qualia_core_db/net/qdnf/crypto/
finished.rs1use 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
18pub 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
41pub 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}