1 /*
2 * TLS v1.0/v1.1/v1.2 client (RFC 2246, RFC 4346, RFC 5246)
3 * Copyright (c) 2006-2019, Jouni Malinen <j@w1.fi>
4 *
5 * This software may be distributed under the terms of the BSD license.
6 * See README for more details.
7 */
8
9 #include "includes.h"
10
11 #include "common.h"
12 #include "crypto/sha1.h"
13 #include "crypto/tls.h"
14 #include "x509v3.h"
15 #include "tlsv1_common.h"
16 #include "tlsv1_record.h"
17 #include "tlsv1_client.h"
18 #include "tlsv1_client_i.h"
19
20 /* TODO:
21 * Support for a message fragmented across several records (RFC 2246, 6.2.1)
22 */
23
24
tls_alert(struct tlsv1_client * conn,u8 level,u8 description)25 void tls_alert(struct tlsv1_client *conn, u8 level, u8 description)
26 {
27 conn->alert_level = level;
28 conn->alert_description = description;
29 }
30
31
tlsv1_client_free_dh(struct tlsv1_client * conn)32 void tlsv1_client_free_dh(struct tlsv1_client *conn)
33 {
34 os_free(conn->dh_p);
35 os_free(conn->dh_g);
36 os_free(conn->dh_ys);
37 conn->dh_p = conn->dh_g = conn->dh_ys = NULL;
38 }
39
40
tls_client_highest_ver(struct tlsv1_client * conn)41 u16 tls_client_highest_ver(struct tlsv1_client *conn)
42 {
43 u16 tls_version = TLS_VERSION;
44
45 /* Pick the highest locally enabled TLS version */
46 #ifdef CONFIG_TLSV12
47 if ((conn->flags & TLS_CONN_DISABLE_TLSv1_2) &&
48 tls_version == TLS_VERSION_1_2)
49 tls_version = TLS_VERSION_1_1;
50 #endif /* CONFIG_TLSV12 */
51 #ifdef CONFIG_TLSV11
52 if ((conn->flags & TLS_CONN_DISABLE_TLSv1_1) &&
53 tls_version == TLS_VERSION_1_1)
54 tls_version = TLS_VERSION_1;
55 #endif /* CONFIG_TLSV11 */
56 if ((conn->flags & TLS_CONN_DISABLE_TLSv1_0) &&
57 tls_version == TLS_VERSION_1)
58 return 0;
59
60 return tls_version;
61 }
62
63
tls_derive_pre_master_secret(struct tlsv1_client * conn,u8 * pre_master_secret)64 int tls_derive_pre_master_secret(struct tlsv1_client *conn,
65 u8 *pre_master_secret)
66 {
67 WPA_PUT_BE16(pre_master_secret, tls_client_highest_ver(conn));
68 if (os_get_random(pre_master_secret + 2,
69 TLS_PRE_MASTER_SECRET_LEN - 2))
70 return -1;
71 return 0;
72 }
73
74
tls_derive_keys(struct tlsv1_client * conn,const u8 * pre_master_secret,size_t pre_master_secret_len)75 int tls_derive_keys(struct tlsv1_client *conn,
76 const u8 *pre_master_secret, size_t pre_master_secret_len)
77 {
78 u8 seed[2 * TLS_RANDOM_LEN];
79 u8 key_block[TLS_MAX_KEY_BLOCK_LEN];
80 u8 *pos;
81 size_t key_block_len;
82
83 if (pre_master_secret) {
84 wpa_hexdump_key(MSG_MSGDUMP, "TLSv1: pre_master_secret",
85 pre_master_secret, pre_master_secret_len);
86 os_memcpy(seed, conn->client_random, TLS_RANDOM_LEN);
87 os_memcpy(seed + TLS_RANDOM_LEN, conn->server_random,
88 TLS_RANDOM_LEN);
89 if (tls_prf(conn->rl.tls_version,
90 pre_master_secret, pre_master_secret_len,
91 "master secret", seed, 2 * TLS_RANDOM_LEN,
92 conn->master_secret, TLS_MASTER_SECRET_LEN)) {
93 wpa_printf(MSG_DEBUG, "TLSv1: Failed to derive "
94 "master_secret");
95 return -1;
96 }
97 wpa_hexdump_key(MSG_MSGDUMP, "TLSv1: master_secret",
98 conn->master_secret, TLS_MASTER_SECRET_LEN);
99 }
100
101 os_memcpy(seed, conn->server_random, TLS_RANDOM_LEN);
102 os_memcpy(seed + TLS_RANDOM_LEN, conn->client_random, TLS_RANDOM_LEN);
103 key_block_len = 2 * (conn->rl.hash_size + conn->rl.key_material_len);
104 if (conn->rl.tls_version == TLS_VERSION_1)
105 key_block_len += 2 * conn->rl.iv_size;
106 if (tls_prf(conn->rl.tls_version,
107 conn->master_secret, TLS_MASTER_SECRET_LEN,
108 "key expansion", seed, 2 * TLS_RANDOM_LEN,
109 key_block, key_block_len)) {
110 wpa_printf(MSG_DEBUG, "TLSv1: Failed to derive key_block");
111 return -1;
112 }
113 wpa_hexdump_key(MSG_MSGDUMP, "TLSv1: key_block",
114 key_block, key_block_len);
115
116 pos = key_block;
117
118 /* client_write_MAC_secret */
119 os_memcpy(conn->rl.write_mac_secret, pos, conn->rl.hash_size);
120 pos += conn->rl.hash_size;
121 /* server_write_MAC_secret */
122 os_memcpy(conn->rl.read_mac_secret, pos, conn->rl.hash_size);
123 pos += conn->rl.hash_size;
124
125 /* client_write_key */
126 os_memcpy(conn->rl.write_key, pos, conn->rl.key_material_len);
127 pos += conn->rl.key_material_len;
128 /* server_write_key */
129 os_memcpy(conn->rl.read_key, pos, conn->rl.key_material_len);
130 pos += conn->rl.key_material_len;
131
132 if (conn->rl.tls_version == TLS_VERSION_1) {
133 /* client_write_IV */
134 os_memcpy(conn->rl.write_iv, pos, conn->rl.iv_size);
135 pos += conn->rl.iv_size;
136 /* server_write_IV */
137 os_memcpy(conn->rl.read_iv, pos, conn->rl.iv_size);
138 } else {
139 /*
140 * Use IV field to set the mask value for TLS v1.1. A fixed
141 * mask of zero is used per the RFC 4346, 6.2.3.2 CBC Block
142 * Cipher option 2a.
143 */
144 os_memset(conn->rl.write_iv, 0, conn->rl.iv_size);
145 }
146
147 return 0;
148 }
149
150
151 /**
152 * tlsv1_client_handshake - Process TLS handshake
153 * @conn: TLSv1 client connection data from tlsv1_client_init()
154 * @in_data: Input data from TLS peer
155 * @in_len: Input data length
156 * @out_len: Length of the output buffer.
157 * @appl_data: Pointer to application data pointer, or %NULL if dropped
158 * @appl_data_len: Pointer to variable that is set to appl_data length
159 * @need_more_data: Set to 1 if more data would be needed to complete
160 * processing
161 * Returns: Pointer to output data, %NULL on failure
162 */
tlsv1_client_handshake(struct tlsv1_client * conn,const u8 * in_data,size_t in_len,size_t * out_len,u8 ** appl_data,size_t * appl_data_len,int * need_more_data)163 u8 * tlsv1_client_handshake(struct tlsv1_client *conn,
164 const u8 *in_data, size_t in_len,
165 size_t *out_len, u8 **appl_data,
166 size_t *appl_data_len, int *need_more_data)
167 {
168 const u8 *pos, *end;
169 u8 *msg = NULL, *in_msg = NULL, *in_pos, *in_end, alert, ct;
170 size_t in_msg_len;
171 int no_appl_data;
172 int used;
173
174 if (need_more_data)
175 *need_more_data = 0;
176
177 if (conn->state == CLIENT_HELLO) {
178 if (in_len)
179 return NULL;
180 return tls_send_client_hello(conn, out_len);
181 }
182
183 if (conn->partial_input) {
184 if (wpabuf_resize(&conn->partial_input, in_len) < 0) {
185 wpa_printf(MSG_DEBUG, "TLSv1: Failed to allocate "
186 "memory for pending record");
187 tls_alert(conn, TLS_ALERT_LEVEL_FATAL,
188 TLS_ALERT_INTERNAL_ERROR);
189 goto failed;
190 }
191 wpabuf_put_data(conn->partial_input, in_data, in_len);
192 in_data = wpabuf_head(conn->partial_input);
193 in_len = wpabuf_len(conn->partial_input);
194 }
195
196 if (in_data == NULL || in_len == 0)
197 return NULL;
198
199 pos = in_data;
200 end = in_data + in_len;
201 in_msg = os_malloc(in_len);
202 if (in_msg == NULL)
203 return NULL;
204
205 /* Each received packet may include multiple records */
206 while (pos < end) {
207 in_msg_len = in_len;
208 used = tlsv1_record_receive(&conn->rl, pos, end - pos,
209 in_msg, &in_msg_len, &alert);
210 if (used < 0) {
211 wpa_printf(MSG_DEBUG, "TLSv1: Processing received "
212 "record failed");
213 tls_alert(conn, TLS_ALERT_LEVEL_FATAL, alert);
214 goto failed;
215 }
216 if (used == 0) {
217 struct wpabuf *partial;
218 wpa_printf(MSG_DEBUG, "TLSv1: Need more data");
219 partial = wpabuf_alloc_copy(pos, end - pos);
220 wpabuf_free(conn->partial_input);
221 conn->partial_input = partial;
222 if (conn->partial_input == NULL) {
223 wpa_printf(MSG_DEBUG, "TLSv1: Failed to "
224 "allocate memory for pending "
225 "record");
226 tls_alert(conn, TLS_ALERT_LEVEL_FATAL,
227 TLS_ALERT_INTERNAL_ERROR);
228 goto failed;
229 }
230 os_free(in_msg);
231 if (need_more_data)
232 *need_more_data = 1;
233 return NULL;
234 }
235 ct = pos[0];
236
237 in_pos = in_msg;
238 in_end = in_msg + in_msg_len;
239
240 /* Each received record may include multiple messages of the
241 * same ContentType. */
242 while (in_pos < in_end) {
243 in_msg_len = in_end - in_pos;
244 if (tlsv1_client_process_handshake(conn, ct, in_pos,
245 &in_msg_len,
246 appl_data,
247 appl_data_len) < 0)
248 goto failed;
249 in_pos += in_msg_len;
250 }
251
252 pos += used;
253 }
254
255 os_free(in_msg);
256 in_msg = NULL;
257
258 no_appl_data = appl_data == NULL || *appl_data == NULL;
259 msg = tlsv1_client_handshake_write(conn, out_len, no_appl_data);
260
261 failed:
262 os_free(in_msg);
263 if (conn->alert_level) {
264 wpabuf_free(conn->partial_input);
265 conn->partial_input = NULL;
266 conn->state = FAILED;
267 os_free(msg);
268 msg = tlsv1_client_send_alert(conn, conn->alert_level,
269 conn->alert_description,
270 out_len);
271 } else if (msg == NULL) {
272 msg = os_zalloc(1);
273 *out_len = 0;
274 }
275
276 if (need_more_data == NULL || !(*need_more_data)) {
277 wpabuf_free(conn->partial_input);
278 conn->partial_input = NULL;
279 }
280
281 return msg;
282 }
283
284
285 /**
286 * tlsv1_client_encrypt - Encrypt data into TLS tunnel
287 * @conn: TLSv1 client connection data from tlsv1_client_init()
288 * @in_data: Pointer to plaintext data to be encrypted
289 * @in_len: Input buffer length
290 * @out_data: Pointer to output buffer (encrypted TLS data)
291 * @out_len: Maximum out_data length
292 * Returns: Number of bytes written to out_data, -1 on failure
293 *
294 * This function is used after TLS handshake has been completed successfully to
295 * send data in the encrypted tunnel.
296 */
tlsv1_client_encrypt(struct tlsv1_client * conn,const u8 * in_data,size_t in_len,u8 * out_data,size_t out_len)297 int tlsv1_client_encrypt(struct tlsv1_client *conn,
298 const u8 *in_data, size_t in_len,
299 u8 *out_data, size_t out_len)
300 {
301 size_t rlen;
302
303 wpa_hexdump_key(MSG_MSGDUMP, "TLSv1: Plaintext AppData",
304 in_data, in_len);
305
306 if (tlsv1_record_send(&conn->rl, TLS_CONTENT_TYPE_APPLICATION_DATA,
307 out_data, out_len, in_data, in_len, &rlen) < 0) {
308 wpa_printf(MSG_DEBUG, "TLSv1: Failed to create a record");
309 tls_alert(conn, TLS_ALERT_LEVEL_FATAL,
310 TLS_ALERT_INTERNAL_ERROR);
311 return -1;
312 }
313
314 return rlen;
315 }
316
317
318 /**
319 * tlsv1_client_decrypt - Decrypt data from TLS tunnel
320 * @conn: TLSv1 client connection data from tlsv1_client_init()
321 * @in_data: Pointer to input buffer (encrypted TLS data)
322 * @in_len: Input buffer length
323 * @need_more_data: Set to 1 if more data would be needed to complete
324 * processing
325 * Returns: Decrypted data or %NULL on failure
326 *
327 * This function is used after TLS handshake has been completed successfully to
328 * receive data from the encrypted tunnel.
329 */
tlsv1_client_decrypt(struct tlsv1_client * conn,const u8 * in_data,size_t in_len,int * need_more_data)330 struct wpabuf * tlsv1_client_decrypt(struct tlsv1_client *conn,
331 const u8 *in_data, size_t in_len,
332 int *need_more_data)
333 {
334 const u8 *in_end, *pos;
335 int used;
336 u8 alert, *out_pos, ct;
337 size_t olen;
338 struct wpabuf *buf = NULL;
339
340 if (need_more_data)
341 *need_more_data = 0;
342
343 if (conn->partial_input) {
344 if (wpabuf_resize(&conn->partial_input, in_len) < 0) {
345 wpa_printf(MSG_DEBUG, "TLSv1: Failed to allocate "
346 "memory for pending record");
347 alert = TLS_ALERT_INTERNAL_ERROR;
348 goto fail;
349 }
350 wpabuf_put_data(conn->partial_input, in_data, in_len);
351 in_data = wpabuf_head(conn->partial_input);
352 in_len = wpabuf_len(conn->partial_input);
353 }
354
355 pos = in_data;
356 in_end = in_data + in_len;
357
358 while (pos < in_end) {
359 ct = pos[0];
360 if (wpabuf_resize(&buf, in_end - pos) < 0) {
361 alert = TLS_ALERT_INTERNAL_ERROR;
362 goto fail;
363 }
364 out_pos = wpabuf_put(buf, 0);
365 olen = wpabuf_tailroom(buf);
366 used = tlsv1_record_receive(&conn->rl, pos, in_end - pos,
367 out_pos, &olen, &alert);
368 if (used < 0) {
369 wpa_printf(MSG_DEBUG, "TLSv1: Record layer processing "
370 "failed");
371 goto fail;
372 }
373 if (used == 0) {
374 struct wpabuf *partial;
375 wpa_printf(MSG_DEBUG, "TLSv1: Need more data");
376 partial = wpabuf_alloc_copy(pos, in_end - pos);
377 wpabuf_free(conn->partial_input);
378 conn->partial_input = partial;
379 if (conn->partial_input == NULL) {
380 wpa_printf(MSG_DEBUG, "TLSv1: Failed to "
381 "allocate memory for pending "
382 "record");
383 alert = TLS_ALERT_INTERNAL_ERROR;
384 goto fail;
385 }
386 if (need_more_data)
387 *need_more_data = 1;
388 return buf;
389 }
390
391 if (ct == TLS_CONTENT_TYPE_ALERT) {
392 if (olen < 2) {
393 wpa_printf(MSG_DEBUG, "TLSv1: Alert "
394 "underflow");
395 alert = TLS_ALERT_DECODE_ERROR;
396 goto fail;
397 }
398 wpa_printf(MSG_DEBUG, "TLSv1: Received alert %d:%d",
399 out_pos[0], out_pos[1]);
400 if (out_pos[0] == TLS_ALERT_LEVEL_WARNING) {
401 /* Continue processing */
402 pos += used;
403 continue;
404 }
405
406 alert = out_pos[1];
407 goto fail;
408 }
409
410 if (ct != TLS_CONTENT_TYPE_APPLICATION_DATA) {
411 wpa_printf(MSG_DEBUG, "TLSv1: Unexpected content type "
412 "0x%x when decrypting application data",
413 pos[0]);
414 alert = TLS_ALERT_UNEXPECTED_MESSAGE;
415 goto fail;
416 }
417
418 wpabuf_put(buf, olen);
419
420 pos += used;
421 }
422
423 wpabuf_free(conn->partial_input);
424 conn->partial_input = NULL;
425 return buf;
426
427 fail:
428 wpabuf_free(buf);
429 wpabuf_free(conn->partial_input);
430 conn->partial_input = NULL;
431 tls_alert(conn, TLS_ALERT_LEVEL_FATAL, alert);
432 return NULL;
433 }
434
435
436 /**
437 * tlsv1_client_global_init - Initialize TLSv1 client
438 * Returns: 0 on success, -1 on failure
439 *
440 * This function must be called before using any other TLSv1 client functions.
441 */
tlsv1_client_global_init(void)442 int tlsv1_client_global_init(void)
443 {
444 return crypto_global_init();
445 }
446
447
448 /**
449 * tlsv1_client_global_deinit - Deinitialize TLSv1 client
450 *
451 * This function can be used to deinitialize the TLSv1 client that was
452 * initialized by calling tlsv1_client_global_init(). No TLSv1 client functions
453 * can be called after this before calling tlsv1_client_global_init() again.
454 */
tlsv1_client_global_deinit(void)455 void tlsv1_client_global_deinit(void)
456 {
457 crypto_global_deinit();
458 }
459
460
461 /**
462 * tlsv1_client_init - Initialize TLSv1 client connection
463 * Returns: Pointer to TLSv1 client connection data or %NULL on failure
464 */
tlsv1_client_init(void)465 struct tlsv1_client * tlsv1_client_init(void)
466 {
467 struct tlsv1_client *conn;
468 size_t count;
469 u16 *suites;
470
471 conn = os_zalloc(sizeof(*conn));
472 if (conn == NULL)
473 return NULL;
474
475 conn->state = CLIENT_HELLO;
476
477 if (tls_verify_hash_init(&conn->verify) < 0) {
478 wpa_printf(MSG_DEBUG, "TLSv1: Failed to initialize verify "
479 "hash");
480 os_free(conn);
481 return NULL;
482 }
483
484 count = 0;
485 suites = conn->cipher_suites;
486 #ifdef CONFIG_CRYPTO_MBEDTLS
487 suites[count++] = TLS_DHE_RSA_WITH_AES_256_CBC_SHA256;
488 #endif
489 suites[count++] = TLS_RSA_WITH_AES_256_CBC_SHA256;
490 #ifdef CONFIG_CRYPTO_MBEDTLS
491 suites[count++] = TLS_DHE_RSA_WITH_AES_256_CBC_SHA;
492 #endif
493 suites[count++] = TLS_RSA_WITH_AES_256_CBC_SHA;
494 #ifdef CONFIG_CRYPTO_MBEDTLS
495 suites[count++] = TLS_DHE_RSA_WITH_AES_128_CBC_SHA256;
496 #endif
497 suites[count++] = TLS_RSA_WITH_AES_128_CBC_SHA256;
498 #ifdef CONFIG_CRYPTO_MBEDTLS
499 suites[count++] = TLS_DHE_RSA_WITH_AES_128_CBC_SHA;
500 #endif
501 suites[count++] = TLS_RSA_WITH_AES_128_CBC_SHA;
502 #ifdef CONFIG_CRYPTO_MBEDTLS
503 suites[count++] = TLS_DHE_RSA_WITH_3DES_EDE_CBC_SHA;
504 #endif
505 suites[count++] = TLS_RSA_WITH_3DES_EDE_CBC_SHA;
506 suites[count++] = TLS_RSA_WITH_RC4_128_SHA;
507 suites[count++] = TLS_RSA_WITH_RC4_128_MD5;
508 conn->num_cipher_suites = count;
509
510 conn->rl.tls_version = TLS_VERSION;
511
512 return conn;
513 }
514
515
516 /**
517 * tlsv1_client_deinit - Deinitialize TLSv1 client connection
518 * @conn: TLSv1 client connection data from tlsv1_client_init()
519 */
tlsv1_client_deinit(struct tlsv1_client * conn)520 void tlsv1_client_deinit(struct tlsv1_client *conn)
521 {
522 crypto_public_key_free(conn->server_rsa_key);
523 tlsv1_record_set_cipher_suite(&conn->rl, TLS_NULL_WITH_NULL_NULL);
524 tlsv1_record_change_write_cipher(&conn->rl);
525 tlsv1_record_change_read_cipher(&conn->rl);
526 tls_verify_hash_free(&conn->verify);
527 os_free(conn->client_hello_ext);
528 tlsv1_client_free_dh(conn);
529 tlsv1_cred_free(conn->cred);
530 wpabuf_free(conn->partial_input);
531 x509_certificate_chain_free(conn->server_cert);
532 os_free(conn);
533 }
534
535
536 /**
537 * tlsv1_client_established - Check whether connection has been established
538 * @conn: TLSv1 client connection data from tlsv1_client_init()
539 * Returns: 1 if connection is established, 0 if not
540 */
tlsv1_client_established(struct tlsv1_client * conn)541 int tlsv1_client_established(struct tlsv1_client *conn)
542 {
543 return conn->state == ESTABLISHED;
544 }
545
546
547 /**
548 * tlsv1_client_prf - Use TLS-PRF to derive keying material
549 * @conn: TLSv1 client connection data from tlsv1_client_init()
550 * @label: Label (e.g., description of the key) for PRF
551 * @context: Optional extra upper-layer context (max len 2^16)
552 * @context_len: The length of the context value
553 * @server_random_first: seed is 0 = client_random|server_random,
554 * 1 = server_random|client_random
555 * @out: Buffer for output data from TLS-PRF
556 * @out_len: Length of the output buffer
557 * Returns: 0 on success, -1 on failure
558 */
tlsv1_client_prf(struct tlsv1_client * conn,const char * label,const u8 * context,size_t context_len,int server_random_first,u8 * out,size_t out_len)559 int tlsv1_client_prf(struct tlsv1_client *conn, const char *label,
560 const u8 *context, size_t context_len,
561 int server_random_first, u8 *out, size_t out_len)
562 {
563 u8 *seed, *pos;
564 size_t seed_len = 2 * TLS_RANDOM_LEN;
565 int res;
566
567 if (conn->state != ESTABLISHED)
568 return -1;
569
570 if (context_len > 65535)
571 return -1;
572
573 if (context)
574 seed_len += 2 + context_len;
575
576 seed = os_malloc(seed_len);
577 if (!seed)
578 return -1;
579
580 if (server_random_first) {
581 os_memcpy(seed, conn->server_random, TLS_RANDOM_LEN);
582 os_memcpy(seed + TLS_RANDOM_LEN, conn->client_random,
583 TLS_RANDOM_LEN);
584 } else {
585 os_memcpy(seed, conn->client_random, TLS_RANDOM_LEN);
586 os_memcpy(seed + TLS_RANDOM_LEN, conn->server_random,
587 TLS_RANDOM_LEN);
588 }
589
590 if (context) {
591 pos = seed + 2 * TLS_RANDOM_LEN;
592 WPA_PUT_BE16(pos, context_len);
593 pos += 2;
594 os_memcpy(pos, context, context_len);
595 }
596
597 res = tls_prf(conn->rl.tls_version,
598 conn->master_secret, TLS_MASTER_SECRET_LEN,
599 label, seed, seed_len, out, out_len);
600 os_free(seed);
601 return res;
602 }
603
604
605 /**
606 * tlsv1_client_get_cipher - Get current cipher name
607 * @conn: TLSv1 client connection data from tlsv1_client_init()
608 * @buf: Buffer for the cipher name
609 * @buflen: buf size
610 * Returns: 0 on success, -1 on failure
611 *
612 * Get the name of the currently used cipher.
613 */
tlsv1_client_get_cipher(struct tlsv1_client * conn,char * buf,size_t buflen)614 int tlsv1_client_get_cipher(struct tlsv1_client *conn, char *buf,
615 size_t buflen)
616 {
617 char *cipher;
618
619 switch (conn->rl.cipher_suite) {
620 case TLS_RSA_WITH_RC4_128_MD5:
621 cipher = "RC4-MD5";
622 break;
623 case TLS_RSA_WITH_RC4_128_SHA:
624 cipher = "RC4-SHA";
625 break;
626 case TLS_RSA_WITH_DES_CBC_SHA:
627 cipher = "DES-CBC-SHA";
628 break;
629 case TLS_RSA_WITH_3DES_EDE_CBC_SHA:
630 cipher = "DES-CBC3-SHA";
631 break;
632 case TLS_DHE_RSA_WITH_DES_CBC_SHA:
633 cipher = "DHE-RSA-DES-CBC-SHA";
634 break;
635 case TLS_DHE_RSA_WITH_3DES_EDE_CBC_SHA:
636 cipher = "DHE-RSA-DES-CBC3-SHA";
637 break;
638 case TLS_DH_anon_WITH_RC4_128_MD5:
639 cipher = "ADH-RC4-MD5";
640 break;
641 case TLS_DH_anon_WITH_DES_CBC_SHA:
642 cipher = "ADH-DES-SHA";
643 break;
644 case TLS_DH_anon_WITH_3DES_EDE_CBC_SHA:
645 cipher = "ADH-DES-CBC3-SHA";
646 break;
647 case TLS_RSA_WITH_AES_128_CBC_SHA:
648 cipher = "AES-128-SHA";
649 break;
650 case TLS_DHE_RSA_WITH_AES_128_CBC_SHA:
651 cipher = "DHE-RSA-AES-128-SHA";
652 break;
653 case TLS_DH_anon_WITH_AES_128_CBC_SHA:
654 cipher = "ADH-AES-128-SHA";
655 break;
656 case TLS_RSA_WITH_AES_256_CBC_SHA:
657 cipher = "AES-256-SHA";
658 break;
659 case TLS_DHE_RSA_WITH_AES_256_CBC_SHA:
660 cipher = "DHE-RSA-AES-256-SHA";
661 break;
662 case TLS_DH_anon_WITH_AES_256_CBC_SHA:
663 cipher = "ADH-AES-256-SHA";
664 break;
665 case TLS_RSA_WITH_AES_128_CBC_SHA256:
666 cipher = "AES-128-SHA256";
667 break;
668 case TLS_RSA_WITH_AES_256_CBC_SHA256:
669 cipher = "AES-256-SHA256";
670 break;
671 case TLS_DHE_RSA_WITH_AES_128_CBC_SHA256:
672 cipher = "DHE-RSA-AES-128-SHA256";
673 break;
674 case TLS_DHE_RSA_WITH_AES_256_CBC_SHA256:
675 cipher = "DHE-RSA-AES-256-SHA256";
676 break;
677 case TLS_DH_anon_WITH_AES_128_CBC_SHA256:
678 cipher = "ADH-AES-128-SHA256";
679 break;
680 case TLS_DH_anon_WITH_AES_256_CBC_SHA256:
681 cipher = "ADH-AES-256-SHA256";
682 break;
683 default:
684 return -1;
685 }
686
687 if (os_strlcpy(buf, cipher, buflen) >= buflen)
688 return -1;
689 return 0;
690 }
691
692
693 /**
694 * tlsv1_client_shutdown - Shutdown TLS connection
695 * @conn: TLSv1 client connection data from tlsv1_client_init()
696 * Returns: 0 on success, -1 on failure
697 */
tlsv1_client_shutdown(struct tlsv1_client * conn)698 int tlsv1_client_shutdown(struct tlsv1_client *conn)
699 {
700 conn->state = CLIENT_HELLO;
701
702 if (tls_verify_hash_init(&conn->verify) < 0) {
703 wpa_printf(MSG_DEBUG, "TLSv1: Failed to re-initialize verify "
704 "hash");
705 return -1;
706 }
707
708 tlsv1_record_set_cipher_suite(&conn->rl, TLS_NULL_WITH_NULL_NULL);
709 tlsv1_record_change_write_cipher(&conn->rl);
710 tlsv1_record_change_read_cipher(&conn->rl);
711
712 conn->certificate_requested = 0;
713 crypto_public_key_free(conn->server_rsa_key);
714 conn->server_rsa_key = NULL;
715 conn->session_resumed = 0;
716
717 return 0;
718 }
719
720
721 /**
722 * tlsv1_client_resumed - Was session resumption used
723 * @conn: TLSv1 client connection data from tlsv1_client_init()
724 * Returns: 1 if current session used session resumption, 0 if not
725 */
tlsv1_client_resumed(struct tlsv1_client * conn)726 int tlsv1_client_resumed(struct tlsv1_client *conn)
727 {
728 return !!conn->session_resumed;
729 }
730
731
732 /**
733 * tlsv1_client_hello_ext - Set TLS extension for ClientHello
734 * @conn: TLSv1 client connection data from tlsv1_client_init()
735 * @ext_type: Extension type
736 * @data: Extension payload (%NULL to remove extension)
737 * @data_len: Extension payload length
738 * Returns: 0 on success, -1 on failure
739 */
tlsv1_client_hello_ext(struct tlsv1_client * conn,int ext_type,const u8 * data,size_t data_len)740 int tlsv1_client_hello_ext(struct tlsv1_client *conn, int ext_type,
741 const u8 *data, size_t data_len)
742 {
743 u8 *pos;
744
745 conn->session_ticket_included = 0;
746 os_free(conn->client_hello_ext);
747 conn->client_hello_ext = NULL;
748 conn->client_hello_ext_len = 0;
749
750 if (data == NULL || data_len == 0)
751 return 0;
752
753 pos = conn->client_hello_ext = os_malloc(4 + data_len);
754 if (pos == NULL)
755 return -1;
756
757 WPA_PUT_BE16(pos, ext_type);
758 pos += 2;
759 WPA_PUT_BE16(pos, data_len);
760 pos += 2;
761 os_memcpy(pos, data, data_len);
762 conn->client_hello_ext_len = 4 + data_len;
763
764 if (ext_type == TLS_EXT_PAC_OPAQUE) {
765 conn->session_ticket_included = 1;
766 wpa_printf(MSG_DEBUG, "TLSv1: Using session ticket");
767 }
768
769 return 0;
770 }
771
772
773 /**
774 * tlsv1_client_get_random - Get random data from TLS connection
775 * @conn: TLSv1 client connection data from tlsv1_client_init()
776 * @keys: Structure of random data (filled on success)
777 * Returns: 0 on success, -1 on failure
778 */
tlsv1_client_get_random(struct tlsv1_client * conn,struct tls_random * keys)779 int tlsv1_client_get_random(struct tlsv1_client *conn, struct tls_random *keys)
780 {
781 os_memset(keys, 0, sizeof(*keys));
782 if (conn->state == CLIENT_HELLO)
783 return -1;
784
785 keys->client_random = conn->client_random;
786 keys->client_random_len = TLS_RANDOM_LEN;
787
788 if (conn->state != SERVER_HELLO) {
789 keys->server_random = conn->server_random;
790 keys->server_random_len = TLS_RANDOM_LEN;
791 }
792
793 return 0;
794 }
795
796
797 /**
798 * tlsv1_client_get_keyblock_size - Get TLS key_block size
799 * @conn: TLSv1 client connection data from tlsv1_client_init()
800 * Returns: Size of the key_block for the negotiated cipher suite or -1 on
801 * failure
802 */
tlsv1_client_get_keyblock_size(struct tlsv1_client * conn)803 int tlsv1_client_get_keyblock_size(struct tlsv1_client *conn)
804 {
805 if (conn->state == CLIENT_HELLO || conn->state == SERVER_HELLO)
806 return -1;
807
808 return 2 * (conn->rl.hash_size + conn->rl.key_material_len +
809 conn->rl.iv_size);
810 }
811
812
813 /**
814 * tlsv1_client_set_cipher_list - Configure acceptable cipher suites
815 * @conn: TLSv1 client connection data from tlsv1_client_init()
816 * @ciphers: Zero (TLS_CIPHER_NONE) terminated list of allowed ciphers
817 * (TLS_CIPHER_*).
818 * Returns: 0 on success, -1 on failure
819 */
tlsv1_client_set_cipher_list(struct tlsv1_client * conn,u8 * ciphers)820 int tlsv1_client_set_cipher_list(struct tlsv1_client *conn, u8 *ciphers)
821 {
822 size_t count;
823 u16 *suites;
824
825 /* TODO: implement proper configuration of cipher suites */
826 if (ciphers[0] == TLS_CIPHER_ANON_DH_AES128_SHA) {
827 count = 0;
828 suites = conn->cipher_suites;
829 suites[count++] = TLS_DH_anon_WITH_AES_256_CBC_SHA256;
830 suites[count++] = TLS_DH_anon_WITH_AES_256_CBC_SHA;
831 suites[count++] = TLS_DH_anon_WITH_AES_128_CBC_SHA256;
832 suites[count++] = TLS_DH_anon_WITH_AES_128_CBC_SHA;
833 suites[count++] = TLS_DH_anon_WITH_3DES_EDE_CBC_SHA;
834 suites[count++] = TLS_DH_anon_WITH_RC4_128_MD5;
835 suites[count++] = TLS_DH_anon_WITH_DES_CBC_SHA;
836
837 /*
838 * Cisco AP (at least 350 and 1200 series) local authentication
839 * server does not know how to search cipher suites from the
840 * list and seem to require that the last entry in the list is
841 * the one that it wants to use. However, TLS specification
842 * requires the list to be in the client preference order. As a
843 * workaround, add anon-DH AES-128-SHA1 again at the end of the
844 * list to allow the Cisco code to find it.
845 */
846 suites[count++] = TLS_DH_anon_WITH_AES_128_CBC_SHA;
847 conn->num_cipher_suites = count;
848 }
849
850 return 0;
851 }
852
853
854 /**
855 * tlsv1_client_set_cred - Set client credentials
856 * @conn: TLSv1 client connection data from tlsv1_client_init()
857 * @cred: Credentials from tlsv1_cred_alloc()
858 * Returns: 0 on success, -1 on failure
859 *
860 * On success, the client takes ownership of the credentials block and caller
861 * must not free it. On failure, caller is responsible for freeing the
862 * credential block.
863 */
tlsv1_client_set_cred(struct tlsv1_client * conn,struct tlsv1_credentials * cred)864 int tlsv1_client_set_cred(struct tlsv1_client *conn,
865 struct tlsv1_credentials *cred)
866 {
867 tlsv1_cred_free(conn->cred);
868 conn->cred = cred;
869 return 0;
870 }
871
872
873 /**
874 * tlsv1_client_set_flags - Set connection flags
875 * @conn: TLSv1 client connection data from tlsv1_client_init()
876 * @flags: TLS_CONN_* bitfield
877 */
tlsv1_client_set_flags(struct tlsv1_client * conn,unsigned int flags)878 void tlsv1_client_set_flags(struct tlsv1_client *conn, unsigned int flags)
879 {
880 conn->flags = flags;
881 conn->rl.tls_version = tls_client_highest_ver(conn);
882 }
883
884
tlsv1_client_set_session_ticket_cb(struct tlsv1_client * conn,tlsv1_client_session_ticket_cb cb,void * ctx)885 void tlsv1_client_set_session_ticket_cb(struct tlsv1_client *conn,
886 tlsv1_client_session_ticket_cb cb,
887 void *ctx)
888 {
889 wpa_printf(MSG_DEBUG, "TLSv1: SessionTicket callback set %p (ctx %p)",
890 cb, ctx);
891 conn->session_ticket_cb = cb;
892 conn->session_ticket_cb_ctx = ctx;
893 }
894
895
tlsv1_client_set_cb(struct tlsv1_client * conn,void (* event_cb)(void * ctx,enum tls_event ev,union tls_event_data * data),void * cb_ctx,int cert_in_cb)896 void tlsv1_client_set_cb(struct tlsv1_client *conn,
897 void (*event_cb)(void *ctx, enum tls_event ev,
898 union tls_event_data *data),
899 void *cb_ctx,
900 int cert_in_cb)
901 {
902 conn->event_cb = event_cb;
903 conn->cb_ctx = cb_ctx;
904 conn->cert_in_cb = !!cert_in_cb;
905 }
906
907
tlsv1_client_get_version(struct tlsv1_client * conn,char * buf,size_t buflen)908 int tlsv1_client_get_version(struct tlsv1_client *conn, char *buf,
909 size_t buflen)
910 {
911 if (!conn)
912 return -1;
913 switch (conn->rl.tls_version) {
914 case TLS_VERSION_1:
915 os_strlcpy(buf, "TLSv1", buflen);
916 break;
917 case TLS_VERSION_1_1:
918 os_strlcpy(buf, "TLSv1.1", buflen);
919 break;
920 case TLS_VERSION_1_2:
921 os_strlcpy(buf, "TLSv1.2", buflen);
922 break;
923 default:
924 return -1;
925 }
926
927 return 0;
928 }
929
