Skip to Content
LYNKORIADocs

ADR 002: v1 product → Lynkoria authentication

  • Status: Accepted
  • Owner: Eng lead
  • Date: 2026-11-12

Context

Product backends already authenticate their users. Lynkoria must never trust a client-supplied project, user or room.

Decision

Server-to-server service API keys only (lynk_live_ / lynk_test_), HMAC-SHA256 digested with a pepper outside the database, bound to one project environment and scoped. Product-signed JWKS assertions are deferred.

Consequences

Every token request is a round trip through the product backend. Revocation is immediate (no key cache). A key from one project can never act on another.

On this page