Skip to content

docs(enterprise): cover 2.4.0 SSO/SCIM/MFA/M2M gaps, fix drift#76

Open
lakhansamani wants to merge 2 commits into
mainfrom
docs/2.4.0-enterprise-m2m-a2a-gaps
Open

docs(enterprise): cover 2.4.0 SSO/SCIM/MFA/M2M gaps, fix drift#76
lakhansamani wants to merge 2 commits into
mainfrom
docs/2.4.0-enterprise-m2m-a2a-gaps

Conversation

@lakhansamani

Copy link
Copy Markdown
Contributor

Summary

Server shipped a batch of enterprise features after 2.3.0 with zero docs, plus a few existing pages drifted from current code. Verified every claim against authorizerdev/authorizer @ e26a1253 (2.4.0-rc.8) — grepped real GraphQL/gRPC/REST op names and source behavior, not just commit messages or the pre-implementation design specs (a few places where the spec's proposed name/flag/default didn't match what shipped, e.g. --enable-org-discovery defaults false not true, auto-verify domain method never shipped).

New pages

  • enterprise/saml-idp.md — Authorizer as a SAML 2.0 Identity Provider (issuing assertions to downstream SPs), key rotation, SCIM-group → SAML-group projection
  • enterprise/org-domains.md — verified domains + Home Realm Discovery

Gap-filled / drift-fixed

  • scim.md — Groups (previously documented as "not yet implemented"), filter operators, full user PATCH, provisioning webhooks
  • security.md / server-config.md / migration/v1-to-v2.md — WebAuthn/passkey ceremonies, MFA default-on + --disable-mfa, withheld-token first-time setup, lockout + admin recovery
  • client-registry.md — service accounts as FGA subjects, public client_id, 503 on transient lookup failure
  • workload-identity.md — Kubernetes TokenReview config now admin-settable
  • oauth2-oidc.md / grpc.md / rest-api.md — RFC 8414 discovery alias, RFC 8707 resource binding on the auth-code flow, refresh-reuse grace window, 21 admin RPCs that existed in proto but not in docs
  • graphql-api.mdskip_mfa_setup / lock_mfa / email_otp_mfa_setup / sms_otp_mfa_setup were undocumented on every surface (GraphQL/gRPC/REST)
  • organizations.md / org-saml.md — cross-link the two new pages
  • sidebars.ts — wire in new pages, renumber sidebar_position

Overlaps in scope with open PR #75 (MFA default-on flags/meta fields) are expected — that PR is narrower and unmerged; this branch documents the full current MFA state independently.

Test plan

  • npm run build — clean, no broken-link warnings
  • npm run typecheck — clean
  • Editorial review of new pages (saml-idp.md, org-domains.md) for tone/accuracy

Server shipped a batch of enterprise features after 2.3.0 with no docs,
and a few existing pages had drifted from the current code:

- add SAML 2.0 Identity Provider role (enterprise/saml-idp.md)
- add verified domains + home realm discovery (enterprise/org-domains.md)
- scim.md: groups (was documented as unimplemented), filter operators,
  full user PATCH, provisioning webhooks
- security.md/server-config.md: WebAuthn/passkey ceremonies, MFA
  default-on + --disable-mfa, withheld-token setup, lockout + admin
  recovery
- client-registry.md: service accounts as FGA subjects, public
  client_id, 503 on transient lookup failure
- workload-identity.md: TokenReview config now admin-settable
- oauth2-oidc.md/grpc.md/rest-api.md: RFC 8414 alias, RFC 8707 resource
  binding on auth-code flow, refresh-reuse grace window, 21 missing
  admin RPCs
- graphql-api.md: skip_mfa_setup/lock_mfa/email_otp_mfa_setup/
  sms_otp_mfa_setup were undocumented on every surface (GraphQL/gRPC/
  REST)
- organizations.md/org-saml.md: cross-link the two new pages
- sidebars.ts: wire in new pages, renumber sidebar_position

Every claim verified against authorizer @ e26a1253 (2.4.0-rc.8), not
just commit messages or the pre-implementation design specs.
@netlify

netlify Bot commented Jul 23, 2026

Copy link
Copy Markdown

Deploy Preview for authorizerdev-docs ready!

Name Link
🔨 Latest commit 3a01a34
🔍 Latest deploy log https://app.netlify.com/projects/authorizerdev-docs/deploys/6a61c07c2dcebb0007556a70
😎 Deploy Preview https://deploy-preview-76--authorizerdev-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

…ation

- organizations.md/org-saml.md/org-sso-oidc.md/scim.md: fix false
  "super-admin only" claim; document authorizer:org_admin role
- server-config.md/security.md: document --url trusted-base-url flag
  (closes CWE-640 host-header-injection)
- security.md/graphql-api.md: document synchronous session revocation
  on self-service password reset
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