Skip to content

Cleanup: fix docs and provisioning instructions#1

Open
shaq-authlete wants to merge 3 commits into
mainfrom
refactor/cleanup
Open

Cleanup: fix docs and provisioning instructions#1
shaq-authlete wants to merge 3 commits into
mainfrom
refactor/cleanup

Conversation

@shaq-authlete

Copy link
Copy Markdown

Part 1 of making this repo customer-presentable. Docs and config hygiene only, no behavior changes.

Changes

  • .env.example: added a key generation command for AS_SIGNING_JWKS, pointed at the Authlete console for credentials, fixed a wrong comment (AS signing keys are auto-served at /oauth/jwks, no Authlete registration needed)
  • README: removed a reference to src/userstore.ts which does not exist
  • README provisioning: added the fresh-service gotcha (register a service JWK Set or ID token issuance fails with A162201), exact test RP client settings, and a table of the three key pairs involved in the setup
  • Unified naming to "Interaction Protocol"
  • CLAUDE.md is now gitignored (local agent notes)

Verification

Full E2E smoke test (auth-ui/scripts/smoke-e2e.mjs) passes against a running stack. See the companion PR: authlete/auth-ui#2

Further cleanup (script hygiene, comment fixes) is planned in a follow-up, tracked in the task notes.

🤖 Generated with Claude Code

shaq-authlete and others added 3 commits July 13, 2026 21:39
- Point to the Authlete console for service ID and API token
- Fix wrong comment: AS signing keys are auto-served at /oauth/jwks,
  no registration with Authlete needed
- Add a jose one-liner to generate the ES256 interaction JWKS
- Rename 'Component protocol v0.3' to 'Interaction Protocol'

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- Remove reference to src/userstore.ts (file does not exist)
- Fix provisioning: AS signing key is auto-served at /oauth/jwks,
  not registered with Authlete
- Add fresh-service gotcha: register a service JWK Set or ID token
  issuance fails with A162201
- Spell out the exact test RP client settings
- Add the three-key-pairs table
- Add AS_SIGNING_JWKS to the config table
- Ignore CLAUDE.md (local agent notes)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Users new to Authlete had no pointer for how to actually create the
account, service, and client in the console. Also note where the test
client id ends up (RP_CLIENT_ID in auth-ui's .env).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
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