> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.pensar.dev/console/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.pensar.dev/console/_mcp/server.

# Verifying Domains

> Verify domain ownership with DNS TXT records or an HTTP verification file

## Overview

After [adding a domain](/console/domains/adding-domains) to your workspace, you must verify ownership using a DNS TXT record — or, if you can't edit the domain's DNS, by serving the verification token over HTTP. This verification proves you control the domain and authorizes Pensar to perform security testing.

> **Success**
>
> The verification dialog opens automatically after creating a domain, showing
> your unique TXT record and verification instructions.

## Why Domain Verification?

Domain verification is a critical security measure that:

* **Proves Ownership**: Ensures you control the domain before testing begins
* **Prevents Abuse**: Protects others from unauthorized security testing
* **Legal Protection**: Provides evidence of authorization for penetration testing
* **Compliance**: Demonstrates due diligence for security assessments

## Verification Process

When you create a domain, a verification dialog automatically opens with your unique DNS TXT record.

#### View Your TXT Record

The verification dialog displays:

* Your unique verification record (format: `pensar=<token>`)
* A copy button for easy copying
* Instructions for adding the record
* A verify button to check verification status

#### Copy the Record

Click the **Copy** icon next to the TXT record to copy it to your clipboard. This ensures you don't make any typos when adding it to your DNS.

#### Add to Your DNS Provider

Log in to your DNS provider and add a new TXT record:

* **Type**: TXT
* **Name**: `_pensar.<your-domain>` — the full name shown in the dialog
* **Value**: Paste the copied record (format: `pensar=<token>`)
* **TTL**: 3600 seconds (or your provider's default)

> **Warning**
>
> Name fields differ by provider: some take the full name, others append
> the hosted zone to what you type. Check what the field shows — if it
> displays the zone beside or below the input, enter only the part before
> it. In the `example.com` zone that makes `_pensar.app.example.com` into
> `_pensar.app`, and `_pensar.example.com` into `_pensar`. Entering the
> full name in a field that appends the zone publishes the record at
> `_pensar.app.example.com.example.com` — the wrong name, where
> verification won't look for it.

#### Wait for DNS Propagation

DNS changes take time to propagate globally:

* **Fast providers** (Cloudflare, Vercel): 1-5 minutes
* **Most providers**: 10-30 minutes
* **Maximum**: Up to 48 hours (rare)

#### Click Verify

Return to the Pensar Console and click the **Verify** button in the dialog. This triggers a DNS lookup to check for your TXT record.

#### Successful Verification

When verification succeeds:

* You'll see: "Domain verified successfully"
* The dialog closes automatically
* Reconnaissance is automatically queued
* Your domain is ready for penetration testing

## HTTP File Verification (No DNS Access)

If you can't add DNS records — common for apps hosted on platform subdomains like `myapp.onrender.com` or `myapp.herokuapp.com` — serve the verification token over HTTP instead. Both methods use the same token, and clicking **Verify** checks both automatically.

#### Copy the Verification Record

Copy the same `pensar=<token>` value shown in the verification dialog.

#### Serve It at the Well-Known Path

Make your app respond with the record as plain text at:

```text
https://<your-domain>/.well-known/pensar-verification
```

The response body must be exactly the record value (surrounding whitespace is ignored), served with a `200` status over HTTPS. For example, in Express:

```javascript
app.get('/.well-known/pensar-verification', (req, res) => {
  res.type('text/plain').send('pensar=<your-token>');
});
```

Or simply place a static file named `pensar-verification` containing the record in your app's `.well-known` public directory.

#### Click Verify

Return to the Pensar Console and click **Verify**. Pensar checks DNS first, then fetches the well-known URL.

> **Info**
>
> Keep the route or file in place permanently — just like the DNS TXT record,
> it allows instant re-verification later and poses no security risk.

## DNS TXT Record Format

Your verification TXT record follows this specific format:

```text
Record Type: TXT
Host: _pensar.<your-domain>
Value: pensar=<unique-verification-token>
TTL: 3600
```

### Examples by Domain Type

#### Subdomain

**Domain**: `app.example.com`

```text
Host: _pensar.app.example.com
Value: pensar=a1b2c3d4e5f6...
TTL: 3600
```

If the name field appends the hosted zone, enter only the part before it.
In the `example.com` zone that is `_pensar.app`, not `_pensar`:

```text
Host: _pensar.app
Value: pensar=a1b2c3d4e5f6...
TTL: 3600
```

#### Root Domain

**Domain**: `example.com`

```text
Host: _pensar.example.com
Value: pensar=a1b2c3d4e5f6...
TTL: 3600
```

If the name field appends the hosted zone, enter only the part before it.
In the `example.com` zone that is:

```text
Host: _pensar
Value: pensar=a1b2c3d4e5f6...
TTL: 3600
```

#### With Port

**Domain**: `api.example.com:8443`

```text
Host: _pensar.api.example.com
Value: pensar=a1b2c3d4e5f6...
TTL: 3600
```

> **Info**
>
> Ports are ignored for verification. Add the TXT record for the domain name only.

## DNS Provider Guides

Step-by-step instructions for popular DNS providers:

#### Cloudflare

**Adding TXT Record in Cloudflare:**

1. Log in to your [Cloudflare dashboard](https://dash.cloudflare.com/)
2. Select the domain you're verifying
3. Click **DNS** in the sidebar, then **Records**
4. Click **Add record**
5. Configure the record:
   * **Type**: TXT
   * **Name**: `_pensar` for the target `example.com`, `_pensar.app` for `app.example.com` — Cloudflare appends the zone, and shows the resulting full name under the field
   * **Content**: Paste your full record value (e.g., `pensar=abc123...`)
   * **TTL**: Auto (or 3600)
   * **Proxy status**: DNS only (gray cloud)
6. Click **Save**
7. Wait 1-5 minutes for propagation
8. Return to Pensar Console and click **Verify**

> **Success**
>
> Cloudflare typically propagates DNS changes within 1-2 minutes, making it one of the fastest providers for verification.

#### AWS Route 53

**Adding TXT Record in Route 53:**

1. Open the [Route 53 console](https://console.aws.amazon.com/route53/)
2. Click **Hosted zones** in the sidebar
3. Select the hosted zone for your domain
4. Click **Create record**
5. Configure the record:
   * **Record name**: the part before the hosted zone name shown beside the field — `_pensar` for the target `example.com`, `_pensar.app` for `app.example.com` ([field reference](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/resource-record-sets-values-shared.html))
   * **Record type**: TXT
   * **Value**: `"pensar=<token>"` (enclose in double quotes)
   * **TTL (seconds)**: 300 or 3600
   * **Routing policy**: Simple routing
6. Click **Create records**
7. Wait 5-10 minutes for propagation
8. Return to Pensar Console and click **Verify**

> **Warning**
>
> Route 53 requires:
>
> * TXT values enclosed in double quotes: `"pensar=token"`, not `pensar=token`
> * The record name relative to the hosted zone — the console shows the zone
>   suffix beside the field and appends it to what you type

#### Google Cloud DNS

**Adding TXT Record in Google Cloud DNS:**

1. Open the [Cloud DNS console](https://console.cloud.google.com/net-services/dns/)
2. Click on your DNS zone
3. Click **Add record set** at the top
4. Configure the record:
   * **DNS name**: the full name with a trailing dot — `_pensar.example.com.` for the target `example.com`, `_pensar.app.example.com.` for `app.example.com`. Google Cloud DNS does not append the zone
   * **Resource record type**: TXT
   * **TTL**: 3600 seconds
   * **TXT data**: `pensar=<token>` (no quotes needed)
5. Click **Create**
6. Wait 5-10 minutes for propagation
7. Return to Pensar Console and click **Verify**

> **Info**
>
> Google Cloud DNS requires the trailing dot in the DNS name but doesn't require quotes around the value.

#### GoDaddy

**Adding TXT Record in GoDaddy:**

1. Log in to your [GoDaddy account](https://www.godaddy.com/)
2. Navigate to **My Products** > **All Products and Services**
3. Find your domain and click **DNS**
4. Scroll to the **Records** section
5. Click **Add** and select **TXT**
6. Configure the record:
   * **Name**: the name minus the zone, which is appended for you — `_pensar` for the target `example.com`, `_pensar.app` for `app.example.com`
   * **Value**: Paste your full record value
   * **TTL**: 3600 seconds (or 1 hour)
7. Click **Save**
8. Wait 10-30 minutes for propagation (GoDaddy can be slower)
9. Return to Pensar Console and click **Verify**

> **Warning**
>
> GoDaddy DNS propagation can take 10-30 minutes or longer. If verification fails, wait a bit longer and try again.

#### Namecheap

**Adding TXT Record in Namecheap:**

1. Log in to your [Namecheap account](https://www.namecheap.com/)
2. Navigate to **Domain List**
3. Click **Manage** next to your domain
4. Go to the **Advanced DNS** tab
5. Click **Add New Record** in the Host Records section
6. Configure the record:
   * **Type**: TXT Record
   * **Host**: the name minus the zone, which is appended for you — `_pensar` for the target `example.com`, `_pensar.app` for `app.example.com`
   * **Value**: Paste your full record value
   * **TTL**: Automatic (or select a specific value)
7. Click the checkmark to save
8. Wait 10-30 minutes for propagation
9. Return to Pensar Console and click **Verify**

#### DigitalOcean

**Adding TXT Record in DigitalOcean:**

1. Log in to your [DigitalOcean account](https://cloud.digitalocean.com/)
2. Navigate to **Networking** > **Domains**
3. Click on your domain
4. Scroll to the **Add a record** section
5. Configure the record:
   * **Type**: TXT
   * **Hostname**: the name minus the zone, which is appended for you — `_pensar` for the target `example.com`, `_pensar.app` for `app.example.com`
   * **Value**: Paste your full record value
   * **TTL (seconds)**: 3600
6. Click **Create Record**
7. Wait 5-10 minutes for propagation
8. Return to Pensar Console and click **Verify**

#### Vercel

**Adding TXT Record in Vercel:**

1. Log in to your [Vercel dashboard](https://vercel.com/dashboard)
2. Navigate to your project
3. Go to **Settings** > **Domains**
4. Click on your domain
5. Scroll to **DNS Records**
6. Click **Add** and select **TXT**
7. Configure the record:
   * **Name**: the name minus the zone, which is appended for you — `_pensar` for the target `example.com`, `_pensar.app` for `app.example.com`
   * **Value**: Paste your full record value
   * **TTL**: Default (automatic)
8. Click **Save**
9. Wait 1-5 minutes for propagation (Vercel is very fast)
10. Return to Pensar Console and click **Verify**

#### Netlify

**Adding TXT Record in Netlify:**

1. Log in to your [Netlify dashboard](https://app.netlify.com/)
2. Navigate to **Domains**
3. Select your domain
4. Click **DNS settings**
5. Scroll to **DNS records**
6. Click **Add new record**
7. Configure the record:
   * **Record type**: TXT
   * **Name**: the name minus the zone, which is appended for you — `_pensar` for the target `example.com`, `_pensar.app` for `app.example.com`
   * **Value**: Paste your full record value
   * **TTL**: 3600
8. Click **Save**
9. Wait 5-10 minutes for propagation
10. Return to Pensar Console and click **Verify**

## Checking DNS Propagation

Before clicking verify, you can check if your TXT record has propagated:

### Online DNS Checker Tools

#### [DNS Checker](https://dnschecker.org/)

Check DNS propagation from multiple global locations. Enter
`_pensar.yourdomain.com` and select TXT record type.

#### [What's My DNS](https://www.whatsmydns.net/)

View your DNS records from servers around the world. Shows propagation
status per region.

#### [Google DNS](https://dns.google/)

Query Google's public DNS servers. Fast and reliable for checking if records
are live.

#### [MX Toolbox](https://mxtoolbox.com/TXTLookup.aspx)

Comprehensive DNS lookup tool. Check TXT records and other DNS information.

### Command Line Tools

You can also check from your terminal:

#### dig

**Using dig (Linux/Mac):**

```bash
# Check for TXT record
dig _pensar.example.com TXT

# Show only the answer
dig +short _pensar.example.com TXT

# Query a specific DNS server (Google's DNS)
dig @8.8.8.8 _pensar.example.com TXT
```

**Expected output:**

```text
_pensar.example.com. 3600 IN TXT "pensar=abc123xyz789..."
```

#### nslookup

**Using nslookup (Windows/Mac/Linux):**

```bash
# Check for TXT record
nslookup -type=TXT _pensar.example.com

# Query a specific DNS server
nslookup -type=TXT _pensar.example.com 8.8.8.8
```

**Expected output:**

```text
_pensar.example.com text = "pensar=abc123xyz789..."
```

#### host

**Using host (Linux/Mac):**

```bash
# Check for TXT record
host -t TXT _pensar.example.com

# Query a specific DNS server
host -t TXT _pensar.example.com 8.8.8.8
```

**Expected output:**

```text
_pensar.example.com descriptive text "pensar=abc123xyz789..."
```

## Troubleshooting Verification

If verification fails, follow these troubleshooting steps:

#### TXT Record Not Found

**Problem**: The DNS lookup can't find your TXT record.

**Solutions:**

1. **Wait longer**: DNS propagation can take 10-30 minutes (sometimes longer)
2. **Check the record exists**: Log back into your DNS provider and verify the record is saved
3. **Check the name**: query the full name — `dig _pensar.<your-domain> TXT`. A record on the bare domain still verifies, but a record on the wrong name does not
4. **Check the zone wasn't appended twice**: if the name field appends the hosted zone, `_pensar.app.example.com` typed into it lands at `_pensar.app.example.com.example.com`. Enter `_pensar.app` instead
5. **Check DNS propagation**: Use online tools to see if the record is visible globally

> **Info**
>
> If your DNS provider's interface shows the record but verification fails, it usually means the record hasn't propagated yet. Wait 5-10 more minutes and try again.

#### Record Format Issues

**Problem**: The record exists but doesn't match the expected format.

**Common mistakes:**

* ❌ Missing `_pensar` prefix in the name
* ❌ The hosted zone appended twice (`_pensar.app.example.com.example.com`)
* ❌ Missing `pensar=` in the value (just the token)
* ❌ Extra quotes added when they shouldn't be
* ❌ Spaces or line breaks in the value
* ❌ Wrong label (e.g., `_verify` instead of `_pensar`)

**Correct format**, for the target `app.example.com`:

```text
Name:  _pensar.app.example.com
Value: pensar=abc123xyz789...
```

**Action**: Delete the record and re-add it, carefully copying the value from the Pensar verification dialog using the Copy button.

#### DNS Provider Specific Issues

**Problem**: Different DNS providers have different formatting requirements.

**Provider-specific tips:**

**Route 53 (AWS):**

* Requires double quotes: `"pensar=token"`
* Appends the zone shown beside the field — enter `_pensar.app`, not `_pensar.app.example.com`

**Google Cloud DNS:**

* Takes the full name with a trailing dot: `_pensar.app.example.com.`
* No quotes needed

**Cloudflare:**

* Appends the zone — enter the name without it (`_pensar.app` in the `example.com` zone)
* No trailing dot needed
* No quotes needed

**GoDaddy/Namecheap:**

* Append the zone — enter the name without it (`_pensar.app` in the `example.com` zone)
* No quotes needed

**Check your provider's documentation** for TXT record formatting requirements.

#### Multiple TXT Records

**Problem**: Your domain already has other TXT records and there may be conflicts.

**Solution:**

* Multiple TXT records for the same host are allowed
* DNS returns all TXT records for a host
* The Pensar verification looks specifically for the `pensar=` prefix
* Having other TXT records (like SPF, DKIM, etc.) won't interfere

**If you have issues:**

* Ensure your new record is actually saved and visible
* Check that the `pensar=` value is correct
* Try querying the DNS to see all TXT records returned

#### Propagation Taking Too Long

**Problem**: It's been over 30 minutes and the record still isn't visible.

**Possible causes:**

1. **DNS provider is slow**: Some providers take longer (GoDaddy, some regional providers)
2. **Caching**: Your local DNS may be caching old results
3. **DNS not saved**: The record might not have been saved properly

**Actions to take:**

1. Clear your local DNS cache:
   * **Mac**: `sudo dscacheutil -flushcache`
   * **Windows**: `ipconfig /flushdns`
   * **Linux**: `sudo systemd-resolve --flush-caches`
2. Check from a different network or device
3. Use an online DNS checker to see global propagation
4. Verify the record is actually saved in your DNS provider's interface
5. If it's been over 2 hours, contact your DNS provider's support

#### Verification Error Messages

**Common error messages and solutions:**

**"Verification token not found. Add a TXT record with name … and value …"**

* Neither the DNS lookup nor the well-known file produced a matching token
* The message names the exact name and value to publish — compare both against your provider
* Common causes: propagation not finished, a typo, or the record at the wrong name

**"A Pensar TXT record resolved for this domain, but no published value matches."**

* A `pensar=` record was found, but none of the published values is this domain's
* The value may be stale, mistyped, or issued for a different domain or workspace. Publish the value from this domain's dialog

**"No verification record found. Please create one first."**

* The domain has no token yet. Reopen the verification dialog to issue one

## Re-Verifying Domains

You can re-verify a domain at any time:

#### Open Domain Menu

In the Domains list, click the menu (⋮) next to the unverified domain.

#### Click Verify

Select **Verify** from the dropdown menu.

#### Verification Dialog Opens

The verification dialog opens showing the same TXT record value. The token
remains the same for each domain.

#### Check DNS Record

Verify the TXT record is still in your DNS (it should be if you added it
earlier).

#### Click Verify

Click the **Verify** button to retry verification.

> **Info**
>
> The verification token for a domain doesn't change, so you only need to add
> the DNS TXT record once. You can verify multiple times using the same record.

## After Successful Verification

Once your domain is verified:

#### Automatic Reconnaissance

Pensar automatically queues reconnaissance to discover your attack surface.

#### Status Updates

In the Domains list:

* **Verified** column shows a green checkmark ✓
* **Last Analyzed** shows when reconnaissance started
* An animated radar icon appears while reconnaissance is running

#### Endpoint Discovery

The reconnaissance process discovers:

* API endpoints
* Web pages and routes
* Entry points and input vectors
* Authentication mechanisms

#### Ready for Testing

Once reconnaissance completes, your domain is ready for penetration testing.
You can:

* View discovered endpoints
* Review pentest objectives
* Manually trigger pentests
* Enable automatic testing schedules

## Best Practices

#### Leave TXT Records in Place

**Recommendation**: Keep your verification TXT record in your DNS permanently.

**Why:**

* No security risk - the token is public and only proves ownership
* Allows easy re-verification if needed
* Doesn't interfere with other DNS records
* Takes up minimal DNS resources
* Makes future verification instant

**When to remove:**

* You permanently stop using Pensar
* You delete the domain from your workspace
* Your organization requires cleanup of unused records

#### Verify Before Production Testing

**Recommendation**: Verify and test staging/development domains before production.

**Benefits:**

* Familiarize yourself with the process
* Ensure verification works smoothly
* Test the security testing process in a safe environment
* Validate that test credentials work
* Confirm penetration testing doesn't disrupt services

#### Document Your DNS Records

**Recommendation**: Keep a record of all DNS TXT records you add for services.

**Why:**

* Know what each record is for
* Makes cleanup easier later
* Helps when troubleshooting DNS issues
* Useful for team knowledge sharing
* Required for some compliance frameworks

**What to document:**

* Service name (Pensar)
* Purpose (Domain verification)
* Record host (`_pensar.example.com`)
* Date added
* Who added it

#### Test DNS Propagation First

**Recommendation**: Check DNS propagation before clicking Verify in Pensar.

**How:**

* Use online DNS checker tools
* Run command-line queries
* Check from multiple locations
* Wait until you see the record globally

**Benefits:**

* Avoid failed verification attempts
* Know the record is working before testing
* Understand propagation time for your DNS provider
* Catch formatting errors early

## Security Considerations

> **Info**
>
> The DNS TXT record verification token is public information and is safe to
> share. It only proves domain ownership and cannot be used to access your
> systems or data.

### Is the Verification Token Secret?

**No.** The verification token:

* ✅ Proves you can add DNS records to the domain
* ✅ Is publicly queryable by anyone via DNS lookup
* ✅ Only authorizes Pensar to test that specific domain
* ❌ Does NOT provide access to your application
* ❌ Does NOT contain sensitive information
* ❌ Cannot be used to compromise security

### Can Someone Use My Token?

**No.** Even if someone copies your verification token:

* They can't add it to their DNS for your domain (they don't control your DNS)
* They can't use it to verify their own domain (tokens are domain-specific)
* They can't gain access to your Pensar workspace
* They can't trigger tests on your domain without Pensar workspace access

### Removing Verification Records

You can safely remove TXT records if:

* You're no longer using Pensar
* You've deleted the domain from your workspace
* You need to clean up DNS records

**To remove:**

1. Log in to your DNS provider
2. Find the TXT record with host `_pensar.yourdomain.com`
3. Delete the record
4. Wait for DNS propagation (changes take effect in 5-30 minutes)

> **Warning**
>
> If you remove the verification record, you'll need to add it back if you ever
> want to re-verify the domain in the future. However, the token value remains
> the same.

## Next Steps

#### [Adding Domains](/console/domains/adding-domains)

Learn how to add new domains to your workspace before verification.

#### [Authentication](/console/features/authentication)

Configure authentication credentials to test protected endpoints.

#### [Hybrid Testing](/console/features/hybrid-testing)

Start penetration testing on your verified domains.

#### [Attack Surface](/console/features/attack-surface)

Understand how Pensar discovers endpoints on your verified domains.