add station icon

Adding a Trading Station

Version: latest

The first thing you need to configure on the AS2 Gateway is a "Trading Station" which is used as your local endpoint of the trading communication, you will receive messages to this trading station and you can send messages from this trading station. A trading station is nearly analogous to a email address.

Lets start with adding a trading station for your organization. First go to the stations view using the "Stations" icon on the left navigation menu. Then on the top menu, click on "New Station" button.

station nav pointed

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

station add

To add the trading station;

  1. Specify a name for the trading station. This is solely used for the organization and viewing of stations within the application, and will not be used in AS2 message communication.

  2. Specify the AS2 identifier, this is the identifier used to identify the AS2 station, analogous to your email id and used in AS2 message communication, this has to be unique among a set of agreed partners, and AS2 Gateway.

    Spaces, backslash or double quotes are not allowed for the station AS2 identifier. Minimum length is one and and maximum length should be 128.

  3. Specify an email address to be used in From header of AS2 communication (This is not AS2From, which will be the as2identifier on outgoing messages) Further this email address will be used to send notification for incoming messages.

  4. A small description for this trading station to easily identify it.

    If required a maximum of three emails can be added as a comma separated list (without spaces in between) to receive notifications. Primary email should be the first if a list is given.

  5. Toggle "Enable Email Notifications" to false if you do not wish to receive email notification for incoming AS2 messages.

  6. Then we have to configure the certificate for the station. Here we have three options.

    • Option 1 - Generating a new keystore.

    • Option 2 - Uploading an existing keystore.

    • Option 3 - Selecting a certificate from "Certificate Store".

    If you are new to AS2 messaging we recommond you to go with Option 1 until you are familiar with the concepts related to certificates.

Option 1 - Generate New Key Store:
new ks gen
  1. Specify a common name for the new certificate. This can be your name or your server’s hostname. For example "Rajind Ruparathna" or "www.adroitlogic.com".

  2. Specify the organization unit. This can be a something like section name in your organization. For example "Information Technology"

  3. Specify the organization. This can be your company name. For example "AdroitLogic Lanka (Pvt.) Ltd."

  4. Specify a city. For example "Colombo".

  5. Specify a state. For example "North Western"

  6. Select your country from the drop down list.

  7. Select a preferred key length.

  8. Enter a password for the new key store.

  9. Enter a password for the certificate.

That is all if you are going with option 1.

Option 2 - Upload An Existing Key Store:
upload ks

If you have an already generated key store, you can go with this option.

  1. Enter the password of the keystore.

  2. Browse and select the key store.

  3. Enter the alias of the certificate.

  4. Enter the password for the certificate.

Option 3 - Selecting A Certificate From Certificate Store:
select cert from store

Once the certificate configuration is complete, go ahead and submit the form by clicking on the "Save" button.

Trading Station Listing

Once you add the station, you will be directed to the trading station listing page, from which you can view the partner configurations of the station just created.

station list

Note the actions on the bottom section of the station card are the actions available for a trading station.

Partner Configuration of Trading Station

partner config button pointed

Click on the "Partner Config" button of the action panel of the trading station card to see the configuration that you should be sharing with your partners in-order for them to setup a trading partner to send AS2 messages to your organization via the trading station we just created in previous step.

partner config

You can use the share configuration option to share this configuration to your partner vi email when required.

  1. Toggle "Attach HTTPS certificates" to true to attach HTTPS certificate of your station when configuration is shared.

    Attach the HTTPS certificate only if you plan to use HTTPS when communicating with your partner.

  2. Specify an email address of the partner you want to communicate with.

  3. Click this "Send" button to share the configuration.

Now that we have created a trading station, the next step would be adding a partner so that we can starting communicating.

In this topic
In this topic