Skip to content

Commit bc359a7

Browse files
committed
docs(permissions): the platform-admin grant anchor is the Default Organization's; an organization-less grant anchors nothing
Claude-Session: https://claude.ai/code/session_01GvYt2WyJja4rEjcy6pdD4p Co-authored-by: Claude <noreply@anthropic.com>
1 parent 980cdc1 commit bc359a7

1 file changed

Lines changed: 11 additions & 9 deletions

File tree

‎content/docs/permissions/permission-sets.mdx‎

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -187,15 +187,17 @@ sufficient depends on the deployment's
187187
are one administrator, not two half-matches. Nothing is stored and nothing is
188188
granted — the answer is recomputed from configuration on every resolution.
189189
This anchor is read under every posture.
190-
- **An unscoped `admin_full_access` grant row** — a `sys_user_permission_set`
191-
row with `organization_id = NULL`, the original anchor. It confers standing
192-
under the `single` posture only. Under the walled postures (`group` /
193-
`isolated`) the row is no longer an anchor: the set it names still grants
194-
what any held set grants, but it confers no `PLATFORM_ADMIN` standing, and
195-
nothing is logged about it per request. If a walled deployment holding such a
196-
row ends up with no usable configured administrator, the boot log says it has
197-
zero platform administrators, names the account that holds the row, and points
198-
at `OS_PLATFORM_OWNER_EMAIL` as the way to restore that account's standing.
190+
- **The Default Organization's `admin_full_access` grant row** — a
191+
`sys_user_permission_set` row owned by the Default Organization, the row the
192+
`single` first-user promotion writes. It confers standing under the `single`
193+
posture only. An organization-less grant (`organization_id = NULL`, the row an
194+
earlier release's promotion wrote, which the ownership ceremony attributes to
195+
an organization) anchors nothing, in any posture. Under the walled postures
196+
(`group` / `isolated`) no grant row is an anchor: the set it names still
197+
grants what any held set grants, but it confers no `PLATFORM_ADMIN` standing,
198+
and nothing is logged about it per request. A walled deployment that declares
199+
no usable configured administrator is told so at boot: the log says it has
200+
zero platform administrators and points at `OS_PLATFORM_OWNER_EMAIL`.
199201

200202
Which anchor a fresh deployment gets depends on its
201203
[tenancy posture](/docs/deployment/tenancy-modes). Under `single` the first

0 commit comments

Comments
 (0)