> For the complete documentation index, see [llms.txt](https://trustbok.ishare.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://trustbok.ishare.eu/apply-ishare/quick-walkthroughs/participant-management.md).

# Participant Management

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

#### 1. Fill out participant details

<figure><img src="/files/JZP2UbtwoNwRowlwxG8b" 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="/files/kudTRXez9Rwt8g0clX9g" 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="/files/TQwrSADlStUL6O8uNv6v" 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="/files/s1EDoscYofZSOlEIxSf3" 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](/apply-ishare/test-certificate.md).
  {% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://trustbok.ishare.eu/apply-ishare/quick-walkthroughs/participant-management.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.