plugin tokens - nself-org/cli GitHub Wiki
Tokens Plugin
HLS encryption keys, content delivery tokens, and entitlement checks. Free, MIT licensed.
Install
nself plugin install tokens
What It Does
Manages HLS encryption keys for video delivery, issues time-limited content delivery tokens, and performs entitlement checks before serving protected content. Used by video streaming setups to gate content behind authentication without requiring per-request auth server calls.
Configuration
| Env Var | Default | Description |
|---|---|---|
TOKENS_PORT |
3108 |
Service port |
TOKENS_SECRET |
(auto-generated) | Token signing secret |
TOKENS_TTL |
3600 |
Default token TTL in seconds |
TOKENS_HLS_KEY_ROTATION |
3600 |
HLS key rotation interval |
Ports
| Port | Purpose |
|---|---|
| 3108 | Tokens REST API |
Database Tables
5 tables added to your Postgres database:
np_tokens_tokens, issued token recordsnp_tokens_hls_keys, HLS encryption key archivenp_tokens_entitlements, user content entitlementsnp_tokens_revocations, revoked tokensnp_tokens_audit, token issuance audit log
Nginx Routes
| Route | Target |
|---|---|
/tokens/ |
Token issuance and validation API |
/keys/ |
HLS key delivery endpoint |