Skip to main content

​
SecurityLocalDecryptAES192GCM

Valid for: CANoe DE • CANoe4SW DE

​
Function Syntax

long SecurityLocalDecryptAES192GCM(byte key[], dword keyLength, byte iv[], dword ivLength, byte aad[], dword aadLength, byte cipheredData[], dword cipheredDataLength, byte tag[], dword tagLength, byte plainData[], dword plainDataLength)

​
Description

Decrypts ciphered data with a given key, initialization vector and additional authenticated data. The decryption is AES192 (GCM). Also verifies result with tag.

​
Parameters

  • byte key[]: The key to be used for AES (192 bit)
  • dword keyLength: 24 (bytes)
  • byte iv[]: The init vector
  • dword ivLength: The length of the init vector
  • byte aad[]: The additional authenticated data
  • dword aadLength: The length of the additional authenticated data
  • byte cipheredData[]: The ciphered data to decrypt
  • dword cipheredDataLength: The length of the ciphered data
  • byte tag[]: The verification tag for the ciphered text
  • dword tagLength: The length of the verification tag, must equal 16
  • byte plainData[] [out]: The buffer in which the plain data is stored
  • dword plainDataLength [in/out]: The length of the buffer. Typically, this buffer should have the same length as the ciphered data buffer

​
Return Values

  • 1: Success. A value of 1 means that the action was successful.
  • ≤ 0: Error. A value less than or equal to 0 means error.

​
Example

byte keyData[24] = {0xfe, 0xff, 0xe9, 0x92, 0x86, 0x65, 0x73, 0x1c, 0x6d, 0x6a, 0x8f, 0x94, 0x67, 0x30, 0x83, 0x08, 0xfe, 0xff, 0xe9, 0x92, 0x86, 0x65, 0x73, 0x1c};
dword keyLength = elcount(keyData);
byte iv[12] = {0xca, 0xfe, 0xba, 0xbe, 0xfa, 0xce, 0xdb, 0xad, 0xde, 0xca, 0xf8, 0x88};
dword ivLength = elcount(iv);
byte aad[20] = {0xfe, 0xed, 0xfa, 0xce, 0xde, 0xad, 0xbe, 0xef, 0xfe, 0xed, 0xfa, 0xce, 0xde, 0xad, 0xbe, 0xef, 0xab, 0xad, 0xda, 0xd2};
dword aadLength = elcount(aad);
byte cipheredText[60] = {0x39, 0x80, 0xca, 0x0b, 0x3c, 0x00, 0xe8, 0x41, 0xeb, 0x06, 0xfa, 0xc4, 0x87, 0x2a, 0x27, 0x57, 0x85, 0x9e, 0x1c, 0xea, 0xa6, 0xef, 0xd9, 0x84, 0x62, 0x85, 0x93, 0xb4, 0x0c, 0xa1,
0xe1, 0x9c, 0x7d, 0x77, 0x3d, 0x00, 0xc1, 0x44, 0xc5, 0x25, 0xac, 0x61, 0x9d, 0x18, 0xc8, 0x4a, 0x3f, 0x47, 0x18, 0xe2, 0x44, 0x8b, 0x2f, 0xe3, 0x24, 0xd9, 0xcc, 0xda, 0x27, 0x10};
dword cipheredTextLength = elcount(cipheredText);
byte tag[16] = {0x25, 0x19, 0x49, 0x8e, 0x80, 0xf1, 0x47, 0x8f, 0x37, 0xba, 0x55, 0xbd, 0x6d, 0x27, 0x61, 0x8c};
dword tagLength = elcount(tag);
byte plainText[100];
dword plainTextLength = elcount(plainText);
long result;
result =  SecurityLocalDecryptAES192GCM(keyData, keyLength, iv, ivLength, aad, aadLength, cipheredText, cipheredTextLength, tag, tagLength, plainText, plainTextLength);
SecurityLocalEncryptAES128GCM • SecurityLocalDecryptAES256GCM • SecurityLocalEncryptAES192GCM