Set up a JWT key

  • Release version: Australia
  • Updated March 12, 2026
  • 1 minute to read
  • 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:
    Table 1. Set up requirements
    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.
      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 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.