Vanity URLs
Vanity URL Configuration
A vanity URL allows you to use a custom domain for authID endpoints instead of the default authid.ai domain. This enables your organization to align authentication services with your own domain structure.
Configuring a vanity URL requires updating DNS records and coordinating with the authID support team to verify domain ownership and generate TLS certificates.
Follow the steps below to complete the setup.
Prerequisites
Before starting:
- You must own the domain you intend to use.
- You must have permission to modify the domain’s DNS records.
DNS Records Summary
During the configuration process, you will need to add the following DNS records.
| Record Type | Purpose | Provided By |
|---|---|---|
| CNAME | Routes your vanity URL to authID infrastructure | Customer |
| TXT | Verifies domain ownership | authID |
| TXT | ACME challenge used to generate TLS certificates | authID |
Setup Process
1. Choose a Vanity URL
Select the domain you want to use for authID services.
Example: id.yourcompanydomain.com
2. Configure the CNAME Record
Create a CNAME record in your DNS configuration that points your vanity URL to the authID endpoint.
| Record Type | Name | Value |
|---|---|---|
| CNAME | your vanity URL | id.authid.ai |
Example:
| Record Type | Name | Value |
|---|---|---|
| CNAME | id.yourcompany.com | id.authid.ai |
3. Contact authID Support
Once the CNAME record has been added, contact authID support and provide your previously configured vanity URL.
The support team will register the domain on the authID platform and provide the DNS records required to verify domain ownership.
4. Add the Domain Verification TXT Record
authID will provide a TXT record used to verify that you control the domain.
Add the provided TXT record to your DNS configuration.
Example format:
| Record Type | Name | Value |
|---|---|---|
| TXT | verification host | verification token |
After adding the record, notify authID support so they can validate domain ownership.
5. Add the TLS Certificate TXT Record
After domain ownership is verified, authID will provide a second TXT record used for the ACME challenge required to generate TLS certificates.
Add the provided TXT record to your DNS configuration.
Example format:
| Record Type | Name | Value |
|---|---|---|
| TXT | _acme-challenge.domain | challenge token |
Once the record has been added, notify authID support so the certificate generation process can begin.
6. Confirmation
After the DNS records are verified and TLS certificates are generated, authID will confirm that your vanity URL is active and ready for use.
Note:
DNS changes may take several minutes to propagate depending on your DNS provider. Verification may require waiting until the new records are visible in DNS.
Updated about 2 months ago