# 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.

## 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 [Get Test Certificate section](https://dev.ishare.eu/version-2.1.1/introduction/getting-started/test-certificates).
   * **Production:** Acquire a certificate from an eIDAS certificate provider.
2. **Register yourself as iSHARE 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 Providers is required to implement the following endpoints. These endpoints will be 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/version-2.1.1/all-roles-common-endpoints/access-token-m2m)
* [ ] [Capabilities](https://dev.ishare.eu/version-2.1.1/all-roles-common-endpoints/capabilities)
* [ ] [Return](https://dev.ishare.eu/version-2.1.1/service-provider-role/return) (for human-to-machine (H2M) consumption of its services using an Identity Provider)

## Example implementation of REST endpoint

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

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