add partner icon

Adding a Trading Partner

Version: latest

Partners need to be added/declared for you to be able to send messages to them as well as to receive messages from them. Declaring a partner requires some information from the that respective partner such as it’s as2 identifier, recipient URL and so on.. (These are the information of a foreign trading station corresponds to the Partner Configuration that we saw on our local trading station page in the previous section).

To add a partner, first go to the partners view using the "Partners" icon on the left navigation menu. Then on the top menu, click on "New Partner" button.

partner nav pointed

Now you need to fill the required information to configure the trading partner you are about to add.

partner add
  1. Specify a name for the trading partner, this is just a textual identifier for you to easily distinguish this partner from others in the cards view and will not be used in any AS2 message communication properties.

  2. Select the partner type. In most cases this would be Production; Check with this reference if you believe you need to use Test type.

  3. Specify the AS2 Identifier of the partner, this has to be obtained from the partner.

    You cannot change this partner AS2 identifier value later!
  4. Specify a description mainly describe the partner for identification purposes within the application

  5. Specify the partner URL which is used to send messages to this partner (in other words the partner is listening on this URL for messages). This must be a HTTP or HTTPS URL (starting with http:// or https://).

  6. Set the "Upload New" toggle to true and then upload the public certificate of corresponding private certificate partner uses to encrypt messages (if encryption is enabled for outgoing messages). Here you have an option to select it from the "Certificate Store" as well.

  7. Set this "Use different certificate as signing certificate" toggle to true if you want to use different certificates for signing and encryption of AS2 messages.

    If you are new to AS2 messaging we recommond you to go with same certificate for both signing and encryption ("Use different certificate as signing certificate" toggle set to false). Refer to this section under Advanced Partner Settings for more details.

  8. Then provide a default message subject which will be used if a subject is not specified when sending messages.

  9. Then we have the advanced options. We’ll skip these for now. Refer to the Advanced Partner Settings reference for more information on the advanced options.

    partner add advanced

Finally click the Save button to submit the form.

In this topic
In this topic