Skip navigation
Toggle Sidebar

AS2 Server Connector - Legacy

The AS2 Server Connector is only manageable as a legacy connector in existing integrations. If you would like to enable AS2 listening, review the AS2 Shared Server Connector as it contains all required functionality.

The AS2 Server Connector allows you to receive data in real-time via the AS2 protocol. AS2 is a common communication choice for EDI and business-to-business (B2B) integrations. Because of this, the AS2 Server Connector will almost always be used within the context of a Trading Partner.

The AS2 Server Connector is not like Web Services or SOAP. It can be used to receive generic data (often in EDI or XML, but not necessarily) via AS2. It "listens" for inbound or event-based messages sent from trading partners and processes them immediately. As a result, AS2 Server Connectors should only be used in the Start Shape as the initial inbound Connector. Processes that use this Connector do not need to be scheduled.

Applications and trading partners will send messages to a specific URL:

http://<Atom Host name or IP address>:<Port>/as2
or if using SSL:
https://<Atom Host name or IP address>:<Port>/as2

These variables are configured in the Connection and Operation Components. This is the URL you will give to the sending trading partner.

If you receive AS2 from multiple trading partners, you will typically configure only one AS2 Server Connection and pair it with multiple AS2 Server Operations, one for each trading partner based on a unique AS2 ID.

The AS2 Server Connector is used to "listen" for inbound messages sent from another trading partner. For sending data, use the AS2 Client Connector.


Prerequisites

  • AS2 Server Connections can only be used within a deployed process. This means you cannot use an AS2 Server Connection via Test Mode.
  • You must be able to provide your trading partner with a static URL/IP address to connect to. This means the machine on which the Atom is installed or network gateway device must have a static IP address assigned. Work with your network administrator for help with this configuration.
  • Because AS2 is a secure protocol, you will need to provide your trading partner with a certificate that they will use to encrypt data when sending to you. You can either import an existing certificate or generate a new one within Boomi. See Certificates for more information on working with Certificates.
  • You must configure your firewall to allow AS2 traffic on the specific ports configured in the AS2 Server Connection. A common port for AS2 are 8080. Contact your network administrator for help configuring the firewall.
  • Be careful not to deploy more than one AS2 Server Connection that is configured to listen on the same port to the same machine. This will result in conflicts and unpredictably behavior until corrected.


Tracked Properties

This Connector has the following Tracked Properties that can be referenced in various Process Steps.

Name Description
AS2 From ID AS2 ID of the sending entity.
AS2 To ID AS2 ID of the receiving entity.
Subject AS2 subject of the message.
Message ID AS2 message ID.
File Name The inbound file name of the document.



Additional Resources
What is AS2?
Official standard

Adaptavist Theme Builder Powered by Atlassian Confluence