Trusted list

This page must be considered part of the iSHARE Framework

This page is considered normative and is therefore compliant with RFC 2119.

Retrieves list of trusted certificate authorities

get

Used to obtain the list of trusted certificate authorities (roots) as described in the iSHARE framework. Server response is an iSHARE signed JSON Web Token. Please refer to the models 'jwtHeader' and 'jwtPayloadTrustedListToken' 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
/trustedList
200

OK

Response model

The model of the trustedListToken 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:

  • trustedList

    Array of Objects. Root level.

    Contains a collection of trusted certificate authorities.

    • subject

      String. Contained in the object of trustedList.

      Certificate authority subject name.

    • certificateFingerprint

      String. Contained in the object of trustedList.

      SHA256 fingerprint of the certificate.

    • validity

      String. Contained in the object of trustedList.

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

    • status

      String. Contained in the object of trustedList.

      Status of the certificate. Available values are granted, withdrawn, supervision ceased 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:

PreviousClaims (single claim) [PATCH]NextData Spaces

Last updated