cryptography-core/dev.whyoleg.cryptography.algorithms/AES/CBC

CBC

@SubclassOptInRequired(markerClass = [CryptographyProviderApi::class])

interface CBC : AES<AES.CBC.Key> (source)

AES in Cipher Block Chaining (CBC) mode as defined in NIST SP 800-38A.

Each plaintext block is XORed with the previous ciphertext block before encryption. Uses a 128-bit (16-byte) IV by default. Does not provide authentication — use GCM when integrity is required.

val key = provider.get(AES.CBC).keyGenerator().generateKey()
val ciphertext = key.cipher().encrypt(plaintext)

Types

Companion

object Companion : CryptographyAlgorithmId<AES.CBC>

Key

@SubclassOptInRequired(markerClass = [CryptographyProviderApi::class])

interface Key : AES.Key

An AES-CBC key that provides encryption and decryption via cipher.

Properties

open override val id: CryptographyAlgorithmId<AES.CBC>

The typed identifier that uniquely distinguishes this algorithm and is used to look it up from a CryptographyProvider.

Functions

keyDecoder

abstract fun keyDecoder(): Decoder<AES.Key.Format, AES.CBC.Key>

Returns a Decoder that decodes AES keys from the specified Key.Format.

keyGenerator

abstract fun keyGenerator(keySize: BinarySize = Key.Size.B256): KeyGenerator<AES.CBC.Key>

Returns a KeyGenerator that generates AES keys of the given keySize.