1 /* 2 * Copyright 1995-2025 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. 5 * 6 * Licensed under the Apache License 2.0 (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 10 */ 11 12 #ifndef OSSL_SSL_LOCAL_H 13 # define OSSL_SSL_LOCAL_H 14 15 # include <stdlib.h> 16 # include <time.h> 17 # include <errno.h> 18 # include "internal/common.h" /* for HAS_PREFIX */ 19 20 # include <openssl/buffer.h> 21 # include <openssl/bio.h> 22 # include <openssl/comp.h> 23 # include <openssl/dsa.h> 24 # include <openssl/err.h> 25 # include <openssl/ssl.h> 26 # include <openssl/async.h> 27 # include <openssl/symhacks.h> 28 # include <openssl/ct.h> 29 # include "internal/recordmethod.h" 30 # include "internal/statem.h" 31 # include "internal/packet.h" 32 # include "internal/dane.h" 33 # include "internal/refcount.h" 34 # include "internal/tsan_assist.h" 35 # include "internal/bio.h" 36 # include "internal/ktls.h" 37 # include "internal/time.h" 38 # include "internal/ssl.h" 39 # include "internal/cryptlib.h" 40 # include "internal/quic_predef.h" 41 # include "record/record.h" 42 # include "internal/quic_predef.h" 43 # include "internal/quic_tls.h" 44 45 # ifdef OPENSSL_BUILD_SHLIBSSL 46 # undef OPENSSL_EXTERN 47 # define OPENSSL_EXTERN OPENSSL_EXPORT 48 # endif 49 50 # define TLS_MAX_VERSION_INTERNAL TLS1_3_VERSION 51 # define DTLS_MAX_VERSION_INTERNAL DTLS1_2_VERSION 52 53 /* 54 * DTLS version numbers are strange because they're inverted. Except for 55 * DTLS1_BAD_VER, which should be considered "lower" than the rest. 56 */ 57 # define dtls_ver_ordinal(v1) (((v1) == DTLS1_BAD_VER) ? 0xff00 : (v1)) 58 # define DTLS_VERSION_GT(v1, v2) (dtls_ver_ordinal(v1) < dtls_ver_ordinal(v2)) 59 # define DTLS_VERSION_GE(v1, v2) (dtls_ver_ordinal(v1) <= dtls_ver_ordinal(v2)) 60 # define DTLS_VERSION_LT(v1, v2) (dtls_ver_ordinal(v1) > dtls_ver_ordinal(v2)) 61 # define DTLS_VERSION_LE(v1, v2) (dtls_ver_ordinal(v1) >= dtls_ver_ordinal(v2)) 62 63 # define SSL_AD_NO_ALERT -1 64 65 /* 66 * Define the Bitmasks for SSL_CIPHER.algorithms. 67 * This bits are used packed as dense as possible. If new methods/ciphers 68 * etc will be added, the bits a likely to change, so this information 69 * is for internal library use only, even though SSL_CIPHER.algorithms 70 * can be publicly accessed. 71 * Use the according functions for cipher management instead. 72 * 73 * The bit mask handling in the selection and sorting scheme in 74 * ssl_create_cipher_list() has only limited capabilities, reflecting 75 * that the different entities within are mutually exclusive: 76 * ONLY ONE BIT PER MASK CAN BE SET AT A TIME. 77 */ 78 79 /* Bits for algorithm_mkey (key exchange algorithm) */ 80 /* RSA key exchange */ 81 # define SSL_kRSA 0x00000001U 82 /* tmp DH key no DH cert */ 83 # define SSL_kDHE 0x00000002U 84 /* ephemeral ECDH */ 85 # define SSL_kECDHE 0x00000004U 86 /* PSK */ 87 # define SSL_kPSK 0x00000008U 88 /* GOST key exchange */ 89 # define SSL_kGOST 0x00000010U 90 /* SRP */ 91 # define SSL_kSRP 0x00000020U 92 93 # define SSL_kRSAPSK 0x00000040U 94 # define SSL_kECDHEPSK 0x00000080U 95 # define SSL_kDHEPSK 0x00000100U 96 /* GOST KDF key exchange, draft-smyshlyaev-tls12-gost-suites */ 97 # define SSL_kGOST18 0x00000200U 98 99 /* all PSK */ 100 101 # define SSL_PSK (SSL_kPSK | SSL_kRSAPSK | SSL_kECDHEPSK | SSL_kDHEPSK) 102 103 /* Any appropriate key exchange algorithm (for TLS 1.3 ciphersuites) */ 104 # define SSL_kANY 0x00000000U 105 106 /* Bits for algorithm_auth (server authentication) */ 107 /* RSA auth */ 108 # define SSL_aRSA 0x00000001U 109 /* DSS auth */ 110 # define SSL_aDSS 0x00000002U 111 /* no auth (i.e. use ADH or AECDH) */ 112 # define SSL_aNULL 0x00000004U 113 /* ECDSA auth*/ 114 # define SSL_aECDSA 0x00000008U 115 /* PSK auth */ 116 # define SSL_aPSK 0x00000010U 117 /* GOST R 34.10-2001 signature auth */ 118 # define SSL_aGOST01 0x00000020U 119 /* SRP auth */ 120 # define SSL_aSRP 0x00000040U 121 /* GOST R 34.10-2012 signature auth */ 122 # define SSL_aGOST12 0x00000080U 123 /* Any appropriate signature auth (for TLS 1.3 ciphersuites) */ 124 # define SSL_aANY 0x00000000U 125 /* All bits requiring a certificate */ 126 #define SSL_aCERT \ 127 (SSL_aRSA | SSL_aDSS | SSL_aECDSA | SSL_aGOST01 | SSL_aGOST12) 128 129 /* Bits for algorithm_enc (symmetric encryption) */ 130 # define SSL_DES 0x00000001U 131 # define SSL_3DES 0x00000002U 132 # define SSL_RC4 0x00000004U 133 # define SSL_RC2 0x00000008U 134 # define SSL_IDEA 0x00000010U 135 # define SSL_eNULL 0x00000020U 136 # define SSL_AES128 0x00000040U 137 # define SSL_AES256 0x00000080U 138 # define SSL_CAMELLIA128 0x00000100U 139 # define SSL_CAMELLIA256 0x00000200U 140 # define SSL_eGOST2814789CNT 0x00000400U 141 # define SSL_SEED 0x00000800U 142 # define SSL_AES128GCM 0x00001000U 143 # define SSL_AES256GCM 0x00002000U 144 # define SSL_AES128CCM 0x00004000U 145 # define SSL_AES256CCM 0x00008000U 146 # define SSL_AES128CCM8 0x00010000U 147 # define SSL_AES256CCM8 0x00020000U 148 # define SSL_eGOST2814789CNT12 0x00040000U 149 # define SSL_CHACHA20POLY1305 0x00080000U 150 # define SSL_ARIA128GCM 0x00100000U 151 # define SSL_ARIA256GCM 0x00200000U 152 # define SSL_MAGMA 0x00400000U 153 # define SSL_KUZNYECHIK 0x00800000U 154 155 # define SSL_AESGCM (SSL_AES128GCM | SSL_AES256GCM) 156 # define SSL_AESCCM (SSL_AES128CCM | SSL_AES256CCM | SSL_AES128CCM8 | SSL_AES256CCM8) 157 # define SSL_AES (SSL_AES128|SSL_AES256|SSL_AESGCM|SSL_AESCCM) 158 # define SSL_CAMELLIA (SSL_CAMELLIA128|SSL_CAMELLIA256) 159 # define SSL_CHACHA20 (SSL_CHACHA20POLY1305) 160 # define SSL_ARIAGCM (SSL_ARIA128GCM | SSL_ARIA256GCM) 161 # define SSL_ARIA (SSL_ARIAGCM) 162 # define SSL_CBC (SSL_DES | SSL_3DES | SSL_RC2 | SSL_IDEA \ 163 | SSL_AES128 | SSL_AES256 | SSL_CAMELLIA128 \ 164 | SSL_CAMELLIA256 | SSL_SEED) 165 166 /* Bits for algorithm_mac (symmetric authentication) */ 167 168 # define SSL_MD5 0x00000001U 169 # define SSL_SHA1 0x00000002U 170 # define SSL_GOST94 0x00000004U 171 # define SSL_GOST89MAC 0x00000008U 172 # define SSL_SHA256 0x00000010U 173 # define SSL_SHA384 0x00000020U 174 /* Not a real MAC, just an indication it is part of cipher */ 175 # define SSL_AEAD 0x00000040U 176 # define SSL_GOST12_256 0x00000080U 177 # define SSL_GOST89MAC12 0x00000100U 178 # define SSL_GOST12_512 0x00000200U 179 # define SSL_MAGMAOMAC 0x00000400U 180 # define SSL_KUZNYECHIKOMAC 0x00000800U 181 182 /* 183 * When adding new digest in the ssl_ciph.c and increment SSL_MD_NUM_IDX make 184 * sure to update this constant too 185 */ 186 187 # define SSL_MD_MD5_IDX 0 188 # define SSL_MD_SHA1_IDX 1 189 # define SSL_MD_GOST94_IDX 2 190 # define SSL_MD_GOST89MAC_IDX 3 191 # define SSL_MD_SHA256_IDX 4 192 # define SSL_MD_SHA384_IDX 5 193 # define SSL_MD_GOST12_256_IDX 6 194 # define SSL_MD_GOST89MAC12_IDX 7 195 # define SSL_MD_GOST12_512_IDX 8 196 # define SSL_MD_MD5_SHA1_IDX 9 197 # define SSL_MD_SHA224_IDX 10 198 # define SSL_MD_SHA512_IDX 11 199 # define SSL_MD_MAGMAOMAC_IDX 12 200 # define SSL_MD_KUZNYECHIKOMAC_IDX 13 201 # define SSL_MAX_DIGEST 14 202 203 #define SSL_MD_NUM_IDX SSL_MAX_DIGEST 204 205 /* Bits for algorithm2 (handshake digests and other extra flags) */ 206 207 /* Bits 0-7 are handshake MAC */ 208 # define SSL_HANDSHAKE_MAC_MASK 0xFF 209 # define SSL_HANDSHAKE_MAC_MD5_SHA1 SSL_MD_MD5_SHA1_IDX 210 # define SSL_HANDSHAKE_MAC_SHA256 SSL_MD_SHA256_IDX 211 # define SSL_HANDSHAKE_MAC_SHA384 SSL_MD_SHA384_IDX 212 # define SSL_HANDSHAKE_MAC_GOST94 SSL_MD_GOST94_IDX 213 # define SSL_HANDSHAKE_MAC_GOST12_256 SSL_MD_GOST12_256_IDX 214 # define SSL_HANDSHAKE_MAC_GOST12_512 SSL_MD_GOST12_512_IDX 215 # define SSL_HANDSHAKE_MAC_DEFAULT SSL_HANDSHAKE_MAC_MD5_SHA1 216 217 /* Bits 8-15 bits are PRF */ 218 # define TLS1_PRF_DGST_SHIFT 8 219 # define TLS1_PRF_SHA1_MD5 (SSL_MD_MD5_SHA1_IDX << TLS1_PRF_DGST_SHIFT) 220 # define TLS1_PRF_SHA256 (SSL_MD_SHA256_IDX << TLS1_PRF_DGST_SHIFT) 221 # define TLS1_PRF_SHA384 (SSL_MD_SHA384_IDX << TLS1_PRF_DGST_SHIFT) 222 # define TLS1_PRF_GOST94 (SSL_MD_GOST94_IDX << TLS1_PRF_DGST_SHIFT) 223 # define TLS1_PRF_GOST12_256 (SSL_MD_GOST12_256_IDX << TLS1_PRF_DGST_SHIFT) 224 # define TLS1_PRF_GOST12_512 (SSL_MD_GOST12_512_IDX << TLS1_PRF_DGST_SHIFT) 225 # define TLS1_PRF (SSL_MD_MD5_SHA1_IDX << TLS1_PRF_DGST_SHIFT) 226 227 /* 228 * Stream MAC for GOST ciphersuites from cryptopro draft (currently this also 229 * goes into algorithm2) 230 */ 231 # define TLS1_STREAM_MAC 0x10000 232 /* 233 * TLSTREE cipher/mac key derivation from draft-smyshlyaev-tls12-gost-suites 234 * (currently this also goes into algorithm2) 235 */ 236 # define TLS1_TLSTREE 0x20000 237 238 /* Ciphersuite supported in QUIC */ 239 # define SSL_QUIC 0x00040000U 240 241 # define SSL_STRONG_MASK 0x0000001FU 242 # define SSL_DEFAULT_MASK 0X00000020U 243 244 # define SSL_STRONG_NONE 0x00000001U 245 # define SSL_LOW 0x00000002U 246 # define SSL_MEDIUM 0x00000004U 247 # define SSL_HIGH 0x00000008U 248 # define SSL_FIPS 0x00000010U 249 # define SSL_NOT_DEFAULT 0x00000020U 250 251 /* we have used 0000003f - 26 bits left to go */ 252 253 /* Flag used on OpenSSL ciphersuite ids to indicate they are for SSLv3+ */ 254 # define SSL3_CK_CIPHERSUITE_FLAG 0x03000000 255 256 /* Check if an SSL structure is using DTLS */ 257 # define SSL_CONNECTION_IS_DTLS(s) \ 258 (SSL_CONNECTION_GET_SSL(s)->method->ssl3_enc->enc_flags & SSL_ENC_FLAG_DTLS) 259 260 /* Check if an SSL_CTX structure is using DTLS */ 261 # define SSL_CTX_IS_DTLS(ctx) \ 262 (ctx->method->ssl3_enc->enc_flags & SSL_ENC_FLAG_DTLS) 263 264 /* Check if we are using TLSv1.3 */ 265 # define SSL_CONNECTION_IS_TLS13(s) (!SSL_CONNECTION_IS_DTLS(s) \ 266 && SSL_CONNECTION_GET_SSL(s)->method->version >= TLS1_3_VERSION \ 267 && SSL_CONNECTION_GET_SSL(s)->method->version != TLS_ANY_VERSION) 268 269 # define SSL_CONNECTION_TREAT_AS_TLS13(s) \ 270 (SSL_CONNECTION_IS_TLS13(s) \ 271 || (s)->early_data_state == SSL_EARLY_DATA_CONNECTING \ 272 || (s)->early_data_state == SSL_EARLY_DATA_CONNECT_RETRY \ 273 || (s)->early_data_state == SSL_EARLY_DATA_WRITING \ 274 || (s)->early_data_state == SSL_EARLY_DATA_WRITE_RETRY \ 275 || (s)->hello_retry_request == SSL_HRR_PENDING) 276 277 # define SSL_IS_FIRST_HANDSHAKE(s) ((s)->s3.tmp.finish_md_len == 0 \ 278 || (s)->s3.tmp.peer_finish_md_len == 0) 279 280 /* 281 * See if we use signature algorithms extension and signature algorithm 282 * before signatures. 283 */ 284 # define SSL_USE_SIGALGS(s) \ 285 (SSL_CONNECTION_GET_SSL(s)->method->ssl3_enc->enc_flags & SSL_ENC_FLAG_SIGALGS) 286 /* 287 * Allow TLS 1.2 ciphersuites: applies to DTLS 1.2 as well as TLS 1.2: may 288 * apply to others in future. 289 */ 290 # define SSL_USE_TLS1_2_CIPHERS(s) \ 291 (SSL_CONNECTION_GET_SSL(s)->method->ssl3_enc->enc_flags & SSL_ENC_FLAG_TLS1_2_CIPHERS) 292 293 # define IS_MAX_FRAGMENT_LENGTH_EXT_VALID(value) \ 294 (((value) >= TLSEXT_max_fragment_length_512) && \ 295 ((value) <= TLSEXT_max_fragment_length_4096)) 296 # define USE_MAX_FRAGMENT_LENGTH_EXT(session) \ 297 IS_MAX_FRAGMENT_LENGTH_EXT_VALID(session->ext.max_fragment_len_mode) 298 # define GET_MAX_FRAGMENT_LENGTH(session) \ 299 (512U << (session->ext.max_fragment_len_mode - 1)) 300 301 # define SSL_READ_ETM(s) (s->s3.flags & TLS1_FLAGS_ENCRYPT_THEN_MAC_READ) 302 # define SSL_WRITE_ETM(s) (s->s3.flags & TLS1_FLAGS_ENCRYPT_THEN_MAC_WRITE) 303 304 # define SSL_IS_QUIC_HANDSHAKE(s) (((s)->s3.flags & TLS1_FLAGS_QUIC) != 0) 305 # define SSL_IS_QUIC_INT_HANDSHAKE(s) (((s)->s3.flags & TLS1_FLAGS_QUIC_INTERNAL) != 0) 306 307 /* no end of early data */ 308 # define SSL_NO_EOED(s) SSL_IS_QUIC_HANDSHAKE(s) 309 310 /* alert_dispatch values */ 311 312 /* No alert pending */ 313 # define SSL_ALERT_DISPATCH_NONE 0 314 /* Alert pending */ 315 # define SSL_ALERT_DISPATCH_PENDING 1 316 /* Pending alert write needs to be retried */ 317 # define SSL_ALERT_DISPATCH_RETRY 2 318 319 /* Mostly for SSLv3 */ 320 # define SSL_PKEY_RSA 0 321 # define SSL_PKEY_RSA_PSS_SIGN 1 322 # define SSL_PKEY_DSA_SIGN 2 323 # define SSL_PKEY_ECC 3 324 # define SSL_PKEY_GOST01 4 325 # define SSL_PKEY_GOST12_256 5 326 # define SSL_PKEY_GOST12_512 6 327 # define SSL_PKEY_ED25519 7 328 # define SSL_PKEY_ED448 8 329 # define SSL_PKEY_NUM 9 330 331 # define SSL_ENC_DES_IDX 0 332 # define SSL_ENC_3DES_IDX 1 333 # define SSL_ENC_RC4_IDX 2 334 # define SSL_ENC_RC2_IDX 3 335 # define SSL_ENC_IDEA_IDX 4 336 # define SSL_ENC_NULL_IDX 5 337 # define SSL_ENC_AES128_IDX 6 338 # define SSL_ENC_AES256_IDX 7 339 # define SSL_ENC_CAMELLIA128_IDX 8 340 # define SSL_ENC_CAMELLIA256_IDX 9 341 # define SSL_ENC_GOST89_IDX 10 342 # define SSL_ENC_SEED_IDX 11 343 # define SSL_ENC_AES128GCM_IDX 12 344 # define SSL_ENC_AES256GCM_IDX 13 345 # define SSL_ENC_AES128CCM_IDX 14 346 # define SSL_ENC_AES256CCM_IDX 15 347 # define SSL_ENC_AES128CCM8_IDX 16 348 # define SSL_ENC_AES256CCM8_IDX 17 349 # define SSL_ENC_GOST8912_IDX 18 350 # define SSL_ENC_CHACHA_IDX 19 351 # define SSL_ENC_ARIA128GCM_IDX 20 352 # define SSL_ENC_ARIA256GCM_IDX 21 353 # define SSL_ENC_MAGMA_IDX 22 354 # define SSL_ENC_KUZNYECHIK_IDX 23 355 # define SSL_ENC_NUM_IDX 24 356 357 /*- 358 * SSL_kRSA <- RSA_ENC 359 * SSL_kDH <- DH_ENC & (RSA_ENC | RSA_SIGN | DSA_SIGN) 360 * SSL_kDHE <- RSA_ENC | RSA_SIGN | DSA_SIGN 361 * SSL_aRSA <- RSA_ENC | RSA_SIGN 362 * SSL_aDSS <- DSA_SIGN 363 */ 364 365 /* Certificate Type State */ 366 # define OSSL_CERT_TYPE_CTOS_NONE 0 367 # define OSSL_CERT_TYPE_CTOS_GOOD 1 368 # define OSSL_CERT_TYPE_CTOS_ERROR 2 369 370 /* Post-Handshake Authentication state */ 371 typedef enum { 372 SSL_PHA_NONE = 0, 373 SSL_PHA_EXT_SENT, /* client-side only: extension sent */ 374 SSL_PHA_EXT_RECEIVED, /* server-side only: extension received */ 375 SSL_PHA_REQUEST_PENDING, /* server-side only: request pending */ 376 SSL_PHA_REQUESTED /* request received by client, or sent by server */ 377 } SSL_PHA_STATE; 378 379 /* CipherSuite length. SSLv3 and all TLS versions. */ 380 # define TLS_CIPHER_LEN 2 381 /* used to hold info on the particular ciphers used */ 382 struct ssl_cipher_st { 383 uint32_t valid; 384 const char *name; /* text name */ 385 const char *stdname; /* RFC name */ 386 uint32_t id; /* id, 4 bytes, first is version */ 387 /* 388 * changed in 1.0.0: these four used to be portions of a single value 389 * 'algorithms' 390 */ 391 uint32_t algorithm_mkey; /* key exchange algorithm */ 392 uint32_t algorithm_auth; /* server authentication */ 393 uint32_t algorithm_enc; /* symmetric encryption */ 394 uint32_t algorithm_mac; /* symmetric authentication */ 395 int min_tls; /* minimum SSL/TLS protocol version */ 396 int max_tls; /* maximum SSL/TLS protocol version */ 397 int min_dtls; /* minimum DTLS protocol version */ 398 int max_dtls; /* maximum DTLS protocol version */ 399 uint32_t algo_strength; /* strength and export flags */ 400 uint32_t algorithm2; /* Extra flags */ 401 int32_t strength_bits; /* Number of bits really used */ 402 uint32_t alg_bits; /* Number of bits for algorithm */ 403 }; 404 405 /* Used to hold SSL/TLS functions */ 406 struct ssl_method_st { 407 int version; 408 unsigned flags; 409 uint64_t mask; 410 SSL *(*ssl_new) (SSL_CTX *ctx); 411 void (*ssl_free) (SSL *s); 412 int (*ssl_reset) (SSL *s); 413 int (*ssl_init) (SSL *s); 414 int (*ssl_clear) (SSL *s); 415 void (*ssl_deinit) (SSL *s); 416 int (*ssl_accept) (SSL *s); 417 int (*ssl_connect) (SSL *s); 418 int (*ssl_read) (SSL *s, void *buf, size_t len, size_t *readbytes); 419 int (*ssl_peek) (SSL *s, void *buf, size_t len, size_t *readbytes); 420 int (*ssl_write) (SSL *s, const void *buf, size_t len, size_t *written); 421 int (*ssl_shutdown) (SSL *s); 422 int (*ssl_renegotiate) (SSL *s); 423 int (*ssl_renegotiate_check) (SSL *s, int); 424 int (*ssl_read_bytes) (SSL *s, uint8_t type, uint8_t *recvd_type, 425 unsigned char *buf, size_t len, int peek, 426 size_t *readbytes); 427 int (*ssl_write_bytes) (SSL *s, uint8_t type, const void *buf_, size_t len, 428 size_t *written); 429 int (*ssl_dispatch_alert) (SSL *s); 430 long (*ssl_ctrl) (SSL *s, int cmd, long larg, void *parg); 431 long (*ssl_ctx_ctrl) (SSL_CTX *ctx, int cmd, long larg, void *parg); 432 const SSL_CIPHER *(*get_cipher_by_char) (const unsigned char *ptr); 433 int (*put_cipher_by_char) (const SSL_CIPHER *cipher, WPACKET *pkt, 434 size_t *len); 435 size_t (*ssl_pending) (const SSL *s); 436 int (*num_ciphers) (void); 437 const SSL_CIPHER *(*get_cipher) (unsigned ncipher); 438 OSSL_TIME (*get_timeout) (void); 439 const struct ssl3_enc_method *ssl3_enc; /* Extra SSLv3/TLS stuff */ 440 int (*ssl_version) (void); 441 long (*ssl_callback_ctrl) (SSL *s, int cb_id, void (*fp) (void)); 442 long (*ssl_ctx_callback_ctrl) (SSL_CTX *s, int cb_id, void (*fp) (void)); 443 }; 444 445 /* 446 * Matches the length of PSK_MAX_PSK_LEN. We keep it the same value for 447 * consistency, even in the event of OPENSSL_NO_PSK being defined. 448 */ 449 # define TLS13_MAX_RESUMPTION_PSK_LENGTH 512 450 451 /*- 452 * Lets make this into an ASN.1 type structure as follows 453 * SSL_SESSION_ID ::= SEQUENCE { 454 * version INTEGER, -- structure version number 455 * SSLversion INTEGER, -- SSL version number 456 * Cipher OCTET STRING, -- the 3 byte cipher ID 457 * Session_ID OCTET STRING, -- the Session ID 458 * Master_key OCTET STRING, -- the master key 459 * Key_Arg [ 0 ] IMPLICIT OCTET STRING, -- the optional Key argument 460 * Time [ 1 ] EXPLICIT INTEGER, -- optional Start Time 461 * Timeout [ 2 ] EXPLICIT INTEGER, -- optional Timeout ins seconds 462 * Peer [ 3 ] EXPLICIT X509, -- optional Peer Certificate 463 * Session_ID_context [ 4 ] EXPLICIT OCTET STRING, -- the Session ID context 464 * Verify_result [ 5 ] EXPLICIT INTEGER, -- X509_V_... code for `Peer' 465 * HostName [ 6 ] EXPLICIT OCTET STRING, -- optional HostName from servername TLS extension 466 * PSK_identity_hint [ 7 ] EXPLICIT OCTET STRING, -- optional PSK identity hint 467 * PSK_identity [ 8 ] EXPLICIT OCTET STRING, -- optional PSK identity 468 * Ticket_lifetime_hint [9] EXPLICIT INTEGER, -- server's lifetime hint for session ticket 469 * Ticket [10] EXPLICIT OCTET STRING, -- session ticket (clients only) 470 * Compression_meth [11] EXPLICIT OCTET STRING, -- optional compression method 471 * SRP_username [ 12 ] EXPLICIT OCTET STRING -- optional SRP username 472 * flags [ 13 ] EXPLICIT INTEGER -- optional flags 473 * } 474 * Look in ssl/ssl_asn1.c for more details 475 * I'm using EXPLICIT tags so I can read the damn things using asn1parse :-). 476 */ 477 struct ssl_session_st { 478 int ssl_version; /* what ssl version session info is being kept 479 * in here? */ 480 size_t master_key_length; 481 482 /* TLSv1.3 early_secret used for external PSKs */ 483 unsigned char early_secret[EVP_MAX_MD_SIZE]; 484 /* 485 * For <=TLS1.2 this is the master_key. For TLS1.3 this is the resumption 486 * PSK 487 */ 488 unsigned char master_key[TLS13_MAX_RESUMPTION_PSK_LENGTH]; 489 /* session_id - valid? */ 490 size_t session_id_length; 491 unsigned char session_id[SSL_MAX_SSL_SESSION_ID_LENGTH]; 492 /* 493 * this is used to determine whether the session is being reused in the 494 * appropriate context. It is up to the application to set this, via 495 * SSL_new 496 */ 497 size_t sid_ctx_length; 498 unsigned char sid_ctx[SSL_MAX_SID_CTX_LENGTH]; 499 # ifndef OPENSSL_NO_PSK 500 char *psk_identity_hint; 501 char *psk_identity; 502 # endif 503 /* 504 * Used to indicate that session resumption is not allowed. Applications 505 * can also set this bit for a new session via not_resumable_session_cb 506 * to disable session caching and tickets. 507 */ 508 int not_resumable; 509 /* Peer raw public key, if available */ 510 EVP_PKEY *peer_rpk; 511 /* This is the cert and type for the other end. */ 512 X509 *peer; 513 /* Certificate chain peer sent. */ 514 STACK_OF(X509) *peer_chain; 515 /* 516 * when app_verify_callback accepts a session where the peer's 517 * certificate is not ok, we must remember the error for session reuse: 518 */ 519 long verify_result; /* only for servers */ 520 OSSL_TIME timeout; 521 OSSL_TIME time; 522 OSSL_TIME calc_timeout; 523 unsigned int compress_meth; /* Need to lookup the method */ 524 const SSL_CIPHER *cipher; 525 unsigned long cipher_id; /* when ASN.1 loaded, this needs to be used to 526 * load the 'cipher' structure */ 527 unsigned int kex_group; /* TLS group from key exchange */ 528 CRYPTO_EX_DATA ex_data; /* application specific data */ 529 530 struct { 531 char *hostname; 532 /* RFC4507 info */ 533 unsigned char *tick; /* Session ticket */ 534 size_t ticklen; /* Session ticket length */ 535 /* Session lifetime hint in seconds */ 536 unsigned long tick_lifetime_hint; 537 uint32_t tick_age_add; 538 /* Max number of bytes that can be sent as early data */ 539 uint32_t max_early_data; 540 /* The ALPN protocol selected for this session */ 541 unsigned char *alpn_selected; 542 size_t alpn_selected_len; 543 /* 544 * Maximum Fragment Length as per RFC 4366. 545 * If this value does not contain RFC 4366 allowed values (1-4) then 546 * either the Maximum Fragment Length Negotiation failed or was not 547 * performed at all. 548 */ 549 uint8_t max_fragment_len_mode; 550 } ext; 551 # ifndef OPENSSL_NO_SRP 552 char *srp_username; 553 # endif 554 unsigned char *ticket_appdata; 555 size_t ticket_appdata_len; 556 uint32_t flags; 557 SSL_CTX *owner; 558 559 /* 560 * These are used to make removal of session-ids more efficient and to 561 * implement a maximum cache size. Access requires protection of ctx->lock. 562 */ 563 struct ssl_session_st *prev, *next; 564 CRYPTO_REF_COUNT references; 565 }; 566 567 /* Extended master secret support */ 568 # define SSL_SESS_FLAG_EXTMS 0x1 569 570 # ifndef OPENSSL_NO_SRP 571 572 typedef struct srp_ctx_st { 573 /* param for all the callbacks */ 574 void *SRP_cb_arg; 575 /* set client Hello login callback */ 576 int (*TLS_ext_srp_username_callback) (SSL *, int *, void *); 577 /* set SRP N/g param callback for verification */ 578 int (*SRP_verify_param_callback) (SSL *, void *); 579 /* set SRP client passwd callback */ 580 char *(*SRP_give_srp_client_pwd_callback) (SSL *, void *); 581 char *login; 582 BIGNUM *N, *g, *s, *B, *A; 583 BIGNUM *a, *b, *v; 584 char *info; 585 int strength; 586 unsigned long srp_Mask; 587 } SRP_CTX; 588 589 # endif 590 591 typedef enum { 592 SSL_EARLY_DATA_NONE = 0, 593 SSL_EARLY_DATA_CONNECT_RETRY, 594 SSL_EARLY_DATA_CONNECTING, 595 SSL_EARLY_DATA_WRITE_RETRY, 596 SSL_EARLY_DATA_WRITING, 597 SSL_EARLY_DATA_WRITE_FLUSH, 598 SSL_EARLY_DATA_UNAUTH_WRITING, 599 SSL_EARLY_DATA_FINISHED_WRITING, 600 SSL_EARLY_DATA_ACCEPT_RETRY, 601 SSL_EARLY_DATA_ACCEPTING, 602 SSL_EARLY_DATA_READ_RETRY, 603 SSL_EARLY_DATA_READING, 604 SSL_EARLY_DATA_FINISHED_READING 605 } SSL_EARLY_DATA_STATE; 606 607 /* 608 * We check that the amount of unreadable early data doesn't exceed 609 * max_early_data. max_early_data is given in plaintext bytes. However if it is 610 * unreadable then we only know the number of ciphertext bytes. We also don't 611 * know how much the overhead should be because it depends on the ciphersuite. 612 * We make a small allowance. We assume 5 records of actual data plus the end 613 * of early data alert record. Each record has a tag and a content type byte. 614 * The longest tag length we know of is EVP_GCM_TLS_TAG_LEN. We don't count the 615 * content of the alert record either which is 2 bytes. 616 */ 617 # define EARLY_DATA_CIPHERTEXT_OVERHEAD ((6 * (EVP_GCM_TLS_TAG_LEN + 1)) + 2) 618 619 /* 620 * The allowance we have between the client's calculated ticket age and our own. 621 * We allow for 10 seconds. If a ticket is presented and the 622 * client's age calculation is different by more than this than our own then we 623 * do not allow that ticket for early_data. 624 */ 625 # define TICKET_AGE_ALLOWANCE ossl_seconds2time(10) 626 627 #define MAX_COMPRESSIONS_SIZE 255 628 629 630 typedef struct raw_extension_st { 631 /* Raw packet data for the extension */ 632 PACKET data; 633 /* Set to 1 if the extension is present or 0 otherwise */ 634 int present; 635 /* Set to 1 if we have already parsed the extension or 0 otherwise */ 636 int parsed; 637 /* The type of this extension, i.e. a TLSEXT_TYPE_* value */ 638 unsigned int type; 639 /* Track what order extensions are received in (0-based). */ 640 size_t received_order; 641 } RAW_EXTENSION; 642 643 typedef struct { 644 unsigned int isv2; 645 unsigned int legacy_version; 646 unsigned char random[SSL3_RANDOM_SIZE]; 647 size_t session_id_len; 648 unsigned char session_id[SSL_MAX_SSL_SESSION_ID_LENGTH]; 649 size_t dtls_cookie_len; 650 unsigned char dtls_cookie[DTLS1_COOKIE_LENGTH]; 651 PACKET ciphersuites; 652 size_t compressions_len; 653 unsigned char compressions[MAX_COMPRESSIONS_SIZE]; 654 PACKET extensions; 655 size_t pre_proc_exts_len; 656 RAW_EXTENSION *pre_proc_exts; 657 } CLIENTHELLO_MSG; 658 659 /* 660 * Extension index values NOTE: Any updates to these defines should be mirrored 661 * with equivalent updates to ext_defs in extensions.c 662 */ 663 typedef enum tlsext_index_en { 664 TLSEXT_IDX_renegotiate, 665 TLSEXT_IDX_server_name, 666 TLSEXT_IDX_max_fragment_length, 667 TLSEXT_IDX_srp, 668 TLSEXT_IDX_ec_point_formats, 669 TLSEXT_IDX_supported_groups, 670 TLSEXT_IDX_session_ticket, 671 TLSEXT_IDX_status_request, 672 TLSEXT_IDX_next_proto_neg, 673 TLSEXT_IDX_application_layer_protocol_negotiation, 674 TLSEXT_IDX_use_srtp, 675 TLSEXT_IDX_encrypt_then_mac, 676 TLSEXT_IDX_signed_certificate_timestamp, 677 TLSEXT_IDX_extended_master_secret, 678 TLSEXT_IDX_signature_algorithms_cert, 679 TLSEXT_IDX_post_handshake_auth, 680 TLSEXT_IDX_client_cert_type, 681 TLSEXT_IDX_server_cert_type, 682 TLSEXT_IDX_signature_algorithms, 683 TLSEXT_IDX_supported_versions, 684 TLSEXT_IDX_psk_kex_modes, 685 TLSEXT_IDX_key_share, 686 TLSEXT_IDX_cookie, 687 TLSEXT_IDX_cryptopro_bug, 688 TLSEXT_IDX_compress_certificate, 689 TLSEXT_IDX_early_data, 690 TLSEXT_IDX_certificate_authorities, 691 TLSEXT_IDX_padding, 692 TLSEXT_IDX_psk, 693 /* Dummy index - must always be the last entry */ 694 TLSEXT_IDX_num_builtins 695 } TLSEXT_INDEX; 696 697 DEFINE_LHASH_OF_EX(SSL_SESSION); 698 /* Needed in ssl_cert.c */ 699 DEFINE_LHASH_OF_EX(X509_NAME); 700 701 # define TLSEXT_KEYNAME_LENGTH 16 702 # define TLSEXT_TICK_KEY_LENGTH 32 703 704 typedef struct ssl_ctx_ext_secure_st { 705 unsigned char tick_hmac_key[TLSEXT_TICK_KEY_LENGTH]; 706 unsigned char tick_aes_key[TLSEXT_TICK_KEY_LENGTH]; 707 } SSL_CTX_EXT_SECURE; 708 709 /* 710 * Helper function for HMAC 711 * The structure should be considered opaque, it will change once the low 712 * level deprecated calls are removed. At that point it can be replaced 713 * by EVP_MAC_CTX and most of the functions converted to macros or inlined 714 * directly. 715 */ 716 typedef struct ssl_hmac_st { 717 EVP_MAC_CTX *ctx; 718 # ifndef OPENSSL_NO_DEPRECATED_3_0 719 HMAC_CTX *old_ctx; 720 # endif 721 } SSL_HMAC; 722 723 SSL_HMAC *ssl_hmac_new(const SSL_CTX *ctx); 724 void ssl_hmac_free(SSL_HMAC *ctx); 725 # ifndef OPENSSL_NO_DEPRECATED_3_0 726 HMAC_CTX *ssl_hmac_get0_HMAC_CTX(SSL_HMAC *ctx); 727 # endif 728 EVP_MAC_CTX *ssl_hmac_get0_EVP_MAC_CTX(SSL_HMAC *ctx); 729 int ssl_hmac_init(SSL_HMAC *ctx, void *key, size_t len, char *md); 730 int ssl_hmac_update(SSL_HMAC *ctx, const unsigned char *data, size_t len); 731 int ssl_hmac_final(SSL_HMAC *ctx, unsigned char *md, size_t *len, 732 size_t max_size); 733 size_t ssl_hmac_size(const SSL_HMAC *ctx); 734 735 int ssl_get_EC_curve_nid(const EVP_PKEY *pkey); 736 __owur int tls13_set_encoded_pub_key(EVP_PKEY *pkey, 737 const unsigned char *enckey, 738 size_t enckeylen); 739 740 typedef struct tls_group_info_st { 741 char *tlsname; /* Curve Name as in TLS specs */ 742 char *realname; /* Curve Name according to provider */ 743 char *algorithm; /* Algorithm name to fetch */ 744 unsigned int secbits; /* Bits of security (from SP800-57) */ 745 uint16_t group_id; /* Group ID */ 746 int mintls; /* Minimum TLS version, -1 unsupported */ 747 int maxtls; /* Maximum TLS version (or 0 for undefined) */ 748 int mindtls; /* Minimum DTLS version, -1 unsupported */ 749 int maxdtls; /* Maximum DTLS version (or 0 for undefined) */ 750 char is_kem; /* Mode for this Group: 0 is KEX, 1 is KEM */ 751 } TLS_GROUP_INFO; 752 753 typedef struct tls_sigalg_info_st { 754 char *name; /* name as in IANA TLS specs */ 755 uint16_t code_point; /* IANA-specified code point of sigalg-name */ 756 char *sigalg_name; /* (combined) sigalg name */ 757 char *sigalg_oid; /* (combined) sigalg OID */ 758 char *sig_name; /* pure signature algorithm name */ 759 char *sig_oid; /* pure signature algorithm OID */ 760 char *hash_name; /* hash algorithm name */ 761 char *hash_oid; /* hash algorithm OID */ 762 char *keytype; /* keytype name */ 763 char *keytype_oid; /* keytype OID */ 764 unsigned int secbits; /* Bits of security (from SP800-57) */ 765 int mintls; /* Minimum TLS version, -1 unsupported */ 766 int maxtls; /* Maximum TLS version (or 0 for undefined) */ 767 int mindtls; /* Minimum DTLS version, -1 unsupported */ 768 int maxdtls; /* Maximum DTLS version (or 0 for undefined) */ 769 } TLS_SIGALG_INFO; 770 771 /* 772 * Structure containing table entry of certificate info corresponding to 773 * CERT_PKEY entries 774 */ 775 typedef struct { 776 int nid; /* NID of public key algorithm */ 777 uint32_t amask; /* authmask corresponding to key type */ 778 } SSL_CERT_LOOKUP; 779 780 /* flags values */ 781 # define TLS_GROUP_TYPE 0x0000000FU /* Mask for group type */ 782 # define TLS_GROUP_CURVE_PRIME 0x00000001U 783 # define TLS_GROUP_CURVE_CHAR2 0x00000002U 784 # define TLS_GROUP_CURVE_CUSTOM 0x00000004U 785 # define TLS_GROUP_FFDHE 0x00000008U 786 # define TLS_GROUP_ONLY_FOR_TLS1_3 0x00000010U 787 788 # define TLS_GROUP_FFDHE_FOR_TLS1_3 (TLS_GROUP_FFDHE|TLS_GROUP_ONLY_FOR_TLS1_3) 789 790 /* We limit the number of key shares sent */ 791 # ifndef OPENSSL_CLIENT_MAX_KEY_SHARES 792 # define OPENSSL_CLIENT_MAX_KEY_SHARES 4 793 # endif 794 795 struct ssl_ctx_st { 796 OSSL_LIB_CTX *libctx; 797 798 const SSL_METHOD *method; 799 STACK_OF(SSL_CIPHER) *cipher_list; 800 /* same as above but sorted for lookup */ 801 STACK_OF(SSL_CIPHER) *cipher_list_by_id; 802 /* TLSv1.3 specific ciphersuites */ 803 STACK_OF(SSL_CIPHER) *tls13_ciphersuites; 804 struct x509_store_st /* X509_STORE */ *cert_store; 805 LHASH_OF(SSL_SESSION) *sessions; 806 /* 807 * Most session-ids that will be cached, default is 808 * SSL_SESSION_CACHE_MAX_SIZE_DEFAULT. 0 is unlimited. 809 */ 810 size_t session_cache_size; 811 struct ssl_session_st *session_cache_head; 812 struct ssl_session_st *session_cache_tail; 813 /* 814 * This can have one of 2 values, ored together, SSL_SESS_CACHE_CLIENT, 815 * SSL_SESS_CACHE_SERVER, Default is SSL_SESSION_CACHE_SERVER, which 816 * means only SSL_accept will cache SSL_SESSIONS. 817 */ 818 uint32_t session_cache_mode; 819 /* 820 * If timeout is not 0, it is the default timeout value set when 821 * SSL_new() is called. This has been put in to make life easier to set 822 * things up 823 */ 824 OSSL_TIME session_timeout; 825 /* 826 * If this callback is not null, it will be called each time a session id 827 * is added to the cache. If this function returns 1, it means that the 828 * callback will do an SSL_SESSION_free() when it has finished using it. 829 * Otherwise, on 0, it means the callback has finished with it. If 830 * remove_session_cb is not null, it will be called when a session-id is 831 * removed from the cache. After the call, OpenSSL will 832 * SSL_SESSION_free() it. 833 */ 834 int (*new_session_cb) (struct ssl_st *ssl, SSL_SESSION *sess); 835 void (*remove_session_cb) (struct ssl_ctx_st *ctx, SSL_SESSION *sess); 836 SSL_SESSION *(*get_session_cb) (struct ssl_st *ssl, 837 const unsigned char *data, int len, 838 int *copy); 839 struct { 840 TSAN_QUALIFIER int sess_connect; /* SSL new conn - started */ 841 TSAN_QUALIFIER int sess_connect_renegotiate; /* SSL reneg - requested */ 842 TSAN_QUALIFIER int sess_connect_good; /* SSL new conne/reneg - finished */ 843 TSAN_QUALIFIER int sess_accept; /* SSL new accept - started */ 844 TSAN_QUALIFIER int sess_accept_renegotiate; /* SSL reneg - requested */ 845 TSAN_QUALIFIER int sess_accept_good; /* SSL accept/reneg - finished */ 846 TSAN_QUALIFIER int sess_miss; /* session lookup misses */ 847 TSAN_QUALIFIER int sess_timeout; /* reuse attempt on timeouted session */ 848 TSAN_QUALIFIER int sess_cache_full; /* session removed due to full cache */ 849 TSAN_QUALIFIER int sess_hit; /* session reuse actually done */ 850 TSAN_QUALIFIER int sess_cb_hit; /* session-id that was not in 851 * the cache was passed back via 852 * the callback. This indicates 853 * that the application is 854 * supplying session-id's from 855 * other processes - spooky 856 * :-) */ 857 } stats; 858 #ifdef TSAN_REQUIRES_LOCKING 859 CRYPTO_RWLOCK *tsan_lock; 860 #endif 861 862 CRYPTO_REF_COUNT references; 863 864 /* if defined, these override the X509_verify_cert() calls */ 865 int (*app_verify_callback) (X509_STORE_CTX *, void *); 866 void *app_verify_arg; 867 /* 868 * before OpenSSL 0.9.7, 'app_verify_arg' was ignored 869 * ('app_verify_callback' was called with just one argument) 870 */ 871 872 /* Default password callback. */ 873 pem_password_cb *default_passwd_callback; 874 875 /* Default password callback user data. */ 876 void *default_passwd_callback_userdata; 877 878 /* get client cert callback */ 879 int (*client_cert_cb) (SSL *ssl, X509 **x509, EVP_PKEY **pkey); 880 881 /* cookie generate callback */ 882 int (*app_gen_cookie_cb) (SSL *ssl, unsigned char *cookie, 883 unsigned int *cookie_len); 884 885 /* verify cookie callback */ 886 int (*app_verify_cookie_cb) (SSL *ssl, const unsigned char *cookie, 887 unsigned int cookie_len); 888 889 /* TLS1.3 app-controlled cookie generate callback */ 890 int (*gen_stateless_cookie_cb) (SSL *ssl, unsigned char *cookie, 891 size_t *cookie_len); 892 893 /* TLS1.3 verify app-controlled cookie callback */ 894 int (*verify_stateless_cookie_cb) (SSL *ssl, const unsigned char *cookie, 895 size_t cookie_len); 896 897 CRYPTO_EX_DATA ex_data; 898 899 const EVP_MD *md5; /* For SSLv3/TLSv1 'ssl3-md5' */ 900 const EVP_MD *sha1; /* For SSLv3/TLSv1 'ssl3-sha1' */ 901 902 STACK_OF(X509) *extra_certs; 903 STACK_OF(SSL_COMP) *comp_methods; /* stack of SSL_COMP, SSLv3/TLSv1 */ 904 905 /* Default values used when no per-SSL value is defined follow */ 906 907 /* used if SSL's info_callback is NULL */ 908 void (*info_callback) (const SSL *ssl, int type, int val); 909 910 /* 911 * What we put in certificate_authorities extension for TLS 1.3 912 * (ClientHello and CertificateRequest) or just client cert requests for 913 * earlier versions. If client_ca_names is populated then it is only used 914 * for client cert requests, and in preference to ca_names. 915 */ 916 STACK_OF(X509_NAME) *ca_names; 917 STACK_OF(X509_NAME) *client_ca_names; 918 919 /* 920 * Default values to use in SSL structures follow (these are copied by 921 * SSL_new) 922 */ 923 924 uint64_t options; 925 uint32_t mode; 926 int min_proto_version; 927 int max_proto_version; 928 size_t max_cert_list; 929 930 struct cert_st /* CERT */ *cert; 931 SSL_CERT_LOOKUP *ssl_cert_info; 932 int read_ahead; 933 934 /* callback that allows applications to peek at protocol messages */ 935 ossl_msg_cb msg_callback; 936 void *msg_callback_arg; 937 938 uint32_t verify_mode; 939 size_t sid_ctx_length; 940 unsigned char sid_ctx[SSL_MAX_SID_CTX_LENGTH]; 941 /* called 'verify_callback' in the SSL */ 942 int (*default_verify_callback) (int ok, X509_STORE_CTX *ctx); 943 944 /* Default generate session ID callback. */ 945 GEN_SESSION_CB generate_session_id; 946 947 X509_VERIFY_PARAM *param; 948 949 int quiet_shutdown; 950 951 # ifndef OPENSSL_NO_CT 952 CTLOG_STORE *ctlog_store; /* CT Log Store */ 953 /* 954 * Validates that the SCTs (Signed Certificate Timestamps) are sufficient. 955 * If they are not, the connection should be aborted. 956 */ 957 ssl_ct_validation_cb ct_validation_callback; 958 void *ct_validation_callback_arg; 959 # endif 960 961 /* 962 * If we're using more than one pipeline how should we divide the data 963 * up between the pipes? 964 */ 965 size_t split_send_fragment; 966 /* 967 * Maximum amount of data to send in one fragment. actual record size can 968 * be more than this due to padding and MAC overheads. 969 */ 970 size_t max_send_fragment; 971 972 /* Up to how many pipelines should we use? If 0 then 1 is assumed */ 973 size_t max_pipelines; 974 975 /* The default read buffer length to use (0 means not set) */ 976 size_t default_read_buf_len; 977 978 # ifndef OPENSSL_NO_ENGINE 979 /* 980 * Engine to pass requests for client certs to 981 */ 982 ENGINE *client_cert_engine; 983 # endif 984 985 /* ClientHello callback. Mostly for extensions, but not entirely. */ 986 SSL_client_hello_cb_fn client_hello_cb; 987 void *client_hello_cb_arg; 988 989 /* Callback to announce new pending ssl objects in the accept queue */ 990 SSL_new_pending_conn_cb_fn new_pending_conn_cb; 991 void *new_pending_conn_arg; 992 993 /* TLS extensions. */ 994 struct { 995 /* TLS extensions servername callback */ 996 int (*servername_cb) (SSL *, int *, void *); 997 void *servername_arg; 998 /* RFC 4507 session ticket keys */ 999 unsigned char tick_key_name[TLSEXT_KEYNAME_LENGTH]; 1000 SSL_CTX_EXT_SECURE *secure; 1001 # ifndef OPENSSL_NO_DEPRECATED_3_0 1002 /* Callback to support customisation of ticket key setting */ 1003 int (*ticket_key_cb) (SSL *ssl, 1004 unsigned char *name, unsigned char *iv, 1005 EVP_CIPHER_CTX *ectx, HMAC_CTX *hctx, int enc); 1006 #endif 1007 int (*ticket_key_evp_cb) (SSL *ssl, 1008 unsigned char *name, unsigned char *iv, 1009 EVP_CIPHER_CTX *ectx, EVP_MAC_CTX *hctx, 1010 int enc); 1011 1012 /* certificate status request info */ 1013 /* Callback for status request */ 1014 int (*status_cb) (SSL *ssl, void *arg); 1015 void *status_arg; 1016 /* ext status type used for CSR extension (OCSP Stapling) */ 1017 int status_type; 1018 /* RFC 4366 Maximum Fragment Length Negotiation */ 1019 uint8_t max_fragment_len_mode; 1020 1021 /* EC extension values inherited by SSL structure */ 1022 size_t ecpointformats_len; 1023 unsigned char *ecpointformats; 1024 1025 size_t supportedgroups_len; 1026 uint16_t *supportedgroups; 1027 1028 size_t keyshares_len; 1029 uint16_t *keyshares; 1030 1031 size_t tuples_len; /* Number of group tuples */ 1032 size_t *tuples; /* Number of groups in each group tuple */ 1033 1034 /* 1035 * ALPN information (we are in the process of transitioning from NPN to 1036 * ALPN.) 1037 */ 1038 1039 /*- 1040 * For a server, this contains a callback function that allows the 1041 * server to select the protocol for the connection. 1042 * out: on successful return, this must point to the raw protocol 1043 * name (without the length prefix). 1044 * outlen: on successful return, this contains the length of |*out|. 1045 * in: points to the client's list of supported protocols in 1046 * wire-format. 1047 * inlen: the length of |in|. 1048 */ 1049 int (*alpn_select_cb) (SSL *s, 1050 const unsigned char **out, 1051 unsigned char *outlen, 1052 const unsigned char *in, 1053 unsigned int inlen, void *arg); 1054 void *alpn_select_cb_arg; 1055 1056 /* 1057 * For a client, this contains the list of supported protocols in wire 1058 * format. 1059 */ 1060 unsigned char *alpn; 1061 size_t alpn_len; 1062 1063 # ifndef OPENSSL_NO_NEXTPROTONEG 1064 /* Next protocol negotiation information */ 1065 1066 /* 1067 * For a server, this contains a callback function by which the set of 1068 * advertised protocols can be provided. 1069 */ 1070 SSL_CTX_npn_advertised_cb_func npn_advertised_cb; 1071 void *npn_advertised_cb_arg; 1072 /* 1073 * For a client, this contains a callback function that selects the next 1074 * protocol from the list provided by the server. 1075 */ 1076 SSL_CTX_npn_select_cb_func npn_select_cb; 1077 void *npn_select_cb_arg; 1078 # endif 1079 1080 unsigned char cookie_hmac_key[SHA256_DIGEST_LENGTH]; 1081 } ext; 1082 1083 # ifndef OPENSSL_NO_PSK 1084 SSL_psk_client_cb_func psk_client_callback; 1085 SSL_psk_server_cb_func psk_server_callback; 1086 # endif 1087 SSL_psk_find_session_cb_func psk_find_session_cb; 1088 SSL_psk_use_session_cb_func psk_use_session_cb; 1089 1090 # ifndef OPENSSL_NO_SRP 1091 SRP_CTX srp_ctx; /* ctx for SRP authentication */ 1092 # endif 1093 1094 /* Shared DANE context */ 1095 struct dane_ctx_st dane; 1096 1097 # ifndef OPENSSL_NO_SRTP 1098 /* SRTP profiles we are willing to do from RFC 5764 */ 1099 STACK_OF(SRTP_PROTECTION_PROFILE) *srtp_profiles; 1100 # endif 1101 /* 1102 * Callback for disabling session caching and ticket support on a session 1103 * basis, depending on the chosen cipher. 1104 */ 1105 int (*not_resumable_session_cb) (SSL *ssl, int is_forward_secure); 1106 1107 CRYPTO_RWLOCK *lock; 1108 1109 /* 1110 * Callback for logging key material for use with debugging tools like 1111 * Wireshark. The callback should log `line` followed by a newline. 1112 */ 1113 SSL_CTX_keylog_cb_func keylog_callback; 1114 1115 /* 1116 * Private flag for internal key logging based on SSLKEYLOG env 1117 */ 1118 # ifndef OPENSSL_NO_SSLKEYLOG 1119 uint32_t do_sslkeylog; 1120 # endif 1121 1122 /* 1123 * The maximum number of bytes advertised in session tickets that can be 1124 * sent as early data. 1125 */ 1126 uint32_t max_early_data; 1127 1128 /* 1129 * The maximum number of bytes of early data that a server will tolerate 1130 * (which should be at least as much as max_early_data). 1131 */ 1132 uint32_t recv_max_early_data; 1133 1134 /* TLS1.3 padding callback */ 1135 size_t (*record_padding_cb)(SSL *s, int type, size_t len, void *arg); 1136 void *record_padding_arg; 1137 size_t block_padding; 1138 size_t hs_padding; 1139 1140 /* Session ticket appdata */ 1141 SSL_CTX_generate_session_ticket_fn generate_ticket_cb; 1142 SSL_CTX_decrypt_session_ticket_fn decrypt_ticket_cb; 1143 void *ticket_cb_data; 1144 1145 /* The number of TLS1.3 tickets to automatically send */ 1146 size_t num_tickets; 1147 1148 /* Callback to determine if early_data is acceptable or not */ 1149 SSL_allow_early_data_cb_fn allow_early_data_cb; 1150 void *allow_early_data_cb_data; 1151 1152 /* Do we advertise Post-handshake auth support? */ 1153 int pha_enabled; 1154 1155 /* Callback for SSL async handling */ 1156 SSL_async_callback_fn async_cb; 1157 void *async_cb_arg; 1158 1159 char *propq; 1160 1161 int ssl_mac_pkey_id[SSL_MD_NUM_IDX]; 1162 const EVP_CIPHER *ssl_cipher_methods[SSL_ENC_NUM_IDX]; 1163 const EVP_MD *ssl_digest_methods[SSL_MD_NUM_IDX]; 1164 size_t ssl_mac_secret_size[SSL_MD_NUM_IDX]; 1165 1166 size_t sigalg_lookup_cache_len; 1167 size_t tls12_sigalgs_len; 1168 /* Cache of all sigalgs we know and whether they are available or not */ 1169 struct sigalg_lookup_st *sigalg_lookup_cache; 1170 /* List of all sigalgs (code points) available, incl. from providers */ 1171 uint16_t *tls12_sigalgs; 1172 1173 TLS_GROUP_INFO *group_list; 1174 size_t group_list_len; 1175 size_t group_list_max_len; 1176 1177 TLS_SIGALG_INFO *sigalg_list; 1178 size_t sigalg_list_len; 1179 size_t sigalg_list_max_len; 1180 1181 /* masks of disabled algorithms */ 1182 uint32_t disabled_enc_mask; 1183 uint32_t disabled_mac_mask; 1184 uint32_t disabled_mkey_mask; 1185 uint32_t disabled_auth_mask; 1186 1187 #ifndef OPENSSL_NO_COMP_ALG 1188 /* certificate compression preferences */ 1189 int cert_comp_prefs[TLSEXT_comp_cert_limit]; 1190 #endif 1191 1192 /* Certificate Type stuff - for RPK vs X.509 */ 1193 unsigned char *client_cert_type; 1194 size_t client_cert_type_len; 1195 unsigned char *server_cert_type; 1196 size_t server_cert_type_len; 1197 1198 # ifndef OPENSSL_NO_QUIC 1199 uint64_t domain_flags; 1200 SSL_TOKEN_STORE *tokencache; 1201 # endif 1202 1203 # ifndef OPENSSL_NO_QLOG 1204 char *qlog_title; /* Session title for qlog */ 1205 # endif 1206 }; 1207 1208 typedef struct ossl_quic_tls_callbacks_st { 1209 int (*crypto_send_cb)(SSL *s, const unsigned char *buf, size_t buf_len, 1210 size_t *consumed, void *arg); 1211 int (*crypto_recv_rcd_cb)(SSL *s, const unsigned char **buf, 1212 size_t *bytes_read, void *arg); 1213 int (*crypto_release_rcd_cb)(SSL *s, size_t bytes_read, void *arg); 1214 int (*yield_secret_cb)(SSL *s, uint32_t prot_level, int direction, 1215 const unsigned char *secret, size_t secret_len, 1216 void *arg); 1217 int (*got_transport_params_cb)(SSL *s, const unsigned char *params, 1218 size_t params_len, 1219 void *arg); 1220 int (*alert_cb)(SSL *s, unsigned char alert_code, void *arg); 1221 } OSSL_QUIC_TLS_CALLBACKS; 1222 1223 typedef struct cert_pkey_st CERT_PKEY; 1224 1225 #define SSL_TYPE_SSL_CONNECTION 0 1226 #define SSL_TYPE_QUIC_CONNECTION 0x80 1227 #define SSL_TYPE_QUIC_XSO 0x81 1228 #define SSL_TYPE_QUIC_LISTENER 0x82 1229 #define SSL_TYPE_QUIC_DOMAIN 0x83 1230 1231 #define SSL_TYPE_IS_QUIC(x) (((x) & 0x80) != 0) 1232 1233 struct ssl_st { 1234 int type; 1235 SSL_CTX *ctx; 1236 const SSL_METHOD *defltmeth; 1237 const SSL_METHOD *method; 1238 CRYPTO_REF_COUNT references; 1239 CRYPTO_RWLOCK *lock; 1240 /* extra application data */ 1241 CRYPTO_EX_DATA ex_data; 1242 }; 1243 1244 struct ssl_connection_st { 1245 /* type identifier and common data */ 1246 struct ssl_st ssl; 1247 1248 /* 1249 * The actual end user's SSL object. Could be different to this one for 1250 * QUIC 1251 */ 1252 SSL *user_ssl; 1253 1254 /* 1255 * protocol version (one of SSL2_VERSION, SSL3_VERSION, TLS1_VERSION, 1256 * DTLS1_VERSION) 1257 */ 1258 int version; 1259 /* 1260 * There are 2 BIO's even though they are normally both the same. This 1261 * is so data can be read and written to different handlers 1262 */ 1263 /* used by SSL_read */ 1264 BIO *rbio; 1265 /* used by SSL_write */ 1266 BIO *wbio; 1267 /* used during session-id reuse to concatenate messages */ 1268 BIO *bbio; 1269 /* 1270 * This holds a variable that indicates what we were doing when a 0 or -1 1271 * is returned. This is needed for non-blocking IO so we know what 1272 * request needs re-doing when in SSL_accept or SSL_connect 1273 */ 1274 int rwstate; 1275 int (*handshake_func) (SSL *); 1276 /* 1277 * Imagine that here's a boolean member "init" that is switched as soon 1278 * as SSL_set_{accept/connect}_state is called for the first time, so 1279 * that "state" and "handshake_func" are properly initialized. But as 1280 * handshake_func is == 0 until then, we use this test instead of an 1281 * "init" member. 1282 */ 1283 /* are we the server side? */ 1284 int server; 1285 /* 1286 * Generate a new session or reuse an old one. 1287 * NB: For servers, the 'new' session may actually be a previously 1288 * cached session or even the previous session unless 1289 * SSL_OP_NO_SESSION_RESUMPTION_ON_RENEGOTIATION is set 1290 */ 1291 int new_session; 1292 /* don't send shutdown packets */ 1293 int quiet_shutdown; 1294 /* we have shut things down, 0x01 sent, 0x02 for received */ 1295 int shutdown; 1296 /* Timestamps used to calculate the handshake RTT */ 1297 OSSL_TIME ts_msg_write; 1298 OSSL_TIME ts_msg_read; 1299 /* where we are */ 1300 OSSL_STATEM statem; 1301 SSL_EARLY_DATA_STATE early_data_state; 1302 BUF_MEM *init_buf; /* buffer used during init */ 1303 void *init_msg; /* pointer to handshake message body, set by 1304 * tls_get_message_header() */ 1305 size_t init_num; /* amount read/written */ 1306 size_t init_off; /* amount read/written */ 1307 1308 size_t ssl_pkey_num; 1309 1310 /* QUIC TLS fields */ 1311 OSSL_QUIC_TLS_CALLBACKS qtcb; 1312 void *qtarg; 1313 QUIC_TLS *qtls; 1314 1315 struct { 1316 long flags; 1317 unsigned char server_random[SSL3_RANDOM_SIZE]; 1318 unsigned char client_random[SSL3_RANDOM_SIZE]; 1319 1320 /* used during startup, digest all incoming/outgoing packets */ 1321 BIO *handshake_buffer; 1322 /* 1323 * When handshake digest is determined, buffer is hashed and 1324 * freed and MD_CTX for the required digest is stored here. 1325 */ 1326 EVP_MD_CTX *handshake_dgst; 1327 /* 1328 * Set whenever an expected ChangeCipherSpec message is processed. 1329 * Unset when the peer's Finished message is received. 1330 * Unexpected ChangeCipherSpec messages trigger a fatal alert. 1331 */ 1332 int change_cipher_spec; 1333 int warn_alert; 1334 int fatal_alert; 1335 /* 1336 * we allow one fatal and one warning alert to be outstanding, send close 1337 * alert via the warning alert 1338 */ 1339 int alert_dispatch; 1340 unsigned char send_alert[2]; 1341 /* 1342 * This flag is set when we should renegotiate ASAP, basically when there 1343 * is no more data in the read or write buffers 1344 */ 1345 int renegotiate; 1346 int total_renegotiations; 1347 int num_renegotiations; 1348 int in_read_app_data; 1349 1350 struct { 1351 /* actually only need to be 16+20 for SSLv3 and 12 for TLS */ 1352 unsigned char finish_md[EVP_MAX_MD_SIZE * 2]; 1353 size_t finish_md_len; 1354 unsigned char peer_finish_md[EVP_MAX_MD_SIZE * 2]; 1355 size_t peer_finish_md_len; 1356 size_t message_size; 1357 int message_type; 1358 /* used to hold the new cipher we are going to use */ 1359 const SSL_CIPHER *new_cipher; 1360 EVP_PKEY *pkey; /* holds short lived key exchange key */ 1361 /* holds the array of short lived key exchange key (pointers) */ 1362 EVP_PKEY *ks_pkey[OPENSSL_CLIENT_MAX_KEY_SHARES]; 1363 uint16_t ks_group_id[OPENSSL_CLIENT_MAX_KEY_SHARES]; /* The IDs of the keyshare keys */ 1364 size_t num_ks_pkey; /* how many keyshares are there */ 1365 /* used for certificate requests */ 1366 int cert_req; 1367 /* Certificate types in certificate request message. */ 1368 uint8_t *ctype; 1369 size_t ctype_len; 1370 /* Certificate authorities list peer sent */ 1371 STACK_OF(X509_NAME) *peer_ca_names; 1372 size_t key_block_length; 1373 unsigned char *key_block; 1374 const EVP_CIPHER *new_sym_enc; 1375 const EVP_MD *new_hash; 1376 int new_mac_pkey_type; 1377 size_t new_mac_secret_size; 1378 # ifndef OPENSSL_NO_COMP 1379 const SSL_COMP *new_compression; 1380 # else 1381 char *new_compression; 1382 # endif 1383 int cert_request; 1384 /* Raw values of the cipher list from a client */ 1385 unsigned char *ciphers_raw; 1386 size_t ciphers_rawlen; 1387 /* Temporary storage for premaster secret */ 1388 unsigned char *pms; 1389 size_t pmslen; 1390 # ifndef OPENSSL_NO_PSK 1391 /* Temporary storage for PSK key */ 1392 unsigned char *psk; 1393 size_t psklen; 1394 # endif 1395 /* Signature algorithm we actually use */ 1396 const struct sigalg_lookup_st *sigalg; 1397 /* Pointer to certificate we use */ 1398 CERT_PKEY *cert; 1399 /* 1400 * signature algorithms peer reports: e.g. supported signature 1401 * algorithms extension for server or as part of a certificate 1402 * request for client. 1403 * Keep track of the algorithms for TLS and X.509 usage separately. 1404 */ 1405 uint16_t *peer_sigalgs; 1406 uint16_t *peer_cert_sigalgs; 1407 /* Size of above arrays */ 1408 size_t peer_sigalgslen; 1409 size_t peer_cert_sigalgslen; 1410 /* Sigalg peer actually uses */ 1411 const struct sigalg_lookup_st *peer_sigalg; 1412 /* 1413 * Set if corresponding CERT_PKEY can be used with current 1414 * SSL session: e.g. appropriate curve, signature algorithms etc. 1415 * If zero it can't be used at all. 1416 */ 1417 uint32_t *valid_flags; 1418 /* 1419 * For servers the following masks are for the key and auth algorithms 1420 * that are supported by the certs below. For clients they are masks of 1421 * *disabled* algorithms based on the current session. 1422 */ 1423 uint32_t mask_k; 1424 uint32_t mask_a; 1425 /* 1426 * The following are used by the client to see if a cipher is allowed or 1427 * not. It contains the minimum and maximum version the client's using 1428 * based on what it knows so far. 1429 */ 1430 int min_ver; 1431 int max_ver; 1432 } tmp; 1433 1434 /* Connection binding to prevent renegotiation attacks */ 1435 unsigned char previous_client_finished[EVP_MAX_MD_SIZE]; 1436 size_t previous_client_finished_len; 1437 unsigned char previous_server_finished[EVP_MAX_MD_SIZE]; 1438 size_t previous_server_finished_len; 1439 int send_connection_binding; 1440 1441 # ifndef OPENSSL_NO_NEXTPROTONEG 1442 /* 1443 * Set if we saw the Next Protocol Negotiation extension from our peer. 1444 */ 1445 int npn_seen; 1446 # endif 1447 1448 /* 1449 * ALPN information (we are in the process of transitioning from NPN to 1450 * ALPN.) 1451 */ 1452 1453 /* 1454 * In a server these point to the selected ALPN protocol after the 1455 * ClientHello has been processed. In a client these contain the protocol 1456 * that the server selected once the ServerHello has been processed. 1457 */ 1458 unsigned char *alpn_selected; 1459 size_t alpn_selected_len; 1460 /* used by the server to know what options were proposed */ 1461 unsigned char *alpn_proposed; 1462 size_t alpn_proposed_len; 1463 /* used by the client to know if it actually sent alpn */ 1464 int alpn_sent; 1465 1466 /* 1467 * This is set to true if we believe that this is a version of Safari 1468 * running on OS X 10.6 or newer. We wish to know this because Safari on 1469 * 10.8 .. 10.8.3 has broken ECDHE-ECDSA support. 1470 */ 1471 char is_probably_safari; 1472 1473 /* 1474 * Track whether we did a key exchange this handshake or not, so 1475 * SSL_get_negotiated_group() knows whether to fall back to the 1476 * value in the SSL_SESSION. 1477 */ 1478 char did_kex; 1479 /* For clients: peer temporary key */ 1480 /* The group_id for the key exchange key */ 1481 uint16_t group_id; 1482 EVP_PKEY *peer_tmp; 1483 /* The cached group_id candidate for the key exchange key */ 1484 uint16_t group_id_candidate; 1485 } s3; 1486 1487 struct dtls1_state_st *d1; /* DTLSv1 variables */ 1488 /* callback that allows applications to peek at protocol messages */ 1489 void (*msg_callback) (int write_p, int version, int content_type, 1490 const void *buf, size_t len, SSL *ssl, void *arg); 1491 void *msg_callback_arg; 1492 int hit; /* reusing a previous session */ 1493 X509_VERIFY_PARAM *param; 1494 /* Per connection DANE state */ 1495 SSL_DANE dane; 1496 /* crypto */ 1497 STACK_OF(SSL_CIPHER) *peer_ciphers; 1498 STACK_OF(SSL_CIPHER) *cipher_list; 1499 STACK_OF(SSL_CIPHER) *cipher_list_by_id; 1500 /* TLSv1.3 specific ciphersuites */ 1501 STACK_OF(SSL_CIPHER) *tls13_ciphersuites; 1502 /* 1503 * These are the ones being used, the ones in SSL_SESSION are the ones to 1504 * be 'copied' into these ones 1505 */ 1506 uint32_t mac_flags; 1507 /* 1508 * The TLS1.3 secrets. 1509 */ 1510 unsigned char early_secret[EVP_MAX_MD_SIZE]; 1511 unsigned char handshake_secret[EVP_MAX_MD_SIZE]; 1512 unsigned char master_secret[EVP_MAX_MD_SIZE]; 1513 unsigned char resumption_master_secret[EVP_MAX_MD_SIZE]; 1514 unsigned char client_finished_secret[EVP_MAX_MD_SIZE]; 1515 unsigned char server_finished_secret[EVP_MAX_MD_SIZE]; 1516 unsigned char server_finished_hash[EVP_MAX_MD_SIZE]; 1517 unsigned char handshake_traffic_hash[EVP_MAX_MD_SIZE]; 1518 unsigned char client_app_traffic_secret[EVP_MAX_MD_SIZE]; 1519 unsigned char server_app_traffic_secret[EVP_MAX_MD_SIZE]; 1520 unsigned char exporter_master_secret[EVP_MAX_MD_SIZE]; 1521 unsigned char early_exporter_master_secret[EVP_MAX_MD_SIZE]; 1522 1523 /* session info */ 1524 /* client cert? */ 1525 /* This is used to hold the server certificate used */ 1526 struct cert_st /* CERT */ *cert; 1527 1528 /* 1529 * The hash of all messages prior to the CertificateVerify, and the length 1530 * of that hash. 1531 */ 1532 unsigned char cert_verify_hash[EVP_MAX_MD_SIZE]; 1533 size_t cert_verify_hash_len; 1534 1535 /* Flag to indicate whether we should send a HelloRetryRequest or not */ 1536 enum {SSL_HRR_NONE = 0, SSL_HRR_PENDING, SSL_HRR_COMPLETE} 1537 hello_retry_request; 1538 1539 /* 1540 * the session_id_context is used to ensure sessions are only reused in 1541 * the appropriate context 1542 */ 1543 size_t sid_ctx_length; 1544 unsigned char sid_ctx[SSL_MAX_SID_CTX_LENGTH]; 1545 /* This can also be in the session once a session is established */ 1546 SSL_SESSION *session; 1547 /* TLSv1.3 PSK session */ 1548 SSL_SESSION *psksession; 1549 unsigned char *psksession_id; 1550 size_t psksession_id_len; 1551 /* Default generate session ID callback. */ 1552 GEN_SESSION_CB generate_session_id; 1553 /* 1554 * The temporary TLSv1.3 session id. This isn't really a session id at all 1555 * but is a random value sent in the legacy session id field. 1556 */ 1557 unsigned char tmp_session_id[SSL_MAX_SSL_SESSION_ID_LENGTH]; 1558 size_t tmp_session_id_len; 1559 /* Used in SSL3 */ 1560 /* 1561 * 0 don't care about verify failure. 1562 * 1 fail if verify fails 1563 */ 1564 uint32_t verify_mode; 1565 /* fail if callback returns 0 */ 1566 int (*verify_callback) (int ok, X509_STORE_CTX *ctx); 1567 /* optional informational callback */ 1568 void (*info_callback) (const SSL *ssl, int type, int val); 1569 /* error bytes to be written */ 1570 int error; 1571 /* actual code */ 1572 int error_code; 1573 # ifndef OPENSSL_NO_PSK 1574 SSL_psk_client_cb_func psk_client_callback; 1575 SSL_psk_server_cb_func psk_server_callback; 1576 # endif 1577 SSL_psk_find_session_cb_func psk_find_session_cb; 1578 SSL_psk_use_session_cb_func psk_use_session_cb; 1579 1580 /* Verified chain of peer */ 1581 STACK_OF(X509) *verified_chain; 1582 long verify_result; 1583 /* 1584 * What we put in certificate_authorities extension for TLS 1.3 1585 * (ClientHello and CertificateRequest) or just client cert requests for 1586 * earlier versions. If client_ca_names is populated then it is only used 1587 * for client cert requests, and in preference to ca_names. 1588 */ 1589 STACK_OF(X509_NAME) *ca_names; 1590 STACK_OF(X509_NAME) *client_ca_names; 1591 /* protocol behaviour */ 1592 uint64_t options; 1593 /* API behaviour */ 1594 uint32_t mode; 1595 int min_proto_version; 1596 int max_proto_version; 1597 size_t max_cert_list; 1598 int first_packet; 1599 /* 1600 * What was passed in ClientHello.legacy_version. Used for RSA pre-master 1601 * secret and SSLv3/TLS (<=1.2) rollback check 1602 */ 1603 int client_version; 1604 /* 1605 * If we're using more than one pipeline how should we divide the data 1606 * up between the pipes? 1607 */ 1608 size_t split_send_fragment; 1609 /* 1610 * Maximum amount of data to send in one fragment. actual record size can 1611 * be more than this due to padding and MAC overheads. 1612 */ 1613 size_t max_send_fragment; 1614 /* Up to how many pipelines should we use? If 0 then 1 is assumed */ 1615 size_t max_pipelines; 1616 1617 struct { 1618 /* Built-in extension flags */ 1619 uint8_t extflags[TLSEXT_IDX_num_builtins]; 1620 /* TLS extension debug callback */ 1621 void (*debug_cb)(SSL *s, int client_server, int type, 1622 const unsigned char *data, int len, void *arg); 1623 void *debug_arg; 1624 char *hostname; 1625 /* certificate status request info */ 1626 /* Status type or -1 if no status type */ 1627 int status_type; 1628 /* Raw extension data, if seen */ 1629 unsigned char *scts; 1630 /* Length of raw extension data, if seen */ 1631 uint16_t scts_len; 1632 /* Expect OCSP CertificateStatus message */ 1633 int status_expected; 1634 1635 struct { 1636 /* OCSP status request only */ 1637 STACK_OF(OCSP_RESPID) *ids; 1638 X509_EXTENSIONS *exts; 1639 /* OCSP response received or to be sent */ 1640 unsigned char *resp; 1641 size_t resp_len; 1642 } ocsp; 1643 1644 /* RFC4507 session ticket expected to be received or sent */ 1645 int ticket_expected; 1646 /* TLS 1.3 tickets requested by the application. */ 1647 int extra_tickets_expected; 1648 1649 /* our list */ 1650 size_t ecpointformats_len; 1651 unsigned char *ecpointformats; 1652 /* peer's list */ 1653 size_t peer_ecpointformats_len; 1654 unsigned char *peer_ecpointformats; 1655 1656 /* our list */ 1657 size_t supportedgroups_len; 1658 uint16_t *supportedgroups; 1659 /* peer's list */ 1660 size_t peer_supportedgroups_len; 1661 uint16_t *peer_supportedgroups; 1662 1663 /* key shares */ 1664 size_t keyshares_len; 1665 uint16_t *keyshares; 1666 /* supported groups tuples */ 1667 size_t tuples_len; 1668 size_t *tuples; 1669 1670 /* TLS Session Ticket extension override */ 1671 TLS_SESSION_TICKET_EXT *session_ticket; 1672 /* TLS Session Ticket extension callback */ 1673 tls_session_ticket_ext_cb_fn session_ticket_cb; 1674 void *session_ticket_cb_arg; 1675 /* TLS pre-shared secret session resumption */ 1676 tls_session_secret_cb_fn session_secret_cb; 1677 void *session_secret_cb_arg; 1678 /* 1679 * For a client, this contains the list of supported protocols in wire 1680 * format. 1681 */ 1682 unsigned char *alpn; 1683 size_t alpn_len; 1684 /* 1685 * Next protocol negotiation. For the client, this is the protocol that 1686 * we sent in NextProtocol and is set when handling ServerHello 1687 * extensions. For a server, this is the client's selected_protocol from 1688 * NextProtocol and is set when handling the NextProtocol message, before 1689 * the Finished message. 1690 */ 1691 unsigned char *npn; 1692 size_t npn_len; 1693 1694 /* The available PSK key exchange modes */ 1695 int psk_kex_mode; 1696 1697 /* Set to one if we have negotiated ETM */ 1698 int use_etm; 1699 1700 /* Are we expecting to receive early data? */ 1701 int early_data; 1702 /* Is the session suitable for early data? */ 1703 int early_data_ok; 1704 1705 /* May be sent by a server in HRR. Must be echoed back in ClientHello */ 1706 unsigned char *tls13_cookie; 1707 size_t tls13_cookie_len; 1708 /* Have we received a cookie from the client? */ 1709 int cookieok; 1710 1711 /* 1712 * Maximum Fragment Length as per RFC 4366. 1713 * If this member contains one of the allowed values (1-4) 1714 * then we should include Maximum Fragment Length Negotiation 1715 * extension in Client Hello. 1716 * Please note that value of this member does not have direct 1717 * effect. The actual (binding) value is stored in SSL_SESSION, 1718 * as this extension is optional on server side. 1719 */ 1720 uint8_t max_fragment_len_mode; 1721 1722 /* 1723 * On the client side the number of ticket identities we sent in the 1724 * ClientHello. On the server side the identity of the ticket we 1725 * selected. 1726 */ 1727 int tick_identity; 1728 1729 /* This is the list of algorithms the peer supports that we also support */ 1730 int compress_certificate_from_peer[TLSEXT_comp_cert_limit]; 1731 /* indicate that we sent the extension, so we'll accept it */ 1732 int compress_certificate_sent; 1733 1734 uint8_t client_cert_type; 1735 uint8_t client_cert_type_ctos; 1736 uint8_t server_cert_type; 1737 uint8_t server_cert_type_ctos; 1738 } ext; 1739 1740 /* 1741 * Parsed form of the ClientHello, kept around across client_hello_cb 1742 * calls. 1743 */ 1744 CLIENTHELLO_MSG *clienthello; 1745 1746 /*- 1747 * no further mod of servername 1748 * 0 : call the servername extension callback. 1749 * 1 : prepare 2, allow last ack just after in server callback. 1750 * 2 : don't call servername callback, no ack in server hello 1751 */ 1752 int servername_done; 1753 # ifndef OPENSSL_NO_CT 1754 /* 1755 * Validates that the SCTs (Signed Certificate Timestamps) are sufficient. 1756 * If they are not, the connection should be aborted. 1757 */ 1758 ssl_ct_validation_cb ct_validation_callback; 1759 /* User-supplied argument that is passed to the ct_validation_callback */ 1760 void *ct_validation_callback_arg; 1761 /* 1762 * Consolidated stack of SCTs from all sources. 1763 * Lazily populated by CT_get_peer_scts(SSL*) 1764 */ 1765 STACK_OF(SCT) *scts; 1766 /* Have we attempted to find/parse SCTs yet? */ 1767 int scts_parsed; 1768 # endif 1769 SSL_CTX *session_ctx; /* initial ctx, used to store sessions */ 1770 # ifndef OPENSSL_NO_SRTP 1771 /* What we'll do */ 1772 STACK_OF(SRTP_PROTECTION_PROFILE) *srtp_profiles; 1773 /* What's been chosen */ 1774 SRTP_PROTECTION_PROFILE *srtp_profile; 1775 # endif 1776 /*- 1777 * 1 if we are renegotiating. 1778 * 2 if we are a server and are inside a handshake 1779 * (i.e. not just sending a HelloRequest) 1780 */ 1781 int renegotiate; 1782 /* If sending a KeyUpdate is pending */ 1783 int key_update; 1784 /* Post-handshake authentication state */ 1785 SSL_PHA_STATE post_handshake_auth; 1786 int pha_enabled; 1787 uint8_t* pha_context; 1788 size_t pha_context_len; 1789 int certreqs_sent; 1790 EVP_MD_CTX *pha_dgst; /* this is just the digest through ClientFinished */ 1791 1792 # ifndef OPENSSL_NO_SRP 1793 /* ctx for SRP authentication */ 1794 SRP_CTX srp_ctx; 1795 # endif 1796 /* 1797 * Callback for disabling session caching and ticket support on a session 1798 * basis, depending on the chosen cipher. 1799 */ 1800 int (*not_resumable_session_cb) (SSL *ssl, int is_forward_secure); 1801 1802 /* Record layer data */ 1803 RECORD_LAYER rlayer; 1804 1805 /* Default password callback. */ 1806 pem_password_cb *default_passwd_callback; 1807 /* Default password callback user data. */ 1808 void *default_passwd_callback_userdata; 1809 /* Async Job info */ 1810 ASYNC_JOB *job; 1811 ASYNC_WAIT_CTX *waitctx; 1812 size_t asyncrw; 1813 1814 /* 1815 * The maximum number of bytes advertised in session tickets that can be 1816 * sent as early data. 1817 */ 1818 uint32_t max_early_data; 1819 /* 1820 * The maximum number of bytes of early data that a server will tolerate 1821 * (which should be at least as much as max_early_data). 1822 */ 1823 uint32_t recv_max_early_data; 1824 1825 /* 1826 * The number of bytes of early data received so far. If we accepted early 1827 * data then this is a count of the plaintext bytes. If we rejected it then 1828 * this is a count of the ciphertext bytes. 1829 */ 1830 uint32_t early_data_count; 1831 1832 /* The number of TLS1.3 tickets to automatically send */ 1833 size_t num_tickets; 1834 /* The number of TLS1.3 tickets actually sent so far */ 1835 size_t sent_tickets; 1836 /* The next nonce value to use when we send a ticket on this connection */ 1837 uint64_t next_ticket_nonce; 1838 1839 /* Callback to determine if early_data is acceptable or not */ 1840 SSL_allow_early_data_cb_fn allow_early_data_cb; 1841 void *allow_early_data_cb_data; 1842 1843 /* Callback for SSL async handling */ 1844 SSL_async_callback_fn async_cb; 1845 void *async_cb_arg; 1846 1847 /* 1848 * Signature algorithms shared by client and server: cached because these 1849 * are used most often. 1850 */ 1851 const struct sigalg_lookup_st **shared_sigalgs; 1852 size_t shared_sigalgslen; 1853 1854 #ifndef OPENSSL_NO_COMP_ALG 1855 /* certificate compression preferences */ 1856 int cert_comp_prefs[TLSEXT_comp_cert_limit]; 1857 #endif 1858 1859 /* Certificate Type stuff - for RPK vs X.509 */ 1860 unsigned char *client_cert_type; 1861 size_t client_cert_type_len; 1862 unsigned char *server_cert_type; 1863 size_t server_cert_type_len; 1864 }; 1865 1866 /* 1867 * Structure containing table entry of values associated with the signature 1868 * algorithms (signature scheme) extension 1869 */ 1870 typedef struct sigalg_lookup_st { 1871 /* TLS 1.3 signature scheme name */ 1872 const char *name; 1873 /* TLS 1.2 signature scheme name */ 1874 const char *name12; 1875 /* Raw value used in extension */ 1876 uint16_t sigalg; 1877 /* NID of hash algorithm or NID_undef if no hash */ 1878 int hash; 1879 /* Index of hash algorithm or -1 if no hash algorithm */ 1880 int hash_idx; 1881 /* NID of signature algorithm */ 1882 int sig; 1883 /* Index of signature algorithm */ 1884 int sig_idx; 1885 /* Combined hash and signature NID, if any */ 1886 int sigandhash; 1887 /* Required public key curve (ECDSA only) */ 1888 int curve; 1889 /* Whether this signature algorithm is actually available for use */ 1890 int available; 1891 /* Whether this signature algorithm is by default advertised */ 1892 int advertise; 1893 /* Supported protocol ranges */ 1894 int mintls; 1895 int maxtls; 1896 int mindtls; 1897 int maxdtls; 1898 } SIGALG_LOOKUP; 1899 1900 /* DTLS structures */ 1901 1902 # ifndef OPENSSL_NO_SCTP 1903 # define DTLS1_SCTP_AUTH_LABEL "EXPORTER_DTLS_OVER_SCTP" 1904 # endif 1905 1906 /* Max MTU overhead we know about so far is 40 for IPv6 + 8 for UDP */ 1907 # define DTLS1_MAX_MTU_OVERHEAD 48 1908 1909 struct dtls1_retransmit_state { 1910 const OSSL_RECORD_METHOD *wrlmethod; 1911 OSSL_RECORD_LAYER *wrl; 1912 }; 1913 1914 struct hm_header_st { 1915 unsigned char type; 1916 size_t msg_len; 1917 unsigned short seq; 1918 size_t frag_off; 1919 size_t frag_len; 1920 unsigned int is_ccs; 1921 struct dtls1_retransmit_state saved_retransmit_state; 1922 }; 1923 1924 typedef struct hm_fragment_st { 1925 struct hm_header_st msg_header; 1926 unsigned char *fragment; 1927 unsigned char *reassembly; 1928 } hm_fragment; 1929 1930 typedef struct pqueue_st pqueue; 1931 typedef struct pitem_st pitem; 1932 1933 struct pitem_st { 1934 unsigned char priority[8]; /* 64-bit value in big-endian encoding */ 1935 void *data; 1936 pitem *next; 1937 }; 1938 1939 typedef struct pitem_st *piterator; 1940 1941 pitem *pitem_new(unsigned char *prio64be, void *data); 1942 void pitem_free(pitem *item); 1943 pqueue *pqueue_new(void); 1944 void pqueue_free(pqueue *pq); 1945 pitem *pqueue_insert(pqueue *pq, pitem *item); 1946 pitem *pqueue_peek(pqueue *pq); 1947 pitem *pqueue_pop(pqueue *pq); 1948 pitem *pqueue_find(pqueue *pq, unsigned char *prio64be); 1949 pitem *pqueue_iterator(pqueue *pq); 1950 pitem *pqueue_next(piterator *iter); 1951 size_t pqueue_size(pqueue *pq); 1952 1953 typedef struct dtls1_state_st { 1954 unsigned char cookie[DTLS1_COOKIE_LENGTH]; 1955 size_t cookie_len; 1956 unsigned int cookie_verified; 1957 /* handshake message numbers */ 1958 unsigned short handshake_write_seq; 1959 unsigned short next_handshake_write_seq; 1960 unsigned short handshake_read_seq; 1961 /* Buffered handshake messages */ 1962 pqueue *buffered_messages; 1963 /* Buffered (sent) handshake records */ 1964 pqueue *sent_messages; 1965 size_t link_mtu; /* max on-the-wire DTLS packet size */ 1966 size_t mtu; /* max DTLS packet size */ 1967 struct hm_header_st w_msg_hdr; 1968 struct hm_header_st r_msg_hdr; 1969 /* Number of alerts received so far */ 1970 unsigned int timeout_num_alerts; 1971 /* 1972 * Indicates when the last handshake msg sent will timeout 1973 */ 1974 OSSL_TIME next_timeout; 1975 /* Timeout duration */ 1976 unsigned int timeout_duration_us; 1977 1978 unsigned int retransmitting; 1979 # ifndef OPENSSL_NO_SCTP 1980 int shutdown_received; 1981 # endif 1982 1983 DTLS_timer_cb timer_cb; 1984 1985 } DTLS1_STATE; 1986 1987 /* 1988 * From ECC-TLS draft, used in encoding the curve type in ECParameters 1989 */ 1990 # define EXPLICIT_PRIME_CURVE_TYPE 1 1991 # define EXPLICIT_CHAR2_CURVE_TYPE 2 1992 # define NAMED_CURVE_TYPE 3 1993 1994 # ifndef OPENSSL_NO_COMP_ALG 1995 struct ossl_comp_cert_st { 1996 unsigned char *data; 1997 size_t len; 1998 size_t orig_len; 1999 CRYPTO_REF_COUNT references; 2000 int alg; 2001 }; 2002 typedef struct ossl_comp_cert_st OSSL_COMP_CERT; 2003 2004 void OSSL_COMP_CERT_free(OSSL_COMP_CERT *c); 2005 int OSSL_COMP_CERT_up_ref(OSSL_COMP_CERT *c); 2006 # endif 2007 2008 struct cert_pkey_st { 2009 X509 *x509; 2010 EVP_PKEY *privatekey; 2011 /* Chain for this certificate */ 2012 STACK_OF(X509) *chain; 2013 /*- 2014 * serverinfo data for this certificate. The data is in TLS Extension 2015 * wire format, specifically it's a series of records like: 2016 * uint16_t extension_type; // (RFC 5246, 7.4.1.4, Extension) 2017 * uint16_t length; 2018 * uint8_t data[length]; 2019 */ 2020 unsigned char *serverinfo; 2021 size_t serverinfo_length; 2022 # ifndef OPENSSL_NO_COMP_ALG 2023 /* Compressed certificate data - index 0 is unused */ 2024 OSSL_COMP_CERT *comp_cert[TLSEXT_comp_cert_limit]; 2025 int cert_comp_used; 2026 # endif 2027 }; 2028 /* Retrieve Suite B flags */ 2029 # define tls1_suiteb(s) (s->cert->cert_flags & SSL_CERT_FLAG_SUITEB_128_LOS) 2030 /* Uses to check strict mode: suite B modes are always strict */ 2031 # define SSL_CERT_FLAGS_CHECK_TLS_STRICT \ 2032 (SSL_CERT_FLAG_SUITEB_128_LOS|SSL_CERT_FLAG_TLS_STRICT) 2033 2034 typedef enum { 2035 ENDPOINT_CLIENT = 0, 2036 ENDPOINT_SERVER, 2037 ENDPOINT_BOTH 2038 } ENDPOINT; 2039 2040 2041 typedef struct { 2042 unsigned short ext_type; 2043 ENDPOINT role; 2044 /* The context which this extension applies to */ 2045 unsigned int context; 2046 /* 2047 * Per-connection flags relating to this extension type: not used if 2048 * part of an SSL_CTX structure. 2049 */ 2050 uint32_t ext_flags; 2051 SSL_custom_ext_add_cb_ex add_cb; 2052 SSL_custom_ext_free_cb_ex free_cb; 2053 void *add_arg; 2054 SSL_custom_ext_parse_cb_ex parse_cb; 2055 void *parse_arg; 2056 } custom_ext_method; 2057 2058 /* ext_flags values */ 2059 2060 /* 2061 * Indicates an extension has been received. Used to check for unsolicited or 2062 * duplicate extensions. 2063 */ 2064 # define SSL_EXT_FLAG_RECEIVED 0x1 2065 /* 2066 * Indicates an extension has been sent: used to enable sending of 2067 * corresponding ServerHello extension. 2068 */ 2069 # define SSL_EXT_FLAG_SENT 0x2 2070 /* 2071 * Indicates an extension that was set on SSL object and needs to be 2072 * preserved when switching SSL contexts. 2073 */ 2074 # define SSL_EXT_FLAG_CONN 0x4 2075 2076 typedef struct { 2077 custom_ext_method *meths; 2078 size_t meths_count; 2079 } custom_ext_methods; 2080 2081 typedef struct cert_st { 2082 /* Current active set */ 2083 /* 2084 * ALWAYS points to an element of the pkeys array 2085 * Probably it would make more sense to store 2086 * an index, not a pointer. 2087 */ 2088 CERT_PKEY *key; 2089 2090 EVP_PKEY *dh_tmp; 2091 DH *(*dh_tmp_cb) (SSL *ssl, int is_export, int keysize); 2092 int dh_tmp_auto; 2093 /* Flags related to certificates */ 2094 uint32_t cert_flags; 2095 CERT_PKEY *pkeys; 2096 size_t ssl_pkey_num; 2097 /* Custom certificate types sent in certificate request message. */ 2098 uint8_t *ctype; 2099 size_t ctype_len; 2100 /* 2101 * supported signature algorithms. When set on a client this is sent in 2102 * the client hello as the supported signature algorithms extension. For 2103 * servers it represents the signature algorithms we are willing to use. 2104 */ 2105 uint16_t *conf_sigalgs; 2106 /* Size of above array */ 2107 size_t conf_sigalgslen; 2108 /* 2109 * Client authentication signature algorithms, if not set then uses 2110 * conf_sigalgs. On servers these will be the signature algorithms sent 2111 * to the client in a certificate request for TLS 1.2. On a client this 2112 * represents the signature algorithms we are willing to use for client 2113 * authentication. 2114 */ 2115 uint16_t *client_sigalgs; 2116 /* Size of above array */ 2117 size_t client_sigalgslen; 2118 /* 2119 * Certificate setup callback: if set is called whenever a certificate 2120 * may be required (client or server). the callback can then examine any 2121 * appropriate parameters and setup any certificates required. This 2122 * allows advanced applications to select certificates on the fly: for 2123 * example based on supported signature algorithms or curves. 2124 */ 2125 int (*cert_cb) (SSL *ssl, void *arg); 2126 void *cert_cb_arg; 2127 /* 2128 * Optional X509_STORE for chain building or certificate validation If 2129 * NULL the parent SSL_CTX store is used instead. 2130 */ 2131 X509_STORE *chain_store; 2132 X509_STORE *verify_store; 2133 /* Custom extensions */ 2134 custom_ext_methods custext; 2135 /* Security callback */ 2136 int (*sec_cb) (const SSL *s, const SSL_CTX *ctx, int op, int bits, int nid, 2137 void *other, void *ex); 2138 /* Security level */ 2139 int sec_level; 2140 void *sec_ex; 2141 # ifndef OPENSSL_NO_PSK 2142 /* If not NULL psk identity hint to use for servers */ 2143 char *psk_identity_hint; 2144 # endif 2145 CRYPTO_REF_COUNT references; /* >1 only if SSL_copy_session_id is used */ 2146 } CERT; 2147 2148 /* 2149 * This is for the SSLv3/TLSv1.0 differences in crypto/hash stuff It is a bit 2150 * of a mess of functions, but hell, think of it as an opaque structure :-) 2151 */ 2152 typedef struct ssl3_enc_method { 2153 int (*setup_key_block) (SSL_CONNECTION *); 2154 int (*generate_master_secret) (SSL_CONNECTION *, unsigned char *, 2155 unsigned char *, size_t, size_t *); 2156 int (*change_cipher_state) (SSL_CONNECTION *, int); 2157 size_t (*final_finish_mac) (SSL_CONNECTION *, const char *, size_t, 2158 unsigned char *); 2159 const char *client_finished_label; 2160 size_t client_finished_label_len; 2161 const char *server_finished_label; 2162 size_t server_finished_label_len; 2163 int (*alert_value) (int); 2164 int (*export_keying_material) (SSL_CONNECTION *, unsigned char *, size_t, 2165 const char *, size_t, 2166 const unsigned char *, size_t, 2167 int use_context); 2168 /* Various flags indicating protocol version requirements */ 2169 uint32_t enc_flags; 2170 /* Set the handshake header */ 2171 int (*set_handshake_header) (SSL_CONNECTION *s, WPACKET *pkt, int type); 2172 /* Close construction of the handshake message */ 2173 int (*close_construct_packet) (SSL_CONNECTION *s, WPACKET *pkt, int htype); 2174 /* Write out handshake message */ 2175 int (*do_write) (SSL_CONNECTION *s); 2176 } SSL3_ENC_METHOD; 2177 2178 # define ssl_set_handshake_header(s, pkt, htype) \ 2179 SSL_CONNECTION_GET_SSL(s)->method->ssl3_enc->set_handshake_header((s), (pkt), (htype)) 2180 # define ssl_close_construct_packet(s, pkt, htype) \ 2181 SSL_CONNECTION_GET_SSL(s)->method->ssl3_enc->close_construct_packet((s), (pkt), (htype)) 2182 # define ssl_do_write(s) SSL_CONNECTION_GET_SSL(s)->method->ssl3_enc->do_write(s) 2183 2184 /* Values for enc_flags */ 2185 2186 /* Uses signature algorithms extension */ 2187 # define SSL_ENC_FLAG_SIGALGS 0x2 2188 /* Uses SHA256 default PRF */ 2189 # define SSL_ENC_FLAG_SHA256_PRF 0x4 2190 /* Is DTLS */ 2191 # define SSL_ENC_FLAG_DTLS 0x8 2192 /* 2193 * Allow TLS 1.2 ciphersuites: applies to DTLS 1.2 as well as TLS 1.2: may 2194 * apply to others in future. 2195 */ 2196 # define SSL_ENC_FLAG_TLS1_2_CIPHERS 0x10 2197 2198 typedef enum downgrade_en { 2199 DOWNGRADE_NONE, 2200 DOWNGRADE_TO_1_2, 2201 DOWNGRADE_TO_1_1 2202 } DOWNGRADE; 2203 2204 /* 2205 * Dummy status type for the status_type extension. Indicates no status type 2206 * set 2207 */ 2208 #define TLSEXT_STATUSTYPE_nothing -1 2209 2210 /* Sigalgs values */ 2211 #define TLSEXT_SIGALG_ecdsa_secp256r1_sha256 0x0403 2212 #define TLSEXT_SIGALG_ecdsa_secp384r1_sha384 0x0503 2213 #define TLSEXT_SIGALG_ecdsa_secp521r1_sha512 0x0603 2214 #define TLSEXT_SIGALG_ecdsa_sha224 0x0303 2215 #define TLSEXT_SIGALG_ecdsa_sha1 0x0203 2216 #define TLSEXT_SIGALG_rsa_pss_rsae_sha256 0x0804 2217 #define TLSEXT_SIGALG_rsa_pss_rsae_sha384 0x0805 2218 #define TLSEXT_SIGALG_rsa_pss_rsae_sha512 0x0806 2219 #define TLSEXT_SIGALG_rsa_pss_pss_sha256 0x0809 2220 #define TLSEXT_SIGALG_rsa_pss_pss_sha384 0x080a 2221 #define TLSEXT_SIGALG_rsa_pss_pss_sha512 0x080b 2222 #define TLSEXT_SIGALG_rsa_pkcs1_sha256 0x0401 2223 #define TLSEXT_SIGALG_rsa_pkcs1_sha384 0x0501 2224 #define TLSEXT_SIGALG_rsa_pkcs1_sha512 0x0601 2225 #define TLSEXT_SIGALG_rsa_pkcs1_sha224 0x0301 2226 #define TLSEXT_SIGALG_rsa_pkcs1_sha1 0x0201 2227 #define TLSEXT_SIGALG_dsa_sha256 0x0402 2228 #define TLSEXT_SIGALG_dsa_sha384 0x0502 2229 #define TLSEXT_SIGALG_dsa_sha512 0x0602 2230 #define TLSEXT_SIGALG_dsa_sha224 0x0302 2231 #define TLSEXT_SIGALG_dsa_sha1 0x0202 2232 #define TLSEXT_SIGALG_gostr34102012_256_intrinsic 0x0840 2233 #define TLSEXT_SIGALG_gostr34102012_512_intrinsic 0x0841 2234 #define TLSEXT_SIGALG_gostr34102012_256_gostr34112012_256 0xeeee 2235 #define TLSEXT_SIGALG_gostr34102012_512_gostr34112012_512 0xefef 2236 #define TLSEXT_SIGALG_gostr34102001_gostr3411 0xeded 2237 2238 #define TLSEXT_SIGALG_ed25519 0x0807 2239 #define TLSEXT_SIGALG_ed448 0x0808 2240 #define TLSEXT_SIGALG_ecdsa_brainpoolP256r1_sha256 0x081a 2241 #define TLSEXT_SIGALG_ecdsa_brainpoolP384r1_sha384 0x081b 2242 #define TLSEXT_SIGALG_ecdsa_brainpoolP512r1_sha512 0x081c 2243 #define TLSEXT_SIGALG_mldsa44 0x0904 2244 #define TLSEXT_SIGALG_mldsa65 0x0905 2245 #define TLSEXT_SIGALG_mldsa87 0x0906 2246 2247 /* Sigalgs names */ 2248 #define TLSEXT_SIGALG_ecdsa_secp256r1_sha256_name "ecdsa_secp256r1_sha256" 2249 #define TLSEXT_SIGALG_ecdsa_secp384r1_sha384_name "ecdsa_secp384r1_sha384" 2250 #define TLSEXT_SIGALG_ecdsa_secp521r1_sha512_name "ecdsa_secp521r1_sha512" 2251 #define TLSEXT_SIGALG_ecdsa_sha224_name "ecdsa_sha224" 2252 #define TLSEXT_SIGALG_ecdsa_sha1_name "ecdsa_sha1" 2253 #define TLSEXT_SIGALG_rsa_pss_rsae_sha256_name "rsa_pss_rsae_sha256" 2254 #define TLSEXT_SIGALG_rsa_pss_rsae_sha384_name "rsa_pss_rsae_sha384" 2255 #define TLSEXT_SIGALG_rsa_pss_rsae_sha512_name "rsa_pss_rsae_sha512" 2256 #define TLSEXT_SIGALG_rsa_pss_pss_sha256_name "rsa_pss_pss_sha256" 2257 #define TLSEXT_SIGALG_rsa_pss_pss_sha384_name "rsa_pss_pss_sha384" 2258 #define TLSEXT_SIGALG_rsa_pss_pss_sha512_name "rsa_pss_pss_sha512" 2259 #define TLSEXT_SIGALG_rsa_pkcs1_sha256_name "rsa_pkcs1_sha256" 2260 #define TLSEXT_SIGALG_rsa_pkcs1_sha384_name "rsa_pkcs1_sha384" 2261 #define TLSEXT_SIGALG_rsa_pkcs1_sha512_name "rsa_pkcs1_sha512" 2262 #define TLSEXT_SIGALG_rsa_pkcs1_sha224_name "rsa_pkcs1_sha224" 2263 #define TLSEXT_SIGALG_rsa_pkcs1_sha1_name "rsa_pkcs1_sha1" 2264 #define TLSEXT_SIGALG_dsa_sha256_name "dsa_sha256" 2265 #define TLSEXT_SIGALG_dsa_sha384_name "dsa_sha384" 2266 #define TLSEXT_SIGALG_dsa_sha512_name "dsa_sha512" 2267 #define TLSEXT_SIGALG_dsa_sha224_name "dsa_sha224" 2268 #define TLSEXT_SIGALG_dsa_sha1_name "dsa_sha1" 2269 #define TLSEXT_SIGALG_gostr34102012_256_intrinsic_name "gostr34102012_256" 2270 #define TLSEXT_SIGALG_gostr34102012_512_intrinsic_name "gostr34102012_512" 2271 #define TLSEXT_SIGALG_gostr34102012_256_intrinsic_alias "gost2012_256" 2272 #define TLSEXT_SIGALG_gostr34102012_512_intrinsic_alias "gost2012_512" 2273 #define TLSEXT_SIGALG_gostr34102012_256_gostr34112012_256_name "gost2012_256" 2274 #define TLSEXT_SIGALG_gostr34102012_512_gostr34112012_512_name "gost2012_512" 2275 #define TLSEXT_SIGALG_gostr34102001_gostr3411_name "gost2001_gost94" 2276 2277 #define TLSEXT_SIGALG_ed25519_name "ed25519" 2278 #define TLSEXT_SIGALG_ed448_name "ed448" 2279 #define TLSEXT_SIGALG_ecdsa_brainpoolP256r1_sha256_name "ecdsa_brainpoolP256r1tls13_sha256" 2280 #define TLSEXT_SIGALG_ecdsa_brainpoolP384r1_sha384_name "ecdsa_brainpoolP384r1tls13_sha384" 2281 #define TLSEXT_SIGALG_ecdsa_brainpoolP512r1_sha512_name "ecdsa_brainpoolP512r1tls13_sha512" 2282 #define TLSEXT_SIGALG_ecdsa_brainpoolP256r1_sha256_alias "ecdsa_brainpoolP256r1_sha256" 2283 #define TLSEXT_SIGALG_ecdsa_brainpoolP384r1_sha384_alias "ecdsa_brainpoolP384r1_sha384" 2284 #define TLSEXT_SIGALG_ecdsa_brainpoolP512r1_sha512_alias "ecdsa_brainpoolP512r1_sha512" 2285 #define TLSEXT_SIGALG_mldsa44_name "mldsa44" 2286 #define TLSEXT_SIGALG_mldsa65_name "mldsa65" 2287 #define TLSEXT_SIGALG_mldsa87_name "mldsa87" 2288 2289 /* Known PSK key exchange modes */ 2290 #define TLSEXT_KEX_MODE_KE 0x00 2291 #define TLSEXT_KEX_MODE_KE_DHE 0x01 2292 2293 /* 2294 * Internal representations of key exchange modes 2295 */ 2296 #define TLSEXT_KEX_MODE_FLAG_NONE 0 2297 #define TLSEXT_KEX_MODE_FLAG_KE 1 2298 #define TLSEXT_KEX_MODE_FLAG_KE_DHE 2 2299 2300 #define SSL_USE_PSS(s) (s->s3.tmp.peer_sigalg != NULL && \ 2301 s->s3.tmp.peer_sigalg->sig == EVP_PKEY_RSA_PSS) 2302 2303 /* TLSv1.3 downgrade protection sentinel values */ 2304 extern const unsigned char tls11downgrade[8]; 2305 extern const unsigned char tls12downgrade[8]; 2306 2307 extern const SSL3_ENC_METHOD ssl3_undef_enc_method; 2308 2309 __owur const SSL_METHOD *sslv3_method(void); 2310 __owur const SSL_METHOD *sslv3_server_method(void); 2311 __owur const SSL_METHOD *sslv3_client_method(void); 2312 __owur const SSL_METHOD *tlsv1_method(void); 2313 __owur const SSL_METHOD *tlsv1_server_method(void); 2314 __owur const SSL_METHOD *tlsv1_client_method(void); 2315 __owur const SSL_METHOD *tlsv1_1_method(void); 2316 __owur const SSL_METHOD *tlsv1_1_server_method(void); 2317 __owur const SSL_METHOD *tlsv1_1_client_method(void); 2318 __owur const SSL_METHOD *tlsv1_2_method(void); 2319 __owur const SSL_METHOD *tlsv1_2_server_method(void); 2320 __owur const SSL_METHOD *tlsv1_2_client_method(void); 2321 __owur const SSL_METHOD *tlsv1_3_method(void); 2322 __owur const SSL_METHOD *tlsv1_3_server_method(void); 2323 __owur const SSL_METHOD *tlsv1_3_client_method(void); 2324 __owur const SSL_METHOD *dtlsv1_method(void); 2325 __owur const SSL_METHOD *dtlsv1_server_method(void); 2326 __owur const SSL_METHOD *dtlsv1_client_method(void); 2327 __owur const SSL_METHOD *dtls_bad_ver_client_method(void); 2328 __owur const SSL_METHOD *dtlsv1_2_method(void); 2329 __owur const SSL_METHOD *dtlsv1_2_server_method(void); 2330 __owur const SSL_METHOD *dtlsv1_2_client_method(void); 2331 2332 extern const SSL3_ENC_METHOD TLSv1_enc_data; 2333 extern const SSL3_ENC_METHOD TLSv1_1_enc_data; 2334 extern const SSL3_ENC_METHOD TLSv1_2_enc_data; 2335 extern const SSL3_ENC_METHOD TLSv1_3_enc_data; 2336 extern const SSL3_ENC_METHOD SSLv3_enc_data; 2337 extern const SSL3_ENC_METHOD DTLSv1_enc_data; 2338 extern const SSL3_ENC_METHOD DTLSv1_2_enc_data; 2339 2340 /* 2341 * Flags for SSL methods 2342 */ 2343 # define SSL_METHOD_NO_FIPS (1U<<0) 2344 # define SSL_METHOD_NO_SUITEB (1U<<1) 2345 2346 # define IMPLEMENT_tls_meth_func(version, flags, mask, func_name, s_accept, \ 2347 s_connect, enc_data) \ 2348 const SSL_METHOD *func_name(void) \ 2349 { \ 2350 static const SSL_METHOD func_name##_data= { \ 2351 version, \ 2352 flags, \ 2353 mask, \ 2354 ossl_ssl_connection_new, \ 2355 ossl_ssl_connection_free, \ 2356 ossl_ssl_connection_reset, \ 2357 tls1_new, \ 2358 tls1_clear, \ 2359 tls1_free, \ 2360 s_accept, \ 2361 s_connect, \ 2362 ssl3_read, \ 2363 ssl3_peek, \ 2364 ssl3_write, \ 2365 ssl3_shutdown, \ 2366 ssl3_renegotiate, \ 2367 ssl3_renegotiate_check, \ 2368 ssl3_read_bytes, \ 2369 ssl3_write_bytes, \ 2370 ssl3_dispatch_alert, \ 2371 ssl3_ctrl, \ 2372 ssl3_ctx_ctrl, \ 2373 ssl3_get_cipher_by_char, \ 2374 ssl3_put_cipher_by_char, \ 2375 ssl3_pending, \ 2376 ssl3_num_ciphers, \ 2377 ssl3_get_cipher, \ 2378 tls1_default_timeout, \ 2379 &enc_data, \ 2380 ssl_undefined_void_function, \ 2381 ssl3_callback_ctrl, \ 2382 ssl3_ctx_callback_ctrl, \ 2383 }; \ 2384 return &func_name##_data; \ 2385 } 2386 2387 # define IMPLEMENT_ssl3_meth_func(func_name, s_accept, s_connect) \ 2388 const SSL_METHOD *func_name(void) \ 2389 { \ 2390 static const SSL_METHOD func_name##_data= { \ 2391 SSL3_VERSION, \ 2392 SSL_METHOD_NO_FIPS | SSL_METHOD_NO_SUITEB, \ 2393 SSL_OP_NO_SSLv3, \ 2394 ossl_ssl_connection_new, \ 2395 ossl_ssl_connection_free, \ 2396 ossl_ssl_connection_reset, \ 2397 ssl3_new, \ 2398 ssl3_clear, \ 2399 ssl3_free, \ 2400 s_accept, \ 2401 s_connect, \ 2402 ssl3_read, \ 2403 ssl3_peek, \ 2404 ssl3_write, \ 2405 ssl3_shutdown, \ 2406 ssl3_renegotiate, \ 2407 ssl3_renegotiate_check, \ 2408 ssl3_read_bytes, \ 2409 ssl3_write_bytes, \ 2410 ssl3_dispatch_alert, \ 2411 ssl3_ctrl, \ 2412 ssl3_ctx_ctrl, \ 2413 ssl3_get_cipher_by_char, \ 2414 ssl3_put_cipher_by_char, \ 2415 ssl3_pending, \ 2416 ssl3_num_ciphers, \ 2417 ssl3_get_cipher, \ 2418 ssl3_default_timeout, \ 2419 &SSLv3_enc_data, \ 2420 ssl_undefined_void_function, \ 2421 ssl3_callback_ctrl, \ 2422 ssl3_ctx_callback_ctrl, \ 2423 }; \ 2424 return &func_name##_data; \ 2425 } 2426 2427 # define IMPLEMENT_dtls1_meth_func(version, flags, mask, func_name, s_accept, \ 2428 s_connect, enc_data) \ 2429 const SSL_METHOD *func_name(void) \ 2430 { \ 2431 static const SSL_METHOD func_name##_data= { \ 2432 version, \ 2433 flags, \ 2434 mask, \ 2435 ossl_ssl_connection_new, \ 2436 ossl_ssl_connection_free, \ 2437 ossl_ssl_connection_reset, \ 2438 dtls1_new, \ 2439 dtls1_clear, \ 2440 dtls1_free, \ 2441 s_accept, \ 2442 s_connect, \ 2443 ssl3_read, \ 2444 ssl3_peek, \ 2445 ssl3_write, \ 2446 dtls1_shutdown, \ 2447 ssl3_renegotiate, \ 2448 ssl3_renegotiate_check, \ 2449 dtls1_read_bytes, \ 2450 dtls1_write_app_data_bytes, \ 2451 dtls1_dispatch_alert, \ 2452 dtls1_ctrl, \ 2453 ssl3_ctx_ctrl, \ 2454 ssl3_get_cipher_by_char, \ 2455 ssl3_put_cipher_by_char, \ 2456 ssl3_pending, \ 2457 ssl3_num_ciphers, \ 2458 ssl3_get_cipher, \ 2459 dtls1_default_timeout, \ 2460 &enc_data, \ 2461 ssl_undefined_void_function, \ 2462 ssl3_callback_ctrl, \ 2463 ssl3_ctx_callback_ctrl, \ 2464 }; \ 2465 return &func_name##_data; \ 2466 } 2467 2468 struct openssl_ssl_test_functions { 2469 int (*p_ssl_init_wbio_buffer) (SSL_CONNECTION *s); 2470 }; 2471 2472 const char *ssl_protocol_to_string(int version); 2473 2474 static ossl_inline int tls12_rpk_and_privkey(const SSL_CONNECTION *sc, int idx) 2475 { 2476 /* 2477 * This is to check for special cases when using RPK with just 2478 * a private key, and NO CERTIFICATE 2479 */ 2480 return ((sc->server && sc->ext.server_cert_type == TLSEXT_cert_type_rpk) 2481 || (!sc->server && sc->ext.client_cert_type == TLSEXT_cert_type_rpk)) 2482 && sc->cert->pkeys[idx].privatekey != NULL 2483 && sc->cert->pkeys[idx].x509 == NULL; 2484 } 2485 2486 static ossl_inline int ssl_has_cert_type(const SSL_CONNECTION *sc, unsigned char ct) 2487 { 2488 unsigned char *ptr; 2489 size_t len; 2490 2491 if (sc->server) { 2492 ptr = sc->server_cert_type; 2493 len = sc->server_cert_type_len; 2494 } else { 2495 ptr = sc->client_cert_type; 2496 len = sc->client_cert_type_len; 2497 } 2498 2499 if (ptr == NULL) 2500 return 0; 2501 2502 return memchr(ptr, ct, len) != NULL; 2503 } 2504 2505 /* Returns true if certificate and private key for 'idx' are present */ 2506 static ossl_inline int ssl_has_cert(const SSL_CONNECTION *s, int idx) 2507 { 2508 if (idx < 0 || idx >= (int)s->ssl_pkey_num) 2509 return 0; 2510 2511 /* If RPK is enabled for this SSL... only require private key */ 2512 if (ssl_has_cert_type(s, TLSEXT_cert_type_rpk)) 2513 return s->cert->pkeys[idx].privatekey != NULL; 2514 2515 return s->cert->pkeys[idx].x509 != NULL 2516 && s->cert->pkeys[idx].privatekey != NULL; 2517 } 2518 2519 static ossl_inline void tls1_get_peer_groups(SSL_CONNECTION *s, 2520 const uint16_t **pgroups, 2521 size_t *pgroupslen) 2522 { 2523 *pgroups = s->ext.peer_supportedgroups; 2524 *pgroupslen = s->ext.peer_supportedgroups_len; 2525 } 2526 2527 # ifndef OPENSSL_UNIT_TEST 2528 2529 __owur int ossl_ssl_init(SSL *ssl, SSL_CTX *ctx, const SSL_METHOD *method, 2530 int type); 2531 __owur SSL *ossl_ssl_connection_new_int(SSL_CTX *ctx, SSL *user_ssl, 2532 const SSL_METHOD *method); 2533 __owur SSL *ossl_ssl_connection_new(SSL_CTX *ctx); 2534 void ossl_ssl_connection_free(SSL *ssl); 2535 __owur int ossl_ssl_connection_reset(SSL *ssl); 2536 2537 __owur int ssl_read_internal(SSL *s, void *buf, size_t num, size_t *readbytes); 2538 __owur int ssl_write_internal(SSL *s, const void *buf, size_t num, 2539 uint64_t flags, size_t *written); 2540 int ssl_clear_bad_session(SSL_CONNECTION *s); 2541 __owur CERT *ssl_cert_new(size_t ssl_pkey_num); 2542 __owur CERT *ssl_cert_dup(CERT *cert); 2543 void ssl_cert_clear_certs(CERT *c); 2544 void ssl_cert_free(CERT *c); 2545 __owur int ssl_generate_session_id(SSL_CONNECTION *s, SSL_SESSION *ss); 2546 __owur int ssl_get_new_session(SSL_CONNECTION *s, int session); 2547 __owur SSL_SESSION *lookup_sess_in_cache(SSL_CONNECTION *s, 2548 const unsigned char *sess_id, 2549 size_t sess_id_len); 2550 __owur int ssl_get_prev_session(SSL_CONNECTION *s, CLIENTHELLO_MSG *hello); 2551 __owur SSL_SESSION *ssl_session_dup(const SSL_SESSION *src, int ticket); 2552 __owur int ssl_cipher_id_cmp(const SSL_CIPHER *a, const SSL_CIPHER *b); 2553 DECLARE_OBJ_BSEARCH_GLOBAL_CMP_FN(SSL_CIPHER, SSL_CIPHER, ssl_cipher_id); 2554 __owur int ssl_cipher_ptr_id_cmp(const SSL_CIPHER *const *ap, 2555 const SSL_CIPHER *const *bp); 2556 __owur STACK_OF(SSL_CIPHER) *ssl_create_cipher_list(SSL_CTX *ctx, 2557 STACK_OF(SSL_CIPHER) *tls13_ciphersuites, 2558 STACK_OF(SSL_CIPHER) **cipher_list, 2559 STACK_OF(SSL_CIPHER) **cipher_list_by_id, 2560 const char *rule_str, 2561 CERT *c); 2562 __owur int ssl_cache_cipherlist(SSL_CONNECTION *s, PACKET *cipher_suites, 2563 int sslv2format); 2564 __owur int ossl_bytes_to_cipher_list(SSL_CONNECTION *s, PACKET *cipher_suites, 2565 STACK_OF(SSL_CIPHER) **skp, 2566 STACK_OF(SSL_CIPHER) **scsvs, int sslv2format, 2567 int fatal); 2568 void ssl_update_cache(SSL_CONNECTION *s, int mode); 2569 __owur int ssl_cipher_get_evp_cipher(SSL_CTX *ctx, const SSL_CIPHER *sslc, 2570 const EVP_CIPHER **enc); 2571 __owur int ssl_cipher_get_evp_md_mac(SSL_CTX *ctx, const SSL_CIPHER *sslc, 2572 const EVP_MD **md, 2573 int *mac_pkey_type, size_t *mac_secret_size); 2574 __owur int ssl_cipher_get_evp(SSL_CTX *ctxc, const SSL_SESSION *s, 2575 const EVP_CIPHER **enc, const EVP_MD **md, 2576 int *mac_pkey_type, size_t *mac_secret_size, 2577 SSL_COMP **comp, int use_etm); 2578 __owur int ssl_cipher_get_overhead(const SSL_CIPHER *c, size_t *mac_overhead, 2579 size_t *int_overhead, size_t *blocksize, 2580 size_t *ext_overhead); 2581 __owur int ssl_cert_is_disabled(SSL_CTX *ctx, size_t idx); 2582 __owur const SSL_CIPHER *ssl_get_cipher_by_char(SSL_CONNECTION *ssl, 2583 const unsigned char *ptr, 2584 int all); 2585 __owur int ssl_cert_set0_chain(SSL_CONNECTION *s, SSL_CTX *ctx, 2586 STACK_OF(X509) *chain); 2587 __owur int ssl_cert_set1_chain(SSL_CONNECTION *s, SSL_CTX *ctx, 2588 STACK_OF(X509) *chain); 2589 __owur int ssl_cert_add0_chain_cert(SSL_CONNECTION *s, SSL_CTX *ctx, X509 *x); 2590 __owur int ssl_cert_add1_chain_cert(SSL_CONNECTION *s, SSL_CTX *ctx, X509 *x); 2591 __owur int ssl_cert_select_current(CERT *c, X509 *x); 2592 __owur int ssl_cert_set_current(CERT *c, long arg); 2593 void ssl_cert_set_cert_cb(CERT *c, int (*cb) (SSL *ssl, void *arg), void *arg); 2594 2595 __owur int ssl_verify_cert_chain(SSL_CONNECTION *s, STACK_OF(X509) *sk); 2596 __owur int ssl_verify_rpk(SSL_CONNECTION *s, EVP_PKEY *rpk); 2597 __owur int ssl_build_cert_chain(SSL_CONNECTION *s, SSL_CTX *ctx, int flags); 2598 __owur int ssl_cert_set_cert_store(CERT *c, X509_STORE *store, int chain, 2599 int ref); 2600 __owur int ssl_cert_get_cert_store(CERT *c, X509_STORE **pstore, int chain); 2601 2602 __owur int ssl_security(const SSL_CONNECTION *s, int op, int bits, int nid, 2603 void *other); 2604 __owur int ssl_ctx_security(const SSL_CTX *ctx, int op, int bits, int nid, 2605 void *other); 2606 int ssl_get_security_level_bits(const SSL *s, const SSL_CTX *ctx, int *levelp); 2607 2608 __owur int ssl_cert_lookup_by_nid(int nid, size_t *pidx, SSL_CTX *ctx); 2609 __owur const SSL_CERT_LOOKUP *ssl_cert_lookup_by_pkey(const EVP_PKEY *pk, 2610 size_t *pidx, 2611 SSL_CTX *ctx); 2612 __owur const SSL_CERT_LOOKUP *ssl_cert_lookup_by_idx(size_t idx, SSL_CTX *ctx); 2613 2614 int ssl_undefined_function(SSL *s); 2615 __owur int ssl_undefined_void_function(void); 2616 __owur int ssl_get_server_cert_serverinfo(SSL_CONNECTION *s, 2617 const unsigned char **serverinfo, 2618 size_t *serverinfo_length); 2619 void ssl_set_masks(SSL_CONNECTION *s); 2620 __owur STACK_OF(SSL_CIPHER) *ssl_get_ciphers_by_id(SSL_CONNECTION *sc); 2621 __owur int ssl_x509err2alert(int type); 2622 void ssl_sort_cipher_list(void); 2623 int ssl_load_ciphers(SSL_CTX *ctx); 2624 __owur int ssl_setup_sigalgs(SSL_CTX *ctx); 2625 int ssl_load_groups(SSL_CTX *ctx); 2626 int ssl_load_sigalgs(SSL_CTX *ctx); 2627 __owur int ssl_fill_hello_random(SSL_CONNECTION *s, int server, 2628 unsigned char *field, size_t len, 2629 DOWNGRADE dgrd); 2630 __owur int ssl_generate_master_secret(SSL_CONNECTION *s, unsigned char *pms, 2631 size_t pmslen, int free_pms); 2632 __owur EVP_PKEY *ssl_generate_pkey(SSL_CONNECTION *s, EVP_PKEY *pm); 2633 __owur int ssl_gensecret(SSL_CONNECTION *s, unsigned char *pms, size_t pmslen); 2634 __owur int ssl_derive(SSL_CONNECTION *s, EVP_PKEY *privkey, EVP_PKEY *pubkey, 2635 int genmaster); 2636 __owur int ssl_decapsulate(SSL_CONNECTION *s, EVP_PKEY *privkey, 2637 const unsigned char *ct, size_t ctlen, 2638 int gensecret); 2639 __owur int ssl_encapsulate(SSL_CONNECTION *s, EVP_PKEY *pubkey, 2640 unsigned char **ctp, size_t *ctlenp, 2641 int gensecret); 2642 __owur EVP_PKEY *ssl_dh_to_pkey(DH *dh); 2643 __owur int ssl_set_tmp_ecdh_groups(uint16_t **pext, size_t *pextlen, 2644 uint16_t **ksext, size_t *ksextlen, 2645 size_t **tplext, size_t *tplextlen, 2646 void *key); 2647 __owur unsigned int ssl_get_max_send_fragment(const SSL_CONNECTION *sc); 2648 __owur unsigned int ssl_get_split_send_fragment(const SSL_CONNECTION *sc); 2649 2650 __owur const SSL_CIPHER *ssl3_get_cipher_by_id(uint32_t id); 2651 __owur const SSL_CIPHER *ssl3_get_cipher_by_std_name(const char *stdname); 2652 __owur const SSL_CIPHER *ssl3_get_cipher_by_char(const unsigned char *p); 2653 __owur int ssl3_put_cipher_by_char(const SSL_CIPHER *c, WPACKET *pkt, 2654 size_t *len); 2655 int ssl3_init_finished_mac(SSL_CONNECTION *s); 2656 __owur int ssl3_setup_key_block(SSL_CONNECTION *s); 2657 __owur int ssl3_change_cipher_state(SSL_CONNECTION *s, int which); 2658 void ssl3_cleanup_key_block(SSL_CONNECTION *s); 2659 __owur int ssl3_do_write(SSL_CONNECTION *s, uint8_t type); 2660 int ssl3_send_alert(SSL_CONNECTION *s, int level, int desc); 2661 __owur int ssl3_generate_master_secret(SSL_CONNECTION *s, unsigned char *out, 2662 unsigned char *p, size_t len, 2663 size_t *secret_size); 2664 __owur int ssl3_get_req_cert_type(SSL_CONNECTION *s, WPACKET *pkt); 2665 __owur int ssl3_num_ciphers(void); 2666 __owur const SSL_CIPHER *ssl3_get_cipher(unsigned int u); 2667 int ssl3_renegotiate(SSL *ssl); 2668 int ssl3_renegotiate_check(SSL *ssl, int initok); 2669 void ssl3_digest_master_key_set_params(const SSL_SESSION *session, 2670 OSSL_PARAM params[]); 2671 __owur int ssl3_dispatch_alert(SSL *s); 2672 __owur size_t ssl3_final_finish_mac(SSL_CONNECTION *s, const char *sender, 2673 size_t slen, unsigned char *p); 2674 __owur int ssl3_finish_mac(SSL_CONNECTION *s, const unsigned char *buf, 2675 size_t len); 2676 void ssl3_free_digest_list(SSL_CONNECTION *s); 2677 __owur unsigned long ssl3_output_cert_chain(SSL_CONNECTION *s, WPACKET *pkt, 2678 CERT_PKEY *cpk, int for_comp); 2679 __owur const SSL_CIPHER *ssl3_choose_cipher(SSL_CONNECTION *s, 2680 STACK_OF(SSL_CIPHER) *clnt, 2681 STACK_OF(SSL_CIPHER) *srvr); 2682 __owur int ssl3_digest_cached_records(SSL_CONNECTION *s, int keep); 2683 __owur int ssl3_new(SSL *s); 2684 void ssl3_free(SSL *s); 2685 __owur int ssl3_read(SSL *s, void *buf, size_t len, size_t *readbytes); 2686 __owur int ssl3_peek(SSL *s, void *buf, size_t len, size_t *readbytes); 2687 __owur int ssl3_write(SSL *s, const void *buf, size_t len, size_t *written); 2688 __owur int ssl3_shutdown(SSL *s); 2689 int ssl3_clear(SSL *s); 2690 __owur long ssl3_ctrl(SSL *s, int cmd, long larg, void *parg); 2691 __owur long ssl3_ctx_ctrl(SSL_CTX *s, int cmd, long larg, void *parg); 2692 __owur long ssl3_callback_ctrl(SSL *s, int cmd, void (*fp) (void)); 2693 __owur long ssl3_ctx_callback_ctrl(SSL_CTX *s, int cmd, void (*fp) (void)); 2694 2695 __owur int ssl3_do_change_cipher_spec(SSL_CONNECTION *s); 2696 __owur OSSL_TIME ssl3_default_timeout(void); 2697 2698 __owur int ssl3_set_handshake_header(SSL_CONNECTION *s, WPACKET *pkt, 2699 int htype); 2700 __owur int tls_close_construct_packet(SSL_CONNECTION *s, WPACKET *pkt, int htype); 2701 __owur int tls_setup_handshake(SSL_CONNECTION *s); 2702 __owur int dtls1_set_handshake_header(SSL_CONNECTION *s, WPACKET *pkt, int htype); 2703 __owur int dtls1_close_construct_packet(SSL_CONNECTION *s, WPACKET *pkt, int htype); 2704 __owur int ssl3_handshake_write(SSL_CONNECTION *s); 2705 2706 __owur int ssl_allow_compression(SSL_CONNECTION *s); 2707 2708 __owur int ssl_version_cmp(const SSL_CONNECTION *s, int versiona, int versionb); 2709 __owur int ssl_version_supported(const SSL_CONNECTION *s, int version, 2710 const SSL_METHOD **meth); 2711 2712 __owur int ssl_set_client_hello_version(SSL_CONNECTION *s); 2713 __owur int ssl_check_version_downgrade(SSL_CONNECTION *s); 2714 __owur int ssl_set_version_bound(int method_version, int version, int *bound); 2715 __owur int ssl_choose_server_version(SSL_CONNECTION *s, CLIENTHELLO_MSG *hello, 2716 DOWNGRADE *dgrd); 2717 __owur int ssl_choose_client_version(SSL_CONNECTION *s, int version, 2718 RAW_EXTENSION *extensions); 2719 __owur int ssl_get_min_max_version(const SSL_CONNECTION *s, int *min_version, 2720 int *max_version, int *real_max); 2721 2722 __owur OSSL_TIME tls1_default_timeout(void); 2723 __owur int dtls1_do_write(SSL_CONNECTION *s, uint8_t type); 2724 void dtls1_set_message_header(SSL_CONNECTION *s, 2725 unsigned char mt, 2726 size_t len, 2727 size_t frag_off, size_t frag_len); 2728 2729 int dtls1_write_app_data_bytes(SSL *s, uint8_t type, const void *buf_, 2730 size_t len, size_t *written); 2731 2732 __owur int dtls1_read_failed(SSL_CONNECTION *s, int code); 2733 __owur int dtls1_buffer_message(SSL_CONNECTION *s, int ccs); 2734 __owur int dtls1_retransmit_message(SSL_CONNECTION *s, unsigned short seq, 2735 int *found); 2736 __owur int dtls1_get_queue_priority(unsigned short seq, int is_ccs); 2737 int dtls1_retransmit_buffered_messages(SSL_CONNECTION *s); 2738 void dtls1_clear_received_buffer(SSL_CONNECTION *s); 2739 void dtls1_clear_sent_buffer(SSL_CONNECTION *s); 2740 void dtls1_get_message_header(const unsigned char *data, 2741 struct hm_header_st *msg_hdr); 2742 __owur OSSL_TIME dtls1_default_timeout(void); 2743 __owur int dtls1_get_timeout(const SSL_CONNECTION *s, OSSL_TIME *timeleft); 2744 __owur int dtls1_check_timeout_num(SSL_CONNECTION *s); 2745 __owur int dtls1_handle_timeout(SSL_CONNECTION *s); 2746 void dtls1_start_timer(SSL_CONNECTION *s); 2747 void dtls1_stop_timer(SSL_CONNECTION *s); 2748 __owur int dtls1_is_timer_expired(SSL_CONNECTION *s); 2749 __owur int dtls_raw_hello_verify_request(WPACKET *pkt, unsigned char *cookie, 2750 size_t cookie_len); 2751 __owur size_t dtls1_min_mtu(SSL_CONNECTION *s); 2752 void dtls1_hm_fragment_free(hm_fragment *frag); 2753 __owur int dtls1_query_mtu(SSL_CONNECTION *s); 2754 2755 __owur int tls1_new(SSL *s); 2756 void tls1_free(SSL *s); 2757 int tls1_clear(SSL *s); 2758 2759 __owur int dtls1_new(SSL *s); 2760 void dtls1_free(SSL *s); 2761 int dtls1_clear(SSL *s); 2762 long dtls1_ctrl(SSL *s, int cmd, long larg, void *parg); 2763 __owur int dtls1_shutdown(SSL *s); 2764 2765 __owur int dtls1_dispatch_alert(SSL *s); 2766 2767 __owur int ssl_init_wbio_buffer(SSL_CONNECTION *s); 2768 int ssl_free_wbio_buffer(SSL_CONNECTION *s); 2769 2770 __owur int tls1_change_cipher_state(SSL_CONNECTION *s, int which); 2771 __owur int tls1_setup_key_block(SSL_CONNECTION *s); 2772 __owur size_t tls1_final_finish_mac(SSL_CONNECTION *s, const char *str, 2773 size_t slen, unsigned char *p); 2774 __owur int tls1_generate_master_secret(SSL_CONNECTION *s, unsigned char *out, 2775 unsigned char *p, size_t len, 2776 size_t *secret_size); 2777 __owur int tls13_setup_key_block(SSL_CONNECTION *s); 2778 __owur size_t tls13_final_finish_mac(SSL_CONNECTION *s, const char *str, size_t slen, 2779 unsigned char *p); 2780 __owur int tls13_store_handshake_traffic_hash(SSL_CONNECTION *s); 2781 __owur int tls13_store_server_finished_hash(SSL_CONNECTION *s); 2782 __owur int tls13_change_cipher_state(SSL_CONNECTION *s, int which); 2783 __owur int tls13_update_key(SSL_CONNECTION *s, int send); 2784 __owur int tls13_hkdf_expand(SSL_CONNECTION *s, 2785 const EVP_MD *md, 2786 const unsigned char *secret, 2787 const unsigned char *label, size_t labellen, 2788 const unsigned char *data, size_t datalen, 2789 unsigned char *out, size_t outlen, int fatal); 2790 __owur int tls13_hkdf_expand_ex(OSSL_LIB_CTX *libctx, const char *propq, 2791 const EVP_MD *md, 2792 const unsigned char *secret, 2793 const unsigned char *label, size_t labellen, 2794 const unsigned char *data, size_t datalen, 2795 unsigned char *out, size_t outlen, 2796 int raise_error); 2797 __owur int tls13_derive_key(SSL_CONNECTION *s, const EVP_MD *md, 2798 const unsigned char *secret, unsigned char *key, 2799 size_t keylen); 2800 __owur int tls13_derive_iv(SSL_CONNECTION *s, const EVP_MD *md, 2801 const unsigned char *secret, unsigned char *iv, 2802 size_t ivlen); 2803 __owur int tls13_derive_finishedkey(SSL_CONNECTION *s, const EVP_MD *md, 2804 const unsigned char *secret, 2805 unsigned char *fin, size_t finlen); 2806 int tls13_generate_secret(SSL_CONNECTION *s, const EVP_MD *md, 2807 const unsigned char *prevsecret, 2808 const unsigned char *insecret, 2809 size_t insecretlen, 2810 unsigned char *outsecret); 2811 __owur int tls13_generate_handshake_secret(SSL_CONNECTION *s, 2812 const unsigned char *insecret, 2813 size_t insecretlen); 2814 __owur int tls13_generate_master_secret(SSL_CONNECTION *s, unsigned char *out, 2815 unsigned char *prev, size_t prevlen, 2816 size_t *secret_size); 2817 __owur int tls1_export_keying_material(SSL_CONNECTION *s, 2818 unsigned char *out, size_t olen, 2819 const char *label, size_t llen, 2820 const unsigned char *p, size_t plen, 2821 int use_context); 2822 __owur int tls13_export_keying_material(SSL_CONNECTION *s, 2823 unsigned char *out, size_t olen, 2824 const char *label, size_t llen, 2825 const unsigned char *context, 2826 size_t contextlen, int use_context); 2827 __owur int tls13_export_keying_material_early(SSL_CONNECTION *s, 2828 unsigned char *out, size_t olen, 2829 const char *label, size_t llen, 2830 const unsigned char *context, 2831 size_t contextlen); 2832 __owur int tls1_alert_code(int code); 2833 __owur int tls13_alert_code(int code); 2834 __owur int ssl3_alert_code(int code); 2835 2836 __owur int ssl_check_srvr_ecc_cert_and_alg(X509 *x, SSL_CONNECTION *s); 2837 2838 SSL_COMP *ssl3_comp_find(STACK_OF(SSL_COMP) *sk, int n); 2839 2840 __owur const TLS_GROUP_INFO *tls1_group_id_lookup(SSL_CTX *ctx, uint16_t curve_id); 2841 __owur const char *tls1_group_id2name(SSL_CTX *ctx, uint16_t group_id); 2842 __owur int tls1_group_id2nid(uint16_t group_id, int include_unknown); 2843 __owur uint16_t tls1_nid2group_id(int nid); 2844 __owur int tls1_check_group_id(SSL_CONNECTION *s, uint16_t group_id, 2845 int check_own_curves); 2846 __owur int tls1_get0_implemented_groups(int min_proto_version, 2847 int max_proto_version, 2848 TLS_GROUP_INFO *grps, 2849 size_t num, long all, 2850 STACK_OF(OPENSSL_CSTRING) *out); 2851 __owur uint16_t tls1_shared_group(SSL_CONNECTION *s, int nmatch); 2852 __owur int tls1_set_groups(uint16_t **grpext, size_t *grpextlen, 2853 uint16_t **ksext, size_t *ksextlen, 2854 size_t **tplext, size_t *tplextlen, 2855 int *curves, size_t ncurves); 2856 __owur int tls1_set_groups_list(SSL_CTX *ctx, 2857 uint16_t **grpext, size_t *grpextlen, 2858 uint16_t **ksext, size_t *ksextlen, 2859 size_t **tplext, size_t *tplextlen, 2860 const char *str); 2861 __owur EVP_PKEY *ssl_generate_pkey_group(SSL_CONNECTION *s, uint16_t id); 2862 __owur int tls_valid_group(SSL_CONNECTION *s, uint16_t group_id, int minversion, 2863 int maxversion, int isec, int *okfortls13); 2864 __owur EVP_PKEY *ssl_generate_param_group(SSL_CONNECTION *s, uint16_t id); 2865 void tls1_get_formatlist(SSL_CONNECTION *s, const unsigned char **pformats, 2866 size_t *num_formats); 2867 __owur int tls1_check_ec_tmp_key(SSL_CONNECTION *s, unsigned long id); 2868 2869 __owur int tls_group_allowed(SSL_CONNECTION *s, uint16_t curve, int op); 2870 void tls1_get_supported_groups(SSL_CONNECTION *s, const uint16_t **pgroups, 2871 size_t *pgroupslen); 2872 void tls1_get_requested_keyshare_groups(SSL_CONNECTION *s, const uint16_t **pgroups, 2873 size_t *pgroupslen); 2874 void tls1_get_group_tuples(SSL_CONNECTION *s, const size_t **ptuples, 2875 size_t *ptupleslen); 2876 2877 __owur int tls1_set_server_sigalgs(SSL_CONNECTION *s); 2878 2879 __owur SSL_TICKET_STATUS tls_get_ticket_from_client(SSL_CONNECTION *s, 2880 CLIENTHELLO_MSG *hello, 2881 SSL_SESSION **ret); 2882 __owur SSL_TICKET_STATUS tls_decrypt_ticket(SSL_CONNECTION *s, 2883 const unsigned char *etick, 2884 size_t eticklen, 2885 const unsigned char *sess_id, 2886 size_t sesslen, SSL_SESSION **psess); 2887 2888 __owur int tls_use_ticket(SSL_CONNECTION *s); 2889 2890 void ssl_set_sig_mask(uint32_t *pmask_a, SSL_CONNECTION *s, int op); 2891 2892 __owur int tls1_set_sigalgs_list(SSL_CTX *ctx, CERT *c, const char *str, int client); 2893 __owur int tls1_set_raw_sigalgs(CERT *c, const uint16_t *psigs, size_t salglen, 2894 int client); 2895 __owur int tls1_set_sigalgs(CERT *c, const int *salg, size_t salglen, 2896 int client); 2897 int tls1_check_chain(SSL_CONNECTION *s, X509 *x, EVP_PKEY *pk, 2898 STACK_OF(X509) *chain, int idx); 2899 void tls1_set_cert_validity(SSL_CONNECTION *s); 2900 2901 # ifndef OPENSSL_NO_CT 2902 __owur int ssl_validate_ct(SSL_CONNECTION *s); 2903 # endif 2904 2905 __owur EVP_PKEY *ssl_get_auto_dh(SSL_CONNECTION *s); 2906 2907 __owur int ssl_security_cert(SSL_CONNECTION *s, SSL_CTX *ctx, X509 *x, int vfy, 2908 int is_ee); 2909 __owur int ssl_security_cert_chain(SSL_CONNECTION *s, STACK_OF(X509) *sk, 2910 X509 *ex, int vfy); 2911 2912 int tls_choose_sigalg(SSL_CONNECTION *s, int fatalerrs); 2913 2914 __owur long ssl_get_algorithm2(SSL_CONNECTION *s); 2915 __owur int tls12_copy_sigalgs(SSL_CONNECTION *s, WPACKET *pkt, 2916 const uint16_t *psig, size_t psiglen); 2917 __owur int tls1_save_u16(PACKET *pkt, uint16_t **pdest, size_t *pdestlen); 2918 __owur int tls1_save_sigalgs(SSL_CONNECTION *s, PACKET *pkt, int cert); 2919 __owur int tls1_process_sigalgs(SSL_CONNECTION *s); 2920 __owur int tls1_set_peer_legacy_sigalg(SSL_CONNECTION *s, const EVP_PKEY *pkey); 2921 __owur int tls1_lookup_md(SSL_CTX *ctx, const SIGALG_LOOKUP *lu, 2922 const EVP_MD **pmd); 2923 __owur size_t tls12_get_psigalgs(SSL_CONNECTION *s, int sent, 2924 const uint16_t **psigs); 2925 __owur int tls_check_sigalg_curve(const SSL_CONNECTION *s, int curve); 2926 __owur int tls12_check_peer_sigalg(SSL_CONNECTION *s, uint16_t, EVP_PKEY *pkey); 2927 __owur int ssl_set_client_disabled(SSL_CONNECTION *s); 2928 __owur int ssl_cipher_disabled(const SSL_CONNECTION *s, const SSL_CIPHER *c, 2929 int op, int echde); 2930 2931 __owur int ssl_handshake_hash(SSL_CONNECTION *s, 2932 unsigned char *out, size_t outlen, 2933 size_t *hashlen); 2934 __owur const EVP_MD *ssl_md(SSL_CTX *ctx, int idx); 2935 int ssl_get_md_idx(int md_nid); 2936 __owur const EVP_MD *ssl_handshake_md(SSL_CONNECTION *s); 2937 __owur const EVP_MD *ssl_prf_md(SSL_CONNECTION *s); 2938 2939 __owur int ossl_adjust_domain_flags(uint64_t domain_flags, 2940 uint64_t *p_domain_flags); 2941 2942 /* 2943 * ssl_log_rsa_client_key_exchange logs |premaster| to the SSL_CTX associated 2944 * with |ssl|, if logging is enabled. It returns one on success and zero on 2945 * failure. The entry is identified by the first 8 bytes of 2946 * |encrypted_premaster|. 2947 */ 2948 __owur int ssl_log_rsa_client_key_exchange(SSL_CONNECTION *s, 2949 const uint8_t *encrypted_premaster, 2950 size_t encrypted_premaster_len, 2951 const uint8_t *premaster, 2952 size_t premaster_len); 2953 2954 /* 2955 * ssl_log_secret logs |secret| to the SSL_CTX associated with |ssl|, if 2956 * logging is available. It returns one on success and zero on failure. It tags 2957 * the entry with |label|. 2958 */ 2959 __owur int ssl_log_secret(SSL_CONNECTION *s, const char *label, 2960 const uint8_t *secret, size_t secret_len); 2961 2962 #define MASTER_SECRET_LABEL "CLIENT_RANDOM" 2963 #define CLIENT_EARLY_LABEL "CLIENT_EARLY_TRAFFIC_SECRET" 2964 #define CLIENT_HANDSHAKE_LABEL "CLIENT_HANDSHAKE_TRAFFIC_SECRET" 2965 #define SERVER_HANDSHAKE_LABEL "SERVER_HANDSHAKE_TRAFFIC_SECRET" 2966 #define CLIENT_APPLICATION_LABEL "CLIENT_TRAFFIC_SECRET_0" 2967 #define CLIENT_APPLICATION_N_LABEL "CLIENT_TRAFFIC_SECRET_N" 2968 #define SERVER_APPLICATION_LABEL "SERVER_TRAFFIC_SECRET_0" 2969 #define SERVER_APPLICATION_N_LABEL "SERVER_TRAFFIC_SECRET_N" 2970 #define EARLY_EXPORTER_SECRET_LABEL "EARLY_EXPORTER_SECRET" 2971 #define EXPORTER_SECRET_LABEL "EXPORTER_SECRET" 2972 2973 __owur int srp_generate_server_master_secret(SSL_CONNECTION *s); 2974 __owur int srp_generate_client_master_secret(SSL_CONNECTION *s); 2975 __owur int srp_verify_server_param(SSL_CONNECTION *s); 2976 2977 /* statem/statem_srvr.c */ 2978 2979 __owur int send_certificate_request(SSL_CONNECTION *s); 2980 2981 /* statem/extensions_cust.c */ 2982 2983 custom_ext_method *custom_ext_find(const custom_ext_methods *exts, 2984 ENDPOINT role, unsigned int ext_type, 2985 size_t *idx); 2986 2987 void custom_ext_init(custom_ext_methods *meths); 2988 2989 int ossl_tls_add_custom_ext_intern(SSL_CTX *ctx, custom_ext_methods *exts, 2990 ENDPOINT role, unsigned int ext_type, 2991 unsigned int context, 2992 SSL_custom_ext_add_cb_ex add_cb, 2993 SSL_custom_ext_free_cb_ex free_cb, 2994 void *add_arg, 2995 SSL_custom_ext_parse_cb_ex parse_cb, 2996 void *parse_arg); 2997 __owur int custom_ext_parse(SSL_CONNECTION *s, unsigned int context, 2998 unsigned int ext_type, 2999 const unsigned char *ext_data, size_t ext_size, 3000 X509 *x, size_t chainidx); 3001 __owur int custom_ext_add(SSL_CONNECTION *s, int context, WPACKET *pkt, X509 *x, 3002 size_t chainidx, int maxversion); 3003 3004 __owur int custom_exts_copy(custom_ext_methods *dst, 3005 const custom_ext_methods *src); 3006 __owur int custom_exts_copy_conn(custom_ext_methods *dst, 3007 const custom_ext_methods *src); 3008 __owur int custom_exts_copy_flags(custom_ext_methods *dst, 3009 const custom_ext_methods *src); 3010 void custom_exts_free(custom_ext_methods *exts); 3011 3012 /* ssl_mcnf.c */ 3013 int ssl_ctx_system_config(SSL_CTX *ctx); 3014 3015 const EVP_CIPHER *ssl_evp_cipher_fetch(OSSL_LIB_CTX *libctx, 3016 int nid, 3017 const char *properties); 3018 int ssl_evp_cipher_up_ref(const EVP_CIPHER *cipher); 3019 void ssl_evp_cipher_free(const EVP_CIPHER *cipher); 3020 const EVP_MD *ssl_evp_md_fetch(OSSL_LIB_CTX *libctx, 3021 int nid, 3022 const char *properties); 3023 int ssl_evp_md_up_ref(const EVP_MD *md); 3024 void ssl_evp_md_free(const EVP_MD *md); 3025 3026 void tls_engine_finish(ENGINE *e); 3027 const EVP_CIPHER *tls_get_cipher_from_engine(int nid); 3028 const EVP_MD *tls_get_digest_from_engine(int nid); 3029 int tls_engine_load_ssl_client_cert(SSL_CONNECTION *s, X509 **px509, 3030 EVP_PKEY **ppkey); 3031 int ssl_hmac_old_new(SSL_HMAC *ret); 3032 void ssl_hmac_old_free(SSL_HMAC *ctx); 3033 int ssl_hmac_old_init(SSL_HMAC *ctx, void *key, size_t len, char *md); 3034 int ssl_hmac_old_update(SSL_HMAC *ctx, const unsigned char *data, size_t len); 3035 int ssl_hmac_old_final(SSL_HMAC *ctx, unsigned char *md, size_t *len); 3036 size_t ssl_hmac_old_size(const SSL_HMAC *ctx); 3037 3038 int ssl_ctx_srp_ctx_free_intern(SSL_CTX *ctx); 3039 int ssl_ctx_srp_ctx_init_intern(SSL_CTX *ctx); 3040 int ssl_srp_ctx_free_intern(SSL_CONNECTION *s); 3041 int ssl_srp_ctx_init_intern(SSL_CONNECTION *s); 3042 3043 int ssl_srp_calc_a_param_intern(SSL_CONNECTION *s); 3044 int ssl_srp_server_param_with_username_intern(SSL_CONNECTION *s, int *ad); 3045 3046 void ssl_session_calculate_timeout(SSL_SESSION *ss); 3047 3048 # else /* OPENSSL_UNIT_TEST */ 3049 3050 # define ssl_init_wbio_buffer SSL_test_functions()->p_ssl_init_wbio_buffer 3051 3052 # endif 3053 3054 /* Some helper routines to support TSAN operations safely */ 3055 static ossl_unused ossl_inline int ssl_tsan_lock(const SSL_CTX *ctx) 3056 { 3057 #ifdef TSAN_REQUIRES_LOCKING 3058 if (!CRYPTO_THREAD_write_lock(ctx->tsan_lock)) 3059 return 0; 3060 #endif 3061 return 1; 3062 } 3063 3064 static ossl_unused ossl_inline void ssl_tsan_unlock(const SSL_CTX *ctx) 3065 { 3066 #ifdef TSAN_REQUIRES_LOCKING 3067 CRYPTO_THREAD_unlock(ctx->tsan_lock); 3068 #endif 3069 } 3070 3071 static ossl_unused ossl_inline void ssl_tsan_counter(const SSL_CTX *ctx, 3072 TSAN_QUALIFIER int *stat) 3073 { 3074 if (ssl_tsan_lock(ctx)) { 3075 tsan_counter(stat); 3076 ssl_tsan_unlock(ctx); 3077 } 3078 } 3079 3080 int ossl_comp_has_alg(int a); 3081 size_t ossl_calculate_comp_expansion(int alg, size_t length); 3082 3083 void ossl_ssl_set_custom_record_layer(SSL_CONNECTION *s, 3084 const OSSL_RECORD_METHOD *meth, 3085 void *rlarg); 3086 3087 long ossl_ctrl_internal(SSL *s, int cmd, long larg, void *parg, int no_quic); 3088 3089 /* 3090 * Options which no longer have any effect, but which can be implemented 3091 * as no-ops for QUIC. 3092 */ 3093 #define OSSL_LEGACY_SSL_OPTIONS \ 3094 (SSL_OP_NETSCAPE_REUSE_CIPHER_CHANGE_BUG | \ 3095 SSL_OP_MICROSOFT_BIG_SSLV3_BUFFER | \ 3096 SSL_OP_SSLEAY_080_CLIENT_DH_BUG | \ 3097 SSL_OP_TLS_D5_BUG | \ 3098 SSL_OP_TLS_BLOCK_PADDING_BUG | \ 3099 SSL_OP_MSIE_SSLV2_RSA_PADDING | \ 3100 SSL_OP_SSLREF2_REUSE_CERT_TYPE_BUG | \ 3101 SSL_OP_MICROSOFT_SESS_ID_BUG | \ 3102 SSL_OP_NETSCAPE_CHALLENGE_BUG | \ 3103 SSL_OP_PKCS1_CHECK_1 | \ 3104 SSL_OP_PKCS1_CHECK_2 | \ 3105 SSL_OP_SINGLE_DH_USE | \ 3106 SSL_OP_SINGLE_ECDH_USE | \ 3107 SSL_OP_EPHEMERAL_RSA ) 3108 3109 /* This option is undefined in public headers with no-dtls1-method. */ 3110 #ifndef SSL_OP_CISCO_ANYCONNECT 3111 # define SSL_OP_CISCO_ANYCONNECT 0 3112 #endif 3113 /* 3114 * Options which are no-ops under QUIC or TLSv1.3 and which are therefore 3115 * allowed but ignored under QUIC. 3116 */ 3117 #define OSSL_TLS1_2_OPTIONS \ 3118 (SSL_OP_CRYPTOPRO_TLSEXT_BUG | \ 3119 SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS | \ 3120 SSL_OP_ALLOW_CLIENT_RENEGOTIATION | \ 3121 SSL_OP_ALLOW_UNSAFE_LEGACY_RENEGOTIATION | \ 3122 SSL_OP_NO_COMPRESSION | \ 3123 SSL_OP_NO_SSLv3 | \ 3124 SSL_OP_NO_TLSv1 | \ 3125 SSL_OP_NO_TLSv1_1 | \ 3126 SSL_OP_NO_TLSv1_2 | \ 3127 SSL_OP_NO_DTLSv1 | \ 3128 SSL_OP_NO_DTLSv1_2 | \ 3129 SSL_OP_NO_SESSION_RESUMPTION_ON_RENEGOTIATION | \ 3130 SSL_OP_CISCO_ANYCONNECT | \ 3131 SSL_OP_NO_RENEGOTIATION | \ 3132 SSL_OP_NO_EXTENDED_MASTER_SECRET | \ 3133 SSL_OP_NO_ENCRYPT_THEN_MAC | \ 3134 SSL_OP_COOKIE_EXCHANGE | \ 3135 SSL_OP_LEGACY_SERVER_CONNECT | \ 3136 SSL_OP_IGNORE_UNEXPECTED_EOF ) 3137 3138 /* Total mask of connection-level options permitted or ignored under QUIC. */ 3139 #define OSSL_QUIC_PERMITTED_OPTIONS_CONN \ 3140 (OSSL_LEGACY_SSL_OPTIONS | \ 3141 OSSL_TLS1_2_OPTIONS | \ 3142 SSL_OP_CIPHER_SERVER_PREFERENCE | \ 3143 SSL_OP_DISABLE_TLSEXT_CA_NAMES | \ 3144 SSL_OP_NO_TX_CERTIFICATE_COMPRESSION | \ 3145 SSL_OP_NO_RX_CERTIFICATE_COMPRESSION | \ 3146 SSL_OP_PRIORITIZE_CHACHA | \ 3147 SSL_OP_NO_QUERY_MTU | \ 3148 SSL_OP_NO_TICKET | \ 3149 SSL_OP_NO_ANTI_REPLAY ) 3150 3151 /* Total mask of stream-level options permitted or ignored under QUIC. */ 3152 #define OSSL_QUIC_PERMITTED_OPTIONS_STREAM \ 3153 (OSSL_LEGACY_SSL_OPTIONS | \ 3154 OSSL_TLS1_2_OPTIONS | \ 3155 SSL_OP_CLEANSE_PLAINTEXT ) 3156 3157 /* Total mask of options permitted on either connections or streams. */ 3158 #define OSSL_QUIC_PERMITTED_OPTIONS \ 3159 (OSSL_QUIC_PERMITTED_OPTIONS_CONN | \ 3160 OSSL_QUIC_PERMITTED_OPTIONS_STREAM) 3161 3162 /* Total mask of domain flags supported on a QUIC SSL_CTX. */ 3163 #define OSSL_QUIC_SUPPORTED_DOMAIN_FLAGS \ 3164 (SSL_DOMAIN_FLAG_SINGLE_THREAD | \ 3165 SSL_DOMAIN_FLAG_MULTI_THREAD | \ 3166 SSL_DOMAIN_FLAG_THREAD_ASSISTED | \ 3167 SSL_DOMAIN_FLAG_BLOCKING | \ 3168 SSL_DOMAIN_FLAG_LEGACY_BLOCKING) 3169 3170 #endif 3171