Action needed: Starting July 20, 2026, analyses running with a Java runtime lower than 21 are no longer supported.
Read the scanner requirements page for more details.
Ctrlk
Start FreeLogin
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Domain verification

Domain verification serves as a foundational security step that proves your organization owns a specific email domain.

When configuring Single Sign-On (SSO) in your enterprise, domain verification provides various advantages, such as avoiding one-time email verification during SSO login.

Administrators of a SonarQube Cloud enterprise can verify their company's email domain using the setup assistant. This process associates the verified domain with your SSO connection.

Step 1: Start the Domain Configuration assistant

  1. In SonarQube Cloud, retrieve your enterprise. See Retrieving and viewing your enterprise for more details.

  2. Go to Administration > SSO & Provisioning. The SSO & Provisioning page opens. The Single sign-on & Domain verification section header shows your domain's verification status.

The domain verification status is shown in the section header.

  1. Expand the Single sign-on & Domain verification section. To do so, select the expand arrow at the far right of the section header or select the View SSO links button.

  2. Select Edit Configuration. The Configure Your Connection page opens.

The Single sign-on & Domain verification section expanded, showing the Edit Configuration button.

  1. Select Domain Configuration to open the Domain Configuration assistant.

Select Domain Configuration.

Step 2: Verify your domain in the assistant

  1. In Domain, enter your domain name (domain-name.com) and select Add Domain. The domain is added to the Pending Domains section with a TXT record name and content.

  2. Ask your domain administrator to add the TXT record to the domain.

When adding the TXT record in your DNS provider, use only the TXT record name prefix; do not append your domain name at the end of the TXT record name. For example, if the TXT record name is _ss-verification.org_XXXX.mydomain.com, only enter _ss-verification.org_XXXX as the record name. Your DNS provider will automatically append your domain.

  1. Once the record has been added, select the Verify button. The assistant verifies that the record has been added to your domain.

If the verification is successfull, the domain is removed from the Pending Domains section and added to the Manage Domains tab of the assistant.

Relates pages

PreviousInvite users to sign inNextRecovery account for SSO

Last updated

Was this helpful?