Ingest Tokens

Humio has two kinds of API tokens; Personal API Tokens and Ingest Tokens.

Personal API Token

All users have a Personal API Token, which you can find in your account settings page. This is used for accessing the management API, for example when you create new repositories. These tokens should not be used for sending data to Humio, even though this is strictly possible. For that, you use ingest tokens.

Ingest Tokens

Unlike Personal API Tokens, you cannot use Ingest Tokens to manage Humio. Ingest tokens are a per-repository token that allows you to send data to a specific repository. They are also write-only, meaning you cannot query Humio, log in, or read any data.

Ingest tokens are tied to a repository instead of a user. This provides a better way of managing access control and is more convenient for most use cases.

For example, if a user leaves the organization or project, you do not need to reprovision all agents that send data with a new token. You also don’t have to create fake “Bot” user accounts.

You can manage your ingest tokens in the Settings tab in each repository.

Assigning a Token to a Parser

See how to assign a parser to an ingest token in Assigning Parsers to API Tokens.