Encryption Activities Extension Library

Protect sensitive content by encrypting and decrypting it inside your workflows.

The Encryption Activities Extension Library adds two activities: Encrypt Message and Decrypt Message. Use them when you need to protect message content before it is stored or transmitted, and then recover the original content later in the workflow when needed.

Download IntegrationSoup.EncryptionActivities.msi

Using It In A Workflow

1. Run the MSI on the server.
2. Restart the Integration Soup service if needed.
3. Add Encrypt Message where you want plain text to become encrypted text, or add Decrypt Message where you want encrypted text turned back into readable text.
4. Open the activity message template and insert the source content from the receiver or earlier activity.
5. Enter the same encryption key in both the encrypt and decrypt steps, preferably by inserting a protected variable rather than typing it directly into the workflow.

What To Place In The Parameters

  • Encryption Key: enter the shared secret used for both encryption and decryption. A longer key is better; the built-in guidance recommends at least 12 characters.

What To Place In The Activity Message

For Encrypt Message, place the content you want to protect into the activity message. The incoming message type is selectable in the workflow designer, so the activity can be used in more than one workflow shape. For Decrypt Message, place the encrypted text into the activity message.

A typical setup is to right click in the message template and choose Insert Activity Message so the text comes directly from the previous step in the workflow.

What The Activity Returns

Encrypt Message returns encrypted text in a text response. Decrypt Message returns the decrypted content and lets you choose the response message type in the workflow designer so downstream steps can treat the value as the appropriate message type.

When decrypting non-text content, choose the response type that matches the original message representation.

Typical Uses

  • Protecting temporary payloads before saving them outside the workflow.
  • Encrypting message content before partner delivery or storage.
  • Decrypting inbound content that arrives already protected.
Extension Library Directory Helpful Links

Download HL7 Soup and Integration Host

Return to the Tutorials Directory