Skip to Content
LYNKORIADocs

ADR 003: Console admin authentication

  • Status: Superseded in part (2026-11-13): the console now signs in with passwords and server-side sessions created by the operator CLI; Cloudflare Access is an optional extra layer whose identity must match the session. See admin access.
  • Owner: Eng lead
  • Date: 2026-11-12

Context

Building identity, MFA and offboarding is out of scope.

Decision

The console and /v1/admin/* sit behind Cloudflare Access tied to the company IdP. The API verifies the Cf-Access-Jwt-Assertion JWT (issuer, AUD, RS256) on every request and maps the email to console_roles.

Consequences

Offboarding happens in the IdP. Admin endpoints never accept service keys and vice versa.

On this page