General Operations
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:
|
the checksum algorithm |
|
|
Content |
Binary |
The content for calculating the checksum |
|
|
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 |
|
|
Validate Checksum
<crypto:validate-checksum>
Validates the checksum of the content or value against the checksum previously calculated using the Calculate Checksum operation.