Skip to content

docs(organizations): roles scoped to an organization type - #15673

Open
devGregA wants to merge 1 commit into
DefectDojo:devfrom
devGregA:docs/org-type-scoped-roles
Open

docs(organizations): roles scoped to an organization type#15673
devGregA wants to merge 1 commit into
DefectDojo:devfrom
devGregA:docs/org-type-scoped-roles

Conversation

@devGregA

Copy link
Copy Markdown
Contributor

Documents granting a role against an Organization type rather than one Organization at a time, so it applies to every Organization of that type — including Organizations created later, with nothing to backfill.

Extends the existing Organizations page rather than adding a new one. Organization Types and union-of-grants membership already ship there, so the new section cross-links those instead of restating them.

The section covers:

  • what a type-scoped grant is, and the cases it exists for (compliance auditors across every regulated scope, platform teams across every Team Organization, portfolio-level reporting)
  • what it does and does not do: bounded by the role's own permissions, follows the same union-of-grants rule as membership, additive-only (a grant can never reduce access), and ignores nesting, which remains reporting-only
  • the deployment flag, DD_V3_ORGANIZATION_TYPE_ROLES, off by default
  • why managing grants is restricted to superusers and global owners, and why grants are created and revoked rather than edited
  • the note that re-typing an Organization moves it between grants' scopes

Documentation only — no code changes.

Documents granting a role against an Organization *type* rather than one Organization at a
time, so it applies to every Organization of that type and to ones created later.

Extends the existing Organizations page rather than adding one: Organization Types and
union-of-grants already ship there, so the new section cross-links them instead of
restating them. Covers what the grant does and does not do (bounded by the role, follows
membership, additive-only, ignores nesting), the deployment flag, and why managing grants
is restricted to superusers and global owners.
@devGregA devGregA added this to the 3.3.0 milestone Aug 15, 2026
@github-actions github-actions Bot added the docs label Aug 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant