Skip to content

docs: document that only a server administrator can set the organization SSO domain - #1131

Open
Anty0 wants to merge 1 commit into
mainfrom
jirikuchynka/document-sso-domain-admin-only
Open

docs: document that only a server administrator can set the organization SSO domain#1131
Anty0 wants to merge 1 commit into
mainfrom
jirikuchynka/document-sso-domain-admin-only

Conversation

@Anty0

@Anty0 Anty0 commented Jul 29, 2026

Copy link
Copy Markdown
Member

The SSO docs listed Domain name as one of the fields an organization owner fills in, with no hint that the field is admin-only. In the product, the domain can only be set or changed by a server administrator:

  • SsoProviderController.setProvider passes allowChangeDomain = authenticatedUser.isAdmin()
  • TenantServiceImpl.createOrUpdate throws SSO_DOMAIN_NOT_ALLOWED when a non-admin changes the domain (a new tenant starts with an empty domain, so a non-admin owner can never set it either)
  • The webapp disables the field for non-admins and shows the helper text "E-mail domain for org members; contact your admin or support to change it"

Changes:

  • sso_getting_started.mdx — the Domain name row now says only a server administrator can set it, plus a callout explaining who to ask (Tolgee support on Cloud, the instance administrator when self-hosted) and that SSO cannot be enabled until the domain is set, since it is a required field for an enabled configuration.
  • sso_server_setup_organizations.mdx — new section describing how a server administrator sets the domain from Administration > Organizations > Settings, and why the restriction exists.

@netlify

netlify Bot commented Jul 29, 2026

Copy link
Copy Markdown

Deploy Preview for tolgee-docs ready!

Name Link
🔨 Latest commit 74002a6
🔍 Latest deploy log https://app.netlify.com/projects/tolgee-docs/deploys/6a6a46e1488cb700086803ea
😎 Deploy Preview https://deploy-preview-1131--tolgee-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

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

@Anty0
Anty0 requested a review from Barush July 29, 2026 18:33
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