Skip to main content
Release: CX-Saturn (Preview)

CX-0001 Participant Agent Registration v1.2

1. Introduction

This standard solves a requirement towards GAIA-X compliance. It is necessary that each Participant Agent must provide a Self Description (SD) of type ServiceOffering. This requires a registration of a Participant Agent at the Core Service Provider B.

NOTE: This standard has been renamed as the original name EDC Discovery API is obsolete for several reasons:

  1. The name EDC is obsolete. The correct term as defined in the Data Space Protocol is Participant Agent.
  2. The discovery API is a deprecated feature that is only necessary for backward compatibility reasons, connector discovery is from now on done using the DID document as specified in CX-0018.
  3. Therefore, the only normative aspect of this standard left is the registration to fulfil the GAIA-X compliance requirements. This is reflected in the new standard name.

1.1 Audience & Scope

This section is non-normative

This standard is relevant for the following roles:

  • Data Provider / Consumer
  • Business Application Provider
  • Core Service Provider
  • Onboarding Service Provider
  • Enablement Service Provider

1.2 Conformance

As well as sections marked as non-normative, all authoring guidelines, diagrams, examples, and notes in this specification are non-normative. Everything else in this specification is normative.

The key words MAY, MUST, MUST NOT, OPTIONAL, RECOMMENDED, REQUIRED, SHOULD and SHOULD NOT in this document are to be interpreted as described in BCP 14 RFC2119, RFC8174 when, and only when, they appear in all capitals, as shown here.

1.3 Proof of conformity

All participants and their solutions will need to proof, that they are conform with the Catena-X standards. To validate that the standards are applied correctly, Catena-X employs Conformity Assessment Bodies (CABs).

  • The Service Operator MUST provide an onboarding process for participants and participant agent instances. This has to be provided in accordance to CX-0006

  • The implemented service MUST use an SD storage like SD-Hub for storing the SD documents provided during the onboarding process.

  • The provided SD documents MUST be GAIA-X compliant, i.e. MUST provide a compliance credential issued from GAIA-X AISBL.

1.4 Examples

SD for ServiceOffering

{
"selfDescriptionCredential": {
"@context": [
"https://www.w3.org/2018/credentials/v1",
"https://registry.gaia-x.eu/v2206/api/shape"
],
"type": [
"VerifiableCredential",
"ServiceOfferingExperimental"
],
"id": "https://compliance.gaia-x.eu/.well-known/serviceComplianceService.json",
"issuer": "did:web:delta-dao.com",
"issuanceDate": "2022-09-25T23:23:23.235Z",
"credentialSubject": {
"id": "https://compliance.gaia-x.eu/.well-known/serviceComplianceService.json",
"gx-service-offering:providedBy": "https://compliance.gaia-x.eu/.well-known/participant.json",
"gx-service-offering:name": "Gaia-X Lab Compliance Service",
"gx-service-offering:description": "The Compliance Service will validate the shape and content of Self Descriptions. Required fields and consistency rules are defined in the Gaia-X Trust Framework.",
"gx-service-offering:webAddress": "https://compliance.gaia-x.eu/",
"gx-service-offering:termsAndConditions": [
{
"gx-service-offering:url": "https://compliance.gaia-x.eu/terms",
"gx-service-offering:hash": "myrandomhash"
}
],
"gx-service-offering:gdpr": [
{
"gx-service-offering:imprint": "https://gaia-x.eu/imprint/"
},
{
"gx-service-offering:privacyPolicy": "https://gaia-x.eu/privacy-policy/"
}
],
"gx-service-offering:dataProtectionRegime": [
"GDPR2016"
],
"gx-service-offering:dataExport": [
{
"gx-service-offering:requestType": "email",
"gx-service-offering:accessType": "digital",
"gx-service-offering:formatType": "mime/png"
}
],
"gx-service-offering:dependsOn": [
"https://compliance.gaia-x.eu/.well-known/serviceManagedPostgreSQLOVH.json",
"https://compliance.gaia-x.eu/.well-known/serviceManagedK8sOVH.json"
],
"ctxsd": "connector-url"
},
"proof": {
"type": "JsonWebSignature2020",
"created": "2022-09-25T22:36:50.274Z",
"proofPurpose": "assertionMethod",
"verificationMethod": "did:web:compliance.gaia-x.eu",
"jws": "eyJhbGciOiJQUzI1NiIsImI2NCI6ZmFsc2UsImNyaXQiOlsiYjY0Il19..Chbzpl0-4S3sobkKXyBjfx6pm74xLHInOmruHUmO--3HpMcrfKldeJQPYLrUWsEJ1HIjMUqxE6QymZRxXfuRlAJKy2nwyM3S5sFX9YJ8bepBcf6q-nWGTDX-jh8wuyX3lwrG94aJnTBByKPLCovSiZ9BURR3cwiSHczBlM7iP90ee5roHOtI-eoqSBYrYaynTaK5eQaWfT-2OdXYgqVPSRJAK2KD5AqEM8KU7x6nnP6-shgSNBIEC1fAOTfAEUYkcrK8Tn4BTaH02HnO3B90S1MWyAWwBzrnmS915CFY4BiHsp9Tz7pt016c8HB8HE7gqoXndk7DUhzgNE2mRbHuLg"
}
},
"complianceCredential": {
"@context": [
"https://www.w3.org/2018/credentials/v1"
],
"type": [
"VerifiableCredential",
"ServiceOfferingCredentialExperimental"
],
"id": "https://catalogue.gaia-x.eu/credentials/ServiceOfferingCredentialExperimental/1664145414932",
"issuer": "did:web:compliance.gaia-x.eu",
"issuanceDate": "2022-09-25T22:36:54.932Z",
"credentialSubject": {
"id": "https://compliance.gaia-x.eu/.well-known/serviceComplianceService.json",
"hash": "eeac8a9b5b6750f13fbc548299b22b73d6beea13f19e71856d0027b5cd42069c"
},
"proof": {
"type": "JsonWebSignature2020",
"created": "2022-09-25T22:36:54.932Z",
"proofPurpose": "assertionMethod",
"jws": "eyJhbGciOiJQUzI1NiIsImI2NCI6ZmFsc2UsImNyaXQiOlsiYjY0Il19..SibPFxPtfsKP439SjoKo5VtmU_EpgsfuEjghCt_8sG2fUYT6s9CTY8jyEniGUkk7BIWnIYNsuuKudlNBD27kwzdTy6bZX9Jq0OaAaCpgZAZ9vlp7oFZF3ysLcERmBAixzGUjL0sny06Mu7IRCcDYVhLyd6flOvUGtH2I6T9u6UZL8cN1advRYKd4BSumAp5d4cCG-7cg7DCqPXk_M8cTvU8mDeXvXfciv7sIqvkwqd2L-T4kbxmPTCY3r3wPoVHGBDa3Gnntwkz3_aVInjbztchH-WmlDpCPv1hTv4uZNenNZVw7xsx1_o0voJJLSGtlYNhW4rk2oDxr4qie3S-Zgw",
"verificationMethod": "did:web:compliance.gaia-x.eu"
}
}
}

1.5 Terminology

This section is non-normative

The following terms are especially relevant for the understanding of the standard:

Business Partner Number (BPN)

A BPN is the unique identifier of a partner within Catena-X, see CX-0010.

Self Description (SD)

Gaia-X requires all providers to describe themselves and their service offerings using standardized, machine-readable metadata called Self-Descriptions. Such Self-Descriptions will for example include information like the address of a company, a specific service description or certificates and labels.

Participant Agent

A Participant Agent is a service that fulfills the requirements of the CX-0018 standard

Additional terminology used in this standard can be looked up in the glossary on the association homepage.

2 Participant Agent Registration

This section is normative

  • The Core Service Provider B MUST offer a process/workflow to register Participant Agents; Enablement Service Provider as well as Application Service Provider MUST run the Participant Agent registration for their service customers. The provided url endpoint for the participant agent service must be in accordance to CX-0018.

  • SD documents MUST be created for every Participant Agent registered by the Participants. The Core Service Provider B make them available.

  • The self-description documents used as data source MUST be GAIA-X compliant, i.e. adhering to the GAIA-X Trustframework in the currently supported version in Catena-X. It MUST provide a compliance credential issued from GAIA-X AISBL.

  • In addition, these SD documents MUST be registered at an SD storage like SD-Hub.

A test case will be, that a Participant Agent instance has to be onboarded for a specific participant identified by a BPN. The SD for the EDC has to be visible in the supported SD storage.

3.0 Backward Compatibility

This section is normative, it is not part of the backward compatibility requirement for this standard version.

The EDC Discovery API service MUST be offered as central available endpoint by the Core Service Provider B. Every Participant Agent operated in the dataspace MUST be registered. The Core Service Provider B MUST offer each registered Participant Agent via the EDC Discovery API.

The EDC Discovery API can get triggered via technical as well as real users, if relevant roles are available.

For technical user, a company can request the user creation with the technical user creation feature inside the portal.

A test case will be, that the query against a registered participant agent instance for the given BPN SHOULD provide the connector url as stated in the SD document which is the same as used during registration.

3.1 API Endpoints & resources

The EDC Discovery API MUST be implemented as specified here:

Endpoint: POST: /api/administration/connectors/discovery

Request body

the request body can be kept empty (to retrieve a complete list of registered Participant Agents) or be filled with one or multiple BPNs to retrieve a list of registered Participant Agent endpoints for the giving BPNs.

[
"BPNL....",
"BPNL...."
]

Response structure

[
{
"bpn": "BPNL......",
"connectorEndpoint": [
"http://some.example.url",
"http://some.other-example.url"
]
},
{
"bpn": "BPNL......",
"connectorEndpoint": "http://some.example.url"
}
]

For each BPN an own response object is provided. In case of multiple Participant Agent instances for one BPN an array is returned (first result set) otherwise a single value (second result set)

3.2 Available Data Types

The API MUST use JSON as the payload transported via HTTP.

3.3 Data Asset Structure

This API is not accessed via a Participant Agent but can be queried from any authorized participant or service directly.

3.4 Error Handling

HTTP standard response codes that MUST be used as described in the following table.

CodeDescription
200Discovery request finished successfully
400Request body was malformed
401Not authorized
403Forbidden
405Method not allowed

4 REFERENCES

4.1 Normative References

Following Standards are used within this standard:

CX-0006 Registration and initial onboarding

CX-0010 Business Partner Number

CX-0018 Dataspace Connectivity

Data Space Protocol

GAIA-X Trustframework

Copyright © 2025 Catena-X Automotive Network e.V. All rights reserved. For more information, please visit here.