Skip to content

Commit ad23186

Browse files
committed
docs(permissions): the sharing-rules page names the external role's channels (#25233 stage 2)
An external principal is an organization member holding the external role; its org-wide default is owner-only, and shares, sharing rules, share links and held grant RLS widen it. Co-authored-by: Claude <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01AZbN6PU5Xz4WTi6NKmyKhN
1 parent f3c0fc1 commit ad23186

1 file changed

Lines changed: 13 additions & 6 deletions

File tree

‎content/docs/permissions/sharing-rules.mdx‎

Lines changed: 13 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -125,14 +125,21 @@ only narrows, so it cannot make a `private` row visible. On `public_read` and
125125
## External principals — no external org-wide default
126126

127127
There is one org-wide default, `sharingModel`. An external (portal or
128-
partner) principal reaches **explicitly shared rows only** — the authorization
129-
kernel's `EXTERNAL` rung (ADR-0095), never derived from an org-wide default.
130-
Grant it a row with a manual share or a sharing rule, or publish a record
131-
through a share link (`publicSharing`).
128+
partner) principal — an organization member holding the `external` role —
129+
reaches rows through **explicit grants only**: the authorization kernel's
130+
`EXTERNAL` rung (ADR-0095), never derived from an org-wide default. For an
131+
external, every object's org-wide default is owner-only; it reads and writes
132+
the rows it owns and the rows granted to it:
133+
134+
- a manual share or a sharing rule;
135+
- a share link (`publicSharing`);
136+
- a permission set or position it holds whose `rowLevelSecurity` speaks for
137+
the object (for example `supplier in current_user.<key>`). Such a policy
138+
lifts the owner-only floor for that object, and the policy bounds the rows.
132139

133140
`externalSharingModel`, the external dial ADR-0090 D11 declared, was removed
134-
in `@objectstack/spec` 18 (ADR-0049 enforce-or-remove): no request ever
135-
resolved an external principal, so the value changed no answer. The schema
141+
in `@objectstack/spec` 18 (ADR-0049 enforce-or-remove): while it existed no
142+
request resolved an external principal, so the value changed no answer. The schema
136143
refuses it with the prescription "delete the key";
137144
`os migrate meta --from 17` lists the mechanical edits for existing sources.
138145

0 commit comments

Comments
 (0)