Configuring Inbound AS2 Parameters

For AS2 inbound (receiver) connections for transactions over the HTTP and HTTPS ports, enable AS2 by selecting the Enable AS2 over HTTP/S check box on the Site's Connection Options tab. You can enable or disable AS2 for partner (user) accounts at the User Setting Level or the user level, 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 at the Site level before you can enable it for a User Setting Level or user account.)

The parameters in the table below are available on the AS2 Inbound tab and can be configured manually or using the AS2 Partner Access 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

Used to apply a unique AS2-To ID that EFT Server will accept from this partner’s inbound messages. Copied from the Site-wide EFT Server AS2 ID at the time the user is created, but NOT inherited or changed from that point forward unless the administrator makes explicit changes to the user settings.

Partner AS2 identifier

Required

Used to identify the AS2-From ID for inbound messages emanating from his partner.

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 the 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

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.

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

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 send 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.

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

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