docs(access): describe acting context enforcement

This commit is contained in:
2026-08-19 22:16:18 +02:00
parent 3661fdd370
commit 38fc22c06b
3 changed files with 13 additions and 6 deletions
+5 -2
View File
@@ -146,8 +146,11 @@ The backend foundation exposes these administration routes:
- `/api/v1/admin/function-assignments`
- `/api/v1/admin/function-delegations`
Dedicated WebUI management panels and explicit acting-in-place context
selection are still follow-up work on top of these routes.
Dedicated WebUI management panels remain follow-up work on top of these routes.
Interactive acting-in-place selection is available through
`/api/v1/auth/acting-contexts` and `/api/v1/auth/switch-acting-context`; it
persists the exact selected assignment and represented account on the session,
audits each switch, and fails closed when the assignment is no longer effective.
## Removed Compatibility Paths
+5 -4
View File
@@ -161,6 +161,10 @@ Implemented backend foundation:
delegation identifiers when those facts exist.
- The access manifest registers `access.semanticDirectory` and
`access.explanation` capabilities.
- Interactive sessions can list `/api/v1/auth/acting-contexts` and explicitly
select or clear one with `/api/v1/auth/switch-acting-context`. Every switch is
audited. API keys cannot select an acting context, and a stale, expired,
revoked, or account-mismatched assignment fails closed.
Remaining rollout:
@@ -169,9 +173,6 @@ Remaining rollout:
projection until migration is complete.
2. Add dedicated WebUI management panels for identities, organization units,
functions, assignments, and delegations.
3. Add explicit acting-in-place context selection; `act_in_place` delegation
facts are stored now but do not silently grant permissions without a selected
acting context.
4. Retrofit postbox, workflow, portal, and audit consumers to use identity,
3. Retrofit postbox, workflow, portal, and audit consumers to use identity,
organization, and access explanation capabilities rather than local access
assumptions.