Kernel 8.0 APIs Banner [skip navigation]
Office of Information & Technology (OIT) Banner

$$AESDECR^XUSHSH: Returns Plaintext String Value for AES Encrypted Ciphertext Entry

Reference Type: Supported, Category: Data Security, Integration Agreement:6189

Description

This extrinsic function returns the string value of an Advanced Encryption Standard (AES) encrypted ciphertext entry. AES is a specification for the encryption of electronic data established by the U.S. National Institute of Standards and Technology (NIST) in 2001.

NOTE: This API was released with Kernel patch XU*8.0*655.

Format

$$AESDECR^XUSHSH(text,key[,iv])

Input Parameters

text (required) The ciphertext string to be decrypted.
key (required) The input key material 16, 24, or 32 characters long.
iv (optional) The initialization vector. If this argument is present, it must be 16 characters long.

Output Variables

Output Returns the plaintext value of the AES encrypted ciphertext entry in the text input parameter.

 

Example

>W $$AESDECR^XUSHSH($$B64DECD^XUSHSH("STbvalBtOxy754eRo15Bkg=="),"Encr4pt10nK3y")
This is a test.