Skip to main content
Version: 24.03

Adoption View

Connector kit banner

Connector KIT​

The Connector Kit provides a connector framework, based on the Eclipse Dataspace Connector for sovereign, cross-enterprise data exchange.

Vision & Mission​

Vision​

Sharing data along the automotive supply chain adds great value for every participant. The key to such collaboration is trust in the involved partners and assurance that the shared data is not being misused. Within a few years, companies along the automotive value chain will share and exchange data with each other as a matter of course, without anyone fearing that their data will be misused while unlocking significant values for every party.

Mission​

Collaboration needs trust. Within Catena-X trust is built on an open-source architecture and components designed to support full sovereignity. The Connector KIT provides the single directory of information and technology to perform trustful data exchange within Catena-X. The Connector KIT bundles the interaction patterns, relevant standards, APIs, and reference implementations for developers.

Concept​

Trust, interoperability, and data sovereignty are the objectives and values for secure and sustainable peer-to-peer data exchange between organizations and companies. The claim is data sovereignty: Whoever provides data to the Data Space retains control and decides individually who is involved in the data exchange, how, when, where and under what conditions. A corresponding concept was developed in the context of Gaia-X and the International Data Space Association. The essential software component is the EDC.

With the EDC, a new communication component was introduced, which implements the following architectural principles:

  • Simple. Maintaining a small and efficient core with as few external dependencies as possible.
  • Interoperable. Independent of platforms and ecosystems.
  • Decentralized. Software components with the necessary capabilities for participating in a Data Space are located on the partners' side, data is only exchanged within agreed contracts.
  • Data protection is more important than data sharing. Data to be transmitted is fundamentally linked to policies via contracts; a transfer without a contract is not possible.
  • Separation of metadata and data. Enables high throughput rates for the actual data transfer.
  • Consistent semantics. Is the basis for interoperability and digital value creation.
  • Automation. As far as possible, all processes, starting with determining the identity, through ensuring the contractually agreed regulations to data transmission, are automated.
  • Standardization. Existing standards and protocols (GAIA-X and IDSA) are used as far as possible.

Use Case​

The EDC is the enabling component for all use cases within Catena-X and the only component to execute the exchange of operational data to Data Space participants. The base use case is therefore the exchange of data between to partners. Value creation along the automotive value chain is tied to processing data in specific contexts. Within Catena-X exist 10 use cases companies can participate in. Active participation in given use cases always requires the use of a connector compliant to the DSP such as the EDC. Depending on the use case a participant chooses to participate in, further components will be required explained in subsequent Kits.

Business Architecture​

The EDC as a connector implements a framework agreement for sovereign, cross-organizational data exchange. The International Data Spaces Standard (IDS) and relevant principles in connection with GAIA-X were implemented. The connector is designed to be extensible to support alternative protocols and to be integrated into different ecosystems.

The objective is to set up a decentralized software component on the part of the respective partner, which bundles the skills required to participate in a Data Space and enables peer-to-peer connections between participants. The focus here is particularly on the data sovereignty of the independent companies. The functionality required for this is bundled in the open-source project "Eclipse Dataspace Connector", to which members of the Eclipse Foundation contribute.

The main difference between the EDC and the previous connectors of the IDSA is the separation of the communication into a channel for the metadata and one for the actual data exchange. The channel for the data supports various transmission protocols via so-called data plane extensions. The metadata is transmitted directly via the EDC interface, while the actual data exchange then takes place via the appropriate channel extension. In this way, a highly scalable data exchange is made possible.

EDC Architecture

The architecture of the EDC combines various services that are necessary for the above principles:

  • An interface to the Identity Provider service, currently IDSA's Identity And Trust Protocol communicating with the Managed identity Wallet. This central service provides the identity and the corresponding authentication of the participants in the data exchange. (There is no authorization at this point). Decentralized solutions will also be supported in the future.
  • The provision of possible offers (contract offering) which, on the one hand, stipulates the data offered and the associated terms of use (policies) in corresponding contracts.
  • An interface for manual selection of data and associated contract offers.
  • The actual data transfer via the data plane extension
  • The connection of software systems on the customer and provider side

Additional Resources​

Tutorial & Whitepapers​

  • There is a extensive tutorial on setting up and using an EDC in the context of the Catena-X dataspace in the Tutorials section of this website.
  • To find out more about the role of the Enablement Services (of which the Connector is one), the Whitepaper "Enablement Services 101" provides a very digestible high-level overview.

Catena-X Standards​

The Connector KIT builds on the Catena-X Standards. Every data consumer and provider in Catena-X is required to comply with these standards. The EDC builds on the following standards:

Terminology​

The shown picture illustrates only a generic view of the EDC's Domain Model and is not intended to show all aspects of the implementation. Most of the Domain-Model-Elements are represented by separate APIs. Please check the Management API Walkthrough in the tractusx-edc repository for more a reference on usage of the API.

domain_model

Extensions​

There are different extenions for the Connector, e.g. for the Data Plane. This enables various transfer modes like httpData or via blob-storage.

Data Plane​

The Data Plane handles several forms of actual data exchange by utilizing various extensions.

Control Plane​

The Control Plane handles meta data exchange with other components and Connectors, as well as transfer of access tokens

Data Assets​

Data Sources (databases, files, cache information, etc.) are connected to the Connector and are represented by Data Assets. For each asset, a DataAddress needs to be resolvable.

Data address​

A data address is a pointer into the physical storage location where an asset will be stored.

Policy Definition​

A standardized set of policies can be used to define actions regarding access to and usage of assets. These actions can be limited further by constraints (temporal or spatial) and duties ("e.g. deletion of the data after 30 days").

Contract Definition​

By combining [Assets](#data asset) and Policies, Contracts for data offerings are defined. These Contracts need to be accepted by consuming participants (Connectors) for the data exchange to take place.

Contract offer​

The contract offer is a representation of the ContractDefinition for a specific consumer and serves as protocol for a data transfer object (DTO) for a particular contract negotiation. If a data consumer wants to conclude a binding data exchange contract based on the terms of a Data Offer, the data consumer can communicate such desire to the data provider by referencing to a specific Data Offer. This constitutes a binding offer by the data consumer. For now, the data consumer only has the option to accept all terms of a Data Offer (or not). The Data Exchange Process does not yet provide for the data consumer to make an offer that deviates from the terms of a Data Offer as set by the data provider.

Contract negotiation​

A ContractNegotiation captures the current state of the negotiation of a contract (ContractOffer -> ContractAgreement) between two parties. This process is inherently asynchronous.

Contract agreement​

A contract agreement represents the agreed-upon terms of access and usage of an asset's data between two data space participants, including a start and an end date and further relevant information.

Transfer process​

After a successful contract negotiation, DataRequests can be sent from the consumer connector to the provider connector to initiate the data transfer. It references the requested [Asset](#data asset) and ContractAgreement as well as information about the data destination.

Similar to the ContractNegotiation, this object captures the current state of a data transfer. This process is inherently asynchronous, so the TransferProcess objects are stored in a backing data store (TransferProcessStore).

Notice​

This work is licensed under the CC-BY-4.0.

  • SPDX-License-Identifier: CC-BY-4.0
  • SPDX-FileCopyrightText: 2023 sovity GmbH
  • SPDX-FileCopyrightText: 2023 msg systems AG
  • SPDX-FileCopyrightText: 2023 Mercedes-Benz Group AG
  • SPDX-FileCopyrightText: 2023 Contributors of the Eclipse Foundation
  • Source URL: https://github.com/eclipse-tractusx/tractusx-edc