Dataspace Protocol 2024-1

Version 2024-1

About 2024-1

Version 2024-1 is a stable first version of the Dataspace Protocol. It contains the specification for the Dataspace Protocol including

1. How Datasets are deployed as DCAT Catalogs and usage control is expressed as ODRL Policies.
2. How Agreements that govern data usage are syntactically expressed and electronically negotiated.
3. How Datasets are accessed using Transfer Process Protocols.

The specification is complemented with resources for the specified messages and a REST-binding.

Resources

The resources are published as GitHub pages of the repository https://international-data-spaces-association.github.io/ids-specification/2024-1/ (which will deliver a 404, what is correct), e.g., https://international-data-spaces-association.github.io/ids-specification/2024-1/common/schema/context.json. Please check the 'releases' folder for details and available files.

Please also consider, that those resources are available via w3id namespace dspace, e.g.,:

• https://w3id.org/dspace* --> https://github.com/International-Data-Spaces-Association/ids-specification/
• https://w3id.org/dspace/2024/1/context.json --> https://international-data-spaces-association.github.io/ids-specification/2024/1/common/schema/context.json

A human-friendly version of the specification document is available here.

What's new

Full Changelog: v0.8...2024-1

What's Changed

• fix: resolve broken links by @juliapampus in #60
• fix: align service property in catalog with DCAT spec by @juliapampus in #61
• chore: update protocol naming and version by @juliapampus in #58
• refactor: clean up by @juliapampus in #62
• refactor: restructure list of files by @juliapampus in #68
• chore: add reference for abbreviation IRI by @juliapampus in #70
• refactor: remove CONSUMER_ and PROVIDER_ prefixes from CN states by @juliapampus in #71
• fix: remove inconsistencies in transfer.process.protocol.md by @juliapampus in #84
• chore: add missing details to TransferCompletionMessage by @juliapampus in #86
• "hasPolicy" Examples from JSON Object to JSON Array by @sebbader-sap in #80
• completing unfinished note in the catalog protocol description by @sebbader-sap in #81
• chore: introduce subsection for message responses by @juliapampus in #85
• refactor: rename CatalogErrorMessage to CatalogError by @juliapampus in #100
• fix: remove checksum from ContractNegotiation and correlating messages by @juliapampus in #99
• feat: introduce an agreement timestamp by @jimmarino in #82
• feat: remove correlationId from transfer and negotiation by @juliapampus in #101
• feat: add consumerId and providerId to ODRL agreement by @juliapampus in #102
• fix(TerminationMessages): make code optional in schema files by @juliapampus in #98
• Fixed some minor typos by @MichaelSteinert in #109
• Removed potentially misleading token notes by @milux in #108
• docs: add sequence diagrams for transfers by @juliapampus in #111
• Add termiantion endpoint for consumer and improve text by @MichaelSteinert in #112
• fix: fixing typo in dataset with capital S by @ssteinbuss in #131
• fix: fixing typo by @ssteinbuss in #130
• fix: fixing typo in dataset with capital S by @ssteinbuss in #135
• Fix GET Catalog Example in the HTTP Binding by @sebbader-sap in #136
• fix: rename CatalogRequest leftovers to CatalogRequestMessage by @Konfr in #140
• chore: add relations for TERMINATED in state diagrams by @juliapampus in #43
• chore: add http endpoint for provider initiated CN by @juliapampus in #141
• Add note about profiling external standards by @sebbader-sap in #149
• feat: extend JSON-LD context and update examples by @mkollenstart in #139
• feat(TP): change processId to providerPid and consumerPid by @juliapampus in #152
• feat(CN): change processId to providerPid and consumerPid by @juliapampus in #151
• docs: Explain the versioning of the specification and the rendering to GitBook by @ssteinbuss in #158
• chore: update title of GitBook's landing page by @juliapampus in #165
• feat: improved DataAddress model by @mkollenstart in #164
• 104 introduce best practices document by @ssteinbuss in #146
• Add missing attributes for the DCAT Catalog Schema and Shape by @sebbader-sap in #89
• Update ProtocolOverview.png by @ssteinbuss in #174
• feat: Adds a well-known proof metadata endpoint description to the catalog specifications by @jimmarino in #172
• Version Endpoint by @sebbader-sap in #177
• feat: Remove references to signatures by @jimmarino in #181
• feat: Remove Notes Section 5 by @jimmarino in #183
• Releases folder & Github Pages action by @mkollenstart in #179
• chore: align asset/dataset terminology by @juliapampus in #189
• chore: align usage of terms and add linkage by @juliapampus in #190
• Remove the dcat distribution examples ... by @sebbader-sap in #200
• feat: Remove unnecessary dataset id references by @jimmarino in #193
• feat: Add explanations when to use odrl:target by @sebbader-sap in #201
• Editorial Rework by @sebbader-sap in #184
• Remove hasPolicy from the dspace:Catalog by @sebbader-sap in #212
• remove hashedMessage by @sebbader-sap in #214
• chore: add GH action to check changes to release files by @juliapampus in #211
• ci: fix typo for file check workflow by @juliapampus in #215
• Update context.json by @mkollenstart in #216
• Fix Namespace of offer and agreement Attributes by @sebbader-sap in #221
• Extend explanation on dspace-trust child resources by @sebbader-sap in #222
• Replace providerId/consumerId with odrl:assigner / odrl:assignee by @sebbader-sap in #213
• Update model documents by @jimmarino in #229
• Add pagination and filter changes by @jimmarino in #228
• Adds auth description to common bindings document by @jimmarino in #227
• Remove subchapter on Versioning by @sebbader-sap in #225
• Cleanup EndpointProperty inconsistencies and specify authType by @jimmarino in #218
• Emphazising that the spec does not cover the data transfer by @ssteinbuss in #230
• 169 enhance the model section by @ssteinbuss in #219
• Add participant id to catalog by @jimmarino in #226
• Removing working draft by @ssteinbuss in #234
• 242 fix markdown issues by @ssteinbuss in #243
• chore: refactor transfer process description by @juliapampus in #238
• 233 remove work in progress from GitBook files by @ssteinbuss in #241
• Replace v0.8 version tag by @sebbader-sap in #237
• Fix "Offer" Class Name in the Contract Schema by @sebbader-sap in #246
• Update diagram description for ContractOfferMessage by @ssteinbuss in #245
• Create Folder for the 2024-1 Release by @sebbader-sap in #247
• Fix References in JSON Schema Files by @sebbader-sap in #256

New Contributors

• @MichaelSteinert made their first contribution in #109
• @milux made their first contribution in #108
• @Konfr made their first contribution in #140
• @mkollenstart made their first contribution in #139

Full Changelog: v0.8...2024-1