> For the complete documentation index, see [llms.txt](https://docs.datasaur.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.datasaur.ai/integrations/domain-claim.md).

# Domain Claim

Domain ownership verification is a critical security measure. Without a reliable way to prove ownership, unauthorized parties could interfere with integration requests and potentially compromise the application.

## How it works

The domain claim process involves verifying a domain by generating a unique token, asking the domain owner to publish it in a DNS TXT record for that (sub)domain, and then doing a DNS lookup to confirm the token is actually present. This process confirms whether you really own the domain.

## Claim a domain

1. Go to the **Settings** page from the sidebar.
2. Select **SAML & SCIM**. The **Domain claim** section is located at the top of the page and is currently tied to SAML/SCIM configuration.
3. Click **Add domain** and enter the domain you want Datasaur to claim.
4. In your DNS provider, create a TXT record using the values provided by Datasaur, including the fully qualified domain name (FQDN), host, and value.
5. Return to the app and click **Verify** to confirm domain ownership.

{% hint style="info" %}
Verification can take up to 24 hours, due to DNS propagation delays.
{% endhint %}

## Status

The status indicates the current state of the domain claim process.

* **Unclaimed**: The domain has been added but hasn't been claimed yet. Click **Verify** to start the process.
* **In progress**: The domain is currently being verified (up to 24 hours).
* **Claimed**: The domain is successfully claimed, confirming ownership.
* **Failed**: Datasaur could not get the desired result when verifying the domain after 24 hours.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.datasaur.ai/integrations/domain-claim.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.