Skip to content

docs(sso): Document email change restrictions with SSO enforcement#16690

Open
inkeep[bot] wants to merge 1 commit intomasterfrom
docs-writer-ai-update-2026-05-01T12-48-23-051Z-kx9rs0
Open

docs(sso): Document email change restrictions with SSO enforcement#16690
inkeep[bot] wants to merge 1 commit intomasterfrom
docs-writer-ai-update-2026-05-01T12-48-23-051Z-kx9rs0

Conversation

@inkeep
Copy link
Copy Markdown
Contributor

@inkeep inkeep Bot commented May 1, 2026

Changes

This PR documents new SSO and email change behavior introduced in PostHog/posthog#56232.

What's documented:

  1. SSO enforcement blocks email changes – Users on an SSO-enforced domain can no longer change their email address, preventing:

    • Bypassing SSO enforcement by switching to a non-enforced domain
    • Lockout scenarios when changing to an SSO-enforced domain without a password
  2. Social auth cleanup on email change – When a user verifies a new email address, all social authentication connections (Google, GitHub, GitLab) are automatically disconnected to prevent the old identity from accessing the account.

Files changed:

  • contents/docs/settings/sso.mdx – Added "Email change restrictions" subsection under SSO enforcement

This PR was created by the Inkeep Content Writer agent, which is maintained by the Docs and Wizard team. Please reach out on Slack for help if needed.

Reflects changes from PostHog/posthog#56232:
- SSO-enforced domains block email changes (both from and to)
- Social auth providers are disconnected on verified email change
- Fix Organization settings URL to use app.posthog.com
@inkeep inkeep Bot requested a review from a-lider May 1, 2026 12:50
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 1, 2026

Deploy preview

Status Details Updated (UTC)
🟢 Ready View preview May 01, 2026 01:01PM

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 1, 2026

Vale prose linter → found 0 errors, 14 warnings, 8 suggestions in your markdown

Full report → Copy the linter results into an LLM to batch-fix issues.

Linter being weird? Update the rules!

contents/docs/settings/sso.mdx — 0 errors, 14 warnings, 8 suggestions
Line Severity Message Rule
68:81 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
86:81 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
92:182 warning 'unmanaged' is a possible misspelling. PostHogBase.Spelling
94:12 suggestion Address the reader directly. Use 'you can' instead of 'users can'. PostHogDocs.DirectAddress
114:96 warning 'OAuth' is a possible misspelling. PostHogBase.Spelling
116:54 warning Use American English. Use 'organization' instead of 'organisation'. PostHogBase.AmericanEnglish
116:121 warning 'OAuth' is a possible misspelling. PostHogBase.Spelling
116:139 warning 'OAuth' is a possible misspelling. PostHogBase.Spelling
119:39 warning Use 'URL' instead of 'url'. Vale.Terms
120:53 warning Use 'URL' instead of 'url'. Vale.Terms
135:39 warning Use 'URL' instead of 'url'. Vale.Terms
152:49 warning 'OAuth' is a possible misspelling. PostHogBase.Spelling
160:139 warning 'OAuth' is a possible misspelling. PostHogBase.Spelling
166:326 suggestion Address the reader directly. Use 'you can' instead of 'users can'. PostHogDocs.DirectAddress
176:58 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
178:103 suggestion Address the reader directly. Use 'you can' instead of 'users can'. PostHogDocs.DirectAddress
246:38 warning Capitalize 'Logs' for PostHog's product. Use 'logs' for the general industry concept. PostHogBase.ProductNames
286:23 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
287:28 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
288:27 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
328:205 suggestion Address the reader directly. Use 'you' instead of 'the user'. PostHogDocs.DirectAddress
350:58 warning 'Entra' is a possible misspelling. PostHogBase.Spelling

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented May 1, 2026

Hey @a-lider! This docs PR was generated for you by an agent. You're responsible for reviewing and merging it into production.

  1. Review and approve the PR
  2. Merge the PR
    a. Check the preview env and CI build and merge it yourself
    b. Enable auto-merge if you're confident in the changes

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.

0 participants