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.