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 (BPN) 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 Identity Wallet Management.
Navigate to Technical Setup > Technical User Management.
Select your technical user Identity Wallet Management. 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
iatp.sts.oauth.client.secret_alias
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 - Components View
From the menu select Components.
This view allows you to search, add, edit, and remove components, while displaying details such as component type, version, name and state. This view also contains the Audit which logs all components.
Search and Filter
Use the Search Field 🔎︎ in the top left to look up a specific component. The list will only show components which contain the entered name.
Use the Dropdown Field in the top left to filter the components by type (e.g. DTR, EDC).
Use the Sort Feature ⇅ in the header to sort the components in an ascending or descending order. When using this feature, the affected column header is highlighted.
Select Reset to remove all search queries and filters.
Step 4 - Add Eclipse Dataspace Connector
Notice
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.
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.
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 (see above). 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 to transfer data securely.
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 Steps
After adding the EDC, the next step is to see Add a Submodel Service.