Setting up a custom domain
Before you start
Section titled “Before you start”- Your organization’s plan includes a custom domain. Free includes one; Identity Plus and Team Plus include unlimited custom domains. See Custom domains.
- You are the organization’s owner or an admin.
- You can create DNS records for the domain at your registrar or DNS provider.
- You have decided which address to use. A subdomain such as
secrets.example.comis recommended: it uses a CNAME record, which keeps working if the service’s addresses change. An apex domain such asexample.comneeds an A record pointing at a fixed IP address.
Add the domain
Section titled “Add the domain”- Sign in, open the user menu and choose Domains. This opens your organization’s settings on the Domains tab. The domain belongs to the organization whose settings are open.
- Choose Add domain.
- In Custom domain, enter the address, for example
secrets.example.com. If you enter an apex domain such asexample.com, you are asked where secret links should live: pick one of the Popular subdomains, or choose Use my root domain. - Choose Continue with your domain.
The domain is added to the organization, and the next screen lists the two DNS records to create. There is no region choice: the records point at the regional site your organization uses. See Where your domain is served.
Create the DNS records
Section titled “Create the DNS records”Create both records in your DNS provider. Copy the values from the domain’s verification page; the examples below only show their form.
Ownership record (TXT)
Section titled “Ownership record (TXT)”This record proves that you control the domain. Verification depends on it.
- Host:
_onetime-challenge-followed by a short identifier for your domain. For a subdomain, the subdomain is added after it. For example,_onetime-challenge-abc1234forexample.com, or_onetime-challenge-abc1234.secretsforsecrets.example.com. Create it in the zone of the base domain (example.com). - Value: a 32-character hexadecimal code.
Some providers expect only the host label and add the zone for you; others
expect the full name. Either form is fine as long as the record resolves at
<host>.<your base domain> and returns the value unchanged. It must be the
only TXT record at that name: remove values left from an earlier attempt.
The value stays the same while the domain is in your organization. If you remove the domain and add it again, it gets a new value, and usually a new host.
Keep this record after verification. Verification is repeated in the background, and a check that no longer finds the record stops the domain being served.
Routing record (CNAME or A)
Section titled “Routing record (CNAME or A)”This record sends visitors to Onetime Secret.
- Subdomain: a CNAME record from your subdomain (for example
secrets) to the target shown on the verification page. - Apex domain: an A record for
@(or a blank host, depending on your provider) with the IP address shown on the verification page.
For reference, these are the targets for each regional site:
| Region | CNAME target | A record address |
|---|---|---|
| Canada | identity.ca.onetime.co |
As shown on the verification page |
| European Union | identity.eu.onetime.co |
109.105.217.207 |
| Aotearoa New Zealand | identity.nz.onetime.co |
As shown on the verification page |
| United Kingdom | identity.ingress.onetime.co |
As shown on the verification page |
| United States | identity.us.onetime.co |
66.51.126.41 |
Remove any other A, AAAA or CNAME records for the same host. Do not remove the TXT ownership record; it is not a conflict.
Verify the domain
Section titled “Verify the domain”- On the Domains tab, open the domain’s menu and choose Verify Domain, or select the domain’s status. On the verification page, choose Verify Domain. The button can be used again after a short pause.
- The service also re-checks domains in the background, so verification can finish without you pressing the button. DNS changes often take effect within minutes, but can take a day or longer, depending on your DNS provider and the records’ time to live (TTL).
Verification succeeds when the TXT record is found. The domain is then served, and you can choose it when you create a secret. The routing record and the certificate are tracked separately; see DNS validation for each stage and the status labels.
Check the result
Section titled “Check the result”When the domain is ready, the Domains tab shows a check mark next to it, with the tooltip Domain verified and active, and the domain’s own page shows Active. A domain that needs attention shows its status as text on the Domains tab instead.
After a check has run, the domain’s verification page shows a Domain Status panel with these fields:
- Domain: the domain name.
- Status: the latest result reported for the domain.
- Target Address: on some setups, where the service routes the domain internally. It is not a value to enter in your DNS.
- DNS Record: where your domain pointed at the last check.
- SSL Status: whether a certificate is active.
- SSL Renews: the current certificate’s expiry date. The service renews the certificate before then; you do not need to do anything.
- Last Monitored: when the domain was last checked.
- Last verification check failed: shown only when the latest check could not complete.
Use the domain
Section titled “Use the domain”When you create a secret while signed in, choose the domain you are creating
under. The secret link then uses your domain, for example
https://secrets.example.com/secret/abc123.
Questions or need support?
Section titled “Questions or need support?”Email support@onetimesecret.com or use the feedback form.