package ssh-agent

  1. Overview
  2. Docs

Source file serialize.ml

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
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
open Types

module Wire = struct
  let write_byte t byte =
    Faraday.write_uint8 t byte

  let write_boolean t b =
    Faraday.write_uint8 t (if b then 1 else 0)

  let write_uint32 t uint32 =
    Faraday.BE.write_uint32 t uint32

  let write_uint64 t uint64 =
    Faraday.BE.write_uint64 t uint64

  let write_string t s =
    Faraday.BE.write_uint32 t (String.length s |> Int32.of_int);
    Faraday.write_string t s

  let write_mpint t mpint =
    if mpint = Z.zero
    then write_uint32 t 0l
    else
      let mpint = Mirage_crypto_pk.Z_extra.to_cstruct_be mpint in
      let mpint_padded =
        if Cstruct.get_uint8 mpint 0 land 0x80 <> 0
        then Cstruct.append (Cstruct.of_string "\000") mpint
        else mpint in
      write_string t (Cstruct.to_string mpint_padded)

  let write_name_list t name_list =
    write_string t (String.concat "," name_list)
end

let with_faraday (f : Faraday.t -> unit) : string =
  let buf = Faraday.create 1024 in
  f buf;
  Faraday.serialize_to_string buf

let write_tuple t (name, data) =
  Wire.write_string t name;
  Wire.write_string t data

let write_tuples t tuples =
  List.iter (write_tuple t) tuples


let rec write_ssh_rsa_cert_tbs t
    { Pubkey.nonce; pubkey = { e; n }; serial; typ; key_id;
      valid_principals; valid_after; valid_before;
      critical_options; extensions; reserved; signature_key; }
  =
  Wire.write_string t "ssh-rsa-cert-v01@openssh.com";
  Wire.write_string t nonce;
  Wire.write_mpint t e;
  Wire.write_mpint t n;
  Wire.write_uint64 t serial;
  Wire.write_uint32 t (Protocol_number.ssh_cert_type_to_int typ);
  Wire.write_string t key_id;
  Wire.write_string t (with_faraday (fun t -> List.iter (Wire.write_string t) valid_principals));
  Wire.write_uint64 t valid_before;
  Wire.write_uint64 t valid_after;
  Wire.write_string t (with_faraday (fun t -> write_tuples t critical_options));
  Wire.write_string t (with_faraday (fun t -> write_tuples t extensions));
  Wire.write_string t reserved;
  Wire.write_string t (with_faraday (fun t -> write_pubkey t signature_key))

and write_pubkey t key =
  let open Pubkey in
  match key with
  | Ssh_dss { p; q; gg; y } ->
    Wire.write_string t "ssh-dss";
    Wire.write_mpint t p;
    Wire.write_mpint t q;
    Wire.write_mpint t gg;
    Wire.write_mpint t y
  | Ssh_rsa { e; n } ->
    Wire.write_string t "ssh-rsa";
    Wire.write_mpint t e;
    Wire.write_mpint t n
  | Ssh_rsa_cert { to_be_signed; signature; } ->
    write_ssh_rsa_cert_tbs t to_be_signed;
    Wire.write_string t signature
  | Blob { key_type; key_blob } ->
    Wire.write_string t key_type;
    Faraday.write_string t key_blob

let write_privkey t key =
  let open Privkey in
  match key with
  | Ssh_dss { p; q; gg; x; y } ->
    Wire.write_string t "ssh-dss";
    Wire.write_mpint t p;
    Wire.write_mpint t q;
    Wire.write_mpint t gg;
    Wire.write_mpint t y;
    Wire.write_mpint t x
  | Ssh_rsa { e; d; n; p; q; dp=_; dq=_; q' } ->
    (* iqmp (inverse of q modulo p) is q' *)
    Wire.write_string t "ssh-rsa";
    Wire.write_mpint t n;
    Wire.write_mpint t e;
    Wire.write_mpint t d;
    Wire.write_mpint t q';
    Wire.write_mpint t p;
    Wire.write_mpint t q
  | Ssh_rsa_cert ({ e=_; d; n=_; p; q; dp=_; dq=_; q' },
                  pubkey) ->
    Wire.write_string t "ssh-rsa-cert-v01@openssh.com";
    Wire.write_string t (with_faraday (fun t -> write_pubkey t (Pubkey.Ssh_rsa_cert pubkey)));
    Wire.write_mpint t d;
    Wire.write_mpint t q';
    Wire.write_mpint t p;
    Wire.write_mpint t q
  | Blob { key_type; key_blob } ->
    Wire.write_string t key_type;
    Faraday.write_string t key_blob

let write_protocol_number t ssh_agent =
  Wire.write_byte t (Protocol_number.ssh_agent_to_int ssh_agent)

let write_sign_flags t sign_flags =
  let flags = List.fold_left (fun acc sign_flag ->
      Protocol_number.sign_flag_to_int sign_flag lor acc)
      0 sign_flags in
  flags |> Int32.of_int |> Wire.write_uint32 t

let write_key_constraints t constraints =
  List.iter (function
      | Lifetime secs ->
        Faraday.write_uint8 t 1;
        Wire.write_uint32 t secs
      | Confirm ->
        Faraday.write_uint8 t 2)
    constraints

let write_ssh_agent_request t (type a) (req : a ssh_agent_request) =
  let message = with_faraday (fun t ->
      match req with
      | Ssh_agentc_request_identities ->
        write_protocol_number t SSH_AGENTC_REQUEST_IDENTITIES
      | Ssh_agentc_sign_request (pubkey, data, flags) ->
        write_protocol_number t SSH_AGENTC_SIGN_REQUEST;
        Wire.write_string t (with_faraday (fun t -> write_pubkey t pubkey));
        Wire.write_string t data;
        write_sign_flags t flags
      | Ssh_agentc_add_identity { privkey; key_comment } ->
        write_protocol_number t SSH_AGENTC_ADD_IDENTITY;
        write_privkey t privkey;
        Wire.write_string t key_comment
      | Ssh_agentc_remove_identity pubkey ->
        write_protocol_number t SSH_AGENTC_REMOVE_IDENTITY;
        Wire.write_string t (with_faraday (fun t -> write_pubkey t pubkey))
      | Ssh_agentc_remove_all_identities ->
        write_protocol_number t SSH_AGENTC_REMOVE_ALL_IDENTITIES
      | Ssh_agentc_add_smartcard_key { smartcard_id; smartcard_pin } ->
        write_protocol_number t SSH_AGENTC_ADD_SMARTCARD_KEY;
        Wire.write_string t smartcard_id;
        Wire.write_string t smartcard_pin
      | Ssh_agentc_remove_smartcard_key { smartcard_reader_id; smartcard_reader_pin } ->
        write_protocol_number t SSH_AGENTC_REMOVE_SMARTCARD_KEY;
        Wire.write_string t smartcard_reader_id;
        Wire.write_string t smartcard_reader_pin
      | Ssh_agentc_lock passphrase ->
        write_protocol_number t SSH_AGENTC_LOCK;
        Wire.write_string t passphrase
      | Ssh_agentc_unlock passphrase ->
        write_protocol_number t SSH_AGENTC_UNLOCK;
        Wire.write_string t passphrase
      | Ssh_agentc_add_id_constrained { privkey; key_comment; key_constraints } ->
        write_protocol_number t SSH_AGENTC_ADD_ID_CONSTRAINED;
        write_privkey t privkey;
        Wire.write_string t key_comment;
        write_key_constraints t key_constraints
      | Ssh_agentc_add_smartcard_key_constrained { smartcard_id; smartcard_pin;
                                                   smartcard_constraints } ->
        write_protocol_number t SSH_AGENTC_ADD_SMARTCARD_KEY_CONSTRAINED;
        Wire.write_string t smartcard_id;
        Wire.write_string t smartcard_pin;
        write_key_constraints t smartcard_constraints
      | Ssh_agentc_extension { extension_type; extension_contents } ->
        write_protocol_number t SSH_AGENTC_EXTENSION;
        Wire.write_string t extension_type;
        Faraday.write_string t extension_contents
    ) in
  Wire.write_uint32 t (Int32.of_int (String.length message));
  Faraday.write_string t message

let write_ssh_agent_response t (type a) (resp : a ssh_agent_response) =
  let message = with_faraday (fun t ->
      match resp with
      | Ssh_agent_failure ->
        write_protocol_number t SSH_AGENT_FAILURE
      | Ssh_agent_success ->
        write_protocol_number t SSH_AGENT_SUCCES
      | Ssh_agent_extension_failure ->
        write_protocol_number t SSH_AGENT_EXTENSION_FAILURE
      | Ssh_agent_extension_blob data ->
        Faraday.write_string t data
      | Ssh_agent_identities_answer ids ->
        write_protocol_number t SSH_AGENT_IDENTITIES_ANSWER;
        Wire.write_uint32 t (Int32.of_int (List.length ids));
        List.iter (fun { pubkey; comment } ->
            Wire.write_string t (with_faraday (fun t -> write_pubkey t pubkey));
            Wire.write_string t comment)
          ids
      | Ssh_agent_sign_response signature ->
        write_protocol_number t SSH_AGENT_SIGN_RESPONSE;
        Wire.write_string t signature)
  in
  Wire.write_uint32 t (Int32.of_int (String.length message));
  Faraday.write_string t message
OCaml

Innovation. Community. Security.