Configuring custom domains

A custom domain enables the use of a unique, branded web address instead of the platform’s default domain.

By default, services are accessed by using platform-generated URLs, for example, yourapp.provider.com. With a custom domain, you can replace the default domain with a domain that belongs to your organization, such as api.yourcompany.com.

The benefits of using custom domain are as follows.

  • Use your organization’s domain for a professional and consistent branding identity.
  • Create simple, meaningful URLs for your users for ease of use.
  • Align all services and integrations under a single domain.

In webMethods Integration, you can use custom domains that are configured at the platform-level. This means any custom domain set up at the platform is automatically reflected and used within the integration, helping ensure consistency across services.

When a custom domain is configured at the platform-level:

  • The platform automatically routes requests through your custom domain.
  • All supported integrations use this domain by default.
  • No additional configuration is required at the integration level after set up.

To configure a custom domain, contact IBM support. After the custom domain is enabled, your custom domain is automatically applied across integrations.

mTLS domain behavior

If mTLS is enabled, the mTLS endpoint is automatically derived from your custom domain. An mTLS subdomain is added to your primary domain.

Example of mTLS domain:

  • Primary domain - mydomain.example.com
  • mTLS domain - mydomain.mtls.example.com

This structure helps ensure a clear separation between regular and mTLS-secured traffic and maintains consistency with your custom domain.