cd90f3a241
When the peer or caller requests a renegotiation, OpenSSL doesn't renegotiate immediately. It sets a flag to begin a renegotiation as soon as record-layer read and write buffers are clear. One reason is that OpenSSL's record layer cannot write a handshake record while an application data record is being written. The buffer consistency checks around partial writes will break. None of these cases are relevant for the client auth hack. We already require that renego come in at a quiescent part of the application protocol by forbidding handshake/app_data interleave. The new behavior is now: when a HelloRequest comes in, if the record layer is not idle, the renegotiation is rejected as if SSL_set_reject_peer_renegotiations were set. Otherwise we immediately begin the new handshake. The server may not send any application data between HelloRequest and completing the handshake. The HelloRequest may not be consumed if an SSL_write is pending. Note this does require that Chromium's HTTP stack not attempt to read the HTTP response until the request has been written, but the renegotiation logic already assumes it. Were Chromium to drive the SSL_read state machine early and the server, say, sent a HelloRequest after reading the request headers but before we've sent the whole POST body, the SSL state machine may racily enter renegotiate early, block writing the POST body on the new handshake, which would break Chromium's ERR_SSL_CLIENT_AUTH_CERT_NEEDED plumbing. BUG=429450 Change-Id: I6278240c3bceb5d2e1a2195bdb62dd9e0f4df718 Reviewed-on: https://boringssl-review.googlesource.com/4825 Reviewed-by: Adam Langley <agl@google.com>
682 lines
28 KiB
C
682 lines
28 KiB
C
/* ssl/ssl3.h */
|
|
/* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
|
|
* All rights reserved.
|
|
*
|
|
* This package is an SSL implementation written
|
|
* by Eric Young (eay@cryptsoft.com).
|
|
* The implementation was written so as to conform with Netscapes SSL.
|
|
*
|
|
* This library is free for commercial and non-commercial use as long as
|
|
* the following conditions are aheared to. The following conditions
|
|
* apply to all code found in this distribution, be it the RC4, RSA,
|
|
* lhash, DES, etc., code; not just the SSL code. The SSL documentation
|
|
* included with this distribution is covered by the same copyright terms
|
|
* except that the holder is Tim Hudson (tjh@cryptsoft.com).
|
|
*
|
|
* Copyright remains Eric Young's, and as such any Copyright notices in
|
|
* the code are not to be removed.
|
|
* If this package is used in a product, Eric Young should be given attribution
|
|
* as the author of the parts of the library used.
|
|
* This can be in the form of a textual message at program startup or
|
|
* in documentation (online or textual) provided with the package.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
* 1. Redistributions of source code must retain the copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
* documentation and/or other materials provided with the distribution.
|
|
* 3. All advertising materials mentioning features or use of this software
|
|
* must display the following acknowledgement:
|
|
* "This product includes cryptographic software written by
|
|
* Eric Young (eay@cryptsoft.com)"
|
|
* The word 'cryptographic' can be left out if the rouines from the library
|
|
* being used are not cryptographic related :-).
|
|
* 4. If you include any Windows specific code (or a derivative thereof) from
|
|
* the apps directory (application code) you must include an acknowledgement:
|
|
* "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
|
|
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
* ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
|
|
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
* SUCH DAMAGE.
|
|
*
|
|
* The licence and distribution terms for any publically available version or
|
|
* derivative of this code cannot be changed. i.e. this code cannot simply be
|
|
* copied and put under another distribution licence
|
|
* [including the GNU Public Licence.]
|
|
*/
|
|
/* ====================================================================
|
|
* Copyright (c) 1998-2002 The OpenSSL Project. All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
*
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
*
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in
|
|
* the documentation and/or other materials provided with the
|
|
* distribution.
|
|
*
|
|
* 3. All advertising materials mentioning features or use of this
|
|
* software must display the following acknowledgment:
|
|
* "This product includes software developed by the OpenSSL Project
|
|
* for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
|
|
*
|
|
* 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
|
|
* endorse or promote products derived from this software without
|
|
* prior written permission. For written permission, please contact
|
|
* openssl-core@openssl.org.
|
|
*
|
|
* 5. Products derived from this software may not be called "OpenSSL"
|
|
* nor may "OpenSSL" appear in their names without prior written
|
|
* permission of the OpenSSL Project.
|
|
*
|
|
* 6. Redistributions of any form whatsoever must retain the following
|
|
* acknowledgment:
|
|
* "This product includes software developed by the OpenSSL Project
|
|
* for use in the OpenSSL Toolkit (http://www.openssl.org/)"
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
|
|
* EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
|
|
* PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
|
|
* ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
|
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
|
* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
|
|
* LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
|
|
* STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
|
|
* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
|
|
* OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
* ====================================================================
|
|
*
|
|
* This product includes cryptographic software written by Eric Young
|
|
* (eay@cryptsoft.com). This product includes software written by Tim
|
|
* Hudson (tjh@cryptsoft.com).
|
|
*
|
|
*/
|
|
/* ====================================================================
|
|
* Copyright 2002 Sun Microsystems, Inc. ALL RIGHTS RESERVED.
|
|
* ECC cipher suite support in OpenSSL originally developed by
|
|
* SUN MICROSYSTEMS, INC., and contributed to the OpenSSL project.
|
|
*/
|
|
|
|
#ifndef HEADER_SSL3_H
|
|
#define HEADER_SSL3_H
|
|
|
|
#include <openssl/aead.h>
|
|
#include <openssl/buf.h>
|
|
#include <openssl/evp.h>
|
|
#include <openssl/ssl.h>
|
|
#include <openssl/type_check.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
|
|
/* Signalling cipher suite value: from RFC5746 */
|
|
#define SSL3_CK_SCSV 0x030000FF
|
|
/* Fallback signalling cipher suite value: not IANA assigned.
|
|
* See https://tools.ietf.org/html/draft-bmoeller-tls-downgrade-scsv-01 */
|
|
#define SSL3_CK_FALLBACK_SCSV 0x03005600
|
|
|
|
#define SSL3_CK_RSA_NULL_MD5 0x03000001
|
|
#define SSL3_CK_RSA_NULL_SHA 0x03000002
|
|
#define SSL3_CK_RSA_RC4_40_MD5 0x03000003
|
|
#define SSL3_CK_RSA_RC4_128_MD5 0x03000004
|
|
#define SSL3_CK_RSA_RC4_128_SHA 0x03000005
|
|
#define SSL3_CK_RSA_RC2_40_MD5 0x03000006
|
|
#define SSL3_CK_RSA_IDEA_128_SHA 0x03000007
|
|
#define SSL3_CK_RSA_DES_40_CBC_SHA 0x03000008
|
|
#define SSL3_CK_RSA_DES_64_CBC_SHA 0x03000009
|
|
#define SSL3_CK_RSA_DES_192_CBC3_SHA 0x0300000A
|
|
|
|
#define SSL3_CK_DH_DSS_DES_40_CBC_SHA 0x0300000B
|
|
#define SSL3_CK_DH_DSS_DES_64_CBC_SHA 0x0300000C
|
|
#define SSL3_CK_DH_DSS_DES_192_CBC3_SHA 0x0300000D
|
|
#define SSL3_CK_DH_RSA_DES_40_CBC_SHA 0x0300000E
|
|
#define SSL3_CK_DH_RSA_DES_64_CBC_SHA 0x0300000F
|
|
#define SSL3_CK_DH_RSA_DES_192_CBC3_SHA 0x03000010
|
|
|
|
#define SSL3_CK_EDH_DSS_DES_40_CBC_SHA 0x03000011
|
|
#define SSL3_CK_EDH_DSS_DES_64_CBC_SHA 0x03000012
|
|
#define SSL3_CK_EDH_DSS_DES_192_CBC3_SHA 0x03000013
|
|
#define SSL3_CK_EDH_RSA_DES_40_CBC_SHA 0x03000014
|
|
#define SSL3_CK_EDH_RSA_DES_64_CBC_SHA 0x03000015
|
|
#define SSL3_CK_EDH_RSA_DES_192_CBC3_SHA 0x03000016
|
|
|
|
#define SSL3_CK_ADH_RC4_40_MD5 0x03000017
|
|
#define SSL3_CK_ADH_RC4_128_MD5 0x03000018
|
|
#define SSL3_CK_ADH_DES_40_CBC_SHA 0x03000019
|
|
#define SSL3_CK_ADH_DES_64_CBC_SHA 0x0300001A
|
|
#define SSL3_CK_ADH_DES_192_CBC_SHA 0x0300001B
|
|
|
|
#define SSL3_TXT_RSA_NULL_MD5 "NULL-MD5"
|
|
#define SSL3_TXT_RSA_NULL_SHA "NULL-SHA"
|
|
#define SSL3_TXT_RSA_RC4_40_MD5 "EXP-RC4-MD5"
|
|
#define SSL3_TXT_RSA_RC4_128_MD5 "RC4-MD5"
|
|
#define SSL3_TXT_RSA_RC4_128_SHA "RC4-SHA"
|
|
#define SSL3_TXT_RSA_RC2_40_MD5 "EXP-RC2-CBC-MD5"
|
|
#define SSL3_TXT_RSA_IDEA_128_SHA "IDEA-CBC-SHA"
|
|
#define SSL3_TXT_RSA_DES_40_CBC_SHA "EXP-DES-CBC-SHA"
|
|
#define SSL3_TXT_RSA_DES_64_CBC_SHA "DES-CBC-SHA"
|
|
#define SSL3_TXT_RSA_DES_192_CBC3_SHA "DES-CBC3-SHA"
|
|
|
|
#define SSL3_TXT_DH_DSS_DES_40_CBC_SHA "EXP-DH-DSS-DES-CBC-SHA"
|
|
#define SSL3_TXT_DH_DSS_DES_64_CBC_SHA "DH-DSS-DES-CBC-SHA"
|
|
#define SSL3_TXT_DH_DSS_DES_192_CBC3_SHA "DH-DSS-DES-CBC3-SHA"
|
|
#define SSL3_TXT_DH_RSA_DES_40_CBC_SHA "EXP-DH-RSA-DES-CBC-SHA"
|
|
#define SSL3_TXT_DH_RSA_DES_64_CBC_SHA "DH-RSA-DES-CBC-SHA"
|
|
#define SSL3_TXT_DH_RSA_DES_192_CBC3_SHA "DH-RSA-DES-CBC3-SHA"
|
|
|
|
#define SSL3_TXT_EDH_DSS_DES_40_CBC_SHA "EXP-EDH-DSS-DES-CBC-SHA"
|
|
#define SSL3_TXT_EDH_DSS_DES_64_CBC_SHA "EDH-DSS-DES-CBC-SHA"
|
|
#define SSL3_TXT_EDH_DSS_DES_192_CBC3_SHA "EDH-DSS-DES-CBC3-SHA"
|
|
#define SSL3_TXT_EDH_RSA_DES_40_CBC_SHA "EXP-EDH-RSA-DES-CBC-SHA"
|
|
#define SSL3_TXT_EDH_RSA_DES_64_CBC_SHA "EDH-RSA-DES-CBC-SHA"
|
|
#define SSL3_TXT_EDH_RSA_DES_192_CBC3_SHA "EDH-RSA-DES-CBC3-SHA"
|
|
|
|
#define SSL3_TXT_ADH_RC4_40_MD5 "EXP-ADH-RC4-MD5"
|
|
#define SSL3_TXT_ADH_RC4_128_MD5 "ADH-RC4-MD5"
|
|
#define SSL3_TXT_ADH_DES_40_CBC_SHA "EXP-ADH-DES-CBC-SHA"
|
|
#define SSL3_TXT_ADH_DES_64_CBC_SHA "ADH-DES-CBC-SHA"
|
|
#define SSL3_TXT_ADH_DES_192_CBC_SHA "ADH-DES-CBC3-SHA"
|
|
|
|
#define SSL3_SSL_SESSION_ID_LENGTH 32
|
|
#define SSL3_MAX_SSL_SESSION_ID_LENGTH 32
|
|
|
|
#define SSL3_MASTER_SECRET_SIZE 48
|
|
#define SSL3_RANDOM_SIZE 32
|
|
#define SSL3_SESSION_ID_SIZE 32
|
|
#define SSL3_RT_HEADER_LENGTH 5
|
|
|
|
#define SSL3_HM_HEADER_LENGTH 4
|
|
|
|
#ifndef SSL3_ALIGN_PAYLOAD
|
|
/* Some will argue that this increases memory footprint, but it's not actually
|
|
* true. Point is that malloc has to return at least 64-bit aligned pointers,
|
|
* meaning that allocating 5 bytes wastes 3 bytes in either case. Suggested
|
|
* pre-gaping simply moves these wasted bytes from the end of allocated region
|
|
* to its front, but makes data payload aligned, which improves performance. */
|
|
#define SSL3_ALIGN_PAYLOAD 8
|
|
#else
|
|
#if (SSL3_ALIGN_PAYLOAD & (SSL3_ALIGN_PAYLOAD - 1)) != 0
|
|
#error "insane SSL3_ALIGN_PAYLOAD"
|
|
#undef SSL3_ALIGN_PAYLOAD
|
|
#endif
|
|
#endif
|
|
|
|
/* This is the maximum MAC (digest) size used by the SSL library. Currently
|
|
* maximum of 20 is used by SHA1, but we reserve for future extension for
|
|
* 512-bit hashes. */
|
|
|
|
#define SSL3_RT_MAX_MD_SIZE 64
|
|
|
|
/* Maximum block size used in all ciphersuites. Currently 16 for AES. */
|
|
|
|
#define SSL_RT_MAX_CIPHER_BLOCK_SIZE 16
|
|
|
|
#define SSL3_RT_MAX_EXTRA (16384)
|
|
|
|
/* Maximum plaintext length: defined by SSL/TLS standards */
|
|
#define SSL3_RT_MAX_PLAIN_LENGTH 16384
|
|
/* Maximum compression overhead: defined by SSL/TLS standards */
|
|
#define SSL3_RT_MAX_COMPRESSED_OVERHEAD 1024
|
|
|
|
/* The standards give a maximum encryption overhead of 1024 bytes. In practice
|
|
* the value is lower than this. The overhead is the maximum number of padding
|
|
* bytes (256) plus the mac size.
|
|
*
|
|
* TODO(davidben): This derivation doesn't take AEADs into account, or TLS 1.1
|
|
* explicit nonces. It happens to work because |SSL3_RT_MAX_MD_SIZE| is larger
|
|
* than necessary and no true AEAD has variable overhead in TLS 1.2. */
|
|
#define SSL3_RT_MAX_ENCRYPTED_OVERHEAD (256 + SSL3_RT_MAX_MD_SIZE)
|
|
|
|
/* SSL3_RT_SEND_MAX_ENCRYPTED_OVERHEAD is the maximum overhead in encrypting a
|
|
* record. This does not include the record header. Some ciphers use explicit
|
|
* nonces, so it includes both the AEAD overhead as well as the nonce. */
|
|
#define SSL3_RT_SEND_MAX_ENCRYPTED_OVERHEAD \
|
|
(EVP_AEAD_MAX_OVERHEAD + EVP_AEAD_MAX_NONCE_LENGTH)
|
|
|
|
OPENSSL_COMPILE_ASSERT(
|
|
SSL3_RT_MAX_ENCRYPTED_OVERHEAD >= SSL3_RT_SEND_MAX_ENCRYPTED_OVERHEAD,
|
|
max_overheads_are_consistent);
|
|
|
|
/* SSL3_RT_MAX_COMPRESSED_LENGTH is an alias for
|
|
* |SSL3_RT_MAX_PLAIN_LENGTH|. Compression is gone, so don't include the
|
|
* compression overhead. */
|
|
#define SSL3_RT_MAX_COMPRESSED_LENGTH SSL3_RT_MAX_PLAIN_LENGTH
|
|
|
|
#define SSL3_RT_MAX_ENCRYPTED_LENGTH \
|
|
(SSL3_RT_MAX_ENCRYPTED_OVERHEAD + SSL3_RT_MAX_COMPRESSED_LENGTH)
|
|
#define SSL3_RT_MAX_PACKET_SIZE \
|
|
(SSL3_RT_MAX_ENCRYPTED_LENGTH + SSL3_RT_HEADER_LENGTH)
|
|
|
|
#define SSL3_MD_CLIENT_FINISHED_CONST "\x43\x4C\x4E\x54"
|
|
#define SSL3_MD_SERVER_FINISHED_CONST "\x53\x52\x56\x52"
|
|
|
|
#define SSL3_VERSION 0x0300
|
|
#define SSL3_VERSION_MAJOR 0x03
|
|
#define SSL3_VERSION_MINOR 0x00
|
|
|
|
#define SSL3_RT_CHANGE_CIPHER_SPEC 20
|
|
#define SSL3_RT_ALERT 21
|
|
#define SSL3_RT_HANDSHAKE 22
|
|
#define SSL3_RT_APPLICATION_DATA 23
|
|
|
|
/* Pseudo content types to indicate additional parameters */
|
|
#define TLS1_RT_CRYPTO 0x1000
|
|
#define TLS1_RT_CRYPTO_PREMASTER (TLS1_RT_CRYPTO | 0x1)
|
|
#define TLS1_RT_CRYPTO_CLIENT_RANDOM (TLS1_RT_CRYPTO | 0x2)
|
|
#define TLS1_RT_CRYPTO_SERVER_RANDOM (TLS1_RT_CRYPTO | 0x3)
|
|
#define TLS1_RT_CRYPTO_MASTER (TLS1_RT_CRYPTO | 0x4)
|
|
|
|
#define TLS1_RT_CRYPTO_READ 0x0000
|
|
#define TLS1_RT_CRYPTO_WRITE 0x0100
|
|
#define TLS1_RT_CRYPTO_MAC (TLS1_RT_CRYPTO | 0x5)
|
|
#define TLS1_RT_CRYPTO_KEY (TLS1_RT_CRYPTO | 0x6)
|
|
#define TLS1_RT_CRYPTO_IV (TLS1_RT_CRYPTO | 0x7)
|
|
#define TLS1_RT_CRYPTO_FIXED_IV (TLS1_RT_CRYPTO | 0x8)
|
|
|
|
/* Pseudo content type for SSL/TLS header info */
|
|
#define SSL3_RT_HEADER 0x100
|
|
|
|
#define SSL3_AL_WARNING 1
|
|
#define SSL3_AL_FATAL 2
|
|
|
|
#define SSL3_AD_CLOSE_NOTIFY 0
|
|
#define SSL3_AD_UNEXPECTED_MESSAGE 10 /* fatal */
|
|
#define SSL3_AD_BAD_RECORD_MAC 20 /* fatal */
|
|
#define SSL3_AD_DECOMPRESSION_FAILURE 30 /* fatal */
|
|
#define SSL3_AD_HANDSHAKE_FAILURE 40 /* fatal */
|
|
#define SSL3_AD_NO_CERTIFICATE 41
|
|
#define SSL3_AD_BAD_CERTIFICATE 42
|
|
#define SSL3_AD_UNSUPPORTED_CERTIFICATE 43
|
|
#define SSL3_AD_CERTIFICATE_REVOKED 44
|
|
#define SSL3_AD_CERTIFICATE_EXPIRED 45
|
|
#define SSL3_AD_CERTIFICATE_UNKNOWN 46
|
|
#define SSL3_AD_ILLEGAL_PARAMETER 47 /* fatal */
|
|
#define SSL3_AD_INAPPROPRIATE_FALLBACK 86 /* fatal */
|
|
|
|
typedef struct ssl3_record_st {
|
|
/* type is the record type. */
|
|
uint8_t type;
|
|
/* length is the number of unconsumed bytes of |data|. */
|
|
uint16_t length;
|
|
/* off is the number of consumed bytes of |data|. */
|
|
uint16_t off;
|
|
/* data is a non-owning pointer to the record contents. The total length of
|
|
* the buffer is |off| + |length|. */
|
|
uint8_t *data;
|
|
/* epoch, in DTLS, is the epoch number of the record. */
|
|
uint16_t epoch;
|
|
/* seq_num, in DTLS, is the sequence number of the record. The top two bytes
|
|
* are always zero.
|
|
*
|
|
* TODO(davidben): This is confusing. They should include the epoch or the
|
|
* field should be six bytes. */
|
|
uint8_t seq_num[8];
|
|
} SSL3_RECORD;
|
|
|
|
typedef struct ssl3_buffer_st {
|
|
uint8_t *buf; /* at least SSL3_RT_MAX_PACKET_SIZE bytes, see
|
|
ssl3_setup_buffers() */
|
|
size_t len; /* buffer size */
|
|
int offset; /* where to 'copy from' */
|
|
int left; /* how many bytes left */
|
|
} SSL3_BUFFER;
|
|
|
|
#define SSL3_CT_RSA_SIGN 1
|
|
#define SSL3_CT_DSS_SIGN 2
|
|
#define SSL3_CT_RSA_FIXED_DH 3
|
|
#define SSL3_CT_DSS_FIXED_DH 4
|
|
#define SSL3_CT_RSA_EPHEMERAL_DH 5
|
|
#define SSL3_CT_DSS_EPHEMERAL_DH 6
|
|
#define SSL3_CT_FORTEZZA_DMS 20
|
|
|
|
|
|
/* TODO(davidben): This flag can probably be merged into s3->change_cipher_spec
|
|
* to something tri-state. (Normal / Expect CCS / Between CCS and Finished). */
|
|
#define SSL3_FLAGS_EXPECT_CCS 0x0080
|
|
|
|
typedef struct ssl3_state_st {
|
|
long flags;
|
|
|
|
uint8_t read_sequence[8];
|
|
int read_mac_secret_size;
|
|
uint8_t read_mac_secret[EVP_MAX_MD_SIZE];
|
|
uint8_t write_sequence[8];
|
|
int write_mac_secret_size;
|
|
uint8_t write_mac_secret[EVP_MAX_MD_SIZE];
|
|
|
|
uint8_t server_random[SSL3_RANDOM_SIZE];
|
|
uint8_t client_random[SSL3_RANDOM_SIZE];
|
|
|
|
/* flags for countermeasure against known-IV weakness */
|
|
int need_record_splitting;
|
|
|
|
/* The value of 'extra' when the buffers were initialized */
|
|
int init_extra;
|
|
|
|
/* have_version is true if the connection's final version is known. Otherwise
|
|
* the version has not been negotiated yet. */
|
|
char have_version;
|
|
|
|
/* initial_handshake_complete is true if the initial handshake has
|
|
* completed. */
|
|
char initial_handshake_complete;
|
|
|
|
/* sniff_buffer is used by the server in the initial handshake to read a
|
|
* V2ClientHello before the record layer is initialized. */
|
|
BUF_MEM *sniff_buffer;
|
|
size_t sniff_buffer_len;
|
|
|
|
SSL3_BUFFER rbuf; /* read IO goes into here */
|
|
SSL3_BUFFER wbuf; /* write IO goes into here */
|
|
|
|
SSL3_RECORD rrec; /* each decoded record goes in here */
|
|
|
|
/* storage for Handshake protocol data received but not yet processed by
|
|
* ssl3_read_bytes: */
|
|
uint8_t handshake_fragment[4];
|
|
unsigned int handshake_fragment_len;
|
|
|
|
/* partial write - check the numbers match */
|
|
unsigned int wnum; /* number of bytes sent so far */
|
|
int wpend_tot; /* number bytes written */
|
|
int wpend_type;
|
|
int wpend_ret; /* number of bytes submitted */
|
|
const uint8_t *wpend_buf;
|
|
|
|
/* used during startup, digest all incoming/outgoing packets */
|
|
BIO *handshake_buffer;
|
|
/* When set of handshake digests is determined, buffer is hashed and freed
|
|
* and MD_CTX-es for all required digests are stored in this array */
|
|
EVP_MD_CTX **handshake_dgst;
|
|
/* this is set whenerver we see a change_cipher_spec message come in when we
|
|
* are not looking for one */
|
|
int change_cipher_spec;
|
|
|
|
int warn_alert;
|
|
int fatal_alert;
|
|
/* we allow one fatal and one warning alert to be outstanding, send close
|
|
* alert via the warning alert */
|
|
int alert_dispatch;
|
|
uint8_t send_alert[2];
|
|
|
|
int total_renegotiations;
|
|
|
|
/* State pertaining to the pending handshake.
|
|
*
|
|
* TODO(davidben): State is current spread all over the place. Move
|
|
* pending handshake state here so it can be managed separately from
|
|
* established connection state in case of renegotiations. */
|
|
struct {
|
|
/* actually only need to be 16+20 for SSLv3 and 12 for TLS */
|
|
uint8_t finish_md[EVP_MAX_MD_SIZE * 2];
|
|
int finish_md_len;
|
|
uint8_t peer_finish_md[EVP_MAX_MD_SIZE * 2];
|
|
int peer_finish_md_len;
|
|
|
|
unsigned long message_size;
|
|
int message_type;
|
|
|
|
/* used to hold the new cipher we are going to use */
|
|
const SSL_CIPHER *new_cipher;
|
|
DH *dh;
|
|
|
|
EC_KEY *ecdh; /* holds short lived ECDH key */
|
|
|
|
/* used when SSL_ST_FLUSH_DATA is entered */
|
|
int next_state;
|
|
|
|
int reuse_message;
|
|
|
|
/* Client-only: cert_req determines if a client certificate is to be sent.
|
|
* This is 0 if no client Certificate message is to be sent, 1 if there is
|
|
* a client certificate, and 2 to send an empty client Certificate
|
|
* message. */
|
|
int cert_req;
|
|
|
|
/* Client-only: ca_names contains the list of CAs received in a
|
|
* CertificateRequest message. */
|
|
STACK_OF(X509_NAME) *ca_names;
|
|
|
|
/* Client-only: certificate_types contains the set of certificate types
|
|
* received in a CertificateRequest message. */
|
|
uint8_t *certificate_types;
|
|
size_t num_certificate_types;
|
|
|
|
int key_block_length;
|
|
uint8_t *key_block;
|
|
|
|
const EVP_AEAD *new_aead;
|
|
uint8_t new_mac_secret_len;
|
|
uint8_t new_fixed_iv_len;
|
|
uint8_t new_variable_iv_len;
|
|
|
|
/* Server-only: cert_request is true if a client certificate was
|
|
* requested. */
|
|
int cert_request;
|
|
|
|
/* certificate_status_expected is true if OCSP stapling was negotiated and
|
|
* the server is expected to send a CertificateStatus message. */
|
|
char certificate_status_expected;
|
|
|
|
/* peer_ecpointformatlist contains the EC point formats advertised by the
|
|
* peer. */
|
|
uint8_t *peer_ecpointformatlist;
|
|
size_t peer_ecpointformatlist_length;
|
|
|
|
/* Server-only: peer_ellipticcurvelist contains the EC curve IDs advertised
|
|
* by the peer. This is only set on the server's end. The server does not
|
|
* advertise this extension to the client. */
|
|
uint16_t *peer_ellipticcurvelist;
|
|
size_t peer_ellipticcurvelist_length;
|
|
|
|
/* extended_master_secret indicates whether the extended master secret
|
|
* computation is used in this handshake. Note that this is different from
|
|
* whether it was used for the current session. If this is a resumption
|
|
* handshake then EMS might be negotiated in the client and server hello
|
|
* messages, but it doesn't matter if the session that's being resumed
|
|
* didn't use it to create the master secret initially. */
|
|
char extended_master_secret;
|
|
|
|
/* Client-only: peer_psk_identity_hint is the psk_identity_hint sent by the
|
|
* server when using a PSK key exchange. */
|
|
char *peer_psk_identity_hint;
|
|
|
|
/* new_mac_secret_size is unused and exists only until wpa_supplicant can
|
|
* be updated. It is only needed for EAP-FAST, which we don't support. */
|
|
uint8_t new_mac_secret_size;
|
|
|
|
/* Client-only: in_false_start is one if there is a pending handshake in
|
|
* False Start. The client may write data at this point. */
|
|
char in_false_start;
|
|
} tmp;
|
|
|
|
/* Connection binding to prevent renegotiation attacks */
|
|
uint8_t previous_client_finished[EVP_MAX_MD_SIZE];
|
|
uint8_t previous_client_finished_len;
|
|
uint8_t previous_server_finished[EVP_MAX_MD_SIZE];
|
|
uint8_t previous_server_finished_len;
|
|
int send_connection_binding; /* TODOEKR */
|
|
|
|
/* Set if we saw the Next Protocol Negotiation extension from our peer. */
|
|
int next_proto_neg_seen;
|
|
|
|
/* ALPN information
|
|
* (we are in the process of transitioning from NPN to ALPN.) */
|
|
|
|
/* In a server these point to the selected ALPN protocol after the
|
|
* ClientHello has been processed. In a client these contain the protocol
|
|
* that the server selected once the ServerHello has been processed. */
|
|
uint8_t *alpn_selected;
|
|
size_t alpn_selected_len;
|
|
|
|
/* In a client, this means that the server supported Channel ID and that a
|
|
* Channel ID was sent. In a server it means that we echoed support for
|
|
* Channel IDs and that tlsext_channel_id will be valid after the
|
|
* handshake. */
|
|
char tlsext_channel_id_valid;
|
|
/* tlsext_channel_id_new means that the updated Channel ID extension was
|
|
* negotiated. This is a temporary hack in the code to support both forms of
|
|
* Channel ID extension while we transition to the new format, which fixed a
|
|
* security issue. */
|
|
char tlsext_channel_id_new;
|
|
/* For a server:
|
|
* If |tlsext_channel_id_valid| is true, then this contains the
|
|
* verified Channel ID from the client: a P256 point, (x,y), where
|
|
* each are big-endian values. */
|
|
uint8_t tlsext_channel_id[64];
|
|
} SSL3_STATE;
|
|
|
|
/* SSLv3 */
|
|
/* client */
|
|
/* extra state */
|
|
#define SSL3_ST_CW_FLUSH (0x100 | SSL_ST_CONNECT)
|
|
#define SSL3_ST_FALSE_START (0x101 | SSL_ST_CONNECT)
|
|
/* write to server */
|
|
#define SSL3_ST_CW_CLNT_HELLO_A (0x110 | SSL_ST_CONNECT)
|
|
#define SSL3_ST_CW_CLNT_HELLO_B (0x111 | SSL_ST_CONNECT)
|
|
/* read from server */
|
|
#define SSL3_ST_CR_SRVR_HELLO_A (0x120 | SSL_ST_CONNECT)
|
|
#define SSL3_ST_CR_SRVR_HELLO_B (0x121 | SSL_ST_CONNECT)
|
|
#define DTLS1_ST_CR_HELLO_VERIFY_REQUEST_A (0x126 | SSL_ST_CONNECT)
|
|
#define DTLS1_ST_CR_HELLO_VERIFY_REQUEST_B (0x127 | SSL_ST_CONNECT)
|
|
#define SSL3_ST_CR_CERT_A (0x130 | SSL_ST_CONNECT)
|
|
#define SSL3_ST_CR_CERT_B (0x131 | SSL_ST_CONNECT)
|
|
#define SSL3_ST_CR_KEY_EXCH_A (0x140 | SSL_ST_CONNECT)
|
|
#define SSL3_ST_CR_KEY_EXCH_B (0x141 | SSL_ST_CONNECT)
|
|
#define SSL3_ST_CR_CERT_REQ_A (0x150 | SSL_ST_CONNECT)
|
|
#define SSL3_ST_CR_CERT_REQ_B (0x151 | SSL_ST_CONNECT)
|
|
#define SSL3_ST_CR_SRVR_DONE_A (0x160 | SSL_ST_CONNECT)
|
|
#define SSL3_ST_CR_SRVR_DONE_B (0x161 | SSL_ST_CONNECT)
|
|
/* write to server */
|
|
#define SSL3_ST_CW_CERT_A (0x170 | SSL_ST_CONNECT)
|
|
#define SSL3_ST_CW_CERT_B (0x171 | SSL_ST_CONNECT)
|
|
#define SSL3_ST_CW_CERT_C (0x172 | SSL_ST_CONNECT)
|
|
#define SSL3_ST_CW_CERT_D (0x173 | SSL_ST_CONNECT)
|
|
#define SSL3_ST_CW_KEY_EXCH_A (0x180 | SSL_ST_CONNECT)
|
|
#define SSL3_ST_CW_KEY_EXCH_B (0x181 | SSL_ST_CONNECT)
|
|
#define SSL3_ST_CW_CERT_VRFY_A (0x190 | SSL_ST_CONNECT)
|
|
#define SSL3_ST_CW_CERT_VRFY_B (0x191 | SSL_ST_CONNECT)
|
|
#define SSL3_ST_CW_CHANGE_A (0x1A0 | SSL_ST_CONNECT)
|
|
#define SSL3_ST_CW_CHANGE_B (0x1A1 | SSL_ST_CONNECT)
|
|
#define SSL3_ST_CW_NEXT_PROTO_A (0x200 | SSL_ST_CONNECT)
|
|
#define SSL3_ST_CW_NEXT_PROTO_B (0x201 | SSL_ST_CONNECT)
|
|
#define SSL3_ST_CW_CHANNEL_ID_A (0x220 | SSL_ST_CONNECT)
|
|
#define SSL3_ST_CW_CHANNEL_ID_B (0x221 | SSL_ST_CONNECT)
|
|
#define SSL3_ST_CW_FINISHED_A (0x1B0 | SSL_ST_CONNECT)
|
|
#define SSL3_ST_CW_FINISHED_B (0x1B1 | SSL_ST_CONNECT)
|
|
/* read from server */
|
|
#define SSL3_ST_CR_CHANGE (0x1C0 | SSL_ST_CONNECT)
|
|
#define SSL3_ST_CR_FINISHED_A (0x1D0 | SSL_ST_CONNECT)
|
|
#define SSL3_ST_CR_FINISHED_B (0x1D1 | SSL_ST_CONNECT)
|
|
#define SSL3_ST_CR_SESSION_TICKET_A (0x1E0 | SSL_ST_CONNECT)
|
|
#define SSL3_ST_CR_SESSION_TICKET_B (0x1E1 | SSL_ST_CONNECT)
|
|
#define SSL3_ST_CR_CERT_STATUS_A (0x1F0 | SSL_ST_CONNECT)
|
|
#define SSL3_ST_CR_CERT_STATUS_B (0x1F1 | SSL_ST_CONNECT)
|
|
|
|
/* server */
|
|
/* extra state */
|
|
#define SSL3_ST_SW_FLUSH (0x100 | SSL_ST_ACCEPT)
|
|
/* read from client */
|
|
#define SSL3_ST_SR_INITIAL_BYTES (0x240 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SR_V2_CLIENT_HELLO (0x241 | SSL_ST_ACCEPT)
|
|
/* Do not change the number values, they do matter */
|
|
#define SSL3_ST_SR_CLNT_HELLO_A (0x110 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SR_CLNT_HELLO_B (0x111 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SR_CLNT_HELLO_C (0x112 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SR_CLNT_HELLO_D (0x115 | SSL_ST_ACCEPT)
|
|
/* write to client */
|
|
#define SSL3_ST_SW_HELLO_REQ_A (0x120 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SW_HELLO_REQ_B (0x121 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SW_HELLO_REQ_C (0x122 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SW_SRVR_HELLO_A (0x130 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SW_SRVR_HELLO_B (0x131 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SW_CERT_A (0x140 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SW_CERT_B (0x141 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SW_KEY_EXCH_A (0x150 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SW_KEY_EXCH_B (0x151 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SW_CERT_REQ_A (0x160 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SW_CERT_REQ_B (0x161 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SW_SRVR_DONE_A (0x170 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SW_SRVR_DONE_B (0x171 | SSL_ST_ACCEPT)
|
|
/* read from client */
|
|
#define SSL3_ST_SR_CERT_A (0x180 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SR_CERT_B (0x181 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SR_KEY_EXCH_A (0x190 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SR_KEY_EXCH_B (0x191 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SR_CERT_VRFY_A (0x1A0 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SR_CERT_VRFY_B (0x1A1 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SR_CHANGE (0x1B0 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SR_NEXT_PROTO_A (0x210 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SR_NEXT_PROTO_B (0x211 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SR_CHANNEL_ID_A (0x230 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SR_CHANNEL_ID_B (0x231 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SR_FINISHED_A (0x1C0 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SR_FINISHED_B (0x1C1 | SSL_ST_ACCEPT)
|
|
|
|
/* write to client */
|
|
#define SSL3_ST_SW_CHANGE_A (0x1D0 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SW_CHANGE_B (0x1D1 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SW_FINISHED_A (0x1E0 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SW_FINISHED_B (0x1E1 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SW_SESSION_TICKET_A (0x1F0 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SW_SESSION_TICKET_B (0x1F1 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SW_CERT_STATUS_A (0x200 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SW_CERT_STATUS_B (0x201 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SW_SUPPLEMENTAL_DATA_A (0x220 | SSL_ST_ACCEPT)
|
|
#define SSL3_ST_SW_SUPPLEMENTAL_DATA_B (0x221 | SSL_ST_ACCEPT)
|
|
|
|
#define SSL3_MT_HELLO_REQUEST 0
|
|
#define SSL3_MT_CLIENT_HELLO 1
|
|
#define SSL3_MT_SERVER_HELLO 2
|
|
#define SSL3_MT_NEWSESSION_TICKET 4
|
|
#define SSL3_MT_CERTIFICATE 11
|
|
#define SSL3_MT_SERVER_KEY_EXCHANGE 12
|
|
#define SSL3_MT_CERTIFICATE_REQUEST 13
|
|
#define SSL3_MT_SERVER_DONE 14
|
|
#define SSL3_MT_CERTIFICATE_VERIFY 15
|
|
#define SSL3_MT_CLIENT_KEY_EXCHANGE 16
|
|
#define SSL3_MT_FINISHED 20
|
|
#define SSL3_MT_CERTIFICATE_STATUS 22
|
|
#define SSL3_MT_SUPPLEMENTAL_DATA 23
|
|
#define SSL3_MT_NEXT_PROTO 67
|
|
#define SSL3_MT_ENCRYPTED_EXTENSIONS 203
|
|
#define DTLS1_MT_HELLO_VERIFY_REQUEST 3
|
|
|
|
|
|
#define SSL3_MT_CCS 1
|
|
|
|
/* These are used when changing over to a new cipher */
|
|
#define SSL3_CC_READ 0x01
|
|
#define SSL3_CC_WRITE 0x02
|
|
#define SSL3_CC_CLIENT 0x10
|
|
#define SSL3_CC_SERVER 0x20
|
|
#define SSL3_CHANGE_CIPHER_CLIENT_WRITE (SSL3_CC_CLIENT | SSL3_CC_WRITE)
|
|
#define SSL3_CHANGE_CIPHER_SERVER_READ (SSL3_CC_SERVER | SSL3_CC_READ)
|
|
#define SSL3_CHANGE_CIPHER_CLIENT_READ (SSL3_CC_CLIENT | SSL3_CC_READ)
|
|
#define SSL3_CHANGE_CIPHER_SERVER_WRITE (SSL3_CC_SERVER | SSL3_CC_WRITE)
|
|
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
#endif
|