# Getting started

The Service Provider role is fulfilled by a legal entity that provides a service, in the form of data, for consumption by a Service Consumer. This legal entity provides the result of a service that Service Consumer(s) need; for example, the party that uses a truck’s time and location to calculate and communicate the truck’s optimal route and estimated time of arrival. Before requesting delegation evidence, the Service Provider MUST know which Authorisation Registry holds the evidence for that capability. Service Providers could also have that directly registered with them.

## Prerequisites

Make sure you execute the following steps before trying to provide as an iSHARE Service Provider.

1. **Obtain a valid identity (private key + certificate)**
   * **Staging:** [Click here](https://ca7.isharetest.net:8442/ejbca/ra/index.xhtml) to request a test certificate. More information on the [Get Test Certificate section](https://dev.ishare.eu/introduction/getting-started/test-certificates).
   * **Production:** Acquire a certificate from an eIDAS certificate provider.
2. **Register yourself as Service Provider**
   * **Staging:** If you want to register at a specific Participant Registry, contact the Participant Registry through their communication channels. A registration via the Scheme Owner is also possible: [Contact the Scheme Owner](https://ishare.eu/home/contact/).
   * **Production:** Register yourself with any Participant Registry using their registration procedure, using the [admission process](https://framework.ishare.eu/detailed-descriptions/operational/operational-processes/admission).

## Implementation of required endpoints

Any Service Provider is required to implement the following endpoints. These endpoints will be the subject of the conformance test, as part of the [admission process](https://framework.ishare.eu/detailed-descriptions/operational/operational-processes/admission).

* [ ] [Access Token](https://dev.ishare.eu/all-roles-common-endpoints/access-token-m2m)
* [ ] [Capabilities](https://dev.ishare.eu/all-roles-common-endpoints/capabilities)
* [ ] [Return](https://dev.ishare.eu/service-provider-role/return) (for human-to-machine (H2M) consumption of its services using an Identity Provider)

## Example implementation of a REST endpoint

If the Service Provider wants to expose a REST endpoint as part of its services as an iSHARE Service Provider, it can do so following the example implementation given in the following endpoint:

* [ ] [Service](https://dev.ishare.eu/service-provider-role/getting-started/service)


---

# Agent Instructions: 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://dev.ishare.eu/service-provider-role/getting-started.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.