Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

To configure an AS4.NET MessageHandler to act as an ebMS endpoint that receives AS4 Messages from EESSI the following PModes are required:

 

 


  • A Sending PMode which is used to send AS4 Messages via MultiHop in the Push Message Exchange Pattern. (eessi-push-send-pmode-AP)
  • A Sending PMode that is used by a PullReceive Agent.  The PullReceive Agent uses this PMode to send PullRequest signal-messages. (eessi-pull-send-pmode)
  • A Receiving PMode that is used by the PullReceive Agent.  When an AS4 Message is received via Pulling, the PullReceive Agent will dynamically determine the Receiving PMode that is necessary to treat the received AS4 Message. (eessi-pull-receive-pmode)
  • A Sending PMode that is used to send a Receipt or Error signal-message. (eessi-pull-response-send-pmode)

To setup an EESSI ebMS endpoint, the following steps need to be undertaken:

3.4.1   Configure the Pmodes

In the samples\pmodes\eessi folder, you can find skeleton files for the PModes that were mentioned in the previous section.
You’ll need to make some minor modifications to those files in order to be able to use them within EESSI:

eessi-push-send-pmode.xml

    • Configure the URL to where AS4 Messages should be pushed
    • Specify the TLS certificate that must be used
    • Specify the Signing certificate that must be used
    • Specify the PartyInfo

eessi-pull-send-pmode.xml

    • Specify the MPC that is used for pulling
    • Configure the URL to where PullRequest signals must be send
    • Specify the TLS certificate that must be used
    • Specify the Signing certificate that must be used

eessi-pull-receive-pmode.xml

No mandatory configuration modifications are required.

eessi-pull-response-send-pmode.xml

    • Configure the URL to where PullRequest signals must be send
    • Specify the TLS certificate that must be used
    • Specify the Signing certificate that must be used

Copy the eessi-pull-receive-pmode.xml file to config\receive-pmodes folder.

Copy the following files to the config\sending-pmodes folder:

    • eessi-push-send-pmode.xml
    • eessi-pull-send-pmode.xml
    • eessi-pull-response-pmode.xml

3.4.2   Modify settings.xml to enable a PullReceive Agent

The settings.xml file has a PullReceive Agent configured that is currently commented out.

In the configuration of that PullReceive Agent you’ll see that the eessi-pull-send-pmode is used to send PullRequest signal-messages.  The PullReceive Agent will send PullRequest messages in intervals that vary from 1 second to 25 seconds, depending on the response that is received for the PullRequest.  When no messages are received as a result of a PullRequest, the interval will gradually increase until a maximum interval of 25 seconds is reached.  When messages are received, the interval will be reset to the configured minimum-interval.

Remove the comments and start the AS4.NET component.  You’ll see that the AS4.NET MSH will start sending PullRequest signal-messages to the URL that has been configured in the eessi-pull-send-pmode.