Home | History | Annotate | Download | only in tls
      1 /*
      2  * TLS v1.0/v1.1/v1.2 client (RFC 2246, RFC 4346, RFC 5246)
      3  * Copyright (c) 2006-2015, Jouni Malinen <j (at) 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