[−][src]Struct orion::auth::Tag
A type to represent the Tag
output by BLAKE2b-256 in keyed mode.
Errors:
An error will be returned if:
slice
is not 32 bytes.
Security:
-
Avoid using
unprotected_as_bytes()
whenever possible, as it breaks all protections that the type implements. -
The trait
PartialEq<&'_ [u8]>
is implemented for this type so that users are not tempted to callunprotected_as_bytes
to compare this sensitive value to a byte slice. The trait is implemented in such a way that the comparison happens in constant time. Thus, users should preferSecretType == &[u8]
overSecretType.unprotected_as_bytes() == &[u8]
. Examples are shown below. The examples apply to any type that implementsPartialEq<&'_ [u8]>
.
use orion::hazardous::mac::hmac::Tag; // Initialize an arbitrary, 64-byte tag. let tag = Tag::from_slice(&[1; 64])?; // Secure, constant-time comparison with a byte slice assert!(tag == &[1; 64][..]); // Secure, constant-time comparison with another Tag assert!(tag == Tag::from_slice(&[1; 64])?);
Methods
impl Tag
[src]
#[must_use = "SECURITY WARNING: Ignoring a Result can have real security implications."]
pub fn from_slice(slice: &[u8]) -> Result<Tag, UnknownCryptoError>
[src]
Construct from a given byte slice.
pub fn unprotected_as_bytes(&self) -> &[u8]
[src]
Return the object as byte slice. Warning: Should not be used unless strictly needed. This breaks protections that the type implements.
pub fn len(&self) -> usize
[src]
Return the length of the object.
Trait Implementations
impl Clone for Tag
[src]
impl Copy for Tag
[src]
impl Debug for Tag
[src]
impl Eq for Tag
[src]
impl From<[u8; 32]> for Tag
[src]
impl<'_> PartialEq<&'_ [u8]> for Tag
[src]
impl PartialEq<Tag> for Tag
[src]
Auto Trait Implementations
impl RefUnwindSafe for Tag
impl Send for Tag
impl Sync for Tag
impl Unpin for Tag
impl UnwindSafe for Tag
Blanket Implementations
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> From<T> for T
[src]
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T> ToOwned for T where
T: Clone,
[src]
T: Clone,
type Owned = T
The resulting type after obtaining ownership.
fn to_owned(&self) -> T
[src]
fn clone_into(&self, target: &mut T)
[src]
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,