> For the complete documentation index, see [llms.txt](https://docs.sonarsource.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sonarsource.com/sonarqube-cloud/administering-sonarcloud/enterprise-security/sso-and-provisioning/verify-domain.md).

# 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.

As an administrator of a SonarQube Cloud enterprise, you can verify your company's email domain using the Domain Configuration assistant. Verifying the domain associates it with your SSO connection.

## Step 1: Open the Domain Configuration assistant

1. In SonarQube Cloud, retrieve your enterprise. See [Retrieving and viewing your enterprise](https://docs.sonarsource.com/sonarqube-cloud/administering-sonarcloud/managing-enterprise/retrieving-and-viewing-your-enterprise.md) for more details.
2. Go to **Administration** > **SSO & provisioning** to access the **Domain verification** section, which shows whether your domain is verified.
3. Expand the **Domain verification** section.
4. Select **Set up domain verification** to open the **Domain Configuration** assistant in a new tab.

<figure><img src="https://2223713658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB4UT2GNiZKjtxFtcFAL7%2Fuploads%2Fgit-blob-cba52bb3f8a957ed80c8e7cf0b8ca23f52d5ff55%2Fsonarqube-cloud-sso-domain-not-verified.png?alt=media" alt="The SSO &#x26; provisioning page with the Domain verification section expanded and the Not verified badge and Set up domain verification button outlined."><figcaption></figcaption></figure>

## Step 2: Verify your domain in the assistant

1. On the **Add Domain** tab, in **Domain**, enter your domain name (`domain-name.com`) and select **Add Domain**. The domain is added to the **Pending Domains** section.
2. Select the pending domain to expand it. The assistant shows a **TXT Record Name** and a **TXT Record Content** value. Select the copy icon next to each value to copy it.
3. Ask your domain administrator to add the TXT record to the domain.

{% hint style="info" %}
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.
{% endhint %}

4. After the domain administrator adds the TXT record, select **Verify**. The assistant checks your domain for the record. DNS changes can take up to 48 hours to apply, and typically finish sooner.

<figure><img src="https://2223713658-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FB4UT2GNiZKjtxFtcFAL7%2Fuploads%2Fgit-blob-95ad2df347eaa6af98ace8fc79aaf84c0770704e%2Fsonarqube-cloud-sso-verify-domain-configuration.png?alt=media" alt="The Domain Configuration assistant with the Domain field (1), the TXT record fields (2), and the Verify button (3) outlined and numbered in red."><figcaption></figcaption></figure>

5. If the assistant shows the message "could not be verified," wait and select **Verify** again. If the message persists, check the TXT record with your DNS provider.
6. Select **Done** to close the assistant.
7. After the domain is verified, the **Domain verification** section on the **SSO & provisioning** page shows the number of verified domains in its badge, such as **1 verified domain**, and lists each domain under **Verified domains**. The **Set up domain verification** button changes to **Edit domains**.

## Related pages

* [Set up SSO](https://docs.sonarsource.com/sonarqube-cloud/administering-sonarcloud/enterprise-security/sso-and-provisioning/set-up-sso.md)
* [Recovery account for SSO](https://docs.sonarsource.com/sonarqube-cloud/administering-sonarcloud/enterprise-security/sso-and-provisioning/recovery-account.md)
* [About SSO and provisioning](https://docs.sonarsource.com/sonarqube-cloud/administering-sonarcloud/enterprise-security/sso-and-provisioning/about.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.sonarsource.com/sonarqube-cloud/administering-sonarcloud/enterprise-security/sso-and-provisioning/verify-domain.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
