cryptography-core/dev.whyoleg.cryptography.operations/IvEncryptor

IvEncryptor

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

interface IvEncryptor : Encryptor(source)

Encrypts plaintext with an explicit initialization vector (IV). The WithIv methods return only the ciphertext without the IV. All WithIv methods are marked DelicateCryptographyApi because using a custom IV requires careful handling to avoid security issues such as IV reuse.

For the decryption counterpart, see IvDecryptor.

Inheritors

IvAuthenticatedEncryptor

IvCipher

Functions

encrypt

open suspend fun encrypt(plaintext: ByteArray): ByteArray

Encrypts the given plaintext and returns the resulting ciphertext as a ByteArray.

open suspend fun encrypt(plaintext: ByteString): ByteString

Encrypts the given plaintext and returns the resulting ciphertext as a ByteString.

encryptBlocking

abstract fun encryptBlocking(plaintext: ByteArray): ByteArray

Encrypts the given plaintext and returns the resulting ciphertext as a ByteArray.

open fun encryptBlocking(plaintext: ByteString): ByteString

Encrypts the given plaintext and returns the resulting ciphertext as a ByteString.

encryptingSink

abstract fun encryptingSink(ciphertext: RawSink): RawSink

Returns a RawSink that encrypts data as it is written, sending the resulting ciphertext to ciphertext. Write plaintext to the returned sink, and ciphertext will be forwarded to ciphertext.

encryptingSinkWithIv

@DelicateCryptographyApi

abstract fun encryptingSinkWithIv(iv: ByteArray, ciphertext: RawSink): RawSink

@DelicateCryptographyApi

open fun encryptingSinkWithIv(iv: ByteString, ciphertext: RawSink): RawSink

Returns a RawSink that encrypts data as it is written, sending the resulting ciphertext to ciphertext, using the specified iv.

encryptingSource

abstract fun encryptingSource(plaintext: RawSource): RawSource

Returns a RawSource that encrypts data as it is read from the given plaintext source. The resulting source produces ciphertext on reads.

encryptingSourceWithIv

@DelicateCryptographyApi

abstract fun encryptingSourceWithIv(iv: ByteArray, plaintext: RawSource): RawSource

@DelicateCryptographyApi

open fun encryptingSourceWithIv(iv: ByteString, plaintext: RawSource): RawSource

Returns a RawSource that encrypts data as it is read from the given plaintext source using the specified iv.

encryptWithIv

@DelicateCryptographyApi

open suspend fun encryptWithIv(iv: ByteArray, plaintext: ByteArray): ByteArray

Encrypts the given plaintext using the specified iv and returns the resulting ciphertext as a ByteArray.

@DelicateCryptographyApi

open suspend fun encryptWithIv(iv: ByteString, plaintext: ByteString): ByteString

Encrypts the given plaintext using the specified iv and returns the resulting ciphertext as a ByteString.

encryptWithIvBlocking

@DelicateCryptographyApi

abstract fun encryptWithIvBlocking(iv: ByteArray, plaintext: ByteArray): ByteArray

Encrypts the given plaintext using the specified iv and returns the resulting ciphertext as a ByteArray.

@DelicateCryptographyApi

open fun encryptWithIvBlocking(iv: ByteString, plaintext: ByteString): ByteString

Encrypts the given plaintext using the specified iv and returns the resulting ciphertext as a ByteString.