# Source: https://docs.sonarsource.com/sonarqube-mcp-server/resources/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-community-build/instance-administration/authentication/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-community-build/devops-platform-integration/bitbucket-integration/bitbucket-cloud-integration/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-community-build/analyzing-source-code/dotnet-environments/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-community-build/server-update-and-maintenance/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-for-eclipse/resources/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-for-visual-studio/resources/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-for-intellij/resources/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-for-vs-code/resources/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/8.9/setup-and-upgrade/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/9.8/setup-and-upgrade/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/9.9/setup-and-upgrade/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/10.0/setup-and-upgrade/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/10.1/setup-and-upgrade/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/10.2/setup-and-upgrade/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/10.3/setup-and-upgrade/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/10.3/setup-and-upgrade/install-the-server/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/10.4/setup-and-upgrade/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/10.4/setup-and-upgrade/install-the-server/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/10.5/setup-and-upgrade/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/10.5/setup-and-upgrade/install-the-server/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/10.6/setup-and-upgrade/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/10.6/setup-and-upgrade/install-the-server/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/10.7/analyzing-source-code/dotnet-environments/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/10.7/server-upgrade-and-maintenance/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/10.7/setup-and-upgrade/install-the-server/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/10.8/instance-administration/authentication/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/10.8/analyzing-source-code/dotnet-environments/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/10.8/server-upgrade-and-maintenance/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/2025.2/instance-administration/authentication/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/2025.2/analyzing-source-code/dotnet-environments/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/2025.2/server-update-and-maintenance/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/2025.3/instance-administration/authentication/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/2025.3/analyzing-source-code/dotnet-environments/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/2025.3/server-update-and-maintenance/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/2025.3/advanced-security/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/2025.5/instance-administration/authentication/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/2025.5/devops-platform-integration/bitbucket-integration/bitbucket-cloud-integration/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/2025.5/analyzing-source-code/dotnet-environments/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/2025.5/server-update-and-maintenance/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/2025.5/advanced-security/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/2025.1/instance-administration/authentication/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/2025.1/analyzing-source-code/dotnet-environments/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/2025.1/server-update-and-maintenance/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/2025.4/instance-administration/authentication/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/2025.4/analyzing-source-code/dotnet-environments/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/2025.4/server-update-and-maintenance/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/2025.4/advanced-security/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/2025.6/instance-administration/authentication/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/2025.6/instance-administration/system-functions/notifications/slack/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/2025.6/devops-platform-integration/bitbucket-integration/bitbucket-cloud-integration/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/2025.6/analyzing-source-code/dotnet-environments/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/2025.6/server-update-and-maintenance/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/2025.6/advanced-security/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/instance-administration/authentication/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/instance-administration/system-functions/notifications/slack/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/devops-platform-integration/bitbucket-integration/bitbucket-cloud-integration/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/analyzing-source-code/dotnet-environments/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/server-update-and-maintenance/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-server/advanced-security/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-cloud/appendices/troubleshooting.md

# Source: https://docs.sonarsource.com/sonarqube-cloud/administering-sonarcloud/managing-enterprise/enterprise-security/sso/troubleshooting.md

# Troubleshooting SSO connection

There may be several reasons for this failure:

* The user entered an invalid key or you sent them an invalid login URL. See [inviting-users-to-sign-in](https://docs.sonarsource.com/sonarqube-cloud/administering-sonarcloud/managing-enterprise/enterprise-security/sso/setup/inviting-users-to-sign-in "mention").
* The user is not a member of any organization in the enterprise. See [organization-members](https://docs.sonarsource.com/sonarqube-cloud/administering-sonarcloud/managing-organization/users-and-permissions/organization-members "mention").
* The group synchronization failed. See [verify-user-groups](https://docs.sonarsource.com/sonarqube-cloud/administering-sonarcloud/managing-enterprise/enterprise-security/sso/setup/verify-user-groups "mention").
* The SSO configuration is incorrect:
  * Check the attribute mapping (specifically email). See [editing-sso-configuration](https://docs.sonarsource.com/sonarqube-cloud/administering-sonarcloud/managing-enterprise/enterprise-security/sso/editing-sso-configuration "mention").
  * If it still doesn’t work, check the other SSO settings and test your connection.
* You use GitHub and SSO and have configured an IP allow list in GitHub. In that case, disable the configuration in GitHub and try again.

### Related pages <a href="#related-pages" id="related-pages"></a>

[about](https://docs.sonarsource.com/sonarqube-cloud/administering-sonarcloud/managing-enterprise/enterprise-security/sso/about "mention")\
[setting-up-sso](https://docs.sonarsource.com/sonarqube-cloud/getting-started-with-enterprise/setting-up-sso "mention")\
[editing-sso-configuration](https://docs.sonarsource.com/sonarqube-cloud/administering-sonarcloud/managing-enterprise/enterprise-security/sso/editing-sso-configuration "mention")\
[deleting-sso-configuration](https://docs.sonarsource.com/sonarqube-cloud/administering-sonarcloud/managing-enterprise/enterprise-security/sso/deleting-sso-configuration "mention")\
[#deleting-sso-account](https://docs.sonarsource.com/sonarqube-cloud/managing-organization/users-and-permissions/user-on-and-offboarding#deleting-sso-account "mention")