Identity / Field guide

Domain verification

Prove that a customer controls an email domain before applying organization rules.

An email is not a domain claim

WHO CONTROLS EXAMPLE.COM?alex@example.comMailbox verifiedONE PERSONDNS TXT RECORD_verify.example.comchallenge=8e42…DOMAIN OWNEREmail match alone cannot enforce SSO

One matching email proves only that a person receives mail there.

01 / CONTEXT

Why it matters

A matching email address proves that one person receives mail at a domain. It does not prove that the person controls the domain or may configure SSO for the whole company. Domain verification establishes a stronger organization-level claim.

Verification usually asks an admin to publish a DNS record, then checks that record before activating automatic membership or SSO routing. Ownership can change, so the proof needs status, renewal and a path for disputes.

02 / DESIGN

Decisions to make

  • Separate email-domain affiliation from DNS-based ownership verification.
  • Choose whether a verified domain suggests membership or grants it automatically.
  • Define what happens when two organizations claim the same domain.
  • Decide who may add, verify and remove domains for an organization.
  • Plan how verification expiry or DNS changes affect existing members and SSO.
03 / IMPLEMENTATION

Build checklist

  • Issue an unpredictable, organization-specific DNS challenge.
  • Check the expected record and record when verification succeeded.
  • Show pending, verified and failed states with actionable instructions.
  • Recheck ownership before high-impact domain policy changes.
  • Audit domain claims, transfers and automatic enrollment decisions.
04 / WATCH FOR

Common mistakes

  • Treating a verified employee email address as proof of domain ownership.
  • Allowing an unverified domain claim to force all users into one SSO connection.
  • Leaving automatic enrollment active after a domain is removed or transferred.
05 / GO DEEPER

Tools & references

3 starting points to compare or study. Check fit, maintenance, terms and current capabilities before choosing one.

BUILDING THIS NOW?

Explore the SaaSLayer approach.

See the services and developer guides behind our AWS backed SaaS building blocks.

Read SaaSLayer docs
NEXT FEATUREMulti-factor authentication