What is an Eclipse Dataspace Connector (EDC)?
The EDC provides 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 Dataspace and the participant (e.g., with an IT stack based on Kubernetes) at the same.
For more information, see What is an EDC?
Step 1 - Keep your Technical User Credentials, Client ID and Client Secret ready
To follow the next steps, make sure you have your Business Partner Number (BPNL) ready from your Cofinity-X Portal Account. You will find your BPN in Your Account in the section Personal Information.
To follow the next steps, make sure you have your Client ID and your Client Secret ready from your technical user called "dim-Dataspace OS" with the role Identity Wallet Management.
Navigate to Technical Setup > Technical User Management.
Select your technical user dim-Dataspace OS". You will find the Client ID and Client Secret in section Technical User Details.
You can copy and paste the information into the EDC creation with Copy .
Step 2 - Keep your Connector Configuration Details from Portal ready (IATP)
To create an EDC you need to login to your Cofinity Portal Account and retrieve your Connector Configuration Details.
You need the following information:
trusted_issuer
iatp.sts.oauth.token_url
iatp.sts.oauth.client.id - gotten In the step 1
iatp.sts.oauth.client.secret_alias - gotten In the step 1
iatp.sts.dim.url
iatp.id
DID Resolver
In Portal, navigate to Technical Setup > Connector Registration.
1 | More Details |
Select More Details to display the configuration details.
You can copy and paste the information into the EDC creation with Copy.
Step 3 - Add Eclipse Dataspace Connector
NOTE:
Faulty or missing input will result in error messages. Follow the instructions in those messages.
Select Add component.
The new EDC is set up in the dialog.Select type EDC.
Fill in the required fields:
Versions - The version of the EDC.
Component name - Internal name to identify this EDC, must be all lowercase, unique and no spaces
Display name - This name is displayed in the graphical user interface.
Description - A short description of this EDC.
Company/department name - The name of the organization that is beneficiary of this digital twin registry.
Cost center - Used for identification and billing cost in an organization, if case you do not have one, fill it as 0
Token receiver URL - Not required! Used for redirecting to your desired endpoint of a token receiver.
Keep awake
OFF - EDC will go to sleep after a set time if there are no requests.
ON - EDC will never go to sleep.
NOTICE
It is recommended to use the latest version.
Fill in the IATP Properties. For this you will need the required Client ID, Client Secret and Connector Registration Details (from the Step 1 and 2). If necessary, you can add further users using Add trusted user. Use the following mapping:
IATP Property | maps to Connector Registration Detail |
IATP ID | iatp.id |
OAuth Client ID | Client ID of your technical user Identity Wallet Management |
OAuth Token URL | iatp.sts.oauth.token_url |
DIM URL | iatp.sts.dim.url |
Trusted Issuers | trusted_issuer |
Fill in the Control plane properties. For this you will need the required Connector Registration Details (see above). Use the following mapping:
IATP Property | maps to Connector Registration Detail |
BPNL-DID Resolution Service URL (BDRS) | DID Resolver |
Enter a valid API authorization key. This key will be used in case if you want to access your EDC from the backend.
NOTICE
Data loss
Keep API authorization key in a save place. Do not publicize the key.
1. Select Add to create the EDC.
Status of EDCs
The view also displays the status of each EDC.
Status of EDC | Description |
OK | The EDC is working correctly. |
Sleeping | If not in use, the EDC is sleeping. In this state, it cannot process requests - it needs to wake up. You can control this behavior by setting Keep awake when creating or editing the EDC:
|
Waking up | The EDC is waking up to process requests. This may take a few minutes. |
Creating | The EDC is created. This may take a few minutes. |
Error | An error occurred. For more information, contact Cofinity-X (for more information, see Contact). |
For more information about specific EDCs, see Eclipse Dataspace Connector Details.
✅ Next Step
After adding the EDC, the next step is to see 2. Add a Submodel Service.