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