# 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 Does It Work?

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 a user really owns the domain.

## Step-by-Step

1. Select a **Workspace** and go to **Settings** in the sidebar.
2. Select the **SAML & SCIM**. There will be a domain claim section at the top of the page. At the moment, domain claim is tightly connected to SAML/SCIM.
3. At the top of the page, click the **"Add domain"** button. Fill it with the domain you want Datasaur to claim.
4. In your DNS provider, create a **TXT record** using the values provided by Datasaur (fully qualified domain name, host, and its value).
5. Return to the app and click **"Verify"** button so that Datasaur will attempt to confirm ownership. Verification may take up to 24 hours due to DNS propagation delays.

## **Status**

This refers to the status column after a domain is added.

* **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 by the user, confirming ownership.
* **Failed**: Data Studio cannot get the desired result when requesting the domain after 24 hours.


---

# Agent Instructions: 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.
