How to change the legacy DNS configuration for the 3scale SaaS Developer portal

Solution Verified - Updated -

Environment

  • Red Hat 3scale API Management SaaS

Issue

Resolution

Change the DNS configuration from:

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

To

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

Root Cause

According to the Custom domain configuration documentation, the developer portal should be pointing directly to autossl.3scale.net, without passing through your original developer portal name.

Diagnostic Steps

If you use a DNS tool like "dig", you will see that the custom developer portal domain is already arriving correctly to autossl.3scale.net, however it goes through different extra DNS hops using the original 3scale developer portal domain (example "developer.3scale.net"), which is a legacy DNS configuration that will be deprecated soon.

$ dig developer.mydomain.com
...
developer.mydomain.com. 7200    IN  CNAME   developer.3scale.net.
developer.3scale.net.   600 IN  CNAME   mtssl-edge-a.3scale.net.
mtssl-edge-a.3scale.net. 5  IN  CNAME   autossl.3scale.net.
autossl.3scale.net. 5   IN  CNAME   autossl.pro-saas.3sca.net.
autossl.pro-saas.3sca.net. 5    IN  A   35.170.219.72
autossl.pro-saas.3sca.net. 5    IN  A   34.234.179.47
autossl.pro-saas.3sca.net. 5    IN  A   34.194.220.181

With the requested change, service will not be affected, developer portal traffic will still go to "autossl.3scale.net" but with fewer DNS hops, so having something similar to the following example:

$ dig developer.mydomain.com
...
developer.mydomain.com. 7200    IN  CNAME   autossl.3scale.net.
autossl.3scale.net. 5   IN  CNAME   autossl.pro-saas.3sca.net.
autossl.pro-saas.3sca.net. 5    IN  A   35.170.219.72
autossl.pro-saas.3sca.net. 5    IN  A   34.234.179.47
autossl.pro-saas.3sca.net. 5    IN  A   34.194.220.181

This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.

Comments