Skip to main content

qualia_core_db/net/qdnf/crypto/
finished.rs

1//! Directional secret-derived Finished confirmation (E02.2).
2
3use crate::crypto::network::errors::CryptoError;
4use crate::crypto::network::kdf::{hmac_sha384, hmac_sha384_verify};
5use crate::crypto::network::types::AEAD_KEY_LEN;
6use crate::net::qdnf::types::StrongDigest;
7
8pub const ROLE_I2R: &[u8] = b"qpr-pq-1/finished/i2r";
9pub const ROLE_R2I: &[u8] = b"qpr-pq-1/finished/r2i";
10
11fn finished_data(transcript_digest: &StrongDigest, role: &[u8], out: &mut [u8; 80]) -> usize {
12    out[..48].copy_from_slice(&transcript_digest.0);
13    let n = role.len().min(32);
14    out[48..48 + n].copy_from_slice(&role[..n]);
15    48 + n
16}
17
18/// Finished MAC over the transcript.
19///
20/// Rejects all-zero secrets and unauthenticated zero transcript digests (`R03`).
21pub fn finished_mac(
22    secret: &[u8; AEAD_KEY_LEN],
23    transcript_digest: &StrongDigest,
24    initiator_to_responder: bool,
25) -> Result<StrongDigest, CryptoError> {
26    if secret == &[0u8; AEAD_KEY_LEN] || *transcript_digest == StrongDigest::ZERO {
27        return Err(CryptoError::CryptoFailure);
28    }
29    let role = if initiator_to_responder {
30        ROLE_I2R
31    } else {
32        ROLE_R2I
33    };
34    let mut data = [0u8; 80];
35    let len = finished_data(transcript_digest, role, &mut data);
36    let mut out = [0u8; 48];
37    hmac_sha384(secret, &data[..len], &mut out)?;
38    Ok(StrongDigest(out))
39}
40
41/// Verifies `finished`.
42pub fn verify_finished(
43    secret: &[u8; AEAD_KEY_LEN],
44    transcript_digest: &StrongDigest,
45    initiator_to_responder: bool,
46    tag: &StrongDigest,
47) -> Result<(), CryptoError> {
48    if secret == &[0u8; AEAD_KEY_LEN]
49        || *transcript_digest == StrongDigest::ZERO
50        || *tag == StrongDigest::ZERO
51    {
52        return Err(CryptoError::CryptoFailure);
53    }
54    let role = if initiator_to_responder {
55        ROLE_I2R
56    } else {
57        ROLE_R2I
58    };
59    let mut data = [0u8; 80];
60    let len = finished_data(transcript_digest, role, &mut data);
61    hmac_sha384_verify(secret, &data[..len], &tag.0)
62}
63
64#[cfg(test)]
65mod tests {
66    use super::*;
67
68    #[test]
69    fn wrong_secret_fails_confirmation() {
70        let digest = StrongDigest([7u8; 48]);
71        let secret_a = [1u8; AEAD_KEY_LEN];
72        let secret_b = [2u8; AEAD_KEY_LEN];
73        let tag = finished_mac(&secret_a, &digest, true).unwrap();
74        assert!(verify_finished(&secret_a, &digest, true, &tag).is_ok());
75        assert!(verify_finished(&secret_b, &digest, true, &tag).is_err());
76    }
77
78    #[test]
79    fn equal_transcripts_wrong_role_fail() {
80        let digest = StrongDigest([7u8; 48]);
81        let secret = [9u8; AEAD_KEY_LEN];
82        let tag = finished_mac(&secret, &digest, true).unwrap();
83        assert!(verify_finished(&secret, &digest, false, &tag).is_err());
84        let other = finished_mac(&secret, &digest, false).unwrap();
85        assert_ne!(tag, other);
86    }
87
88    #[test]
89    fn changed_transcript_fails() {
90        let secret = [9u8; AEAD_KEY_LEN];
91        let tag = finished_mac(&secret, &StrongDigest([1u8; 48]), true).unwrap();
92        assert!(verify_finished(&secret, &StrongDigest([2u8; 48]), true, &tag).is_err());
93    }
94
95    #[test]
96    fn r03_zero_secret_or_zero_transcript_digest_is_rejected() {
97        let digest = StrongDigest([7u8; 48]);
98        let zero_secret = [0u8; AEAD_KEY_LEN];
99        let valid_secret = [5u8; AEAD_KEY_LEN];
100        assert!(finished_mac(&zero_secret, &digest, true).is_err());
101        assert!(finished_mac(&valid_secret, &StrongDigest::ZERO, true).is_err());
102        let tag = finished_mac(&valid_secret, &digest, true).unwrap();
103        assert!(verify_finished(&zero_secret, &digest, true, &tag).is_err());
104        assert!(verify_finished(&valid_secret, &StrongDigest::ZERO, true, &tag).is_err());
105        assert!(verify_finished(&valid_secret, &digest, true, &StrongDigest::ZERO).is_err());
106    }
107}