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

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

Reference Type: Supported, Category: Data Security, ICR#: 6189

Description

The $$AESDECR^XUSHSH 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

returns:

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

Example

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