Skip to content

docs(self-hosted): disable sso providers on Troubleshooting Sentry page#17705

Open
aldy505 wants to merge 1 commit intomasterfrom
aldy505/self-hosted/troubleshooting-sentry-disable-sso
Open

docs(self-hosted): disable sso providers on Troubleshooting Sentry page#17705
aldy505 wants to merge 1 commit intomasterfrom
aldy505/self-hosted/troubleshooting-sentry-disable-sso

Conversation

@aldy505
Copy link
Copy Markdown
Collaborator

@aldy505 aldy505 commented May 10, 2026

DESCRIBE YOUR PR

From a live troubleshooting session in Discord.

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

LEGAL BOILERPLATE

Look, I get it. The entity doing business as "Sentry" was incorporated in the State of Delaware in 2015 as Functional Software, Inc. and is gonna need some rights from me in order to utilize my contributions in this here PR. So here's the deal: I retain all rights, title and interest in and to my contributions, and by keeping this boilerplate intact I confirm that Sentry can use, modify, copy, and redistribute my contributions, under Sentry's choice of terms.

EXTRA RESOURCES

@vercel
Copy link
Copy Markdown

vercel Bot commented May 10, 2026

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

Project Deployment Actions Updated (UTC)
develop-docs Ready Ready Preview, Comment May 10, 2026 2:41pm
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
sentry-docs Ignored Ignored May 10, 2026 2:41pm

Request Review

Comment on lines +123 to +126
```sql
DELETE FROM sentry_authidentity WHERE auth_provider_id = 1;
DELETE FROM sentry_authprovider WHERE id = 1;
```
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 documented SQL commands to disable SSO are incomplete and will fail if 'default teams' are configured, leaving the database in an inconsistent state.
Severity: HIGH

Suggested Fix

Add a SQL command to delete from the sentry_authprovider_default_teams table before the command that deletes from sentry_authprovider. This manually handles the relationship that the Django ORM would normally cascade, preventing the foreign key violation.

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/troubleshooting/sentry.mdx#L123-L126

Potential issue: The troubleshooting documentation provides raw SQL commands to disable
SSO. These commands fail if 'default teams' are configured for the SSO provider.
Specifically, the `DELETE FROM sentry_authprovider` statement fails with a foreign key
constraint violation because it doesn't first delete related entries from the
`sentry_authprovider_default_teams` table. This failure occurs after the `DELETE FROM
sentry_authidentity` command has already succeeded, leaving the database in an
inconsistent state and potentially worsening the user lockout situation.

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.

1 participant