# Participant Management

This page explains how a Participant can be added to the Participant Registry.

#### 1. Fill out participant details

<figure><img src="https://2110281265-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfKDJDsmddUm6vG90kdzt%2Fuploads%2F1z5Zedbmu5piBT1kwT7C%2Fimage.png?alt=media&#x26;token=8fe3795f-67e8-4103-8ade-7a45f028f2f6" alt=""><figcaption><p>Adding Participant Details</p></figcaption></figure>

<details>

<summary>Participant details</summary>

While generating/obtaining the certificate, a valid **PartyID** is also required. This PartyID or identifier is used to register the participant in the dataspace.\
The **party name** is the Organisation Name used to generate/obtain the certificate.\
**Adherence status** should be active for participants that are in compliance with the dataspace agreements.\
**Capabilities url** is an optional URL for parties providing services, referring to the [Capabilities endpoint](https://dev.ishare.eu/common/capabilities.html) used to discover the participant's services. \
**Registrar Data Space ID** - is the ID of the dataspace onboarding the participant.

</details>

#### 2. Adding the certificate

If a certificate is required (see below), upload the certificate and click 'Save'.

<div align="center"><figure><img src="https://s3-eu-central-1.amazonaws.com/euc-cdn.freshdesk.com/data/helpdesk/attachments/production/101141727381/original/i7eIRQn3hVbn8GRmAyy5jBhDVHZ31Z53Lg.png?1708011071" alt=""><figcaption><p>Certificates addition in the Participant Registry</p></figcaption></figure></div>

#### 3. Add an Authorisation Registry and additional details

For parties with the role of Entitled Party, optionally an Authorisation Registry can be added.

<figure><img src="https://2110281265-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfKDJDsmddUm6vG90kdzt%2Fuploads%2FjyAv14lSVhlod2YXs3y1%2Fimage.png?alt=media&#x26;token=36145b52-5754-4dec-9d8d-42ec80868e86" alt=""><figcaption><p>Adding Additional Details</p></figcaption></figure>

<details>

<summary>AR &#x26; additional details </summary>

Authorisation Registry and Additional Participant Details are optional.

</details>

#### 4. Add agreements and add the party to the right dataspace

Add two agreements (Terms of Use and Accession Agreement) and optionally extra agreements that are specific for a data space.&#x20;

<figure><img src="https://2110281265-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfKDJDsmddUm6vG90kdzt%2Fuploads%2FN7eSRLw4GztSwkFlGgwM%2Fimage.png?alt=media&#x26;token=33342c87-c7ab-485f-ad28-8a8d8c8cb326" alt=""><figcaption><p>Adding Agreements</p></figcaption></figure>

<details>

<summary>Agreements</summary>

The signed Terms Of Use and Accession Agreement are required for all participants. Dummy agreements can be added for test environment.

For Certified Parties - Certified Parties agreement is required.&#x20;

For more information on the Legal agreements required for onboarding participants to a dataspace, refer to the [Legal Agreements in the Trust Framework.](https://framework.ishare.eu/detailed-descriptions/legal)&#x20;

</details>

#### 5. Add party roles

Select the roles which the participant will fulfill.&#x20;

<figure><img src="https://2110281265-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfKDJDsmddUm6vG90kdzt%2Fuploads%2F8OYiOCP4aJ5iXCqVRnsd%2Fimage.png?alt=media&#x26;token=0f2eb3e0-667f-4922-8049-efdb182b5fe3" alt=""><figcaption><p>Adding Roles</p></figcaption></figure>

<details>

<summary>Roles </summary>

A minimum of one role is required to be added. Organisation or Participants can also play multiple roles.

For clarity on Roles used in the Trust Framework,[ refer here](https://framework.ishare.eu/main-aspects-of-the-ishare-trust-framework/framework-and-roles).&#x20;

</details>

{% hint style="info" %}

For all participants with the role of Service Provider, Service Consumer with machine-to-machine API implementation, Authorization Registry or Identity Provider a certificate is required.

* For production implementations refer to [iSHARE's eSEAL Guide](https://github.com/iSHAREScheme/eSEALsGuide).
* For UAT/test implementations refer to [creating a test certificate](https://trustbok.ishare.eu/apply-ishare/test-certificate).
  {% endhint %}
