rustls 0.1.2

Rustls is a modern TLS library written in Rust.
Documentation 
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
117
118
119
120
121
122

use msgs::handshake::SessionID;
use msgs::enums::CipherSuite;
use msgs::codec::{Reader, Codec};
use msgs::handshake::CertificatePayload;
use msgs::base::PayloadU8;

/* These are the keys and values we store in session storage. */

/* --- Client types --- */
#[derive(Debug)]
pub struct ClientSessionKey {
  dns_name: PayloadU8
}

impl Codec for ClientSessionKey {
  fn encode(&self, bytes: &mut Vec<u8>) {
    bytes.extend_from_slice(b"session");
    self.dns_name.encode(bytes);
  }

  /* Don't need to read these. */
  fn read(_r: &mut Reader) -> Option<ClientSessionKey> {
    None
  }
}

impl ClientSessionKey {
  pub fn for_dns_name(dns_name: &str) -> ClientSessionKey {
    ClientSessionKey {
      dns_name: PayloadU8::new(dns_name.as_bytes().to_vec())
    }
  }

  pub fn get_encoding(&self) -> Vec<u8> {
    let mut buf = Vec::new();
    self.encode(&mut buf);
    buf
  }
}

#[derive(Debug)]
pub struct ClientSessionValue {
  pub cipher_suite: CipherSuite,
  pub session_id: SessionID,
  pub master_secret: PayloadU8
}

impl Codec for ClientSessionValue {
  fn encode(&self, bytes: &mut Vec<u8>) {
    self.cipher_suite.encode(bytes);
    self.session_id.encode(bytes);
    self.master_secret.encode(bytes);
  }

  fn read(r: &mut Reader) -> Option<ClientSessionValue> {
    let cs = try_ret!(CipherSuite::read(r));
    let sid = try_ret!(SessionID::read(r));
    let ms = try_ret!(PayloadU8::read(r));

    Some(ClientSessionValue {
      cipher_suite: cs,
      session_id: sid,
      master_secret: ms
    })
  }
}

impl ClientSessionValue {
  pub fn new(cs: &CipherSuite, sessid: &SessionID, ms: Vec<u8>) -> ClientSessionValue {
    ClientSessionValue {
      cipher_suite: *cs,
      session_id: sessid.clone(),
      master_secret: PayloadU8::new(ms)
    }
  }
}

/* --- Server types --- */
pub type ServerSessionKey = SessionID;

#[derive(Debug)]
pub struct ServerSessionValue {
  pub cipher_suite: CipherSuite,
  pub master_secret: PayloadU8,
  pub client_cert_chain: Option<CertificatePayload>
}

impl Codec for ServerSessionValue {
  fn encode(&self, bytes: &mut Vec<u8>) {
    self.cipher_suite.encode(bytes);
    self.master_secret.encode(bytes);
    if self.client_cert_chain.is_some() {
      self.client_cert_chain.as_ref().unwrap().encode(bytes);
    }
  }

  fn read(r: &mut Reader) -> Option<ServerSessionValue> {
    let cs = try_ret!(CipherSuite::read(r));
    let ms = try_ret!(PayloadU8::read(r));
    let ccert = if r.any_left() {
      CertificatePayload::read(r)
    } else {
      None
    };

    Some(ServerSessionValue {
      cipher_suite: cs,
      master_secret: ms,
      client_cert_chain: ccert
    })
  }
}

impl ServerSessionValue {
  pub fn new(cs: &CipherSuite, ms: Vec<u8>, cert_chain: &Option<CertificatePayload>) -> ServerSessionValue {
    ServerSessionValue {
      cipher_suite: cs.clone(),
      master_secret: PayloadU8::new(ms),
      client_cert_chain: cert_chain.clone()
    }
  }
}