tlspuffin/tls/rustls/
kx.rs1use crate::tls::rustls::error::Error;
2use crate::tls::rustls::msgs::enums::NamedGroup;
3
4pub struct KeyExchange {
7 pub skxg: &'static SupportedKxGroup,
8 pub privkey: ring::agreement::EphemeralPrivateKey,
9 pub pubkey: ring::agreement::PublicKey,
10}
11
12impl KeyExchange {
13 pub fn choose(
15 name: NamedGroup,
16 supported: &[&'static SupportedKxGroup],
17 ) -> Option<&'static SupportedKxGroup> {
18 supported.iter().find(|skxg| skxg.name == name).cloned()
19 }
20
21 pub fn start(skxg: &'static SupportedKxGroup) -> Option<Self> {
25 let rng = ring::rand::SystemRandom::new();
26 let ours =
27 ring::agreement::EphemeralPrivateKey::generate(skxg.agreement_algorithm, &rng).ok()?;
28
29 let pubkey = ours.compute_public_key().ok()?;
30
31 Some(Self {
32 skxg,
33 privkey: ours,
34 pubkey,
35 })
36 }
37
38 pub fn group(&self) -> NamedGroup {
40 self.skxg.name
41 }
42
43 pub fn complete<T>(
48 self,
49 peer: &[u8],
50 f: impl FnOnce(&[u8]) -> Result<T, ()>,
51 ) -> Result<T, Error> {
52 let peer_key = ring::agreement::UnparsedPublicKey::new(self.skxg.agreement_algorithm, peer);
53 ring::agreement::agree_ephemeral(self.privkey, &peer_key, (), f)
54 .map_err(|()| Error::PeerMisbehavedError("key agreement failed".to_string()))
55 }
56}
57
58#[derive(Debug)]
63pub struct SupportedKxGroup {
64 pub name: NamedGroup,
66
67 pub agreement_algorithm: &'static ring::agreement::Algorithm,
69}
70
71pub static X25519: SupportedKxGroup = SupportedKxGroup {
73 name: NamedGroup::X25519,
74 agreement_algorithm: &ring::agreement::X25519,
75};
76
77pub static SECP256R1: SupportedKxGroup = SupportedKxGroup {
79 name: NamedGroup::secp256r1,
80 agreement_algorithm: &ring::agreement::ECDH_P256,
81};
82
83pub static SECP384R1: SupportedKxGroup = SupportedKxGroup {
85 name: NamedGroup::secp384r1,
86 agreement_algorithm: &ring::agreement::ECDH_P384,
87};
88
89pub static ALL_KX_GROUPS: [&SupportedKxGroup; 3] = [&X25519, &SECP256R1, &SECP384R1];