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

Set up Cribl integration authentication credentials

Configure credentials for the authentication method used by the Cribl integration.

Before you begin

Decide on the appropriate authentication method for your instance:

  • Basic authentication is preferred for self-hosted (On-Prem) Cribl instances.
  • Token-based authentication is required for Cribl Cloud instances.

    Note: Token-based authentication is also supported for self-hosted (On-Prem) Cribl instances.

For token-based authentication, create a client ID and a client secret on your Cribl instance and use them to generate a token. For example:

  • Client ID: 1234567890abcdef
  • Client secret: abcdef1234567890

For detailed information on the Cribl API, refer to the Cribl API documentation.

Role required: evt_mgmt_admin

Procedure

  1. Navigate to All > Connections & Credentials > Connection & Credential Aliases.

  2. Select the default Cribl credential alias: Cribl_Credential_Alias.

  3. Select New to create a credential record.

  4. Select the appropriate credentials type for your Cribl instance:

    • For basic authentication, select Basic Auth Credentials.
    • For token-based authentication, select Custom Header API Key Credential.
    • On the displayed form, fill in the fields.

    • For basic authentication:

      FieldDescription
      NameA name that describes the credentials.
      UsernameYour Cribl server username. For example: admin.
      PasswordYour Cribl server password. For example: admin123.
    • For token-based authentication:

        
      NameA name that describes the credential.
      API KeyThe authentication token you generated on the Cribl instance.
  5. Select Save to save the credentials configuration.

What to do next

  • Verify that the provided credentials have appropriate permissions to access your Cribl instance.
  • Verify that only one active credential record of each credentials type exists under the credential alias.

Parent Topic:Set up Health Log Analytics on your ServiceNow instance