Skip to main content

​
SecurityLocalEncryptAES256GCM

Valid for: CANoe DE • CANoe4SW DE

​
Function Syntax

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

​
Description

Encrypts data with a given key, initialization vector and additional authentication data. The encryption is AES256 (GCM). Also stores tag.

​
Parameters

  • byte key[]: The key to be used for AES (32 bytes).
  • dword keyLength: 32 (bytes)
  • byte iv[]: The init vector.
  • dword ivLength: The length of the init vector.
  • byte aad[]: The additional authentication data.
  • dword aadLength: The length of the additional authentication data.
  • byte plainData[]: The data to encrypt.
  • dword plainDataLength: The length of the data.
  • byte tag[][out]: The buffer where to store the verification tag for the ciphered text.
  • dword tagLength: 16 (bytes)
  • byte cipheredData[][out]: The buffer in which the ciphered data is stored.
  • dword cipheredDataLength [in/out]: The length of the buffer. Typically this buffer should have the same length as the data to encrypt.

​
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[32] = {0xE3, 0xC0, 0x8A, 0x8F, 0x06, 0xC6, 0xE3, 0xAD, 0x95, 0xA7, 0x05, 0x57, 0xB2, 0x3F, 0x75, 0x48, 0x3C, 0xE3, 0x30, 0x21, 0xA9, 0xC7, 0x2B, 0x70, 0x25, 0x66, 0x62, 0x04, 0xC6, 0x9C, 0x0B, 0x72};
byte initVector[12] = {0x12, 0x15, 0x35, 0x24, 0xC0, 0x89, 0x5E, 0x81, 0xB2, 0xC2, 0x84, 0x65};
byte aad[70] = {0xD6, 0x09, 0xB1, 0xF0, 0x56, 0x63, 0x7A, 0x0D, 0x46, 0xDF, 0x99, 0x8D, 0x88, 0xE5, 0x22, 0x2A, 0xB2, 0xC2, 0x84, 0x65, 0x12, 0x15, 0x35, 0x24, 0xC0, 0x89, 0x5E, 0x81, 0x08, 0x00, 0x0F, 0x10, 0x11, 0x12, 0x13, 0x14, 0x15, 0x16, 0x17, 0x18, 0x19, 0x1A, 0x1B, 0x1C, 0x1D, 0x1E, 0x1F, 0x20, 0x21, 0x22, 0x23, 0x24, 0x25, 0x26, 0x27, 0x28, 0x29, 0x2A, 0x2B, 0x2C, 0x2D, 0x2E, 0x2F, 0x30, 0x31, 0x32, 0x33, 0x34, 0x00, 0x01 };
byte plainText[32] = {0x08, 0x00, 0x0F, 0x10, 0x11, 0x12, 0x13, 0x14, 0x15, 0x16, 0x17, 0x18, 0x19, 0x1A, 0x1B, 0x1C, 0x1D, 0x1E, 0x1F, 0x20, 0x21, 0x22, 0x23, 0x24, 0x25, 0x26, 0x27, 0x28, 0x29, 0x2A, 0x2B, 0x2C};
dword plainLength = elcount(plainText);

byte cipheredText [48];

byte tag [16] = {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};

dword tagLength = elcount(tag);
dword cipheredTextLength = elcount(cipheredText);

long encryptResult;

encryptResult = SecurityLocalEncryptAES256GCM(keyData, elcount(keyData), initVector, elcount(initVector), aad, elcount(aad), plainText, plainLength, tag, tagLength, cipheredText, cipheredTextLength);
SecurityLocalDecryptAES256GCM • SecurityLocalEncryptAES128GCM