Adding custom domain
To avoid frustrating cookie issues and to enhance your branding, use a custom domain.
By default, you have a Frontegg Domain. This domain ends with .frontegg.com. By using this Frontegg Domain, however, you may encounter unwanted cookie issues and use a domain that is not consistent with your brand.
Read below to learn more.
Why Use a Custom Domain
Avoid Cookie Issues
Some browsers block third party cookies by default. Providing a custom domain as your application UI domain will give you the ability to support these browsers.
Enhance Your Brand
Instead of seeing .frontegg.com in your domain, you might prefer to have your customers see your custom domain. For instance, when your customers use your application to login, your application might direct them to the following URL:
https://your-application.frontegg.com/oauth/account/login
Rather than see a domain with .frontegg.com in it, you might prefer that your customer see your domain instead.
Read below to learn how to configure a custom domain.
Configure Custom Domain
In the Frontegg portal, go to Environments ➜ [NAME OF ENVIRONMENT] ➜ Settings ➜ Domains.
For instance, go to the development environment at Environments ➜ Development ➜ Settings ➜ Domains.
On this page, you can manage your Frontegg Domains. You should see your Frontegg Domain and also a place to add a Custom Domain.

Be sure to manage the custom domains in each environment separately.
In the Custom Domain section, click the Configure button. You should see a dialog appear that asks for your domain name and gives you the information you need for creating the CNAME record in your DNS configuration.
As the instructions in the dialog indicate, add the CNAME record to the DNS configuration with your DNS provider.
Use Subdomain as Custom Domain
A common practice is to use a subdomains as the custom domain because if your app is hosted on app.sample.com and you have an existing A Record for that domain, you cannot use app.sample.com as a custom domain on Frontegg. Instead, use a subdomain as the custom domain, like auth.sample.com.
After adding the CNAME to your DNS configuration, click the Verify button.
SSL Certificate
Frontegg generates an SSL certificate for your custom domain.
If Frontegg is able to verify the CNAME record, you will see a success message.
After a successful setup, you also should see your custom domain listed on the Administration Page's Domain tab with a verified tag.
Frontegg SDK
When you're using a custom domain on Frontegg, that should be also the domain that you're passing as the
baseUrl
in thecontextOptions
in your Frontend integration package.
In the setup, you may encounter an error if Frontegg is unable to verify your custom domain. If that happens to you, double check that you entered your CNAME correctly with your DNS provider and try again.
Updated 3 months ago