A Custom Domain let you serve login under your own domain.
This page explains how to add a custom domain.
Add the domain
- In Admin console, navigate to Branding → Domains.
- Click on Add Integration.
- In the DNS record, put your chosen custom domain. For example: auth.acme.io
- Click the Add button.
For security reasons, we have to ensure that you own the domain, This requires you to add a TXT record with the given details in your domain entries.
(See below if your DNS provider is GoDaddy)
After adding the DNS record, click the Verify Domain button.
The domain should be in a verified state.
For SSL to work, a certificate (with its key) should be provided,
Issuing a certificate is beyond the scope of this tutorial.
Once a certificate issued, you should have a PEM file with a full chain certificate and a key.
In the domains action, click the deploy button (see screenshot above).
Provide the certificate and key and click deploy.
If everything is okay, the deployment state should be green.
Wait a bit for the deployment process to end.
Use the domain
Refer to your domain instead of crossid.io, for example, if your tenant is acme, located in US then
OAuth endpoints would be referred to: https://acme.us.crossid.io/oauth2/.well-known/openid-configuration
If your custom domain is
auth.acme.io, your can refer now to the URL:
If your domain is hosted in GoDaddy follow these steps:
- Open https://dcc.godaddy.com/manage
- Put a TXT record with the given name and value.
- Click the Add Record.