Chapter 10. Custom domain configuration

Within your DNS, add a CNAME record pointing your domain name to autossl.3scale.net. For example, a domain developer.mydomain.com pointing to autossl.3scale.net may look like:

developer.mydomain.com.  CNAME  autossl.3scale.net.

Normally you would want to make the change to your custom domain before you allow public access to your Developer Portal. If you already have public users, bear in mind that it is not possible to define a redirect from mydomain.3scale.net to your custom domain, so you’ll need to inform your users about the domain change.

It is best to implement the CNAME in advance. In the rare case that this isn’t possible – such as if you have an existing site in public use at that domain – please contact Red Hat support to determine the best way to synchronize a switchover.

It may take some time for the changes with your DNS to propagate. Validate that your CNAME record has been configured correctly. You may use the following commands to validate CNAME configuration:

dig cname developer.mydomain.com

or

nslookup developer.mydomain.com

If you are using Certificate Authority Authorization (CAA), you must allow the Let’s Encrypt certificate authority to issue certificates for your domain by adding a CAA record for the letsencrypt.org address on the root domain. For example, a domain mydomain.com pointing to letsencrypt.org may look like:

mydomain.com.  CAA 0 issue "letsencrypt.org"

Depending on your DNS provider, you may need to add the 0 issue "letsencrypt.org" flag, tag, and value to the list of certificate authorities in the CAA record for your root domain. Refer to your DNS provider for instructions on how to configure CAA records.

Once you have added a CNAME entry and, optionally, added a CAA record to your DNS setup, you must open a Red Hat support case to request the Developer Portal domain change, specifying the following:

Once you have submitted the ticket, Red Hat support will validate the DNS setup and either provide confirmation once the change is applied, or respond appropriately.

Once you receive confirmation from Red Hat support regarding your domain change, review and test your Developer Portal. Ensure any non-relative links to your custom domain are updated.