Appliance: Custom Domains
If you are using Appliance Build 5XXX or later, you may configure custom domains using the Management Dashboard.
Custom domains allow you to expose one or more arbitrary DNS names for a tenant. Conventionally, the Appliance uses a three-part domain name for access, and it is the first portion of the domain name that varies depending on the tenant.
The root tenant authority (RTA) is a special domain that is configured when the Appliance cluster(s) are first set up. It is a privileged tenant from which certain manage operations for the cluster are available. The RTA is sometimes called the configuration domain, and all users that have access to the Management Dashboard belong to an application in the RTA.
All tenant domain names derive from the root tenant authority, and any changes to this will result in the deletion of all tenants.
Suppose that your RTA is
config.example.com. From this point on, all of your new tenants' domain names must derive from the base name,
However, you might want to expose other domain names to your end users, such as:
You may do so by utilizing the Appliance's custom domains feature, which sets the domain used for authentication endpoints.
Certificates Required for Custom Domains
Custom domains map one or more external DNS to a tenant that follows the standard naming convention.
Suppose that we have a tenant with the following domain:
Suppose that we want the following domains to map to
Each of the custom domains (in this example, there are two) has its own certificate, which is stored separately.
Configuring Custom Domains
Custom Domains for Appliance's Hosted in Auth0’s Private Cloud
If your Appliance is hosted in Auth0’s private cloud, your domains will end in auth0.com. If you want to use a custom domain with your customer-facing applications, see Information Requirements for Setting Up the Appliance in Auth0's Private Cloud.