Skip to content

Commit cfa69d9

Browse files
committed
docs(setup-app): correct Advanced-group nav list + note JWKS gating (ADR-0066 ④)
The Advanced table listed Verifications and Device Codes, but those nav entries were deliberately removed (sensitive ephemeral secrets — not browsable; see setup-nav.contributions.ts). Also document that nav_jwks is capability-gated and sys_jwks is private-posture. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_0187GeNqezxV6g5jiLiggfbt
1 parent bc03362 commit cfa69d9

1 file changed

Lines changed: 7 additions & 2 deletions

File tree

content/docs/ui/setup-app.mdx

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,7 @@ anchors are:
5656
| **Configuration** (`group_configuration`) | All Settings · Branding · Authentication · Email · File Storage · AI & Embedder · Knowledge · Feature Flags — `platform-objects` |
5757
| **Diagnostics** (`group_diagnostics`) | Sessions · Notification Events — `platform-objects`; Audit Logs — `plugin-audit` |
5858
| **Integrations** (`group_integrations`) | `plugin-webhooks` |
59-
| **Advanced** (`group_advanced`) | OAuth Applications · Signing Keys (JWKS) · Verifications · Device Codes · Identity Links · User Preferences — `platform-objects` |
59+
| **Advanced** (`group_advanced`) | OAuth Applications · Signing Keys (JWKS) · Identity Links · User Preferences — `platform-objects` |
6060

6161
The exact rendered menu depends on which capability plugins are loaded.
6262
A few notable entries:
@@ -66,7 +66,12 @@ A few notable entries:
6666
- **OAuth Applications** (`sys_oauth_application`) — third-party OAuth
6767
client registrations, contributed into `group_advanced`.
6868
- **Signing Keys (JWKS)** (`sys_jwks`) — JWKS keys used for OIDC / JWT
69-
signing, contributed into `group_advanced`.
69+
signing, contributed into `group_advanced`. The nav item is gated on the
70+
`manage_platform_settings` capability, and the object itself is
71+
`access: { default: 'private' }` (ADR-0066 ④) — signing keys are never
72+
covered by the wildcard grant, so non-admins are denied server-side.
73+
(`sys_verification` and `sys_device_code` are deliberately **not** in the
74+
nav: sensitive, ephemeral secrets — not browsable, and also `private`.)
7075
- **Audit Logs** (`sys_audit_log`) — contributed by `plugin-audit` into
7176
`group_diagnostics`. (The `sys_activity` and `sys_comment` objects also
7277
live in `plugin-audit`, but they are not contributed as Setup nav

0 commit comments

Comments
 (0)