Skip to main content
Set-up: Eclipse Dataspace Connector (EDC)
Updated over a week ago

General Informations about the EDC:

The EDCs provide a framework, based on the Dataspace Protocol specification (DSP), for sovereign, inter-organizational data exchange. This framework contains modules for performing data queries, data exchange, policy enforcement, monitoring, and auditing. Specifically, it can be integrated with existing identity, data catalog, and transfer technologies to provide compliance, policy, and control capabilities across the network. The EDC can be assembled as a connector that serves all the requirements of the Catena-X data space and the participant (e.g., with an IT stack based on Kubernetes) at the same.


Tutorial Video:


Please follow these simple steps to set up an Eclipse Dataspace Connector (EDC):

  1. Select the "Components" module from the sidebar on the left side of the Dataspace OS interface. In this section, you can create new components, and view all the components that you have previously created.

  2. Click on the "+ Add Component" button located at the top-right corner of the screen.

  3. In the "Type" dropdown menu, select "EDC" as the component type.

  4. In the "Dataspace" dropdown menu, you don't need to make a selection, as only the Catena-X Dataspace is supported currently. In the future you will be able to select other Dataspaces.

  5. From the "Versions" dropdown menu, select the "latest version" unless you are required to use an old version.

  6. To enter the BPN details:

    • Go to the Cofinity-X portal and click on the user icon at the top-right corner of the screen.

    • Select "Wallet" from the dropdown menu.

    • Here, you will be able to see your BPN. Copy the BPN and paste it into the BPN field in DOS.

    • You can click on "View Credential" to see additional information.

  7. Enter Component Details:

    • Component Name: Enter a unique name for the component. This name will be used in the backend.

    • Display Name: Enter a display name. This name will be used to display the component in the user interface.

    • Description: Provide a brief description that gives an overview of the component.

    • Company/Department Name: Enter your company name or the name of the department you are associated with.

    • Cost Center: If applicable, enter your cost center number. If you do not have one, simply type "0".

  8. The "Token Receiver URL" is for App Providers to connect via APIs. If you're not an App Provider, you can skip this step.

  9. MIW Properties:

    • Go to the Cofinity-X portal again and open the Sidebar.

    • Click on "Technical User Management" under "Technical Integration".

    • Click on the "Create Technical User" button.

    • Provide a username and description for the Technical User.

    • Under service roles, ensure you select "Identity Wallet Management".

    • Press "Confirm" at the bottom of the screen. You will receive confirmation of the technical user creation.

    • Copy the "Client ID" and paste it into the "OAuth Client ID" field in Dataspace OS.

    • Copy the "Client Secret" and paste it into the "OAuth Client Secret" field in Dataspace OS.

    • In the OAuth URL field, depending on which environment you are using, copy and paste one of the following URLs:

      • Production Environment: https://centralidp.services.cofinity-x.com/auth/realms/CX-Central/protocol/openid-connect/token

      • Pre Production Environment: https://centralidp.preprod.cofinity-x.com/auth/realms/CX-Central/protocol/openid-connect/token

    • In the "Authority ID" field, enter the "Issuer ID". To get the "Issuer ID", go to the Cofinity-X portal, click on the user icon at the top-right, and select "Wallet". Click on "View Credential" to find the "Issuer ID".

    • In the MIW URL field, depending on which environment you are using, copy and paste one of the following URLs:

      • Production Environment: https://managed-identity-wallet.services.cofinity-x.com/

        Pre Production Environment: https://managed-identity-wallet.preprod.cofinity-x.com/

  10. Enter a strong password in the API Authorization Key field under Control Plane Properties.

Please allow a few minutes for the status of the EDC to update to "Ok โœ…". During this time, you can still click on the EDC to view the Component Details, Assets, Contract Definitions, Policies, and other related information.

Did this answer your question?