Private SaaS (PSaaS) Appliance: Custom Domains
If you are using PSaaS 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 PSaaS 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 PSaaS 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.
Custom Domains Features
The follow is a list of custom domain features that differ in behavior from their implementation in the Auth0 Public Cloud or have yet to be released to PSaaS Appliance implementations.
|Feature||Currently Supported in the PSaaS Appliance?|
|Use of custom domain in emails||No|
|Custom domain protection via API keys||No|
|Custom domain registration||Yes; accessible via PSaaS Appliance Dashboard|
|Token issuer used as custom domain||No|
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 PSaaS 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
You may configure custom domains for your tenants via the custom domains set-up area of the tenants page in the PSaaS Appliance configuration area.
Custom Domains for PSaaS Appliance's Hosted in Auth0’s Private Cloud
If your PSaaS 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 PSaaS Appliance in Auth0's Private Cloud.