Crypto.Cipher.AES

data types

data AES

AES Context (pre-processed key)

data AES128

Instances

Cipher AES128

BlockCipher AES128

data AES192

Instances

Cipher AES192

BlockCipher AES192

data AES256

Instances

Cipher AES256

BlockCipher AES256

creation

initAES :: Byteable b => b -> AES

initialize key

rounds need to be 10 12 14. any other values will cause undefined behavior

initKey :: Byteable b => b -> AES

Deprecated: use initAES

misc

genCTR

Arguments

:: Byteable iv

=> AES

Cipher Key.

-> iv

usually a 128 bit integer.

-> Int

length of bytes required.

-> ByteString

generate a counter mode pad. this is generally xor-ed to an input to make the standard counter mode block operations.

if the length requested is not a multiple of the block cipher size, more data will be returned, so that the returned bytestring is a multiple of the block cipher size.

encryption

encryptECB :: AES -> ByteString -> ByteString

encrypt using Electronic Code Book (ECB)

encryptCBC :: Byteable iv => AES -> iv -> ByteString -> ByteString

encrypt using Cipher Block Chaining (CBC)

encryptCTR :: Byteable iv => AES -> iv -> ByteString -> ByteString

encrypt using Counter mode (CTR)

in CTR mode encryption and decryption is the same operation.

encryptXTS :: Byteable iv => (AES, AES) -> iv -> Word32 -> ByteString -> ByteString

encrypt using XTS

the first key is the normal block encryption key the second key is used for the initial block tweak

encryptGCM

Arguments

:: Byteable iv

=> AES

Key

-> iv

initial vector

-> ByteString

data to authenticate (AAD)

-> ByteString

data to encrypt

-> (ByteString, AuthTag)

ciphertext and tag

encrypt using Galois counter mode (GCM) return the encrypted bytestring and the tag associated

note: encrypted data is identical to CTR mode in GCM, however a tag is also computed.

decryption

decryptECB :: AES -> ByteString -> ByteString

decrypt using Electronic Code Book (ECB)

decryptCBC :: Byteable iv => AES -> iv -> ByteString -> ByteString

decrypt using Cipher block chaining (CBC)

decryptCTR :: Byteable iv => AES -> iv -> ByteString -> ByteString

decrypt using Counter mode (CTR).

in CTR mode encryption and decryption is the same operation.

decryptXTS :: Byteable iv => (AES, AES) -> iv -> Word32 -> ByteString -> ByteString

decrypt using XTS

decryptGCM :: Byteable iv => AES -> iv -> ByteString -> ByteString -> (ByteString, AuthTag)

decrypt using Galois Counter Mode (GCM)