Trusted list

Retrieves list of trusted certificate authorities

get

Used to obtain the iSHARE list of trusted certificate authorities (currently, eIDAS certificate issuer certificate authorities).

Server response is an iSHARE signed JSON Web Token. Please refer to the models 'jwt_header' and 'jwt_payload_trusted_list_token' which indicate what the decoded response will look like.

Authorizations
AuthorizationstringRequired

OAuth 2.0 authorization based on bearer token. MUST contain “Bearer “ + access token value. Must be provided if restricted endpoints are needed.

Responses
200

OK

application/json
get
/trusted_list
200

OK

Response model

The model of the trusted_list_token JWT response is available on the iSHARE OpenAPI documentation.

Decoded trusted_list_token parameters:

It contains iSHARE compliant JWT claims. In addition to that it also contains the following parameters:

  • trusted_list

    Array of Objects. Root level.

    Contains collection of trusted certificate authorities.

    • subject

      String. Contained in the object of trusted_list.

      Certificate authority subject name.

    • certificate_fingerprint

      String. Contained in the object of trusted_list.

      SHA256 fingerprint of the certificate.

    • validity

      String. Contained in the object of trusted_list.

      Validity of the certificate. Available values are valid or invalid.

    • status

      String. Contained in the object of trusted_list.

      Status of the certificate. Available values are granted, withdrawn, supervisionceased and undersupervision.

Example request

Example response

The response contains an encoded JWT, which looks like this:

After decoding, the example content of the JWT looks like this:

Note

This page must be considered part of the iSHARE Trust Framework.

Last updated