StartAESCipher()

Syntax

Result = StartAESCipher(#Cipher, *Key, Bits, *InitializationVector, Mode)

Initializes an AES cipher stream using the specified '*Key'. 'Bits' specifies the size of the key used by the ciphering. Valid values are 128, 192 and 256. The 'InitializationVector' is a random data block, used to initialize the ciphering to avoid breach in decoding (only needed when using the #PB_Cipher_CBC mode). Its size depends of the 'Bits' parameter: l6 bytes for 128 bit encryption, 24 bytes for 196 bit and 32 bytes for 256 bit. Once a cipher is finished, FinishCipher() has to be called.

The optional 'Mode' parameter can be a combination of the following value:

  #PB_Cipher_Decode: The stream is used to decode data.
  #PB_Cipher_Encode: The stream is used to encode data.

with

  #PB_Cipher_CBC: Default mode of encoding (Cipher Block Chaining). Needs an '*InitializationVector'.
                  Recommended as more secure than ECB mode.
  #PB_Cipher_ECB: Alternative mode (Electronic CodeBook). It doesn't uses random value nor chaining 
                  (each block is ciphered independently) making it less strong the CBC.

New buffers to be encoded or decoded can be added with AddCipherBuffer().

For more information about AES, see AESEncoder().

Supported OS

All