1 /* 2 * TLS v1.0/v1.1/v1.2 client (RFC 2246, RFC 4346, RFC 5246) 3 * Copyright (c) 2006-2019, 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 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 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 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 */ 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 */ 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 */ 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 */ 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 */ 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 */ 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 suites[count++] = TLS_DHE_RSA_WITH_AES_256_CBC_SHA256; 487 suites[count++] = TLS_RSA_WITH_AES_256_CBC_SHA256; 488 suites[count++] = TLS_DHE_RSA_WITH_AES_256_CBC_SHA; 489 suites[count++] = TLS_RSA_WITH_AES_256_CBC_SHA; 490 suites[count++] = TLS_DHE_RSA_WITH_AES_128_CBC_SHA256; 491 suites[count++] = TLS_RSA_WITH_AES_128_CBC_SHA256; 492 suites[count++] = TLS_DHE_RSA_WITH_AES_128_CBC_SHA; 493 suites[count++] = TLS_RSA_WITH_AES_128_CBC_SHA; 494 suites[count++] = TLS_DHE_RSA_WITH_3DES_EDE_CBC_SHA; 495 suites[count++] = TLS_RSA_WITH_3DES_EDE_CBC_SHA; 496 suites[count++] = TLS_RSA_WITH_RC4_128_SHA; 497 suites[count++] = TLS_RSA_WITH_RC4_128_MD5; 498 conn->num_cipher_suites = count; 499 500 conn->rl.tls_version = TLS_VERSION; 501 502 return conn; 503 } 504 505 506 /** 507 * tlsv1_client_deinit - Deinitialize TLSv1 client connection 508 * @conn: TLSv1 client connection data from tlsv1_client_init() 509 */ 510 void tlsv1_client_deinit(struct tlsv1_client *conn) 511 { 512 crypto_public_key_free(conn->server_rsa_key); 513 tlsv1_record_set_cipher_suite(&conn->rl, TLS_NULL_WITH_NULL_NULL); 514 tlsv1_record_change_write_cipher(&conn->rl); 515 tlsv1_record_change_read_cipher(&conn->rl); 516 tls_verify_hash_free(&conn->verify); 517 os_free(conn->client_hello_ext); 518 tlsv1_client_free_dh(conn); 519 tlsv1_cred_free(conn->cred); 520 wpabuf_free(conn->partial_input); 521 x509_certificate_chain_free(conn->server_cert); 522 os_free(conn); 523 } 524 525 526 /** 527 * tlsv1_client_established - Check whether connection has been established 528 * @conn: TLSv1 client connection data from tlsv1_client_init() 529 * Returns: 1 if connection is established, 0 if not 530 */ 531 int tlsv1_client_established(struct tlsv1_client *conn) 532 { 533 return conn->state == ESTABLISHED; 534 } 535 536 537 /** 538 * tlsv1_client_prf - Use TLS-PRF to derive keying material 539 * @conn: TLSv1 client connection data from tlsv1_client_init() 540 * @label: Label (e.g., description of the key) for PRF 541 * @context: Optional extra upper-layer context (max len 2^16) 542 * @context_len: The length of the context value 543 * @server_random_first: seed is 0 = client_random|server_random, 544 * 1 = server_random|client_random 545 * @out: Buffer for output data from TLS-PRF 546 * @out_len: Length of the output buffer 547 * Returns: 0 on success, -1 on failure 548 */ 549 int tlsv1_client_prf(struct tlsv1_client *conn, const char *label, 550 const u8 *context, size_t context_len, 551 int server_random_first, u8 *out, size_t out_len) 552 { 553 u8 *seed, *pos; 554 size_t seed_len = 2 * TLS_RANDOM_LEN; 555 int res; 556 557 if (conn->state != ESTABLISHED) 558 return -1; 559 560 if (context_len > 65535) 561 return -1; 562 563 if (context) 564 seed_len += 2 + context_len; 565 566 seed = os_malloc(seed_len); 567 if (!seed) 568 return -1; 569 570 if (server_random_first) { 571 os_memcpy(seed, conn->server_random, TLS_RANDOM_LEN); 572 os_memcpy(seed + TLS_RANDOM_LEN, conn->client_random, 573 TLS_RANDOM_LEN); 574 } else { 575 os_memcpy(seed, conn->client_random, TLS_RANDOM_LEN); 576 os_memcpy(seed + TLS_RANDOM_LEN, conn->server_random, 577 TLS_RANDOM_LEN); 578 } 579 580 if (context) { 581 pos = seed + 2 * TLS_RANDOM_LEN; 582 WPA_PUT_BE16(pos, context_len); 583 pos += 2; 584 os_memcpy(pos, context, context_len); 585 } 586 587 res = tls_prf(conn->rl.tls_version, 588 conn->master_secret, TLS_MASTER_SECRET_LEN, 589 label, seed, seed_len, out, out_len); 590 os_free(seed); 591 return res; 592 } 593 594 595 /** 596 * tlsv1_client_get_cipher - Get current cipher name 597 * @conn: TLSv1 client connection data from tlsv1_client_init() 598 * @buf: Buffer for the cipher name 599 * @buflen: buf size 600 * Returns: 0 on success, -1 on failure 601 * 602 * Get the name of the currently used cipher. 603 */ 604 int tlsv1_client_get_cipher(struct tlsv1_client *conn, char *buf, 605 size_t buflen) 606 { 607 char *cipher; 608 609 switch (conn->rl.cipher_suite) { 610 case TLS_RSA_WITH_RC4_128_MD5: 611 cipher = "RC4-MD5"; 612 break; 613 case TLS_RSA_WITH_RC4_128_SHA: 614 cipher = "RC4-SHA"; 615 break; 616 case TLS_RSA_WITH_DES_CBC_SHA: 617 cipher = "DES-CBC-SHA"; 618 break; 619 case TLS_RSA_WITH_3DES_EDE_CBC_SHA: 620 cipher = "DES-CBC3-SHA"; 621 break; 622 case TLS_DHE_RSA_WITH_DES_CBC_SHA: 623 cipher = "DHE-RSA-DES-CBC-SHA"; 624 break; 625 case TLS_DHE_RSA_WITH_3DES_EDE_CBC_SHA: 626 cipher = "DHE-RSA-DES-CBC3-SHA"; 627 break; 628 case TLS_DH_anon_WITH_RC4_128_MD5: 629 cipher = "ADH-RC4-MD5"; 630 break; 631 case TLS_DH_anon_WITH_DES_CBC_SHA: 632 cipher = "ADH-DES-SHA"; 633 break; 634 case TLS_DH_anon_WITH_3DES_EDE_CBC_SHA: 635 cipher = "ADH-DES-CBC3-SHA"; 636 break; 637 case TLS_RSA_WITH_AES_128_CBC_SHA: 638 cipher = "AES-128-SHA"; 639 break; 640 case TLS_DHE_RSA_WITH_AES_128_CBC_SHA: 641 cipher = "DHE-RSA-AES-128-SHA"; 642 break; 643 case TLS_DH_anon_WITH_AES_128_CBC_SHA: 644 cipher = "ADH-AES-128-SHA"; 645 break; 646 case TLS_RSA_WITH_AES_256_CBC_SHA: 647 cipher = "AES-256-SHA"; 648 break; 649 case TLS_DHE_RSA_WITH_AES_256_CBC_SHA: 650 cipher = "DHE-RSA-AES-256-SHA"; 651 break; 652 case TLS_DH_anon_WITH_AES_256_CBC_SHA: 653 cipher = "ADH-AES-256-SHA"; 654 break; 655 case TLS_RSA_WITH_AES_128_CBC_SHA256: 656 cipher = "AES-128-SHA256"; 657 break; 658 case TLS_RSA_WITH_AES_256_CBC_SHA256: 659 cipher = "AES-256-SHA256"; 660 break; 661 case TLS_DHE_RSA_WITH_AES_128_CBC_SHA256: 662 cipher = "DHE-RSA-AES-128-SHA256"; 663 break; 664 case TLS_DHE_RSA_WITH_AES_256_CBC_SHA256: 665 cipher = "DHE-RSA-AES-256-SHA256"; 666 break; 667 case TLS_DH_anon_WITH_AES_128_CBC_SHA256: 668 cipher = "ADH-AES-128-SHA256"; 669 break; 670 case TLS_DH_anon_WITH_AES_256_CBC_SHA256: 671 cipher = "ADH-AES-256-SHA256"; 672 break; 673 default: 674 return -1; 675 } 676 677 if (os_strlcpy(buf, cipher, buflen) >= buflen) 678 return -1; 679 return 0; 680 } 681 682 683 /** 684 * tlsv1_client_shutdown - Shutdown TLS connection 685 * @conn: TLSv1 client connection data from tlsv1_client_init() 686 * Returns: 0 on success, -1 on failure 687 */ 688 int tlsv1_client_shutdown(struct tlsv1_client *conn) 689 { 690 conn->state = CLIENT_HELLO; 691 692 if (tls_verify_hash_init(&conn->verify) < 0) { 693 wpa_printf(MSG_DEBUG, "TLSv1: Failed to re-initialize verify " 694 "hash"); 695 return -1; 696 } 697 698 tlsv1_record_set_cipher_suite(&conn->rl, TLS_NULL_WITH_NULL_NULL); 699 tlsv1_record_change_write_cipher(&conn->rl); 700 tlsv1_record_change_read_cipher(&conn->rl); 701 702 conn->certificate_requested = 0; 703 crypto_public_key_free(conn->server_rsa_key); 704 conn->server_rsa_key = NULL; 705 conn->session_resumed = 0; 706 707 return 0; 708 } 709 710 711 /** 712 * tlsv1_client_resumed - Was session resumption used 713 * @conn: TLSv1 client connection data from tlsv1_client_init() 714 * Returns: 1 if current session used session resumption, 0 if not 715 */ 716 int tlsv1_client_resumed(struct tlsv1_client *conn) 717 { 718 return !!conn->session_resumed; 719 } 720 721 722 /** 723 * tlsv1_client_hello_ext - Set TLS extension for ClientHello 724 * @conn: TLSv1 client connection data from tlsv1_client_init() 725 * @ext_type: Extension type 726 * @data: Extension payload (%NULL to remove extension) 727 * @data_len: Extension payload length 728 * Returns: 0 on success, -1 on failure 729 */ 730 int tlsv1_client_hello_ext(struct tlsv1_client *conn, int ext_type, 731 const u8 *data, size_t data_len) 732 { 733 u8 *pos; 734 735 conn->session_ticket_included = 0; 736 os_free(conn->client_hello_ext); 737 conn->client_hello_ext = NULL; 738 conn->client_hello_ext_len = 0; 739 740 if (data == NULL || data_len == 0) 741 return 0; 742 743 pos = conn->client_hello_ext = os_malloc(4 + data_len); 744 if (pos == NULL) 745 return -1; 746 747 WPA_PUT_BE16(pos, ext_type); 748 pos += 2; 749 WPA_PUT_BE16(pos, data_len); 750 pos += 2; 751 os_memcpy(pos, data, data_len); 752 conn->client_hello_ext_len = 4 + data_len; 753 754 if (ext_type == TLS_EXT_PAC_OPAQUE) { 755 conn->session_ticket_included = 1; 756 wpa_printf(MSG_DEBUG, "TLSv1: Using session ticket"); 757 } 758 759 return 0; 760 } 761 762 763 /** 764 * tlsv1_client_get_random - Get random data from TLS connection 765 * @conn: TLSv1 client connection data from tlsv1_client_init() 766 * @keys: Structure of random data (filled on success) 767 * Returns: 0 on success, -1 on failure 768 */ 769 int tlsv1_client_get_random(struct tlsv1_client *conn, struct tls_random *keys) 770 { 771 os_memset(keys, 0, sizeof(*keys)); 772 if (conn->state == CLIENT_HELLO) 773 return -1; 774 775 keys->client_random = conn->client_random; 776 keys->client_random_len = TLS_RANDOM_LEN; 777 778 if (conn->state != SERVER_HELLO) { 779 keys->server_random = conn->server_random; 780 keys->server_random_len = TLS_RANDOM_LEN; 781 } 782 783 return 0; 784 } 785 786 787 /** 788 * tlsv1_client_get_keyblock_size - Get TLS key_block size 789 * @conn: TLSv1 client connection data from tlsv1_client_init() 790 * Returns: Size of the key_block for the negotiated cipher suite or -1 on 791 * failure 792 */ 793 int tlsv1_client_get_keyblock_size(struct tlsv1_client *conn) 794 { 795 if (conn->state == CLIENT_HELLO || conn->state == SERVER_HELLO) 796 return -1; 797 798 return 2 * (conn->rl.hash_size + conn->rl.key_material_len + 799 conn->rl.iv_size); 800 } 801 802 803 /** 804 * tlsv1_client_set_cipher_list - Configure acceptable cipher suites 805 * @conn: TLSv1 client connection data from tlsv1_client_init() 806 * @ciphers: Zero (TLS_CIPHER_NONE) terminated list of allowed ciphers 807 * (TLS_CIPHER_*). 808 * Returns: 0 on success, -1 on failure 809 */ 810 int tlsv1_client_set_cipher_list(struct tlsv1_client *conn, u8 *ciphers) 811 { 812 size_t count; 813 u16 *suites; 814 815 /* TODO: implement proper configuration of cipher suites */ 816 if (ciphers[0] == TLS_CIPHER_ANON_DH_AES128_SHA) { 817 count = 0; 818 suites = conn->cipher_suites; 819 suites[count++] = TLS_DH_anon_WITH_AES_256_CBC_SHA256; 820 suites[count++] = TLS_DH_anon_WITH_AES_256_CBC_SHA; 821 suites[count++] = TLS_DH_anon_WITH_AES_128_CBC_SHA256; 822 suites[count++] = TLS_DH_anon_WITH_AES_128_CBC_SHA; 823 suites[count++] = TLS_DH_anon_WITH_3DES_EDE_CBC_SHA; 824 suites[count++] = TLS_DH_anon_WITH_RC4_128_MD5; 825 suites[count++] = TLS_DH_anon_WITH_DES_CBC_SHA; 826 827 /* 828 * Cisco AP (at least 350 and 1200 series) local authentication 829 * server does not know how to search cipher suites from the 830 * list and seem to require that the last entry in the list is 831 * the one that it wants to use. However, TLS specification 832 * requires the list to be in the client preference order. As a 833 * workaround, add anon-DH AES-128-SHA1 again at the end of the 834 * list to allow the Cisco code to find it. 835 */ 836 suites[count++] = TLS_DH_anon_WITH_AES_128_CBC_SHA; 837 conn->num_cipher_suites = count; 838 } 839 840 return 0; 841 } 842 843 844 /** 845 * tlsv1_client_set_cred - Set client credentials 846 * @conn: TLSv1 client connection data from tlsv1_client_init() 847 * @cred: Credentials from tlsv1_cred_alloc() 848 * Returns: 0 on success, -1 on failure 849 * 850 * On success, the client takes ownership of the credentials block and caller 851 * must not free it. On failure, caller is responsible for freeing the 852 * credential block. 853 */ 854 int tlsv1_client_set_cred(struct tlsv1_client *conn, 855 struct tlsv1_credentials *cred) 856 { 857 tlsv1_cred_free(conn->cred); 858 conn->cred = cred; 859 return 0; 860 } 861 862 863 /** 864 * tlsv1_client_set_flags - Set connection flags 865 * @conn: TLSv1 client connection data from tlsv1_client_init() 866 * @flags: TLS_CONN_* bitfield 867 */ 868 void tlsv1_client_set_flags(struct tlsv1_client *conn, unsigned int flags) 869 { 870 conn->flags = flags; 871 conn->rl.tls_version = tls_client_highest_ver(conn); 872 } 873 874 875 void tlsv1_client_set_session_ticket_cb(struct tlsv1_client *conn, 876 tlsv1_client_session_ticket_cb cb, 877 void *ctx) 878 { 879 wpa_printf(MSG_DEBUG, "TLSv1: SessionTicket callback set %p (ctx %p)", 880 cb, ctx); 881 conn->session_ticket_cb = cb; 882 conn->session_ticket_cb_ctx = ctx; 883 } 884 885 886 void tlsv1_client_set_cb(struct tlsv1_client *conn, 887 void (*event_cb)(void *ctx, enum tls_event ev, 888 union tls_event_data *data), 889 void *cb_ctx, 890 int cert_in_cb) 891 { 892 conn->event_cb = event_cb; 893 conn->cb_ctx = cb_ctx; 894 conn->cert_in_cb = !!cert_in_cb; 895 } 896 897 898 int tlsv1_client_get_version(struct tlsv1_client *conn, char *buf, 899 size_t buflen) 900 { 901 if (!conn) 902 return -1; 903 switch (conn->rl.tls_version) { 904 case TLS_VERSION_1: 905 os_strlcpy(buf, "TLSv1", buflen); 906 break; 907 case TLS_VERSION_1_1: 908 os_strlcpy(buf, "TLSv1.1", buflen); 909 break; 910 case TLS_VERSION_1_2: 911 os_strlcpy(buf, "TLSv1.2", buflen); 912 break; 913 default: 914 return -1; 915 } 916 917 return 0; 918 } 919
Indexes created Fri Jun 12 00:25:51 UTC 2026