Skip to main content

Create verifier global configuration

POST 
/v2/config/digital-wallet/openid/verifier/global-configuration

Creates the global configuration of the OpenID4VP verifier.

The configuration sets whether the verifier accepts an encrypted Authorization Response, and how long an Authorization Request stays valid.

Request​

Header Parameters

    X-SandboxOrgId stringrequired

    Optional. Unique identifier of the sandbox organisation to use for this request. When you send this header, the service runs the operation in the context of the named sandbox organisation, that is, against the wallet of that sandbox organisation and not against the main wallet of the organisation. Leave the header out to use the main wallet.

    The service reads this header only when you authenticate with a bearer access token. When you authenticate with an API key, the service takes the sandbox organisation from the API key and ignores this header. To run an API-key call in a sandbox organisation, bind the key to the sandbox organisation with PUT /v2/config/admin/apikey/{apiKeyId}/sandbox-org instead.

    X-SubwalletId is the deprecated name of this header. The service continues to accept it, but X-SandboxOrgId wins if you send both headers.

    The sandbox organisation must exist, must belong to your organisation and must be deployed. An unknown identifier, an identifier of a sandbox organisation that is not deployed, and an identifier that belongs to a different organisation all make the call fail with HTTP 400.

    Example: 6889e1a4c5b2f30001a3d710

Body

required

Settings of the new verifier global configuration.

    supportCredentialEncryption booleanrequired

    Set to true when the verifier accepts an encrypted OpenID4VP Authorization Response, that is a response mode of direct_post.jwt or dc_api.jwt. This property is mandatory.

    presentationRequestExpiresIn integer

    Possible values: >= 3600

    Default value: 3600

    Lifetime of an Authorization Request in seconds. The server writes this value to the exp claim of the request. The smallest value is 3600. The server uses 3600 when you leave this property out.

Responses​

The server created the verifier global configuration.

Response Headers
    Schema
      verifierGlobalConfiguration objectrequired

      Global configuration of the OpenID4VP verifier. It holds the settings that every verification request of the organisation uses.

      id stringrequired

      Record identifier of the verifier global configuration. The server makes this value when it saves the record. It is not the same value as verifierGlobalConfigurationId.

      verifierGlobalConfigurationId stringrequired

      Unique identifier of the verifier global configuration. Use this identifier to read, update or delete the record.

      openIdOrganisationId stringrequired

      Identifier of the digital wallet deployment that holds this configuration.

      supportCredentialEncryption booleanrequired

      When true, the verifier accepts an encrypted OpenID4VP Authorization Response, that is a response mode of direct_post.jwt or dc_api.jwt.

      presentationRequestExpiresIn numberrequired

      Lifetime of an Authorization Request in seconds. The server writes this value to the exp claim of the request. The smallest value is 3600, and the default is 3600.

      createdAt numberrequired

      Unix timestamp in seconds when the server made this configuration.

      updatedAt numberrequired

      Unix timestamp in seconds when the server last changed this configuration.

    Loading...
    Last updated on