Struct ring::aead::LessSafeKey

pub struct LessSafeKey { /* private fields */ }

Immutable keys for use in situations where OpeningKey/SealingKey and NonceSequence cannot reasonably be used.

Prefer to use OpeningKey/SealingKey and NonceSequence when practical.

Implementations

impl LessSafeKey

pub fn new(key: UnboundKey) -> Self

Constructs a LessSafeKey.

pub fn open_in_place_separate_tag<'in_out, A>( &self, nonce: Nonce, aad: Aad<A>, tag: Tag, in_out: &'in_out mut [u8], ciphertext: RangeFrom<usize> ) -> Result<&'in_out mut [u8], Unspecified>

where A: AsRef<[u8]>,

Like open_in_place, except the authentication tag is passed separately.

pub fn open_in_place<'in_out, A>( &self, nonce: Nonce, aad: Aad<A>, in_out: &'in_out mut [u8] ) -> Result<&'in_out mut [u8], Unspecified>

where A: AsRef<[u8]>,

Like super::OpeningKey::open_in_place(), except it accepts an arbitrary nonce.

nonce must be unique for every use of the key to open data.

pub fn open_within<'in_out, A>( &self, nonce: Nonce, aad: Aad<A>, in_out: &'in_out mut [u8], ciphertext_and_tag: RangeFrom<usize> ) -> Result<&'in_out mut [u8], Unspecified>

where A: AsRef<[u8]>,

Like super::OpeningKey::open_within(), except it accepts an arbitrary nonce.

nonce must be unique for every use of the key to open data.

pub fn seal_in_place_append_tag<A, InOut>( &self, nonce: Nonce, aad: Aad<A>, in_out: &mut InOut ) -> Result<(), Unspecified>

where A: AsRef<[u8]>, InOut: AsMut<[u8]> + for<'in_out> Extend<&'in_out u8>,

Like super::SealingKey::seal_in_place_append_tag(), except it accepts an arbitrary nonce.

nonce must be unique for every use of the key to seal data.

pub fn seal_in_place_separate_tag<A>( &self, nonce: Nonce, aad: Aad<A>, in_out: &mut [u8] ) -> Result<Tag, Unspecified>

where A: AsRef<[u8]>,

Like super::SealingKey::seal_in_place_separate_tag(), except it accepts an arbitrary nonce.

nonce must be unique for every use of the key to seal data.

pub fn algorithm(&self) -> &'static Algorithm

The key’s AEAD algorithm.

Trait Implementations

impl Clone for LessSafeKey

fn clone(&self) -> LessSafeKey

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for LessSafeKey

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

Formats the value using the given formatter.