Set up a JWT key

task australia Updated Sep 10, 2026 1 min read set-up-a-jwt-key.md
Raw file servicenow.com

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.

Verifi

See 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.

    Field Value
    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.

    Field Value
    Name <Name of the JWT key>
    Signing Algorithm HMAC256, 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.

Keywords set up jwt keyjwt keyjson web token keysigning keystoresigning keykey idsystem oauth jwt keyscard data security jwtconfigure jwt keyx509 certificate signing
Search documentation
Search document titles and file paths on the australia branch