AS2 Inbound Parameters

For AS2 inbound (receiver) connections for transactions over the HTTP and HTTPS ports, enable AS2 by selecting the AS2 check box on the Site's Connections tab. You can enable or disable AS2 for partner (user) accounts on the Settings Template and/or for each user, or by selecting AS2 in the New User Creation wizard on the protocol selection page when you create the partner account. The standard inheritance rules apply. (AS2 has to be enabled and configured for the Site before you can enable it for a Settings Template or user account.)

The parameters in the table below are available on the AS2 Inbound tab and can be configured manually or using the setup wizard.

Parameter

Required/
Optional

Description

Your certificate

Required

Displays the AS2 certificate public key path to be used for signing the MDN and for decryption, copied from the Site. (Can be on a drive or UNC path.)

Partner certificate

Required

Specifies the AS2 certificate to be used for verifying signed messages. (Can be on a drive or UNC path.)

Your AS2 identifier

Required

Your AS2 identifier.

Partner AS2 identifier

Required

Your partner's AS2 identifier (must be unique)

Authentication mechanism (v6.1 and later)

Required

Used to specify whether the client is authenticating with username and password or using Message Level Security (MLS). Refer to AS2 Authentication for more information.

Partner AS2 identifier mismatch policy

Required

Used to accept or reject AS2 transactions where the connecting partner’s AS2-From ID does not match the AS2 identifier defined for that partner.

  • Reject (default) - Disallow the transaction

  • Accept - Allow the transaction

EFT Server AS2 identifier mismatch policy

Required

Used to accept or reject AS2 transactions where the connecting partner’s AS2-To ID does not match EFT Server AS2 identifier defined for that partner in that partner’s AS2 Inbound tab.

  • Reject (default) - Disallow the transaction

  • Accept - Allow the transaction

Duplicate Message ID with different contents

Required

Used to Accept or Reject AS2 transactions with duplicate Message IDs.

  • If an incoming request has the same Message ID and the same payload as a prior incoming message, EFT Server sends the exact same response from that prior transaction back to the client, and does not extract or process the payload (that is, discards the payload, does not save to file system, does not trigger Event Rules, etc.).

  • If an incoming request has the same Message ID, but the payload is different, EFT Server processes or discards the message based on the configuration provided by the user.

Options include:

  • Reject (default) - Disallow the transaction

  • Accept - Allow the transaction

Duplicate Contents with different Message ID

Required

Used to overwrite or reject AS2 transactions where the file is a duplicate of an existing file already residing in the upload directory.

  • Reject (default) - Disallow the transaction

  • Overwrite - Overwrite the existing file with the new version

  • Numerate - Add a unique number to the filename

Message not signed (v6.1 and later)

Required

Used to specify whether EFT Server will Accept or Reject the transaction if it is not signed.

Message not encrypted (v6.1 and later)

Required

Used to specify whether EFT Server will Accept or Reject the transaction if it is not encrypted.

MDN send attempt timeout (seconds)

Required

Specifies the timeout period after which an asynchronous MDN send attempt shall be considered a failure if no response is received from the remote server. Range: 0-600, 60 seconds is the default. 0 = no timeout.

MDN send attempt retries

Optional

Number of time to attempt to send MDN. Range: 0 (no retry) to 999; 10 is the default.

icon_info.gif

Retries do not include the initial attempt. That is, 10 retries means 10 in addition to the first attempt (11 total).

MDN send attempt delay between retries (seconds)

Optional

Retry interval. Range: 0 (no wait) to - 600 seconds; 30 seconds is the default

icon_info.gif

Failure only occurs after all attempts to send MDN have failed. Likewise, success is only after complete transaction has occurred (file received and MDN is sent).

Transaction FAILED notification e-mail*

Optional

Opens the Edit Mail Template in which you can specify an e-mail notification for failed transaction. (Refer to e-mail Notification Action for details of defining an e-mail notification.)

Transaction SUCCESS notification e-mail*

Optional

Opens the Edit Mail Template in which you can specify an e-mail notification for successful transaction. (Refer to e-mail Notification Action for details of defining an e-mail notification.)

Transaction FAILED run command*

Optional

Opens the Custom Command dialog box in which you can specify a Custom Command to occur upon failed send. (Refer to Creating a Command to create a command and refer to Using an Event Rule to Execute a Command (Run a Process) for details of using a Command.)

Transaction SUCCESS run command*

Optional

Opens the Custom Command dialog box in which you can specify a Custom Command to occur upon successful run. (Refer to Creating a Command to create a command and refer to Using an Event Rule to Execute a Command (Run a Process) for details of using a Command.)

Move received data to folder

Optional

Specify a folder in which to save received data. (Can be on a drive or UNC path.)

Rename file(s) to

Optional

Appends filename to path using specified variables. Preserve filename if undefined.

icon_info.gif

This parameter is the same as the Specify relative path and filename field in the Target File tab of the Offload Action wizard in EFT Server’s Copy/Move File to Host Action.

HTTP 1.0 mode (don't send HTTP/1.1 100 Continue)

(v6.2.9.1 and later)

Optional

"100 Continue" is a part of the HTTP protocol and means "Everything is OK for now, continue this transaction"; many AS2 servers use it to avoid timeouts. It is the client software's responsibility to process this reply properly (just skip until 200 OK or real HTTP error is received); if the client does not process the reply correctly, you can turn off the "100 Continue" response by selecting the check box. (The check box is cleared by default.) If your AS2 partner receives multiple MDN failures when sending to EFT Server in HTTPS, select this check box to turn off the "100 Continue" reply.

* EFT Server sends e-mails and executes commands only after the final transaction status (Failure or Success) is known.