Skip to content

docs(users): document that system-level actions share one permission - #650

Draft
MRmarioruci wants to merge 1 commit into
mainfrom
docs/system-level-actions-share-one-permission
Draft

docs(users): document that system-level actions share one permission#650
MRmarioruci wants to merge 1 commit into
mainfrom
docs/system-level-actions-share-one-permission

Conversation

@MRmarioruci

@MRmarioruci MRmarioruci commented Aug 10, 2026

Copy link
Copy Markdown
Contributor

Change

Documentation only.

SystemUpgrade, SetDisasterRecovery and SystemRestore are presented as three separately-labelled actions in the policy editor, and the docs tell operators to configure policies per action. All three resolve to a single permission, and matching policies are OR-combined, so the least restrictive policy on any of them governs all three. SystemRestore has no specifier of its own and cannot be scoped independently.

Adds a section to the user guide on permissions and policies setting that out, so operators can size a delegation of any of the three correctly.

No code change.

Follow-up

A matching affordance in the policy editor would be the natural complement, but the action label is reused in request titles and lists, so where it belongs is a design decision rather than a locale edit.

SystemUpgrade, SetDisasterRecovery and SystemRestore are presented as
separate actions in the wallet and the policy editor, but all three
resolve to a single permission. Policies are matched by that shared key
and OR-combined, so the least restrictive policy on any of the three
governs all of them, and SystemRestore cannot be scoped at all.

Delegating disaster recovery configuration is also terminal on its own,
since it sets which group is the recovery committee and its quorum, so a
group able to approve it can appoint itself and recover the station with
code of its choosing.

Document both so operators can size the delegation correctly.

Co-Authored-By: Claude Opus 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