# Dataspace Protocol 2024-1 > **NOTE:** The Dataspace Protocol is now an Eclipse Specification project and has a new home in this [Repository](https://github.com/eclipse-dataspace-protocol-base/DataspaceProtocol). > > **NOTE:** The web rendering of the Dataspace Protocol represents the current state on this repo's main branch: The Dataspace Protocol aims for a release as Eclipse Specification combining this specification with the [Dataspace TCK](https://projects.eclipse.org/projects/technology.dataspacetck) and at least one conformant implementation. The [Eclipse Dataspace Components EDC](https://projects.eclipse.org/projects/technology.edc) are planned as compliant implementation, others are welcome. The Dataspace Protocol targets a PAS transposition to ISO during 2025. > > **NOTE:** Feel free to join our [Mailing list.](https://accounts.eclipse.org/mailing-list/dataspace-protocol-base-dev) ## About versions of the Dataspace Protocol This version ([2024-1](https://github.com/International-Data-Spaces-Association/ids-specification/tree/main/releases/2024-1)) of the Dataspace Protocol specification is the release candidate and considered to be stable. Further changes shall not affect conformity. Since [version 0.8](https://github.com/International-Data-Spaces-Association/ids-specification/tree/main/releases/v0.8) the specification is stable with changes in details. All changes made to the specification can be reviewed in the [GitHub repository](https://github.com/International-Data-Spaces-Association/ids-specification/). > **NOTE:** A versioning scheme beside the commits to the repository is not available but will be provided in the future. ## Abstract The **Dataspace Protocol** is a set of specifications designed to facilitate interoperable data sharing between entities governed by usage control and based on Web technologies. These specifications define the schemas and protocols required for entities to publish data, negotiate [Agreements](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/terminology#agreement), and access data as part of a federation of technical systems termed a [Dataspace](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/terminology#dataspace). ## Introduction Sharing data between autonomous entities requires the provision of metadata to facilitate the transfer of [Datasets](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/terminology#dataset) by making use of a data transfer (or application layer) protocol. The **Dataspace Protocol** defines how this metadata is provisioned: 1. How [Datasets](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/terminology#dataset) are deployed as [DCAT Catalogs](https://www.w3.org/TR/vocab-dcat-3/#Class:Catalog) and usage control is expressed as [ODRL Policies](https://www.w3.org/TR/odrl-model/). 2. How [Agreements](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/terminology#agreement) that govern data usage are syntactically expressed and electronically negotiated. 3. How [Datasets](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/terminology#dataset) are accessed using [Transfer Process Protocols](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/terminology#transfer-process-protocol). These specifications build on protocols located in the [ISO OSI model (ISO/IEC 7498-1:1994)](https://www.iso.org/standard/20269.html) layers, like HTTPS. The purpose of this specification is to define interactions between systems independent of such protocols, but describing how to implement it in an unambiguous and extensible way. To do so, the messages that are exchanged during the process are described in this specification and the states and their transitions are specified as state machines, based on the key terms and concepts of a [Dataspace](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/terminology#dataspace). On this foundation the bindings to data transfer protocols, like HTTPS, are described. The specifications are organized into the following documents: * [***Dataspace Model***](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/overview/model) and [***Dataspace Terminology***](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/overview/terminology) documents that define key terms. * [***Common Functionalities***](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/common-functionalities/common.protocol) and their [***Binding in HTTPS***](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/common-functionalities/common.binding.https) declares cross-cutting functions as, e.g., the declaration of supported versions of this Dataspace Protocol. * [***Catalog Protocol***](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/catalog/catalog.protocol) and [***Catalog HTTPS Binding***](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/catalog/catalog.binding.https) documents that define how [DCAT Catalogs](https://www.w3.org/TR/vocab-dcat-3/#Class:Catalog) are published and accessed as HTTPS endpoints respectively. * [***Contract Negotiation Protocol***](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/contract-negotiation/contract.negotiation.protocol) and [***Contract Negotiation HTTPS Binding***](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/contract-negotiation/contract.negotiation.binding.https) documents that define how [Contract Negotiations](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/terminology#contract-negotiation) are conducted and requested via HTTPS endpoints. * [***Transfer Process Protocol***](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/transfer-process/transfer.process.protocol) and [***Transfer Process HTTPS Binding***](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/transfer-process/transfer.process.binding.https) documents that define how [Transfer Processes](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/terminology#transfer-process) using a given data transfer protocol are governed via HTTPS endpoints. > **This specification does not cover the data transfer process as such.** > > While the data transfer is controlled by the ***Transfer Process Protocol*** mentioned above, e.g. the initation of the transfer channels or their decomissioning, the data transfer itself and especially the handling of technical exceptions is an obligation to the Transport Protocol. > > As an implication, the data transfer can be conducted in a separated process if required, as long as this process is to the specified extend controlled by the ***Transfer Process Protocol***. > > Nevertheless, illustrative message examples are provided in the [***Transfer Process Protocol section***](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/transfer-process/transfer.process.protocol#2-message-types). The best practices section may contain further non-normative examples and explanations. ### Context of this specification The **Dataspace Protocol** is used in the context of [Dataspaces](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/terminology#dataspace) as described and defined in the subsequent sections with the purpose to support interoperability. In this context, the specification provides fundamental technical interoperability for [Participants](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/terminology#participant) in [Dataspaces](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/terminology#dataspace). Beyond the technical interoperability measures described in this specification, semantic interoperability should also be addressed by the [Participants](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/terminology#participant). On the perspective of the [Dataspace](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/terminology#dataspace), interoperability needs to be addressed also on the level of trust, on organizational levels, and on legal levels. The aspect of cross-dataspace communication is not subject of this document, as this is addressed by the [Dataspaces'](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/terminology#dataspace) organizational and legal agreements. The interaction of [Participants](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/terminology#participant) in a [Dataspace](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/terminology#dataspace) is conducted by the [Participant Agents](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/terminology#participant-agent), so-called [Connectors](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/terminology#connector--data-service-), which implement the protocols described above. While most interactions take place between [Connectors](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/terminology#connector--data-service-), some interactions with other systems are required. The figure below provides an overview on the context of this specification. An [Identity Provider](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/terminology#identity-provider) realizes the required interfaces and provides required information to implement the Trust Framework of a [Dataspace](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/terminology#dataspace). The validation of the identity of a given [Participant Agent](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/terminology#participant-agent) and the validation of additional claims is a fundamental mechanism. The structure and content of such claims and identities may, however, vary between different [Dataspaces](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/terminology#dataspace), as well as the structure of such an [Identity Provider](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/terminology#identity-provider), e.g. a centralized system, a decentralized system or a federated system. Other specifications, like the Identity and Trust Protocol ([IATP](https://github.com/eclipse-tractusx/identity-trust)), define the respective functions. A [Connector](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/terminology#connector--data-service-) will implement additional internal functionalities, like monitoring or policy engines, as appropriate. It is not covered by this specification if a [Connector](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/terminology#connector--data-service-) implements such or how. The same applies for the actual data that is transferred between the systems. While this document does not define the transport protocol, the structure, syntax or semantics of the data, a specification for those aspects is required and subject to the agreements of the [Participants](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/terminology#participant) or the [Dataspace](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/terminology#dataspace). ![Overview on protocol and context](https://377581754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlnGZQUB3A7aTQkUjaEA4%2Fuploads%2Fgit-blob-fb75be575f63a8e65f3e14563607363f52daf352%2FProtocolOverview.png?alt=media) ## Best Practices The Dataspace Protocol is under development and the working group is active on this draft, reviewed and improved the content multiple times. During the process several aspects were discussed, which are not considered part of the normative specification, but important to be documented as support for the users of this specification as best practices. The [Best Practices](https://docs.internationaldataspaces.org/ids-knowledgebase/dataspace-protocol/best-practices/best.practices) are non-normative. Users of this specification are invited to provide feedback such as, but not limited to: * What information is missing? * What information, including examples, would you like to see? * What did you like in this document? Please provide your feedback as Issue in our [GitHub repository](https://github.com/International-Data-Spaces-Association/ids-specification/issues).