The core services connect your Catena-X Dataspace to the technical users. The core services will enable your Catena-X Dataspace to manage data and assets with the whole Catena-X Network. A core service and its data depend on the submitted technical user.
For example: To share your Catena-X membership information you need to create a technical user "CX Membership". Afterwards, you need to add the core service "MEMBERSHIP" to your Catena-X Dataspace. Finally, you can provide the resulting core service URL to your partners, or you can reuse the core service URL within Dataspace OS to set up other components.
For more information, see What is a Core Service?
Important Note
For all services you can use one technical user with several permissions, automatically created after subscribing to DOS in the portal, called "Dataspace OS".
Step 1 - Keep your Technical User Credentials ready
To add core services, you will need the credentials for each core service/technical user, such as, Client ID and Client Secret.
Login to your Cofinity-X Portal account.
Navigate to Technical Setup > Technical User Management.
Choose the technical user called "Dataspace OS" and select Details.
The details view lists all necessary data in section Technical User Details. You can copy and paste the credentials into Dataspace OS with Copy.
Keep the credentials ready for the next steps.
Step 2: Actions in Dataspace OS
Log in to Dataspace OS and go to the ‘Dataspaces’ tab.
Click ‘Add Dataspace’ and fill in the following fields:
Name: Choose a unique name for your Dataspace.
Type: This will be preselected.
Version: Select the latest version.
BPN: Enter your BPNL (e.g., BPNLxxxxxxx).
Once the Dataspace is created, you can begin adding services.
Step 3: Adding your Services
The main services to add are:
Membership
Semantic Hub
EDC_Discovery
Connector_Registration
EDC_BPDM
Navigate to your Dataspace and click on the ‘Add Service’ button.
2. Select the Service Type you want to configure and provide a name. For example:
Type: MEMBERSHIP
Name: Membership Service
URL: Use the appropriate URL for your environment (e.g., PROD or Pre-Prod).
Token URL:
PROD:
https://centralidp.svc.cofinity-x.com/auth/realms/CX-Central/protocol/openid-connect/tokenPre-Prod:
https://centralidp.beta.cofinity-x.com/auth/realms/CX-Central/protocol/openid-connect/token
3. Use the previously noted Client ID and Secret from the Portal for authorization.
Note: The Token URL, Client ID, and Client Secret will remain the same across all services created within the same environment, except the EDC_BPDM service.
Service URLs
Membership:
PROD:https://portal-backend.svc.cofinity-x.com/api/administration
Pre-prod:https://portal-backend.beta.cofinity-x.com/api/administrationSemantic Hub Service:
PROD:https://semantic-hub.svc.cofinity-x.com/semantics
Pre-Prod:https://semantic-hub.beta.cofinity-x.com/semanticsEDC Discovery Service:
PROD:https://portal-backend.svc.cofinity-x.com/api/administration
Pre-Prod:https://portal-backend.beta.cofinity-x.com/api/administrationConnector Registration Service:
PROD:https://portal-backend.svc.cofinity-x.com/api/administration
Pre-Prod:https://portal-backend.beta.cofinity-x.com/api/administration
Setting up the EDC_BPDM service
EDC_BPDM service allows to list the legal entities of Catena-X within the Dataspace OS, by talking to an EDC.
For setting up this service, follow the instructions below:
Choose the type: EDC_BPDM
Provide a unique name for the service
Paste the following EDC URL, according to the environment:
Preprod: https://dos-edc-bpdm-service-edc.dataspaceos.preprod.cofinity-x.com/api/v1/dsp
Prod: https://dos-edc-bpdm-service-edc.dataspaceos.svc.cofinity-x.com/api/v1/dsp
EDC BPDM BPN:
For both environments: BPNLCOFINITYEZFA
EDC component: Please choose one of your EDCs to which the aforementioned EDC will be talking to.
Click save. It might take some hours until the EDC_BPDM service will be active. If it is not active after one business day, please raise a ticket: support@cofinity-x.com
Next Steps
You have finished the initial setup for your Catana-X Dataspace. The next step is to set up your first data exchange. Follow the instructions to Start your Journey to Data Exchange to learn how to set up Catena-X Components, create policies and contracts and learn how to use data share assistance like "Get Data" or "Share Data".