EDI Signature

Usage

Using the EDI Signature Utility module, you can sign or verify EDI messages.

The sender and receiver values of the USH segment are being set according to the sender and receiver information of the EDI message.

Signing EDI Messages

With the EDI Signature Utility, you can sign outgoing EDI messages in EDIFACT format.

For the signing of the EDI message, the hashing algorithm SHA-1 and the signature algorithm RSA are used.

Prerequisites

You have a private key to sign the message.

Proceed as follows

  1. Integrate the module EDI Signature Utility into your workflow.

  2. Open the module for editing via the context menu.

  3. In the properties dialog, open the EDI Configuration page.

  4. Select the option Sign EDI message.

  5. Click on Next.

    → The EDI sign message dialog page is displayed.

  6. In the Add Private Key section, click the Add button.

    → A file explorer opens.

  7. Select the private key to be used to sign the message.

  8. Click Finish to close the dialog.

If there is an UNA segment in the EDI message, the delimiters are taken from the UNA segment. If not, the default delimiters are used.

Verifying EDI Signatures

With the EDI Signature Utility, you can verify the signature of incoming EDI messages in EDIFACT format.

Prerequisites

You own the certificate of the signer.

Proceed as follows

  1. Integrate the module EDI Signature Utility into your workflow.

  2. Open the module for editing via the context menu.

  3. In the properties dialog, open the EDI Configuration page.

  4. Select the option Verify EDI signature.

  5. Click on Next.

    → The Verify EDI signature dialog page is displayed.

  6. Click on the button Add public certificate of the signer.

→ A file explorer opens. 7. Select the certificate to be verified. 8. Optionally: Select the Generate acknowledgment message option to receive an acknowledgment message when the certificate is valid. 9. Click Finish to close the dialog.

Dialog Descriptions in the EDI Signature

EDI Configuration Dialog

In this dialog, you select one of the EDI configuration options.

EDI configuration

Select one of the EDI configuration options:

  • Sign EDI message

    The EDI message is signed by adding a security segment, such as USH, USA, USC, USR, or UST.

  • Verify EDI signature

    The integrity of the EDIFACT structure is checked and an AUTACK message is generated.

EDI Sign Message Dialog

Usage

For the option Sign EDI message

This dialog offers the following options:

  • Hashing algorithm

    Choose the hashing algorithm from the drop-down list. The hashing algorithm SHA1 is supported.

  • Signature algorithm

    Choose the signature algorithm from the drop-down list. The hashing algorithm RSA is supported

  • Add private key

    Click Add to add the private key in JKS format.

  • Public key data

    This field displays an already added private key.

Verify EDI Signature Dialog

Usage

For the option Verify EDI signature

This dialog offers the following options:

  • Generate acknowledgment message

    If activated, an acknowledgment is automatically generated if the EDI signature is valid. The edifact.auto.acknowledgment output variable contains the AUTOACK message.

  • Add public certificate of the signer

    Click the button to add the certificate file.

  • Certificate data

    This field displays an already added certificate.