Skip to content

Onboard to the federated catalogue

This guide walks you through joining the dataLOFT dataspace as a participant and registering your service offering in the federated catalogue. You need to complete both steps before your connector is discoverable by other participants.

Prerequisites

  • You have a running RUN-DSP instance with a public endpoint.
  • Your participant domain hosts a did:web document at https://<your-domain>/.well-known/did.json. If you are using HST-DID, this is handled automatically from your Let's Encrypt certificate.
  • You have access to the private key corresponding to the public key in your DID document.

Step 1: Register as a participant

Submit a registration request via the portal:

  1. Go to https://loire-portal.dataspace.fun/register.
  2. Fill in your participant details, including your DID (e.g. did:web:your-domain.example).
  3. Submit the form.

Your request is queued for review. A federator must approve it before you can add service offerings. Once approved, your participant credential is visible under GET /participants on the FC-Service API.

Note

A federator is a participant whose DID is registered as a federator in the catalogue. Contact the dataLOFT platform team to have your request approved.

Step 2: Add a service offering

Once your participant is approved, register your connector endpoint as a service offering:

  1. Go to https://loire-portal.dataspace.fun and navigate to Browse Catalog → Self Descriptions → Provide.
  2. Select your DID as the issuer.
  3. Provide the private key corresponding to your DID document's public key. The portal uses this to sign the verifiable credential (the key is not stored).
  4. Select Connector Endpoint as the template.
  5. Enter your RUN-DSP endpoint URL.
  6. If applicable, check Cloud Processing Tag to indicate that your service supports cloud-based processing workflows.
  7. Submit. The portal creates and signs the verifiable credential and registers it with FC-Service.

Your connector endpoint is now discoverable by consumers querying the catalogue.

Verifying registration

To confirm your participant credential is registered:

curl --request GET \
  --url https://fed-cat.dataspace.fun/participants \
  --header 'content-type: application/json'

Your DID should appear in the response list.

To verify your service offering is queryable:

curl --request POST \
  --url https://fed-cat.dataspace.fun/query \
  --header 'content-type: application/json' \
  --data '{
  "statement": "MATCH (n:gx__ServiceOffering) -[:gx__endpoint]-> (m:gx__Endpoint) RETURN m.gx__endpointURL as url"
}'

Your endpoint URL should appear in the results.