CAPLfunctionSecurityLocalEncryptAES128CBC

SecurityLocalEncryptAES128CBC

Valid for: CANoe DE • CANoe4SW DE

Note
Replaces LocalSecurityEncryptAES128CBC.

Function Syntax

long SecurityLocalEncryptAES128CBC(byte key[], dword keyLength, byte data[], dword dataLength, byte initVector[], dword initVectorLength, byte cipheredData[], dword cipheredDataLength)

Description

Encrypts data with a given key and initialization vector using AES128 (CBC), Padding Mode PKCS5.

Parameters

• byte key[]: The key to be used for AES (128 bit).
• dword keyLength: 16 (bytes).
• byte data[]: The data to encrypt.
• dword dataLength: The length of the data to encrypt.
• byte initVector[]: The init vector to be used.
• dword initVectorLength: 16 (bytes).
• byte cipheredData [] [Out]: The buffer in which the ciphered data is stored.
• dword cipheredData Length [In/Out]: The length of the buffer. Typically this buffer has to be 16 bytes longer than the length of 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

Example

byte keyData[16] = {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};
dword keyLength = elcount(keyData);
byte data[16] = {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};
dword dataLength = elcount(data);
byte initVector[16] = {0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00};
dword initVectorLength = elcount(initVector);
byte cipheredOutput[32];
dword cipheredOutputLength = elcount(cipheredOutput);

long result;

result = SecurityLocalEncryptAES128CBC(keyData, keyLength, data, dataLength, initVector, initVectorLength, cipheredOutput, cipheredOutputLength);