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
-
Host Name or IP Address - The hostname or IP address of the Cribl server.
-
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.
- Client ID and Client Secret - Required for this authentication method. The Client ID and Client Secret for an account that has permissions to fetch assets. Refer to API Docs | Cribl Docs for information on how to create the Client ID and Client Secret.
Cribl Settings with User Name and Password Authentication Method
Cribl Settings with Client ID and Client Secret Authentication Method
Optional Parameters
-
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.
-
Group Name Suffix - Enter a group name suffix to the Users endpoint (Example: /m/group_name)
-
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.
-
HTTPS Proxy - Connect the adapter to a proxy instead of directly connecting it to the domain.
-
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.
-
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:
- Advanced settings can apply to either all connections of this adapter, or to a specific connection. For more detailed information, see Advanced Configuration for Adapters.
- For more general information about advanced settings, see Adapter Advanced Settings.
- Fetch Application Settings (default: false) - Select this option to fetch Cribl application settings and create Application Settings assets.
Updated 5 days ago
