Custom Domain

How to use custom domain with Cadana White Label Platform

Adding a Custom Domain

Overview

Custom domains are essential for maintaining brand consistency and trust with your users. Cadana offers two straightforward options for setting up a domain for your white-labelled UI.

Option 1: Cadana-Provided Subdomain

By default, Cadana provides all white label clients with a unique subdomain, requiring no additional configuration on your part. You can opt to use this subdomain directly or redirect requests from your own domain to the provided subdomain.

Example:

Cadana provides a subdomain like enterprise1.cadanapay.com. You can use this directly or set up a redirect from a domain of your choice to point to this subdomain.

Steps:

  1. Use the provided subdomain directly, or
  2. Set up a redirect from your domain to the provided subdomain.

Note: Cadana generates a unique subdomain for all white label clients by default.

Option 2: Using Your Own Custom Domain

For a more personalized experience, you can provide a custom domain name. Cadana will generate ACM certificates for the subdomain, which will require DNS record verification.

Steps:

  1. Provide your custom domain name to Cadana.
  2. Cadana generates ACM certificates for the subdomain.
  3. Verify the certificates by adding the provided DNS records to your domain's DNS configuration.

Example DNS Records:

Domain NameRecord NameRecord TypeRecord Value
app.example.com_53dc40d8e563e923scq5a06b03c602f90.app.example.com.CNAME_ec562bvad13rh99c494f5e048fbf17ca7b384.whqzffzsdn.acm-validations.aws.
staging.example.com_637935sedg0dc813ea541ddd23526ec9dc93.staging.example.com.CNAME_9a8d6ak83a6ef0a789f7d486cb85143d.whqzffzsdn.acm-validations.aws.
staging.example.comstaging.example.comCNAME{{uniquePlatformID}}.cloudfront.net.

Verification and Usage:

After adding the DNS records, Cadana will verify the certificates and configure them for use with your custom domain. Ensure the DNS records are propagated and verified before directing traffic to the custom domain.