integration icon

Setting up a Custom Domain for AS2

Version: latest

With AS2 Gateway, you can assign a custom domain name (hostname) to your AS2 receiver endpoint. For example, instead of sending to the default

http://service.as2gateway.com:8280/…​

endpoint, your partners will see - and send messages to - a custom URL (domain) such as

http://as2.your.custom.domain:8280/…​

This is useful if you wish to use an AS2 domain name that better represents your organization, business or public domain, instead of the generic/default one provided by AS2 Gateway.

AS2 protocol or AS2 Gateway does not use or depend on the message receive hostname/domain in their internal operation, except when using the test URL (this requires an additional step; see below). So, adding a custom hostname does not impact AS2 communication, or any already set-up AS2 connections.
Adding a custom domain will not change the port number (HTTP: 8280) or the path (/service/as2-receiver) where AS2 Gateway accepts messages. If you also want to customize the port number, contact AS2 Gateway team.

Configuring a Custom Domain

Simply add a DNS "A" (alias) record, pointing your custom domain to the IP address of AS2 Gateway (52.204.119.191):

as2.your.custom.domain.  300  IN A      52.204.119.191

No changes are needed on AS2 Gateway or your account.

You can find the instructions to configure an A record, under the online documentation/guides of your DNS/hosting provider.

Instead of an A record, you can also add a CNAME record pointing your domain to service.as2gateway.com. (note the trailing dot):

as2.your.custom.domain.  300  IN CNAME  service.as2gateway.com.

Using Test URLs

If you or your partner is using (or planning to use) test-mode partner URLs (where the hostname must start with a test- prefix), you would also need to add an A/CNAME record for test-<your custom domain> as well:

  • if adding an A/alias record: point to the same AS2 Gateway IP (52.204.119.191)

  • if adding a CNAME record: point to test-service.as2gateway.com.

Custom Domains for HTTPS

By default, custom domain names are supported only for AS2 over HTTP. If you need a custom domain name assigned for HTTPS (e.g. instead of https://service.as2gateway.com:8443), please contact AS2 Gateway team, mentioning the domain name and the required port number (8443/4080/443).

AS2 protocol already encrypts transmitted data, so unlike in regular web traffic, HTTPS is not needed in most cases; unless there is a regulatory/policy requirement.
In this topic
In this topic