Set up Cribl integration authentication credentials

task brazil Updated Sep 10, 2026 1 min read hla-setup-cribl-credentials.md

Configure credentials in Health Log Analytics 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

Navigate to All > Connections & Credentials > Connection & Credential Aliases.
Select the default Cribl credential alias: Cribl_Credential_Alias.
Select New to create a credential record.
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:
  
  Field Description
  
  Name A name that describes the credentials.
  
  Username Your Cribl server username. For example: admin.
  
  Password Your Cribl server password. For example: admin123.
- For token-based authentication:
  
  Name A name that describes the credential.
  
  API Key The authentication token you generated on the Cribl instance.
Select Save to save the credentials configuration.

Field	Description
Name	A name that describes the credentials.
Username	Your Cribl server username. For example: admin.
Password	Your Cribl server password. For example: admin123.


Name	A name that describes the credential.
API Key	The authentication token you generated on the Cribl instance.

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

Keywords Health Log AnalyticsCriblintegrationauthenticationcredentialsbasic authtoken-based

78 lines · 3.1 KB Wrap lines

---
title: Set up Cribl integration authentication credentials
description: Configure credentials in Health Log Analytics for the authentication method used by the Cribl integration.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/it-operations-management/health-log-analytics/hla-setup-cribl-credentials.html
release: brazil
product: Health Log Analytics
classification: health-log-analytics
topic_type: task
last_updated: "2026-09-10"
reading_time_minutes: 1
keywords: [Health Log Analytics, Cribl, integration, authentication, credentials, basic auth, token-based]
breadcrumb: [Cribl, Set up integrations from Integrations Launchpad, Set up HLA on your instance, Configuring, Health Log Analytics, ITOM AIOps, IT Operations Management]
---

# Set up Cribl integration authentication credentials

Configure credentials in Health Log Analytics 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](https://docs.cribl.io/api/) documentation.

Role required: evt\_mgmt\_admin

## Procedure

1.  Navigate to **All** &gt; **Connections &amp; Credentials** &gt; **Connection &amp; 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**.
5.  On the displayed form, fill in the fields.

    -   For basic authentication:

        |Field|Description|
        |-----|-----------|
        |Name|A name that describes the credentials.|
        |Username|Your Cribl server username. For example: admin.|
        |Password|Your Cribl server password. For example: admin123.|

    -   For token-based authentication:

        | | |
        |---|---|
        |Name|A name that describes the credential.|
        |API Key|The authentication token you generated on the Cribl instance.|

6.  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](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/it-operations-management/health-log-analytics/hla-implement.md)