CAPLfunctionSecurityLocalEncryptAES128GCM

SecurityLocalEncryptAES128GCM

Valid for: CANoe DE • CANoe4SW DE

Function Syntax

long SecurityLocalEncryptAES128GCM(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 AES128 (GCM). Also stores tag.

Parameters

• byte key[]: The key to be used for AES (16 bytes).
• dword keyLength: 16 (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

bbyte keyData[16] = {0xE3, 0xC0, 0x8A, 0x8F, 0x06, 0xC6, 0xE3, 0xAD, 0x95, 0xA7, 0x05, 0x57, 0xB2, 0x3F, 0x75, 0x48};
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 = SecurityLocalEncryptAES128GCM(keyData, elcount(keyData), initVector, elcount(initVector), aad, elcount(aad), plainText, plainLength, tag, tagLength, cipheredText, cipheredTextLength);

SecurityLocalDecryptAES128GCM • SecurityLocalEncryptAES256GCM