AS2 communications in Jitterbit EDI

Introduction

AS2 (Applicability Statement 2) is a protocol for securely and reliably exchanging data over the internet, and a popular way for businesses to exchange EDI documents with their trading partners.

If your partner offers an AS2 endpoint, you can use it to send and receive documents by configuring an AS2 communication setting and assigning it to them. This page shows you how to do this.

Create an AS2 connection

To create an AS2 connection, follow these steps:

1. Click the New button, then select AS2 connection. The Create a new AS2 connection panel appears (highlighted):

   

2. Set the following toggles:

   • Duplicate Transaction Check: Turn on to check for duplicate transactions transmitted via this connection.

   • Active: Turn on to make the connection available for use.

3. In the basic settings group, set values for the following fields:

   

   • Name: The connection name.

   • Sending URL: The URL provided by the trading partner for sending documents through the AS2 connection. It must be included as part of the AS2 configuration.

     Receiving URLs

     You must also provide your trading partner one of these receiving URLs, according to your Harmony account's region:

     • North America: na.as2.jitterbitedi.com/receiver.aspx

     • EMEA: emea.as2.jitterbitedi.com/receiver.aspx

     • APAC: emea.as2.jitterbitedi.com/receiver.aspx (APAC uses EMEA's URL.)

   • Connection Timeout: The initial connection timeout.

   • AS2 Company ID: The AS2 company identifier.

   • AS2 Partner ID: The AS2 partner identifier.

4. (Optional) Expand the Proxy settings tab, then set values for the following fields:

   

   • Proxy: Enable the proxy server.

   • Address: The proxy server address.

   • Domain: The proxy server domain.

   • Username: The proxy server username.

   • Password: The proxy server password.

5. (Optional) Expand the HTTP settings tab, then set values for the following fields:

   

   • Authentication: Enable HTTP authentication.

   • Authentication Type: The HTTP authentication type. Select one of the following:

     • Basic: Use non-encrypted base64-encoded credentials ([RFC 2617]).

     • Digest: Use encrypted base64-encoded credentials ([RFC 2617]).

   • Authentication user: The username for HTTP authentication.

   • Authentication password: The password for HTTP authentication.

   • Subject: The subject describing the purpose of the endpoint.

6. (Optional) Expand the Encryption settings tab, then set values for the following fields:

   

   • Signature algorithm: The signature algorithm.

   • Encryption algorithm: The encryption algorithm.

   • Sign: Enable to reject unsigned incoming messages.

   • Encrypt: Enable to reject unencrypted incoming messages.

   • Request MDN: Request an MDN (message disposition notification).

   • Request MDN signed: Request a signed MDN.

   • Compress: Enable to use ZLIB compression.

7. (Optional) Expand the Certificate tab:

   

   The tab has two regions:

   • My certificates: Certificates for your organization. These are private certificates, which must be in pfx format, and contain only private keys.

   • Partner certificates: Certificates for the trading partner. These are public certificates, which must be in .cer format, and contain only public keys.

   Uploaded or created certificates appear as a row, showing the name, expiry date, and the following icons:

   • Assign: Assign the certificate to the connection.

   • Download: Download the certificate as a .cer file.

   • Delete: Delete the certificate. To confirm the action, enter the word DELETE in the dialog's text field, then click the Delete button.

   To upload a certificate, follow these steps:

   1. Click the Upload icon for either party.

   2. In the panel that opens, enter values for Certificate name and Password:

      

   3. Click the Upload file button, then select the certificate file. (Accepted file types are .cer and .pfx.)

   4. In the Upload certificate panel, click the Save button.

   To create a certificate for your organization, follow these steps:

   1. Click the Create icon.

   2. In the panel that opens, enter values for Certificate name and Validity years

      

   3. In the Create a new certificate panel, click the Save button.

8. In the Create a new AS2 connection panel, click the Save button. The new connection is now ready for you to assign it to a partner.