Struct VerificationError 

#[non_exhaustive]
pub struct VerificationError;

Verification failed.

Returned when cryptographic verification fails (MAC tags, AEAD tags, signatures). Intentionally opaque to prevent timing side-channels.

Examples

use rscrypto::traits::{VerificationError, ct::constant_time_eq};

fn verify(computed: &[u8; 32], expected: &[u8; 32]) -> Result<(), VerificationError> {
  if constant_time_eq(computed, expected) {
    Ok(())
  } else {
    Err(VerificationError::new())
  }
}

let a = [0u8; 32];
let b = [1u8; 32];
assert!(verify(&a, &b).is_err());

Security

This error provides no details about the failure to prevent timing side-channels. Treat it as a generic authentication failure and avoid mapping it to finer-grained protocol responses that would recreate an oracle. The underlying verification should use constant-time comparison.

Implementations

impl VerificationError

pub const fn new() -> Self

Trait Implementations

impl Clone for VerificationError

fn clone(&self) -> VerificationError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VerificationError

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

Formats the value using the given formatter.

impl Default for VerificationError

fn default() -> Self

Returns the “default value” for a type.

impl Display for VerificationError

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

Formats the value using the given formatter.

impl Error for VerificationError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

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

Provides type-based access to context intended for error reports.

impl From<VerificationError> for OpenError

Available on crate features aes-gcm or aes-gcm-siv or chacha20poly1305 or xchacha20poly1305 or aegis256 or ascon-aead only.

fn from(value: VerificationError) -> Self

Converts to this type from the input type.

impl Hash for VerificationError

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for VerificationError

fn eq(&self, other: &VerificationError) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for VerificationError

impl Eq for VerificationError

impl StructuralPartialEq for VerificationError