Setting up a party configuration domain

Introduction §

On the IOXIO data sharing services groups can optionally have a party configuration domain; a domain on which a party (the group) publishes standardized configuration files. They are used with HTTP Message Signatures or with the consent protocol prototype, which is available only on some data sharing services.

This guide explains how to set up the necessary configuration files.

Creating and hosting party configuration §

1. Select a domain (it can also be a subdomain) on which you want to host your party configuration.
Note: You will need to be able to create a file at /.well-known/dataspace/party-configuration.json on that domain and it needs to be accessible over https:// with a valid certificate.

2. Create the party-configuration.json and host it on the desired domain. See party configuration schema for more details.

3. Ensure the jwks_uri points to some https:// based domain and a location you can control. A suggestion is to point it to the /.well-known/jwks.json on the same domain as the party configuration.
Example from https://docs.ioxio.dev/schemas/party-configuration :

4. Create the content for the jwks_uri and host it in the location you specified in the party configuration. For this, you will need to generate an RSA public/private keypair. Ensure there is at least one key and that it has a kid, the kty is RSA, the use is set to sig, the alg is RS256 and it has the n and e parameters. Here is an example of what it should look like from https://ioxio.com/.well-known/jwks.json :