Skip to content

Update SSO configuration instructions #17538

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
LordSimal wants to merge 2 commits into
base: master
Choose a base branch
from
+4 −0
Open

Update SSO configuration instructions #17538

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
d7ceb95
Update SSO configuration instructions
LordSimal Apr 29, 2026
c47084a
Update SSO configuration instructions
LordSimal Apr 29, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions develop-docs/self-hosted/configuration/sso.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,10 @@ auth-google.client-id: '<client id>'
auth-google.client-secret: '<client secret>'
```

The redirect URL should be `${url-prefix}/auth/sso/`.

After that you need to go into your Organization Settings => Organization => Auth and enable the Google Provider.
Copy link
Copy Markdown

@sentry sentry Bot Apr 29, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Bug: The navigation path Organization Settings => Organization => Auth is incorrect. The correct path to Sentry's Auth settings is Org Settings > Auth.
Severity: LOW

Suggested Fix

Update the navigation path in sso.mdx to Org Settings > Auth to match the actual UI and other documentation. The URL can also be provided for clarity: /settings/ORG_SLUG/auth/.

Prompt for AI Agent 
Review the code at the location below. A potential bug has been identified by an AI
agent. Verify if this is a real issue. If it is, propose a fix; if not, explain why it's
not valid.

Location: develop-docs/self-hosted/configuration/sso.mdx#L42

Potential issue: The documentation provides an incorrect navigation path for accessing
SSO settings: `Organization Settings => Organization => Auth`. The intermediate `=>
Organization =>` step does not exist in the Sentry UI. The correct path is `Org Settings
> Auth`, as confirmed by other documentation files. This error will prevent users from
finding the authentication settings page, hindering their ability to configure SSO.

Did we get this right? 👍 / 👎 to inform future reviews.


<Alert title="Note">
After changing configuration files, re-run the <code>./install.sh</code> script, to rebuild and restart the containers. See the <Link to="/self-hosted/#configuration">configuration section</Link> for more information.
</Alert>
Expand Down
Loading