How to create and manage a group

Introduction §

A group is needed both for data sources and for applications. You create a group in the developer portal. You have to input a unique name for the group and then input the party configuration domain where you hosted a party configuration you set up. In case you have an existing group without a party configuration you can find the group in your list of groups, edit it, add the party configuration domain and click the update button.

Note that some dataspaces require groups to be created by staff, so if the page has a notice saying so, please follow the instructions written on it.

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 :