2 * Copyright 1995-2016 The OpenSSL Project Authors. All Rights Reserved.
3 * Copyright (c) 2002, Oracle and/or its affiliates. All rights reserved
4 * Copyright 2005 Nokia. All rights reserved.
6 * Licensed under the OpenSSL license (the "License"). You may not use
7 * this file except in compliance with the License. You can obtain a copy
8 * in the file LICENSE in the source distribution or at
9 * https://www.openssl.org/source/license.html
13 #include "../ssl_locl.h"
14 #include "statem_locl.h"
15 #include "internal/constant_time_locl.h"
16 #include <openssl/buffer.h>
17 #include <openssl/rand.h>
18 #include <openssl/objects.h>
19 #include <openssl/evp.h>
20 #include <openssl/hmac.h>
21 #include <openssl/x509.h>
22 #include <openssl/dh.h>
23 #include <openssl/bn.h>
24 #include <openssl/md5.h>
26 static int tls_construct_encrypted_extensions(SSL
*s
, WPACKET
*pkt
);
27 static int tls_construct_hello_retry_request(SSL
*s
, WPACKET
*pkt
);
30 * ossl_statem_server13_read_transition() encapsulates the logic for the allowed
31 * handshake state transitions when a TLSv1.3 server is reading messages from
32 * the client. The message type that the client has sent is provided in |mt|.
33 * The current state is in |s->statem.hand_state|.
35 * Return values are 1 for success (transition allowed) and 0 on error
36 * (transition not allowed)
38 static int ossl_statem_server13_read_transition(SSL
*s
, int mt
)
40 OSSL_STATEM
*st
= &s
->statem
;
43 * Note: There is no case for TLS_ST_BEFORE because at that stage we have
44 * not negotiated TLSv1.3 yet, so that case is handled by
45 * ossl_statem_server_read_transition()
47 switch (st
->hand_state
) {
51 case TLS_ST_EARLY_DATA
:
52 if (s
->hello_retry_request
) {
53 if (mt
== SSL3_MT_CLIENT_HELLO
) {
54 st
->hand_state
= TLS_ST_SR_CLNT_HELLO
;
58 } else if (s
->ext
.early_data
== SSL_EARLY_DATA_ACCEPTED
) {
59 if (mt
== SSL3_MT_END_OF_EARLY_DATA
) {
60 st
->hand_state
= TLS_ST_SR_END_OF_EARLY_DATA
;
67 case TLS_ST_SR_END_OF_EARLY_DATA
:
68 case TLS_ST_SW_FINISHED
:
69 if (s
->s3
->tmp
.cert_request
) {
70 if (mt
== SSL3_MT_CERTIFICATE
) {
71 st
->hand_state
= TLS_ST_SR_CERT
;
75 if (mt
== SSL3_MT_FINISHED
) {
76 st
->hand_state
= TLS_ST_SR_FINISHED
;
83 if (s
->session
->peer
== NULL
) {
84 if (mt
== SSL3_MT_FINISHED
) {
85 st
->hand_state
= TLS_ST_SR_FINISHED
;
89 if (mt
== SSL3_MT_CERTIFICATE_VERIFY
) {
90 st
->hand_state
= TLS_ST_SR_CERT_VRFY
;
96 case TLS_ST_SR_CERT_VRFY
:
97 if (mt
== SSL3_MT_FINISHED
) {
98 st
->hand_state
= TLS_ST_SR_FINISHED
;
105 * Its never ok to start processing handshake messages in the middle of
106 * early data (i.e. before we've received the end of early data alert)
108 if (s
->early_data_state
== SSL_EARLY_DATA_READING
)
110 if (mt
== SSL3_MT_KEY_UPDATE
) {
111 st
->hand_state
= TLS_ST_SR_KEY_UPDATE
;
117 /* No valid transition found */
122 * ossl_statem_server_read_transition() encapsulates the logic for the allowed
123 * handshake state transitions when the server is reading messages from the
124 * client. The message type that the client has sent is provided in |mt|. The
125 * current state is in |s->statem.hand_state|.
127 * Return values are 1 for success (transition allowed) and 0 on error
128 * (transition not allowed)
130 int ossl_statem_server_read_transition(SSL
*s
, int mt
)
132 OSSL_STATEM
*st
= &s
->statem
;
134 if (SSL_IS_TLS13(s
)) {
135 if (!ossl_statem_server13_read_transition(s
, mt
))
140 switch (st
->hand_state
) {
146 case DTLS_ST_SW_HELLO_VERIFY_REQUEST
:
147 if (mt
== SSL3_MT_CLIENT_HELLO
) {
148 st
->hand_state
= TLS_ST_SR_CLNT_HELLO
;
153 case TLS_ST_SW_SRVR_DONE
:
155 * If we get a CKE message after a ServerDone then either
156 * 1) We didn't request a Certificate
158 * 2) If we did request one then
159 * a) We allow no Certificate to be returned
161 * b) We are running SSL3 (in TLS1.0+ the client must return a 0
162 * list if we requested a certificate)
164 if (mt
== SSL3_MT_CLIENT_KEY_EXCHANGE
) {
165 if (s
->s3
->tmp
.cert_request
) {
166 if (s
->version
== SSL3_VERSION
) {
167 if ((s
->verify_mode
& SSL_VERIFY_PEER
)
168 && (s
->verify_mode
& SSL_VERIFY_FAIL_IF_NO_PEER_CERT
)) {
170 * This isn't an unexpected message as such - we're just
171 * not going to accept it because we require a client
174 ssl3_send_alert(s
, SSL3_AL_FATAL
,
175 SSL3_AD_HANDSHAKE_FAILURE
);
176 SSLerr(SSL_F_OSSL_STATEM_SERVER_READ_TRANSITION
,
177 SSL_R_PEER_DID_NOT_RETURN_A_CERTIFICATE
);
180 st
->hand_state
= TLS_ST_SR_KEY_EXCH
;
184 st
->hand_state
= TLS_ST_SR_KEY_EXCH
;
187 } else if (s
->s3
->tmp
.cert_request
) {
188 if (mt
== SSL3_MT_CERTIFICATE
) {
189 st
->hand_state
= TLS_ST_SR_CERT
;
196 if (mt
== SSL3_MT_CLIENT_KEY_EXCHANGE
) {
197 st
->hand_state
= TLS_ST_SR_KEY_EXCH
;
202 case TLS_ST_SR_KEY_EXCH
:
204 * We should only process a CertificateVerify message if we have
205 * received a Certificate from the client. If so then |s->session->peer|
206 * will be non NULL. In some instances a CertificateVerify message is
207 * not required even if the peer has sent a Certificate (e.g. such as in
208 * the case of static DH). In that case |st->no_cert_verify| should be
211 if (s
->session
->peer
== NULL
|| st
->no_cert_verify
) {
212 if (mt
== SSL3_MT_CHANGE_CIPHER_SPEC
) {
214 * For the ECDH ciphersuites when the client sends its ECDH
215 * pub key in a certificate, the CertificateVerify message is
216 * not sent. Also for GOST ciphersuites when the client uses
217 * its key from the certificate for key exchange.
219 st
->hand_state
= TLS_ST_SR_CHANGE
;
223 if (mt
== SSL3_MT_CERTIFICATE_VERIFY
) {
224 st
->hand_state
= TLS_ST_SR_CERT_VRFY
;
230 case TLS_ST_SR_CERT_VRFY
:
231 if (mt
== SSL3_MT_CHANGE_CIPHER_SPEC
) {
232 st
->hand_state
= TLS_ST_SR_CHANGE
;
237 case TLS_ST_SR_CHANGE
:
238 #ifndef OPENSSL_NO_NEXTPROTONEG
239 if (s
->s3
->npn_seen
) {
240 if (mt
== SSL3_MT_NEXT_PROTO
) {
241 st
->hand_state
= TLS_ST_SR_NEXT_PROTO
;
246 if (mt
== SSL3_MT_FINISHED
) {
247 st
->hand_state
= TLS_ST_SR_FINISHED
;
250 #ifndef OPENSSL_NO_NEXTPROTONEG
255 #ifndef OPENSSL_NO_NEXTPROTONEG
256 case TLS_ST_SR_NEXT_PROTO
:
257 if (mt
== SSL3_MT_FINISHED
) {
258 st
->hand_state
= TLS_ST_SR_FINISHED
;
264 case TLS_ST_SW_FINISHED
:
265 if (mt
== SSL3_MT_CHANGE_CIPHER_SPEC
) {
266 st
->hand_state
= TLS_ST_SR_CHANGE
;
273 /* No valid transition found */
274 ssl3_send_alert(s
, SSL3_AL_FATAL
, SSL3_AD_UNEXPECTED_MESSAGE
);
275 SSLerr(SSL_F_OSSL_STATEM_SERVER_READ_TRANSITION
, SSL_R_UNEXPECTED_MESSAGE
);
280 * Should we send a ServerKeyExchange message?
282 * Valid return values are:
286 static int send_server_key_exchange(SSL
*s
)
288 unsigned long alg_k
= s
->s3
->tmp
.new_cipher
->algorithm_mkey
;
291 * only send a ServerKeyExchange if DH or fortezza but we have a
292 * sign only certificate PSK: may send PSK identity hints For
293 * ECC ciphersuites, we send a serverKeyExchange message only if
294 * the cipher suite is either ECDH-anon or ECDHE. In other cases,
295 * the server certificate contains the server's public key for
298 if (alg_k
& (SSL_kDHE
| SSL_kECDHE
)
300 * PSK: send ServerKeyExchange if PSK identity hint if
303 #ifndef OPENSSL_NO_PSK
304 /* Only send SKE if we have identity hint for plain PSK */
305 || ((alg_k
& (SSL_kPSK
| SSL_kRSAPSK
))
306 && s
->cert
->psk_identity_hint
)
307 /* For other PSK always send SKE */
308 || (alg_k
& (SSL_PSK
& (SSL_kDHEPSK
| SSL_kECDHEPSK
)))
310 #ifndef OPENSSL_NO_SRP
311 /* SRP: send ServerKeyExchange */
312 || (alg_k
& SSL_kSRP
)
322 * Should we send a CertificateRequest message?
324 * Valid return values are:
328 static int send_certificate_request(SSL
*s
)
331 /* don't request cert unless asked for it: */
332 s
->verify_mode
& SSL_VERIFY_PEER
334 * if SSL_VERIFY_CLIENT_ONCE is set, don't request cert
335 * during re-negotiation:
337 && (s
->s3
->tmp
.finish_md_len
== 0 ||
338 !(s
->verify_mode
& SSL_VERIFY_CLIENT_ONCE
))
340 * never request cert in anonymous ciphersuites (see
341 * section "Certificate request" in SSL 3 drafts and in
344 && (!(s
->s3
->tmp
.new_cipher
->algorithm_auth
& SSL_aNULL
)
346 * ... except when the application insists on
347 * verification (against the specs, but statem_clnt.c accepts
350 || (s
->verify_mode
& SSL_VERIFY_FAIL_IF_NO_PEER_CERT
))
351 /* don't request certificate for SRP auth */
352 && !(s
->s3
->tmp
.new_cipher
->algorithm_auth
& SSL_aSRP
)
354 * With normal PSK Certificates and Certificate Requests
357 && !(s
->s3
->tmp
.new_cipher
->algorithm_auth
& SSL_aPSK
)) {
365 * ossl_statem_server13_write_transition() works out what handshake state to
366 * move to next when a TLSv1.3 server is writing messages to be sent to the
369 static WRITE_TRAN
ossl_statem_server13_write_transition(SSL
*s
)
371 OSSL_STATEM
*st
= &s
->statem
;
374 * No case for TLS_ST_BEFORE, because at that stage we have not negotiated
375 * TLSv1.3 yet, so that is handled by ossl_statem_server_write_transition()
378 switch (st
->hand_state
) {
380 /* Shouldn't happen */
381 return WRITE_TRAN_ERROR
;
384 if (s
->key_update
!= SSL_KEY_UPDATE_NONE
) {
385 st
->hand_state
= TLS_ST_SW_KEY_UPDATE
;
386 return WRITE_TRAN_CONTINUE
;
388 /* Try to read from the client instead */
389 return WRITE_TRAN_FINISHED
;
391 case TLS_ST_SR_CLNT_HELLO
:
392 if (s
->hello_retry_request
)
393 st
->hand_state
= TLS_ST_SW_HELLO_RETRY_REQUEST
;
395 st
->hand_state
= TLS_ST_SW_SRVR_HELLO
;
396 return WRITE_TRAN_CONTINUE
;
398 case TLS_ST_SW_HELLO_RETRY_REQUEST
:
399 st
->hand_state
= TLS_ST_EARLY_DATA
;
400 return WRITE_TRAN_CONTINUE
;
402 case TLS_ST_SW_SRVR_HELLO
:
403 st
->hand_state
= TLS_ST_SW_ENCRYPTED_EXTENSIONS
;
404 return WRITE_TRAN_CONTINUE
;
406 case TLS_ST_SW_ENCRYPTED_EXTENSIONS
:
408 st
->hand_state
= TLS_ST_SW_FINISHED
;
409 else if (send_certificate_request(s
))
410 st
->hand_state
= TLS_ST_SW_CERT_REQ
;
412 st
->hand_state
= TLS_ST_SW_CERT
;
414 return WRITE_TRAN_CONTINUE
;
416 case TLS_ST_SW_CERT_REQ
:
417 st
->hand_state
= TLS_ST_SW_CERT
;
418 return WRITE_TRAN_CONTINUE
;
421 st
->hand_state
= TLS_ST_SW_CERT_VRFY
;
422 return WRITE_TRAN_CONTINUE
;
424 case TLS_ST_SW_CERT_VRFY
:
425 st
->hand_state
= TLS_ST_SW_FINISHED
;
426 return WRITE_TRAN_CONTINUE
;
428 case TLS_ST_SW_FINISHED
:
429 st
->hand_state
= TLS_ST_EARLY_DATA
;
430 return WRITE_TRAN_CONTINUE
;
432 case TLS_ST_EARLY_DATA
:
433 return WRITE_TRAN_FINISHED
;
435 case TLS_ST_SR_FINISHED
:
437 * Technically we have finished the handshake at this point, but we're
438 * going to remain "in_init" for now and write out the session ticket
440 * TODO(TLS1.3): Perhaps we need to be able to control this behaviour
441 * and give the application the opportunity to delay sending the
444 st
->hand_state
= TLS_ST_SW_SESSION_TICKET
;
445 return WRITE_TRAN_CONTINUE
;
447 case TLS_ST_SR_KEY_UPDATE
:
448 if (s
->key_update
!= SSL_KEY_UPDATE_NONE
) {
449 st
->hand_state
= TLS_ST_SW_KEY_UPDATE
;
450 return WRITE_TRAN_CONTINUE
;
454 case TLS_ST_SW_KEY_UPDATE
:
455 case TLS_ST_SW_SESSION_TICKET
:
456 st
->hand_state
= TLS_ST_OK
;
457 return WRITE_TRAN_CONTINUE
;
462 * ossl_statem_server_write_transition() works out what handshake state to move
463 * to next when the server is writing messages to be sent to the client.
465 WRITE_TRAN
ossl_statem_server_write_transition(SSL
*s
)
467 OSSL_STATEM
*st
= &s
->statem
;
470 * Note that before the ClientHello we don't know what version we are going
471 * to negotiate yet, so we don't take this branch until later
475 return ossl_statem_server13_write_transition(s
);
477 switch (st
->hand_state
) {
479 /* Shouldn't happen */
480 return WRITE_TRAN_ERROR
;
483 if (st
->request_state
== TLS_ST_SW_HELLO_REQ
) {
484 /* We must be trying to renegotiate */
485 st
->hand_state
= TLS_ST_SW_HELLO_REQ
;
486 st
->request_state
= TLS_ST_BEFORE
;
487 return WRITE_TRAN_CONTINUE
;
489 /* Must be an incoming ClientHello */
490 if (!tls_setup_handshake(s
)) {
491 ossl_statem_set_error(s
);
492 return WRITE_TRAN_ERROR
;
497 /* Just go straight to trying to read from the client */
498 return WRITE_TRAN_FINISHED
;
500 case TLS_ST_SW_HELLO_REQ
:
501 st
->hand_state
= TLS_ST_OK
;
502 return WRITE_TRAN_CONTINUE
;
504 case TLS_ST_SR_CLNT_HELLO
:
505 if (SSL_IS_DTLS(s
) && !s
->d1
->cookie_verified
506 && (SSL_get_options(s
) & SSL_OP_COOKIE_EXCHANGE
))
507 st
->hand_state
= DTLS_ST_SW_HELLO_VERIFY_REQUEST
;
509 st
->hand_state
= TLS_ST_SW_SRVR_HELLO
;
510 return WRITE_TRAN_CONTINUE
;
512 case DTLS_ST_SW_HELLO_VERIFY_REQUEST
:
513 return WRITE_TRAN_FINISHED
;
515 case TLS_ST_SW_SRVR_HELLO
:
517 if (s
->ext
.ticket_expected
)
518 st
->hand_state
= TLS_ST_SW_SESSION_TICKET
;
520 st
->hand_state
= TLS_ST_SW_CHANGE
;
522 /* Check if it is anon DH or anon ECDH, */
523 /* normal PSK or SRP */
524 if (!(s
->s3
->tmp
.new_cipher
->algorithm_auth
&
525 (SSL_aNULL
| SSL_aSRP
| SSL_aPSK
))) {
526 st
->hand_state
= TLS_ST_SW_CERT
;
527 } else if (send_server_key_exchange(s
)) {
528 st
->hand_state
= TLS_ST_SW_KEY_EXCH
;
529 } else if (send_certificate_request(s
)) {
530 st
->hand_state
= TLS_ST_SW_CERT_REQ
;
532 st
->hand_state
= TLS_ST_SW_SRVR_DONE
;
535 return WRITE_TRAN_CONTINUE
;
538 if (s
->ext
.status_expected
) {
539 st
->hand_state
= TLS_ST_SW_CERT_STATUS
;
540 return WRITE_TRAN_CONTINUE
;
544 case TLS_ST_SW_CERT_STATUS
:
545 if (send_server_key_exchange(s
)) {
546 st
->hand_state
= TLS_ST_SW_KEY_EXCH
;
547 return WRITE_TRAN_CONTINUE
;
551 case TLS_ST_SW_KEY_EXCH
:
552 if (send_certificate_request(s
)) {
553 st
->hand_state
= TLS_ST_SW_CERT_REQ
;
554 return WRITE_TRAN_CONTINUE
;
558 case TLS_ST_SW_CERT_REQ
:
559 st
->hand_state
= TLS_ST_SW_SRVR_DONE
;
560 return WRITE_TRAN_CONTINUE
;
562 case TLS_ST_SW_SRVR_DONE
:
563 return WRITE_TRAN_FINISHED
;
565 case TLS_ST_SR_FINISHED
:
567 st
->hand_state
= TLS_ST_OK
;
568 return WRITE_TRAN_CONTINUE
;
569 } else if (s
->ext
.ticket_expected
) {
570 st
->hand_state
= TLS_ST_SW_SESSION_TICKET
;
572 st
->hand_state
= TLS_ST_SW_CHANGE
;
574 return WRITE_TRAN_CONTINUE
;
576 case TLS_ST_SW_SESSION_TICKET
:
577 st
->hand_state
= TLS_ST_SW_CHANGE
;
578 return WRITE_TRAN_CONTINUE
;
580 case TLS_ST_SW_CHANGE
:
581 st
->hand_state
= TLS_ST_SW_FINISHED
;
582 return WRITE_TRAN_CONTINUE
;
584 case TLS_ST_SW_FINISHED
:
586 return WRITE_TRAN_FINISHED
;
588 st
->hand_state
= TLS_ST_OK
;
589 return WRITE_TRAN_CONTINUE
;
594 * Perform any pre work that needs to be done prior to sending a message from
595 * the server to the client.
597 WORK_STATE
ossl_statem_server_pre_work(SSL
*s
, WORK_STATE wst
)
599 OSSL_STATEM
*st
= &s
->statem
;
601 switch (st
->hand_state
) {
603 /* No pre work to be done */
606 case TLS_ST_SW_HELLO_REQ
:
609 dtls1_clear_sent_buffer(s
);
612 case DTLS_ST_SW_HELLO_VERIFY_REQUEST
:
614 if (SSL_IS_DTLS(s
)) {
615 dtls1_clear_sent_buffer(s
);
616 /* We don't buffer this message so don't use the timer */
621 case TLS_ST_SW_SRVR_HELLO
:
622 if (SSL_IS_DTLS(s
)) {
624 * Messages we write from now on should be buffered and
625 * retransmitted if necessary, so we need to use the timer now
631 case TLS_ST_SW_SRVR_DONE
:
632 #ifndef OPENSSL_NO_SCTP
633 if (SSL_IS_DTLS(s
) && BIO_dgram_is_sctp(SSL_get_wbio(s
)))
634 return dtls_wait_for_dry(s
);
636 return WORK_FINISHED_CONTINUE
;
638 case TLS_ST_SW_SESSION_TICKET
:
639 if (SSL_IS_TLS13(s
)) {
641 * Actually this is the end of the handshake, but we're going
642 * straight into writing the session ticket out. So we finish off
643 * the handshake, but keep the various buffers active.
645 return tls_finish_handshake(s
, wst
, 0);
646 } if (SSL_IS_DTLS(s
)) {
648 * We're into the last flight. We don't retransmit the last flight
649 * unless we need to, so we don't use the timer
655 case TLS_ST_SW_CHANGE
:
656 s
->session
->cipher
= s
->s3
->tmp
.new_cipher
;
657 if (!s
->method
->ssl3_enc
->setup_key_block(s
)) {
658 ossl_statem_set_error(s
);
661 if (SSL_IS_DTLS(s
)) {
663 * We're into the last flight. We don't retransmit the last flight
664 * unless we need to, so we don't use the timer. This might have
665 * already been set to 0 if we sent a NewSessionTicket message,
666 * but we'll set it again here in case we didn't.
670 return WORK_FINISHED_CONTINUE
;
672 case TLS_ST_EARLY_DATA
:
673 if (s
->early_data_state
!= SSL_EARLY_DATA_ACCEPTING
)
674 return WORK_FINISHED_CONTINUE
;
678 return tls_finish_handshake(s
, wst
, 1);
681 return WORK_FINISHED_CONTINUE
;
685 * Perform any work that needs to be done after sending a message from the
686 * server to the client.
688 WORK_STATE
ossl_statem_server_post_work(SSL
*s
, WORK_STATE wst
)
690 OSSL_STATEM
*st
= &s
->statem
;
694 switch (st
->hand_state
) {
696 /* No post work to be done */
699 case TLS_ST_SW_HELLO_RETRY_REQUEST
:
700 if (statem_flush(s
) != 1)
704 case TLS_ST_SW_HELLO_REQ
:
705 if (statem_flush(s
) != 1)
707 if (!ssl3_init_finished_mac(s
)) {
708 ossl_statem_set_error(s
);
713 case DTLS_ST_SW_HELLO_VERIFY_REQUEST
:
714 if (statem_flush(s
) != 1)
716 /* HelloVerifyRequest resets Finished MAC */
717 if (s
->version
!= DTLS1_BAD_VER
&& !ssl3_init_finished_mac(s
)) {
718 ossl_statem_set_error(s
);
722 * The next message should be another ClientHello which we need to
723 * treat like it was the first packet
728 case TLS_ST_SW_SRVR_HELLO
:
729 #ifndef OPENSSL_NO_SCTP
730 if (SSL_IS_DTLS(s
) && s
->hit
) {
731 unsigned char sctpauthkey
[64];
732 char labelbuffer
[sizeof(DTLS1_SCTP_AUTH_LABEL
)];
735 * Add new shared key for SCTP-Auth, will be ignored if no
738 memcpy(labelbuffer
, DTLS1_SCTP_AUTH_LABEL
,
739 sizeof(DTLS1_SCTP_AUTH_LABEL
));
741 if (SSL_export_keying_material(s
, sctpauthkey
,
742 sizeof(sctpauthkey
), labelbuffer
,
743 sizeof(labelbuffer
), NULL
, 0,
745 ossl_statem_set_error(s
);
749 BIO_ctrl(SSL_get_wbio(s
), BIO_CTRL_DGRAM_SCTP_ADD_AUTH_KEY
,
750 sizeof(sctpauthkey
), sctpauthkey
);
754 * TODO(TLS1.3): This actually causes a problem. We don't yet know
755 * whether the next record we are going to receive is an unencrypted
756 * alert, or an encrypted handshake message. We're going to need
757 * something clever in the record layer for this.
759 if (SSL_IS_TLS13(s
)) {
760 if (!s
->method
->ssl3_enc
->setup_key_block(s
)
761 || !s
->method
->ssl3_enc
->change_cipher_state(s
,
762 SSL3_CC_HANDSHAKE
| SSL3_CHANGE_CIPHER_SERVER_WRITE
))
765 if (s
->ext
.early_data
!= SSL_EARLY_DATA_ACCEPTED
766 && !s
->method
->ssl3_enc
->change_cipher_state(s
,
767 SSL3_CC_HANDSHAKE
|SSL3_CHANGE_CIPHER_SERVER_READ
))
772 case TLS_ST_SW_CHANGE
:
773 #ifndef OPENSSL_NO_SCTP
774 if (SSL_IS_DTLS(s
) && !s
->hit
) {
776 * Change to new shared key of SCTP-Auth, will be ignored if
779 BIO_ctrl(SSL_get_wbio(s
), BIO_CTRL_DGRAM_SCTP_NEXT_AUTH_KEY
,
783 if (!s
->method
->ssl3_enc
->change_cipher_state(s
,
784 SSL3_CHANGE_CIPHER_SERVER_WRITE
))
786 ossl_statem_set_error(s
);
791 dtls1_reset_seq_numbers(s
, SSL3_CC_WRITE
);
794 case TLS_ST_SW_SRVR_DONE
:
795 if (statem_flush(s
) != 1)
799 case TLS_ST_SW_FINISHED
:
800 if (statem_flush(s
) != 1)
802 #ifndef OPENSSL_NO_SCTP
803 if (SSL_IS_DTLS(s
) && s
->hit
) {
805 * Change to new shared key of SCTP-Auth, will be ignored if
808 BIO_ctrl(SSL_get_wbio(s
), BIO_CTRL_DGRAM_SCTP_NEXT_AUTH_KEY
,
812 if (SSL_IS_TLS13(s
)) {
813 if (!s
->method
->ssl3_enc
->generate_master_secret(s
,
814 s
->master_secret
, s
->handshake_secret
, 0,
815 &s
->session
->master_key_length
)
816 || !s
->method
->ssl3_enc
->change_cipher_state(s
,
817 SSL3_CC_APPLICATION
| SSL3_CHANGE_CIPHER_SERVER_WRITE
))
822 case TLS_ST_SW_KEY_UPDATE
:
823 if (statem_flush(s
) != 1)
825 if (!tls13_update_key(s
, 1))
829 case TLS_ST_SW_SESSION_TICKET
:
830 if (SSL_IS_TLS13(s
) && statem_flush(s
) != 1)
835 return WORK_FINISHED_CONTINUE
;
839 * Get the message construction function and message type for sending from the
842 * Valid return values are:
846 int ossl_statem_server_construct_message(SSL
*s
, WPACKET
*pkt
,
847 confunc_f
*confunc
, int *mt
)
849 OSSL_STATEM
*st
= &s
->statem
;
851 switch (st
->hand_state
) {
853 /* Shouldn't happen */
856 case TLS_ST_SW_CHANGE
:
858 *confunc
= dtls_construct_change_cipher_spec
;
860 *confunc
= tls_construct_change_cipher_spec
;
861 *mt
= SSL3_MT_CHANGE_CIPHER_SPEC
;
864 case DTLS_ST_SW_HELLO_VERIFY_REQUEST
:
865 *confunc
= dtls_construct_hello_verify_request
;
866 *mt
= DTLS1_MT_HELLO_VERIFY_REQUEST
;
869 case TLS_ST_SW_HELLO_REQ
:
870 /* No construction function needed */
872 *mt
= SSL3_MT_HELLO_REQUEST
;
875 case TLS_ST_SW_SRVR_HELLO
:
876 *confunc
= tls_construct_server_hello
;
877 *mt
= SSL3_MT_SERVER_HELLO
;
881 *confunc
= tls_construct_server_certificate
;
882 *mt
= SSL3_MT_CERTIFICATE
;
885 case TLS_ST_SW_CERT_VRFY
:
886 *confunc
= tls_construct_cert_verify
;
887 *mt
= SSL3_MT_CERTIFICATE_VERIFY
;
891 case TLS_ST_SW_KEY_EXCH
:
892 *confunc
= tls_construct_server_key_exchange
;
893 *mt
= SSL3_MT_SERVER_KEY_EXCHANGE
;
896 case TLS_ST_SW_CERT_REQ
:
897 *confunc
= tls_construct_certificate_request
;
898 *mt
= SSL3_MT_CERTIFICATE_REQUEST
;
901 case TLS_ST_SW_SRVR_DONE
:
902 *confunc
= tls_construct_server_done
;
903 *mt
= SSL3_MT_SERVER_DONE
;
906 case TLS_ST_SW_SESSION_TICKET
:
907 *confunc
= tls_construct_new_session_ticket
;
908 *mt
= SSL3_MT_NEWSESSION_TICKET
;
911 case TLS_ST_SW_CERT_STATUS
:
912 *confunc
= tls_construct_cert_status
;
913 *mt
= SSL3_MT_CERTIFICATE_STATUS
;
916 case TLS_ST_SW_FINISHED
:
917 *confunc
= tls_construct_finished
;
918 *mt
= SSL3_MT_FINISHED
;
921 case TLS_ST_EARLY_DATA
:
926 case TLS_ST_SW_ENCRYPTED_EXTENSIONS
:
927 *confunc
= tls_construct_encrypted_extensions
;
928 *mt
= SSL3_MT_ENCRYPTED_EXTENSIONS
;
931 case TLS_ST_SW_HELLO_RETRY_REQUEST
:
932 *confunc
= tls_construct_hello_retry_request
;
933 *mt
= SSL3_MT_HELLO_RETRY_REQUEST
;
936 case TLS_ST_SW_KEY_UPDATE
:
937 *confunc
= tls_construct_key_update
;
938 *mt
= SSL3_MT_KEY_UPDATE
;
946 * Maximum size (excluding the Handshake header) of a ClientHello message,
947 * calculated as follows:
949 * 2 + # client_version
950 * 32 + # only valid length for random
951 * 1 + # length of session_id
952 * 32 + # maximum size for session_id
953 * 2 + # length of cipher suites
954 * 2^16-2 + # maximum length of cipher suites array
955 * 1 + # length of compression_methods
956 * 2^8-1 + # maximum length of compression methods
957 * 2 + # length of extensions
958 * 2^16-1 # maximum length of extensions
960 #define CLIENT_HELLO_MAX_LENGTH 131396
962 #define CLIENT_KEY_EXCH_MAX_LENGTH 2048
963 #define NEXT_PROTO_MAX_LENGTH 514
966 * Returns the maximum allowed length for the current message that we are
967 * reading. Excludes the message header.
969 size_t ossl_statem_server_max_message_size(SSL
*s
)
971 OSSL_STATEM
*st
= &s
->statem
;
973 switch (st
->hand_state
) {
975 /* Shouldn't happen */
978 case TLS_ST_SR_CLNT_HELLO
:
979 return CLIENT_HELLO_MAX_LENGTH
;
981 case TLS_ST_SR_END_OF_EARLY_DATA
:
982 return END_OF_EARLY_DATA_MAX_LENGTH
;
985 return s
->max_cert_list
;
987 case TLS_ST_SR_KEY_EXCH
:
988 return CLIENT_KEY_EXCH_MAX_LENGTH
;
990 case TLS_ST_SR_CERT_VRFY
:
991 return SSL3_RT_MAX_PLAIN_LENGTH
;
993 #ifndef OPENSSL_NO_NEXTPROTONEG
994 case TLS_ST_SR_NEXT_PROTO
:
995 return NEXT_PROTO_MAX_LENGTH
;
998 case TLS_ST_SR_CHANGE
:
999 return CCS_MAX_LENGTH
;
1001 case TLS_ST_SR_FINISHED
:
1002 return FINISHED_MAX_LENGTH
;
1004 case TLS_ST_SR_KEY_UPDATE
:
1005 return KEY_UPDATE_MAX_LENGTH
;
1010 * Process a message that the server has received from the client.
1012 MSG_PROCESS_RETURN
ossl_statem_server_process_message(SSL
*s
, PACKET
*pkt
)
1014 OSSL_STATEM
*st
= &s
->statem
;
1016 switch (st
->hand_state
) {
1018 /* Shouldn't happen */
1019 return MSG_PROCESS_ERROR
;
1021 case TLS_ST_SR_CLNT_HELLO
:
1022 return tls_process_client_hello(s
, pkt
);
1024 case TLS_ST_SR_END_OF_EARLY_DATA
:
1025 return tls_process_end_of_early_data(s
, pkt
);
1027 case TLS_ST_SR_CERT
:
1028 return tls_process_client_certificate(s
, pkt
);
1030 case TLS_ST_SR_KEY_EXCH
:
1031 return tls_process_client_key_exchange(s
, pkt
);
1033 case TLS_ST_SR_CERT_VRFY
:
1034 return tls_process_cert_verify(s
, pkt
);
1036 #ifndef OPENSSL_NO_NEXTPROTONEG
1037 case TLS_ST_SR_NEXT_PROTO
:
1038 return tls_process_next_proto(s
, pkt
);
1041 case TLS_ST_SR_CHANGE
:
1042 return tls_process_change_cipher_spec(s
, pkt
);
1044 case TLS_ST_SR_FINISHED
:
1045 return tls_process_finished(s
, pkt
);
1047 case TLS_ST_SR_KEY_UPDATE
:
1048 return tls_process_key_update(s
, pkt
);
1054 * Perform any further processing required following the receipt of a message
1057 WORK_STATE
ossl_statem_server_post_process_message(SSL
*s
, WORK_STATE wst
)
1059 OSSL_STATEM
*st
= &s
->statem
;
1061 switch (st
->hand_state
) {
1063 /* Shouldn't happen */
1066 case TLS_ST_SR_CLNT_HELLO
:
1067 return tls_post_process_client_hello(s
, wst
);
1069 case TLS_ST_SR_KEY_EXCH
:
1070 return tls_post_process_client_key_exchange(s
, wst
);
1072 return WORK_FINISHED_CONTINUE
;
1075 #ifndef OPENSSL_NO_SRP
1076 static int ssl_check_srp_ext_ClientHello(SSL
*s
, int *al
)
1078 int ret
= SSL_ERROR_NONE
;
1080 *al
= SSL_AD_UNRECOGNIZED_NAME
;
1082 if ((s
->s3
->tmp
.new_cipher
->algorithm_mkey
& SSL_kSRP
) &&
1083 (s
->srp_ctx
.TLS_ext_srp_username_callback
!= NULL
)) {
1084 if (s
->srp_ctx
.login
== NULL
) {
1086 * RFC 5054 says SHOULD reject, we do so if There is no srp
1089 ret
= SSL3_AL_FATAL
;
1090 *al
= SSL_AD_UNKNOWN_PSK_IDENTITY
;
1092 ret
= SSL_srp_server_param_with_username(s
, al
);
1099 int dtls_raw_hello_verify_request(WPACKET
*pkt
, unsigned char *cookie
,
1102 /* Always use DTLS 1.0 version: see RFC 6347 */
1103 if (!WPACKET_put_bytes_u16(pkt
, DTLS1_VERSION
)
1104 || !WPACKET_sub_memcpy_u8(pkt
, cookie
, cookie_len
))
1110 int dtls_construct_hello_verify_request(SSL
*s
, WPACKET
*pkt
)
1112 unsigned int cookie_leni
;
1113 if (s
->ctx
->app_gen_cookie_cb
== NULL
||
1114 s
->ctx
->app_gen_cookie_cb(s
, s
->d1
->cookie
,
1115 &cookie_leni
) == 0 ||
1116 cookie_leni
> 255) {
1117 SSLerr(SSL_F_DTLS_CONSTRUCT_HELLO_VERIFY_REQUEST
,
1118 SSL_R_COOKIE_GEN_CALLBACK_FAILURE
);
1121 s
->d1
->cookie_len
= cookie_leni
;
1123 if (!dtls_raw_hello_verify_request(pkt
, s
->d1
->cookie
,
1124 s
->d1
->cookie_len
)) {
1125 SSLerr(SSL_F_DTLS_CONSTRUCT_HELLO_VERIFY_REQUEST
, ERR_R_INTERNAL_ERROR
);
1132 #ifndef OPENSSL_NO_EC
1134 * ssl_check_for_safari attempts to fingerprint Safari using OS X
1135 * SecureTransport using the TLS extension block in |hello|.
1136 * Safari, since 10.6, sends exactly these extensions, in this order:
1140 * signature_algorithms (for TLSv1.2 only)
1142 * We wish to fingerprint Safari because they broke ECDHE-ECDSA support in 10.8,
1143 * but they advertise support. So enabling ECDHE-ECDSA ciphers breaks them.
1144 * Sadly we cannot differentiate 10.6, 10.7 and 10.8.4 (which work), from
1145 * 10.8..10.8.3 (which don't work).
1147 static void ssl_check_for_safari(SSL
*s
, const CLIENTHELLO_MSG
*hello
)
1149 static const unsigned char kSafariExtensionsBlock
[] = {
1150 0x00, 0x0a, /* elliptic_curves extension */
1151 0x00, 0x08, /* 8 bytes */
1152 0x00, 0x06, /* 6 bytes of curve ids */
1153 0x00, 0x17, /* P-256 */
1154 0x00, 0x18, /* P-384 */
1155 0x00, 0x19, /* P-521 */
1157 0x00, 0x0b, /* ec_point_formats */
1158 0x00, 0x02, /* 2 bytes */
1159 0x01, /* 1 point format */
1160 0x00, /* uncompressed */
1161 /* The following is only present in TLS 1.2 */
1162 0x00, 0x0d, /* signature_algorithms */
1163 0x00, 0x0c, /* 12 bytes */
1164 0x00, 0x0a, /* 10 bytes */
1165 0x05, 0x01, /* SHA-384/RSA */
1166 0x04, 0x01, /* SHA-256/RSA */
1167 0x02, 0x01, /* SHA-1/RSA */
1168 0x04, 0x03, /* SHA-256/ECDSA */
1169 0x02, 0x03, /* SHA-1/ECDSA */
1171 /* Length of the common prefix (first two extensions). */
1172 static const size_t kSafariCommonExtensionsLength
= 18;
1177 tmppkt
= hello
->extensions
;
1179 if (!PACKET_forward(&tmppkt
, 2)
1180 || !PACKET_get_net_2(&tmppkt
, &type
)
1181 || !PACKET_get_length_prefixed_2(&tmppkt
, &sni
)) {
1185 if (type
!= TLSEXT_TYPE_server_name
)
1188 ext_len
= TLS1_get_client_version(s
) >= TLS1_2_VERSION
?
1189 sizeof(kSafariExtensionsBlock
) : kSafariCommonExtensionsLength
;
1191 s
->s3
->is_probably_safari
= PACKET_equal(&tmppkt
, kSafariExtensionsBlock
,
1194 #endif /* !OPENSSL_NO_EC */
1196 MSG_PROCESS_RETURN
tls_process_client_hello(SSL
*s
, PACKET
*pkt
)
1198 int al
= SSL_AD_INTERNAL_ERROR
;
1199 /* |cookie| will only be initialized for DTLS. */
1200 PACKET session_id
, compression
, extensions
, cookie
;
1201 static const unsigned char null_compression
= 0;
1202 CLIENTHELLO_MSG
*clienthello
;
1204 clienthello
= OPENSSL_zalloc(sizeof(*clienthello
));
1205 if (clienthello
== NULL
) {
1206 SSLerr(SSL_F_TLS_PROCESS_CLIENT_HELLO
, ERR_R_INTERNAL_ERROR
);
1209 /* Check if this is actually an unexpected renegotiation ClientHello */
1210 if (s
->renegotiate
== 0 && !SSL_IS_FIRST_HANDSHAKE(s
)) {
1211 if ((s
->options
& SSL_OP_NO_RENEGOTIATION
)) {
1212 ssl3_send_alert(s
, SSL3_AL_WARNING
, SSL_AD_NO_RENEGOTIATION
);
1220 * First, parse the raw ClientHello data into the CLIENTHELLO_MSG structure.
1222 clienthello
->isv2
= RECORD_LAYER_is_sslv2_record(&s
->rlayer
);
1223 PACKET_null_init(&cookie
);
1225 if (clienthello
->isv2
) {
1228 if (!SSL_IS_FIRST_HANDSHAKE(s
) || s
->hello_retry_request
) {
1229 al
= SSL_AD_UNEXPECTED_MESSAGE
;
1230 SSLerr(SSL_F_TLS_PROCESS_CLIENT_HELLO
, SSL_R_UNEXPECTED_MESSAGE
);
1235 * An SSLv3/TLSv1 backwards-compatible CLIENT-HELLO in an SSLv2
1236 * header is sent directly on the wire, not wrapped as a TLS
1237 * record. Our record layer just processes the message length and passes
1238 * the rest right through. Its format is:
1240 * 0-1 msg_length - decoded by the record layer
1241 * 2 msg_type - s->init_msg points here
1243 * 5-6 cipher_spec_length
1244 * 7-8 session_id_length
1245 * 9-10 challenge_length
1249 if (!PACKET_get_1(pkt
, &mt
)
1250 || mt
!= SSL2_MT_CLIENT_HELLO
) {
1252 * Should never happen. We should have tested this in the record
1253 * layer in order to have determined that this is a SSLv2 record
1254 * in the first place
1256 SSLerr(SSL_F_TLS_PROCESS_CLIENT_HELLO
, ERR_R_INTERNAL_ERROR
);
1261 if (!PACKET_get_net_2(pkt
, &clienthello
->legacy_version
)) {
1262 al
= SSL_AD_DECODE_ERROR
;
1263 SSLerr(SSL_F_TLS_PROCESS_CLIENT_HELLO
, SSL_R_LENGTH_TOO_SHORT
);
1267 /* Parse the message and load client random. */
1268 if (clienthello
->isv2
) {
1270 * Handle an SSLv2 backwards compatible ClientHello
1271 * Note, this is only for SSLv3+ using the backward compatible format.
1272 * Real SSLv2 is not supported, and is rejected below.
1274 unsigned int ciphersuite_len
, session_id_len
, challenge_len
;
1277 if (!PACKET_get_net_2(pkt
, &ciphersuite_len
)
1278 || !PACKET_get_net_2(pkt
, &session_id_len
)
1279 || !PACKET_get_net_2(pkt
, &challenge_len
)) {
1280 SSLerr(SSL_F_TLS_PROCESS_CLIENT_HELLO
,
1281 SSL_R_RECORD_LENGTH_MISMATCH
);
1282 al
= SSL_AD_DECODE_ERROR
;
1286 if (session_id_len
> SSL_MAX_SSL_SESSION_ID_LENGTH
) {
1287 al
= SSL_AD_ILLEGAL_PARAMETER
;
1288 SSLerr(SSL_F_TLS_PROCESS_CLIENT_HELLO
, SSL_R_LENGTH_MISMATCH
);
1292 if (!PACKET_get_sub_packet(pkt
, &clienthello
->ciphersuites
,
1294 || !PACKET_copy_bytes(pkt
, clienthello
->session_id
, session_id_len
)
1295 || !PACKET_get_sub_packet(pkt
, &challenge
, challenge_len
)
1296 /* No extensions. */
1297 || PACKET_remaining(pkt
) != 0) {
1298 SSLerr(SSL_F_TLS_PROCESS_CLIENT_HELLO
,
1299 SSL_R_RECORD_LENGTH_MISMATCH
);
1300 al
= SSL_AD_DECODE_ERROR
;
1303 clienthello
->session_id_len
= session_id_len
;
1305 /* Load the client random and compression list. We use SSL3_RANDOM_SIZE
1306 * here rather than sizeof(clienthello->random) because that is the limit
1307 * for SSLv3 and it is fixed. It won't change even if
1308 * sizeof(clienthello->random) does.
1310 challenge_len
= challenge_len
> SSL3_RANDOM_SIZE
1311 ? SSL3_RANDOM_SIZE
: challenge_len
;
1312 memset(clienthello
->random
, 0, SSL3_RANDOM_SIZE
);
1313 if (!PACKET_copy_bytes(&challenge
,
1314 clienthello
->random
+ SSL3_RANDOM_SIZE
-
1315 challenge_len
, challenge_len
)
1316 /* Advertise only null compression. */
1317 || !PACKET_buf_init(&compression
, &null_compression
, 1)) {
1318 SSLerr(SSL_F_TLS_PROCESS_CLIENT_HELLO
, ERR_R_INTERNAL_ERROR
);
1319 al
= SSL_AD_INTERNAL_ERROR
;
1323 PACKET_null_init(&clienthello
->extensions
);
1325 /* Regular ClientHello. */
1326 if (!PACKET_copy_bytes(pkt
, clienthello
->random
, SSL3_RANDOM_SIZE
)
1327 || !PACKET_get_length_prefixed_1(pkt
, &session_id
)
1328 || !PACKET_copy_all(&session_id
, clienthello
->session_id
,
1329 SSL_MAX_SSL_SESSION_ID_LENGTH
,
1330 &clienthello
->session_id_len
)) {
1331 al
= SSL_AD_DECODE_ERROR
;
1332 SSLerr(SSL_F_TLS_PROCESS_CLIENT_HELLO
, SSL_R_LENGTH_MISMATCH
);
1336 if (SSL_IS_DTLS(s
)) {
1337 if (!PACKET_get_length_prefixed_1(pkt
, &cookie
)) {
1338 al
= SSL_AD_DECODE_ERROR
;
1339 SSLerr(SSL_F_TLS_PROCESS_CLIENT_HELLO
, SSL_R_LENGTH_MISMATCH
);
1342 if (!PACKET_copy_all(&cookie
, clienthello
->dtls_cookie
,
1343 DTLS1_COOKIE_LENGTH
,
1344 &clienthello
->dtls_cookie_len
)) {
1345 al
= SSL_AD_INTERNAL_ERROR
;
1346 SSLerr(SSL_F_TLS_PROCESS_CLIENT_HELLO
, ERR_R_INTERNAL_ERROR
);
1350 * If we require cookies and this ClientHello doesn't contain one,
1351 * just return since we do not want to allocate any memory yet.
1352 * So check cookie length...
1354 if (SSL_get_options(s
) & SSL_OP_COOKIE_EXCHANGE
) {
1355 if (clienthello
->dtls_cookie_len
== 0)
1356 return MSG_PROCESS_FINISHED_READING
;
1360 if (!PACKET_get_length_prefixed_2(pkt
, &clienthello
->ciphersuites
)) {
1361 al
= SSL_AD_DECODE_ERROR
;
1362 SSLerr(SSL_F_TLS_PROCESS_CLIENT_HELLO
, SSL_R_LENGTH_MISMATCH
);
1366 if (!PACKET_get_length_prefixed_1(pkt
, &compression
)) {
1367 al
= SSL_AD_DECODE_ERROR
;
1368 SSLerr(SSL_F_TLS_PROCESS_CLIENT_HELLO
, SSL_R_LENGTH_MISMATCH
);
1372 /* Could be empty. */
1373 if (PACKET_remaining(pkt
) == 0) {
1374 PACKET_null_init(&clienthello
->extensions
);
1376 if (!PACKET_get_length_prefixed_2(pkt
, &clienthello
->extensions
)
1377 || PACKET_remaining(pkt
) != 0) {
1378 al
= SSL_AD_DECODE_ERROR
;
1379 SSLerr(SSL_F_TLS_PROCESS_CLIENT_HELLO
, SSL_R_LENGTH_MISMATCH
);
1385 if (!PACKET_copy_all(&compression
, clienthello
->compressions
,
1386 MAX_COMPRESSIONS_SIZE
,
1387 &clienthello
->compressions_len
)) {
1388 al
= SSL_AD_INTERNAL_ERROR
;
1389 SSLerr(SSL_F_TLS_PROCESS_CLIENT_HELLO
, ERR_R_INTERNAL_ERROR
);
1393 /* Preserve the raw extensions PACKET for later use */
1394 extensions
= clienthello
->extensions
;
1395 if (!tls_collect_extensions(s
, &extensions
, SSL_EXT_CLIENT_HELLO
,
1396 &clienthello
->pre_proc_exts
, &al
,
1397 &clienthello
->pre_proc_exts_len
, 1)) {
1398 /* SSLerr already been called */
1401 s
->clienthello
= clienthello
;
1403 return MSG_PROCESS_CONTINUE_PROCESSING
;
1405 ssl3_send_alert(s
, SSL3_AL_FATAL
, al
);
1407 ossl_statem_set_error(s
);
1409 if (clienthello
!= NULL
)
1410 OPENSSL_free(clienthello
->pre_proc_exts
);
1411 OPENSSL_free(clienthello
);
1413 return MSG_PROCESS_ERROR
;
1416 static int tls_early_post_process_client_hello(SSL
*s
, int *pal
)
1419 int i
, al
= SSL_AD_INTERNAL_ERROR
;
1423 #ifndef OPENSSL_NO_COMP
1424 SSL_COMP
*comp
= NULL
;
1426 const SSL_CIPHER
*c
;
1427 STACK_OF(SSL_CIPHER
) *ciphers
= NULL
;
1428 STACK_OF(SSL_CIPHER
) *scsvs
= NULL
;
1429 CLIENTHELLO_MSG
*clienthello
= s
->clienthello
;
1430 DOWNGRADE dgrd
= DOWNGRADE_NONE
;
1432 /* Finished parsing the ClientHello, now we can start processing it */
1433 /* Give the ClientHello callback a crack at things */
1434 if (s
->ctx
->client_hello_cb
!= NULL
) {
1435 /* A failure in the ClientHello callback terminates the connection. */
1436 switch (s
->ctx
->client_hello_cb(s
, &al
, s
->ctx
->client_hello_cb_arg
)) {
1437 case SSL_CLIENT_HELLO_SUCCESS
:
1439 case SSL_CLIENT_HELLO_RETRY
:
1440 s
->rwstate
= SSL_CLIENT_HELLO_CB
;
1442 case SSL_CLIENT_HELLO_ERROR
:
1448 /* Set up the client_random */
1449 memcpy(s
->s3
->client_random
, clienthello
->random
, SSL3_RANDOM_SIZE
);
1451 /* Choose the version */
1453 if (clienthello
->isv2
) {
1454 if (clienthello
->legacy_version
== SSL2_VERSION
1455 || (clienthello
->legacy_version
& 0xff00)
1456 != (SSL3_VERSION_MAJOR
<< 8)) {
1458 * This is real SSLv2 or something complete unknown. We don't
1461 SSLerr(SSL_F_TLS_EARLY_POST_PROCESS_CLIENT_HELLO
, SSL_R_UNKNOWN_PROTOCOL
);
1465 s
->client_version
= clienthello
->legacy_version
;
1468 * Do SSL/TLS version negotiation if applicable. For DTLS we just check
1469 * versions are potentially compatible. Version negotiation comes later.
1471 if (!SSL_IS_DTLS(s
)) {
1472 protverr
= ssl_choose_server_version(s
, clienthello
, &dgrd
);
1473 } else if (s
->method
->version
!= DTLS_ANY_VERSION
&&
1474 DTLS_VERSION_LT((int)clienthello
->legacy_version
, s
->version
)) {
1475 protverr
= SSL_R_VERSION_TOO_LOW
;
1481 SSLerr(SSL_F_TLS_EARLY_POST_PROCESS_CLIENT_HELLO
, protverr
);
1482 if (SSL_IS_FIRST_HANDSHAKE(s
)) {
1483 /* like ssl3_get_record, send alert using remote version number */
1484 s
->version
= s
->client_version
= clienthello
->legacy_version
;
1486 al
= SSL_AD_PROTOCOL_VERSION
;
1490 /* TLSv1.3 specifies that a ClientHello must end on a record boundary */
1491 if (SSL_IS_TLS13(s
) && RECORD_LAYER_processed_read_pending(&s
->rlayer
)) {
1492 al
= SSL_AD_UNEXPECTED_MESSAGE
;
1493 SSLerr(SSL_F_TLS_EARLY_POST_PROCESS_CLIENT_HELLO
,
1494 SSL_R_NOT_ON_RECORD_BOUNDARY
);
1498 if (SSL_IS_DTLS(s
)) {
1499 /* Empty cookie was already handled above by returning early. */
1500 if (SSL_get_options(s
) & SSL_OP_COOKIE_EXCHANGE
) {
1501 if (s
->ctx
->app_verify_cookie_cb
!= NULL
) {
1502 if (s
->ctx
->app_verify_cookie_cb(s
, clienthello
->dtls_cookie
,
1503 clienthello
->dtls_cookie_len
) == 0) {
1504 al
= SSL_AD_HANDSHAKE_FAILURE
;
1505 SSLerr(SSL_F_TLS_EARLY_POST_PROCESS_CLIENT_HELLO
,
1506 SSL_R_COOKIE_MISMATCH
);
1508 /* else cookie verification succeeded */
1510 /* default verification */
1511 } else if (s
->d1
->cookie_len
!= clienthello
->dtls_cookie_len
1512 || memcmp(clienthello
->dtls_cookie
, s
->d1
->cookie
,
1513 s
->d1
->cookie_len
) != 0) {
1514 al
= SSL_AD_HANDSHAKE_FAILURE
;
1515 SSLerr(SSL_F_TLS_EARLY_POST_PROCESS_CLIENT_HELLO
, SSL_R_COOKIE_MISMATCH
);
1518 s
->d1
->cookie_verified
= 1;
1520 if (s
->method
->version
== DTLS_ANY_VERSION
) {
1521 protverr
= ssl_choose_server_version(s
, clienthello
, &dgrd
);
1522 if (protverr
!= 0) {
1523 SSLerr(SSL_F_TLS_EARLY_POST_PROCESS_CLIENT_HELLO
, protverr
);
1524 s
->version
= s
->client_version
;
1525 al
= SSL_AD_PROTOCOL_VERSION
;
1533 if (!ssl_cache_cipherlist(s
, &clienthello
->ciphersuites
,
1534 clienthello
->isv2
, &al
) ||
1535 !bytes_to_cipher_list(s
, &clienthello
->ciphersuites
, &ciphers
, &scsvs
,
1536 clienthello
->isv2
, &al
)) {
1540 s
->s3
->send_connection_binding
= 0;
1541 /* Check what signalling cipher-suite values were received. */
1542 if (scsvs
!= NULL
) {
1543 for(i
= 0; i
< sk_SSL_CIPHER_num(scsvs
); i
++) {
1544 c
= sk_SSL_CIPHER_value(scsvs
, i
);
1545 if (SSL_CIPHER_get_id(c
) == SSL3_CK_SCSV
) {
1546 if (s
->renegotiate
) {
1547 /* SCSV is fatal if renegotiating */
1548 SSLerr(SSL_F_TLS_EARLY_POST_PROCESS_CLIENT_HELLO
,
1549 SSL_R_SCSV_RECEIVED_WHEN_RENEGOTIATING
);
1550 al
= SSL_AD_HANDSHAKE_FAILURE
;
1553 s
->s3
->send_connection_binding
= 1;
1554 } else if (SSL_CIPHER_get_id(c
) == SSL3_CK_FALLBACK_SCSV
&&
1555 !ssl_check_version_downgrade(s
)) {
1557 * This SCSV indicates that the client previously tried
1558 * a higher version. We should fail if the current version
1559 * is an unexpected downgrade, as that indicates that the first
1560 * connection may have been tampered with in order to trigger
1561 * an insecure downgrade.
1563 SSLerr(SSL_F_TLS_EARLY_POST_PROCESS_CLIENT_HELLO
,
1564 SSL_R_INAPPROPRIATE_FALLBACK
);
1565 al
= SSL_AD_INAPPROPRIATE_FALLBACK
;
1571 /* For TLSv1.3 we must select the ciphersuite *before* session resumption */
1572 if (SSL_IS_TLS13(s
)) {
1573 const SSL_CIPHER
*cipher
=
1574 ssl3_choose_cipher(s
, ciphers
, SSL_get_ciphers(s
));
1576 if (cipher
== NULL
) {
1577 SSLerr(SSL_F_TLS_EARLY_POST_PROCESS_CLIENT_HELLO
,
1578 SSL_R_NO_SHARED_CIPHER
);
1579 al
= SSL_AD_HANDSHAKE_FAILURE
;
1582 if (s
->hello_retry_request
1583 && (s
->s3
->tmp
.new_cipher
== NULL
1584 || s
->s3
->tmp
.new_cipher
->id
!= cipher
->id
)) {
1586 * A previous HRR picked a different ciphersuite to the one we
1587 * just selected. Something must have changed.
1589 al
= SSL_AD_ILLEGAL_PARAMETER
;
1590 SSLerr(SSL_F_TLS_EARLY_POST_PROCESS_CLIENT_HELLO
, SSL_R_BAD_CIPHER
);
1593 s
->s3
->tmp
.new_cipher
= cipher
;
1596 /* We need to do this before getting the session */
1597 if (!tls_parse_extension(s
, TLSEXT_IDX_extended_master_secret
,
1598 SSL_EXT_CLIENT_HELLO
,
1599 clienthello
->pre_proc_exts
, NULL
, 0, &al
)) {
1600 SSLerr(SSL_F_TLS_EARLY_POST_PROCESS_CLIENT_HELLO
, SSL_R_CLIENTHELLO_TLSEXT
);
1605 * We don't allow resumption in a backwards compatible ClientHello.
1606 * TODO(openssl-team): in TLS1.1+, session_id MUST be empty.
1608 * Versions before 0.9.7 always allow clients to resume sessions in
1609 * renegotiation. 0.9.7 and later allow this by default, but optionally
1610 * ignore resumption requests with flag
1611 * SSL_OP_NO_SESSION_RESUMPTION_ON_RENEGOTIATION (it's a new flag rather
1612 * than a change to default behavior so that applications relying on
1613 * this for security won't even compile against older library versions).
1614 * 1.0.1 and later also have a function SSL_renegotiate_abbreviated() to
1615 * request renegotiation but not a new session (s->new_session remains
1616 * unset): for servers, this essentially just means that the
1617 * SSL_OP_NO_SESSION_RESUMPTION_ON_RENEGOTIATION setting will be
1620 if (clienthello
->isv2
||
1622 (s
->options
& SSL_OP_NO_SESSION_RESUMPTION_ON_RENEGOTIATION
))) {
1623 if (!ssl_get_new_session(s
, 1))
1626 i
= ssl_get_prev_session(s
, clienthello
, &al
);
1628 /* previous session */
1630 } else if (i
== -1) {
1634 if (!ssl_get_new_session(s
, 1))
1640 * If it is a hit, check that the cipher is in the list. In TLSv1.3 we check
1641 * ciphersuite compatibility with the session as part of resumption.
1643 if (!SSL_IS_TLS13(s
) && s
->hit
) {
1645 id
= s
->session
->cipher
->id
;
1648 fprintf(stderr
, "client sent %d ciphers\n", sk_SSL_CIPHER_num(ciphers
));
1650 for (i
= 0; i
< sk_SSL_CIPHER_num(ciphers
); i
++) {
1651 c
= sk_SSL_CIPHER_value(ciphers
, i
);
1653 fprintf(stderr
, "client [%2d of %2d]:%s\n",
1654 i
, sk_SSL_CIPHER_num(ciphers
), SSL_CIPHER_get_name(c
));
1663 * we need to have the cipher in the cipher list if we are asked
1666 al
= SSL_AD_ILLEGAL_PARAMETER
;
1667 SSLerr(SSL_F_TLS_EARLY_POST_PROCESS_CLIENT_HELLO
,
1668 SSL_R_REQUIRED_CIPHER_MISSING
);
1673 for (loop
= 0; loop
< clienthello
->compressions_len
; loop
++) {
1674 if (clienthello
->compressions
[loop
] == 0)
1678 if (loop
>= clienthello
->compressions_len
) {
1680 al
= SSL_AD_DECODE_ERROR
;
1681 SSLerr(SSL_F_TLS_EARLY_POST_PROCESS_CLIENT_HELLO
, SSL_R_NO_COMPRESSION_SPECIFIED
);
1685 #ifndef OPENSSL_NO_EC
1686 if (s
->options
& SSL_OP_SAFARI_ECDHE_ECDSA_BUG
)
1687 ssl_check_for_safari(s
, clienthello
);
1688 #endif /* !OPENSSL_NO_EC */
1690 /* TLS extensions */
1691 if (!tls_parse_all_extensions(s
, SSL_EXT_CLIENT_HELLO
,
1692 clienthello
->pre_proc_exts
, NULL
, 0, &al
, 1)) {
1693 SSLerr(SSL_F_TLS_EARLY_POST_PROCESS_CLIENT_HELLO
, SSL_R_PARSE_TLSEXT
);
1698 * Check if we want to use external pre-shared secret for this handshake
1699 * for not reused session only. We need to generate server_random before
1700 * calling tls_session_secret_cb in order to allow SessionTicket
1701 * processing to use it in key derivation.
1705 pos
= s
->s3
->server_random
;
1706 if (ssl_fill_hello_random(s
, 1, pos
, SSL3_RANDOM_SIZE
, dgrd
) <= 0) {
1712 && s
->version
>= TLS1_VERSION
1715 && s
->ext
.session_secret_cb
) {
1716 const SSL_CIPHER
*pref_cipher
= NULL
;
1718 * s->session->master_key_length is a size_t, but this is an int for
1719 * backwards compat reasons
1721 int master_key_length
;
1723 master_key_length
= sizeof(s
->session
->master_key
);
1724 if (s
->ext
.session_secret_cb(s
, s
->session
->master_key
,
1725 &master_key_length
, ciphers
,
1727 s
->ext
.session_secret_cb_arg
)
1728 && master_key_length
> 0) {
1729 s
->session
->master_key_length
= master_key_length
;
1731 s
->session
->ciphers
= ciphers
;
1732 s
->session
->verify_result
= X509_V_OK
;
1736 /* check if some cipher was preferred by call back */
1737 if (pref_cipher
== NULL
)
1738 pref_cipher
= ssl3_choose_cipher(s
, s
->session
->ciphers
,
1739 SSL_get_ciphers(s
));
1740 if (pref_cipher
== NULL
) {
1741 al
= SSL_AD_HANDSHAKE_FAILURE
;
1742 SSLerr(SSL_F_TLS_EARLY_POST_PROCESS_CLIENT_HELLO
, SSL_R_NO_SHARED_CIPHER
);
1746 s
->session
->cipher
= pref_cipher
;
1747 sk_SSL_CIPHER_free(s
->cipher_list
);
1748 s
->cipher_list
= sk_SSL_CIPHER_dup(s
->session
->ciphers
);
1749 sk_SSL_CIPHER_free(s
->cipher_list_by_id
);
1750 s
->cipher_list_by_id
= sk_SSL_CIPHER_dup(s
->session
->ciphers
);
1755 * Worst case, we will use the NULL compression, but if we have other
1756 * options, we will now look for them. We have complen-1 compression
1757 * algorithms from the client, starting at q.
1759 s
->s3
->tmp
.new_compression
= NULL
;
1760 if (SSL_IS_TLS13(s
)) {
1762 * We already checked above that the NULL compression method appears in
1763 * the list. Now we check there aren't any others (which is illegal in
1764 * a TLSv1.3 ClientHello.
1766 if (clienthello
->compressions_len
!= 1) {
1767 al
= SSL_AD_ILLEGAL_PARAMETER
;
1768 SSLerr(SSL_F_TLS_EARLY_POST_PROCESS_CLIENT_HELLO
,
1769 SSL_R_INVALID_COMPRESSION_ALGORITHM
);
1773 #ifndef OPENSSL_NO_COMP
1774 /* This only happens if we have a cache hit */
1775 else if (s
->session
->compress_meth
!= 0) {
1776 int m
, comp_id
= s
->session
->compress_meth
;
1778 /* Perform sanity checks on resumed compression algorithm */
1779 /* Can't disable compression */
1780 if (!ssl_allow_compression(s
)) {
1781 SSLerr(SSL_F_TLS_EARLY_POST_PROCESS_CLIENT_HELLO
,
1782 SSL_R_INCONSISTENT_COMPRESSION
);
1785 /* Look for resumed compression method */
1786 for (m
= 0; m
< sk_SSL_COMP_num(s
->ctx
->comp_methods
); m
++) {
1787 comp
= sk_SSL_COMP_value(s
->ctx
->comp_methods
, m
);
1788 if (comp_id
== comp
->id
) {
1789 s
->s3
->tmp
.new_compression
= comp
;
1793 if (s
->s3
->tmp
.new_compression
== NULL
) {
1794 SSLerr(SSL_F_TLS_EARLY_POST_PROCESS_CLIENT_HELLO
,
1795 SSL_R_INVALID_COMPRESSION_ALGORITHM
);
1798 /* Look for resumed method in compression list */
1799 for (k
= 0; k
< clienthello
->compressions_len
; k
++) {
1800 if (clienthello
->compressions
[k
] == comp_id
)
1803 if (k
>= clienthello
->compressions_len
) {
1804 al
= SSL_AD_ILLEGAL_PARAMETER
;
1805 SSLerr(SSL_F_TLS_EARLY_POST_PROCESS_CLIENT_HELLO
,
1806 SSL_R_REQUIRED_COMPRESSION_ALGORITHM_MISSING
);
1809 } else if (s
->hit
) {
1811 } else if (ssl_allow_compression(s
) && s
->ctx
->comp_methods
) {
1812 /* See if we have a match */
1813 int m
, nn
, v
, done
= 0;
1816 nn
= sk_SSL_COMP_num(s
->ctx
->comp_methods
);
1817 for (m
= 0; m
< nn
; m
++) {
1818 comp
= sk_SSL_COMP_value(s
->ctx
->comp_methods
, m
);
1820 for (o
= 0; o
< clienthello
->compressions_len
; o
++) {
1821 if (v
== clienthello
->compressions
[o
]) {
1830 s
->s3
->tmp
.new_compression
= comp
;
1836 * If compression is disabled we'd better not try to resume a session
1837 * using compression.
1839 if (s
->session
->compress_meth
!= 0) {
1840 SSLerr(SSL_F_TLS_EARLY_POST_PROCESS_CLIENT_HELLO
, SSL_R_INCONSISTENT_COMPRESSION
);
1846 * Given s->session->ciphers and SSL_get_ciphers, we must pick a cipher
1849 if (!s
->hit
|| SSL_IS_TLS13(s
)) {
1850 sk_SSL_CIPHER_free(s
->session
->ciphers
);
1851 s
->session
->ciphers
= ciphers
;
1852 if (ciphers
== NULL
) {
1853 al
= SSL_AD_INTERNAL_ERROR
;
1854 SSLerr(SSL_F_TLS_EARLY_POST_PROCESS_CLIENT_HELLO
, ERR_R_INTERNAL_ERROR
);
1861 #ifdef OPENSSL_NO_COMP
1862 s
->session
->compress_meth
= 0;
1864 s
->session
->compress_meth
= (comp
== NULL
) ? 0 : comp
->id
;
1866 if (!tls1_set_server_sigalgs(s
)) {
1867 SSLerr(SSL_F_TLS_EARLY_POST_PROCESS_CLIENT_HELLO
, SSL_R_CLIENTHELLO_TLSEXT
);
1872 sk_SSL_CIPHER_free(ciphers
);
1873 sk_SSL_CIPHER_free(scsvs
);
1874 OPENSSL_free(clienthello
->pre_proc_exts
);
1875 OPENSSL_free(s
->clienthello
);
1876 s
->clienthello
= NULL
;
1879 ossl_statem_set_error(s
);
1882 sk_SSL_CIPHER_free(ciphers
);
1883 sk_SSL_CIPHER_free(scsvs
);
1884 OPENSSL_free(clienthello
->pre_proc_exts
);
1885 OPENSSL_free(s
->clienthello
);
1886 s
->clienthello
= NULL
;
1892 * Call the status request callback if needed. Upon success, returns 1.
1893 * Upon failure, returns 0 and sets |*al| to the appropriate fatal alert.
1895 static int tls_handle_status_request(SSL
*s
, int *al
)
1897 s
->ext
.status_expected
= 0;
1900 * If status request then ask callback what to do. Note: this must be
1901 * called after servername callbacks in case the certificate has changed,
1902 * and must be called after the cipher has been chosen because this may
1903 * influence which certificate is sent
1905 if (s
->ext
.status_type
!= TLSEXT_STATUSTYPE_nothing
&& s
->ctx
!= NULL
1906 && s
->ctx
->ext
.status_cb
!= NULL
) {
1909 /* If no certificate can't return certificate status */
1910 if (s
->s3
->tmp
.cert
!= NULL
) {
1912 * Set current certificate to one we will use so SSL_get_certificate
1913 * et al can pick it up.
1915 s
->cert
->key
= s
->s3
->tmp
.cert
;
1916 ret
= s
->ctx
->ext
.status_cb(s
, s
->ctx
->ext
.status_arg
);
1918 /* We don't want to send a status request response */
1919 case SSL_TLSEXT_ERR_NOACK
:
1920 s
->ext
.status_expected
= 0;
1922 /* status request response should be sent */
1923 case SSL_TLSEXT_ERR_OK
:
1924 if (s
->ext
.ocsp
.resp
)
1925 s
->ext
.status_expected
= 1;
1927 /* something bad happened */
1928 case SSL_TLSEXT_ERR_ALERT_FATAL
:
1930 *al
= SSL_AD_INTERNAL_ERROR
;
1940 * Call the alpn_select callback if needed. Upon success, returns 1.
1941 * Upon failure, returns 0 and sets |*al| to the appropriate fatal alert.
1943 int tls_handle_alpn(SSL
*s
, int *al
)
1945 const unsigned char *selected
= NULL
;
1946 unsigned char selected_len
= 0;
1948 if (s
->ctx
->ext
.alpn_select_cb
!= NULL
&& s
->s3
->alpn_proposed
!= NULL
) {
1949 int r
= s
->ctx
->ext
.alpn_select_cb(s
, &selected
, &selected_len
,
1950 s
->s3
->alpn_proposed
,
1951 (unsigned int)s
->s3
->alpn_proposed_len
,
1952 s
->ctx
->ext
.alpn_select_cb_arg
);
1954 if (r
== SSL_TLSEXT_ERR_OK
) {
1955 OPENSSL_free(s
->s3
->alpn_selected
);
1956 s
->s3
->alpn_selected
= OPENSSL_memdup(selected
, selected_len
);
1957 if (s
->s3
->alpn_selected
== NULL
) {
1958 *al
= SSL_AD_INTERNAL_ERROR
;
1961 s
->s3
->alpn_selected_len
= selected_len
;
1962 #ifndef OPENSSL_NO_NEXTPROTONEG
1963 /* ALPN takes precedence over NPN. */
1964 s
->s3
->npn_seen
= 0;
1967 /* Check ALPN is consistent with session */
1968 if (s
->session
->ext
.alpn_selected
== NULL
1969 || selected_len
!= s
->session
->ext
.alpn_selected_len
1970 || memcmp(selected
, s
->session
->ext
.alpn_selected
,
1971 selected_len
) != 0) {
1972 /* Not consistent so can't be used for early_data */
1973 s
->ext
.early_data_ok
= 0;
1976 /* If a new session update it with the new ALPN value */
1977 s
->session
->ext
.alpn_selected
= OPENSSL_memdup(selected
,
1979 if (s
->session
->ext
.alpn_selected
== NULL
) {
1980 *al
= SSL_AD_INTERNAL_ERROR
;
1983 s
->session
->ext
.alpn_selected_len
= selected_len
;
1988 } else if (r
!= SSL_TLSEXT_ERR_NOACK
) {
1989 *al
= SSL_AD_NO_APPLICATION_PROTOCOL
;
1993 * If r == SSL_TLSEXT_ERR_NOACK then behave as if no callback was
1998 /* Check ALPN is consistent with session */
1999 if (s
->session
->ext
.alpn_selected
!= NULL
) {
2000 /* Not consistent so can't be used for early_data */
2001 s
->ext
.early_data_ok
= 0;
2007 WORK_STATE
tls_post_process_client_hello(SSL
*s
, WORK_STATE wst
)
2009 int al
= SSL_AD_HANDSHAKE_FAILURE
;
2010 const SSL_CIPHER
*cipher
;
2012 if (wst
== WORK_MORE_A
) {
2013 int rv
= tls_early_post_process_client_hello(s
, &al
);
2015 /* SSLErr() was already called */
2022 if (wst
== WORK_MORE_B
) {
2023 if (!s
->hit
|| SSL_IS_TLS13(s
)) {
2024 /* Let cert callback update server certificates if required */
2025 if (!s
->hit
&& s
->cert
->cert_cb
!= NULL
) {
2026 int rv
= s
->cert
->cert_cb(s
, s
->cert
->cert_cb_arg
);
2028 al
= SSL_AD_INTERNAL_ERROR
;
2029 SSLerr(SSL_F_TLS_POST_PROCESS_CLIENT_HELLO
,
2030 SSL_R_CERT_CB_ERROR
);
2034 s
->rwstate
= SSL_X509_LOOKUP
;
2037 s
->rwstate
= SSL_NOTHING
;
2040 /* In TLSv1.3 we selected the ciphersuite before resumption */
2041 if (!SSL_IS_TLS13(s
)) {
2043 ssl3_choose_cipher(s
, s
->session
->ciphers
, SSL_get_ciphers(s
));
2045 if (cipher
== NULL
) {
2046 SSLerr(SSL_F_TLS_POST_PROCESS_CLIENT_HELLO
,
2047 SSL_R_NO_SHARED_CIPHER
);
2050 s
->s3
->tmp
.new_cipher
= cipher
;
2053 if (!tls_choose_sigalg(s
, &al
))
2055 /* check whether we should disable session resumption */
2056 if (s
->not_resumable_session_cb
!= NULL
)
2057 s
->session
->not_resumable
=
2058 s
->not_resumable_session_cb(s
,
2059 ((s
->s3
->tmp
.new_cipher
->algorithm_mkey
2060 & (SSL_kDHE
| SSL_kECDHE
)) != 0));
2061 if (s
->session
->not_resumable
)
2062 /* do not send a session ticket */
2063 s
->ext
.ticket_expected
= 0;
2066 /* Session-id reuse */
2067 s
->s3
->tmp
.new_cipher
= s
->session
->cipher
;
2071 * we now have the following setup.
2073 * cipher_list - our preferred list of ciphers
2074 * ciphers - the clients preferred list of ciphers
2075 * compression - basically ignored right now
2076 * ssl version is set - sslv3
2077 * s->session - The ssl session has been setup.
2078 * s->hit - session reuse flag
2079 * s->s3->tmp.new_cipher- the new cipher to use.
2083 * Call status_request callback if needed. Has to be done after the
2084 * certificate callbacks etc above.
2086 if (!tls_handle_status_request(s
, &al
)) {
2087 SSLerr(SSL_F_TLS_POST_PROCESS_CLIENT_HELLO
,
2088 SSL_R_CLIENTHELLO_TLSEXT
);
2092 * Call alpn_select callback if needed. Has to be done after SNI and
2093 * cipher negotiation (HTTP/2 restricts permitted ciphers). In TLSv1.3
2094 * we already did this because cipher negotiation happens earlier, and
2095 * we must handle ALPN before we decide whether to accept early_data.
2097 if (!SSL_IS_TLS13(s
) && !tls_handle_alpn(s
, &al
)) {
2098 SSLerr(SSL_F_TLS_POST_PROCESS_CLIENT_HELLO
,
2099 SSL_R_CLIENTHELLO_TLSEXT
);
2105 #ifndef OPENSSL_NO_SRP
2106 if (wst
== WORK_MORE_C
) {
2108 if ((ret
= ssl_check_srp_ext_ClientHello(s
, &al
)) < 0) {
2110 * callback indicates further work to be done
2112 s
->rwstate
= SSL_X509_LOOKUP
;
2115 if (ret
!= SSL_ERROR_NONE
) {
2117 * This is not really an error but the only means to for
2118 * a client to detect whether srp is supported.
2120 if (al
!= TLS1_AD_UNKNOWN_PSK_IDENTITY
)
2121 SSLerr(SSL_F_TLS_POST_PROCESS_CLIENT_HELLO
,
2122 SSL_R_CLIENTHELLO_TLSEXT
);
2124 SSLerr(SSL_F_TLS_POST_PROCESS_CLIENT_HELLO
,
2125 SSL_R_PSK_IDENTITY_NOT_FOUND
);
2131 return WORK_FINISHED_STOP
;
2133 ssl3_send_alert(s
, SSL3_AL_FATAL
, al
);
2134 ossl_statem_set_error(s
);
2138 int tls_construct_server_hello(SSL
*s
, WPACKET
*pkt
)
2140 int compm
, al
= SSL_AD_INTERNAL_ERROR
;
2144 /* TODO(TLS1.3): Remove the DRAFT conditional before release */
2145 version
= SSL_IS_TLS13(s
) ? TLS1_3_VERSION_DRAFT
: s
->version
;
2146 if (!WPACKET_put_bytes_u16(pkt
, version
)
2148 * Random stuff. Filling of the server_random takes place in
2149 * tls_process_client_hello()
2151 || !WPACKET_memcpy(pkt
, s
->s3
->server_random
, SSL3_RANDOM_SIZE
)) {
2152 SSLerr(SSL_F_TLS_CONSTRUCT_SERVER_HELLO
, ERR_R_INTERNAL_ERROR
);
2157 * There are several cases for the session ID to send
2158 * back in the server hello:
2159 * - For session reuse from the session cache,
2160 * we send back the old session ID.
2161 * - If stateless session reuse (using a session ticket)
2162 * is successful, we send back the client's "session ID"
2163 * (which doesn't actually identify the session).
2164 * - If it is a new session, we send back the new
2166 * - However, if we want the new session to be single-use,
2167 * we send back a 0-length session ID.
2168 * s->hit is non-zero in either case of session reuse,
2169 * so the following won't overwrite an ID that we're supposed
2172 if (s
->session
->not_resumable
||
2173 (!(s
->ctx
->session_cache_mode
& SSL_SESS_CACHE_SERVER
)
2175 s
->session
->session_id_length
= 0;
2177 sl
= s
->session
->session_id_length
;
2178 if (sl
> sizeof(s
->session
->session_id
)) {
2179 SSLerr(SSL_F_TLS_CONSTRUCT_SERVER_HELLO
, ERR_R_INTERNAL_ERROR
);
2183 /* set up the compression method */
2184 #ifdef OPENSSL_NO_COMP
2187 if (s
->s3
->tmp
.new_compression
== NULL
)
2190 compm
= s
->s3
->tmp
.new_compression
->id
;
2193 if ((!SSL_IS_TLS13(s
)
2194 && !WPACKET_sub_memcpy_u8(pkt
, s
->session
->session_id
, sl
))
2195 || !s
->method
->put_cipher_by_char(s
->s3
->tmp
.new_cipher
, pkt
, &len
)
2196 || (!SSL_IS_TLS13(s
)
2197 && !WPACKET_put_bytes_u8(pkt
, compm
))
2198 || !tls_construct_extensions(s
, pkt
,
2200 ? SSL_EXT_TLS1_3_SERVER_HELLO
2201 : SSL_EXT_TLS1_2_SERVER_HELLO
,
2203 SSLerr(SSL_F_TLS_CONSTRUCT_SERVER_HELLO
, ERR_R_INTERNAL_ERROR
);
2207 if (!(s
->verify_mode
& SSL_VERIFY_PEER
)
2208 && !ssl3_digest_cached_records(s
, 0)) {
2209 al
= SSL_AD_INTERNAL_ERROR
;
2215 ssl3_send_alert(s
, SSL3_AL_FATAL
, al
);
2219 int tls_construct_server_done(SSL
*s
, WPACKET
*pkt
)
2221 if (!s
->s3
->tmp
.cert_request
) {
2222 if (!ssl3_digest_cached_records(s
, 0)) {
2223 ssl3_send_alert(s
, SSL3_AL_FATAL
, SSL_AD_INTERNAL_ERROR
);
2230 int tls_construct_server_key_exchange(SSL
*s
, WPACKET
*pkt
)
2232 #ifndef OPENSSL_NO_DH
2233 EVP_PKEY
*pkdh
= NULL
;
2235 #ifndef OPENSSL_NO_EC
2236 unsigned char *encodedPoint
= NULL
;
2237 size_t encodedlen
= 0;
2240 const SIGALG_LOOKUP
*lu
= s
->s3
->tmp
.sigalg
;
2241 int al
= SSL_AD_INTERNAL_ERROR
, i
;
2244 EVP_MD_CTX
*md_ctx
= EVP_MD_CTX_new();
2245 EVP_PKEY_CTX
*pctx
= NULL
;
2246 size_t paramlen
, paramoffset
;
2248 if (!WPACKET_get_total_written(pkt
, ¶moffset
)) {
2249 SSLerr(SSL_F_TLS_CONSTRUCT_SERVER_KEY_EXCHANGE
, ERR_R_INTERNAL_ERROR
);
2253 if (md_ctx
== NULL
) {
2254 SSLerr(SSL_F_TLS_CONSTRUCT_SERVER_KEY_EXCHANGE
, ERR_R_MALLOC_FAILURE
);
2258 type
= s
->s3
->tmp
.new_cipher
->algorithm_mkey
;
2260 r
[0] = r
[1] = r
[2] = r
[3] = NULL
;
2261 #ifndef OPENSSL_NO_PSK
2262 /* Plain PSK or RSAPSK nothing to do */
2263 if (type
& (SSL_kPSK
| SSL_kRSAPSK
)) {
2265 #endif /* !OPENSSL_NO_PSK */
2266 #ifndef OPENSSL_NO_DH
2267 if (type
& (SSL_kDHE
| SSL_kDHEPSK
)) {
2268 CERT
*cert
= s
->cert
;
2270 EVP_PKEY
*pkdhp
= NULL
;
2273 if (s
->cert
->dh_tmp_auto
) {
2274 DH
*dhp
= ssl_get_auto_dh(s
);
2275 pkdh
= EVP_PKEY_new();
2276 if (pkdh
== NULL
|| dhp
== NULL
) {
2278 SSLerr(SSL_F_TLS_CONSTRUCT_SERVER_KEY_EXCHANGE
,
2279 ERR_R_INTERNAL_ERROR
);
2282 EVP_PKEY_assign_DH(pkdh
, dhp
);
2285 pkdhp
= cert
->dh_tmp
;
2287 if ((pkdhp
== NULL
) && (s
->cert
->dh_tmp_cb
!= NULL
)) {
2288 DH
*dhp
= s
->cert
->dh_tmp_cb(s
, 0, 1024);
2289 pkdh
= ssl_dh_to_pkey(dhp
);
2291 SSLerr(SSL_F_TLS_CONSTRUCT_SERVER_KEY_EXCHANGE
,
2292 ERR_R_INTERNAL_ERROR
);
2297 if (pkdhp
== NULL
) {
2298 al
= SSL_AD_INTERNAL_ERROR
;
2299 SSLerr(SSL_F_TLS_CONSTRUCT_SERVER_KEY_EXCHANGE
,
2300 SSL_R_MISSING_TMP_DH_KEY
);
2303 if (!ssl_security(s
, SSL_SECOP_TMP_DH
,
2304 EVP_PKEY_security_bits(pkdhp
), 0, pkdhp
)) {
2305 al
= SSL_AD_HANDSHAKE_FAILURE
;
2306 SSLerr(SSL_F_TLS_CONSTRUCT_SERVER_KEY_EXCHANGE
,
2307 SSL_R_DH_KEY_TOO_SMALL
);
2310 if (s
->s3
->tmp
.pkey
!= NULL
) {
2311 SSLerr(SSL_F_TLS_CONSTRUCT_SERVER_KEY_EXCHANGE
,
2312 ERR_R_INTERNAL_ERROR
);
2316 s
->s3
->tmp
.pkey
= ssl_generate_pkey(pkdhp
);
2318 if (s
->s3
->tmp
.pkey
== NULL
) {
2319 SSLerr(SSL_F_TLS_CONSTRUCT_SERVER_KEY_EXCHANGE
, ERR_R_EVP_LIB
);
2323 dh
= EVP_PKEY_get0_DH(s
->s3
->tmp
.pkey
);
2325 EVP_PKEY_free(pkdh
);
2328 DH_get0_pqg(dh
, &r
[0], NULL
, &r
[1]);
2329 DH_get0_key(dh
, &r
[2], NULL
);
2332 #ifndef OPENSSL_NO_EC
2333 if (type
& (SSL_kECDHE
| SSL_kECDHEPSK
)) {
2336 if (s
->s3
->tmp
.pkey
!= NULL
) {
2337 SSLerr(SSL_F_TLS_CONSTRUCT_SERVER_KEY_EXCHANGE
,
2338 ERR_R_INTERNAL_ERROR
);
2342 /* Get NID of appropriate shared curve */
2343 nid
= tls1_shared_group(s
, -2);
2344 curve_id
= tls1_ec_nid2curve_id(nid
);
2345 if (curve_id
== 0) {
2346 SSLerr(SSL_F_TLS_CONSTRUCT_SERVER_KEY_EXCHANGE
,
2347 SSL_R_UNSUPPORTED_ELLIPTIC_CURVE
);
2350 s
->s3
->tmp
.pkey
= ssl_generate_pkey_curve(curve_id
);
2351 /* Generate a new key for this curve */
2352 if (s
->s3
->tmp
.pkey
== NULL
) {
2353 SSLerr(SSL_F_TLS_CONSTRUCT_SERVER_KEY_EXCHANGE
, ERR_R_EVP_LIB
);
2357 /* Encode the public key. */
2358 encodedlen
= EVP_PKEY_get1_tls_encodedpoint(s
->s3
->tmp
.pkey
,
2360 if (encodedlen
== 0) {
2361 SSLerr(SSL_F_TLS_CONSTRUCT_SERVER_KEY_EXCHANGE
, ERR_R_EC_LIB
);
2366 * We'll generate the serverKeyExchange message explicitly so we
2367 * can set these to NULLs
2374 #endif /* !OPENSSL_NO_EC */
2375 #ifndef OPENSSL_NO_SRP
2376 if (type
& SSL_kSRP
) {
2377 if ((s
->srp_ctx
.N
== NULL
) ||
2378 (s
->srp_ctx
.g
== NULL
) ||
2379 (s
->srp_ctx
.s
== NULL
) || (s
->srp_ctx
.B
== NULL
)) {
2380 SSLerr(SSL_F_TLS_CONSTRUCT_SERVER_KEY_EXCHANGE
,
2381 SSL_R_MISSING_SRP_PARAM
);
2384 r
[0] = s
->srp_ctx
.N
;
2385 r
[1] = s
->srp_ctx
.g
;
2386 r
[2] = s
->srp_ctx
.s
;
2387 r
[3] = s
->srp_ctx
.B
;
2391 al
= SSL_AD_INTERNAL_ERROR
;
2392 SSLerr(SSL_F_TLS_CONSTRUCT_SERVER_KEY_EXCHANGE
,
2393 SSL_R_UNKNOWN_KEY_EXCHANGE_TYPE
);
2397 if (((s
->s3
->tmp
.new_cipher
->algorithm_auth
& (SSL_aNULL
| SSL_aSRP
)) != 0)
2398 || ((s
->s3
->tmp
.new_cipher
->algorithm_mkey
& SSL_PSK
)) != 0) {
2400 } else if (lu
== NULL
) {
2401 al
= SSL_AD_DECODE_ERROR
;
2405 #ifndef OPENSSL_NO_PSK
2406 if (type
& SSL_PSK
) {
2407 size_t len
= (s
->cert
->psk_identity_hint
== NULL
)
2408 ? 0 : strlen(s
->cert
->psk_identity_hint
);
2411 * It should not happen that len > PSK_MAX_IDENTITY_LEN - we already
2412 * checked this when we set the identity hint - but just in case
2414 if (len
> PSK_MAX_IDENTITY_LEN
2415 || !WPACKET_sub_memcpy_u16(pkt
, s
->cert
->psk_identity_hint
,
2417 SSLerr(SSL_F_TLS_CONSTRUCT_SERVER_KEY_EXCHANGE
,
2418 ERR_R_INTERNAL_ERROR
);
2424 for (i
= 0; i
< 4 && r
[i
] != NULL
; i
++) {
2425 unsigned char *binval
;
2428 #ifndef OPENSSL_NO_SRP
2429 if ((i
== 2) && (type
& SSL_kSRP
)) {
2430 res
= WPACKET_start_sub_packet_u8(pkt
);
2433 res
= WPACKET_start_sub_packet_u16(pkt
);
2436 SSLerr(SSL_F_TLS_CONSTRUCT_SERVER_KEY_EXCHANGE
,
2437 ERR_R_INTERNAL_ERROR
);
2441 #ifndef OPENSSL_NO_DH
2443 * for interoperability with some versions of the Microsoft TLS
2444 * stack, we need to zero pad the DHE pub key to the same length
2447 if ((i
== 2) && (type
& (SSL_kDHE
| SSL_kDHEPSK
))) {
2448 size_t len
= BN_num_bytes(r
[0]) - BN_num_bytes(r
[2]);
2451 if (!WPACKET_allocate_bytes(pkt
, len
, &binval
)) {
2452 SSLerr(SSL_F_TLS_CONSTRUCT_SERVER_KEY_EXCHANGE
,
2453 ERR_R_INTERNAL_ERROR
);
2456 memset(binval
, 0, len
);
2460 if (!WPACKET_allocate_bytes(pkt
, BN_num_bytes(r
[i
]), &binval
)
2461 || !WPACKET_close(pkt
)) {
2462 SSLerr(SSL_F_TLS_CONSTRUCT_SERVER_KEY_EXCHANGE
,
2463 ERR_R_INTERNAL_ERROR
);
2467 BN_bn2bin(r
[i
], binval
);
2470 #ifndef OPENSSL_NO_EC
2471 if (type
& (SSL_kECDHE
| SSL_kECDHEPSK
)) {
2473 * We only support named (not generic) curves. In this situation, the
2474 * ServerKeyExchange message has: [1 byte CurveType], [2 byte CurveName]
2475 * [1 byte length of encoded point], followed by the actual encoded
2478 if (!WPACKET_put_bytes_u8(pkt
, NAMED_CURVE_TYPE
)
2479 || !WPACKET_put_bytes_u8(pkt
, 0)
2480 || !WPACKET_put_bytes_u8(pkt
, curve_id
)
2481 || !WPACKET_sub_memcpy_u8(pkt
, encodedPoint
, encodedlen
)) {
2482 SSLerr(SSL_F_TLS_CONSTRUCT_SERVER_KEY_EXCHANGE
,
2483 ERR_R_INTERNAL_ERROR
);
2486 OPENSSL_free(encodedPoint
);
2487 encodedPoint
= NULL
;
2493 EVP_PKEY
*pkey
= s
->s3
->tmp
.cert
->privatekey
;
2495 unsigned char *sigbytes1
, *sigbytes2
, *tbs
;
2496 size_t siglen
, tbslen
;
2499 if (pkey
== NULL
|| !tls1_lookup_md(lu
, &md
)) {
2500 /* Should never happen */
2501 al
= SSL_AD_INTERNAL_ERROR
;
2502 SSLerr(SSL_F_TLS_CONSTRUCT_SERVER_KEY_EXCHANGE
,
2503 ERR_R_INTERNAL_ERROR
);
2507 * n is the length of the params, they start at &(d[4]) and p
2508 * points to the space at the end.
2511 /* Get length of the parameters we have written above */
2512 if (!WPACKET_get_length(pkt
, ¶mlen
)) {
2513 SSLerr(SSL_F_TLS_CONSTRUCT_SERVER_KEY_EXCHANGE
,
2514 ERR_R_INTERNAL_ERROR
);
2517 /* send signature algorithm */
2518 if (SSL_USE_SIGALGS(s
) && !WPACKET_put_bytes_u16(pkt
, lu
->sigalg
))
2521 * Create the signature. We don't know the actual length of the sig
2522 * until after we've created it, so we reserve enough bytes for it
2523 * up front, and then properly allocate them in the WPACKET
2526 siglen
= EVP_PKEY_size(pkey
);
2527 if (!WPACKET_sub_reserve_bytes_u16(pkt
, siglen
, &sigbytes1
)
2528 || EVP_DigestSignInit(md_ctx
, &pctx
, md
, NULL
, pkey
) <= 0) {
2529 SSLerr(SSL_F_TLS_CONSTRUCT_SERVER_KEY_EXCHANGE
,
2530 ERR_R_INTERNAL_ERROR
);
2533 if (lu
->sig
== EVP_PKEY_RSA_PSS
) {
2534 if (EVP_PKEY_CTX_set_rsa_padding(pctx
, RSA_PKCS1_PSS_PADDING
) <= 0
2535 || EVP_PKEY_CTX_set_rsa_pss_saltlen(pctx
, RSA_PSS_SALTLEN_DIGEST
) <= 0) {
2536 SSLerr(SSL_F_TLS_CONSTRUCT_SERVER_KEY_EXCHANGE
,
2541 tbslen
= construct_key_exchange_tbs(s
, &tbs
,
2542 s
->init_buf
->data
+ paramoffset
,
2545 SSLerr(SSL_F_TLS_CONSTRUCT_SERVER_KEY_EXCHANGE
,
2546 ERR_R_MALLOC_FAILURE
);
2549 rv
= EVP_DigestSign(md_ctx
, sigbytes1
, &siglen
, tbs
, tbslen
);
2551 if (rv
<= 0 || !WPACKET_sub_allocate_bytes_u16(pkt
, siglen
, &sigbytes2
)
2552 || sigbytes1
!= sigbytes2
) {
2553 SSLerr(SSL_F_TLS_CONSTRUCT_SERVER_KEY_EXCHANGE
,
2554 ERR_R_INTERNAL_ERROR
);
2559 EVP_MD_CTX_free(md_ctx
);
2562 ssl3_send_alert(s
, SSL3_AL_FATAL
, al
);
2564 #ifndef OPENSSL_NO_DH
2565 EVP_PKEY_free(pkdh
);
2567 #ifndef OPENSSL_NO_EC
2568 OPENSSL_free(encodedPoint
);
2570 EVP_MD_CTX_free(md_ctx
);
2574 int tls_construct_certificate_request(SSL
*s
, WPACKET
*pkt
)
2576 int al
= SSL_AD_INTERNAL_ERROR
;
2578 if (SSL_IS_TLS13(s
)) {
2579 /* TODO(TLS1.3) for now send empty request context */
2580 if (!WPACKET_put_bytes_u8(pkt
, 0)) {
2581 SSLerr(SSL_F_TLS_CONSTRUCT_CERTIFICATE_REQUEST
,
2582 ERR_R_INTERNAL_ERROR
);
2586 if (!tls_construct_extensions(s
, pkt
,
2587 SSL_EXT_TLS1_3_CERTIFICATE_REQUEST
, NULL
,
2589 SSLerr(SSL_F_TLS_CONSTRUCT_CERTIFICATE_REQUEST
,
2590 ERR_R_INTERNAL_ERROR
);
2596 /* get the list of acceptable cert types */
2597 if (!WPACKET_start_sub_packet_u8(pkt
)
2598 || !ssl3_get_req_cert_type(s
, pkt
) || !WPACKET_close(pkt
)) {
2599 SSLerr(SSL_F_TLS_CONSTRUCT_CERTIFICATE_REQUEST
, ERR_R_INTERNAL_ERROR
);
2603 if (SSL_USE_SIGALGS(s
)) {
2604 const uint16_t *psigs
;
2605 size_t nl
= tls12_get_psigalgs(s
, 1, &psigs
);
2607 if (!WPACKET_start_sub_packet_u16(pkt
)
2608 || !WPACKET_set_flags(pkt
, WPACKET_FLAGS_NON_ZERO_LENGTH
)
2609 || !tls12_copy_sigalgs(s
, pkt
, psigs
, nl
)
2610 || !WPACKET_close(pkt
)) {
2611 SSLerr(SSL_F_TLS_CONSTRUCT_CERTIFICATE_REQUEST
,
2612 ERR_R_INTERNAL_ERROR
);
2617 if (!construct_ca_names(s
, pkt
)) {
2618 SSLerr(SSL_F_TLS_CONSTRUCT_CERTIFICATE_REQUEST
, ERR_R_INTERNAL_ERROR
);
2623 s
->s3
->tmp
.cert_request
= 1;
2626 ssl3_send_alert(s
, SSL3_AL_FATAL
, al
);
2630 static int tls_process_cke_psk_preamble(SSL
*s
, PACKET
*pkt
, int *al
)
2632 #ifndef OPENSSL_NO_PSK
2633 unsigned char psk
[PSK_MAX_PSK_LEN
];
2635 PACKET psk_identity
;
2637 if (!PACKET_get_length_prefixed_2(pkt
, &psk_identity
)) {
2638 *al
= SSL_AD_DECODE_ERROR
;
2639 SSLerr(SSL_F_TLS_PROCESS_CKE_PSK_PREAMBLE
, SSL_R_LENGTH_MISMATCH
);
2642 if (PACKET_remaining(&psk_identity
) > PSK_MAX_IDENTITY_LEN
) {
2643 *al
= SSL_AD_DECODE_ERROR
;
2644 SSLerr(SSL_F_TLS_PROCESS_CKE_PSK_PREAMBLE
, SSL_R_DATA_LENGTH_TOO_LONG
);
2647 if (s
->psk_server_callback
== NULL
) {
2648 *al
= SSL_AD_INTERNAL_ERROR
;
2649 SSLerr(SSL_F_TLS_PROCESS_CKE_PSK_PREAMBLE
, SSL_R_PSK_NO_SERVER_CB
);
2653 if (!PACKET_strndup(&psk_identity
, &s
->session
->psk_identity
)) {
2654 *al
= SSL_AD_INTERNAL_ERROR
;
2655 SSLerr(SSL_F_TLS_PROCESS_CKE_PSK_PREAMBLE
, ERR_R_INTERNAL_ERROR
);
2659 psklen
= s
->psk_server_callback(s
, s
->session
->psk_identity
,
2662 if (psklen
> PSK_MAX_PSK_LEN
) {
2663 *al
= SSL_AD_INTERNAL_ERROR
;
2664 SSLerr(SSL_F_TLS_PROCESS_CKE_PSK_PREAMBLE
, ERR_R_INTERNAL_ERROR
);
2666 } else if (psklen
== 0) {
2668 * PSK related to the given identity not found
2670 *al
= SSL_AD_UNKNOWN_PSK_IDENTITY
;
2671 SSLerr(SSL_F_TLS_PROCESS_CKE_PSK_PREAMBLE
,
2672 SSL_R_PSK_IDENTITY_NOT_FOUND
);
2676 OPENSSL_free(s
->s3
->tmp
.psk
);
2677 s
->s3
->tmp
.psk
= OPENSSL_memdup(psk
, psklen
);
2678 OPENSSL_cleanse(psk
, psklen
);
2680 if (s
->s3
->tmp
.psk
== NULL
) {
2681 *al
= SSL_AD_INTERNAL_ERROR
;
2682 SSLerr(SSL_F_TLS_PROCESS_CKE_PSK_PREAMBLE
, ERR_R_MALLOC_FAILURE
);
2686 s
->s3
->tmp
.psklen
= psklen
;
2690 /* Should never happen */
2691 *al
= SSL_AD_INTERNAL_ERROR
;
2692 SSLerr(SSL_F_TLS_PROCESS_CKE_PSK_PREAMBLE
, ERR_R_INTERNAL_ERROR
);
2697 static int tls_process_cke_rsa(SSL
*s
, PACKET
*pkt
, int *al
)
2699 #ifndef OPENSSL_NO_RSA
2700 unsigned char rand_premaster_secret
[SSL_MAX_MASTER_KEY_LENGTH
];
2702 unsigned char decrypt_good
, version_good
;
2703 size_t j
, padding_len
;
2704 PACKET enc_premaster
;
2706 unsigned char *rsa_decrypt
= NULL
;
2709 rsa
= EVP_PKEY_get0_RSA(s
->cert
->pkeys
[SSL_PKEY_RSA
].privatekey
);
2711 *al
= SSL_AD_INTERNAL_ERROR
;
2712 SSLerr(SSL_F_TLS_PROCESS_CKE_RSA
, SSL_R_MISSING_RSA_CERTIFICATE
);
2716 /* SSLv3 and pre-standard DTLS omit the length bytes. */
2717 if (s
->version
== SSL3_VERSION
|| s
->version
== DTLS1_BAD_VER
) {
2718 enc_premaster
= *pkt
;
2720 if (!PACKET_get_length_prefixed_2(pkt
, &enc_premaster
)
2721 || PACKET_remaining(pkt
) != 0) {
2722 *al
= SSL_AD_DECODE_ERROR
;
2723 SSLerr(SSL_F_TLS_PROCESS_CKE_RSA
, SSL_R_LENGTH_MISMATCH
);
2729 * We want to be sure that the plaintext buffer size makes it safe to
2730 * iterate over the entire size of a premaster secret
2731 * (SSL_MAX_MASTER_KEY_LENGTH). Reject overly short RSA keys because
2732 * their ciphertext cannot accommodate a premaster secret anyway.
2734 if (RSA_size(rsa
) < SSL_MAX_MASTER_KEY_LENGTH
) {
2735 *al
= SSL_AD_INTERNAL_ERROR
;
2736 SSLerr(SSL_F_TLS_PROCESS_CKE_RSA
, RSA_R_KEY_SIZE_TOO_SMALL
);
2740 rsa_decrypt
= OPENSSL_malloc(RSA_size(rsa
));
2741 if (rsa_decrypt
== NULL
) {
2742 *al
= SSL_AD_INTERNAL_ERROR
;
2743 SSLerr(SSL_F_TLS_PROCESS_CKE_RSA
, ERR_R_MALLOC_FAILURE
);
2748 * We must not leak whether a decryption failure occurs because of
2749 * Bleichenbacher's attack on PKCS #1 v1.5 RSA padding (see RFC 2246,
2750 * section 7.4.7.1). The code follows that advice of the TLS RFC and
2751 * generates a random premaster secret for the case that the decrypt
2752 * fails. See https://tools.ietf.org/html/rfc5246#section-7.4.7.1
2755 if (ssl_randbytes(s
, rand_premaster_secret
, sizeof(rand_premaster_secret
)) <= 0)
2759 * Decrypt with no padding. PKCS#1 padding will be removed as part of
2760 * the timing-sensitive code below.
2762 /* TODO(size_t): Convert this function */
2763 decrypt_len
= (int)RSA_private_decrypt((int)PACKET_remaining(&enc_premaster
),
2764 PACKET_data(&enc_premaster
),
2765 rsa_decrypt
, rsa
, RSA_NO_PADDING
);
2766 if (decrypt_len
< 0)
2769 /* Check the padding. See RFC 3447, section 7.2.2. */
2772 * The smallest padded premaster is 11 bytes of overhead. Small keys
2773 * are publicly invalid, so this may return immediately. This ensures
2774 * PS is at least 8 bytes.
2776 if (decrypt_len
< 11 + SSL_MAX_MASTER_KEY_LENGTH
) {
2777 *al
= SSL_AD_DECRYPT_ERROR
;
2778 SSLerr(SSL_F_TLS_PROCESS_CKE_RSA
, SSL_R_DECRYPTION_FAILED
);
2782 padding_len
= decrypt_len
- SSL_MAX_MASTER_KEY_LENGTH
;
2783 decrypt_good
= constant_time_eq_int_8(rsa_decrypt
[0], 0) &
2784 constant_time_eq_int_8(rsa_decrypt
[1], 2);
2785 for (j
= 2; j
< padding_len
- 1; j
++) {
2786 decrypt_good
&= ~constant_time_is_zero_8(rsa_decrypt
[j
]);
2788 decrypt_good
&= constant_time_is_zero_8(rsa_decrypt
[padding_len
- 1]);
2791 * If the version in the decrypted pre-master secret is correct then
2792 * version_good will be 0xff, otherwise it'll be zero. The
2793 * Klima-Pokorny-Rosa extension of Bleichenbacher's attack
2794 * (http://eprint.iacr.org/2003/052/) exploits the version number
2795 * check as a "bad version oracle". Thus version checks are done in
2796 * constant time and are treated like any other decryption error.
2799 constant_time_eq_8(rsa_decrypt
[padding_len
],
2800 (unsigned)(s
->client_version
>> 8));
2802 constant_time_eq_8(rsa_decrypt
[padding_len
+ 1],
2803 (unsigned)(s
->client_version
& 0xff));
2806 * The premaster secret must contain the same version number as the
2807 * ClientHello to detect version rollback attacks (strangely, the
2808 * protocol does not offer such protection for DH ciphersuites).
2809 * However, buggy clients exist that send the negotiated protocol
2810 * version instead if the server does not support the requested
2811 * protocol version. If SSL_OP_TLS_ROLLBACK_BUG is set, tolerate such
2814 if (s
->options
& SSL_OP_TLS_ROLLBACK_BUG
) {
2815 unsigned char workaround_good
;
2816 workaround_good
= constant_time_eq_8(rsa_decrypt
[padding_len
],
2817 (unsigned)(s
->version
>> 8));
2819 constant_time_eq_8(rsa_decrypt
[padding_len
+ 1],
2820 (unsigned)(s
->version
& 0xff));
2821 version_good
|= workaround_good
;
2825 * Both decryption and version must be good for decrypt_good to
2826 * remain non-zero (0xff).
2828 decrypt_good
&= version_good
;
2831 * Now copy rand_premaster_secret over from p using
2832 * decrypt_good_mask. If decryption failed, then p does not
2833 * contain valid plaintext, however, a check above guarantees
2834 * it is still sufficiently large to read from.
2836 for (j
= 0; j
< sizeof(rand_premaster_secret
); j
++) {
2837 rsa_decrypt
[padding_len
+ j
] =
2838 constant_time_select_8(decrypt_good
,
2839 rsa_decrypt
[padding_len
+ j
],
2840 rand_premaster_secret
[j
]);
2843 if (!ssl_generate_master_secret(s
, rsa_decrypt
+ padding_len
,
2844 sizeof(rand_premaster_secret
), 0)) {
2845 *al
= SSL_AD_INTERNAL_ERROR
;
2846 SSLerr(SSL_F_TLS_PROCESS_CKE_RSA
, ERR_R_INTERNAL_ERROR
);
2852 OPENSSL_free(rsa_decrypt
);
2855 /* Should never happen */
2856 *al
= SSL_AD_INTERNAL_ERROR
;
2857 SSLerr(SSL_F_TLS_PROCESS_CKE_RSA
, ERR_R_INTERNAL_ERROR
);
2862 static int tls_process_cke_dhe(SSL
*s
, PACKET
*pkt
, int *al
)
2864 #ifndef OPENSSL_NO_DH
2865 EVP_PKEY
*skey
= NULL
;
2869 const unsigned char *data
;
2870 EVP_PKEY
*ckey
= NULL
;
2873 if (!PACKET_get_net_2(pkt
, &i
) || PACKET_remaining(pkt
) != i
) {
2874 *al
= SSL_AD_DECODE_ERROR
;
2875 SSLerr(SSL_F_TLS_PROCESS_CKE_DHE
,
2876 SSL_R_DH_PUBLIC_VALUE_LENGTH_IS_WRONG
);
2879 skey
= s
->s3
->tmp
.pkey
;
2881 *al
= SSL_AD_INTERNAL_ERROR
;
2882 SSLerr(SSL_F_TLS_PROCESS_CKE_DHE
, SSL_R_MISSING_TMP_DH_KEY
);
2886 if (PACKET_remaining(pkt
) == 0L) {
2887 *al
= SSL_AD_DECODE_ERROR
;
2888 SSLerr(SSL_F_TLS_PROCESS_CKE_DHE
, SSL_R_MISSING_TMP_DH_KEY
);
2891 if (!PACKET_get_bytes(pkt
, &data
, i
)) {
2892 /* We already checked we have enough data */
2893 *al
= SSL_AD_INTERNAL_ERROR
;
2894 SSLerr(SSL_F_TLS_PROCESS_CKE_DHE
, ERR_R_INTERNAL_ERROR
);
2897 ckey
= EVP_PKEY_new();
2898 if (ckey
== NULL
|| EVP_PKEY_copy_parameters(ckey
, skey
) == 0) {
2899 SSLerr(SSL_F_TLS_PROCESS_CKE_DHE
, SSL_R_BN_LIB
);
2902 cdh
= EVP_PKEY_get0_DH(ckey
);
2903 pub_key
= BN_bin2bn(data
, i
, NULL
);
2905 if (pub_key
== NULL
|| !DH_set0_key(cdh
, pub_key
, NULL
)) {
2906 SSLerr(SSL_F_TLS_PROCESS_CKE_DHE
, ERR_R_INTERNAL_ERROR
);
2907 if (pub_key
!= NULL
)
2912 if (ssl_derive(s
, skey
, ckey
, 1) == 0) {
2913 *al
= SSL_AD_INTERNAL_ERROR
;
2914 SSLerr(SSL_F_TLS_PROCESS_CKE_DHE
, ERR_R_INTERNAL_ERROR
);
2919 EVP_PKEY_free(s
->s3
->tmp
.pkey
);
2920 s
->s3
->tmp
.pkey
= NULL
;
2922 EVP_PKEY_free(ckey
);
2925 /* Should never happen */
2926 *al
= SSL_AD_INTERNAL_ERROR
;
2927 SSLerr(SSL_F_TLS_PROCESS_CKE_DHE
, ERR_R_INTERNAL_ERROR
);
2932 static int tls_process_cke_ecdhe(SSL
*s
, PACKET
*pkt
, int *al
)
2934 #ifndef OPENSSL_NO_EC
2935 EVP_PKEY
*skey
= s
->s3
->tmp
.pkey
;
2936 EVP_PKEY
*ckey
= NULL
;
2939 if (PACKET_remaining(pkt
) == 0L) {
2940 /* We don't support ECDH client auth */
2941 *al
= SSL_AD_HANDSHAKE_FAILURE
;
2942 SSLerr(SSL_F_TLS_PROCESS_CKE_ECDHE
, SSL_R_MISSING_TMP_ECDH_KEY
);
2946 const unsigned char *data
;
2949 * Get client's public key from encoded point in the
2950 * ClientKeyExchange message.
2953 /* Get encoded point length */
2954 if (!PACKET_get_1(pkt
, &i
) || !PACKET_get_bytes(pkt
, &data
, i
)
2955 || PACKET_remaining(pkt
) != 0) {
2956 *al
= SSL_AD_DECODE_ERROR
;
2957 SSLerr(SSL_F_TLS_PROCESS_CKE_ECDHE
, SSL_R_LENGTH_MISMATCH
);
2960 ckey
= EVP_PKEY_new();
2961 if (ckey
== NULL
|| EVP_PKEY_copy_parameters(ckey
, skey
) <= 0) {
2962 SSLerr(SSL_F_TLS_PROCESS_CKE_ECDHE
, ERR_R_EVP_LIB
);
2965 if (EVP_PKEY_set1_tls_encodedpoint(ckey
, data
, i
) == 0) {
2966 *al
= SSL_AD_ILLEGAL_PARAMETER
;
2967 SSLerr(SSL_F_TLS_PROCESS_CKE_ECDHE
, ERR_R_EC_LIB
);
2972 if (ssl_derive(s
, skey
, ckey
, 1) == 0) {
2973 *al
= SSL_AD_INTERNAL_ERROR
;
2974 SSLerr(SSL_F_TLS_PROCESS_CKE_ECDHE
, ERR_R_INTERNAL_ERROR
);
2979 EVP_PKEY_free(s
->s3
->tmp
.pkey
);
2980 s
->s3
->tmp
.pkey
= NULL
;
2982 EVP_PKEY_free(ckey
);
2986 /* Should never happen */
2987 *al
= SSL_AD_INTERNAL_ERROR
;
2988 SSLerr(SSL_F_TLS_PROCESS_CKE_ECDHE
, ERR_R_INTERNAL_ERROR
);
2993 static int tls_process_cke_srp(SSL
*s
, PACKET
*pkt
, int *al
)
2995 #ifndef OPENSSL_NO_SRP
2997 const unsigned char *data
;
2999 if (!PACKET_get_net_2(pkt
, &i
)
3000 || !PACKET_get_bytes(pkt
, &data
, i
)) {
3001 *al
= SSL_AD_DECODE_ERROR
;
3002 SSLerr(SSL_F_TLS_PROCESS_CKE_SRP
, SSL_R_BAD_SRP_A_LENGTH
);
3005 if ((s
->srp_ctx
.A
= BN_bin2bn(data
, i
, NULL
)) == NULL
) {
3006 *al
= SSL_AD_INTERNAL_ERROR
;
3007 SSLerr(SSL_F_TLS_PROCESS_CKE_SRP
, ERR_R_BN_LIB
);
3010 if (BN_ucmp(s
->srp_ctx
.A
, s
->srp_ctx
.N
) >= 0 || BN_is_zero(s
->srp_ctx
.A
)) {
3011 *al
= SSL_AD_ILLEGAL_PARAMETER
;
3012 SSLerr(SSL_F_TLS_PROCESS_CKE_SRP
, SSL_R_BAD_SRP_PARAMETERS
);
3015 OPENSSL_free(s
->session
->srp_username
);
3016 s
->session
->srp_username
= OPENSSL_strdup(s
->srp_ctx
.login
);
3017 if (s
->session
->srp_username
== NULL
) {
3018 SSLerr(SSL_F_TLS_PROCESS_CKE_SRP
, ERR_R_MALLOC_FAILURE
);
3022 if (!srp_generate_server_master_secret(s
)) {
3023 SSLerr(SSL_F_TLS_PROCESS_CKE_SRP
, ERR_R_INTERNAL_ERROR
);
3029 /* Should never happen */
3030 *al
= SSL_AD_INTERNAL_ERROR
;
3031 SSLerr(SSL_F_TLS_PROCESS_CKE_SRP
, ERR_R_INTERNAL_ERROR
);
3036 static int tls_process_cke_gost(SSL
*s
, PACKET
*pkt
, int *al
)
3038 #ifndef OPENSSL_NO_GOST
3039 EVP_PKEY_CTX
*pkey_ctx
;
3040 EVP_PKEY
*client_pub_pkey
= NULL
, *pk
= NULL
;
3041 unsigned char premaster_secret
[32];
3042 const unsigned char *start
;
3043 size_t outlen
= 32, inlen
;
3044 unsigned long alg_a
;
3047 size_t sess_key_len
;
3048 const unsigned char *data
;
3051 /* Get our certificate private key */
3052 alg_a
= s
->s3
->tmp
.new_cipher
->algorithm_auth
;
3053 if (alg_a
& SSL_aGOST12
) {
3055 * New GOST ciphersuites have SSL_aGOST01 bit too
3057 pk
= s
->cert
->pkeys
[SSL_PKEY_GOST12_512
].privatekey
;
3059 pk
= s
->cert
->pkeys
[SSL_PKEY_GOST12_256
].privatekey
;
3062 pk
= s
->cert
->pkeys
[SSL_PKEY_GOST01
].privatekey
;
3064 } else if (alg_a
& SSL_aGOST01
) {
3065 pk
= s
->cert
->pkeys
[SSL_PKEY_GOST01
].privatekey
;
3068 pkey_ctx
= EVP_PKEY_CTX_new(pk
, NULL
);
3069 if (pkey_ctx
== NULL
) {
3070 *al
= SSL_AD_INTERNAL_ERROR
;
3071 SSLerr(SSL_F_TLS_PROCESS_CKE_GOST
, ERR_R_MALLOC_FAILURE
);
3074 if (EVP_PKEY_decrypt_init(pkey_ctx
) <= 0) {
3075 *al
= SSL_AD_INTERNAL_ERROR
;
3076 SSLerr(SSL_F_TLS_PROCESS_CKE_GOST
, ERR_R_INTERNAL_ERROR
);
3080 * If client certificate is present and is of the same type, maybe
3081 * use it for key exchange. Don't mind errors from
3082 * EVP_PKEY_derive_set_peer, because it is completely valid to use a
3083 * client certificate for authorization only.
3085 client_pub_pkey
= X509_get0_pubkey(s
->session
->peer
);
3086 if (client_pub_pkey
) {
3087 if (EVP_PKEY_derive_set_peer(pkey_ctx
, client_pub_pkey
) <= 0)
3090 /* Decrypt session key */
3091 sess_key_len
= PACKET_remaining(pkt
);
3092 if (!PACKET_get_bytes(pkt
, &data
, sess_key_len
)) {
3093 *al
= SSL_AD_INTERNAL_ERROR
;
3094 SSLerr(SSL_F_TLS_PROCESS_CKE_GOST
, ERR_R_INTERNAL_ERROR
);
3097 /* TODO(size_t): Convert this function */
3098 if (ASN1_get_object((const unsigned char **)&data
, &Tlen
, &Ttag
,
3099 &Tclass
, (long)sess_key_len
) != V_ASN1_CONSTRUCTED
3100 || Ttag
!= V_ASN1_SEQUENCE
|| Tclass
!= V_ASN1_UNIVERSAL
) {
3101 *al
= SSL_AD_DECODE_ERROR
;
3102 SSLerr(SSL_F_TLS_PROCESS_CKE_GOST
, SSL_R_DECRYPTION_FAILED
);
3107 if (EVP_PKEY_decrypt
3108 (pkey_ctx
, premaster_secret
, &outlen
, start
, inlen
) <= 0) {
3109 *al
= SSL_AD_DECODE_ERROR
;
3110 SSLerr(SSL_F_TLS_PROCESS_CKE_GOST
, SSL_R_DECRYPTION_FAILED
);
3113 /* Generate master secret */
3114 if (!ssl_generate_master_secret(s
, premaster_secret
,
3115 sizeof(premaster_secret
), 0)) {
3116 *al
= SSL_AD_INTERNAL_ERROR
;
3117 SSLerr(SSL_F_TLS_PROCESS_CKE_GOST
, ERR_R_INTERNAL_ERROR
);
3120 /* Check if pubkey from client certificate was used */
3121 if (EVP_PKEY_CTX_ctrl
3122 (pkey_ctx
, -1, -1, EVP_PKEY_CTRL_PEER_KEY
, 2, NULL
) > 0)
3123 s
->statem
.no_cert_verify
= 1;
3127 EVP_PKEY_CTX_free(pkey_ctx
);
3130 /* Should never happen */
3131 *al
= SSL_AD_INTERNAL_ERROR
;
3132 SSLerr(SSL_F_TLS_PROCESS_CKE_GOST
, ERR_R_INTERNAL_ERROR
);
3137 MSG_PROCESS_RETURN
tls_process_client_key_exchange(SSL
*s
, PACKET
*pkt
)
3140 unsigned long alg_k
;
3142 alg_k
= s
->s3
->tmp
.new_cipher
->algorithm_mkey
;
3144 /* For PSK parse and retrieve identity, obtain PSK key */
3145 if ((alg_k
& SSL_PSK
) && !tls_process_cke_psk_preamble(s
, pkt
, &al
))
3148 if (alg_k
& SSL_kPSK
) {
3149 /* Identity extracted earlier: should be nothing left */
3150 if (PACKET_remaining(pkt
) != 0) {
3151 al
= SSL_AD_DECODE_ERROR
;
3152 SSLerr(SSL_F_TLS_PROCESS_CLIENT_KEY_EXCHANGE
,
3153 SSL_R_LENGTH_MISMATCH
);
3156 /* PSK handled by ssl_generate_master_secret */
3157 if (!ssl_generate_master_secret(s
, NULL
, 0, 0)) {
3158 al
= SSL_AD_INTERNAL_ERROR
;
3159 SSLerr(SSL_F_TLS_PROCESS_CLIENT_KEY_EXCHANGE
, ERR_R_INTERNAL_ERROR
);
3162 } else if (alg_k
& (SSL_kRSA
| SSL_kRSAPSK
)) {
3163 if (!tls_process_cke_rsa(s
, pkt
, &al
))
3165 } else if (alg_k
& (SSL_kDHE
| SSL_kDHEPSK
)) {
3166 if (!tls_process_cke_dhe(s
, pkt
, &al
))
3168 } else if (alg_k
& (SSL_kECDHE
| SSL_kECDHEPSK
)) {
3169 if (!tls_process_cke_ecdhe(s
, pkt
, &al
))
3171 } else if (alg_k
& SSL_kSRP
) {
3172 if (!tls_process_cke_srp(s
, pkt
, &al
))
3174 } else if (alg_k
& SSL_kGOST
) {
3175 if (!tls_process_cke_gost(s
, pkt
, &al
))
3178 al
= SSL_AD_INTERNAL_ERROR
;
3179 SSLerr(SSL_F_TLS_PROCESS_CLIENT_KEY_EXCHANGE
,
3180 SSL_R_UNKNOWN_CIPHER_TYPE
);
3184 return MSG_PROCESS_CONTINUE_PROCESSING
;
3187 ssl3_send_alert(s
, SSL3_AL_FATAL
, al
);
3188 #ifndef OPENSSL_NO_PSK
3189 OPENSSL_clear_free(s
->s3
->tmp
.psk
, s
->s3
->tmp
.psklen
);
3190 s
->s3
->tmp
.psk
= NULL
;
3192 ossl_statem_set_error(s
);
3193 return MSG_PROCESS_ERROR
;
3196 WORK_STATE
tls_post_process_client_key_exchange(SSL
*s
, WORK_STATE wst
)
3198 #ifndef OPENSSL_NO_SCTP
3199 if (wst
== WORK_MORE_A
) {
3200 if (SSL_IS_DTLS(s
)) {
3201 unsigned char sctpauthkey
[64];
3202 char labelbuffer
[sizeof(DTLS1_SCTP_AUTH_LABEL
)];
3204 * Add new shared key for SCTP-Auth, will be ignored if no SCTP
3207 memcpy(labelbuffer
, DTLS1_SCTP_AUTH_LABEL
,
3208 sizeof(DTLS1_SCTP_AUTH_LABEL
));
3210 if (SSL_export_keying_material(s
, sctpauthkey
,
3211 sizeof(sctpauthkey
), labelbuffer
,
3212 sizeof(labelbuffer
), NULL
, 0,
3214 ossl_statem_set_error(s
);
3218 BIO_ctrl(SSL_get_wbio(s
), BIO_CTRL_DGRAM_SCTP_ADD_AUTH_KEY
,
3219 sizeof(sctpauthkey
), sctpauthkey
);
3224 if (s
->statem
.no_cert_verify
|| !s
->session
->peer
) {
3226 * No certificate verify or no peer certificate so we no longer need
3227 * the handshake_buffer
3229 if (!ssl3_digest_cached_records(s
, 0)) {
3230 ossl_statem_set_error(s
);
3233 return WORK_FINISHED_CONTINUE
;
3235 if (!s
->s3
->handshake_buffer
) {
3236 SSLerr(SSL_F_TLS_POST_PROCESS_CLIENT_KEY_EXCHANGE
,
3237 ERR_R_INTERNAL_ERROR
);
3238 ossl_statem_set_error(s
);
3242 * For sigalgs freeze the handshake buffer. If we support
3243 * extms we've done this already so this is a no-op
3245 if (!ssl3_digest_cached_records(s
, 1)) {
3246 ossl_statem_set_error(s
);
3251 return WORK_FINISHED_CONTINUE
;
3254 MSG_PROCESS_RETURN
tls_process_client_certificate(SSL
*s
, PACKET
*pkt
)
3256 int i
, al
= SSL_AD_INTERNAL_ERROR
;
3257 MSG_PROCESS_RETURN ret
= MSG_PROCESS_ERROR
;
3259 unsigned long l
, llen
;
3260 const unsigned char *certstart
, *certbytes
;
3261 STACK_OF(X509
) *sk
= NULL
;
3262 PACKET spkt
, context
;
3265 if ((sk
= sk_X509_new_null()) == NULL
) {
3266 SSLerr(SSL_F_TLS_PROCESS_CLIENT_CERTIFICATE
, ERR_R_MALLOC_FAILURE
);
3270 /* TODO(TLS1.3): For now we ignore the context. We need to verify this */
3271 if ((SSL_IS_TLS13(s
) && !PACKET_get_length_prefixed_1(pkt
, &context
))
3272 || !PACKET_get_net_3(pkt
, &llen
)
3273 || !PACKET_get_sub_packet(pkt
, &spkt
, llen
)
3274 || PACKET_remaining(pkt
) != 0) {
3275 al
= SSL_AD_DECODE_ERROR
;
3276 SSLerr(SSL_F_TLS_PROCESS_CLIENT_CERTIFICATE
, SSL_R_LENGTH_MISMATCH
);
3280 for (chainidx
= 0; PACKET_remaining(&spkt
) > 0; chainidx
++) {
3281 if (!PACKET_get_net_3(&spkt
, &l
)
3282 || !PACKET_get_bytes(&spkt
, &certbytes
, l
)) {
3283 al
= SSL_AD_DECODE_ERROR
;
3284 SSLerr(SSL_F_TLS_PROCESS_CLIENT_CERTIFICATE
,
3285 SSL_R_CERT_LENGTH_MISMATCH
);
3289 certstart
= certbytes
;
3290 x
= d2i_X509(NULL
, (const unsigned char **)&certbytes
, l
);
3292 SSLerr(SSL_F_TLS_PROCESS_CLIENT_CERTIFICATE
, ERR_R_ASN1_LIB
);
3295 if (certbytes
!= (certstart
+ l
)) {
3296 al
= SSL_AD_DECODE_ERROR
;
3297 SSLerr(SSL_F_TLS_PROCESS_CLIENT_CERTIFICATE
,
3298 SSL_R_CERT_LENGTH_MISMATCH
);
3302 if (SSL_IS_TLS13(s
)) {
3303 RAW_EXTENSION
*rawexts
= NULL
;
3306 if (!PACKET_get_length_prefixed_2(&spkt
, &extensions
)) {
3307 al
= SSL_AD_DECODE_ERROR
;
3308 SSLerr(SSL_F_TLS_PROCESS_CLIENT_CERTIFICATE
, SSL_R_BAD_LENGTH
);
3311 if (!tls_collect_extensions(s
, &extensions
,
3312 SSL_EXT_TLS1_3_CERTIFICATE
, &rawexts
,
3313 &al
, NULL
, chainidx
== 0)
3314 || !tls_parse_all_extensions(s
, SSL_EXT_TLS1_3_CERTIFICATE
,
3315 rawexts
, x
, chainidx
, &al
,
3316 PACKET_remaining(&spkt
) == 0)) {
3317 OPENSSL_free(rawexts
);
3320 OPENSSL_free(rawexts
);
3323 if (!sk_X509_push(sk
, x
)) {
3324 SSLerr(SSL_F_TLS_PROCESS_CLIENT_CERTIFICATE
, ERR_R_MALLOC_FAILURE
);
3330 if (sk_X509_num(sk
) <= 0) {
3331 /* TLS does not mind 0 certs returned */
3332 if (s
->version
== SSL3_VERSION
) {
3333 al
= SSL_AD_HANDSHAKE_FAILURE
;
3334 SSLerr(SSL_F_TLS_PROCESS_CLIENT_CERTIFICATE
,
3335 SSL_R_NO_CERTIFICATES_RETURNED
);
3338 /* Fail for TLS only if we required a certificate */
3339 else if ((s
->verify_mode
& SSL_VERIFY_PEER
) &&
3340 (s
->verify_mode
& SSL_VERIFY_FAIL_IF_NO_PEER_CERT
)) {
3341 SSLerr(SSL_F_TLS_PROCESS_CLIENT_CERTIFICATE
,
3342 SSL_R_PEER_DID_NOT_RETURN_A_CERTIFICATE
);
3343 al
= SSL_AD_CERTIFICATE_REQUIRED
;
3346 /* No client certificate so digest cached records */
3347 if (s
->s3
->handshake_buffer
&& !ssl3_digest_cached_records(s
, 0)) {
3352 i
= ssl_verify_cert_chain(s
, sk
);
3354 al
= ssl_verify_alarm_type(s
->verify_result
);
3355 SSLerr(SSL_F_TLS_PROCESS_CLIENT_CERTIFICATE
,
3356 SSL_R_CERTIFICATE_VERIFY_FAILED
);
3360 SSLerr(SSL_F_TLS_PROCESS_CLIENT_CERTIFICATE
, i
);
3361 al
= SSL_AD_HANDSHAKE_FAILURE
;
3364 pkey
= X509_get0_pubkey(sk_X509_value(sk
, 0));
3366 al
= SSL3_AD_HANDSHAKE_FAILURE
;
3367 SSLerr(SSL_F_TLS_PROCESS_CLIENT_CERTIFICATE
,
3368 SSL_R_UNKNOWN_CERTIFICATE_TYPE
);
3373 X509_free(s
->session
->peer
);
3374 s
->session
->peer
= sk_X509_shift(sk
);
3375 s
->session
->verify_result
= s
->verify_result
;
3377 sk_X509_pop_free(s
->session
->peer_chain
, X509_free
);
3378 s
->session
->peer_chain
= sk
;
3381 * Freeze the handshake buffer. For <TLS1.3 we do this after the CKE
3384 if (SSL_IS_TLS13(s
) && !ssl3_digest_cached_records(s
, 1)) {
3385 al
= SSL_AD_INTERNAL_ERROR
;
3386 SSLerr(SSL_F_TLS_PROCESS_CLIENT_CERTIFICATE
, ERR_R_INTERNAL_ERROR
);
3391 * Inconsistency alert: cert_chain does *not* include the peer's own
3392 * certificate, while we do include it in statem_clnt.c
3396 /* Save the current hash state for when we receive the CertificateVerify */
3398 && !ssl_handshake_hash(s
, s
->cert_verify_hash
,
3399 sizeof(s
->cert_verify_hash
),
3400 &s
->cert_verify_hash_len
)) {
3401 al
= SSL_AD_INTERNAL_ERROR
;
3402 SSLerr(SSL_F_TLS_PROCESS_CLIENT_CERTIFICATE
, ERR_R_INTERNAL_ERROR
);
3406 ret
= MSG_PROCESS_CONTINUE_READING
;
3410 ssl3_send_alert(s
, SSL3_AL_FATAL
, al
);
3411 ossl_statem_set_error(s
);
3414 sk_X509_pop_free(sk
, X509_free
);
3418 int tls_construct_server_certificate(SSL
*s
, WPACKET
*pkt
)
3420 CERT_PKEY
*cpk
= s
->s3
->tmp
.cert
;
3421 int al
= SSL_AD_INTERNAL_ERROR
;
3424 SSLerr(SSL_F_TLS_CONSTRUCT_SERVER_CERTIFICATE
, ERR_R_INTERNAL_ERROR
);
3429 * In TLSv1.3 the certificate chain is always preceded by a 0 length context
3430 * for the server Certificate message
3432 if ((SSL_IS_TLS13(s
) && !WPACKET_put_bytes_u8(pkt
, 0))
3433 || !ssl3_output_cert_chain(s
, pkt
, cpk
, &al
)) {
3434 SSLerr(SSL_F_TLS_CONSTRUCT_SERVER_CERTIFICATE
, ERR_R_INTERNAL_ERROR
);
3435 ssl3_send_alert(s
, SSL3_AL_FATAL
, al
);
3442 int tls_construct_new_session_ticket(SSL
*s
, WPACKET
*pkt
)
3444 unsigned char *senc
= NULL
;
3445 EVP_CIPHER_CTX
*ctx
= NULL
;
3446 HMAC_CTX
*hctx
= NULL
;
3447 unsigned char *p
, *encdata1
, *encdata2
, *macdata1
, *macdata2
;
3448 const unsigned char *const_p
;
3449 int len
, slen_full
, slen
, lenfinal
;
3452 SSL_CTX
*tctx
= s
->session_ctx
;
3453 unsigned char iv
[EVP_MAX_IV_LENGTH
];
3454 unsigned char key_name
[TLSEXT_KEYNAME_LENGTH
];
3455 int iv_len
, al
= SSL_AD_INTERNAL_ERROR
;
3456 size_t macoffset
, macendoffset
;
3458 unsigned char age_add_c
[sizeof(uint32_t)];
3462 if (SSL_IS_TLS13(s
)) {
3463 if (ssl_randbytes(s
, age_add_u
.age_add_c
, sizeof(age_add_u
)) <= 0)
3465 s
->session
->ext
.tick_age_add
= age_add_u
.age_add
;
3467 * ticket_nonce is set to a single 0 byte because we only ever send a
3468 * single ticket per connection. IMPORTANT: If we ever support multiple
3469 * tickets per connection then this will need to be changed.
3471 OPENSSL_free(s
->session
->ext
.tick_nonce
);
3472 s
->session
->ext
.tick_nonce
= OPENSSL_zalloc(sizeof(char));
3473 if (s
->session
->ext
.tick_nonce
== NULL
) {
3474 SSLerr(SSL_F_TLS_CONSTRUCT_NEW_SESSION_TICKET
,
3475 ERR_R_MALLOC_FAILURE
);
3478 s
->session
->ext
.tick_nonce_len
= 1;
3479 s
->session
->time
= (long)time(NULL
);
3480 if (s
->s3
->alpn_selected
!= NULL
) {
3481 OPENSSL_free(s
->session
->ext
.alpn_selected
);
3482 s
->session
->ext
.alpn_selected
=
3483 OPENSSL_memdup(s
->s3
->alpn_selected
, s
->s3
->alpn_selected_len
);
3484 if (s
->session
->ext
.alpn_selected
== NULL
) {
3485 SSLerr(SSL_F_TLS_CONSTRUCT_NEW_SESSION_TICKET
,
3486 ERR_R_MALLOC_FAILURE
);
3489 s
->session
->ext
.alpn_selected_len
= s
->s3
->alpn_selected_len
;
3491 s
->session
->ext
.max_early_data
= s
->max_early_data
;
3494 /* get session encoding length */
3495 slen_full
= i2d_SSL_SESSION(s
->session
, NULL
);
3497 * Some length values are 16 bits, so forget it if session is too
3500 if (slen_full
== 0 || slen_full
> 0xFF00) {
3501 SSLerr(SSL_F_TLS_CONSTRUCT_NEW_SESSION_TICKET
, ERR_R_INTERNAL_ERROR
);
3504 senc
= OPENSSL_malloc(slen_full
);
3506 SSLerr(SSL_F_TLS_CONSTRUCT_NEW_SESSION_TICKET
, ERR_R_MALLOC_FAILURE
);
3510 ctx
= EVP_CIPHER_CTX_new();
3511 hctx
= HMAC_CTX_new();
3512 if (ctx
== NULL
|| hctx
== NULL
) {
3513 SSLerr(SSL_F_TLS_CONSTRUCT_NEW_SESSION_TICKET
, ERR_R_MALLOC_FAILURE
);
3518 if (!i2d_SSL_SESSION(s
->session
, &p
))
3522 * create a fresh copy (not shared with other threads) to clean up
3525 sess
= d2i_SSL_SESSION(NULL
, &const_p
, slen_full
);
3528 sess
->session_id_length
= 0; /* ID is irrelevant for the ticket */
3530 slen
= i2d_SSL_SESSION(sess
, NULL
);
3531 if (slen
== 0 || slen
> slen_full
) { /* shouldn't ever happen */
3532 SSL_SESSION_free(sess
);
3536 if (!i2d_SSL_SESSION(sess
, &p
)) {
3537 SSL_SESSION_free(sess
);
3540 SSL_SESSION_free(sess
);
3543 * Initialize HMAC and cipher contexts. If callback present it does
3544 * all the work otherwise use generated values from parent ctx.
3546 if (tctx
->ext
.ticket_key_cb
) {
3547 /* if 0 is returned, write an empty ticket */
3548 int ret
= tctx
->ext
.ticket_key_cb(s
, key_name
, iv
, ctx
,
3553 /* Put timeout and length */
3554 if (!WPACKET_put_bytes_u32(pkt
, 0)
3555 || !WPACKET_put_bytes_u16(pkt
, 0)) {
3556 SSLerr(SSL_F_TLS_CONSTRUCT_NEW_SESSION_TICKET
,
3557 ERR_R_INTERNAL_ERROR
);
3561 EVP_CIPHER_CTX_free(ctx
);
3562 HMAC_CTX_free(hctx
);
3567 iv_len
= EVP_CIPHER_CTX_iv_length(ctx
);
3569 const EVP_CIPHER
*cipher
= EVP_aes_256_cbc();
3571 iv_len
= EVP_CIPHER_iv_length(cipher
);
3572 if (ssl_randbytes(s
, iv
, iv_len
) <= 0)
3574 if (!EVP_EncryptInit_ex(ctx
, cipher
, NULL
,
3575 tctx
->ext
.tick_aes_key
, iv
))
3577 if (!HMAC_Init_ex(hctx
, tctx
->ext
.tick_hmac_key
,
3578 sizeof(tctx
->ext
.tick_hmac_key
),
3579 EVP_sha256(), NULL
))
3581 memcpy(key_name
, tctx
->ext
.tick_key_name
,
3582 sizeof(tctx
->ext
.tick_key_name
));
3586 * Ticket lifetime hint: For TLSv1.2 this is advisory only and we leave this
3587 * unspecified for resumed session (for simplicity).
3588 * In TLSv1.3 we reset the "time" field above, and always specify the
3591 if (!WPACKET_put_bytes_u32(pkt
,
3592 (s
->hit
&& !SSL_IS_TLS13(s
))
3593 ? 0 : s
->session
->timeout
)
3595 && (!WPACKET_put_bytes_u32(pkt
, age_add_u
.age_add
)
3596 || !WPACKET_sub_memcpy_u8(pkt
, s
->session
->ext
.tick_nonce
,
3597 s
->session
->ext
.tick_nonce_len
)))
3598 /* Now the actual ticket data */
3599 || !WPACKET_start_sub_packet_u16(pkt
)
3600 || !WPACKET_get_total_written(pkt
, &macoffset
)
3601 /* Output key name */
3602 || !WPACKET_memcpy(pkt
, key_name
, sizeof(key_name
))
3604 || !WPACKET_memcpy(pkt
, iv
, iv_len
)
3605 || !WPACKET_reserve_bytes(pkt
, slen
+ EVP_MAX_BLOCK_LENGTH
,
3607 /* Encrypt session data */
3608 || !EVP_EncryptUpdate(ctx
, encdata1
, &len
, senc
, slen
)
3609 || !WPACKET_allocate_bytes(pkt
, len
, &encdata2
)
3610 || encdata1
!= encdata2
3611 || !EVP_EncryptFinal(ctx
, encdata1
+ len
, &lenfinal
)
3612 || !WPACKET_allocate_bytes(pkt
, lenfinal
, &encdata2
)
3613 || encdata1
+ len
!= encdata2
3614 || len
+ lenfinal
> slen
+ EVP_MAX_BLOCK_LENGTH
3615 || !WPACKET_get_total_written(pkt
, &macendoffset
)
3616 || !HMAC_Update(hctx
,
3617 (unsigned char *)s
->init_buf
->data
+ macoffset
,
3618 macendoffset
- macoffset
)
3619 || !WPACKET_reserve_bytes(pkt
, EVP_MAX_MD_SIZE
, &macdata1
)
3620 || !HMAC_Final(hctx
, macdata1
, &hlen
)
3621 || hlen
> EVP_MAX_MD_SIZE
3622 || !WPACKET_allocate_bytes(pkt
, hlen
, &macdata2
)
3623 || macdata1
!= macdata2
3624 || !WPACKET_close(pkt
)
3626 && !tls_construct_extensions(s
, pkt
,
3627 SSL_EXT_TLS1_3_NEW_SESSION_TICKET
,
3629 SSLerr(SSL_F_TLS_CONSTRUCT_NEW_SESSION_TICKET
, ERR_R_INTERNAL_ERROR
);
3632 EVP_CIPHER_CTX_free(ctx
);
3633 HMAC_CTX_free(hctx
);
3638 ossl_statem_set_error(s
);
3640 EVP_CIPHER_CTX_free(ctx
);
3641 HMAC_CTX_free(hctx
);
3642 ssl3_send_alert(s
, SSL3_AL_FATAL
, SSL_AD_INTERNAL_ERROR
);
3647 * In TLSv1.3 this is called from the extensions code, otherwise it is used to
3648 * create a separate message. Returns 1 on success or 0 on failure.
3650 int tls_construct_cert_status_body(SSL
*s
, WPACKET
*pkt
)
3652 if (!WPACKET_put_bytes_u8(pkt
, s
->ext
.status_type
)
3653 || !WPACKET_sub_memcpy_u24(pkt
, s
->ext
.ocsp
.resp
,
3654 s
->ext
.ocsp
.resp_len
)) {
3655 SSLerr(SSL_F_TLS_CONSTRUCT_CERT_STATUS_BODY
, ERR_R_INTERNAL_ERROR
);
3662 int tls_construct_cert_status(SSL
*s
, WPACKET
*pkt
)
3664 if (!tls_construct_cert_status_body(s
, pkt
)) {
3665 ssl3_send_alert(s
, SSL3_AL_FATAL
, SSL_AD_INTERNAL_ERROR
);
3672 #ifndef OPENSSL_NO_NEXTPROTONEG
3674 * tls_process_next_proto reads a Next Protocol Negotiation handshake message.
3675 * It sets the next_proto member in s if found
3677 MSG_PROCESS_RETURN
tls_process_next_proto(SSL
*s
, PACKET
*pkt
)
3679 PACKET next_proto
, padding
;
3680 size_t next_proto_len
;
3681 int al
= SSL_AD_INTERNAL_ERROR
;
3684 * The payload looks like:
3686 * uint8 proto[proto_len];
3687 * uint8 padding_len;
3688 * uint8 padding[padding_len];
3690 if (!PACKET_get_length_prefixed_1(pkt
, &next_proto
)
3691 || !PACKET_get_length_prefixed_1(pkt
, &padding
)
3692 || PACKET_remaining(pkt
) > 0) {
3693 al
= SSL_AD_DECODE_ERROR
;
3694 SSLerr(SSL_F_TLS_PROCESS_NEXT_PROTO
, SSL_R_LENGTH_MISMATCH
);
3698 if (!PACKET_memdup(&next_proto
, &s
->ext
.npn
, &next_proto_len
)) {
3703 s
->ext
.npn_len
= (unsigned char)next_proto_len
;
3705 return MSG_PROCESS_CONTINUE_READING
;
3707 ssl3_send_alert(s
, SSL3_AL_FATAL
, al
);
3708 ossl_statem_set_error(s
);
3709 return MSG_PROCESS_ERROR
;
3713 static int tls_construct_encrypted_extensions(SSL
*s
, WPACKET
*pkt
)
3717 if (!tls_construct_extensions(s
, pkt
, SSL_EXT_TLS1_3_ENCRYPTED_EXTENSIONS
,
3719 ssl3_send_alert(s
, SSL3_AL_FATAL
, al
);
3720 SSLerr(SSL_F_TLS_CONSTRUCT_ENCRYPTED_EXTENSIONS
, ERR_R_INTERNAL_ERROR
);
3727 static int tls_construct_hello_retry_request(SSL
*s
, WPACKET
*pkt
)
3729 int al
= SSL_AD_INTERNAL_ERROR
;
3733 * TODO(TLS1.3): Remove the DRAFT version before release
3734 * (should be s->version)
3736 if (!WPACKET_put_bytes_u16(pkt
, TLS1_3_VERSION_DRAFT
)
3737 || !s
->method
->put_cipher_by_char(s
->s3
->tmp
.new_cipher
, pkt
, &len
)
3738 || !tls_construct_extensions(s
, pkt
,
3739 SSL_EXT_TLS1_3_HELLO_RETRY_REQUEST
,
3741 SSLerr(SSL_F_TLS_CONSTRUCT_HELLO_RETRY_REQUEST
, ERR_R_INTERNAL_ERROR
);
3745 /* Ditch the session. We'll create a new one next time around */
3746 SSL_SESSION_free(s
->session
);
3751 * Re-initialise the Transcript Hash. We're going to prepopulate it with
3752 * a synthetic message_hash in place of ClientHello1.
3754 if (!create_synthetic_message_hash(s
))
3759 ssl3_send_alert(s
, SSL3_AL_FATAL
, al
);
3763 MSG_PROCESS_RETURN
tls_process_end_of_early_data(SSL
*s
, PACKET
*pkt
)
3765 int al
= SSL_AD_INTERNAL_ERROR
;
3767 if (PACKET_remaining(pkt
) != 0) {
3768 al
= SSL_AD_DECODE_ERROR
;
3769 SSLerr(SSL_F_TLS_PROCESS_END_OF_EARLY_DATA
, SSL_R_LENGTH_MISMATCH
);
3770 ossl_statem_set_error(s
);
3771 return MSG_PROCESS_ERROR
;
3774 if (s
->early_data_state
!= SSL_EARLY_DATA_READING
3775 && s
->early_data_state
!= SSL_EARLY_DATA_READ_RETRY
) {
3776 SSLerr(SSL_F_TLS_PROCESS_END_OF_EARLY_DATA
, ERR_R_INTERNAL_ERROR
);
3781 * EndOfEarlyData signals a key change so the end of the message must be on
3782 * a record boundary.
3784 if (RECORD_LAYER_processed_read_pending(&s
->rlayer
)) {
3785 al
= SSL_AD_UNEXPECTED_MESSAGE
;
3786 SSLerr(SSL_F_TLS_PROCESS_END_OF_EARLY_DATA
,
3787 SSL_R_NOT_ON_RECORD_BOUNDARY
);
3791 s
->early_data_state
= SSL_EARLY_DATA_FINISHED_READING
;
3792 if (!s
->method
->ssl3_enc
->change_cipher_state(s
,
3793 SSL3_CC_HANDSHAKE
| SSL3_CHANGE_CIPHER_SERVER_READ
)) {
3794 SSLerr(SSL_F_TLS_PROCESS_END_OF_EARLY_DATA
, ERR_R_INTERNAL_ERROR
);
3798 return MSG_PROCESS_CONTINUE_READING
;
3800 ssl3_send_alert(s
, SSL3_AL_FATAL
, al
);
3801 ossl_statem_set_error(s
);
3802 return MSG_PROCESS_ERROR
;