Cryptography actions
Article 07/09/2024
8 contributors
Feedback
In this article
Cryptography actions enable you to encrypt and decrypt plain text and text from files providing a key and an encoding format.
The Encrypt text with AES action encrypts a text using the AES algorithm and a user-specified encryption key. You can provide the encryption key directly or through a variable.
To encrypt the text of a file directly, use the Encrypt from file with AES action. This action works similarly to the Encrypt text with AES action but requires a source file instead of a text value.
To decrypt a text, use the Decrypt text with AES , and enter the encrypted text and the encryption key previously used to encrypt it. To decrypt and store a text in a file, deploy the Decrypt to file with AES and specify a destination path.
Apart from encryption and decryption, the Cryptography group of actions provides actions to hash values with and without a key. Like the encryption actions, you can hash values from files using the Hash from file and Hash from file with key actions.
Important
Passwords entered in designated fields only work on the machine where they were initially set. This is due to the machine-specific encryption used for direct password inputs. If the flow is opened on a different machine, these passwords will not be valid and will need to be re-entered.
Encrypt text with AES
Encrypt a string with AES, using a key and a specified encoding format.
Argument
Optional
Accepts
Default Value
Description
Encoding
N/A
System default, ASCII, Unicode, Big-endian Unicode, UTF-8
Unicode
The encoding of the text to encrypt
Text to encrypt
No
Text value
The text to encrypt
Encryption key
No
Direct encrypted input or Text value
The encryption key to use
Padding
N/A
None, PKCS7, Zeros, ANSIX923, ISO10126
PKCS7
The padding to use for the selected encryption algorithm
Key size
N/A
128 bits, 192 bits, 256 bits
256 bits
The size of the key in bits to use for the encryption
Use salt
N/A
Boolean value
False
Specifies whether to use salt for encryption. When this option is enabled, the randomly generated salt becomes an output in the form of a base64 string.
Use initialization vector
N/A
Boolean value
False
Specifies whether to use an initialization vector. When this option is enabled, the randomly generated initialization vector becomes an output in the form of a base64 string
Variables produced
Argument
Type
Description
EncryptedText
Text value
The encrypted text for later processing
Salt
Text value
The randomly generated salt value for later processing
InitializationVector
Text value
The randomly generated initialization vector value for later processing
Exceptions
Exception
Description
Failed to encrypt text
Indicates that an error occurred during encryption
Decrypt text with AES
Decrypt a string with AES based on a specified key and an encoding format.
Argument
Optional
Accepts
Default Value
Description
Encoding
N/A
System default, ASCII, Unicode, Big-endian Unicode, UTF-8
Unicode
The encoding for the decrypted text
Text to decrypt
No
Text value
The text to decrypt in the form of a base64 string
Decryption key
No
Direct encrypted input or Text value
The decryption key to use
Padding
N/A
None, PKCS7, Zeros, ANSIX923, ISO10126
PKCS7
The padding to use for the selected decryption algorithm
Key size
N/A
128 bits, 192 bits, 256 bits
256 bits
The size of the key in bits to use for the decryption
Use salt
N/A
Boolean value
False
Specifies whether to use salt for the decryption
Salt
No
Text value
The salt to use for decryption in the form of a base64 string
Use initialization vector
N/A
Boolean value
False
Specifies whether to use an initialization vector
Initialization vector
No
Text value
The initialization vector to use for decryption in the form of a base64 string
Variables produced
Argument
Type
Description
DecryptedText
Text value
The decrypted text for later processing
Exceptions
Exception
Description
Failed to decrypt text
Indicates that an error occurred during decryption
Encrypt from file with AES
Encrypt the contents of a file with AES, using a key and a specified encoding format.
Argument
Optional
Accepts
Default Value
Description
Encoding
N/A
System default, ASCII, Unicode, Big-endian Unicode, UTF-8
Unicode
The encoding of the file to encrypt
File to encrypt
No
File
The text file that stores the contents to encrypt
Encryption key
No
Direct encrypted input or Text value
The encryption key to use
Padding
N/A
None, PKCS7, Zeros, ANSIX923, ISO10126
PKCS7
The padding to use for the selected encryption algorithm
Key size
N/A
128 bits, 192 bits, 256 bits
256 bits
The size of the key in bits to use for the encryption
Use salt
N/A
Boolean value
False
Specifies whether to use salt for encryption. When this option is enabled, the randomly generated salt becomes an output in the form of a base64 string.
Use initialization vector
N/A
Boolean value
False
Specifies whether to use an initialization vector. When this option is enabled, the randomly generated initialization vector becomes an output in the form of a base64 string
Variables produced
Argument
Type
Description
EncryptedText
Text value
The text of the encrypted file for later processing
Salt
Text value
The randomly generated salt value for later processing
InitializationVector
Text value
The randomly generated initialization vector value for later processing
Exceptions
Exception
Description
File not found
Indicates that the file doesn't exist
Failed to encrypt the contents of the file
Indicates that an error occurred while encrypting the contents of the file
Decrypt to file with AES
Decrypt a string to a file with AES based on a specified key and an encoding format.
Argument
Optional
Accepts
Default Value
Description
Encoding
N/A
System default, ASCII, Unicode, Big-endian Unicode, UTF-8
Unicode
The encoding of the text to decrypt
Text to decrypt
No
Text value
The text to decrypt in the form of a base64 string
Decryption key
No
Direct encrypted input or Text value
The decryption key to use
Decrypt to file
No
File
The file to save the decrypted text into
If file exists
N/A
Overwrite, Don't decrypt to file, Add sequential suffix
Add sequential suffix
Specifies what to do in case the destination file already exists
Padding
N/A
None, PKCS7, Zeros, ANSIX923, ISO10126
PKCS7
The padding to use for the selected decryption algorithm
Key size
N/A
128 bits, 192 bits, 256 bits
256 bits
The size of the key in bits to use for decryption
Use salt
N/A
Boolean value
False
Specifies whether to use salt for decryption
Salt
No
Text value
The salt to use for decryption in the form of a base64 string
Use initialization vector
N/A
Boolean value
False
Specifies whether to use an initialization vector. Enter the initialization vector in the form of a base64 string
Initialization vector
No
Text value
The initialization vector to use for decryption
Variables produced
Argument
Type
Description
DecryptedFile
File
The decrypted file for later processing
Exceptions
Exception
Description
Failed to decrypt and store the contents to a file
Indicates that an error occurred while decrypting or storing the contents to the specified file
Hash text
Hash a string, using a specified algorithm and an encoding format.
Argument
Optional
Accepts
Default Value
Description
Hash algorithm
N/A
SHA256, SHA384, SHA512
SHA256
The algorithm to use for hashing
Encoding
N/A
System default, ASCII, Unicode, Big-endian Unicode, UTF-8
Unicode
The encoding of the text to hash
Text to hash
No
Text value
The text to hash
Variables produced
Argument
Type
Description
HashedText
Text value
The hashed text for later processing
Exceptions
Exception
Description
Failed to hash text
Indicates that an error occurred during hashing
Hash from file
Hash the contents of a file, using a specified algorithm and an encoding format.
Argument
Optional
Accepts
Default Value
Description
Hash algorithm
N/A
SHA256, SHA384, SHA512
SHA256
The algorithm to use for hashing
Encoding
N/A
System default, ASCII, Unicode, Big-endian Unicode, UTF-8
Unicode
The encoding of the file to hash
File to hash
No
File
The file to hash the contents of
Variables produced
Argument
Type
Description
HashedText
Text value
The hashed text for later processing
Exceptions
Exception
Description
File not found
Indicates that the file doesn't exist
Failed to hash the file
Indicates that an error occurred while hashing the contents of the file
Hash text with key
Hash a string with a key, using a specified algorithm and an encoding format.
Argument
Optional
Accepts
Default Value
Description
Hash algorithm
N/A
HMAC SHA256, HMAC SHA384, HMAC SHA512
HMAC SHA256
The algorithm to use for hashing
Encoding
N/A
System default, ASCII, Unicode, Big-endian Unicode, UTF-8
Unicode
The encoding of the text to hash
Text to hash
No
Text value
The text to hash
Hash key
No
Direct encrypted input or Text value
The key to hash the text with
Variables produced
Argument
Type
Description
HashedText
Text value
The hashed text for later processing
Exceptions
Exception
Description
Failed to hash text with key
Indicates that an error occurred during hashing with key
Hash from file with key
Hash the contents of a file with a key, using a specified algorithm and an encoding format.
Argument
Optional
Accepts
Default Value
Description
Hash algorithm
N/A
HMAC SHA256, HMAC SHA384, HMAC SHA512
HMAC SHA256
The algorithm to use for hashing
Encoding
N/A
System default, ASCII, Unicode, Big-endian Unicode, UTF-8
Unicode
The encoding of the file to hash
File to hash
No
File
The file to hash the contents of
Hash key
No
Direct encrypted input or Text value
The hash key to hash the text with
Variables produced
Argument
Type
Description
HashedText
Text value
The hashed text for later processing
Exceptions
Exception
Description
File not found
Indicates that the file doesn't exist
Failed to hash the file with key
Indicates that an error occurred while hashing the contents of the file with the specified key