Skip to content

docs(iam): cockpit per-factory scoped keys — intent, spec, plan (#312) - #3680

Open
olafkfreund wants to merge 12 commits into
mainfrom
docs/312-cockpit-scoped-keys
Open

olafkfreund wants to merge 12 commits into
mainfrom
docs/312-cockpit-scoped-keys

Conversation

@olafkfreund

Copy link
Copy Markdown
Owner

Summary

The intent, spec and plan for one #312 slice: let the CFactory cockpit send a scoped acw_ key per factory instead of the shared wildcard APP_API_TOKEN. This is the edge docs/compliance/scoped-service-tokens.md says to do first. The code is in four PRs (linked from each other).

The user approved all three unseen on 2026-11-07 (bulk run). codex and agy reviewed each draft, and the confirmed findings were fixed before approval. The intent was amended after the spec review: the WS feed's broadcast and user scopes, and all of TFactory's feed, don't filter by org for any principal, so the original "never more than REST" constraint wasn't enforceable without a routing rewrite. The amended constraint states the boundary that is enforceable. The plan's operator checklist was corrected after the final review: a key covers one org.

Follow-up: #3679.

Refs #312

🤖 Generated with Claude Code

https://claude.ai/code/session_01WtDyDqabJ8SR4gD3ubwYx1

olafkfreund and others added 12 commits November 7, 2026 14:48
Approved unseen by user 2026-11-07, bulk run.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WtDyDqabJ8SR4gD3ubwYx1
Refs #312

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WtDyDqabJ8SR4gD3ubwYx1
…312)

Codex spec review: /ws/events broadcast/user scopes and TFactory's feed do
not filter by org for any principal, so 'never more than REST' was not
enforceable without a routing rewrite. State the enforceable boundary and
name the pre-existing gap. Re-approved unseen by user 2026-11-07, bulk run.

Refs #312

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WtDyDqabJ8SR4gD3ubwYx1
#312)

Reuse the REST principal builders, cover the rmux caller, independent WS
exception policy, delivery-level org test, name the unfiltered paths.

Refs #312

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WtDyDqabJ8SR4gD3ubwYx1
Approved unseen by user 2026-11-07, bulk run.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WtDyDqabJ8SR4gD3ubwYx1
…-keys (#312)

Refs #312

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WtDyDqabJ8SR4gD3ubwYx1
Approved unseen by user 2026-11-07, bulk run.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WtDyDqabJ8SR4gD3ubwYx1
Deviation found by the final Opus review: keys are org-bound at mint, so
membership in many orgs does not widen the cockpit's view.

Refs #312

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WtDyDqabJ8SR4gD3ubwYx1
@olafkfreund

Copy link
Copy Markdown
Owner Author

Code PRs: olafkfreund/CFactory#510 (step 1) · olafkfreund/AIFactory#2017 (step 2) · olafkfreund/PFactory#991 (step 3) · olafkfreund/TFactory#1496 (step 4).

This branch has not been deployed

No deployments
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