1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116
//! Pure Rust implementation of the [SHA-1][1] cryptographic hash algorithm
//! with optional hardware-specific optimizations.
//!
//! # 🚨 Warning: Cryptographically Broken! 🚨
//!
//! The SHA-1 hash function should be considered cryptographically broken and
//! unsuitable for further use in any security critical capacity, as it is
//! [practically vulnerable to chosen-prefix collisions][2].
//!
//! We provide this crate for legacy interoperability purposes only.
//!
//! # Usage
//!
//! ```rust
//! use hex_literal::hex;
//! use sha1::{Sha1, Digest};
//!
//! // create a Sha1 object
//! let mut hasher = Sha1::new();
//!
//! // process input message
//! hasher.update(b"hello world");
//!
//! // acquire hash digest in the form of GenericArray,
//! // which in this case is equivalent to [u8; 20]
//! let result = hasher.finalize();
//! assert_eq!(result[..], hex!("2aae6c35c94fcfb415dbe95f408b9ce91ee846ed"));
//! ```
//!
//! Also see [RustCrypto/hashes][3] readme.
//!
//! [1]: https://en.wikipedia.org/wiki/SHA-1
//! [2]: https://sha-mbles.github.io/
//! [3]: https://github.com/RustCrypto/hashes
#![no_std]
#![cfg_attr(docsrs, feature(doc_cfg))]
#![doc(
html_logo_url = "https://raw.githubusercontent.com/RustCrypto/meta/master/logo.svg",
html_favicon_url = "https://raw.githubusercontent.com/RustCrypto/meta/master/logo.svg"
)]
#![deny(unsafe_code)]
#![warn(missing_docs, rust_2018_idioms)]
#[cfg(feature = "std")]
extern crate std;
mod compress;
mod consts;
#[cfg(feature = "compress")]
pub use crate::compress::compress;
#[cfg(not(feature = "compress"))]
use crate::compress::compress;
use crate::consts::{H, STATE_LEN};
use block_buffer::BlockBuffer;
use digest::consts::{U20, U64};
pub use digest::{self, Digest};
use digest::{BlockInput, FixedOutputDirty, Reset, Update};
/// Structure representing the state of a SHA-1 computation
#[derive(Clone)]
pub struct Sha1 {
h: [u32; STATE_LEN],
len: u64,
buffer: BlockBuffer<U64>,
}
impl Default for Sha1 {
fn default() -> Self {
Sha1 {
h: H,
len: 0u64,
buffer: Default::default(),
}
}
}
impl BlockInput for Sha1 {
type BlockSize = U64;
}
impl Update for Sha1 {
fn update(&mut self, input: impl AsRef<[u8]>) {
let input = input.as_ref();
// Assumes that `length_bits<<3` will not overflow
self.len += input.len() as u64;
let state = &mut self.h;
self.buffer.input_blocks(input, |d| compress(state, d));
}
}
impl FixedOutputDirty for Sha1 {
type OutputSize = U20;
fn finalize_into_dirty(&mut self, out: &mut digest::Output<Self>) {
let s = &mut self.h;
let l = self.len << 3;
self.buffer
.len64_padding_be(l, |d| compress(s, core::slice::from_ref(d)));
for (chunk, v) in out.chunks_exact_mut(4).zip(self.h.iter()) {
chunk.copy_from_slice(&v.to_be_bytes());
}
}
}
impl Reset for Sha1 {
fn reset(&mut self) {
self.h = H;
self.len = 0;
self.buffer.reset();
}
}
opaque_debug::implement!(Sha1);
digest::impl_write!(Sha1);