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.
You have created the necessary technical users in a previous step (Create Technical Users in Portal).
For more information, see What is a Core Service?
This guide will show you how to set up the following Catena-X Core Services:
MEMBERSHIP
SEMANTIC_HUB
EDC_DISCOVERY
You only need to add these core services once for your Catena-X Dataspace.
Use Pre-Production Environment
To follow this guide, use the Dataspace OS pre-production environment.
All provided URLs, such as Endpoints, do only apply for pre-production environments.
For more information see Production and Pre-Production Environments.
Required Technical Users
To add the Catena-X Core Services, make sure you have created all required technical users prior (for more information, see Create Technical Users in Portal).
You will also need the credentials for each technical user, such as Client ID and Client Secret.
Required Technical User | Core Service in Dataspace OS | Usage |
CX Membership Info | MEMBERSHIP | Share Catena-X (CX) membership information with partners. |
Semantic Model Management | SEMANTIC_HUB | Provides semantic models (data structures). |
Dataspace Discovery | EDC_DISCOVERY | Share a catalogue of available data with partners (Endpoint Discovery). |
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 for which you need its credentials 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 for each technical user ready for the next steps.
Step 2 - The Dataspaces View
Login to your Dataspace OS account.
From the menu select Dataspaces.
This view allows you to add core services to selected dataspaces.Use ﹀or > to collapse or to expand the dataspace information.
Step 3 - Add Core Service "Semantic Hub"
From the list, expand the dataspace for which you want to add a core service.
Select Add service.
The new core service is set up in the dialog.
Select type SEMANTIC_HUB.
Enter a meaningful name for your core service.
Use the URLs from the table (see below).
Fill in the Client ID and the Client Secret which you had prepared from your technical user.
Add the new core service by selecting Add.
PreProd URL |
|
Token URL |
|
Step 4 - Add Core Service "EDC Discovery"
From the list, expand the dataspace for which you want to add a core service.
Select Add service.
The new core service is set up in the dialog.Select type EDC_DISCOVERY.
Enter a meaningful name for your core service.
Use the URLs from the table (see below).
Fill in the Client ID and the Client Secret which you had prepared from your technical user.
Add the new core service by selecting Add.
PreProd URL |
|
Token URL |
|
Step 5 - Add Core Service "Catena-X Membership"
From the list, expand the dataspace for which you want to add a core service.
Select Add service.
The new core service is set up in the dialog.Select type MEMBERSHIP.
Enter a meaningful name for your core service.
Use the URLs from the table (see below).
Fill in the Client ID and the Client Secret which you had prepared from your technical user.
Add the new core service by selecting Add.
PreProd URL |
|
Token URL |
|
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".