Skip to main content

Verify email domains

Verifying an email domain proves that your organization owns it. You add a DNS TXT record that XFA looks up. A verified domain shows a green Verified status in Settings → Domains, and you can limit identity provider (IdP) sign-in and onboarding to verified domains.

Before you start

  • You are an administrator of your organization in XFA.
  • You can edit the DNS records of the domain.
  • The domain is one of your organization's email domains, listed under Settings → Domains. Click Add domain to add one. The IdP guides accept these next to each connection's Allowed email domains. Public email providers such as gmail.com or outlook.com cannot be added: XFA answers "This is a public email provider. Add your organization's own domain."

The record

FieldValue
TypeTXT
Host_xfa-<label> (the full name is _xfa-<label>.<domain>)
Valuexfa-domain-verification=<token>

The label and the token are specific to your organization and the domain, so the host is different for every organization and domain, for example _xfa-k7q2m4x9p3r5t6v8 for acme.com. Nobody can tell from DNS which domains use XFA. Open Settings → Domains, click Verify next to the domain, and use Copy host and Copy value in the dialog to copy them exactly as shown. The dialog also shows the full name of the record under Host.

Enter the host relative to your DNS zone. When the email domain is the zone itself, such as acme.com in the acme.com zone, that is the copied host. When the email domain is a subdomain hosted in a parent zone, add the subdomain to the host. For staff.example.com in the example.com zone, the name is _xfa-<label>.staff. Check that the full name your DNS provider shows matches the full name in the dialog.

You can have other TXT records at the same name, such as SPF or other verification records. XFA looks for the one with the exact value.

Add the record

Where you add the record depends on who hosts your DNS. If your domain name and DNS are with different companies, use the one that hosts the DNS (the name servers).

Cloudflare

  1. Open the domain in the Cloudflare dashboard and go to DNS → Records.
  2. Click Add record.
  3. Set Type to TXT, enter the host into Name as described in The record, and paste the value into Content.
  4. Click Save.

Google Domains and Squarespace

Google Domains is now Squarespace Domains.

  1. Open the domain and go to DNS → DNS settings.
  2. Under Custom records, click Add record.
  3. Set Type to TXT, enter the host into Host as described in The record, and paste the value into Data.
  4. Click Save.

GoDaddy

  1. Open the domain and go to DNS.
  2. Click Add New Record.
  3. Set Type to TXT, enter the host into Name as described in The record, and paste the value into Value.
  4. Click Save.

Amazon Route 53

  1. Open the hosted zone of the domain.
  2. Click Create record.
  3. Enter the host into Record name as described in The record, set Record type to TXT, and paste the value into Value. Keep the value in double quotes if the console asks for them.
  4. Click Create records.

DNS changes can take up to an hour to reach XFA.

Check the record

  1. Go to Settings → Domains.
  2. Click Verify next to the domain.
  3. Click Check now.

When the record is found, the dialog confirms Domain verified and the domain shows Verified. Otherwise the dialog tells you why:

MessageWhat it means
No TXT record found at _xfa-k7q2m4x9p3r5t6v8.acme.com yetXFA found no record at the name shown in the dialog. Check the host and wait for DNS to catch up.
The record was found but its value does not matchA record exists but with a different value, often a token from an earlier attempt. Copy the value from the dialog again.
Lookup failed, try again in a momentThe DNS lookup did not finish. Click Check now again in a moment.

The Status column in Settings → Domains keeps the reason of the last check under an unverified domain: No TXT record found, Record value does not match or DNS lookup failed. Last checked shows when.

Only verified domains can sign in

The Only verified domains can sign in switch in Settings → Domains appears once at least one domain is verified. It is off for organizations that existed before domain verification, and on by default for new organizations. When it is on, people can only sign in or onboard through your identity providers with an email address at a verified domain. The switch saves as soon as you change it. Before it turns on, XFA asks Lock out people at unverified domains? and tells you how many provisioned users at unverified domains can no longer sign in until those domains are verified. Click Turn on to confirm.

The switch limits the organization's email domains. A domain that is listed in a connection's Allowed email domains stays allowed for that connection, verified or not. After you verify your organization's domains, remove the entries that repeat them from the connections, so that verification decides.

With the switch off, verification is informational: unverified domains keep working.

Weekly re-check

XFA checks the record of every verified domain once a week. Keep the record in place.

  1. After three failed checks in a row, the domain stays verified and all administrators get a warning email.
  2. After the fourth, the domain shows Verification lost and all administrators get a second email that names the record to restore. If Only verified domains can sign in is on, sign-in through the domain stops, unless a connection still lists the domain in its Allowed email domains. If it is off, nothing else changes.

To get the domain back, restore the record, then click Verify next to the domain and Check now.

Several organizations on one domain

Several organizations can verify the same domain. If you run several XFA organizations, for example one per subsidiary, add and verify the domain in each of them. Each gets its own record, and the records coexist in the zone.

Notes and troubleshooting

  • The host and token belong to one organization and domain. Copy them again from the dialog if you are unsure which record is yours.
  • Some DNS panels add the domain to the host for you. If Check now finds nothing, check that the record is not at _xfa-k7q2m4x9p3r5t6v8.acme.com.acme.com.
  • The value must match exactly, without extra spaces or quotes inside it.