DigipassONE Verify is part of v10.0 and v10.1 - a limited, early access release for users who wish to evaluate supporting digital credentials in their applications.
It is not intended for production use.

DigipassONE Verify: a note for evaluation users

Prev Next

Digital credential support is already enabled on the DigipassONE Verify server for evaluation users. Preconfigured settings are listed below, along with examples of digital credential policies and types that are included with your tenant.

Preconfigured settings

  • Digital credential policy

    The policy is available with Allow Digital Credentials enabled.

  • Digital credential criteria

    The policy includes the credential criteria required for the evaluation flow.

  • Registration sequence

    The default registration decision rule includes a digital credential registration sequence that uses the preconfigured policy.

  • Authentication sequence

    The default authentication rule includes a digital credential authentication sequence that uses the preconfigured policy.

  • Digital Credential Processor plugin

    The plugin is enabled and should show an ACTIVE status.

  • Cryptographic considerations

    The issuer and verifier use ES256 signing keys with the did:jwk scheme.

Sample preconfigured Digital Credential policy JSON

This sample policy JSON is configured with issuanceCriteria and verificationCriteria for a tenant with ID noknok.

Important things to note in the sample policy JSON:

  • It supports digital credentials in SD-JWT format

  • Issuance is configured to use pre-authorized flow. Before the app interacts with the wallet, it should have already authenticated before initiating the issuance flow.

  • Verification is configured for same_device flow. Your app and the wallet are expected to be on the same mobile device.

  • It refers to OneSpanBankAuthCredential.json which contains a definition of a bank-issued digital credential for strong customer authentication purposes.

{
    "dcDefault": {
        "version": "1.0",
        "description": "Digital Credential Policy for Evaluation",
        "attributes": {
            "dcCriteria": {
                "issuanceCriteria": {
                    "expiryTimeInSeconds": 120,
                    "issuanceCredentials": [
                        {
                            "credentialConfigurationId": "noknok_onespan_bank_auth_dc_sd_jwt",
                            "format": "dc+sd-jwt",
                            "issuerUrl": "https://demo.example.com/noknok",
                            "issuerOfferPath": "/nnlgateway/dc",
                            "valueMode": "BY_VALUE",
                            "authMode": "PRE_AUTHORIZED"
                        }
                    ]
                },
                "verificationCriteria": {
                    "expiryTimeInSeconds": 120,
                    "verifierUrl": "https://demo.example.com",
                    "verifierPresentationPath": "/nnlgateway/dc/noknok",
                    "flowType": "same_device",
                    "clientId": "https://demo.example.com/nnlgateway/dc/noknok/v2/native/response",
                    "dcql_query": {
                        "credentials": [
                            {
                                "id": "noknok_onespan_bank_auth_dc_sd_jwt",
                                "format": "dc+sd-jwt",
                                "meta": {
                                    "vct_values": [
                                        "https://demo.example.com/noknok/OneSpanBankAuthCredential.json"
                                    ]
                                },
                                "claims": [
                                    {
                                        "path": [
                                            "userName"
                                        ]
                                    },
                                    {
                                        "path": [
                                            "bankAccountNumber"
                                        ]
                                    }
                                ]
                            }
                        ]
                    }
                },
                "riskThreshold": 20
            }
        }
    }
}

Sample preconfigured Digital Credential type JSON

This sample credential type JSON defines the OneSpanBankAuthCredential.json type referenced by the preconfigured policy.

{
  "vct": "https://demo.example.com/noknok/OneSpanBankAuthCredential.json",
  "name": "OneSpan Bank Auth",
  "description": "This is a digital credential for banking use cases"
  "claims": [
    {
      "path": ["userName"],
      "display": [
        {
          "lang": "en-US",
          "name": "Username",
          "description": "The user's name."
        },
        {
          "lang": "de-DE",
          "name": "Benutzername",
          "description": "Der Name des Benutzers."
        }
      ],
      "sd": "allowed",
      "mandatory": true
    },
    {
      "path": ["bankAccountNumber"],
      "display": [
        {
          "lang": "en-US",
          "name": "Bank Account Number",
          "description": "The user's bank account number."
        },
        {
          "lang": "de-DE",
          "name": "Bankkontonummer",
          "description": "Die Bankkontonummer des Benutzers."
        }
      ],
      "sd": "allowed",
      "mandatory": true
    }
  ]
}

Contact OneSpan Support if you have any questions or feedback about these configurations.