Contact Us 1-800-596-4880

General Operations

This version of Mule reached its End of Life on May 2, 2023, when Extended Support ended.

Deployments of new applications to CloudHub that use this version of Mule are no longer allowed. Only in-place updates to applications are permitted.

MuleSoft recommends that you upgrade to the latest version of Mule 4 that is in Standard Support so that your applications run with the latest fixes and security enhancements.

The Cryptography module provides operations to calculate and validate a checksum to check data for errors. These operations are independent of the encryption strategy used.

Checksum Overview

Checksum operations enable you to ensure message integrity. The Calculate Checksum operation acts as an enricher to generate a checksum for a message when it enters a system, and then the Validate Checksum operation acts as a filter to verify the checksum when the message leaves the system. If the entry and exit values do not match, a CRYPTO:VALIDATION error is raised.

This pair of operations enables you to verify that a message remains intact between the sender and the receiver. Because checksum operations do not provide encryption or append a signature to the message, you can use the operations in conjunction with any other security features.

Calculate Checksum

<crypto:calculate-checksum>

Calculates the checksum of a given content or value, which can be an expression. You can select the hashing algorithm to use.

Parameters

Name Type Description Default Value Required

Algorithm

Enumeration, one of:

  • CRC32

  • MD2

  • MD5

  • SHA_1

  • SHA_256

  • SHA_512

the checksum algorithm

SHA_256

 

Content

Binary

The content for calculating the checksum

#[payload]

 

Target Variable

String

The name of a variable on which the operation's output will be placed

 

Target Value

String

An expression that will be evaluated against the operation's output and the outcome of that expression will be stored in the target variable

#[payload]

 

Output Type

String

Throws

  • CRYPTO:CHECKSUM  

Validate Checksum

<crypto:validate-checksum>

Validates the checksum of the content or value against the checksum previously calculated using the Calculate Checksum operation.

Parameters

Name Type Description Default Value Required

Algorithm

Enumeration, one of:

  • CRC32

  • MD2

  • MD5

  • SHA_1

  • SHA_256

  • SHA_512

The checksum algorithm

SHA_256

 

Value

Binary

The content for calculating the checksum

#[payload]

 

Expected

String

The expected checksum as an hexadecimal string

x 

Throws

  • CRYPTO:MISSING_KEY  

  • CRYPTO:VALIDATION