Skip to content
Release: Australia · Updated: 2026-03-12 · Official documentation · View source

Set up a JWT key

Configure a JWT key to enable secure authentication for Card Data Security. This is used to sign the authentication tokens that ServiceNow sends to external systems.

Before you begin

Role required: admin

This task needs the following:

Card network \(Visa, Mastercard\)- A X.509 certificate created for Card Data Security. See Create an X.509 Certificate for more information. - The key alias that was defined when generating the JKS file for Card Data Security. See Create a JKS file for more information. - The credentials JSON file obtained from the tokenizer service.
VerifiSee Set up Verifi integration for a list of required values.

Procedure

  1. Navigate to All > System OAuth > JWT Keys.

  2. Select New.

  3. For card network integrations, enter the following field values.

    FieldValue
    Name<Name of the JWT key>
    Signing Keystore<The X.509 certificate created for Card Data Security>
    Signing Key<The key alias defined when generating the JKS file>
    Key ID<The keyID value from the credentials JSON file>

    For a Verifi integration, enter the following field values.

    FieldValue
    Name<Name of the JWT key>
    Signing AlgorithmHMAC256, or the value specified by Verifi at the time of account creation
    Signing Key<The key alias defined when generating the JKS file>
    Key ID<The keyID value from the credentials JSON file>
  4. Select Submit.

Result

A JWT Key record is created.

What to do next

Set up a JWT Provider.