Struct sha1collisiondetection::Sha1CD

pub struct Sha1CD(_);

Structure representing the state of a SHA-1 computation.

Implementations

impl Sha1CD

pub fn configure() -> Builder

Configures the algorithm.

pub fn update(&mut self, input: impl AsRef<[u8]>)

Digest input data.

This method can be called repeatedly, e.g. for processing streaming messages.

pub fn reset(&mut self)

Reset hasher instance to its initial state.

pub fn finalize_cd(self) -> Result<Output, Collision>

Retrieve result and consume hasher instance, reporting collisions.

pub fn finalize_reset_cd(&mut self) -> Result<Output, Collision>

Retrieve result and reset hasher instance, reporting collisions.

This method sometimes can be more efficient compared to hasher re-creation.

pub fn finalize_into_dirty_cd(
    &mut self,
    out: &mut Output
) -> Result<(), Collision>

Computes the digest and returns if a collision attack was detected.

In case of collisions, the digest will still be returned. Depending on whether or not the collision mitigation is enabled (see Builder::safe_hash), either an attacker controlled digest as produced by the SHA-1 function, or a digest computed by a modified SHA-1 function mitigating the attack.

By default, the mitigations are enabled, hence this is a safer variant of Sha1, which invalidates all signatures over any objects hashing to an attacker-controlled digest.

Trait Implementations

impl BlockInput for Sha1CD

type BlockSize = U64

Block size

impl Clone for Sha1CD

pub fn clone(&self) -> Sha1CD

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Sha1CD

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

Formats the value using the given formatter.

impl Default for Sha1CD

pub fn default() -> Self

Returns the "default value" for a type.

impl FixedOutputDirty for Sha1CD

type OutputSize = U20

Output size for fixed output digest

pub fn finalize_into_dirty(&mut self, out: &mut Output<Self>)

Retrieve result into provided buffer and leave hasher in a dirty state.

impl Reset for Sha1CD

pub fn reset(&mut self)

Reset hasher instance to its initial state and return current state.

impl Update for Sha1CD

pub fn update(&mut self, input: impl AsRef<[u8]>)

Digest input data.

pub fn chain(self, data: impl AsRef<[u8]>) -> Self

Digest input data in a chained manner.

impl Write for Sha1CD

pub fn write(&mut self, buf: &[u8]) -> Result<usize>

Write a buffer into this writer, returning how many bytes were written.

pub fn flush(&mut self) -> Result<()>

Flush this output stream, ensuring that all intermediately buffered contents reach their destination.

pub fn write_vectored(&mut self, bufs: &[IoSlice<'_>]) -> Result<usize, Error>

Like write, except that it writes from a slice of buffers.

pub fn is_write_vectored(&self) -> bool

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

Determines if this Writer has an efficient write_vectored implementation.

pub fn write_all(&mut self, buf: &[u8]) -> Result<(), Error>

Attempts to write an entire buffer into this writer.

pub fn write_all_vectored(
    &mut self,
    bufs: &mut [IoSlice<'_>]
) -> Result<(), Error>

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

Attempts to write multiple buffers into this writer.

pub fn write_fmt(&mut self, fmt: Arguments<'_>) -> Result<(), Error>

Writes a formatted string into this writer, returning any error encountered.

pub fn by_ref(&mut self) -> &mut Self

Creates a "by reference" adaptor for this instance of Write.