Struct password_hash::PasswordHash [−][src]
pub struct PasswordHash<'a> { pub algorithm: Ident<'a>, pub version: Option<Decimal>, pub params: ParamsString, pub salt: Option<Salt<'a>>, pub hash: Option<Output>, }
Password hash.
This type corresponds to the parsed representation of a PHC string as described in the PHC string format specification.
PHC strings have the following format:
$<id>[$v=<version>][$<param>=<value>(,<param>=<value>)*][$<salt>[$<hash>]]
where:
<id>
is the symbolic name for the function<version>
is the algorithm version<param>
is a parameter name<value>
is a parameter value<salt>
is an encoding of the salt<hash>
is an encoding of the hash output
The string is then the concatenation, in that order, of:
- a
$
sign; - the function symbolic name;
- optionally, a
$
sign followed by the algorithm version with av=version
format; - optionally, a
$
sign followed by one or several parameters, each with aname=value
format; the parameters are separated by commas; - optionally, a
$
sign followed by the (encoded) salt value; - optionally, a
$
sign followed by the (encoded) hash output (the hash output may be present only if the salt is present).
Fields
algorithm: Ident<'a>
Password hashing algorithm identifier.
This corresponds to the <id>
field in a PHC string, a.k.a. the
symbolic name for the function.
version: Option<Decimal>
Optional version field.
This corresponds to the <version>
field in a PHC string.
params: ParamsString
Algorithm-specific parameters.
This corresponds to the set of $<param>=<value>(,<param>=<value>)*
name/value pairs in a PHC string.
salt: Option<Salt<'a>>
Salt
string for personalizing a password hash output.
This corresponds to the <salt>
value in a PHC string.
hash: Option<Output>
Password hashing function Output
, a.k.a. hash/digest.
This corresponds to the <hash>
output in a PHC string.
Implementations
impl<'a> PasswordHash<'a>
[src]
impl<'a> PasswordHash<'a>
[src]pub fn new(s: &'a str) -> Result<Self>
[src]
Parse a password hash from a string in the PHC string format.
pub fn parse(s: &'a str, encoding: Encoding) -> Result<Self>
[src]
Parse a password hash from the given Encoding
.
pub fn generate(
phf: impl PasswordHasher,
password: impl AsRef<[u8]>,
salt: &'a str
) -> Result<Self>
[src]
phf: impl PasswordHasher,
password: impl AsRef<[u8]>,
salt: &'a str
) -> Result<Self>
Generate a password hash using the supplied algorithm.
pub fn verify_password(
&self,
phfs: &[&dyn PasswordVerifier],
password: impl AsRef<[u8]>
) -> Result<()>
[src]
&self,
phfs: &[&dyn PasswordVerifier],
password: impl AsRef<[u8]>
) -> Result<()>
Verify this password hash using the specified set of supported
PasswordHasher
trait objects.
pub fn encoding(&self) -> Encoding
[src]
Get the Encoding
that this PasswordHash
is serialized with.
Trait Implementations
impl<'a> Clone for PasswordHash<'a>
[src]
impl<'a> Clone for PasswordHash<'a>
[src]fn clone(&self) -> PasswordHash<'a>
[src]
pub fn clone_from(&mut self, source: &Self)
1.0.0[src]
impl<'a> Eq for PasswordHash<'a>
[src]
impl<'a> Eq for PasswordHash<'a>
[src]impl<'a> PartialEq<PasswordHash<'a>> for PasswordHash<'a>
[src]
impl<'a> PartialEq<PasswordHash<'a>> for PasswordHash<'a>
[src]fn eq(&self, other: &PasswordHash<'a>) -> bool
[src]
fn ne(&self, other: &PasswordHash<'a>) -> bool
[src]
impl<'a> StructuralEq for PasswordHash<'a>
[src]
impl<'a> StructuralEq for PasswordHash<'a>
[src]impl<'a> StructuralPartialEq for PasswordHash<'a>
[src]
impl<'a> StructuralPartialEq for PasswordHash<'a>
[src]Auto Trait Implementations
impl<'a> RefUnwindSafe for PasswordHash<'a>
impl<'a> RefUnwindSafe for PasswordHash<'a>
impl<'a> Send for PasswordHash<'a>
impl<'a> Send for PasswordHash<'a>
impl<'a> Sync for PasswordHash<'a>
impl<'a> Sync for PasswordHash<'a>
impl<'a> Unpin for PasswordHash<'a>
impl<'a> Unpin for PasswordHash<'a>
impl<'a> UnwindSafe for PasswordHash<'a>
impl<'a> UnwindSafe for PasswordHash<'a>