Struct PaddedBlockEncryptingKey 

pub struct PaddedBlockEncryptingKey {
    algorithm: &'static Algorithm,
    key: SymmetricCipherKey,
    mode: OperatingMode,
    padding: PaddingStrategy,
}

A cipher encryption key that performs block padding.

Fields

algorithm: &'static Algorithm

key: SymmetricCipherKey

mode: OperatingMode

padding: PaddingStrategy

Implementations

impl PaddedBlockEncryptingKey

pub fn cbc_pkcs7(key: UnboundCipherKey) -> Result<Self, Unspecified>

Constructs a new PaddedBlockEncryptingKey cipher with chaining block cipher (CBC) mode. Plaintext data is padded following the PKCS#7 scheme.

Errors

• Unspecified: Returned if there is an error constructing a PaddedBlockEncryptingKey. With legacy-des enabled, also returned if key was constructed with DES_FOR_LEGACY_USE_ONLY, DES_EDE_FOR_LEGACY_USE_ONLY or DES_EDE3_FOR_LEGACY_USE_ONLY and the provided key material contains weak or semi-weak DES subkeys, or (for Triple DES) a degenerate subkey configuration (e.g. K1 == K2 for 2TDEA, or any pairwise equality for 3TDEA).

pub fn ecb_pkcs7(key: UnboundCipherKey) -> Result<Self, Unspecified>

Constructs a new PaddedBlockEncryptingKey cipher with electronic code book (ECB) mode. Plaintext data is padded following the PKCS#7 scheme.

☠️ ️️️DANGER ☠️

Offered for computability purposes only. This is an extremely dangerous mode, and very likely not what you want to use.

Errors

• Unspecified: Returned if there is an error constructing a PaddedBlockEncryptingKey. With legacy-des enabled, also returned if key was constructed with DES_FOR_LEGACY_USE_ONLY, DES_EDE_FOR_LEGACY_USE_ONLY or DES_EDE3_FOR_LEGACY_USE_ONLY and the provided key material contains weak or semi-weak DES subkeys, or (for Triple DES) a degenerate subkey configuration (e.g. K1 == K2 for 2TDEA, or any pairwise equality for 3TDEA).

fn new( key: UnboundCipherKey, mode: OperatingMode, padding: PaddingStrategy, ) -> Result<PaddedBlockEncryptingKey, Unspecified>

pub fn algorithm(&self) -> &Algorithm

Returns the cipher algorithm.

pub fn mode(&self) -> OperatingMode

Returns the cipher operating mode.

pub fn encrypt<InOut>( &self, in_out: &mut InOut, ) -> Result<DecryptionContext, Unspecified>

where InOut: AsMut<[u8]> + for<'a> Extend<&'a u8>,

Pads and encrypts data provided in in_out in-place. Returns a references to the encrypted data.

Errors

• Unspecified: Returned if encryption fails.

pub fn less_safe_encrypt<InOut>( &self, in_out: &mut InOut, context: EncryptionContext, ) -> Result<DecryptionContext, Unspecified>

where InOut: AsMut<[u8]> + for<'a> Extend<&'a u8>,

Pads and encrypts data provided in in_out in-place. Returns a references to the encryted data.

Errors

• Unspecified: Returned if encryption fails.

Trait Implementations

impl Debug for PaddedBlockEncryptingKey

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.