Skip to content

fix(azure): stuck self-hosted Azure SSO installation setup #18638

Open
aldy505 wants to merge 1 commit into
masterfrom
aldy505/fix/azure-sso-self-hosted
Open

fix(azure): stuck self-hosted Azure SSO installation setup #18638
aldy505 wants to merge 1 commit into
masterfrom
aldy505/fix/azure-sso-self-hosted

Conversation

@aldy505

@aldy505 aldy505 commented Jul 5, 2026

Copy link
Copy Markdown
Collaborator

DESCRIBE YOUR PR

Closes getsentry/self-hosted#4244

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.

  • Urgent deadline (GA date, etc.):
  • Other deadline:
  • None: Not urgent, can wait up to 1 week+

SLA

  • Teamwork makes the dream work, so please add a reviewer to your PRs.
  • Please give the docs team up to 1 week to review your PR unless you've added an urgent due date to it.
    Thanks in advance for your help!

PRE-MERGE CHECKLIST

Make sure you've checked the following before merging your changes:

  • Checked Vercel preview for correctness, including links
  • PR was reviewed and approved by any necessary SMEs (subject matter experts)
  • PR was reviewed and approved by a member of the Sentry docs team

@vercel

vercel Bot commented Jul 5, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
sentry-docs Ready Ready Preview, Comment Jul 5, 2026 10:08am
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
develop-docs Ignored Ignored Jul 5, 2026 10:08am

Request Review

1. Log in to your self-hosted Sentry instance using your existing account — we'll call this User A.
2. Ask someone else to log in through SSO and confirm it creates a new account for them — we'll call this User B.
3. User A needs to assign the "Owner" role to User B.
4. User B needs to remove User A's account from the Sentry instance.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Bug: The SSO workaround documentation instructs an admin to remove a user account without warning that this action is destructive and causes irreversible data loss.
Severity: HIGH

Suggested Fix

Add a prominent warning or callout in the documentation before the step that instructs the administrator to remove the user account. This warning should clearly state that the action is destructive, irreversible, and will result in the permanent loss of all data associated with that user account.

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: docs/organization/authentication/sso/azure-sso.mdx#L91

Potential issue: The documentation for an Azure SSO workaround instructs an
administrator to remove a user's account from the Sentry instance as part of the
process. However, it fails to include a warning that this is a destructive and
irreversible action. Performing this step will result in the permanent loss of the
user's associated data, including API tokens, saved searches, and dashboards. The
subsequent step involves creating a new account via SSO, not restoring the original one,
making the data loss permanent.

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

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.

Document setting up SSO with Azure Entra ID

1 participant