Cribl

Cribl is a vendor-agnostic observability pipeline used to collect, reduce, enrich, normalize, and route data.

Asset Types Fetched

  • Devices, Users, Application Settings (when Fetch Application Settings is selected)

Data Retrieved through the Adapter

Devices - Fields such as P Addresses, Last Seen, Operating System , Cribl Edge Agent Version

Users - Email, Username, First Name, Last Name

Before You Begin

Ports

  • TCP port 80/443

Authentication Method

  • User Name/Password for Cloud
  • Client ID/Client Secret for on-prem

APIs

Axonius uses the Cribl API Reference. The following endpoints are called:

  • POST /api/v1/auth/login - Authenticates with a user name and password.
  • POST https://login.cribl.cloud/oauth/token - Authenticates with a client ID and client secret.
  • GET /api/v1/master/workers - Fetches devices.
  • GET /api/v1{Group Name Suffix}/system/users - Fetches users.
  • GET /api/v1/products/{product}/users - Fetches users for each Cribl product (Stream, Edge, Search, and Lake).
  • GET /api/v1/system/credentials - Fetches application settings (when Fetch Application Settings is selected).
  • GET /api/v1/security/kms/config - Fetches application settings (when Fetch Application Settings is selected).
  • GET /api/v1/security/kms/health - Fetches application settings (when Fetch Application Settings is selected).
  • GET /api/v1/ai/settings/disabled - Fetches application settings (when Fetch Application Settings is selected).
  • GET /api/v1/ai/settings/features - Fetches application settings (when Fetch Application Settings is selected).
  • GET /api/v1/ai/settings/guard/selected-model - Fetches application settings (when Fetch Application Settings is selected).

Permissions

The value supplied in User Name must have reader_all permissions in order to fetch assets.

Supported From Version

Supported from Axonius version 6.0

Connecting the Adapter in Axonius

To connect the adapter in Axonius, provide the following parameters:

Required Parameters

  1. Host Name or IP Address - The hostname or IP address of the Cribl server.

  2. Auth Method - Select an Authentication method, either User Name and Password (default) or Client ID and Client Secret.

  • User Name and Password - Required for this authentication method. The credentials for a user account that has the Required Permissions to fetch assets.
Cribl with User Name and Password

Cribl Settings with User Name and Password Authentication Method

Cribl with Client ID and Client Secret

Cribl Settings with Client ID and Client Secret Authentication Method


Optional Parameters

  1. Port - The port used for the connection. If the Auth Method is set to 'User Name and Password', then it defaults to 9000. If the 'Auth Method' is set to 'Client ID and Client Secret', it defaults to 443.

  2. Group Name Suffix - Enter a group name suffix to the Users endpoint (Example: /m/group_name)

  3. Verify SSL - Select whether to verify the SSL certificate of the server against the CA database inside of Axonius. For more details, see SSL Trust & CA Settings.

  4. HTTPS Proxy - Connect the adapter to a proxy instead of directly connecting it to the domain.

  5. HTTPS Proxy User Name - The user name to use when connecting to the value supplied in Host Name or IP Address via the value supplied in HTTPS Proxy.

  6. HTTPS Proxy Password - The password to use when connecting to the server using the HTTPS Proxy.

To learn more about common adapter connection parameters and buttons, see Adding a New Adapter Connection.

Advanced Settings

Note:

  1. Fetch Application Settings (default: false) - Select this option to fetch Cribl application settings and create Application Settings assets.

Did this page help you?