Struct Attributes 

pub struct Attributes<H, R> { /* private fields */ }

Attributes represent a collection of attribute values and that can be hardened into a Keyspace.

Implementations

impl<H, R> Attributes<H, R>

where H: PasswordHasher<PasswordHash> + Sync, R: SeedableRng + Rng + Sync, R::Seed: AsMut<[u8]> + Default + Zeroize,

pub fn new(arr: Vec<Vec<u8>>, password_hasher: H) -> Result<Self, AttrkeyError>

Construct a new collection of Attributes.

Requires at least two attribute values, and a password hasher. Returns an error when fewer than two attributes are provided.

pub fn harden( &self, constraint: u8, context: Option<&[u8]>, ) -> Result<Keyspace<R>, AttrkeyError>

Harden the attributes into a cryptographic Keyspace.

Applies password hashing to harden all attributes in parallel with salts derived from each attribute and its position. All hardened attributes are used to produce a keyspace, from which attribute-based keys can be selected.

Returns a Keyspace of the hardened attributes on success, or an error if password hashing fails.

pub fn harden_with_salts( &self, salts: &[Vec<u8>], constraint: u8, context: Option<&[u8]>, ) -> Result<Keyspace<R>, AttrkeyError>

Harden the attributes into a cryptographic Keyspace.

Applies password hashing to harden all attributes in parallel with provided salts. All hardened attributes are used to produce a keyspace, from which attribute-based keys can be selected.

Returns a Keyspace of the hardened attributes on success, or an error if password hashing fails.

pub fn len(&self) -> usize

Return the number of attributes in this collection.

Trait Implementations

impl<H: Clone, R: Clone> Clone for Attributes<H, R>

fn clone(&self) -> Attributes<H, R>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<H, R> Drop for Attributes<H, R>

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl<H, R> Zeroize for Attributes<H, R>

fn zeroize(&mut self)

Zero out this object from memory using Rust intrinsics which ensure the zeroization operation is not “optimized away” by the compiler.