Skip to content

docs: add cross-service auth without shared secrets to primer §2 - #109

Merged
ivanball merged 1 commit into
mainfrom
docs/primer-cross-service-auth
Aug 15, 2026
Merged

docs: add cross-service auth without shared secrets to primer §2#109
ivanball merged 1 commit into
mainfrom
docs/primer-cross-service-auth

Conversation

@ivanball

Copy link
Copy Markdown
Owner

Adds the ADR-004 commitment to the primer''s "Architectural styles this codebase commits to" list: cross-service tokens are RS256-signed and validated via JWKS/OIDC discovery, so only Identity ever holds signing key material.

  • Placed directly after the "Modular Monolith -> extractable services" bullet, since surviving the issuer/validator split is a precondition of that extraction promise.
  • Carries the house-style adoption note (same shape as the ADR-018 and ADR-073 entries): the in-process monolith default stays HS256 behind JwtSettings.SigningAlgorithm, Helpdesk (the monolith seed) runs issuer-less, and ADC''s Conference/Engagement/Notification services all validate through the gateway-routed discovery path.
  • First-concrete-code pointer: group-08. ADR-004 was already in the primer''s ADR table; this gives it the matching section 2 entry.
  • docs/onboarding/00-primer.html and search-index.json regenerated via npm run build (freshness gate).

🤖 Generated with Claude Code

https://claude.ai/code/session_01UCd1wonXVhuiF3ukkchXWB

Adds the ADR-004 commitment (RS256 + JWKS/OIDC discovery, only Identity
holds signing key material) to the architectural styles list, placed
after the modular monolith bullet whose extraction promise it underpins.
Includes the house-style adoption note: HS256 shared-secret stays the
in-process monolith default, Helpdesk runs issuer-less, ADC's three
validating services use the gateway-routed discovery path.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01UCd1wonXVhuiF3ukkchXWB
@ivanball
ivanball merged commit 0077b9a into main Aug 15, 2026
3 checks passed
@ivanball
ivanball deleted the docs/primer-cross-service-auth branch August 15, 2026 03:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant