Settings
Configure these environment variables on the SnackBase instance (any tenancy mode):
Requires
SNACKBASE_SINGLE_TENANT_MODE=true. Multi-tenant instances must not enable
platform auth.
Worked example: Auth0
- Create an Auth0 API with identifier
https://admin.example.com/snackbase. - Create a Machine-to-Machine or SPA application that obtains access tokens for that API.
- Ensure access tokens are RS256 and include
email(and optionally custom claims). - Set on your SnackBase container:
- Mint a token from Auth0 with
audmatchingSNACKBASE_PLATFORM_AUDIENCE. - Call the admin API with
Authorization: Bearer <token>— audit entries recordauth_method=platform.
SnackBase Cloud parity
Cloud sets the same three core variables during provision (SNACKBASE_PLATFORM_ISSUER,
SNACKBASE_PLATFORM_JWKS_URL, SNACKBASE_PLATFORM_AUDIENCE={ref}). The Cloud Console
session replaces manual token handling; self-hosters use their IdP directly.
Security notes
- Platform auth is optional and default-off.
/healthand OpenAPI do not disclose whether platform auth is configured.- HS256 platform-shaped tokens are rejected.
- Disabling platform settings removes the alternate auth path entirely.