//! Password related functions use super::*; use std::{ fmt, }; use pbkdf2::{ pbkdf2, }; use sha2::{ Sha256, }; use hex_literal::hex; use hmac::Hmac; use getrandom::getrandom; pub const SALTSIZE: usize = consts::PASSWORD_SALTSIZE; pub const KEYSIZE: usize = consts::PASSWORD_KEYSIZE; pub const ROUNDS: u32 = consts::PASSWORD_ROUNDS; /// Represents a password hash #[derive(Clone, Copy, PartialEq, Eq, Hash, Default)] #[repr(C, packed)] pub struct Password { derived: [u8; KEYSIZE], } /// Represents a salt to be used for password operations #[derive(Clone, PartialEq, Eq, Hash, Debug)] #[repr(C, packed)] pub struct Salt([u8; SALTSIZE]); impl Default for Salt { #[inline] fn default() -> Self { Self::embedded() } } /// The salt value used for `Salt::embedded()`. pub const STATIC_SALT: [u8; SALTSIZE] = hex!("d0a2404173bac722b29282652f2c457b573261e3c8701b908bb0bd3ada3d7f2d"); impl Salt { /// The default embedded static salt pub const fn embedded() -> Self { Self(STATIC_SALT) } /// Generate a random salt pub fn random() -> Result { let mut output = [0u8; SALTSIZE]; match getrandom(&mut output[..]) { Ok(_) => Ok(Self(output)), Err(_) => Err(Error::Random), } } /// Create a specific salt #[inline] pub const fn specific(from: [u8; SALTSIZE]) -> Self { Self(from) } /// Create a specific salt from a slice pub fn slice(from: T) -> Result where T: AsRef<[u8]> { let mut this = Self::none(); if bytes::copy_slice(&mut this.0[..], from.as_ref()) != this.0.len() { Err(Error::Length{expected: Some(this.0.len()), got: None}) } else { Ok(this) } } /// An empty salt #[inline] pub const fn none() -> Self { Self([0u8; SALTSIZE]) } } impl From<[u8; SALTSIZE]> for Salt { #[inline] fn from(from: [u8; SALTSIZE]) -> Self { Self::specific(from) } } impl From for [u8; SALTSIZE] { #[inline] fn from(from: Salt) -> Self { from.0 } } impl AsRef<[u8]> for Salt { fn as_ref(&self) -> &[u8] { &self.0[..] } } impl AsMut<[u8]> for Salt { fn as_mut(&mut self) -> &mut [u8] { &mut self.0[..] } } impl Password { /// Validate this password. pub fn validate(&self, string: impl AsRef, salt: &Salt) -> bool { &Self::derive(string, salt) == self } /// Derive a password hash from string and salt pub fn derive(string: impl AsRef, salt: &Salt) -> Password { let string = string.as_ref(); let mut derived = [0u8; KEYSIZE]; pbkdf2::>(string.as_bytes(), &salt.0[..], ROUNDS, &mut derived[..]); Self{derived} } } impl AsRef<[u8]> for Password { #[inline] fn as_ref(&self) -> &[u8] { &self.derived[..] } } impl AsMut<[u8]> for Password { #[inline] fn as_mut(&mut self) -> &mut [u8] { &mut self.derived[..] } } impl fmt::Display for Password { fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result { for x in self.derived.iter() { write!(f, "{:x}", x)?; } Ok(()) } } pub use crate::error::password::Error;