Creating an AS4 exchange profile from inverse configuration

In AS4 Microservice, you can use an XML file that is generated by your trading partner to create an outbound AS4 exchange profile. With the Create From Inverse function, you can quickly and easily create an exchange profile to onboard a trading partner.

Before you begin

Ensure that the format of the file is XML before you begin the create from inverse task.

About this task

In AS4 Microservice, you can import an XML file that contains an exchange profile configuration. With the import function, you can generate an outbound AS4 exchange profile with the inverse configuration that corresponds to the configuration in the XML file. To create an exchange profile from the inverse file, complete the following procedure:
Note: After you generate an inverse exchange profile configuration, it is suggested not to import (Create From Inverse) the exchange profile configuration into the same AS4 Microservice instance.
For a complete list of XML elements associated with creating an exchange profile from an inverse configuration file and generating an inverse exchange profile, see ../administering/as4/meig_as4_jumpstartxmlelements.html.

Procedure

  1. Log in to AS4 Microservice. You must have exchange profile creation permissions to use the Create From Inverse operation.
  2. Click Exchanges > Exchange Profiles.
  3. On the Exchange Profiles page, click Create From Inverse.
  4. On the Create Exchange Profile From Inverse page, specify values for the following fields:
    The exchange profile configuration includes the following settings:
    • File Information - Provides information about the XML file that you are importing.
    • Exchange Identification - Includes identification (name and conformance policy) settings for the exchange profile.
    • Trading Partner Organization - The trading partner organization that is associated with the exchange profile.
    • Connection Information - Includes connection settings for the outbound message, receipts, and error messages.
    • Certificate Alias - Includes the certificate alias that matches the configuration of the certificate in the uploaded file.
    • Credentials - Includes the user credentials that match the credentials in the uploaded file.
    Field Description

    File

    Click Browse and select the XML file that you want to import and click Upload.

    Profile name

    Type a unique name for the exchange profile.

    Conformance policy

    Conformance policies that match the settings of the conformance policy in the upload file are listed. Select the appropriate conformance policy. If a match is not found, no conformance policies are displayed.

    To add a conformance policy, click Add Conformance Policy.

    When you are adding a conformance policy, the conformance policy settings from the upload file are preset on the New Conformance Policy page. For example, if user authentication checking is enabled with user credentials for the import file, the same is enabled on the New Conformance Policy page.

    You cannot modify the preset fields.

    Overall exchange pattern

    Displays the message exchange pattern.

    Organization

    Trading partner organizations that match the settings of the trading partner in the upload file are listed. Select the appropriate organization. If a match is not found, no organizations are listed.

    To add a trading partner organization, click Add Organization.

    When you are adding a trading partner, the trading partner settings from the upload file are preset on the New Organization page. If required, you can modify the settings.

    Data HTTP or HTTPS destination

    HTTP or HTTPS destinations that match the settings of the HTTP or HTTPS destination in the upload file are listed. Select the appropriate HTTP or HTTPS destination. If a match is not found, no destinations are displayed.

    To add an HTTP or HTTPS destination, click Add Destination.

    When you are adding an HTTP or HTTPS destination, some destination settings from the upload file are preset on the New Destination page. You cannot modify the value of the Service URL field.

    Pull HTTP or HTTPS destination

    Conditional: If you are importing exchange profile configuration for the following message exchange patterns, the option to select an appropriate pull destination is displayed:
    • AS4 Outbound Two-Way/Push-Pull
    • AS4 Outbound One-Way/Pull

    Pull destinations that match the settings of the pull destination in the upload file are listed. Select appropriate pull destination. If a match is not found, no destinations are displayed.

    To add a pull HTTP destination, click Add Destination.

    When you are adding an HTTP or HTTPS destination, some destination settings from the upload file are preset on the New Destination page. You cannot modify the value of the Service URL field.

    ebMS HTTP or HTTPS destination

    Conditional: The ebMS HTTP or HTTPS destination list is displayed if receipts are configured in the conformance policy that is associated with the exchange profile you are importing.

    HTTP or HTTPS destinations to send ebMS receipts that match the settings of the destination in the upload file are listed. Select appropriate destination. If a match is not found, no destinations are displayed.

    To add an HTTP or HTTPS destination, click Add Destination.

    When you are adding an HTTP or HTTPS destination, some destination settings from the upload file are preset on the New Destination page. You cannot modify the value of the Service URL field.

    Error HTTP or HTTPS destination

    Conditional: The Error HTTP or HTTPS destination list is displayed if error reporting is configured in the conformance policy that is associated with the exchange profile you are importing.

    HTTP or HTTPS destinations to send ebMS error messages that match the settings of the destination in the upload file are listed. Select appropriate destination. If a match is not found, no destinations are displayed.

    To add an HTTP or HTTPS destination, click Add Destination.

    When you are adding an HTTP or HTTPS destination, some destination settings from the upload file are preset on the New Destination page. You cannot modify the value of the Service URL field.

    Certificate Alias

    Conditional: Certificate aliases that match the settings of the certificate alias in the upload file are listed. Select the appropriate certificate alias. If a match is not found, no alias are displayed.

    To add a certificate alias, click Add Certificate Alias.

    When you are adding a certificate alias, the certificate alias settings from the upload file are preset on the New Certificate Alias page.

    You cannot modify the preset fields.

    Request credential

    Conditional: User credentials that match the settings of the credentials in the upload file are listed. Select the appropriate user credential. If a match is not found, no credentials are displayed.

    To add a credential, click Add Credential.

    When you are adding a user credential, the settings from the upload file are preset on the New Credential page.

    You cannot modify the preset fields.

  5. Click Save to save the exchange profile configuration.
    After you click Save, the detailed page for the created exchange profile is displayed. The status of the exchange profile is Undeployed. Specify values for the other mandatory fields to complete the exchange profile configuration.