Skip to main content

Update verifier global configuration

PUT 
/v2/config/digital-wallet/openid/verifier/global-configuration/:globalConfigurationId

Updates the global configuration of the OpenID4VP verifier.

Send the full set of settings. supportCredentialEncryption is mandatory in every update request.

Always send presentationRequestExpiresIn too. If you leave it out, the server sets the lifetime of the Authorization Request to 0 seconds instead of the default 3600.

Request​

Path Parameters

    globalConfigurationId stringrequired

    Unique identifier of the global configuration. Give globalConfigurationId for the issuer operations, holderGlobalConfigurationId for the holder operations, and verifierGlobalConfigurationId for the verifier operations. Do not give the id field of the record.

    Example: b7d1f4a2-8c3e-4a91-9f52-0d3c6e7a1b45

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

New settings of the 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

    Lifetime of an Authorization Request in seconds. The server writes this value to the exp claim of the request. The smallest value is 3600. If you leave this property out, the server stores 0 instead of the default.

Responses​

The server updated 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