How to configure Custom Domains?
A custom domain is a unique name that identifies your website. There are scenarios where you do not want to expose the default domain provided by Developer Portal. In such cases, you can customize the default tenant URL or domain and access the tenant using your own domain.
Use custom domains if you want to make your application accessible on your own domain. Custom domains direct requests to your own URL.
You can request for a custom domain name for your tenant. For example, if your company domain is abc.com, you can have the domain name as https://subdomain.abc.com. Contact Software AG Global Support for details on how to enable and configure the custom domain capability.
Steps to configure custom domains:
Determine the number of domains to be configured for your account and the list of custom domains.
The domain names are owned by you.
Decide the SSL certificate required, which depends on whether you want to protect a single domain, multiple subdomains of a domain, or multiple domain names.
Share the number of domains to be configured for your account and the list of custom domains with Software AG.
Obtain the SSL certificates from a Certificate Authority (CA) and determine the number and type of domains you want to be protected by the certificates.
Send the SSL certificates and Certificate Key to Software AG in base64 format to configure the certificates on the custom domain load balancer.
Software AG sends you the CNAME in return.
Using the CNAME, configure your DNS to point to the custom domain load balancer.
After the configuration is completed, start using the custom domain to access webMethods.io API Gateway.
Checks for existing assets after configuring custom domains
External end points change after the custom domain is configured, so you have to inform your partners about the new domain.
Verify all assets that expose end point URLs, for example, REST APIs, SOAP APIs, Services over HTTP, webhooks and so on.
Few assets, for example, SOAP APIs and REST APIs may not work after the custom domain change as the endpoints change after the custom domain is configured, so you have to inform your customers to update the endpoints.
Allowed IP Addresses
Developer Portal connects with most third-party services easily and instantly. However, in some cases, you may have to connect to your servers from specific IP addresses, and access resources that lie behind a protective firewall. This can be achieved in Developer Portal. SoftwareAG provides a set of static IP addresses that you have to allow in your firewall. This allows Developer Portal to make connections to your servers and run the required services successfully.
Software AG Cloud products are available in several geographical regions, operated by different infrastructure providers. Go to the Software AG Cloud Regions website for information on the available products and also the underlying infrastructure provider in each region.
Currently, Developer Portal is available on Amazon Web Services (AWS) and Microsoft Azure. Based on the vendor and the associated region selected by you at the time of creating your tenant, you need to allow relevant IPs to establish the connectivity. Once you add the allowed IP addresses available on the Software AG Cloud Regions website, you should be able to connect to your resources from Developer Portal services. If not, contact Software AG Global Support with the required details.
Tenant URL and Software AG Cloud Region
The following table helps you to identify the cloud region based on a your tenant URL. Once you identify your cloud region, go to the Software AG Cloud Regions website, and click the Show IP option for information on the allowed IP addresses.
|Sample Tenant URL||Software AG Cloud Region|
|Non CA3S based:
|US1 Oregon AWS|
|Non CA3S based:
|EU2 Frankfurt AWS|
|AU1 Australia East Azure|
|US2 East Azure|
|EU3 West Azure|