]> git.ipfire.org Git - thirdparty/openssl.git/blame - ssl/ssl_locl.h
The default conv_form is uncompressed
[thirdparty/openssl.git] / ssl / ssl_locl.h
CommitLineData
846e33c7 1/*
48e5119a 2 * Copyright 1995-2018 The OpenSSL Project Authors. All Rights Reserved.
aa8f3d76 3 * Copyright (c) 2002, Oracle and/or its affiliates. All rights reserved
c80149d9 4 * Copyright 2005 Nokia. All rights reserved.
5a4fbc69 5 *
846e33c7
RS
6 * Licensed under the OpenSSL license (the "License"). You may not use
7 * this file except in compliance with the License. You can obtain a copy
8 * in the file LICENSE in the source distribution or at
9 * https://www.openssl.org/source/license.html
5a4fbc69 10 */
846e33c7 11
d02b48c6 12#ifndef HEADER_SSL_LOCL_H
0f113f3e 13# define HEADER_SSL_LOCL_H
4cff10dc
P
14
15# include "e_os.h" /* struct timeval for DTLS */
0f113f3e
MC
16# include <stdlib.h>
17# include <time.h>
18# include <string.h>
19# include <errno.h>
d02b48c6 20
0f113f3e 21# include <openssl/buffer.h>
3c27208f 22# include <openssl/comp.h>
0f113f3e 23# include <openssl/bio.h>
3c27208f
RS
24# include <openssl/rsa.h>
25# include <openssl/dsa.h>
0f113f3e
MC
26# include <openssl/err.h>
27# include <openssl/ssl.h>
07bbc92c 28# include <openssl/async.h>
0f113f3e 29# include <openssl/symhacks.h>
3c27208f 30# include <openssl/ct.h>
a230b26e
EK
31# include "record/record.h"
32# include "statem/statem.h"
33# include "packet_locl.h"
34# include "internal/dane.h"
2f545ae4 35# include "internal/refcount.h"
52e1d7b1 36
0f113f3e
MC
37# ifdef OPENSSL_BUILD_SHLIBSSL
38# undef OPENSSL_EXTERN
39# define OPENSSL_EXTERN OPENSSL_EXPORT
40# endif
26da3e65 41
0f113f3e
MC
42# define c2l(c,l) (l = ((unsigned long)(*((c)++))) , \
43 l|=(((unsigned long)(*((c)++)))<< 8), \
44 l|=(((unsigned long)(*((c)++)))<<16), \
45 l|=(((unsigned long)(*((c)++)))<<24))
d02b48c6
RE
46
47/* NOTE - c is not incremented as per c2l */
0f113f3e
MC
48# define c2ln(c,l1,l2,n) { \
49 c+=n; \
50 l1=l2=0; \
51 switch (n) { \
52 case 8: l2 =((unsigned long)(*(--(c))))<<24; \
53 case 7: l2|=((unsigned long)(*(--(c))))<<16; \
54 case 6: l2|=((unsigned long)(*(--(c))))<< 8; \
55 case 5: l2|=((unsigned long)(*(--(c)))); \
56 case 4: l1 =((unsigned long)(*(--(c))))<<24; \
57 case 3: l1|=((unsigned long)(*(--(c))))<<16; \
58 case 2: l1|=((unsigned long)(*(--(c))))<< 8; \
59 case 1: l1|=((unsigned long)(*(--(c)))); \
60 } \
61 }
62
63# define l2c(l,c) (*((c)++)=(unsigned char)(((l) )&0xff), \
64 *((c)++)=(unsigned char)(((l)>> 8)&0xff), \
65 *((c)++)=(unsigned char)(((l)>>16)&0xff), \
66 *((c)++)=(unsigned char)(((l)>>24)&0xff))
67
68# define n2l(c,l) (l =((unsigned long)(*((c)++)))<<24, \
69 l|=((unsigned long)(*((c)++)))<<16, \
70 l|=((unsigned long)(*((c)++)))<< 8, \
71 l|=((unsigned long)(*((c)++))))
72
31c34a3e
DW
73# define n2l8(c,l) (l =((uint64_t)(*((c)++)))<<56, \
74 l|=((uint64_t)(*((c)++)))<<48, \
75 l|=((uint64_t)(*((c)++)))<<40, \
76 l|=((uint64_t)(*((c)++)))<<32, \
77 l|=((uint64_t)(*((c)++)))<<24, \
78 l|=((uint64_t)(*((c)++)))<<16, \
79 l|=((uint64_t)(*((c)++)))<< 8, \
80 l|=((uint64_t)(*((c)++))))
81
82
0f113f3e
MC
83# define l2n(l,c) (*((c)++)=(unsigned char)(((l)>>24)&0xff), \
84 *((c)++)=(unsigned char)(((l)>>16)&0xff), \
85 *((c)++)=(unsigned char)(((l)>> 8)&0xff), \
86 *((c)++)=(unsigned char)(((l) )&0xff))
87
88# define l2n6(l,c) (*((c)++)=(unsigned char)(((l)>>40)&0xff), \
89 *((c)++)=(unsigned char)(((l)>>32)&0xff), \
90 *((c)++)=(unsigned char)(((l)>>24)&0xff), \
91 *((c)++)=(unsigned char)(((l)>>16)&0xff), \
92 *((c)++)=(unsigned char)(((l)>> 8)&0xff), \
93 *((c)++)=(unsigned char)(((l) )&0xff))
94
95# define l2n8(l,c) (*((c)++)=(unsigned char)(((l)>>56)&0xff), \
96 *((c)++)=(unsigned char)(((l)>>48)&0xff), \
97 *((c)++)=(unsigned char)(((l)>>40)&0xff), \
98 *((c)++)=(unsigned char)(((l)>>32)&0xff), \
99 *((c)++)=(unsigned char)(((l)>>24)&0xff), \
100 *((c)++)=(unsigned char)(((l)>>16)&0xff), \
101 *((c)++)=(unsigned char)(((l)>> 8)&0xff), \
102 *((c)++)=(unsigned char)(((l) )&0xff))
103
d02b48c6 104/* NOTE - c is not incremented as per l2c */
0f113f3e
MC
105# define l2cn(l1,l2,c,n) { \
106 c+=n; \
107 switch (n) { \
108 case 8: *(--(c))=(unsigned char)(((l2)>>24)&0xff); \
109 case 7: *(--(c))=(unsigned char)(((l2)>>16)&0xff); \
110 case 6: *(--(c))=(unsigned char)(((l2)>> 8)&0xff); \
111 case 5: *(--(c))=(unsigned char)(((l2) )&0xff); \
112 case 4: *(--(c))=(unsigned char)(((l1)>>24)&0xff); \
113 case 3: *(--(c))=(unsigned char)(((l1)>>16)&0xff); \
114 case 2: *(--(c))=(unsigned char)(((l1)>> 8)&0xff); \
115 case 1: *(--(c))=(unsigned char)(((l1) )&0xff); \
116 } \
117 }
118
d4450e4b
MC
119# define n2s(c,s) ((s=(((unsigned int)((c)[0]))<< 8)| \
120 (((unsigned int)((c)[1])) )),(c)+=2)
121# define s2n(s,c) (((c)[0]=(unsigned char)(((s)>> 8)&0xff), \
122 (c)[1]=(unsigned char)(((s) )&0xff)),(c)+=2)
123
124# define n2l3(c,l) ((l =(((unsigned long)((c)[0]))<<16)| \
125 (((unsigned long)((c)[1]))<< 8)| \
126 (((unsigned long)((c)[2])) )),(c)+=3)
127
128# define l2n3(l,c) (((c)[0]=(unsigned char)(((l)>>16)&0xff), \
129 (c)[1]=(unsigned char)(((l)>> 8)&0xff), \
130 (c)[2]=(unsigned char)(((l) )&0xff)),(c)+=3)
d02b48c6 131
a230b26e
EK
132/*
133 * DTLS version numbers are strange because they're inverted. Except for
134 * DTLS1_BAD_VER, which should be considered "lower" than the rest.
135 */
136# define dtls_ver_ordinal(v1) (((v1) == DTLS1_BAD_VER) ? 0xff00 : (v1))
137# define DTLS_VERSION_GT(v1, v2) (dtls_ver_ordinal(v1) < dtls_ver_ordinal(v2))
138# define DTLS_VERSION_GE(v1, v2) (dtls_ver_ordinal(v1) <= dtls_ver_ordinal(v2))
139# define DTLS_VERSION_LT(v1, v2) (dtls_ver_ordinal(v1) > dtls_ver_ordinal(v2))
140# define DTLS_VERSION_LE(v1, v2) (dtls_ver_ordinal(v1) >= dtls_ver_ordinal(v2))
7946ab33 141
d02b48c6 142
018e57c7
DSH
143/*
144 * Define the Bitmasks for SSL_CIPHER.algorithms.
145 * This bits are used packed as dense as possible. If new methods/ciphers
146 * etc will be added, the bits a likely to change, so this information
147 * is for internal library use only, even though SSL_CIPHER.algorithms
148 * can be publicly accessed.
149 * Use the according functions for cipher management instead.
150 *
657e60fa 151 * The bit mask handling in the selection and sorting scheme in
018e57c7 152 * ssl_create_cipher_list() has only limited capabilities, reflecting
657e60fa 153 * that the different entities within are mutually exclusive:
018e57c7
DSH
154 * ONLY ONE BIT PER MASK CAN BE SET AT A TIME.
155 */
52b8dad8
BM
156
157/* Bits for algorithm_mkey (key exchange algorithm) */
68d39f3c 158/* RSA key exchange */
36e79832 159# define SSL_kRSA 0x00000001U
68d39f3c 160/* tmp DH key no DH cert */
bc71f910 161# define SSL_kDHE 0x00000002U
68d39f3c 162/* synonym */
0f113f3e 163# define SSL_kEDH SSL_kDHE
68d39f3c 164/* ephemeral ECDH */
ce0c1f2b 165# define SSL_kECDHE 0x00000004U
68d39f3c 166/* synonym */
0f113f3e 167# define SSL_kEECDH SSL_kECDHE
68d39f3c 168/* PSK */
ce0c1f2b 169# define SSL_kPSK 0x00000008U
68d39f3c 170/* GOST key exchange */
ce0c1f2b 171# define SSL_kGOST 0x00000010U
68d39f3c 172/* SRP */
ce0c1f2b 173# define SSL_kSRP 0x00000020U
52b8dad8 174
ce0c1f2b
DSH
175# define SSL_kRSAPSK 0x00000040U
176# define SSL_kECDHEPSK 0x00000080U
177# define SSL_kDHEPSK 0x00000100U
64651d39
DSH
178
179/* all PSK */
180
a230b26e 181# define SSL_PSK (SSL_kPSK | SSL_kRSAPSK | SSL_kECDHEPSK | SSL_kDHEPSK)
64651d39 182
e5c4bf93
DSH
183/* Any appropriate key exchange algorithm (for TLS 1.3 ciphersuites) */
184# define SSL_kANY 0x00000000U
185
52b8dad8 186/* Bits for algorithm_auth (server authentication) */
68d39f3c 187/* RSA auth */
36e79832 188# define SSL_aRSA 0x00000001U
68d39f3c 189/* DSS auth */
36e79832 190# define SSL_aDSS 0x00000002U
68d39f3c 191/* no auth (i.e. use ADH or AECDH) */
36e79832 192# define SSL_aNULL 0x00000004U
68d39f3c 193/* ECDSA auth*/
ce0c1f2b 194# define SSL_aECDSA 0x00000008U
68d39f3c 195/* PSK auth */
ce0c1f2b 196# define SSL_aPSK 0x00000010U
68d39f3c 197/* GOST R 34.10-2001 signature auth */
ce0c1f2b 198# define SSL_aGOST01 0x00000020U
68d39f3c 199/* SRP auth */
ce0c1f2b 200# define SSL_aSRP 0x00000040U
e44380a9 201/* GOST R 34.10-2012 signature auth */
ce0c1f2b 202# define SSL_aGOST12 0x00000080U
e5c4bf93
DSH
203/* Any appropriate signature auth (for TLS 1.3 ciphersuites) */
204# define SSL_aANY 0x00000000U
e4fb8b47
DSH
205/* All bits requiring a certificate */
206#define SSL_aCERT \
207 (SSL_aRSA | SSL_aDSS | SSL_aECDSA | SSL_aGOST01 | SSL_aGOST12)
52b8dad8
BM
208
209/* Bits for algorithm_enc (symmetric encryption) */
36e79832
DSH
210# define SSL_DES 0x00000001U
211# define SSL_3DES 0x00000002U
212# define SSL_RC4 0x00000004U
213# define SSL_RC2 0x00000008U
214# define SSL_IDEA 0x00000010U
215# define SSL_eNULL 0x00000020U
216# define SSL_AES128 0x00000040U
217# define SSL_AES256 0x00000080U
218# define SSL_CAMELLIA128 0x00000100U
219# define SSL_CAMELLIA256 0x00000200U
220# define SSL_eGOST2814789CNT 0x00000400U
221# define SSL_SEED 0x00000800U
222# define SSL_AES128GCM 0x00001000U
223# define SSL_AES256GCM 0x00002000U
224# define SSL_AES128CCM 0x00004000U
225# define SSL_AES256CCM 0x00008000U
226# define SSL_AES128CCM8 0x00010000U
227# define SSL_AES256CCM8 0x00020000U
e44380a9 228# define SSL_eGOST2814789CNT12 0x00040000U
a76ba82c 229# define SSL_CHACHA20POLY1305 0x00080000U
bc326738
JS
230# define SSL_ARIA128GCM 0x00100000U
231# define SSL_ARIA256GCM 0x00200000U
0f113f3e 232
a556f342
EK
233# define SSL_AESGCM (SSL_AES128GCM | SSL_AES256GCM)
234# define SSL_AESCCM (SSL_AES128CCM | SSL_AES256CCM | SSL_AES128CCM8 | SSL_AES256CCM8)
235# define SSL_AES (SSL_AES128|SSL_AES256|SSL_AESGCM|SSL_AESCCM)
0f113f3e 236# define SSL_CAMELLIA (SSL_CAMELLIA128|SSL_CAMELLIA256)
1c37fd96 237# define SSL_CHACHA20 (SSL_CHACHA20POLY1305)
bc326738
JS
238# define SSL_ARIAGCM (SSL_ARIA128GCM | SSL_ARIA256GCM)
239# define SSL_ARIA (SSL_ARIAGCM)
52b8dad8
BM
240
241/* Bits for algorithm_mac (symmetric authentication) */
28dd49fa 242
36e79832
DSH
243# define SSL_MD5 0x00000001U
244# define SSL_SHA1 0x00000002U
245# define SSL_GOST94 0x00000004U
246# define SSL_GOST89MAC 0x00000008U
247# define SSL_SHA256 0x00000010U
248# define SSL_SHA384 0x00000020U
28dd49fa 249/* Not a real MAC, just an indication it is part of cipher */
36e79832 250# define SSL_AEAD 0x00000040U
e44380a9
DB
251# define SSL_GOST12_256 0x00000080U
252# define SSL_GOST89MAC12 0x00000100U
253# define SSL_GOST12_512 0x00000200U
52b8dad8 254
0f113f3e 255/*
e44380a9 256 * When adding new digest in the ssl_ciph.c and increment SSL_MD_NUM_IDX make
0f113f3e
MC
257 * sure to update this constant too
258 */
28ba2541
DSH
259
260# define SSL_MD_MD5_IDX 0
261# define SSL_MD_SHA1_IDX 1
262# define SSL_MD_GOST94_IDX 2
263# define SSL_MD_GOST89MAC_IDX 3
264# define SSL_MD_SHA256_IDX 4
265# define SSL_MD_SHA384_IDX 5
266# define SSL_MD_GOST12_256_IDX 6
267# define SSL_MD_GOST89MAC12_IDX 7
268# define SSL_MD_GOST12_512_IDX 8
269# define SSL_MD_MD5_SHA1_IDX 9
7afd2312
DSH
270# define SSL_MD_SHA224_IDX 10
271# define SSL_MD_SHA512_IDX 11
272# define SSL_MAX_DIGEST 12
28ba2541
DSH
273
274/* Bits for algorithm2 (handshake digests and other extra flags) */
275
276/* Bits 0-7 are handshake MAC */
277# define SSL_HANDSHAKE_MAC_MASK 0xFF
278# define SSL_HANDSHAKE_MAC_MD5_SHA1 SSL_MD_MD5_SHA1_IDX
279# define SSL_HANDSHAKE_MAC_SHA256 SSL_MD_SHA256_IDX
280# define SSL_HANDSHAKE_MAC_SHA384 SSL_MD_SHA384_IDX
281# define SSL_HANDSHAKE_MAC_GOST94 SSL_MD_GOST94_IDX
282# define SSL_HANDSHAKE_MAC_GOST12_256 SSL_MD_GOST12_256_IDX
283# define SSL_HANDSHAKE_MAC_GOST12_512 SSL_MD_GOST12_512_IDX
284# define SSL_HANDSHAKE_MAC_DEFAULT SSL_HANDSHAKE_MAC_MD5_SHA1
285
286/* Bits 8-15 bits are PRF */
287# define TLS1_PRF_DGST_SHIFT 8
288# define TLS1_PRF_SHA1_MD5 (SSL_MD_MD5_SHA1_IDX << TLS1_PRF_DGST_SHIFT)
289# define TLS1_PRF_SHA256 (SSL_MD_SHA256_IDX << TLS1_PRF_DGST_SHIFT)
290# define TLS1_PRF_SHA384 (SSL_MD_SHA384_IDX << TLS1_PRF_DGST_SHIFT)
291# define TLS1_PRF_GOST94 (SSL_MD_GOST94_IDX << TLS1_PRF_DGST_SHIFT)
292# define TLS1_PRF_GOST12_256 (SSL_MD_GOST12_256_IDX << TLS1_PRF_DGST_SHIFT)
293# define TLS1_PRF_GOST12_512 (SSL_MD_GOST12_512_IDX << TLS1_PRF_DGST_SHIFT)
294# define TLS1_PRF (SSL_MD_MD5_SHA1_IDX << TLS1_PRF_DGST_SHIFT)
761772d7 295
0f113f3e
MC
296/*
297 * Stream MAC for GOST ciphersuites from cryptopro draft (currently this also
298 * goes into algorithm2)
299 */
28ba2541 300# define TLS1_STREAM_MAC 0x10000
761772d7 301
88a9614b 302# define SSL_STRONG_MASK 0x0000001FU
361a1191 303# define SSL_DEFAULT_MASK 0X00000020U
c84f7f4a 304
361a1191
KR
305# define SSL_STRONG_NONE 0x00000001U
306# define SSL_LOW 0x00000002U
307# define SSL_MEDIUM 0x00000004U
308# define SSL_HIGH 0x00000008U
309# define SSL_FIPS 0x00000010U
310# define SSL_NOT_DEFAULT 0x00000020U
018e57c7 311
361a1191 312/* we have used 0000003f - 26 bits left to go */
d02b48c6 313
34f7245b
MC
314/* Flag used on OpenSSL ciphersuite ids to indicate they are for SSLv3+ */
315# define SSL3_CK_CIPHERSUITE_FLAG 0x03000000
316
890f2f8b 317/* Check if an SSL structure is using DTLS */
0f113f3e 318# define SSL_IS_DTLS(s) (s->method->ssl3_enc->enc_flags & SSL_ENC_FLAG_DTLS)
f2342b7a
MC
319
320/* Check if we are using TLSv1.3 */
c805f618
MC
321# define SSL_IS_TLS13(s) (!SSL_IS_DTLS(s) \
322 && (s)->method->version >= TLS1_3_VERSION \
323 && (s)->method->version != TLS_ANY_VERSION)
f2342b7a 324
49e7fe12 325# define SSL_TREAT_AS_TLS13(s) \
7b0a3ce0
MC
326 (SSL_IS_TLS13(s) || (s)->early_data_state == SSL_EARLY_DATA_CONNECTING \
327 || (s)->early_data_state == SSL_EARLY_DATA_CONNECT_RETRY \
328 || (s)->early_data_state == SSL_EARLY_DATA_WRITING \
758e05c5
MC
329 || (s)->early_data_state == SSL_EARLY_DATA_WRITE_RETRY \
330 || (s)->hello_retry_request == SSL_HRR_PENDING)
49e7fe12 331
fdd92367
MC
332# define SSL_IS_FIRST_HANDSHAKE(S) ((s)->s3->tmp.finish_md_len == 0 \
333 || (s)->s3->tmp.peer_finish_md_len == 0)
c7f47786 334
cbd64894 335/* See if we need explicit IV */
0f113f3e
MC
336# define SSL_USE_EXPLICIT_IV(s) \
337 (s->method->ssl3_enc->enc_flags & SSL_ENC_FLAG_EXPLICIT_IV)
338/*
339 * See if we use signature algorithms extension and signature algorithm
340 * before signatures.
cbd64894 341 */
0f113f3e
MC
342# define SSL_USE_SIGALGS(s) \
343 (s->method->ssl3_enc->enc_flags & SSL_ENC_FLAG_SIGALGS)
344/*
345 * Allow TLS 1.2 ciphersuites: applies to DTLS 1.2 as well as TLS 1.2: may
346 * apply to others in future.
4221c0dd 347 */
0f113f3e
MC
348# define SSL_USE_TLS1_2_CIPHERS(s) \
349 (s->method->ssl3_enc->enc_flags & SSL_ENC_FLAG_TLS1_2_CIPHERS)
350/*
351 * Determine if a client can use TLS 1.2 ciphersuites: can't rely on method
1e2d4cb0
DSH
352 * flags because it may not be set to correct version yet.
353 */
0f113f3e 354# define SSL_CLIENT_USE_TLS1_2_CIPHERS(s) \
4fa52141
VD
355 ((!SSL_IS_DTLS(s) && s->client_version >= TLS1_2_VERSION) || \
356 (SSL_IS_DTLS(s) && DTLS_VERSION_GE(s->client_version, DTLS1_2_VERSION)))
f7aa3185
DB
357/*
358 * Determine if a client should send signature algorithms extension:
359 * as with TLS1.2 cipher we can't rely on method flags.
360 */
361# define SSL_CLIENT_USE_SIGALGS(s) \
362 SSL_CLIENT_USE_TLS1_2_CIPHERS(s)
0f113f3e 363
cf72c757
F
364# define IS_MAX_FRAGMENT_LENGTH_EXT_VALID(value) \
365 (((value) >= TLSEXT_max_fragment_length_512) && \
366 ((value) <= TLSEXT_max_fragment_length_4096))
367# define USE_MAX_FRAGMENT_LENGTH_EXT(session) \
368 IS_MAX_FRAGMENT_LENGTH_EXT_VALID(session->ext.max_fragment_len_mode)
369# define GET_MAX_FRAGMENT_LENGTH(session) \
370 (512U << (session->ext.max_fragment_len_mode - 1))
371
28a31a0a
MC
372# define SSL_READ_ETM(s) (s->s3->flags & TLS1_FLAGS_ENCRYPT_THEN_MAC_READ)
373# define SSL_WRITE_ETM(s) (s->s3->flags & TLS1_FLAGS_ENCRYPT_THEN_MAC_WRITE)
5e3ff62c 374
d02b48c6 375/* Mostly for SSLv3 */
d0ff28f8 376# define SSL_PKEY_RSA 0
045d078a
DSH
377# define SSL_PKEY_RSA_PSS_SIGN 1
378# define SSL_PKEY_DSA_SIGN 2
379# define SSL_PKEY_ECC 3
380# define SSL_PKEY_GOST01 4
381# define SSL_PKEY_GOST12_256 5
382# define SSL_PKEY_GOST12_512 6
383# define SSL_PKEY_ED25519 7
0e1d6ecf
MC
384# define SSL_PKEY_ED448 8
385# define SSL_PKEY_NUM 9
e44380a9
DB
386/*
387 * Pseudo-constant. GOST cipher suites can use different certs for 1
388 * SSL_CIPHER. So let's see which one we have in fact.
389 */
390# define SSL_PKEY_GOST_EC SSL_PKEY_NUM+1
d02b48c6 391
1d97c843 392/*-
361a1191 393 * SSL_kRSA <- RSA_ENC
d02b48c6 394 * SSL_kDH <- DH_ENC & (RSA_ENC | RSA_SIGN | DSA_SIGN)
5a21cadb 395 * SSL_kDHE <- RSA_ENC | RSA_SIGN | DSA_SIGN
d02b48c6
RE
396 * SSL_aRSA <- RSA_ENC | RSA_SIGN
397 * SSL_aDSS <- DSA_SIGN
398 */
399
23a22b4c 400/*-
0f113f3e
MC
401#define CERT_INVALID 0
402#define CERT_PUBLIC_KEY 1
403#define CERT_PRIVATE_KEY 2
d02b48c6
RE
404*/
405
9d75dce3
TS
406/* Post-Handshake Authentication state */
407typedef enum {
408 SSL_PHA_NONE = 0,
409 SSL_PHA_EXT_SENT, /* client-side only: extension sent */
410 SSL_PHA_EXT_RECEIVED, /* server-side only: extension received */
411 SSL_PHA_REQUEST_PENDING, /* server-side only: request pending */
412 SSL_PHA_REQUESTED /* request received by client, or sent by server */
413} SSL_PHA_STATE;
414
e9fa092e 415/* CipherSuite length. SSLv3 and all TLS versions. */
a230b26e 416# define TLS_CIPHER_LEN 2
b6ba4014
MC
417/* used to hold info on the particular ciphers used */
418struct ssl_cipher_st {
90d9e49a 419 uint32_t valid;
a230b26e 420 const char *name; /* text name */
bbb4ceb8 421 const char *stdname; /* RFC name */
a230b26e 422 uint32_t id; /* id, 4 bytes, first is version */
b6ba4014 423 /*
90d9e49a 424 * changed in 1.0.0: these four used to be portions of a single value
b6ba4014
MC
425 * 'algorithms'
426 */
a230b26e
EK
427 uint32_t algorithm_mkey; /* key exchange algorithm */
428 uint32_t algorithm_auth; /* server authentication */
429 uint32_t algorithm_enc; /* symmetric encryption */
430 uint32_t algorithm_mac; /* symmetric authentication */
431 int min_tls; /* minimum SSL/TLS protocol version */
432 int max_tls; /* maximum SSL/TLS protocol version */
433 int min_dtls; /* minimum DTLS protocol version */
434 int max_dtls; /* maximum DTLS protocol version */
435 uint32_t algo_strength; /* strength and export flags */
436 uint32_t algorithm2; /* Extra flags */
437 int32_t strength_bits; /* Number of bits really used */
438 uint32_t alg_bits; /* Number of bits for algorithm */
b6ba4014
MC
439};
440
87d9cafa 441/* Used to hold SSL/TLS functions */
b6ba4014
MC
442struct ssl_method_st {
443 int version;
4fa52141
VD
444 unsigned flags;
445 unsigned long mask;
b6ba4014 446 int (*ssl_new) (SSL *s);
b77f3ed1 447 int (*ssl_clear) (SSL *s);
b6ba4014
MC
448 void (*ssl_free) (SSL *s);
449 int (*ssl_accept) (SSL *s);
450 int (*ssl_connect) (SSL *s);
54105ddd
MC
451 int (*ssl_read) (SSL *s, void *buf, size_t len, size_t *readbytes);
452 int (*ssl_peek) (SSL *s, void *buf, size_t len, size_t *readbytes);
7ee8627f 453 int (*ssl_write) (SSL *s, const void *buf, size_t len, size_t *written);
b6ba4014
MC
454 int (*ssl_shutdown) (SSL *s);
455 int (*ssl_renegotiate) (SSL *s);
c7f47786 456 int (*ssl_renegotiate_check) (SSL *s, int);
657da85e 457 int (*ssl_read_bytes) (SSL *s, int type, int *recvd_type,
eda75751 458 unsigned char *buf, size_t len, int peek,
54105ddd 459 size_t *readbytes);
7ee8627f
MC
460 int (*ssl_write_bytes) (SSL *s, int type, const void *buf_, size_t len,
461 size_t *written);
b6ba4014
MC
462 int (*ssl_dispatch_alert) (SSL *s);
463 long (*ssl_ctrl) (SSL *s, int cmd, long larg, void *parg);
464 long (*ssl_ctx_ctrl) (SSL_CTX *ctx, int cmd, long larg, void *parg);
465 const SSL_CIPHER *(*get_cipher_by_char) (const unsigned char *ptr);
ae2f7b37 466 int (*put_cipher_by_char) (const SSL_CIPHER *cipher, WPACKET *pkt,
2c7b4dbc 467 size_t *len);
8b0e934a 468 size_t (*ssl_pending) (const SSL *s);
b6ba4014
MC
469 int (*num_ciphers) (void);
470 const SSL_CIPHER *(*get_cipher) (unsigned ncipher);
b6ba4014
MC
471 long (*get_timeout) (void);
472 const struct ssl3_enc_method *ssl3_enc; /* Extra SSLv3/TLS stuff */
473 int (*ssl_version) (void);
474 long (*ssl_callback_ctrl) (SSL *s, int cb_id, void (*fp) (void));
475 long (*ssl_ctx_callback_ctrl) (SSL_CTX *s, int cb_id, void (*fp) (void));
476};
477
478/*-
479 * Lets make this into an ASN.1 type structure as follows
480 * SSL_SESSION_ID ::= SEQUENCE {
481 * version INTEGER, -- structure version number
482 * SSLversion INTEGER, -- SSL version number
483 * Cipher OCTET STRING, -- the 3 byte cipher ID
484 * Session_ID OCTET STRING, -- the Session ID
485 * Master_key OCTET STRING, -- the master key
b6ba4014
MC
486 * Key_Arg [ 0 ] IMPLICIT OCTET STRING, -- the optional Key argument
487 * Time [ 1 ] EXPLICIT INTEGER, -- optional Start Time
488 * Timeout [ 2 ] EXPLICIT INTEGER, -- optional Timeout ins seconds
489 * Peer [ 3 ] EXPLICIT X509, -- optional Peer Certificate
490 * Session_ID_context [ 4 ] EXPLICIT OCTET STRING, -- the Session ID context
491 * Verify_result [ 5 ] EXPLICIT INTEGER, -- X509_V_... code for `Peer'
492 * HostName [ 6 ] EXPLICIT OCTET STRING, -- optional HostName from servername TLS extension
493 * PSK_identity_hint [ 7 ] EXPLICIT OCTET STRING, -- optional PSK identity hint
494 * PSK_identity [ 8 ] EXPLICIT OCTET STRING, -- optional PSK identity
495 * Ticket_lifetime_hint [9] EXPLICIT INTEGER, -- server's lifetime hint for session ticket
496 * Ticket [10] EXPLICIT OCTET STRING, -- session ticket (clients only)
497 * Compression_meth [11] EXPLICIT OCTET STRING, -- optional compression method
498 * SRP_username [ 12 ] EXPLICIT OCTET STRING -- optional SRP username
6f152a15 499 * flags [ 13 ] EXPLICIT INTEGER -- optional flags
b6ba4014
MC
500 * }
501 * Look in ssl/ssl_asn1.c for more details
502 * I'm using EXPLICIT tags so I can read the damn things using asn1parse :-).
503 */
504struct ssl_session_st {
a230b26e
EK
505 int ssl_version; /* what ssl version session info is being kept
506 * in here? */
8c1a5343 507 size_t master_key_length;
ec15acb6 508
9368f865
MC
509 /* TLSv1.3 early_secret used for external PSKs */
510 unsigned char early_secret[EVP_MAX_MD_SIZE];
ec15acb6
MC
511 /*
512 * For <=TLS1.2 this is the master_key. For TLS1.3 this is the resumption
513 * master secret
514 */
1a3392c8 515 unsigned char master_key[TLS13_MAX_RESUMPTION_MASTER_LENGTH];
b6ba4014 516 /* session_id - valid? */
ec60ccc1 517 size_t session_id_length;
b6ba4014
MC
518 unsigned char session_id[SSL_MAX_SSL_SESSION_ID_LENGTH];
519 /*
520 * this is used to determine whether the session is being reused in the
521 * appropriate context. It is up to the application to set this, via
522 * SSL_new
523 */
ec60ccc1 524 size_t sid_ctx_length;
b6ba4014 525 unsigned char sid_ctx[SSL_MAX_SID_CTX_LENGTH];
b6ba4014
MC
526# ifndef OPENSSL_NO_PSK
527 char *psk_identity_hint;
528 char *psk_identity;
529# endif
530 /*
531 * Used to indicate that session resumption is not allowed. Applications
532 * can also set this bit for a new session via not_resumable_session_cb
533 * to disable session caching and tickets.
534 */
535 int not_resumable;
a273c6ee 536 /* This is the cert and type for the other end. */
b6ba4014 537 X509 *peer;
a273c6ee 538 int peer_type;
fa7c2637 539 /* Certificate chain peer sent. */
c34b0f99 540 STACK_OF(X509) *peer_chain;
b6ba4014
MC
541 /*
542 * when app_verify_callback accepts a session where the peer's
543 * certificate is not ok, we must remember the error for session reuse:
544 */
545 long verify_result; /* only for servers */
2f545ae4 546 CRYPTO_REF_COUNT references;
b6ba4014
MC
547 long timeout;
548 long time;
549 unsigned int compress_meth; /* Need to lookup the method */
550 const SSL_CIPHER *cipher;
a230b26e
EK
551 unsigned long cipher_id; /* when ASN.1 loaded, this needs to be used to
552 * load the 'cipher' structure */
b6ba4014
MC
553 STACK_OF(SSL_CIPHER) *ciphers; /* shared ciphers? */
554 CRYPTO_EX_DATA ex_data; /* application specific data */
555 /*
556 * These are used to make removal of session-ids more efficient and to
557 * implement a maximum cache size.
558 */
559 struct ssl_session_st *prev, *next;
aff8c126
RS
560
561 struct {
562 char *hostname;
e481f9b9 563# ifndef OPENSSL_NO_EC
aff8c126
RS
564 size_t ecpointformats_len;
565 unsigned char *ecpointformats; /* peer's list */
f9df0a77 566# endif /* OPENSSL_NO_EC */
aff8c126 567 size_t supportedgroups_len;
9e84a42d 568 uint16_t *supportedgroups; /* peer's list */
b6ba4014 569 /* RFC4507 info */
aff8c126
RS
570 unsigned char *tick; /* Session ticket */
571 size_t ticklen; /* Session ticket length */
572 /* Session lifetime hint in seconds */
573 unsigned long tick_lifetime_hint;
fc24f0bf 574 uint32_t tick_age_add;
9b6a8254
MC
575 unsigned char *tick_nonce;
576 size_t tick_nonce_len;
ec15acb6 577 int tick_identity;
5d5b3fba
MC
578 /* Max number of bytes that can be sent as early data */
579 uint32_t max_early_data;
f6370040
MC
580 /* The ALPN protocol selected for this session */
581 unsigned char *alpn_selected;
582 size_t alpn_selected_len;
cf72c757
F
583 /*
584 * Maximum Fragment Length as per RFC 4366.
585 * If this value does not contain RFC 4366 allowed values (1-4) then
586 * either the Maximum Fragment Length Negotiation failed or was not
587 * performed at all.
588 */
589 uint8_t max_fragment_len_mode;
aff8c126 590 } ext;
b6ba4014
MC
591# ifndef OPENSSL_NO_SRP
592 char *srp_username;
593# endif
df0fed9a
TS
594 unsigned char *ticket_appdata;
595 size_t ticket_appdata_len;
f7d53487 596 uint32_t flags;
16203f7b 597 CRYPTO_RWLOCK *lock;
b6ba4014
MC
598};
599
6f152a15 600/* Extended master secret support */
a230b26e 601# define SSL_SESS_FLAG_EXTMS 0x1
b6ba4014
MC
602
603# ifndef OPENSSL_NO_SRP
604
605typedef struct srp_ctx_st {
606 /* param for all the callbacks */
607 void *SRP_cb_arg;
608 /* set client Hello login callback */
609 int (*TLS_ext_srp_username_callback) (SSL *, int *, void *);
610 /* set SRP N/g param callback for verification */
611 int (*SRP_verify_param_callback) (SSL *, void *);
612 /* set SRP client passwd callback */
613 char *(*SRP_give_srp_client_pwd_callback) (SSL *, void *);
614 char *login;
615 BIGNUM *N, *g, *s, *B, *A;
616 BIGNUM *a, *b, *v;
617 char *info;
618 int strength;
619 unsigned long srp_Mask;
620} SRP_CTX;
621
622# endif
623
49e7fe12
MC
624typedef enum {
625 SSL_EARLY_DATA_NONE = 0,
626 SSL_EARLY_DATA_CONNECT_RETRY,
627 SSL_EARLY_DATA_CONNECTING,
628 SSL_EARLY_DATA_WRITE_RETRY,
629 SSL_EARLY_DATA_WRITING,
2a8db717 630 SSL_EARLY_DATA_WRITE_FLUSH,
09f28874 631 SSL_EARLY_DATA_UNAUTH_WRITING,
d781d247
MC
632 SSL_EARLY_DATA_FINISHED_WRITING,
633 SSL_EARLY_DATA_ACCEPT_RETRY,
634 SSL_EARLY_DATA_ACCEPTING,
635 SSL_EARLY_DATA_READ_RETRY,
636 SSL_EARLY_DATA_READING,
637 SSL_EARLY_DATA_FINISHED_READING
49e7fe12
MC
638} SSL_EARLY_DATA_STATE;
639
70ef40a0
MC
640/*
641 * We check that the amount of unreadable early data doesn't exceed
642 * max_early_data. max_early_data is given in plaintext bytes. However if it is
643 * unreadable then we only know the number of ciphertext bytes. We also don't
644 * know how much the overhead should be because it depends on the ciphersuite.
645 * We make a small allowance. We assume 5 records of actual data plus the end
646 * of early data alert record. Each record has a tag and a content type byte.
647 * The longest tag length we know of is EVP_GCM_TLS_TAG_LEN. We don't count the
648 * content of the alert record either which is 2 bytes.
649 */
650# define EARLY_DATA_CIPHERTEXT_OVERHEAD ((6 * (EVP_GCM_TLS_TAG_LEN + 1)) + 2)
651
2c604cb9
MC
652/*
653 * The allowance we have between the client's calculated ticket age and our own.
654 * We allow for 10 seconds (units are in ms). If a ticket is presented and the
655 * client's age calculation is different by more than this than our own then we
656 * do not allow that ticket for early_data.
657 */
658# define TICKET_AGE_ALLOWANCE (10 * 1000)
659
cb7a1f5f
BK
660#define MAX_COMPRESSIONS_SIZE 255
661
b6ba4014
MC
662struct ssl_comp_st {
663 int id;
664 const char *name;
b6ba4014 665 COMP_METHOD *method;
b6ba4014
MC
666};
667
cb7a1f5f
BK
668typedef struct raw_extension_st {
669 /* Raw packet data for the extension */
670 PACKET data;
671 /* Set to 1 if the extension is present or 0 otherwise */
672 int present;
673 /* Set to 1 if we have already parsed the extension or 0 otherwise */
674 int parsed;
675 /* The type of this extension, i.e. a TLSEXT_TYPE_* value */
676 unsigned int type;
193b5d76
BK
677 /* Track what order extensions are received in (0-based). */
678 size_t received_order;
cb7a1f5f
BK
679} RAW_EXTENSION;
680
681typedef struct {
682 unsigned int isv2;
683 unsigned int legacy_version;
684 unsigned char random[SSL3_RANDOM_SIZE];
685 size_t session_id_len;
686 unsigned char session_id[SSL_MAX_SSL_SESSION_ID_LENGTH];
687 size_t dtls_cookie_len;
688 unsigned char dtls_cookie[DTLS1_COOKIE_LENGTH];
689 PACKET ciphersuites;
690 size_t compressions_len;
691 unsigned char compressions[MAX_COMPRESSIONS_SIZE];
692 PACKET extensions;
693 size_t pre_proc_exts_len;
694 RAW_EXTENSION *pre_proc_exts;
695} CLIENTHELLO_MSG;
696
b186a592
MC
697/*
698 * Extension index values NOTE: Any updates to these defines should be mirrored
699 * with equivalent updates to ext_defs in extensions.c
700 */
701typedef enum tlsext_index_en {
702 TLSEXT_IDX_renegotiate,
703 TLSEXT_IDX_server_name,
cf72c757 704 TLSEXT_IDX_max_fragment_length,
b186a592
MC
705 TLSEXT_IDX_srp,
706 TLSEXT_IDX_ec_point_formats,
707 TLSEXT_IDX_supported_groups,
708 TLSEXT_IDX_session_ticket,
b186a592
MC
709 TLSEXT_IDX_status_request,
710 TLSEXT_IDX_next_proto_neg,
711 TLSEXT_IDX_application_layer_protocol_negotiation,
712 TLSEXT_IDX_use_srtp,
713 TLSEXT_IDX_encrypt_then_mac,
714 TLSEXT_IDX_signed_certificate_timestamp,
715 TLSEXT_IDX_extended_master_secret,
c589c34e 716 TLSEXT_IDX_signature_algorithms_cert,
9d75dce3 717 TLSEXT_IDX_post_handshake_auth,
10ed1b72 718 TLSEXT_IDX_signature_algorithms,
b186a592
MC
719 TLSEXT_IDX_supported_versions,
720 TLSEXT_IDX_psk_kex_modes,
721 TLSEXT_IDX_key_share,
722 TLSEXT_IDX_cookie,
723 TLSEXT_IDX_cryptopro_bug,
724 TLSEXT_IDX_early_data,
725 TLSEXT_IDX_certificate_authorities,
726 TLSEXT_IDX_padding,
727 TLSEXT_IDX_psk,
728 /* Dummy index - must always be the last entry */
729 TLSEXT_IDX_num_builtins
730} TLSEXT_INDEX;
731
89d6aa10 732DEFINE_LHASH_OF(SSL_SESSION);
ce023e77
VD
733/* Needed in ssl_cert.c */
734DEFINE_LHASH_OF(X509_NAME);
f8e0a557 735
4bfb96f2
TS
736# define TLSEXT_KEYNAME_LENGTH 16
737# define TLSEXT_TICK_KEY_LENGTH 32
738
739typedef struct ssl_ctx_ext_secure_st {
740 unsigned char tick_hmac_key[TLSEXT_TICK_KEY_LENGTH];
741 unsigned char tick_aes_key[TLSEXT_TICK_KEY_LENGTH];
742} SSL_CTX_EXT_SECURE;
d139723b 743
b6ba4014
MC
744struct ssl_ctx_st {
745 const SSL_METHOD *method;
746 STACK_OF(SSL_CIPHER) *cipher_list;
747 /* same as above but sorted for lookup */
748 STACK_OF(SSL_CIPHER) *cipher_list_by_id;
f865b081
MC
749 /* TLSv1.3 specific ciphersuites */
750 STACK_OF(SSL_CIPHER) *tls13_ciphersuites;
b6ba4014
MC
751 struct x509_store_st /* X509_STORE */ *cert_store;
752 LHASH_OF(SSL_SESSION) *sessions;
753 /*
754 * Most session-ids that will be cached, default is
755 * SSL_SESSION_CACHE_MAX_SIZE_DEFAULT. 0 is unlimited.
756 */
cb150cbc 757 size_t session_cache_size;
b6ba4014
MC
758 struct ssl_session_st *session_cache_head;
759 struct ssl_session_st *session_cache_tail;
760 /*
761 * This can have one of 2 values, ored together, SSL_SESS_CACHE_CLIENT,
762 * SSL_SESS_CACHE_SERVER, Default is SSL_SESSION_CACHE_SERVER, which
6aff543b 763 * means only SSL_accept will cache SSL_SESSIONS.
b6ba4014 764 */
f7d53487 765 uint32_t session_cache_mode;
b6ba4014
MC
766 /*
767 * If timeout is not 0, it is the default timeout value set when
768 * SSL_new() is called. This has been put in to make life easier to set
769 * things up
770 */
771 long session_timeout;
772 /*
773 * If this callback is not null, it will be called each time a session id
774 * is added to the cache. If this function returns 1, it means that the
775 * callback will do a SSL_SESSION_free() when it has finished using it.
776 * Otherwise, on 0, it means the callback has finished with it. If
777 * remove_session_cb is not null, it will be called when a session-id is
778 * removed from the cache. After the call, OpenSSL will
779 * SSL_SESSION_free() it.
780 */
781 int (*new_session_cb) (struct ssl_st *ssl, SSL_SESSION *sess);
782 void (*remove_session_cb) (struct ssl_ctx_st *ctx, SSL_SESSION *sess);
783 SSL_SESSION *(*get_session_cb) (struct ssl_st *ssl,
b6981744
EK
784 const unsigned char *data, int len,
785 int *copy);
b6ba4014
MC
786 struct {
787 int sess_connect; /* SSL new conn - started */
788 int sess_connect_renegotiate; /* SSL reneg - requested */
789 int sess_connect_good; /* SSL new conne/reneg - finished */
790 int sess_accept; /* SSL new accept - started */
791 int sess_accept_renegotiate; /* SSL reneg - requested */
792 int sess_accept_good; /* SSL accept/reneg - finished */
793 int sess_miss; /* session lookup misses */
794 int sess_timeout; /* reuse attempt on timeouted session */
795 int sess_cache_full; /* session removed due to full cache */
796 int sess_hit; /* session reuse actually done */
797 int sess_cb_hit; /* session-id that was not in the cache was
798 * passed back via the callback. This
a230b26e
EK
799 * indicates that the application is supplying
800 * session-id's from other processes - spooky
801 * :-) */
b6ba4014
MC
802 } stats;
803
2f545ae4 804 CRYPTO_REF_COUNT references;
b6ba4014
MC
805
806 /* if defined, these override the X509_verify_cert() calls */
807 int (*app_verify_callback) (X509_STORE_CTX *, void *);
808 void *app_verify_arg;
809 /*
810 * before OpenSSL 0.9.7, 'app_verify_arg' was ignored
811 * ('app_verify_callback' was called with just one argument)
812 */
813
814 /* Default password callback. */
815 pem_password_cb *default_passwd_callback;
816
817 /* Default password callback user data. */
818 void *default_passwd_callback_userdata;
819
820 /* get client cert callback */
821 int (*client_cert_cb) (SSL *ssl, X509 **x509, EVP_PKEY **pkey);
822
823 /* cookie generate callback */
824 int (*app_gen_cookie_cb) (SSL *ssl, unsigned char *cookie,
825 unsigned int *cookie_len);
826
827 /* verify cookie callback */
31011544 828 int (*app_verify_cookie_cb) (SSL *ssl, const unsigned char *cookie,
b6ba4014
MC
829 unsigned int cookie_len);
830
3fa2812f
BS
831 /* TLS1.3 app-controlled cookie generate callback */
832 int (*gen_stateless_cookie_cb) (SSL *ssl, unsigned char *cookie,
833 size_t *cookie_len);
834
835 /* TLS1.3 verify app-controlled cookie callback */
836 int (*verify_stateless_cookie_cb) (SSL *ssl, const unsigned char *cookie,
837 size_t cookie_len);
838
b6ba4014
MC
839 CRYPTO_EX_DATA ex_data;
840
841 const EVP_MD *md5; /* For SSLv3/TLSv1 'ssl3-md5' */
842 const EVP_MD *sha1; /* For SSLv3/TLSv1 'ssl3->sha1' */
843
844 STACK_OF(X509) *extra_certs;
845 STACK_OF(SSL_COMP) *comp_methods; /* stack of SSL_COMP, SSLv3/TLSv1 */
846
847 /* Default values used when no per-SSL value is defined follow */
848
849 /* used if SSL's info_callback is NULL */
850 void (*info_callback) (const SSL *ssl, int type, int val);
851
fa7c2637
DSH
852 /*
853 * What we put in certificate_authorities extension for TLS 1.3
854 * (ClientHello and CertificateRequest) or just client cert requests for
855 * earlier versions.
856 */
857 STACK_OF(X509_NAME) *ca_names;
b6ba4014
MC
858
859 /*
860 * Default values to use in SSL structures follow (these are copied by
861 * SSL_new)
862 */
863
f7d53487
DSH
864 uint32_t options;
865 uint32_t mode;
7946ab33
KR
866 int min_proto_version;
867 int max_proto_version;
12472b45 868 size_t max_cert_list;
b6ba4014
MC
869
870 struct cert_st /* CERT */ *cert;
871 int read_ahead;
872
873 /* callback that allows applications to peek at protocol messages */
874 void (*msg_callback) (int write_p, int version, int content_type,
875 const void *buf, size_t len, SSL *ssl, void *arg);
876 void *msg_callback_arg;
877
f7d53487 878 uint32_t verify_mode;
ec60ccc1 879 size_t sid_ctx_length;
b6ba4014
MC
880 unsigned char sid_ctx[SSL_MAX_SID_CTX_LENGTH];
881 /* called 'verify_callback' in the SSL */
882 int (*default_verify_callback) (int ok, X509_STORE_CTX *ctx);
883
884 /* Default generate session ID callback. */
885 GEN_SESSION_CB generate_session_id;
886
887 X509_VERIFY_PARAM *param;
888
889 int quiet_shutdown;
890
a230b26e
EK
891# ifndef OPENSSL_NO_CT
892 CTLOG_STORE *ctlog_store; /* CT Log Store */
ed29e82a 893 /*
a230b26e
EK
894 * Validates that the SCTs (Signed Certificate Timestamps) are sufficient.
895 * If they are not, the connection should be aborted.
896 */
43341433 897 ssl_ct_validation_cb ct_validation_callback;
ed29e82a 898 void *ct_validation_callback_arg;
a230b26e 899# endif
ed29e82a 900
d102d9df
MC
901 /*
902 * If we're using more than one pipeline how should we divide the data
903 * up between the pipes?
904 */
7ee8627f 905 size_t split_send_fragment;
b6ba4014
MC
906 /*
907 * Maximum amount of data to send in one fragment. actual record size can
908 * be more than this due to padding and MAC overheads.
909 */
7ee8627f 910 size_t max_send_fragment;
b6ba4014 911
d102d9df 912 /* Up to how many pipelines should we use? If 0 then 1 is assumed */
7ee8627f 913 size_t max_pipelines;
d102d9df 914
dad78fb1
MC
915 /* The default read buffer length to use (0 means not set) */
916 size_t default_read_buf_len;
917
a230b26e 918# ifndef OPENSSL_NO_ENGINE
b6ba4014
MC
919 /*
920 * Engine to pass requests for client certs to
921 */
922 ENGINE *client_cert_engine;
a230b26e 923# endif
b6ba4014 924
a9c0d8be
DB
925 /* ClientHello callback. Mostly for extensions, but not entirely. */
926 SSL_client_hello_cb_fn client_hello_cb;
927 void *client_hello_cb_arg;
6b1bb98f 928
aff8c126
RS
929 /* TLS extensions. */
930 struct {
931 /* TLS extensions servername callback */
932 int (*servername_cb) (SSL *, int *, void *);
933 void *servername_arg;
934 /* RFC 4507 session ticket keys */
935 unsigned char tick_key_name[TLSEXT_KEYNAME_LENGTH];
4bfb96f2 936 SSL_CTX_EXT_SECURE *secure;
aff8c126
RS
937 /* Callback to support customisation of ticket key setting */
938 int (*ticket_key_cb) (SSL *ssl,
939 unsigned char *name, unsigned char *iv,
940 EVP_CIPHER_CTX *ectx, HMAC_CTX *hctx, int enc);
941
942 /* certificate status request info */
943 /* Callback for status request */
944 int (*status_cb) (SSL *ssl, void *arg);
945 void *status_arg;
946 /* ext status type used for CSR extension (OCSP Stapling) */
947 int status_type;
cf72c757
F
948 /* RFC 4366 Maximum Fragment Length Negotiation */
949 uint8_t max_fragment_len_mode;
b6ba4014 950
aff8c126
RS
951# ifndef OPENSSL_NO_EC
952 /* EC extension values inherited by SSL structure */
953 size_t ecpointformats_len;
954 unsigned char *ecpointformats;
955 size_t supportedgroups_len;
9e84a42d 956 uint16_t *supportedgroups;
aff8c126 957# endif /* OPENSSL_NO_EC */
b6ba4014 958
aff8c126
RS
959 /*
960 * ALPN information (we are in the process of transitioning from NPN to
961 * ALPN.)
962 */
b6ba4014
MC
963
964 /*-
965 * For a server, this contains a callback function that allows the
966 * server to select the protocol for the connection.
967 * out: on successful return, this must point to the raw protocol
968 * name (without the length prefix).
969 * outlen: on successful return, this contains the length of |*out|.
970 * in: points to the client's list of supported protocols in
971 * wire-format.
972 * inlen: the length of |in|.
973 */
aff8c126
RS
974 int (*alpn_select_cb) (SSL *s,
975 const unsigned char **out,
976 unsigned char *outlen,
977 const unsigned char *in,
978 unsigned int inlen, void *arg);
979 void *alpn_select_cb_arg;
b6ba4014 980
aff8c126
RS
981 /*
982 * For a client, this contains the list of supported protocols in wire
983 * format.
984 */
985 unsigned char *alpn;
986 size_t alpn_len;
987
e3bc1305 988# ifndef OPENSSL_NO_NEXTPROTONEG
aff8c126
RS
989 /* Next protocol negotiation information */
990
991 /*
992 * For a server, this contains a callback function by which the set of
993 * advertised protocols can be provided.
994 */
8cbfcc70 995 SSL_CTX_npn_advertised_cb_func npn_advertised_cb;
aff8c126
RS
996 void *npn_advertised_cb_arg;
997 /*
998 * For a client, this contains a callback function that selects the next
999 * protocol from the list provided by the server.
1000 */
8cbfcc70 1001 SSL_CTX_npn_select_cb_func npn_select_cb;
aff8c126
RS
1002 void *npn_select_cb_arg;
1003# endif
43054d3d
MC
1004
1005 unsigned char cookie_hmac_key[SHA256_DIGEST_LENGTH];
aff8c126
RS
1006 } ext;
1007
1008# ifndef OPENSSL_NO_PSK
8cbfcc70
RS
1009 SSL_psk_client_cb_func psk_client_callback;
1010 SSL_psk_server_cb_func psk_server_callback;
aff8c126 1011# endif
3a7c56b2 1012 SSL_psk_find_session_cb_func psk_find_session_cb;
9368f865 1013 SSL_psk_use_session_cb_func psk_use_session_cb;
aff8c126
RS
1014
1015# ifndef OPENSSL_NO_SRP
1016 SRP_CTX srp_ctx; /* ctx for SRP authentication */
1017# endif
b6ba4014 1018
919ba009
VD
1019 /* Shared DANE context */
1020 struct dane_ctx_st dane;
1021
b6ba4014
MC
1022 /* SRTP profiles we are willing to do from RFC 5764 */
1023 STACK_OF(SRTP_PROTECTION_PROFILE) *srtp_profiles;
b6ba4014
MC
1024 /*
1025 * Callback for disabling session caching and ticket support on a session
1026 * basis, depending on the chosen cipher.
1027 */
1028 int (*not_resumable_session_cb) (SSL *ssl, int is_forward_secure);
ba261f71 1029
16203f7b 1030 CRYPTO_RWLOCK *lock;
2faa1b48
CB
1031
1032 /*
1033 * Callback for logging key material for use with debugging tools like
1034 * Wireshark. The callback should log `line` followed by a newline.
1035 */
1036 SSL_CTX_keylog_cb_func keylog_callback;
3fc8d856
MC
1037
1038 /* The maximum number of bytes that can be sent as early data */
1039 uint32_t max_early_data;
c649d10d
TS
1040
1041 /* TLS1.3 padding callback */
1042 size_t (*record_padding_cb)(SSL *s, int type, size_t len, void *arg);
1043 void *record_padding_arg;
1044 size_t block_padding;
df0fed9a
TS
1045
1046 /* Session ticket appdata */
1047 SSL_CTX_generate_session_ticket_fn generate_ticket_cb;
1048 SSL_CTX_decrypt_session_ticket_fn decrypt_ticket_cb;
1049 void *ticket_cb_data;
b6ba4014
MC
1050};
1051
b6ba4014
MC
1052struct ssl_st {
1053 /*
1054 * protocol version (one of SSL2_VERSION, SSL3_VERSION, TLS1_VERSION,
1055 * DTLS1_VERSION)
1056 */
1057 int version;
b6ba4014
MC
1058 /* SSLv3 */
1059 const SSL_METHOD *method;
1060 /*
1061 * There are 2 BIO's even though they are normally both the same. This
1062 * is so data can be read and written to different handlers
1063 */
1064 /* used by SSL_read */
1065 BIO *rbio;
1066 /* used by SSL_write */
1067 BIO *wbio;
1068 /* used during session-id reuse to concatenate messages */
1069 BIO *bbio;
1070 /*
1071 * This holds a variable that indicates what we were doing when a 0 or -1
1072 * is returned. This is needed for non-blocking IO so we know what
1073 * request needs re-doing when in SSL_accept or SSL_connect
1074 */
1075 int rwstate;
b6ba4014
MC
1076 int (*handshake_func) (SSL *);
1077 /*
1078 * Imagine that here's a boolean member "init" that is switched as soon
1079 * as SSL_set_{accept/connect}_state is called for the first time, so
1080 * that "state" and "handshake_func" are properly initialized. But as
1081 * handshake_func is == 0 until then, we use this test instead of an
1082 * "init" member.
1083 */
23a635c0 1084 /* are we the server side? */
b6ba4014
MC
1085 int server;
1086 /*
1087 * Generate a new session or reuse an old one.
1088 * NB: For servers, the 'new' session may actually be a previously
1089 * cached session or even the previous session unless
1090 * SSL_OP_NO_SESSION_RESUMPTION_ON_RENEGOTIATION is set
1091 */
1092 int new_session;
1093 /* don't send shutdown packets */
1094 int quiet_shutdown;
1095 /* we have shut things down, 0x01 sent, 0x02 for received */
1096 int shutdown;
1097 /* where we are */
d6f1a6e9 1098 OSSL_STATEM statem;
49e7fe12 1099 SSL_EARLY_DATA_STATE early_data_state;
b6ba4014
MC
1100 BUF_MEM *init_buf; /* buffer used during init */
1101 void *init_msg; /* pointer to handshake message body, set by
1102 * ssl3_get_message() */
eda75751
MC
1103 size_t init_num; /* amount read/written */
1104 size_t init_off; /* amount read/written */
b6ba4014
MC
1105 struct ssl3_state_st *s3; /* SSLv3 variables */
1106 struct dtls1_state_st *d1; /* DTLSv1 variables */
b6ba4014
MC
1107 /* callback that allows applications to peek at protocol messages */
1108 void (*msg_callback) (int write_p, int version, int content_type,
1109 const void *buf, size_t len, SSL *ssl, void *arg);
1110 void *msg_callback_arg;
1111 int hit; /* reusing a previous session */
1112 X509_VERIFY_PARAM *param;
919ba009 1113 /* Per connection DANE state */
b9aec69a 1114 SSL_DANE dane;
b6ba4014
MC
1115 /* crypto */
1116 STACK_OF(SSL_CIPHER) *cipher_list;
1117 STACK_OF(SSL_CIPHER) *cipher_list_by_id;
f865b081
MC
1118 /* TLSv1.3 specific ciphersuites */
1119 STACK_OF(SSL_CIPHER) *tls13_ciphersuites;
b6ba4014
MC
1120 /*
1121 * These are the ones being used, the ones in SSL_SESSION are the ones to
1122 * be 'copied' into these ones
1123 */
f7d53487 1124 uint32_t mac_flags;
34574f19 1125 /*
ec15acb6
MC
1126 * The TLS1.3 secrets. The resumption master secret is stored in the
1127 * session.
34574f19
MC
1128 */
1129 unsigned char early_secret[EVP_MAX_MD_SIZE];
1130 unsigned char handshake_secret[EVP_MAX_MD_SIZE];
ec15acb6 1131 unsigned char master_secret[EVP_MAX_MD_SIZE];
6484776f
MC
1132 unsigned char client_finished_secret[EVP_MAX_MD_SIZE];
1133 unsigned char server_finished_secret[EVP_MAX_MD_SIZE];
ace081c1 1134 unsigned char server_finished_hash[EVP_MAX_MD_SIZE];
fe5e20fd 1135 unsigned char handshake_traffic_hash[EVP_MAX_MD_SIZE];
57389a32
MC
1136 unsigned char client_app_traffic_secret[EVP_MAX_MD_SIZE];
1137 unsigned char server_app_traffic_secret[EVP_MAX_MD_SIZE];
0ca8d1ec 1138 unsigned char exporter_master_secret[EVP_MAX_MD_SIZE];
b38ede80 1139 unsigned char early_exporter_master_secret[EVP_MAX_MD_SIZE];
b6ba4014 1140 EVP_CIPHER_CTX *enc_read_ctx; /* cryptographic state */
bebc0c7d 1141 unsigned char read_iv[EVP_MAX_IV_LENGTH]; /* TLSv1.3 static read IV */
b6ba4014 1142 EVP_MD_CTX *read_hash; /* used for mac generation */
9a555706 1143 COMP_CTX *compress; /* compression */
b6ba4014 1144 COMP_CTX *expand; /* uncompress */
b6ba4014 1145 EVP_CIPHER_CTX *enc_write_ctx; /* cryptographic state */
bebc0c7d 1146 unsigned char write_iv[EVP_MAX_IV_LENGTH]; /* TLSv1.3 static write IV */
b6ba4014 1147 EVP_MD_CTX *write_hash; /* used for mac generation */
82f992cb
MC
1148 /* Count of how many KeyUpdate messages we have received */
1149 unsigned int key_update_count;
b6ba4014
MC
1150 /* session info */
1151 /* client cert? */
1152 /* This is used to hold the server certificate used */
1153 struct cert_st /* CERT */ *cert;
2c5dfdc3
MC
1154
1155 /*
1156 * The hash of all messages prior to the CertificateVerify, and the length
1157 * of that hash.
1158 */
1159 unsigned char cert_verify_hash[EVP_MAX_MD_SIZE];
1160 size_t cert_verify_hash_len;
1161
7d061fce 1162 /* Flag to indicate whether we should send a HelloRetryRequest or not */
fc7129dc
MC
1163 enum {SSL_HRR_NONE = 0, SSL_HRR_PENDING, SSL_HRR_COMPLETE}
1164 hello_retry_request;
7d061fce 1165
b6ba4014
MC
1166 /*
1167 * the session_id_context is used to ensure sessions are only reused in
1168 * the appropriate context
1169 */
ec60ccc1 1170 size_t sid_ctx_length;
b6ba4014
MC
1171 unsigned char sid_ctx[SSL_MAX_SID_CTX_LENGTH];
1172 /* This can also be in the session once a session is established */
1173 SSL_SESSION *session;
9368f865
MC
1174 /* TLSv1.3 PSK session */
1175 SSL_SESSION *psksession;
add8d0e9
MC
1176 unsigned char *psksession_id;
1177 size_t psksession_id_len;
b6ba4014
MC
1178 /* Default generate session ID callback. */
1179 GEN_SESSION_CB generate_session_id;
a5816a5a
MC
1180 /*
1181 * The temporary TLSv1.3 session id. This isn't really a session id at all
1182 * but is a random value sent in the legacy session id field.
1183 */
1184 unsigned char tmp_session_id[SSL_MAX_SSL_SESSION_ID_LENGTH];
1185 size_t tmp_session_id_len;
b6ba4014
MC
1186 /* Used in SSL3 */
1187 /*
1188 * 0 don't care about verify failure.
1189 * 1 fail if verify fails
1190 */
f7d53487 1191 uint32_t verify_mode;
b6ba4014
MC
1192 /* fail if callback returns 0 */
1193 int (*verify_callback) (int ok, X509_STORE_CTX *ctx);
1194 /* optional informational callback */
1195 void (*info_callback) (const SSL *ssl, int type, int val);
1196 /* error bytes to be written */
1197 int error;
1198 /* actual code */
1199 int error_code;
a230b26e 1200# ifndef OPENSSL_NO_PSK
8cbfcc70
RS
1201 SSL_psk_client_cb_func psk_client_callback;
1202 SSL_psk_server_cb_func psk_server_callback;
a230b26e 1203# endif
3a7c56b2 1204 SSL_psk_find_session_cb_func psk_find_session_cb;
9368f865 1205 SSL_psk_use_session_cb_func psk_use_session_cb;
b6ba4014 1206 SSL_CTX *ctx;
696178ed
DSH
1207 /* Verified chain of peer */
1208 STACK_OF(X509) *verified_chain;
b6ba4014 1209 long verify_result;
696178ed 1210 /* extra application data */
b6ba4014
MC
1211 CRYPTO_EX_DATA ex_data;
1212 /* for server side, keep the list of CA_dn we can use */
fa7c2637 1213 STACK_OF(X509_NAME) *ca_names;
2f545ae4 1214 CRYPTO_REF_COUNT references;
b6ba4014 1215 /* protocol behaviour */
f7d53487 1216 uint32_t options;
b6ba4014 1217 /* API behaviour */
f7d53487 1218 uint32_t mode;
7946ab33
KR
1219 int min_proto_version;
1220 int max_proto_version;
12472b45 1221 size_t max_cert_list;
b6ba4014 1222 int first_packet;
7acb8b64
MC
1223 /*
1224 * What was passed in ClientHello.legacy_version. Used for RSA pre-master
1225 * secret and SSLv3/TLS (<=1.2) rollback check
1226 */
b6ba4014 1227 int client_version;
d102d9df
MC
1228 /*
1229 * If we're using more than one pipeline how should we divide the data
1230 * up between the pipes?
1231 */
7ee8627f 1232 size_t split_send_fragment;
d102d9df
MC
1233 /*
1234 * Maximum amount of data to send in one fragment. actual record size can
1235 * be more than this due to padding and MAC overheads.
1236 */
7ee8627f 1237 size_t max_send_fragment;
d102d9df 1238 /* Up to how many pipelines should we use? If 0 then 1 is assumed */
7ee8627f 1239 size_t max_pipelines;
aff8c126
RS
1240
1241 struct {
b186a592
MC
1242 /* Built-in extension flags */
1243 uint8_t extflags[TLSEXT_IDX_num_builtins];
aff8c126 1244 /* TLS extension debug callback */
1ed327f7
RS
1245 void (*debug_cb)(SSL *s, int client_server, int type,
1246 const unsigned char *data, int len, void *arg);
aff8c126
RS
1247 void *debug_arg;
1248 char *hostname;
1249 /* certificate status request info */
1250 /* Status type or -1 if no status type */
1251 int status_type;
1252 /* Raw extension data, if seen */
1253 unsigned char *scts;
1254 /* Length of raw extension data, if seen */
1255 uint16_t scts_len;
1256 /* Expect OCSP CertificateStatus message */
1257 int status_expected;
1258
1259 struct {
1260 /* OCSP status request only */
1261 STACK_OF(OCSP_RESPID) *ids;
1262 X509_EXTENSIONS *exts;
1263 /* OCSP response received or to be sent */
1264 unsigned char *resp;
1265 size_t resp_len;
1266 } ocsp;
1267
1268 /* RFC4507 session ticket expected to be received or sent */
1269 int ticket_expected;
1270# ifndef OPENSSL_NO_EC
1271 size_t ecpointformats_len;
1272 /* our list */
1273 unsigned char *ecpointformats;
f9df0a77 1274# endif /* OPENSSL_NO_EC */
aff8c126
RS
1275 size_t supportedgroups_len;
1276 /* our list */
9e84a42d 1277 uint16_t *supportedgroups;
aff8c126
RS
1278 /* TLS Session Ticket extension override */
1279 TLS_SESSION_TICKET_EXT *session_ticket;
1280 /* TLS Session Ticket extension callback */
1281 tls_session_ticket_ext_cb_fn session_ticket_cb;
1282 void *session_ticket_cb_arg;
1283 /* TLS pre-shared secret session resumption */
1284 tls_session_secret_cb_fn session_secret_cb;
1285 void *session_secret_cb_arg;
1286 /*
1287 * For a client, this contains the list of supported protocols in wire
1288 * format.
1289 */
1290 unsigned char *alpn;
1291 size_t alpn_len;
1292 /*
1293 * Next protocol negotiation. For the client, this is the protocol that
1294 * we sent in NextProtocol and is set when handling ServerHello
1295 * extensions. For a server, this is the client's selected_protocol from
1296 * NextProtocol and is set when handling the NextProtocol message, before
1297 * the Finished message.
1298 */
1299 unsigned char *npn;
1300 size_t npn_len;
b2f7e8c0 1301
4086b42b 1302 /* The available PSK key exchange modes */
b2f7e8c0 1303 int psk_kex_mode;
28a31a0a
MC
1304
1305 /* Set to one if we have negotiated ETM */
1306 int use_etm;
0a87d0ac 1307
1ea4d09a
MC
1308 /* Are we expecting to receive early data? */
1309 int early_data;
2c604cb9
MC
1310 /* Is the session suitable for early data? */
1311 int early_data_ok;
cfef5027
MC
1312
1313 /* May be sent by a server in HRR. Must be echoed back in ClientHello */
1314 unsigned char *tls13_cookie;
1315 size_t tls13_cookie_len;
c36001c3
MC
1316 /* Have we received a cookie from the client? */
1317 int cookieok;
1318
cf72c757
F
1319 /*
1320 * Maximum Fragment Length as per RFC 4366.
1321 * If this member contains one of the allowed values (1-4)
1322 * then we should include Maximum Fragment Length Negotiation
1323 * extension in Client Hello.
1324 * Please note that value of this member does not have direct
1325 * effect. The actual (binding) value is stored in SSL_SESSION,
1326 * as this extension is optional on server side.
1327 */
1328 uint8_t max_fragment_len_mode;
aff8c126
RS
1329 } ext;
1330
a9c0d8be
DB
1331 /*
1332 * Parsed form of the ClientHello, kept around across client_hello_cb
1333 * calls.
1334 */
6b1bb98f
BK
1335 CLIENTHELLO_MSG *clienthello;
1336
b6ba4014
MC
1337 /*-
1338 * no further mod of servername
1339 * 0 : call the servername extension callback.
1340 * 1 : prepare 2, allow last ack just after in server callback.
1341 * 2 : don't call servername callback, no ack in server hello
1342 */
1343 int servername_done;
a230b26e 1344# ifndef OPENSSL_NO_CT
ed29e82a 1345 /*
a230b26e
EK
1346 * Validates that the SCTs (Signed Certificate Timestamps) are sufficient.
1347 * If they are not, the connection should be aborted.
1348 */
43341433 1349 ssl_ct_validation_cb ct_validation_callback;
48722ff5 1350 /* User-supplied argument that is passed to the ct_validation_callback */
ed29e82a
RP
1351 void *ct_validation_callback_arg;
1352 /*
1353 * Consolidated stack of SCTs from all sources.
1354 * Lazily populated by CT_get_peer_scts(SSL*)
1355 */
1356 STACK_OF(SCT) *scts;
ed29e82a
RP
1357 /* Have we attempted to find/parse SCTs yet? */
1358 int scts_parsed;
a230b26e 1359# endif
222da979 1360 SSL_CTX *session_ctx; /* initial ctx, used to store sessions */
b6ba4014
MC
1361 /* What we'll do */
1362 STACK_OF(SRTP_PROTECTION_PROFILE) *srtp_profiles;
1363 /* What's been chosen */
1364 SRTP_PROTECTION_PROFILE *srtp_profile;
b6ba4014
MC
1365 /*-
1366 * 1 if we are renegotiating.
1367 * 2 if we are a server and are inside a handshake
1368 * (i.e. not just sending a HelloRequest)
1369 */
1370 int renegotiate;
44c04a2e 1371 /* If sending a KeyUpdate is pending */
4fbfe86a 1372 int key_update;
9d75dce3
TS
1373 /* Post-handshake authentication state */
1374 SSL_PHA_STATE post_handshake_auth;
1375 int pha_forced;
1376 uint8_t* pha_context;
1377 size_t pha_context_len;
1378 int certreqs_sent;
1379 EVP_MD_CTX *pha_dgst; /* this is just the digest through ClientFinished */
1380
a230b26e 1381# ifndef OPENSSL_NO_SRP
b6ba4014
MC
1382 /* ctx for SRP authentication */
1383 SRP_CTX srp_ctx;
a230b26e 1384# endif
b6ba4014
MC
1385 /*
1386 * Callback for disabling session caching and ticket support on a session
1387 * basis, depending on the chosen cipher.
1388 */
1389 int (*not_resumable_session_cb) (SSL *ssl, int is_forward_secure);
28d59af8 1390 RECORD_LAYER rlayer;
a974e64a
MC
1391 /* Default password callback. */
1392 pem_password_cb *default_passwd_callback;
a974e64a
MC
1393 /* Default password callback user data. */
1394 void *default_passwd_callback_userdata;
07bbc92c
MC
1395 /* Async Job info */
1396 ASYNC_JOB *job;
ff75a257 1397 ASYNC_WAIT_CTX *waitctx;
7ee8627f 1398 size_t asyncrw;
eda75751 1399
70ef40a0 1400 /* The maximum number of plaintext bytes that can be sent as early data */
3fc8d856 1401 uint32_t max_early_data;
70ef40a0
MC
1402 /*
1403 * The number of bytes of early data received so far. If we accepted early
1404 * data then this is a count of the plaintext bytes. If we rejected it then
1405 * this is a count of the ciphertext bytes.
1406 */
1407 uint32_t early_data_count;
3fc8d856 1408
c649d10d
TS
1409 /* TLS1.3 padding callback */
1410 size_t (*record_padding_cb)(SSL *s, int type, size_t len, void *arg);
1411 void *record_padding_arg;
1412 size_t block_padding;
1413
16203f7b 1414 CRYPTO_RWLOCK *lock;
b6ba4014
MC
1415};
1416
f742cda8
DSH
1417/*
1418 * Structure containing table entry of values associated with the signature
1419 * algorithms (signature scheme) extension
1420*/
1421typedef struct sigalg_lookup_st {
1422 /* TLS 1.3 signature scheme name */
1423 const char *name;
1424 /* Raw value used in extension */
1425 uint16_t sigalg;
3d234c9e 1426 /* NID of hash algorithm or NID_undef if no hash */
f742cda8 1427 int hash;
3d234c9e 1428 /* Index of hash algorithm or -1 if no hash algorithm */
17ae384e 1429 int hash_idx;
f742cda8
DSH
1430 /* NID of signature algorithm */
1431 int sig;
17ae384e
DSH
1432 /* Index of signature algorithm */
1433 int sig_idx;
f742cda8
DSH
1434 /* Combined hash and signature NID, if any */
1435 int sigandhash;
1436 /* Required public key curve (ECDSA only) */
1437 int curve;
1438} SIGALG_LOOKUP;
1439
0e464d9d
DSH
1440typedef struct tls_group_info_st {
1441 int nid; /* Curve NID */
1442 int secbits; /* Bits of security (from SP800-57) */
1443 uint16_t flags; /* Flags: currently just group type */
1444} TLS_GROUP_INFO;
1445
1446/* flags values */
1447# define TLS_CURVE_TYPE 0x3 /* Mask for group type */
1448# define TLS_CURVE_PRIME 0x0
1449# define TLS_CURVE_CHAR2 0x1
1450# define TLS_CURVE_CUSTOM 0x2
1451
a497cf25
DSH
1452typedef struct cert_pkey_st CERT_PKEY;
1453
c04cd728
DSH
1454/*
1455 * Structure containing table entry of certificate info corresponding to
1456 * CERT_PKEY entries
1457 */
1458typedef struct {
1459 int nid; /* NID of pubic key algorithm */
1460 uint32_t amask; /* authmask corresponding to key type */
1461} SSL_CERT_LOOKUP;
1462
b6ba4014
MC
1463typedef struct ssl3_state_st {
1464 long flags;
b43d1cbb 1465 size_t read_mac_secret_size;
b6ba4014 1466 unsigned char read_mac_secret[EVP_MAX_MD_SIZE];
b43d1cbb 1467 size_t write_mac_secret_size;
b6ba4014
MC
1468 unsigned char write_mac_secret[EVP_MAX_MD_SIZE];
1469 unsigned char server_random[SSL3_RANDOM_SIZE];
1470 unsigned char client_random[SSL3_RANDOM_SIZE];
1471 /* flags for countermeasure against known-IV weakness */
1472 int need_empty_fragments;
1473 int empty_fragment_done;
b6ba4014
MC
1474 /* used during startup, digest all incoming/outgoing packets */
1475 BIO *handshake_buffer;
1476 /*
28ba2541
DSH
1477 * When handshake digest is determined, buffer is hashed and
1478 * freed and MD_CTX for the required digest is stored here.
b6ba4014 1479 */
28ba2541 1480 EVP_MD_CTX *handshake_dgst;
b6ba4014
MC
1481 /*
1482 * Set whenever an expected ChangeCipherSpec message is processed.
1483 * Unset when the peer's Finished message is received.
1484 * Unexpected ChangeCipherSpec messages trigger a fatal alert.
1485 */
1486 int change_cipher_spec;
1487 int warn_alert;
1488 int fatal_alert;
1489 /*
1490 * we allow one fatal and one warning alert to be outstanding, send close
1491 * alert via the warning alert
1492 */
1493 int alert_dispatch;
1494 unsigned char send_alert[2];
1495 /*
1496 * This flag is set when we should renegotiate ASAP, basically when there
1497 * is no more data in the read or write buffers
1498 */
1499 int renegotiate;
1500 int total_renegotiations;
1501 int num_renegotiations;
1502 int in_read_app_data;
1503 struct {
b6ba4014
MC
1504 /* actually only need to be 16+20 for SSLv3 and 12 for TLS */
1505 unsigned char finish_md[EVP_MAX_MD_SIZE * 2];
12472b45 1506 size_t finish_md_len;
b6ba4014 1507 unsigned char peer_finish_md[EVP_MAX_MD_SIZE * 2];
12472b45 1508 size_t peer_finish_md_len;
eda75751 1509 size_t message_size;
b6ba4014
MC
1510 int message_type;
1511 /* used to hold the new cipher we are going to use */
1512 const SSL_CIPHER *new_cipher;
a230b26e
EK
1513# if !defined(OPENSSL_NO_EC) || !defined(OPENSSL_NO_DH)
1514 EVP_PKEY *pkey; /* holds short lived DH/ECDH key */
1515# endif
b6ba4014
MC
1516 /* used for certificate requests */
1517 int cert_req;
75c13e78
DSH
1518 /* Certificate types in certificate request message. */
1519 uint8_t *ctype;
1520 size_t ctype_len;
fa7c2637
DSH
1521 /* Certificate authorities list peer sent */
1522 STACK_OF(X509_NAME) *peer_ca_names;
8c1a5343 1523 size_t key_block_length;
b6ba4014
MC
1524 unsigned char *key_block;
1525 const EVP_CIPHER *new_sym_enc;
1526 const EVP_MD *new_hash;
1527 int new_mac_pkey_type;
b43d1cbb 1528 size_t new_mac_secret_size;
a230b26e 1529# ifndef OPENSSL_NO_COMP
b6ba4014 1530 const SSL_COMP *new_compression;
a230b26e 1531# else
b6ba4014 1532 char *new_compression;
a230b26e 1533# endif
b6ba4014 1534 int cert_request;
76106e60
DSH
1535 /* Raw values of the cipher list from a client */
1536 unsigned char *ciphers_raw;
1537 size_t ciphers_rawlen;
1538 /* Temporary storage for premaster secret */
1539 unsigned char *pms;
1540 size_t pmslen;
a230b26e 1541# ifndef OPENSSL_NO_PSK
64651d39
DSH
1542 /* Temporary storage for PSK key */
1543 unsigned char *psk;
1544 size_t psklen;
a230b26e 1545# endif
93a77f9e
DSH
1546 /* Signature algorithm we actually use */
1547 const SIGALG_LOOKUP *sigalg;
a497cf25
DSH
1548 /* Pointer to certificate we use */
1549 CERT_PKEY *cert;
76106e60
DSH
1550 /*
1551 * signature algorithms peer reports: e.g. supported signature
1552 * algorithms extension for server or as part of a certificate
1553 * request for client.
c589c34e 1554 * Keep track of the algorithms for TLS and X.509 usage separately.
76106e60 1555 */
98c792d1 1556 uint16_t *peer_sigalgs;
c589c34e
BK
1557 uint16_t *peer_cert_sigalgs;
1558 /* Size of above arrays */
76106e60 1559 size_t peer_sigalgslen;
c589c34e 1560 size_t peer_cert_sigalgslen;
46f4e1be 1561 /* Sigalg peer actually uses */
f742cda8 1562 const SIGALG_LOOKUP *peer_sigalg;
6383d316
DSH
1563 /*
1564 * Set if corresponding CERT_PKEY can be used with current
1565 * SSL session: e.g. appropriate curve, signature algorithms etc.
1566 * If zero it can't be used at all.
1567 */
f7d53487 1568 uint32_t valid_flags[SSL_PKEY_NUM];
4d69f9e6
DSH
1569 /*
1570 * For servers the following masks are for the key and auth algorithms
1571 * that are supported by the certs below. For clients they are masks of
1572 * *disabled* algorithms based on the current session.
1573 */
90d9e49a
DSH
1574 uint32_t mask_k;
1575 uint32_t mask_a;
3eb2aff4
KR
1576 /*
1577 * The following are used by the client to see if a cipher is allowed or
1578 * not. It contains the minimum and maximum version the client's using
1579 * based on what it knows so far.
1580 */
1581 int min_ver;
1582 int max_ver;
b6ba4014
MC
1583 } tmp;
1584
1585 /* Connection binding to prevent renegotiation attacks */
1586 unsigned char previous_client_finished[EVP_MAX_MD_SIZE];
12472b45 1587 size_t previous_client_finished_len;
b6ba4014 1588 unsigned char previous_server_finished[EVP_MAX_MD_SIZE];
12472b45 1589 size_t previous_server_finished_len;
b6ba4014
MC
1590 int send_connection_binding; /* TODOEKR */
1591
a230b26e 1592# ifndef OPENSSL_NO_NEXTPROTONEG
b6ba4014
MC
1593 /*
1594 * Set if we saw the Next Protocol Negotiation extension from our peer.
1595 */
aff8c126 1596 int npn_seen;
a230b26e 1597# endif
b6ba4014 1598
b6ba4014
MC
1599 /*
1600 * ALPN information (we are in the process of transitioning from NPN to
1601 * ALPN.)
1602 */
1603
1604 /*
1605 * In a server these point to the selected ALPN protocol after the
1606 * ClientHello has been processed. In a client these contain the protocol
1607 * that the server selected once the ServerHello has been processed.
1608 */
1609 unsigned char *alpn_selected;
817cd0d5
TS
1610 size_t alpn_selected_len;
1611 /* used by the server to know what options were proposed */
1612 unsigned char *alpn_proposed;
1613 size_t alpn_proposed_len;
1614 /* used by the client to know if it actually sent alpn */
1615 int alpn_sent;
b6ba4014 1616
a230b26e 1617# ifndef OPENSSL_NO_EC
b6ba4014
MC
1618 /*
1619 * This is set to true if we believe that this is a version of Safari
1620 * running on OS X 10.6 or newer. We wish to know this because Safari on
1621 * 10.8 .. 10.8.3 has broken ECDHE-ECDSA support.
1622 */
1623 char is_probably_safari;
a230b26e 1624# endif /* !OPENSSL_NO_EC */
8d92c1f8
DSH
1625
1626 /* For clients: peer temporary key */
fb79abe3 1627# if !defined(OPENSSL_NO_EC) || !defined(OPENSSL_NO_DH)
bcec3358 1628 /* The group_id for the DH/ECDH key */
9e84a42d 1629 uint16_t group_id;
61dd9f7a 1630 EVP_PKEY *peer_tmp;
8d92c1f8
DSH
1631# endif
1632
b6ba4014
MC
1633} SSL3_STATE;
1634
b6ba4014
MC
1635/* DTLS structures */
1636
a230b26e
EK
1637# ifndef OPENSSL_NO_SCTP
1638# define DTLS1_SCTP_AUTH_LABEL "EXPORTER_DTLS_OVER_SCTP"
1639# endif
b6ba4014
MC
1640
1641/* Max MTU overhead we know about so far is 40 for IPv6 + 8 for UDP */
a230b26e 1642# define DTLS1_MAX_MTU_OVERHEAD 48
b6ba4014 1643
e3d0dae7
MC
1644/*
1645 * Flag used in message reuse to indicate the buffer contains the record
436ad81f 1646 * header as well as the handshake message header.
e3d0dae7 1647 */
a230b26e 1648# define DTLS1_SKIP_RECORD_HEADER 2
e3d0dae7 1649
b6ba4014
MC
1650struct dtls1_retransmit_state {
1651 EVP_CIPHER_CTX *enc_write_ctx; /* cryptographic state */
1652 EVP_MD_CTX *write_hash; /* used for mac generation */
b6ba4014 1653 COMP_CTX *compress; /* compression */
b6ba4014
MC
1654 SSL_SESSION *session;
1655 unsigned short epoch;
1656};
1657
1658struct hm_header_st {
1659 unsigned char type;
7ee8627f 1660 size_t msg_len;
b6ba4014 1661 unsigned short seq;
7ee8627f
MC
1662 size_t frag_off;
1663 size_t frag_len;
b6ba4014
MC
1664 unsigned int is_ccs;
1665 struct dtls1_retransmit_state saved_retransmit_state;
1666};
1667
b6ba4014
MC
1668struct dtls1_timeout_st {
1669 /* Number of read timeouts so far */
1670 unsigned int read_timeouts;
1671 /* Number of write timeouts so far */
1672 unsigned int write_timeouts;
1673 /* Number of alerts received so far */
1674 unsigned int num_alerts;
1675};
1676
b6ba4014
MC
1677typedef struct hm_fragment_st {
1678 struct hm_header_st msg_header;
1679 unsigned char *fragment;
1680 unsigned char *reassembly;
1681} hm_fragment;
1682
cf2cede4
RS
1683typedef struct pqueue_st pqueue;
1684typedef struct pitem_st pitem;
1685
1686struct pitem_st {
1687 unsigned char priority[8]; /* 64-bit value in big-endian encoding */
1688 void *data;
1689 pitem *next;
1690};
1691
1692typedef struct pitem_st *piterator;
1693
1694pitem *pitem_new(unsigned char *prio64be, void *data);
1695void pitem_free(pitem *item);
a230b26e 1696pqueue *pqueue_new(void);
cf2cede4
RS
1697void pqueue_free(pqueue *pq);
1698pitem *pqueue_insert(pqueue *pq, pitem *item);
1699pitem *pqueue_peek(pqueue *pq);
1700pitem *pqueue_pop(pqueue *pq);
1701pitem *pqueue_find(pqueue *pq, unsigned char *prio64be);
1702pitem *pqueue_iterator(pqueue *pq);
1703pitem *pqueue_next(piterator *iter);
8b0e934a 1704size_t pqueue_size(pqueue *pq);
cf2cede4 1705
b6ba4014 1706typedef struct dtls1_state_st {
b6ba4014 1707 unsigned char cookie[DTLS1_COOKIE_LENGTH];
cb150cbc 1708 size_t cookie_len;
e27f234a 1709 unsigned int cookie_verified;
b6ba4014
MC
1710 /* handshake message numbers */
1711 unsigned short handshake_write_seq;
1712 unsigned short next_handshake_write_seq;
1713 unsigned short handshake_read_seq;
b6ba4014 1714 /* Buffered handshake messages */
cf2cede4 1715 pqueue *buffered_messages;
b6ba4014 1716 /* Buffered (sent) handshake records */
cf2cede4 1717 pqueue *sent_messages;
7ee8627f
MC
1718 size_t link_mtu; /* max on-the-wire DTLS packet size */
1719 size_t mtu; /* max DTLS packet size */
b6ba4014
MC
1720 struct hm_header_st w_msg_hdr;
1721 struct hm_header_st r_msg_hdr;
1722 struct dtls1_timeout_st timeout;
1723 /*
e72040c1 1724 * Indicates when the last handshake msg sent will timeout
b6ba4014
MC
1725 */
1726 struct timeval next_timeout;
1727 /* Timeout duration */
fa4b82cc
AH
1728 unsigned int timeout_duration_us;
1729
b6ba4014 1730 unsigned int retransmitting;
a230b26e 1731# ifndef OPENSSL_NO_SCTP
b6ba4014 1732 int shutdown_received;
a230b26e 1733# endif
fa4b82cc
AH
1734
1735 DTLS_timer_cb timer_cb;
1736
b6ba4014
MC
1737} DTLS1_STATE;
1738
0f113f3e
MC
1739# ifndef OPENSSL_NO_EC
1740/*
1741 * From ECC-TLS draft, used in encoding the curve type in ECParameters
ea262260 1742 */
0f113f3e
MC
1743# define EXPLICIT_PRIME_CURVE_TYPE 1
1744# define EXPLICIT_CHAR2_CURVE_TYPE 2
1745# define NAMED_CURVE_TYPE 3
1746# endif /* OPENSSL_NO_EC */
1747
a497cf25 1748struct cert_pkey_st {
0f113f3e
MC
1749 X509 *x509;
1750 EVP_PKEY *privatekey;
0f113f3e
MC
1751 /* Chain for this certificate */
1752 STACK_OF(X509) *chain;
50e735f9
MC
1753 /*-
1754 * serverinfo data for this certificate. The data is in TLS Extension
1755 * wire format, specifically it's a series of records like:
1756 * uint16_t extension_type; // (RFC 5246, 7.4.1.4, Extension)
1757 * uint16_t length;
1758 * uint8_t data[length];
1759 */
0f113f3e
MC
1760 unsigned char *serverinfo;
1761 size_t serverinfo_length;
a497cf25 1762};
2ea80354 1763/* Retrieve Suite B flags */
0f113f3e 1764# define tls1_suiteb(s) (s->cert->cert_flags & SSL_CERT_FLAG_SUITEB_128_LOS)
2ea80354 1765/* Uses to check strict mode: suite B modes are always strict */
0f113f3e
MC
1766# define SSL_CERT_FLAGS_CHECK_TLS_STRICT \
1767 (SSL_CERT_FLAG_SUITEB_128_LOS|SSL_CERT_FLAG_TLS_STRICT)
d02b48c6 1768
787d9ec7
MC
1769typedef enum {
1770 ENDPOINT_CLIENT = 0,
1771 ENDPOINT_SERVER,
1772 ENDPOINT_BOTH
1773} ENDPOINT;
1774
1775
b83294fe 1776typedef struct {
0f113f3e 1777 unsigned short ext_type;
787d9ec7 1778 ENDPOINT role;
43ae5eed
MC
1779 /* The context which this extension applies to */
1780 unsigned int context;
0f113f3e
MC
1781 /*
1782 * Per-connection flags relating to this extension type: not used if
1783 * part of an SSL_CTX structure.
1784 */
f7d53487 1785 uint32_t ext_flags;
cd17bb19
MC
1786 SSL_custom_ext_add_cb_ex add_cb;
1787 SSL_custom_ext_free_cb_ex free_cb;
0f113f3e 1788 void *add_arg;
cd17bb19 1789 SSL_custom_ext_parse_cb_ex parse_cb;
0f113f3e 1790 void *parse_arg;
ecf4d660 1791} custom_ext_method;
b83294fe 1792
28ea0a0c
DSH
1793/* ext_flags values */
1794
0f113f3e
MC
1795/*
1796 * Indicates an extension has been received. Used to check for unsolicited or
1797 * duplicate extensions.
28ea0a0c 1798 */
0f113f3e
MC
1799# define SSL_EXT_FLAG_RECEIVED 0x1
1800/*
1801 * Indicates an extension has been sent: used to enable sending of
1802 * corresponding ServerHello extension.
28ea0a0c 1803 */
0f113f3e 1804# define SSL_EXT_FLAG_SENT 0x2
28ea0a0c 1805
b83294fe 1806typedef struct {
0f113f3e
MC
1807 custom_ext_method *meths;
1808 size_t meths_count;
ecf4d660 1809} custom_ext_methods;
b83294fe 1810
0f113f3e
MC
1811typedef struct cert_st {
1812 /* Current active set */
1813 /*
1814 * ALWAYS points to an element of the pkeys array
1815 * Probably it would make more sense to store
1816 * an index, not a pointer.
1817 */
1818 CERT_PKEY *key;
0f113f3e 1819# ifndef OPENSSL_NO_DH
e2b420fd 1820 EVP_PKEY *dh_tmp;
0f113f3e
MC
1821 DH *(*dh_tmp_cb) (SSL *ssl, int is_export, int keysize);
1822 int dh_tmp_auto;
0f113f3e
MC
1823# endif
1824 /* Flags related to certificates */
f7d53487 1825 uint32_t cert_flags;
0f113f3e 1826 CERT_PKEY pkeys[SSL_PKEY_NUM];
75c13e78
DSH
1827 /* Custom certificate types sent in certificate request message. */
1828 uint8_t *ctype;
1829 size_t ctype_len;
0f113f3e 1830 /*
60250017 1831 * supported signature algorithms. When set on a client this is sent in
0f113f3e
MC
1832 * the client hello as the supported signature algorithms extension. For
1833 * servers it represents the signature algorithms we are willing to use.
1834 */
98c792d1 1835 uint16_t *conf_sigalgs;
0f113f3e
MC
1836 /* Size of above array */
1837 size_t conf_sigalgslen;
1838 /*
1839 * Client authentication signature algorithms, if not set then uses
1840 * conf_sigalgs. On servers these will be the signature algorithms sent
48722ff5
F
1841 * to the client in a certificate request for TLS 1.2. On a client this
1842 * represents the signature algorithms we are willing to use for client
0f113f3e
MC
1843 * authentication.
1844 */
98c792d1 1845 uint16_t *client_sigalgs;
0f113f3e
MC
1846 /* Size of above array */
1847 size_t client_sigalgslen;
1848 /*
1849 * Signature algorithms shared by client and server: cached because these
1850 * are used most often.
1851 */
4d43ee28 1852 const SIGALG_LOOKUP **shared_sigalgs;
0f113f3e
MC
1853 size_t shared_sigalgslen;
1854 /*
1855 * Certificate setup callback: if set is called whenever a certificate
1856 * may be required (client or server). the callback can then examine any
1857 * appropriate parameters and setup any certificates required. This
1858 * allows advanced applications to select certificates on the fly: for
1859 * example based on supported signature algorithms or curves.
1860 */
1861 int (*cert_cb) (SSL *ssl, void *arg);
1862 void *cert_cb_arg;
1863 /*
1864 * Optional X509_STORE for chain building or certificate validation If
1865 * NULL the parent SSL_CTX store is used instead.
1866 */
1867 X509_STORE *chain_store;
1868 X509_STORE *verify_store;
43ae5eed
MC
1869 /* Custom extensions */
1870 custom_ext_methods custext;
0f113f3e 1871 /* Security callback */
e4646a89 1872 int (*sec_cb) (const SSL *s, const SSL_CTX *ctx, int op, int bits, int nid,
0f113f3e
MC
1873 void *other, void *ex);
1874 /* Security level */
1875 int sec_level;
1876 void *sec_ex;
a230b26e 1877# ifndef OPENSSL_NO_PSK
df6da24b
DSH
1878 /* If not NULL psk identity hint to use for servers */
1879 char *psk_identity_hint;
a230b26e 1880# endif
2f545ae4 1881 CRYPTO_REF_COUNT references; /* >1 only if SSL_copy_session_id is used */
16203f7b 1882 CRYPTO_RWLOCK *lock;
0f113f3e
MC
1883} CERT;
1884
0f113f3e 1885# define FP_ICC (int (*)(const void *,const void *))
0f113f3e
MC
1886
1887/*
1888 * This is for the SSLv3/TLSv1.0 differences in crypto/hash stuff It is a bit
1889 * of a mess of functions, but hell, think of it as an opaque structure :-)
1890 */
1891typedef struct ssl3_enc_method {
72716e79 1892 int (*enc) (SSL *, SSL3_RECORD *, size_t, int);
d102d9df 1893 int (*mac) (SSL *, SSL3_RECORD *, unsigned char *, int);
0f113f3e
MC
1894 int (*setup_key_block) (SSL *);
1895 int (*generate_master_secret) (SSL *, unsigned char *, unsigned char *,
8c1a5343 1896 size_t, size_t *);
0f113f3e 1897 int (*change_cipher_state) (SSL *, int);
6db6bc5a 1898 size_t (*final_finish_mac) (SSL *, const char *, size_t, unsigned char *);
0f113f3e 1899 const char *client_finished_label;
8b0e934a 1900 size_t client_finished_label_len;
0f113f3e 1901 const char *server_finished_label;
8b0e934a 1902 size_t server_finished_label_len;
0f113f3e
MC
1903 int (*alert_value) (int);
1904 int (*export_keying_material) (SSL *, unsigned char *, size_t,
1905 const char *, size_t,
1906 const unsigned char *, size_t,
1907 int use_context);
1908 /* Various flags indicating protocol version requirements */
f7d53487 1909 uint32_t enc_flags;
0f113f3e 1910 /* Set the handshake header */
a29fa98c 1911 int (*set_handshake_header) (SSL *s, WPACKET *pkt, int type);
2c7b4dbc 1912 /* Close construction of the handshake message */
4a01c59f 1913 int (*close_construct_packet) (SSL *s, WPACKET *pkt, int htype);
0f113f3e
MC
1914 /* Write out handshake message */
1915 int (*do_write) (SSL *s);
1916} SSL3_ENC_METHOD;
1917
a29fa98c
MC
1918# define ssl_set_handshake_header(s, pkt, htype) \
1919 s->method->ssl3_enc->set_handshake_header((s), (pkt), (htype))
4a01c59f
MC
1920# define ssl_close_construct_packet(s, pkt, htype) \
1921 s->method->ssl3_enc->close_construct_packet((s), (pkt), (htype))
0f113f3e 1922# define ssl_do_write(s) s->method->ssl3_enc->do_write(s)
173e72e6
DSH
1923
1924/* Values for enc_flags */
1925
1926/* Uses explicit IV for CBC mode */
0f113f3e 1927# define SSL_ENC_FLAG_EXPLICIT_IV 0x1
173e72e6 1928/* Uses signature algorithms extension */
0f113f3e 1929# define SSL_ENC_FLAG_SIGALGS 0x2
cbd64894 1930/* Uses SHA256 default PRF */
0f113f3e 1931# define SSL_ENC_FLAG_SHA256_PRF 0x4
173e72e6 1932/* Is DTLS */
0f113f3e
MC
1933# define SSL_ENC_FLAG_DTLS 0x8
1934/*
1935 * Allow TLS 1.2 ciphersuites: applies to DTLS 1.2 as well as TLS 1.2: may
1936 * apply to others in future.
4221c0dd 1937 */
0f113f3e 1938# define SSL_ENC_FLAG_TLS1_2_CIPHERS 0x10
173e72e6 1939
0f113f3e 1940# ifndef OPENSSL_NO_COMP
651d0aff 1941/* Used for holding the relevant compression methods loaded into SSL_CTX */
0f113f3e
MC
1942typedef struct ssl3_comp_st {
1943 int comp_id; /* The identifier byte for this compression
1944 * type */
1945 char *name; /* Text name used for the compression type */
1946 COMP_METHOD *method; /* The method :-) */
1947} SSL3_COMP;
1948# endif
dfeab068 1949
f7f2a01d
MC
1950typedef enum downgrade_en {
1951 DOWNGRADE_NONE,
1952 DOWNGRADE_TO_1_2,
1953 DOWNGRADE_TO_1_1
1954} DOWNGRADE;
1955
cbb09544
MC
1956/*
1957 * Dummy status type for the status_type extension. Indicates no status type
1958 * set
1959 */
1960#define TLSEXT_STATUSTYPE_nothing -1
1961
703bcee0
MC
1962/* Sigalgs values */
1963#define TLSEXT_SIGALG_ecdsa_secp256r1_sha256 0x0403
1964#define TLSEXT_SIGALG_ecdsa_secp384r1_sha384 0x0503
1965#define TLSEXT_SIGALG_ecdsa_secp521r1_sha512 0x0603
d8311fc9 1966#define TLSEXT_SIGALG_ecdsa_sha224 0x0303
703bcee0 1967#define TLSEXT_SIGALG_ecdsa_sha1 0x0203
f55e99f7
BK
1968#define TLSEXT_SIGALG_rsa_pss_rsae_sha256 0x0804
1969#define TLSEXT_SIGALG_rsa_pss_rsae_sha384 0x0805
1970#define TLSEXT_SIGALG_rsa_pss_rsae_sha512 0x0806
1971#define TLSEXT_SIGALG_rsa_pss_pss_sha256 0x0809
1972#define TLSEXT_SIGALG_rsa_pss_pss_sha384 0x080a
1973#define TLSEXT_SIGALG_rsa_pss_pss_sha512 0x080b
703bcee0
MC
1974#define TLSEXT_SIGALG_rsa_pkcs1_sha256 0x0401
1975#define TLSEXT_SIGALG_rsa_pkcs1_sha384 0x0501
1976#define TLSEXT_SIGALG_rsa_pkcs1_sha512 0x0601
d8311fc9 1977#define TLSEXT_SIGALG_rsa_pkcs1_sha224 0x0301
703bcee0
MC
1978#define TLSEXT_SIGALG_rsa_pkcs1_sha1 0x0201
1979#define TLSEXT_SIGALG_dsa_sha256 0x0402
1980#define TLSEXT_SIGALG_dsa_sha384 0x0502
1981#define TLSEXT_SIGALG_dsa_sha512 0x0602
d8311fc9 1982#define TLSEXT_SIGALG_dsa_sha224 0x0302
703bcee0
MC
1983#define TLSEXT_SIGALG_dsa_sha1 0x0202
1984#define TLSEXT_SIGALG_gostr34102012_256_gostr34112012_256 0xeeee
1985#define TLSEXT_SIGALG_gostr34102012_512_gostr34112012_512 0xefef
1986#define TLSEXT_SIGALG_gostr34102001_gostr3411 0xeded
1987
3d234c9e 1988#define TLSEXT_SIGALG_ed25519 0x0807
0e1d6ecf 1989#define TLSEXT_SIGALG_ed448 0x0808
3d234c9e 1990
b2f7e8c0
MC
1991/* Known PSK key exchange modes */
1992#define TLSEXT_KEX_MODE_KE 0x00
1993#define TLSEXT_KEX_MODE_KE_DHE 0x01
1994
1995/*
1996 * Internal representations of key exchange modes
1997 */
1998#define TLSEXT_KEX_MODE_FLAG_NONE 0
1999#define TLSEXT_KEX_MODE_FLAG_KE 1
2000#define TLSEXT_KEX_MODE_FLAG_KE_DHE 2
2001
ec15acb6
MC
2002/* An invalid index into the TLSv1.3 PSK identities */
2003#define TLSEXT_PSK_BAD_IDENTITY -1
2004
f742cda8
DSH
2005#define SSL_USE_PSS(s) (s->s3->tmp.peer_sigalg != NULL && \
2006 s->s3->tmp.peer_sigalg->sig == EVP_PKEY_RSA_PSS)
fe3066ee 2007
703bcee0
MC
2008/* A dummy signature value not valid for TLSv1.2 signature algs */
2009#define TLSEXT_signature_rsa_pss 0x0101
2010
643a3580
MC
2011/* TLSv1.3 downgrade protection sentinel values */
2012extern const unsigned char tls11downgrade[8];
2013extern const unsigned char tls12downgrade[8];
703bcee0 2014
3ed449e9 2015extern SSL3_ENC_METHOD ssl3_undef_enc_method;
7d7d2cbc 2016
2b8fa1d5
KR
2017__owur const SSL_METHOD *ssl_bad_method(int ver);
2018__owur const SSL_METHOD *sslv3_method(void);
2019__owur const SSL_METHOD *sslv3_server_method(void);
2020__owur const SSL_METHOD *sslv3_client_method(void);
2021__owur const SSL_METHOD *tlsv1_method(void);
2022__owur const SSL_METHOD *tlsv1_server_method(void);
2023__owur const SSL_METHOD *tlsv1_client_method(void);
2024__owur const SSL_METHOD *tlsv1_1_method(void);
2025__owur const SSL_METHOD *tlsv1_1_server_method(void);
2026__owur const SSL_METHOD *tlsv1_1_client_method(void);
2027__owur const SSL_METHOD *tlsv1_2_method(void);
2028__owur const SSL_METHOD *tlsv1_2_server_method(void);
2029__owur const SSL_METHOD *tlsv1_2_client_method(void);
582a17d6
MC
2030__owur const SSL_METHOD *tlsv1_3_method(void);
2031__owur const SSL_METHOD *tlsv1_3_server_method(void);
2032__owur const SSL_METHOD *tlsv1_3_client_method(void);
2b8fa1d5
KR
2033__owur const SSL_METHOD *dtlsv1_method(void);
2034__owur const SSL_METHOD *dtlsv1_server_method(void);
2035__owur const SSL_METHOD *dtlsv1_client_method(void);
032924c4 2036__owur const SSL_METHOD *dtls_bad_ver_client_method(void);
2b8fa1d5
KR
2037__owur const SSL_METHOD *dtlsv1_2_method(void);
2038__owur const SSL_METHOD *dtlsv1_2_server_method(void);
2039__owur const SSL_METHOD *dtlsv1_2_client_method(void);
d02b48c6 2040
161e0a61
BL
2041extern const SSL3_ENC_METHOD TLSv1_enc_data;
2042extern const SSL3_ENC_METHOD TLSv1_1_enc_data;
2043extern const SSL3_ENC_METHOD TLSv1_2_enc_data;
582a17d6 2044extern const SSL3_ENC_METHOD TLSv1_3_enc_data;
8892ce77
BL
2045extern const SSL3_ENC_METHOD SSLv3_enc_data;
2046extern const SSL3_ENC_METHOD DTLSv1_enc_data;
2047extern const SSL3_ENC_METHOD DTLSv1_2_enc_data;
f3b656b2 2048
4fa52141
VD
2049/*
2050 * Flags for SSL methods
2051 */
a230b26e
EK
2052# define SSL_METHOD_NO_FIPS (1U<<0)
2053# define SSL_METHOD_NO_SUITEB (1U<<1)
4fa52141
VD
2054
2055# define IMPLEMENT_tls_meth_func(version, flags, mask, func_name, s_accept, \
ccae4a15 2056 s_connect, enc_data) \
4ebb342f 2057const SSL_METHOD *func_name(void) \
0f113f3e
MC
2058 { \
2059 static const SSL_METHOD func_name##_data= { \
2060 version, \
4fa52141
VD
2061 flags, \
2062 mask, \
0f113f3e
MC
2063 tls1_new, \
2064 tls1_clear, \
2065 tls1_free, \
2066 s_accept, \
2067 s_connect, \
2068 ssl3_read, \
2069 ssl3_peek, \
2070 ssl3_write, \
2071 ssl3_shutdown, \
2072 ssl3_renegotiate, \
2073 ssl3_renegotiate_check, \
0f113f3e
MC
2074 ssl3_read_bytes, \
2075 ssl3_write_bytes, \
2076 ssl3_dispatch_alert, \
2077 ssl3_ctrl, \
2078 ssl3_ctx_ctrl, \
2079 ssl3_get_cipher_by_char, \
2080 ssl3_put_cipher_by_char, \
2081 ssl3_pending, \
2082 ssl3_num_ciphers, \
2083 ssl3_get_cipher, \
0f113f3e
MC
2084 tls1_default_timeout, \
2085 &enc_data, \
2086 ssl_undefined_void_function, \
2087 ssl3_callback_ctrl, \
2088 ssl3_ctx_callback_ctrl, \
2089 }; \
2090 return &func_name##_data; \
2091 }
2092
ccae4a15 2093# define IMPLEMENT_ssl3_meth_func(func_name, s_accept, s_connect) \
4ebb342f 2094const SSL_METHOD *func_name(void) \
0f113f3e
MC
2095 { \
2096 static const SSL_METHOD func_name##_data= { \
2097 SSL3_VERSION, \
4fa52141
VD
2098 SSL_METHOD_NO_FIPS | SSL_METHOD_NO_SUITEB, \
2099 SSL_OP_NO_SSLv3, \
0f113f3e
MC
2100 ssl3_new, \
2101 ssl3_clear, \
2102 ssl3_free, \
2103 s_accept, \
2104 s_connect, \
2105 ssl3_read, \
2106 ssl3_peek, \
2107 ssl3_write, \
2108 ssl3_shutdown, \
2109 ssl3_renegotiate, \
2110 ssl3_renegotiate_check, \
0f113f3e
MC
2111 ssl3_read_bytes, \
2112 ssl3_write_bytes, \
2113 ssl3_dispatch_alert, \
2114 ssl3_ctrl, \
2115 ssl3_ctx_ctrl, \
2116 ssl3_get_cipher_by_char, \
2117 ssl3_put_cipher_by_char, \
2118 ssl3_pending, \
2119 ssl3_num_ciphers, \
2120 ssl3_get_cipher, \
0f113f3e
MC
2121 ssl3_default_timeout, \
2122 &SSLv3_enc_data, \
2123 ssl_undefined_void_function, \
2124 ssl3_callback_ctrl, \
2125 ssl3_ctx_callback_ctrl, \
2126 }; \
2127 return &func_name##_data; \
2128 }
2129
4fa52141 2130# define IMPLEMENT_dtls1_meth_func(version, flags, mask, func_name, s_accept, \
ccae4a15 2131 s_connect, enc_data) \
4ebb342f 2132const SSL_METHOD *func_name(void) \
0f113f3e
MC
2133 { \
2134 static const SSL_METHOD func_name##_data= { \
2135 version, \
4fa52141
VD
2136 flags, \
2137 mask, \
0f113f3e
MC
2138 dtls1_new, \
2139 dtls1_clear, \
2140 dtls1_free, \
2141 s_accept, \
2142 s_connect, \
2143 ssl3_read, \
2144 ssl3_peek, \
2145 ssl3_write, \
2146 dtls1_shutdown, \
2147 ssl3_renegotiate, \
2148 ssl3_renegotiate_check, \
0f113f3e
MC
2149 dtls1_read_bytes, \
2150 dtls1_write_app_data_bytes, \
2151 dtls1_dispatch_alert, \
2152 dtls1_ctrl, \
2153 ssl3_ctx_ctrl, \
2154 ssl3_get_cipher_by_char, \
2155 ssl3_put_cipher_by_char, \
2156 ssl3_pending, \
2157 ssl3_num_ciphers, \
ca3895f0 2158 ssl3_get_cipher, \
0f113f3e
MC
2159 dtls1_default_timeout, \
2160 &enc_data, \
2161 ssl_undefined_void_function, \
2162 ssl3_callback_ctrl, \
2163 ssl3_ctx_callback_ctrl, \
2164 }; \
2165 return &func_name##_data; \
2166 }
2167
2168struct openssl_ssl_test_functions {
46417569 2169 int (*p_ssl_init_wbio_buffer) (SSL *s);
0f113f3e 2170 int (*p_ssl3_setup_buffers) (SSL *s);
0f113f3e
MC
2171};
2172
3eb2aff4 2173const char *ssl_protocol_to_string(int version);
7d650072 2174
4020c0b3
DSH
2175/* Returns true if certificate and private key for 'idx' are present */
2176static ossl_inline int ssl_has_cert(const SSL *s, int idx)
2177{
2178 if (idx < 0 || idx >= SSL_PKEY_NUM)
2179 return 0;
2180 return s->cert->pkeys[idx].x509 != NULL
2181 && s->cert->pkeys[idx].privatekey != NULL;
2182}
2183
ff6d20a6
DSH
2184static ossl_inline void tls1_get_peer_groups(SSL *s, const uint16_t **pgroups,
2185 size_t *pgroupslen)
2186{
2187 *pgroups = s->session->ext.supportedgroups;
2188 *pgroupslen = s->session->ext.supportedgroups_len;
2189}
2190
0f113f3e 2191# ifndef OPENSSL_UNIT_TEST
e0fc7961 2192
4ee7d3f9
KR
2193__owur int ssl_read_internal(SSL *s, void *buf, size_t num, size_t *readbytes);
2194__owur int ssl_write_internal(SSL *s, const void *buf, size_t num, size_t *written);
d02b48c6
RE
2195void ssl_clear_cipher_ctx(SSL *s);
2196int ssl_clear_bad_session(SSL *s);
4bcdb4a6
MC
2197__owur CERT *ssl_cert_new(void);
2198__owur CERT *ssl_cert_dup(CERT *cert);
a5ee80b9 2199void ssl_cert_clear_certs(CERT *c);
d02b48c6 2200void ssl_cert_free(CERT *c);
a84e5c9a 2201__owur int ssl_generate_session_id(SSL *s, SSL_SESSION *ss);
4bcdb4a6 2202__owur int ssl_get_new_session(SSL *s, int session);
f63a17d6 2203__owur int ssl_get_prev_session(SSL *s, CLIENTHELLO_MSG *hello);
98ece4ee 2204__owur SSL_SESSION *ssl_session_dup(SSL_SESSION *src, int ticket);
4bcdb4a6 2205__owur int ssl_cipher_id_cmp(const SSL_CIPHER *a, const SSL_CIPHER *b);
0f113f3e 2206DECLARE_OBJ_BSEARCH_GLOBAL_CMP_FN(SSL_CIPHER, SSL_CIPHER, ssl_cipher_id);
4bcdb4a6 2207__owur int ssl_cipher_ptr_id_cmp(const SSL_CIPHER *const *ap,
a230b26e 2208 const SSL_CIPHER *const *bp);
f865b081
MC
2209__owur STACK_OF(SSL_CIPHER) *ssl_create_cipher_list(const SSL_METHOD *ssl_method,
2210 STACK_OF(SSL_CIPHER) *tls13_ciphersuites,
2211 STACK_OF(SSL_CIPHER) **cipher_list,
2212 STACK_OF(SSL_CIPHER) **cipher_list_by_id,
a230b26e
EK
2213 const char *rule_str,
2214 CERT *c);
f63a17d6 2215__owur int ssl_cache_cipherlist(SSL *s, PACKET *cipher_suites, int sslv2format);
90134d98
BK
2216__owur int bytes_to_cipher_list(SSL *s, PACKET *cipher_suites,
2217 STACK_OF(SSL_CIPHER) **skp,
2218 STACK_OF(SSL_CIPHER) **scsvs, int sslv2format,
f63a17d6 2219 int fatal);
d02b48c6 2220void ssl_update_cache(SSL *s, int mode);
4bcdb4a6 2221__owur int ssl_cipher_get_evp(const SSL_SESSION *s, const EVP_CIPHER **enc,
a230b26e 2222 const EVP_MD **md, int *mac_pkey_type,
8c1a5343 2223 size_t *mac_secret_size, SSL_COMP **comp,
a230b26e 2224 int use_etm);
045bd047
DW
2225__owur int ssl_cipher_get_overhead(const SSL_CIPHER *c, size_t *mac_overhead,
2226 size_t *int_overhead, size_t *blocksize,
2227 size_t *ext_overhead);
c04cd728 2228__owur int ssl_cert_is_disabled(size_t idx);
a230b26e 2229__owur const SSL_CIPHER *ssl_get_cipher_by_char(SSL *ssl,
60d685d1
BK
2230 const unsigned char *ptr,
2231 int all);
4bcdb4a6
MC
2232__owur int ssl_cert_set0_chain(SSL *s, SSL_CTX *ctx, STACK_OF(X509) *chain);
2233__owur int ssl_cert_set1_chain(SSL *s, SSL_CTX *ctx, STACK_OF(X509) *chain);
2234__owur int ssl_cert_add0_chain_cert(SSL *s, SSL_CTX *ctx, X509 *x);
2235__owur int ssl_cert_add1_chain_cert(SSL *s, SSL_CTX *ctx, X509 *x);
2236__owur int ssl_cert_select_current(CERT *c, X509 *x);
2237__owur int ssl_cert_set_current(CERT *c, long arg);
a230b26e 2238void ssl_cert_set_cert_cb(CERT *c, int (*cb) (SSL *ssl, void *arg), void *arg);
f71c6e52 2239
4bcdb4a6 2240__owur int ssl_verify_cert_chain(SSL *s, STACK_OF(X509) *sk);
4bcdb4a6 2241__owur int ssl_build_cert_chain(SSL *s, SSL_CTX *ctx, int flags);
a230b26e
EK
2242__owur int ssl_cert_set_cert_store(CERT *c, X509_STORE *store, int chain,
2243 int ref);
b362ccab 2244
e4646a89 2245__owur int ssl_security(const SSL *s, int op, int bits, int nid, void *other);
a230b26e
EK
2246__owur int ssl_ctx_security(const SSL_CTX *ctx, int op, int bits, int nid,
2247 void *other);
b362ccab 2248
c04cd728
DSH
2249__owur const SSL_CERT_LOOKUP *ssl_cert_lookup_by_pkey(const EVP_PKEY *pk,
2250 size_t *pidx);
2251__owur const SSL_CERT_LOOKUP *ssl_cert_lookup_by_idx(size_t idx);
2252
d02b48c6 2253int ssl_undefined_function(SSL *s);
4bcdb4a6
MC
2254__owur int ssl_undefined_void_function(void);
2255__owur int ssl_undefined_const_function(const SSL *s);
a230b26e
EK
2256__owur int ssl_get_server_cert_serverinfo(SSL *s,
2257 const unsigned char **serverinfo,
2258 size_t *serverinfo_length);
2cf28d61 2259void ssl_set_masks(SSL *s);
4bcdb4a6
MC
2260__owur STACK_OF(SSL_CIPHER) *ssl_get_ciphers_by_id(SSL *s);
2261__owur int ssl_verify_alarm_type(long type);
748f2546 2262void ssl_sort_cipher_list(void);
380a522f 2263int ssl_load_ciphers(void);
a230b26e 2264__owur int ssl_fill_hello_random(SSL *s, int server, unsigned char *field,
f7f2a01d 2265 size_t len, DOWNGRADE dgrd);
57b272b0
DSH
2266__owur int ssl_generate_master_secret(SSL *s, unsigned char *pms, size_t pmslen,
2267 int free_pms);
0a699a07 2268__owur EVP_PKEY *ssl_generate_pkey(EVP_PKEY *pm);
0f1e51ea
MC
2269__owur int ssl_derive(SSL *s, EVP_PKEY *privkey, EVP_PKEY *pubkey,
2270 int genmaster);
6c4e6670 2271__owur EVP_PKEY *ssl_dh_to_pkey(DH *dh);
cf72c757
F
2272__owur unsigned int ssl_get_max_send_fragment(const SSL *ssl);
2273__owur unsigned int ssl_get_split_send_fragment(const SSL *ssl);
d02b48c6 2274
ec15acb6 2275__owur const SSL_CIPHER *ssl3_get_cipher_by_id(uint32_t id);
bbb4ceb8 2276__owur const SSL_CIPHER *ssl3_get_cipher_by_std_name(const char *stdname);
4bcdb4a6 2277__owur const SSL_CIPHER *ssl3_get_cipher_by_char(const unsigned char *p);
ae2f7b37 2278__owur int ssl3_put_cipher_by_char(const SSL_CIPHER *c, WPACKET *pkt,
2c7b4dbc 2279 size_t *len);
2c4a056f 2280int ssl3_init_finished_mac(SSL *s);
4bcdb4a6 2281__owur int ssl3_setup_key_block(SSL *s);
4bcdb4a6 2282__owur int ssl3_change_cipher_state(SSL *s, int which);
d02b48c6 2283void ssl3_cleanup_key_block(SSL *s);
4bcdb4a6 2284__owur int ssl3_do_write(SSL *s, int type);
0f113f3e 2285int ssl3_send_alert(SSL *s, int level, int desc);
4bcdb4a6 2286__owur int ssl3_generate_master_secret(SSL *s, unsigned char *out,
8c1a5343
MC
2287 unsigned char *p, size_t len,
2288 size_t *secret_size);
28ff8ef3 2289__owur int ssl3_get_req_cert_type(SSL *s, WPACKET *pkt);
4bcdb4a6
MC
2290__owur int ssl3_num_ciphers(void);
2291__owur const SSL_CIPHER *ssl3_get_cipher(unsigned int u);
0f113f3e 2292int ssl3_renegotiate(SSL *ssl);
c7f47786 2293int ssl3_renegotiate_check(SSL *ssl, int initok);
4bcdb4a6 2294__owur int ssl3_dispatch_alert(SSL *s);
6db6bc5a 2295__owur size_t ssl3_final_finish_mac(SSL *s, const char *sender, size_t slen,
12472b45 2296 unsigned char *p);
7ee8627f 2297__owur int ssl3_finish_mac(SSL *s, const unsigned char *buf, size_t len);
81025661 2298void ssl3_free_digest_list(SSL *s);
7cea05dc 2299__owur unsigned long ssl3_output_cert_chain(SSL *s, WPACKET *pkt,
f63a17d6 2300 CERT_PKEY *cpk);
4a640fb6
DSH
2301__owur const SSL_CIPHER *ssl3_choose_cipher(SSL *ssl,
2302 STACK_OF(SSL_CIPHER) *clnt,
2303 STACK_OF(SSL_CIPHER) *srvr);
124037fd 2304__owur int ssl3_digest_cached_records(SSL *s, int keep);
4bcdb4a6 2305__owur int ssl3_new(SSL *s);
0f113f3e 2306void ssl3_free(SSL *s);
54105ddd
MC
2307__owur int ssl3_read(SSL *s, void *buf, size_t len, size_t *readbytes);
2308__owur int ssl3_peek(SSL *s, void *buf, size_t len, size_t *readbytes);
7ee8627f 2309__owur int ssl3_write(SSL *s, const void *buf, size_t len, size_t *written);
4bcdb4a6 2310__owur int ssl3_shutdown(SSL *s);
b77f3ed1 2311int ssl3_clear(SSL *s);
4bcdb4a6
MC
2312__owur long ssl3_ctrl(SSL *s, int cmd, long larg, void *parg);
2313__owur long ssl3_ctx_ctrl(SSL_CTX *s, int cmd, long larg, void *parg);
2314__owur long ssl3_callback_ctrl(SSL *s, int cmd, void (*fp) (void));
2315__owur long ssl3_ctx_callback_ctrl(SSL_CTX *s, int cmd, void (*fp) (void));
d02b48c6 2316
4bcdb4a6
MC
2317__owur int ssl3_do_change_cipher_spec(SSL *ssl);
2318__owur long ssl3_default_timeout(void);
f3b656b2 2319
a29fa98c 2320__owur int ssl3_set_handshake_header(SSL *s, WPACKET *pkt, int htype);
4a01c59f 2321__owur int tls_close_construct_packet(SSL *s, WPACKET *pkt, int htype);
c7f47786 2322__owur int tls_setup_handshake(SSL *s);
a29fa98c 2323__owur int dtls1_set_handshake_header(SSL *s, WPACKET *pkt, int htype);
4a01c59f 2324__owur int dtls1_close_construct_packet(SSL *s, WPACKET *pkt, int htype);
4bcdb4a6
MC
2325__owur int ssl3_handshake_write(SSL *s);
2326
4bcdb4a6
MC
2327__owur int ssl_allow_compression(SSL *s);
2328
ccae4a15
FI
2329__owur int ssl_version_supported(const SSL *s, int version);
2330
4fa52141
VD
2331__owur int ssl_set_client_hello_version(SSL *s);
2332__owur int ssl_check_version_downgrade(SSL *s);
2333__owur int ssl_set_version_bound(int method_version, int version, int *bound);
f7f2a01d
MC
2334__owur int ssl_choose_server_version(SSL *s, CLIENTHELLO_MSG *hello,
2335 DOWNGRADE *dgrd);
88050dd1
MC
2336__owur int ssl_choose_client_version(SSL *s, int version,
2337 RAW_EXTENSION *extensions);
1d0c08b4
MC
2338__owur int ssl_get_min_max_version(const SSL *s, int *min_version,
2339 int *max_version);
4fa52141 2340
4bcdb4a6
MC
2341__owur long tls1_default_timeout(void);
2342__owur int dtls1_do_write(SSL *s, int type);
4bcdb4a6 2343void dtls1_set_message_header(SSL *s,
a773b52a 2344 unsigned char mt,
d736bc1a
MC
2345 size_t len,
2346 size_t frag_off, size_t frag_len);
4bcdb4a6 2347
7ee8627f
MC
2348int dtls1_write_app_data_bytes(SSL *s, int type, const void *buf_, size_t len,
2349 size_t *written);
4bcdb4a6 2350
4bcdb4a6
MC
2351__owur int dtls1_read_failed(SSL *s, int code);
2352__owur int dtls1_buffer_message(SSL *s, int ccs);
a773b52a 2353__owur int dtls1_retransmit_message(SSL *s, unsigned short seq, int *found);
4bcdb4a6 2354__owur int dtls1_get_queue_priority(unsigned short seq, int is_ccs);
17dd65e6 2355int dtls1_retransmit_buffered_messages(SSL *s);
f5c7f5df
MC
2356void dtls1_clear_received_buffer(SSL *s);
2357void dtls1_clear_sent_buffer(SSL *s);
0f113f3e
MC
2358void dtls1_get_message_header(unsigned char *data,
2359 struct hm_header_st *msg_hdr);
4bcdb4a6
MC
2360__owur long dtls1_default_timeout(void);
2361__owur struct timeval *dtls1_get_timeout(SSL *s, struct timeval *timeleft);
2362__owur int dtls1_check_timeout_num(SSL *s);
2363__owur int dtls1_handle_timeout(SSL *s);
9289f21b
DSH
2364void dtls1_start_timer(SSL *s);
2365void dtls1_stop_timer(SSL *s);
4bcdb4a6 2366__owur int dtls1_is_timer_expired(SSL *s);
9289f21b 2367void dtls1_double_timeout(SSL *s);
c536b6be 2368__owur int dtls_raw_hello_verify_request(WPACKET *pkt, unsigned char *cookie,
cb150cbc 2369 size_t cookie_len);
7ee8627f 2370__owur size_t dtls1_min_mtu(SSL *s);
8a35dbb6 2371void dtls1_hm_fragment_free(hm_fragment *frag);
8ba708e5 2372__owur int dtls1_query_mtu(SSL *s);
480506bd 2373
4bcdb4a6 2374__owur int tls1_new(SSL *s);
58964a49 2375void tls1_free(SSL *s);
b77f3ed1 2376int tls1_clear(SSL *s);
58964a49 2377
4bcdb4a6 2378__owur int dtls1_new(SSL *s);
36d16f8e 2379void dtls1_free(SSL *s);
b77f3ed1 2380int dtls1_clear(SSL *s);
0f113f3e 2381long dtls1_ctrl(SSL *s, int cmd, long larg, void *parg);
4bcdb4a6 2382__owur int dtls1_shutdown(SSL *s);
36d16f8e 2383
4bcdb4a6 2384__owur int dtls1_dispatch_alert(SSL *s);
36d16f8e 2385
46417569 2386__owur int ssl_init_wbio_buffer(SSL *s);
b77f3ed1 2387int ssl_free_wbio_buffer(SSL *s);
58964a49 2388
4bcdb4a6
MC
2389__owur int tls1_change_cipher_state(SSL *s, int which);
2390__owur int tls1_setup_key_block(SSL *s);
6db6bc5a 2391__owur size_t tls1_final_finish_mac(SSL *s, const char *str, size_t slen,
12472b45 2392 unsigned char *p);
4bcdb4a6 2393__owur int tls1_generate_master_secret(SSL *s, unsigned char *out,
8c1a5343
MC
2394 unsigned char *p, size_t len,
2395 size_t *secret_size);
92760c21
MC
2396__owur int tls13_setup_key_block(SSL *s);
2397__owur size_t tls13_final_finish_mac(SSL *s, const char *str, size_t slen,
2398 unsigned char *p);
0d9824c1 2399__owur int tls13_change_cipher_state(SSL *s, int which);
c2fd15f6 2400__owur int tls13_update_key(SSL *s, int send);
ec15acb6
MC
2401__owur int tls13_hkdf_expand(SSL *s, const EVP_MD *md,
2402 const unsigned char *secret,
ace081c1 2403 const unsigned char *label, size_t labellen,
a19ae67d 2404 const unsigned char *data, size_t datalen,
ace081c1 2405 unsigned char *out, size_t outlen);
d49e23ec
MC
2406__owur int tls13_derive_key(SSL *s, const EVP_MD *md,
2407 const unsigned char *secret, unsigned char *key,
2408 size_t keylen);
2409__owur int tls13_derive_iv(SSL *s, const EVP_MD *md,
2410 const unsigned char *secret, unsigned char *iv,
2411 size_t ivlen);
ec15acb6
MC
2412__owur int tls13_derive_finishedkey(SSL *s, const EVP_MD *md,
2413 const unsigned char *secret,
2414 unsigned char *fin, size_t finlen);
2415int tls13_generate_secret(SSL *s, const EVP_MD *md,
2416 const unsigned char *prevsecret,
2417 const unsigned char *insecret,
2418 size_t insecretlen,
2419 unsigned char *outsecret);
34574f19
MC
2420__owur int tls13_generate_handshake_secret(SSL *s,
2421 const unsigned char *insecret,
2422 size_t insecretlen);
2423__owur int tls13_generate_master_secret(SSL *s, unsigned char *out,
2424 unsigned char *prev, size_t prevlen,
2425 size_t *secret_size);
4bcdb4a6 2426__owur int tls1_export_keying_material(SSL *s, unsigned char *out, size_t olen,
a230b26e
EK
2427 const char *label, size_t llen,
2428 const unsigned char *p, size_t plen,
2429 int use_context);
0ca8d1ec
MC
2430__owur int tls13_export_keying_material(SSL *s, unsigned char *out, size_t olen,
2431 const char *label, size_t llen,
2432 const unsigned char *context,
2433 size_t contextlen, int use_context);
b38ede80
TT
2434__owur int tls13_export_keying_material_early(SSL *s, unsigned char *out,
2435 size_t olen, const char *label,
2436 size_t llen,
2437 const unsigned char *context,
2438 size_t contextlen);
4bcdb4a6 2439__owur int tls1_alert_code(int code);
04904312 2440__owur int tls13_alert_code(int code);
4bcdb4a6 2441__owur int ssl3_alert_code(int code);
58964a49 2442
10bf4fc2 2443# ifndef OPENSSL_NO_EC
4bcdb4a6 2444__owur int ssl_check_srvr_ecc_cert_and_alg(X509 *x, SSL *s);
0f113f3e 2445# endif
41fdcfa7 2446
f73e07cf 2447SSL_COMP *ssl3_comp_find(STACK_OF(SSL_COMP) *sk, int n);
413c4f45 2448
0f113f3e 2449# ifndef OPENSSL_NO_EC
0dd7ba24 2450
43b95d73 2451__owur const TLS_GROUP_INFO *tls1_group_id_lookup(uint16_t curve_id);
6447e818 2452__owur int tls1_check_group_id(SSL *s, uint16_t group_id);
8841154a 2453__owur uint16_t tls1_shared_group(SSL *s, int nmatch);
9e84a42d 2454__owur int tls1_set_groups(uint16_t **pext, size_t *pextlen,
a230b26e 2455 int *curves, size_t ncurves);
9e84a42d 2456__owur int tls1_set_groups_list(uint16_t **pext, size_t *pextlen,
a230b26e 2457 const char *str);
7da160b0
MC
2458void tls1_get_formatlist(SSL *s, const unsigned char **pformats,
2459 size_t *num_formats);
4bcdb4a6 2460__owur int tls1_check_ec_tmp_key(SSL *s, unsigned long id);
f63a17d6 2461__owur EVP_PKEY *ssl_generate_pkey_group(SSL *s, uint16_t id);
612f9d22 2462__owur EVP_PKEY *ssl_generate_param_group(uint16_t id);
0f113f3e 2463# endif /* OPENSSL_NO_EC */
33273721 2464
9e84a42d 2465__owur int tls_curve_allowed(SSL *s, uint16_t curve, int op);
ff6d20a6
DSH
2466void tls1_get_supported_groups(SSL *s, const uint16_t **pgroups,
2467 size_t *pgroupslen);
6b473aca 2468
4bcdb4a6 2469__owur int tls1_set_server_sigalgs(SSL *s);
ddf6ec00 2470
df0fed9a
TS
2471__owur SSL_TICKET_RETURN tls_get_ticket_from_client(SSL *s, CLIENTHELLO_MSG *hello,
2472 SSL_SESSION **ret);
2473__owur SSL_TICKET_RETURN tls_decrypt_ticket(SSL *s, const unsigned char *etick,
2474 size_t eticklen,
2475 const unsigned char *sess_id,
2476 size_t sesslen, SSL_SESSION **psess);
1053a6e2 2477
7da160b0 2478__owur int tls_use_ticket(SSL *s);
a2f9200f 2479
90d9e49a 2480void ssl_set_sig_mask(uint32_t *pmask_a, SSL *s, int op);
a2f9200f 2481
4bcdb4a6 2482__owur int tls1_set_sigalgs_list(CERT *c, const char *str, int client);
fd5e1a8c
BK
2483__owur int tls1_set_raw_sigalgs(CERT *c, const uint16_t *psigs, size_t salglen,
2484 int client);
a230b26e
EK
2485__owur int tls1_set_sigalgs(CERT *c, const int *salg, size_t salglen,
2486 int client);
17dd65e6 2487int tls1_check_chain(SSL *s, X509 *x, EVP_PKEY *pk, STACK_OF(X509) *chain,
0f113f3e 2488 int idx);
d61ff83b 2489void tls1_set_cert_validity(SSL *s);
0f229cce 2490
a230b26e 2491# ifndef OPENSSL_NO_CT
4d482ee2 2492__owur int ssl_validate_ct(SSL *s);
a230b26e 2493# endif
ed29e82a 2494
0f113f3e 2495# ifndef OPENSSL_NO_DH
4bcdb4a6 2496__owur DH *ssl_get_auto_dh(SSL *s);
0f113f3e 2497# endif
b362ccab 2498
4bcdb4a6 2499__owur int ssl_security_cert(SSL *s, SSL_CTX *ctx, X509 *x, int vfy, int is_ee);
a230b26e
EK
2500__owur int ssl_security_cert_chain(SSL *s, STACK_OF(X509) *sk, X509 *ex,
2501 int vfy);
b362ccab 2502
f63a17d6 2503int tls_choose_sigalg(SSL *s, int fatalerrs);
93a77f9e 2504
4bcdb4a6 2505__owur EVP_MD_CTX *ssl_replace_hash(EVP_MD_CTX **hash, const EVP_MD *md);
b948e2c5 2506void ssl_clear_hash_ctx(EVP_MD_CTX **hash);
4bcdb4a6 2507__owur long ssl_get_algorithm2(SSL *s);
ae2f7b37 2508__owur int tls12_copy_sigalgs(SSL *s, WPACKET *pkt,
98c792d1 2509 const uint16_t *psig, size_t psiglen);
9e84a42d 2510__owur int tls1_save_u16(PACKET *pkt, uint16_t **pdest, size_t *pdestlen);
c589c34e 2511__owur int tls1_save_sigalgs(SSL *s, PACKET *pkt, int cert);
4bcdb4a6 2512__owur int tls1_process_sigalgs(SSL *s);
0972bc5c 2513__owur int tls1_set_peer_legacy_sigalg(SSL *s, const EVP_PKEY *pkey);
168067b6 2514__owur int tls1_lookup_md(const SIGALG_LOOKUP *lu, const EVP_MD **pmd);
98c792d1 2515__owur size_t tls12_get_psigalgs(SSL *s, int sent, const uint16_t **psigs);
f742cda8 2516__owur int tls12_check_peer_sigalg(SSL *s, uint16_t, EVP_PKEY *pkey);
1d0c08b4 2517__owur int ssl_set_client_disabled(SSL *s);
8af91fd9 2518__owur int ssl_cipher_disabled(SSL *s, const SSL_CIPHER *c, int op, int echde);
1c78c43b 2519
8c1a5343
MC
2520__owur int ssl_handshake_hash(SSL *s, unsigned char *out, size_t outlen,
2521 size_t *hashlen);
152fbc28 2522__owur const EVP_MD *ssl_md(int idx);
28ba2541
DSH
2523__owur const EVP_MD *ssl_handshake_md(SSL *s);
2524__owur const EVP_MD *ssl_prf_md(SSL *s);
48fbcbac 2525
2faa1b48
CB
2526/*
2527 * ssl_log_rsa_client_key_exchange logs |premaster| to the SSL_CTX associated
2528 * with |ssl|, if logging is enabled. It returns one on success and zero on
2529 * failure. The entry is identified by the first 8 bytes of
2530 * |encrypted_premaster|.
2531 */
2532__owur int ssl_log_rsa_client_key_exchange(SSL *ssl,
2533 const uint8_t *encrypted_premaster,
2534 size_t encrypted_premaster_len,
2535 const uint8_t *premaster,
2536 size_t premaster_len);
2537
2c7bd692
CB
2538/*
2539 * ssl_log_secret logs |secret| to the SSL_CTX associated with |ssl|, if
2540 * logging is available. It returns one on success and zero on failure. It tags
2541 * the entry with |label|.
2faa1b48 2542 */
2c7bd692
CB
2543__owur int ssl_log_secret(SSL *ssl, const char *label,
2544 const uint8_t *secret, size_t secret_len);
2545
2546#define MASTER_SECRET_LABEL "CLIENT_RANDOM"
d49e23ec 2547#define CLIENT_EARLY_LABEL "CLIENT_EARLY_TRAFFIC_SECRET"
2c7bd692
CB
2548#define CLIENT_HANDSHAKE_LABEL "CLIENT_HANDSHAKE_TRAFFIC_SECRET"
2549#define SERVER_HANDSHAKE_LABEL "SERVER_HANDSHAKE_TRAFFIC_SECRET"
2550#define CLIENT_APPLICATION_LABEL "CLIENT_TRAFFIC_SECRET_0"
2551#define SERVER_APPLICATION_LABEL "SERVER_TRAFFIC_SECRET_0"
2faa1b48 2552
2acc020b 2553/* s3_cbc.c */
4bcdb4a6 2554__owur char ssl3_cbc_record_digest_supported(const EVP_MD_CTX *ctx);
5f3d93e4
MC
2555__owur int ssl3_cbc_digest_record(const EVP_MD_CTX *ctx,
2556 unsigned char *md_out,
2557 size_t *md_out_size,
2558 const unsigned char header[13],
2559 const unsigned char *data,
2560 size_t data_plus_mac_size,
2561 size_t data_plus_mac_plus_padding_size,
2562 const unsigned char *mac_secret,
d0e7c31d 2563 size_t mac_secret_length, char is_sslv3);
0f113f3e 2564
57b272b0
DSH
2565__owur int srp_generate_server_master_secret(SSL *s);
2566__owur int srp_generate_client_master_secret(SSL *s);
a2c2e000 2567__owur int srp_verify_server_param(SSL *s);
0989790b 2568
9d75dce3
TS
2569/* statem/statem_srvr.c */
2570
2571__owur int send_certificate_request(SSL *s);
2572
43ae5eed
MC
2573/* statem/extensions_cust.c */
2574
787d9ec7
MC
2575custom_ext_method *custom_ext_find(const custom_ext_methods *exts,
2576 ENDPOINT role, unsigned int ext_type,
2577 size_t *idx);
ecf4d660 2578
28ea0a0c
DSH
2579void custom_ext_init(custom_ext_methods *meths);
2580
43ae5eed 2581__owur int custom_ext_parse(SSL *s, unsigned int context, unsigned int ext_type,
a230b26e 2582 const unsigned char *ext_data, size_t ext_size,
f63a17d6 2583 X509 *x, size_t chainidx);
43ae5eed 2584__owur int custom_ext_add(SSL *s, int context, WPACKET *pkt, X509 *x,
f63a17d6 2585 size_t chainidx, int maxversion);
a230b26e
EK
2586
2587__owur int custom_exts_copy(custom_ext_methods *dst,
2588 const custom_ext_methods *src);
21181889
MC
2589__owur int custom_exts_copy_flags(custom_ext_methods *dst,
2590 const custom_ext_methods *src);
ecf4d660
DSH
2591void custom_exts_free(custom_ext_methods *exts);
2592
b3599dbb 2593void ssl_comp_free_compression_methods_int(void);
03b0e735 2594
8a5ed9dc
TM
2595/* ssl_mcnf.c */
2596void ssl_ctx_system_config(SSL_CTX *ctx);
2597
4ee7d3f9 2598# else /* OPENSSL_UNIT_TEST */
e0fc7961 2599
0f113f3e
MC
2600# define ssl_init_wbio_buffer SSL_test_functions()->p_ssl_init_wbio_buffer
2601# define ssl3_setup_buffers SSL_test_functions()->p_ssl3_setup_buffers
c4e6fb15 2602
0f113f3e 2603# endif
e0fc7961 2604#endif