Authentication

Authentication

Learn how to authenticate your applications with Kopai.

API Tokens

Kopai uses bearer tokens for API authentication. All OTLP requests must include your token in the Authorization header.

Creating a Token

1. Navigate to Settings → Access Tokens
2. Click Generate New Token
3. Give your token a descriptive name
4. Copy the token immediately (it won’t be shown again)

Using Your Token

Include your token in the Authorization header:

Authorization: Bearer YOUR_TOKEN

Or set via environment variable:

export OTEL_EXPORTER_OTLP_HEADERS="Authorization=Bearer YOUR_TOKEN"

Token Best Practices

• Use separate tokens for different environments (dev, staging, prod)
• Rotate tokens regularly
• Never commit tokens to source control
• Revoke unused tokens promptly