Struct sha1collisiondetection::Sha1CD

pub struct Sha1CD(/* private fields */);

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 Clone for Sha1CD

fn clone(&self) -> Sha1CD

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Sha1CD

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

Formats the value using the given formatter.

impl Default for Sha1CD

fn default() -> Self

Returns the “default value” for a type.

impl FixedOutput for Sha1CD

fn finalize_into(self, out: &mut GenericArray<u8, U20>)

Consume value and write result into provided array.

fn finalize_fixed(self) -> GenericArray<u8, Self::OutputSize>

Retrieve result and consume the hasher instance.

impl OutputSizeUser for Sha1CD

type OutputSize = UInt<UInt<UInt<UInt<UInt<UTerm, B1>, B0>, B1>, B0>, B0>

Size of the output in bytes.

fn output_size() -> usize

Return output size in bytes.

impl Reset for Sha1CD

fn reset(&mut self)

Reset state to its initial value.

impl Update for Sha1CD

fn update(&mut self, input: &[u8])

Update state using the provided data.

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

where Self: Sized,

Digest input data in a chained manner.

impl Write for Sha1CD

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

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

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

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

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

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

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.

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

Attempts to write an entire buffer into this writer.

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.

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

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

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

where Self: Sized,

Creates a “by reference” adapter for this instance of Write.

impl HashMarker for Sha1CD