AS2 (Bridge data service)

Prev Next

To use the AS2 Bridge data service, you have to create a special AS2 channel on the Lobster Data Platform and then set the parameters of that channel on the Bridge accordingly.

After that, you can transfer files (via automatically created AS2 message) from the Bridge to the Lobster Data Platform (outbound). Just use a profile that uses the special AS2 channel in an AS2 Input Agent to receive those files.

Additionally, you can transfer files (via AS2 message) from the Lobster Data Platform to the Bridge (inbound). Just use a profile that uses the special AS2 channel in an AS2 Response to send those files.

AS2 channel configuration on the Lobster Data Platform

Create a new AS2 channel on the Lobster Data Platform (→ “Administration → Partners → Partners/Channels“) and enter the following parameters in the channel settings.

  • "Select Lobster Bridge": Choose your Bridge. This will set the "Partner address" and the certificates.

  • "Own ID”: Has to match the "Partner ID" on the Bridge.

  • "Further AS2 settings": Enable "Send signed", "Send encrypted", "Receive signed" and "Receive encrypted".

  • "Partner ID": Has to match the "Local AS2 ID" on the Bridge side.

AS2 channel configuration on the Bridge

Navigate to “Administration → AS2 configuration → Partner channel” on your Bridge.

"Local AS2 ID": Has to match the "Partner ID" of the AS2 channel on the Lobster Data Platform.

"Partner ID": Has to match the "Own ID" of the AS2 channel on the Lobster Data Platform.

"Partner address": Enter the Lobster Data Platform endpoint address for AS2. Example: “https://<Your Lobster Data Platform Integration Server>/partner/AS2Retrieve” or “https://<Your DMZ Server>/partner/AS2Retrieve”, depending on whether you use the default public Bridge Gateway or a private Bridge Gateway (DMZ server).

AS2 file routing on the Bridge

Navigate to “Administration → AS2 configuration → File routing“ on your Bridge.

Monitored folders for outbound pickup and inbound routing are controlled by a single XML configuration file. You can maintain these settings via the Smart Editor (guided, safe defaults). Alternatively, you can use the Expert Editor to edit the XML file directly for full control (usually not necessary).

Outbound file settings

Parameter

Required

Default

Description

Backup folder

Yes

Path of backup folder.

Backup

No

false

If set, backup of files is created before deletion.

Folder

Yes

Path of folder to monitor for files.

Interval

No

5

Scan interval for folder in minutes to send files (minimum: 1).

MIME type

Yes

The MIME type for the AS2 message content.

Retain days

No

0

Backup file retention period in days (0 = no cleanup).

Subject

No

The AS2 message subject (you can use placeholder @file@ for the file name).

Recursive

No

false

If set, subfolders are included in the monitoring.  

Extension

No

File extension filter, e.g. “.pdf”. Value “empty” = all files. Requires recursive monitoring to be enabled.

Exclude

No

Specify the name of the folder to be excluded from the recursive monitoring.

Inbound file settings

Parameter

Required

Default

Description

Fallback folder

Yes

Directory path for files that do not match any rule.

Folder

Yes

false

Target directory for matched files.

MIME type

No

Define the MIME type of files in this folder.

Pattern

No

5

File name pattern to match.

* = Any number of characters.

? = Exactly one character.

Literal characters match exactly.

Subject

No

AS2 subject pattern to match.

Path

No

Choose how the file path is determined.

No subject path”: Save files to the default folder without using the AS2 message subject.

Use subject as path”: Save files according to the path specified in the AS2 message subject. Ensure the "Subject" parameter contains the correct path if this option is selected.

Enabling and disabling the AS2 connector

Navigate to “Administration → Application settings → AS2 configuration“ on your Bridge.

Use button "Stop sending & receiving" or "Activate sending & receiving".

When does a message appear under “Unresolved” (Platform)?

A message appears under “Unresolved” if

  • no profile was found for processing,

  • a signature check was successful,

  • the message could be decrypted.

A message does not appear under “Unresolved” if

  • the signature verification was not successful,

  • the message could not be decrypted.