blob: cd9d4c41efe0b07c3ccc2884a4cc845b525f7c2a [file] [log] [blame]
Adam Langley95c29f32014-06-20 12:00:00 -07001/* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
2 * All rights reserved.
3 *
4 * This package is an SSL implementation written
5 * by Eric Young (eay@cryptsoft.com).
6 * The implementation was written so as to conform with Netscapes SSL.
7 *
8 * This library is free for commercial and non-commercial use as long as
9 * the following conditions are aheared to. The following conditions
10 * apply to all code found in this distribution, be it the RC4, RSA,
11 * lhash, DES, etc., code; not just the SSL code. The SSL documentation
12 * included with this distribution is covered by the same copyright terms
13 * except that the holder is Tim Hudson (tjh@cryptsoft.com).
14 *
15 * Copyright remains Eric Young's, and as such any Copyright notices in
16 * the code are not to be removed.
17 * If this package is used in a product, Eric Young should be given attribution
18 * as the author of the parts of the library used.
19 * This can be in the form of a textual message at program startup or
20 * in documentation (online or textual) provided with the package.
21 *
22 * Redistribution and use in source and binary forms, with or without
23 * modification, are permitted provided that the following conditions
24 * are met:
25 * 1. Redistributions of source code must retain the copyright
26 * notice, this list of conditions and the following disclaimer.
27 * 2. Redistributions in binary form must reproduce the above copyright
28 * notice, this list of conditions and the following disclaimer in the
29 * documentation and/or other materials provided with the distribution.
30 * 3. All advertising materials mentioning features or use of this software
31 * must display the following acknowledgement:
32 * "This product includes cryptographic software written by
33 * Eric Young (eay@cryptsoft.com)"
34 * The word 'cryptographic' can be left out if the rouines from the library
35 * being used are not cryptographic related :-).
36 * 4. If you include any Windows specific code (or a derivative thereof) from
37 * the apps directory (application code) you must include an acknowledgement:
38 * "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
39 *
40 * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
41 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
42 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
43 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
44 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
45 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
46 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
47 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
48 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
49 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
50 * SUCH DAMAGE.
51 *
52 * The licence and distribution terms for any publically available version or
53 * derivative of this code cannot be changed. i.e. this code cannot simply be
54 * copied and put under another distribution licence
55 * [including the GNU Public Licence.]
56 */
57/* ====================================================================
58 * Copyright (c) 1998-2007 The OpenSSL Project. All rights reserved.
59 *
60 * Redistribution and use in source and binary forms, with or without
61 * modification, are permitted provided that the following conditions
62 * are met:
63 *
64 * 1. Redistributions of source code must retain the above copyright
65 * notice, this list of conditions and the following disclaimer.
66 *
67 * 2. Redistributions in binary form must reproduce the above copyright
68 * notice, this list of conditions and the following disclaimer in
69 * the documentation and/or other materials provided with the
70 * distribution.
71 *
72 * 3. All advertising materials mentioning features or use of this
73 * software must display the following acknowledgment:
74 * "This product includes software developed by the OpenSSL Project
75 * for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
76 *
77 * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
78 * endorse or promote products derived from this software without
79 * prior written permission. For written permission, please contact
80 * openssl-core@openssl.org.
81 *
82 * 5. Products derived from this software may not be called "OpenSSL"
83 * nor may "OpenSSL" appear in their names without prior written
84 * permission of the OpenSSL Project.
85 *
86 * 6. Redistributions of any form whatsoever must retain the following
87 * acknowledgment:
88 * "This product includes software developed by the OpenSSL Project
89 * for use in the OpenSSL Toolkit (http://www.openssl.org/)"
90 *
91 * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
92 * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
93 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
94 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
95 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
96 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
97 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
98 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
99 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
100 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
101 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
102 * OF THE POSSIBILITY OF SUCH DAMAGE.
103 * ====================================================================
104 *
105 * This product includes cryptographic software written by Eric Young
106 * (eay@cryptsoft.com). This product includes software written by Tim
107 * Hudson (tjh@cryptsoft.com).
108 *
109 */
110/* ====================================================================
111 * Copyright 2002 Sun Microsystems, Inc. ALL RIGHTS RESERVED.
112 * ECC cipher suite support in OpenSSL originally developed by
113 * SUN MICROSYSTEMS, INC., and contributed to the OpenSSL project.
114 */
115/* ====================================================================
116 * Copyright 2005 Nokia. All rights reserved.
117 *
118 * The portions of the attached software ("Contribution") is developed by
119 * Nokia Corporation and is licensed pursuant to the OpenSSL open source
120 * license.
121 *
122 * The Contribution, originally written by Mika Kousa and Pasi Eronen of
123 * Nokia Corporation, consists of the "PSK" (Pre-Shared Key) ciphersuites
124 * support (see RFC 4279) to OpenSSL.
125 *
126 * No patent licenses or other rights except those expressly stated in
127 * the OpenSSL open source license shall be deemed granted or received
128 * expressly, by implication, estoppel, or otherwise.
129 *
130 * No assurances are provided by Nokia that the Contribution does not
131 * infringe the patent or other intellectual property rights of any third
132 * party or that the license provides you with all the necessary rights
133 * to make use of the Contribution.
134 *
135 * THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IN
136 * ADDITION TO THE DISCLAIMERS INCLUDED IN THE LICENSE, NOKIA
137 * SPECIFICALLY DISCLAIMS ANY LIABILITY FOR CLAIMS BROUGHT BY YOU OR ANY
138 * OTHER ENTITY BASED ON INFRINGEMENT OF INTELLECTUAL PROPERTY RIGHTS OR
139 * OTHERWISE. */
140
David Benjamin9e4e01e2015-09-15 01:48:04 -0400141#include <openssl/ssl.h>
142
Adam Langley95c29f32014-06-20 12:00:00 -0700143#include <assert.h>
David Benjamin93d97432016-08-08 21:22:47 -0400144#include <stdlib.h>
David Benjaminf0ae1702015-04-07 23:05:04 -0400145#include <string.h>
Adam Langley95c29f32014-06-20 12:00:00 -0700146
David Benjamin39482a12014-07-20 13:30:15 -0400147#include <openssl/bytestring.h>
David Benjamin7c6d09b2015-09-05 11:00:19 -0400148#include <openssl/crypto.h>
Adam Langley95c29f32014-06-20 12:00:00 -0700149#include <openssl/dh.h>
David Benjaminf0ae1702015-04-07 23:05:04 -0400150#include <openssl/err.h>
Adam Langley95c29f32014-06-20 12:00:00 -0700151#include <openssl/lhash.h>
152#include <openssl/mem.h>
Adam Langley95c29f32014-06-20 12:00:00 -0700153#include <openssl/rand.h>
Adam Langley95c29f32014-06-20 12:00:00 -0700154
David Benjamin2ee94aa2015-04-07 22:38:30 -0400155#include "internal.h"
David Benjamin546f1a52015-04-15 16:46:09 -0400156#include "../crypto/internal.h"
157
David Benjamin721e8b72016-08-03 13:13:17 -0400158#if defined(OPENSSL_WINDOWS)
159#include <sys/timeb.h>
160#else
161#include <sys/socket.h>
162#include <sys/time.h>
163#endif
164
Adam Langley95c29f32014-06-20 12:00:00 -0700165
David Benjamin76c2efc2015-08-31 14:24:29 -0400166/* |SSL_R_UNKNOWN_PROTOCOL| is no longer emitted, but continue to define it
David Benjamin97760d52015-07-24 23:02:49 -0400167 * to avoid downstream churn. */
David Benjamin76c2efc2015-08-31 14:24:29 -0400168OPENSSL_DECLARE_ERROR_REASON(SSL, UNKNOWN_PROTOCOL)
David Benjamin97760d52015-07-24 23:02:49 -0400169
David Benjamin311c2572016-08-17 15:54:36 -0400170/* The following errors are no longer emitted, but are used in nginx without
171 * #ifdefs. */
172OPENSSL_DECLARE_ERROR_REASON(SSL, BLOCK_CIPHER_PAD_IS_WRONG)
173OPENSSL_DECLARE_ERROR_REASON(SSL, NO_CIPHERS_SPECIFIED)
174
Adam Langleyfcf25832014-12-18 17:42:32 -0800175/* Some error codes are special. Ensure the make_errors.go script never
176 * regresses this. */
177OPENSSL_COMPILE_ASSERT(SSL_R_TLSV1_ALERT_NO_RENEGOTIATION ==
178 SSL_AD_NO_RENEGOTIATION + SSL_AD_REASON_OFFSET,
179 ssl_alert_reason_code_mismatch);
David Benjamine1136082014-09-20 12:28:58 -0400180
David Benjamin1d0a1942015-04-26 15:35:35 -0400181/* kMaxHandshakeSize is the maximum size, in bytes, of a handshake message. */
182static const size_t kMaxHandshakeSize = (1u << 24) - 1;
183
David Benjaminaa585132015-06-29 23:36:17 -0400184static CRYPTO_EX_DATA_CLASS g_ex_data_class_ssl =
185 CRYPTO_EX_DATA_CLASS_INIT_WITH_APP_DATA;
186static CRYPTO_EX_DATA_CLASS g_ex_data_class_ssl_ctx =
187 CRYPTO_EX_DATA_CLASS_INIT_WITH_APP_DATA;
David Benjamin9f33fc62015-04-15 17:29:53 -0400188
David Benjamin7c6d09b2015-09-05 11:00:19 -0400189int SSL_library_init(void) {
190 CRYPTO_library_init();
191 return 1;
192}
193
Adam Langleye976e432016-02-15 14:01:10 -0800194static uint32_t ssl_session_hash(const SSL_SESSION *sess) {
195 const uint8_t *session_id = sess->session_id;
196
197 uint8_t tmp_storage[sizeof(uint32_t)];
198 if (sess->session_id_length < sizeof(tmp_storage)) {
David Benjamin17cf2cb2016-12-13 01:07:13 -0500199 OPENSSL_memset(tmp_storage, 0, sizeof(tmp_storage));
200 OPENSSL_memcpy(tmp_storage, sess->session_id, sess->session_id_length);
Adam Langleye976e432016-02-15 14:01:10 -0800201 session_id = tmp_storage;
202 }
203
David Benjamin27bbae42015-09-13 00:54:37 -0400204 uint32_t hash =
Adam Langleye976e432016-02-15 14:01:10 -0800205 ((uint32_t)session_id[0]) |
206 ((uint32_t)session_id[1] << 8) |
207 ((uint32_t)session_id[2] << 16) |
208 ((uint32_t)session_id[3] << 24);
David Benjamin7c6d09b2015-09-05 11:00:19 -0400209
David Benjamin27bbae42015-09-13 00:54:37 -0400210 return hash;
211}
212
213/* NB: If this function (or indeed the hash function which uses a sort of
214 * coarser function than this one) is changed, ensure
215 * SSL_CTX_has_matching_session_id() is checked accordingly. It relies on being
216 * able to construct an SSL_SESSION that will collide with any existing session
217 * with a matching session ID. */
218static int ssl_session_cmp(const SSL_SESSION *a, const SSL_SESSION *b) {
219 if (a->ssl_version != b->ssl_version) {
220 return 1;
Adam Langleyfcf25832014-12-18 17:42:32 -0800221 }
Adam Langley95c29f32014-06-20 12:00:00 -0700222
David Benjamin27bbae42015-09-13 00:54:37 -0400223 if (a->session_id_length != b->session_id_length) {
224 return 1;
Adam Langleyfcf25832014-12-18 17:42:32 -0800225 }
Adam Langley95c29f32014-06-20 12:00:00 -0700226
David Benjamin17cf2cb2016-12-13 01:07:13 -0500227 return OPENSSL_memcmp(a->session_id, b->session_id, a->session_id_length);
David Benjamin27bbae42015-09-13 00:54:37 -0400228}
Adam Langley95c29f32014-06-20 12:00:00 -0700229
David Benjamin27bbae42015-09-13 00:54:37 -0400230SSL_CTX *SSL_CTX_new(const SSL_METHOD *method) {
231 SSL_CTX *ret = NULL;
232
233 if (method == NULL) {
234 OPENSSL_PUT_ERROR(SSL, SSL_R_NULL_SSL_METHOD_PASSED);
235 return NULL;
Adam Langleyfcf25832014-12-18 17:42:32 -0800236 }
Adam Langley95c29f32014-06-20 12:00:00 -0700237
David Benjamin27bbae42015-09-13 00:54:37 -0400238 if (SSL_get_ex_data_X509_STORE_CTX_idx() < 0) {
239 OPENSSL_PUT_ERROR(SSL, SSL_R_X509_VERIFICATION_SETUP_PROBLEMS);
240 goto err;
David Benjamin62fd1622015-01-11 13:30:01 -0500241 }
242
Brian Smith5ba06892016-02-07 09:36:04 -1000243 ret = OPENSSL_malloc(sizeof(SSL_CTX));
David Benjamin27bbae42015-09-13 00:54:37 -0400244 if (ret == NULL) {
245 goto err;
David Benjamin62fd1622015-01-11 13:30:01 -0500246 }
247
David Benjamin17cf2cb2016-12-13 01:07:13 -0500248 OPENSSL_memset(ret, 0, sizeof(SSL_CTX));
Adam Langley95c29f32014-06-20 12:00:00 -0700249
David Benjamin27bbae42015-09-13 00:54:37 -0400250 ret->method = method->method;
Adam Langley3509dac2017-02-01 11:59:18 -0800251 ret->x509_method = method->x509_method;
David Benjamin27bbae42015-09-13 00:54:37 -0400252
253 CRYPTO_MUTEX_init(&ret->lock);
254
255 ret->session_cache_mode = SSL_SESS_CACHE_SERVER;
256 ret->session_cache_size = SSL_SESSION_CACHE_MAX_SIZE_DEFAULT;
257
David Benjamin27bbae42015-09-13 00:54:37 -0400258 ret->session_timeout = SSL_DEFAULT_SESSION_TIMEOUT;
David Benjamin17b30832017-01-28 14:00:32 -0500259 ret->session_psk_dhe_timeout = SSL_DEFAULT_SESSION_PSK_DHE_TIMEOUT;
David Benjamin27bbae42015-09-13 00:54:37 -0400260
261 ret->references = 1;
262
263 ret->max_cert_list = SSL_MAX_CERT_LIST_DEFAULT;
264 ret->verify_mode = SSL_VERIFY_NONE;
Adam Langley3509dac2017-02-01 11:59:18 -0800265 ret->cert = ssl_cert_new(method->x509_method);
David Benjamin27bbae42015-09-13 00:54:37 -0400266 if (ret->cert == NULL) {
267 goto err;
268 }
269
270 ret->sessions = lh_SSL_SESSION_new(ssl_session_hash, ssl_session_cmp);
271 if (ret->sessions == NULL) {
272 goto err;
273 }
274 ret->cert_store = X509_STORE_new();
275 if (ret->cert_store == NULL) {
276 goto err;
277 }
278
279 ssl_create_cipher_list(ret->method, &ret->cipher_list,
Matthew Braithwaitea57dcfb2017-02-17 22:08:23 -0800280 SSL_DEFAULT_CIPHER_LIST, 1 /* strict */);
David Benjamin27bbae42015-09-13 00:54:37 -0400281 if (ret->cipher_list == NULL ||
282 sk_SSL_CIPHER_num(ret->cipher_list->ciphers) <= 0) {
283 OPENSSL_PUT_ERROR(SSL, SSL_R_LIBRARY_HAS_NO_CIPHERS);
284 goto err2;
285 }
286
287 ret->param = X509_VERIFY_PARAM_new();
288 if (!ret->param) {
289 goto err;
290 }
291
Adam Langley34b4c822017-02-02 10:57:17 -0800292 ret->client_CA = sk_CRYPTO_BUFFER_new_null();
David Benjamin27bbae42015-09-13 00:54:37 -0400293 if (ret->client_CA == NULL) {
294 goto err;
295 }
296
David Benjamin8a589332015-12-04 23:14:35 -0500297 CRYPTO_new_ex_data(&ret->ex_data);
David Benjamin27bbae42015-09-13 00:54:37 -0400298
299 ret->max_send_fragment = SSL3_RT_MAX_PLAIN_LENGTH;
300
301 /* Setup RFC4507 ticket keys */
302 if (!RAND_bytes(ret->tlsext_tick_key_name, 16) ||
303 !RAND_bytes(ret->tlsext_tick_hmac_key, 16) ||
304 !RAND_bytes(ret->tlsext_tick_aes_key, 16)) {
305 ret->options |= SSL_OP_NO_TICKET;
306 }
307
David Benjamina983b4c2016-11-09 14:21:12 -0500308 /* Disable the auto-chaining feature by default. Once this has stuck without
309 * problems, the feature will be removed entirely. */
310 ret->mode = SSL_MODE_NO_AUTO_CHAIN;
311
David Benjamin27bbae42015-09-13 00:54:37 -0400312 /* Lock the SSL_CTX to the specified version, for compatibility with legacy
313 * uses of SSL_METHOD. */
David Benjamine34bcc92016-09-21 16:53:09 -0400314 if (!SSL_CTX_set_max_proto_version(ret, method->version) ||
315 !SSL_CTX_set_min_proto_version(ret, method->version)) {
316 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
317 goto err2;
David Benjamin27bbae42015-09-13 00:54:37 -0400318 }
319
320 return ret;
321
322err:
323 OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
324err2:
325 SSL_CTX_free(ret);
326 return NULL;
327}
328
Adam Langley84cd1592016-06-30 18:29:44 -0700329int SSL_CTX_up_ref(SSL_CTX *ctx) {
330 CRYPTO_refcount_inc(&ctx->references);
331 return 1;
332}
333
David Benjamin27bbae42015-09-13 00:54:37 -0400334void SSL_CTX_free(SSL_CTX *ctx) {
335 if (ctx == NULL ||
336 !CRYPTO_refcount_dec_and_test_zero(&ctx->references)) {
337 return;
338 }
339
340 X509_VERIFY_PARAM_free(ctx->param);
341
342 /* Free internal session cache. However: the remove_cb() may reference the
343 * ex_data of SSL_CTX, thus the ex_data store can only be removed after the
344 * sessions were flushed. As the ex_data handling routines might also touch
345 * the session cache, the most secure solution seems to be: empty (flush) the
346 * cache, then free ex_data, then finally free the cache. (See ticket
347 * [openssl.org #212].) */
348 SSL_CTX_flush_sessions(ctx, 0);
349
350 CRYPTO_free_ex_data(&g_ex_data_class_ssl_ctx, ctx, &ctx->ex_data);
351
352 CRYPTO_MUTEX_cleanup(&ctx->lock);
353 lh_SSL_SESSION_free(ctx->sessions);
354 X509_STORE_free(ctx->cert_store);
355 ssl_cipher_preference_list_free(ctx->cipher_list);
David Benjamin27bbae42015-09-13 00:54:37 -0400356 ssl_cert_free(ctx->cert);
357 sk_SSL_CUSTOM_EXTENSION_pop_free(ctx->client_custom_extensions,
358 SSL_CUSTOM_EXTENSION_free);
359 sk_SSL_CUSTOM_EXTENSION_pop_free(ctx->server_custom_extensions,
360 SSL_CUSTOM_EXTENSION_free);
Adam Langley34b4c822017-02-02 10:57:17 -0800361 sk_CRYPTO_BUFFER_pop_free(ctx->client_CA, CRYPTO_BUFFER_free);
362 ctx->x509_method->ssl_ctx_flush_cached_client_CA(ctx);
David Benjamin27bbae42015-09-13 00:54:37 -0400363 sk_SRTP_PROTECTION_PROFILE_free(ctx->srtp_profiles);
364 OPENSSL_free(ctx->psk_identity_hint);
Steven Valdezce902a92016-05-17 11:47:53 -0400365 OPENSSL_free(ctx->supported_group_list);
David Benjamin27bbae42015-09-13 00:54:37 -0400366 OPENSSL_free(ctx->alpn_client_proto_list);
David Benjamin27bbae42015-09-13 00:54:37 -0400367 EVP_PKEY_free(ctx->tlsext_channel_id_private);
David Benjamin27bbae42015-09-13 00:54:37 -0400368
369 OPENSSL_free(ctx);
Adam Langleyfcf25832014-12-18 17:42:32 -0800370}
Adam Langley95c29f32014-06-20 12:00:00 -0700371
Adam Langleyfcf25832014-12-18 17:42:32 -0800372SSL *SSL_new(SSL_CTX *ctx) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800373 if (ctx == NULL) {
David Benjamin3570d732015-06-29 00:28:17 -0400374 OPENSSL_PUT_ERROR(SSL, SSL_R_NULL_SSL_CTX);
Adam Langleyfcf25832014-12-18 17:42:32 -0800375 return NULL;
376 }
377 if (ctx->method == NULL) {
David Benjamin3570d732015-06-29 00:28:17 -0400378 OPENSSL_PUT_ERROR(SSL, SSL_R_SSL_CTX_HAS_NO_DEFAULT_SSL_VERSION);
Adam Langleyfcf25832014-12-18 17:42:32 -0800379 return NULL;
380 }
Adam Langley95c29f32014-06-20 12:00:00 -0700381
Brian Smith5ba06892016-02-07 09:36:04 -1000382 SSL *ssl = OPENSSL_malloc(sizeof(SSL));
David Benjamin0d56f882015-12-19 17:05:56 -0500383 if (ssl == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800384 goto err;
385 }
David Benjamin17cf2cb2016-12-13 01:07:13 -0500386 OPENSSL_memset(ssl, 0, sizeof(SSL));
Adam Langley95c29f32014-06-20 12:00:00 -0700387
David Benjamin0d56f882015-12-19 17:05:56 -0500388 ssl->min_version = ctx->min_version;
389 ssl->max_version = ctx->max_version;
David Benjamin1eb367c2014-12-12 18:17:51 -0500390
Taylor Brandstetter376a0fe2016-05-10 19:30:28 -0700391 /* RFC 6347 states that implementations SHOULD use an initial timer value of
392 * 1 second. */
393 ssl->initial_timeout_duration_ms = 1000;
394
David Benjamin0d56f882015-12-19 17:05:56 -0500395 ssl->options = ctx->options;
396 ssl->mode = ctx->mode;
397 ssl->max_cert_list = ctx->max_cert_list;
Adam Langley95c29f32014-06-20 12:00:00 -0700398
David Benjamin0d56f882015-12-19 17:05:56 -0500399 ssl->cert = ssl_cert_dup(ctx->cert);
400 if (ssl->cert == NULL) {
David Benjamina5a3eeb2015-03-18 20:26:30 -0400401 goto err;
Adam Langleyfcf25832014-12-18 17:42:32 -0800402 }
Adam Langley95c29f32014-06-20 12:00:00 -0700403
David Benjamin0d56f882015-12-19 17:05:56 -0500404 ssl->msg_callback = ctx->msg_callback;
405 ssl->msg_callback_arg = ctx->msg_callback_arg;
406 ssl->verify_mode = ctx->verify_mode;
David Benjamin0d56f882015-12-19 17:05:56 -0500407 ssl->verify_callback = ctx->default_verify_callback;
David Benjaminbbaf3672016-11-17 10:53:09 +0900408 ssl->retain_only_sha256_of_client_certs =
409 ctx->retain_only_sha256_of_client_certs;
Adam Langley95c29f32014-06-20 12:00:00 -0700410
David Benjamin0d56f882015-12-19 17:05:56 -0500411 ssl->param = X509_VERIFY_PARAM_new();
412 if (!ssl->param) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800413 goto err;
414 }
David Benjamin0d56f882015-12-19 17:05:56 -0500415 X509_VERIFY_PARAM_inherit(ssl->param, ctx->param);
416 ssl->quiet_shutdown = ctx->quiet_shutdown;
417 ssl->max_send_fragment = ctx->max_send_fragment;
Adam Langley95c29f32014-06-20 12:00:00 -0700418
David Benjaminf650c712016-12-22 15:54:51 -0500419 SSL_CTX_up_ref(ctx);
David Benjamin0d56f882015-12-19 17:05:56 -0500420 ssl->ctx = ctx;
David Benjaminf650c712016-12-22 15:54:51 -0500421 SSL_CTX_up_ref(ctx);
David Benjamin0d56f882015-12-19 17:05:56 -0500422 ssl->initial_ctx = ctx;
Adam Langley95c29f32014-06-20 12:00:00 -0700423
Steven Valdezce902a92016-05-17 11:47:53 -0400424 if (ctx->supported_group_list) {
David Benjamin17b30832017-01-28 14:00:32 -0500425 ssl->supported_group_list = BUF_memdup(ctx->supported_group_list,
426 ctx->supported_group_list_len * 2);
Steven Valdezce902a92016-05-17 11:47:53 -0400427 if (!ssl->supported_group_list) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800428 goto err;
429 }
Steven Valdezce902a92016-05-17 11:47:53 -0400430 ssl->supported_group_list_len = ctx->supported_group_list_len;
Adam Langleyfcf25832014-12-18 17:42:32 -0800431 }
Adam Langley95c29f32014-06-20 12:00:00 -0700432
David Benjamin17b30832017-01-28 14:00:32 -0500433 if (ctx->alpn_client_proto_list) {
434 ssl->alpn_client_proto_list = BUF_memdup(ctx->alpn_client_proto_list,
435 ctx->alpn_client_proto_list_len);
David Benjamin0d56f882015-12-19 17:05:56 -0500436 if (ssl->alpn_client_proto_list == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800437 goto err;
438 }
David Benjamin17b30832017-01-28 14:00:32 -0500439 ssl->alpn_client_proto_list_len = ctx->alpn_client_proto_list_len;
Adam Langleyfcf25832014-12-18 17:42:32 -0800440 }
Adam Langley95c29f32014-06-20 12:00:00 -0700441
David Benjamin0d56f882015-12-19 17:05:56 -0500442 ssl->method = ctx->method;
Adam Langley95c29f32014-06-20 12:00:00 -0700443
David Benjamin0d56f882015-12-19 17:05:56 -0500444 if (!ssl->method->ssl_new(ssl)) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800445 goto err;
446 }
Adam Langley95c29f32014-06-20 12:00:00 -0700447
David Benjamin0d56f882015-12-19 17:05:56 -0500448 ssl->rwstate = SSL_NOTHING;
Adam Langley95c29f32014-06-20 12:00:00 -0700449
David Benjamin0d56f882015-12-19 17:05:56 -0500450 CRYPTO_new_ex_data(&ssl->ex_data);
Adam Langley95c29f32014-06-20 12:00:00 -0700451
David Benjamin0d56f882015-12-19 17:05:56 -0500452 ssl->psk_identity_hint = NULL;
Adam Langleyfcf25832014-12-18 17:42:32 -0800453 if (ctx->psk_identity_hint) {
David Benjamin0d56f882015-12-19 17:05:56 -0500454 ssl->psk_identity_hint = BUF_strdup(ctx->psk_identity_hint);
455 if (ssl->psk_identity_hint == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800456 goto err;
457 }
458 }
David Benjamin0d56f882015-12-19 17:05:56 -0500459 ssl->psk_client_callback = ctx->psk_client_callback;
460 ssl->psk_server_callback = ctx->psk_server_callback;
Adam Langley95c29f32014-06-20 12:00:00 -0700461
David Benjamin0d56f882015-12-19 17:05:56 -0500462 ssl->tlsext_channel_id_enabled = ctx->tlsext_channel_id_enabled;
David Benjamin02ddbfd2015-01-11 13:09:11 -0500463 if (ctx->tlsext_channel_id_private) {
Adam Langley310d3f62016-07-12 10:39:20 -0700464 EVP_PKEY_up_ref(ctx->tlsext_channel_id_private);
465 ssl->tlsext_channel_id_private = ctx->tlsext_channel_id_private;
David Benjamin02ddbfd2015-01-11 13:09:11 -0500466 }
467
David Benjamin17b30832017-01-28 14:00:32 -0500468 ssl->signed_cert_timestamps_enabled = ctx->signed_cert_timestamps_enabled;
469 ssl->ocsp_stapling_enabled = ctx->ocsp_stapling_enabled;
HÃ¥vard Molland9169c962014-08-14 14:42:37 +0200470
David Benjamin0d56f882015-12-19 17:05:56 -0500471 return ssl;
Adam Langleyfcf25832014-12-18 17:42:32 -0800472
Adam Langley95c29f32014-06-20 12:00:00 -0700473err:
David Benjamin0d56f882015-12-19 17:05:56 -0500474 SSL_free(ssl);
David Benjamin3570d732015-06-29 00:28:17 -0400475 OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
Adam Langley95c29f32014-06-20 12:00:00 -0700476
Adam Langleyfcf25832014-12-18 17:42:32 -0800477 return NULL;
478}
Adam Langley95c29f32014-06-20 12:00:00 -0700479
David Benjamin27bbae42015-09-13 00:54:37 -0400480void SSL_free(SSL *ssl) {
481 if (ssl == NULL) {
482 return;
483 }
484
485 X509_VERIFY_PARAM_free(ssl->param);
486
487 CRYPTO_free_ex_data(&g_ex_data_class_ssl, ssl, &ssl->ex_data);
488
David Benjamin27bbae42015-09-13 00:54:37 -0400489 BIO_free_all(ssl->rbio);
David Benjaminf715c422016-06-11 19:01:56 -0400490 BIO_free_all(ssl->wbio);
David Benjamin27bbae42015-09-13 00:54:37 -0400491
492 BUF_MEM_free(ssl->init_buf);
493
494 /* add extra stuff */
495 ssl_cipher_preference_list_free(ssl->cipher_list);
David Benjamin27bbae42015-09-13 00:54:37 -0400496
David Benjamin27bbae42015-09-13 00:54:37 -0400497 SSL_SESSION_free(ssl->session);
498
David Benjamin27bbae42015-09-13 00:54:37 -0400499 ssl_cert_free(ssl->cert);
500
501 OPENSSL_free(ssl->tlsext_hostname);
502 SSL_CTX_free(ssl->initial_ctx);
Steven Valdezce902a92016-05-17 11:47:53 -0400503 OPENSSL_free(ssl->supported_group_list);
David Benjamin27bbae42015-09-13 00:54:37 -0400504 OPENSSL_free(ssl->alpn_client_proto_list);
505 EVP_PKEY_free(ssl->tlsext_channel_id_private);
506 OPENSSL_free(ssl->psk_identity_hint);
Adam Langley34b4c822017-02-02 10:57:17 -0800507 sk_CRYPTO_BUFFER_pop_free(ssl->client_CA, CRYPTO_BUFFER_free);
508 ssl->ctx->x509_method->ssl_flush_cached_client_CA(ssl);
David Benjamin27bbae42015-09-13 00:54:37 -0400509 sk_SRTP_PROTECTION_PROFILE_free(ssl->srtp_profiles);
510
511 if (ssl->method != NULL) {
512 ssl->method->ssl_free(ssl);
513 }
514 SSL_CTX_free(ssl->ctx);
515
516 OPENSSL_free(ssl);
517}
518
519void SSL_set_connect_state(SSL *ssl) {
520 ssl->server = 0;
David Benjamin9f1dc822016-06-07 17:03:46 -0400521 ssl->handshake_func = ssl3_connect;
David Benjamin27bbae42015-09-13 00:54:37 -0400522}
523
524void SSL_set_accept_state(SSL *ssl) {
525 ssl->server = 1;
David Benjamin9f1dc822016-06-07 17:03:46 -0400526 ssl->handshake_func = ssl3_accept;
David Benjamin27bbae42015-09-13 00:54:37 -0400527}
528
David Benjamin4501bd52016-08-01 13:39:41 -0400529void SSL_set0_rbio(SSL *ssl, BIO *rbio) {
David Benjaminf715c422016-06-11 19:01:56 -0400530 BIO_free_all(ssl->rbio);
531 ssl->rbio = rbio;
532}
533
David Benjamin4501bd52016-08-01 13:39:41 -0400534void SSL_set0_wbio(SSL *ssl, BIO *wbio) {
David Benjaminf715c422016-06-11 19:01:56 -0400535 BIO_free_all(ssl->wbio);
David Benjamin27bbae42015-09-13 00:54:37 -0400536 ssl->wbio = wbio;
537}
538
David Benjaminf715c422016-06-11 19:01:56 -0400539void SSL_set_bio(SSL *ssl, BIO *rbio, BIO *wbio) {
540 /* For historical reasons, this function has many different cases in ownership
541 * handling. */
542
David Benjamin4501bd52016-08-01 13:39:41 -0400543 /* If nothing has changed, do nothing */
544 if (rbio == SSL_get_rbio(ssl) && wbio == SSL_get_wbio(ssl)) {
545 return;
546 }
547
David Benjaminf715c422016-06-11 19:01:56 -0400548 /* If the two arguments are equal, one fewer reference is granted than
549 * taken. */
550 if (rbio != NULL && rbio == wbio) {
551 BIO_up_ref(rbio);
552 }
553
David Benjamin4501bd52016-08-01 13:39:41 -0400554 /* If only the wbio is changed, adopt only one reference. */
David Benjaminf715c422016-06-11 19:01:56 -0400555 if (rbio == SSL_get_rbio(ssl)) {
David Benjamin4501bd52016-08-01 13:39:41 -0400556 SSL_set0_wbio(ssl, wbio);
David Benjaminf715c422016-06-11 19:01:56 -0400557 return;
558 }
David Benjamin4501bd52016-08-01 13:39:41 -0400559
560 /* There is an asymmetry here for historical reasons. If only the rbio is
561 * changed AND the rbio and wbio were originally different, then we only adopt
562 * one reference. */
563 if (wbio == SSL_get_wbio(ssl) && SSL_get_rbio(ssl) != SSL_get_wbio(ssl)) {
564 SSL_set0_rbio(ssl, rbio);
David Benjaminf715c422016-06-11 19:01:56 -0400565 return;
566 }
567
568 /* Otherwise, adopt both references. */
David Benjamin4501bd52016-08-01 13:39:41 -0400569 SSL_set0_rbio(ssl, rbio);
570 SSL_set0_wbio(ssl, wbio);
David Benjaminf715c422016-06-11 19:01:56 -0400571}
572
David Benjamin27bbae42015-09-13 00:54:37 -0400573BIO *SSL_get_rbio(const SSL *ssl) { return ssl->rbio; }
574
David Benjamindaf207a2017-01-03 18:37:41 -0500575BIO *SSL_get_wbio(const SSL *ssl) { return ssl->wbio; }
David Benjamin27bbae42015-09-13 00:54:37 -0400576
David Benjamin2be4aa72017-01-02 07:56:51 -0500577void ssl_reset_error_state(SSL *ssl) {
578 /* Functions which use |SSL_get_error| must reset I/O and error state on
579 * entry. */
David Benjamin4c5ddb82016-03-11 22:56:19 -0500580 ssl->rwstate = SSL_NOTHING;
David Benjamin15c14882016-03-14 14:25:46 -0400581 ERR_clear_error();
David Benjamin0d275bd2016-06-01 20:19:34 -0400582 ERR_clear_system_error();
David Benjamin2be4aa72017-01-02 07:56:51 -0500583}
584
585int SSL_do_handshake(SSL *ssl) {
586 ssl_reset_error_state(ssl);
David Benjamin15c14882016-03-14 14:25:46 -0400587
David Benjamin27bbae42015-09-13 00:54:37 -0400588 if (ssl->handshake_func == NULL) {
589 OPENSSL_PUT_ERROR(SSL, SSL_R_CONNECTION_TYPE_NOT_SET);
590 return -1;
591 }
592
593 if (!SSL_in_init(ssl)) {
594 return 1;
595 }
596
David Benjamin2644a132016-12-11 13:41:17 -0500597 if (ssl->s3->hs == NULL) {
598 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
599 return -1;
David Benjamince8c9d22016-11-14 10:45:16 +0900600 }
601
602 /* Run the handshake. */
603 assert(ssl->s3->hs != NULL);
604 int ret = ssl->handshake_func(ssl->s3->hs);
605 if (ret <= 0) {
606 return ret;
607 }
608
609 /* Destroy the handshake object if the handshake has completely finished. */
610 if (!SSL_in_init(ssl)) {
611 ssl_handshake_free(ssl->s3->hs);
612 ssl->s3->hs = NULL;
613 }
614
615 return 1;
David Benjamin27bbae42015-09-13 00:54:37 -0400616}
617
618int SSL_connect(SSL *ssl) {
David Benjaminb2a73182016-03-10 01:25:26 -0500619 if (ssl->handshake_func == NULL) {
David Benjamin27bbae42015-09-13 00:54:37 -0400620 /* Not properly initialized yet */
621 SSL_set_connect_state(ssl);
622 }
623
David Benjamin15c14882016-03-14 14:25:46 -0400624 return SSL_do_handshake(ssl);
David Benjamin27bbae42015-09-13 00:54:37 -0400625}
626
627int SSL_accept(SSL *ssl) {
David Benjaminb2a73182016-03-10 01:25:26 -0500628 if (ssl->handshake_func == NULL) {
David Benjamin27bbae42015-09-13 00:54:37 -0400629 /* Not properly initialized yet */
630 SSL_set_accept_state(ssl);
631 }
632
David Benjamin15c14882016-03-14 14:25:46 -0400633 return SSL_do_handshake(ssl);
David Benjamin27bbae42015-09-13 00:54:37 -0400634}
635
David Benjamin163f29a2016-07-28 11:05:58 -0400636static int ssl_do_renegotiate(SSL *ssl) {
David Benjamin34941c02016-10-08 11:45:31 -0400637 /* We do not accept renegotiations as a server or SSL 3.0. SSL 3.0 will be
638 * removed entirely in the future and requires retaining more data for
639 * renegotiation_info. */
640 if (ssl->server || ssl->version == SSL3_VERSION) {
David Benjamin163f29a2016-07-28 11:05:58 -0400641 goto no_renegotiation;
642 }
643
644 if (ssl->s3->tmp.message_type != SSL3_MT_HELLO_REQUEST ||
645 ssl->init_num != 0) {
646 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_DECODE_ERROR);
647 OPENSSL_PUT_ERROR(SSL, SSL_R_BAD_HELLO_REQUEST);
648 return 0;
649 }
650
651 switch (ssl->renegotiate_mode) {
652 case ssl_renegotiate_ignore:
653 /* Ignore the HelloRequest. */
654 return 1;
655
656 case ssl_renegotiate_once:
657 if (ssl->s3->total_renegotiations != 0) {
658 goto no_renegotiation;
659 }
660 break;
661
662 case ssl_renegotiate_never:
663 goto no_renegotiation;
664
665 case ssl_renegotiate_freely:
666 break;
667 }
668
669 /* Renegotiation is only supported at quiescent points in the application
670 * protocol, namely in HTTPS, just before reading the HTTP response. Require
671 * the record-layer be idle and avoid complexities of sending a handshake
672 * record while an application_data record is being written. */
673 if (ssl_write_buffer_is_pending(ssl)) {
674 goto no_renegotiation;
675 }
676
677 /* Begin a new handshake. */
David Benjamin2644a132016-12-11 13:41:17 -0500678 if (ssl->s3->hs != NULL) {
679 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
680 return 0;
681 }
682 ssl->s3->hs = ssl_handshake_new(ssl);
683 if (ssl->s3->hs == NULL) {
684 return 0;
685 }
686
David Benjamin163f29a2016-07-28 11:05:58 -0400687 ssl->s3->total_renegotiations++;
David Benjamin163f29a2016-07-28 11:05:58 -0400688 return 1;
689
690no_renegotiation:
691 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_NO_RENEGOTIATION);
692 OPENSSL_PUT_ERROR(SSL, SSL_R_NO_RENEGOTIATION);
693 return 0;
694}
695
696static int ssl_do_post_handshake(SSL *ssl) {
697 if (ssl3_protocol_version(ssl) < TLS1_3_VERSION) {
698 return ssl_do_renegotiate(ssl);
699 }
700
Steven Valdez8e1c7be2016-07-26 12:39:22 -0400701 return tls13_post_handshake(ssl);
David Benjamin163f29a2016-07-28 11:05:58 -0400702}
703
David Benjamin15c14882016-03-14 14:25:46 -0400704static int ssl_read_impl(SSL *ssl, void *buf, int num, int peek) {
David Benjamin2be4aa72017-01-02 07:56:51 -0500705 ssl_reset_error_state(ssl);
David Benjamin15c14882016-03-14 14:25:46 -0400706
David Benjaminb2a73182016-03-10 01:25:26 -0500707 if (ssl->handshake_func == NULL) {
David Benjamin27bbae42015-09-13 00:54:37 -0400708 OPENSSL_PUT_ERROR(SSL, SSL_R_UNINITIALIZED);
709 return -1;
710 }
711
David Benjamin163f29a2016-07-28 11:05:58 -0400712 for (;;) {
713 /* Complete the current handshake, if any. False Start will cause
714 * |SSL_do_handshake| to return mid-handshake, so this may require multiple
715 * iterations. */
716 while (SSL_in_init(ssl)) {
717 int ret = SSL_do_handshake(ssl);
718 if (ret < 0) {
719 return ret;
720 }
721 if (ret == 0) {
722 OPENSSL_PUT_ERROR(SSL, SSL_R_SSL_HANDSHAKE_FAILURE);
723 return -1;
724 }
725 }
726
727 int got_handshake;
728 int ret = ssl->method->read_app_data(ssl, &got_handshake, buf, num, peek);
729 if (ret > 0 || !got_handshake) {
Steven Valdez32635b82016-08-16 11:25:03 -0400730 ssl->s3->key_update_count = 0;
David Benjaminc79845c2016-03-10 01:28:00 -0500731 return ret;
732 }
David Benjamin163f29a2016-07-28 11:05:58 -0400733
734 /* Handle the post-handshake message and try again. */
735 if (!ssl_do_post_handshake(ssl)) {
David Benjaminc79845c2016-03-10 01:28:00 -0500736 return -1;
737 }
David Benjamin163f29a2016-07-28 11:05:58 -0400738 ssl->method->release_current_message(ssl, 1 /* free buffer */);
David Benjaminc79845c2016-03-10 01:28:00 -0500739 }
David Benjamin15c14882016-03-14 14:25:46 -0400740}
741
742int SSL_read(SSL *ssl, void *buf, int num) {
743 return ssl_read_impl(ssl, buf, num, 0 /* consume bytes */);
David Benjamin27bbae42015-09-13 00:54:37 -0400744}
745
746int SSL_peek(SSL *ssl, void *buf, int num) {
David Benjamin15c14882016-03-14 14:25:46 -0400747 return ssl_read_impl(ssl, buf, num, 1 /* peek */);
David Benjamin27bbae42015-09-13 00:54:37 -0400748}
749
750int SSL_write(SSL *ssl, const void *buf, int num) {
David Benjamin2be4aa72017-01-02 07:56:51 -0500751 ssl_reset_error_state(ssl);
David Benjamin15c14882016-03-14 14:25:46 -0400752
David Benjaminb2a73182016-03-10 01:25:26 -0500753 if (ssl->handshake_func == NULL) {
David Benjamin27bbae42015-09-13 00:54:37 -0400754 OPENSSL_PUT_ERROR(SSL, SSL_R_UNINITIALIZED);
755 return -1;
756 }
757
David Benjaminfa214e42016-05-10 17:03:10 -0400758 if (ssl->s3->send_shutdown != ssl_shutdown_none) {
David Benjamin27bbae42015-09-13 00:54:37 -0400759 OPENSSL_PUT_ERROR(SSL, SSL_R_PROTOCOL_IS_SHUTDOWN);
760 return -1;
761 }
762
David Benjamind7ac1432016-03-10 00:41:25 -0500763 /* If necessary, complete the handshake implicitly. */
764 if (SSL_in_init(ssl) && !SSL_in_false_start(ssl)) {
765 int ret = SSL_do_handshake(ssl);
766 if (ret < 0) {
767 return ret;
768 }
769 if (ret == 0) {
770 OPENSSL_PUT_ERROR(SSL, SSL_R_SSL_HANDSHAKE_FAILURE);
771 return -1;
772 }
773 }
774
David Benjaminf0ee9072016-06-15 17:44:37 -0400775 return ssl->method->write_app_data(ssl, buf, num);
David Benjamin27bbae42015-09-13 00:54:37 -0400776}
777
778int SSL_shutdown(SSL *ssl) {
David Benjamin2be4aa72017-01-02 07:56:51 -0500779 ssl_reset_error_state(ssl);
David Benjamin15c14882016-03-14 14:25:46 -0400780
David Benjaminb2a73182016-03-10 01:25:26 -0500781 if (ssl->handshake_func == NULL) {
David Benjamin27bbae42015-09-13 00:54:37 -0400782 OPENSSL_PUT_ERROR(SSL, SSL_R_UNINITIALIZED);
783 return -1;
784 }
785
David Benjamin12709db2017-02-17 13:51:50 -0500786 /* If we are in the middle of a handshake, silently succeed. Consumers often
787 * call this function before |SSL_free|, whether the handshake succeeded or
788 * not. We assume the caller has already handled failed handshakes. */
Steven Valdeza14934f2016-02-29 10:05:08 -0500789 if (SSL_in_init(ssl)) {
David Benjamin12709db2017-02-17 13:51:50 -0500790 return 1;
Steven Valdeza14934f2016-02-29 10:05:08 -0500791 }
792
David Benjamin27bbae42015-09-13 00:54:37 -0400793 if (ssl->quiet_shutdown) {
David Benjaminfa214e42016-05-10 17:03:10 -0400794 /* Do nothing if configured not to send a close_notify. */
795 ssl->s3->send_shutdown = ssl_shutdown_close_notify;
796 ssl->s3->recv_shutdown = ssl_shutdown_close_notify;
David Benjamin27bbae42015-09-13 00:54:37 -0400797 return 1;
798 }
799
David Benjaminfa214e42016-05-10 17:03:10 -0400800 /* This function completes in two stages. It sends a close_notify and then it
801 * waits for a close_notify to come in. Perform exactly one action and return
802 * whether or not it succeeds. */
David Benjamin27bbae42015-09-13 00:54:37 -0400803
David Benjaminfa214e42016-05-10 17:03:10 -0400804 if (ssl->s3->send_shutdown != ssl_shutdown_close_notify) {
805 /* Send a close_notify. */
806 if (ssl3_send_alert(ssl, SSL3_AL_WARNING, SSL_AD_CLOSE_NOTIFY) <= 0) {
807 return -1;
David Benjamin27bbae42015-09-13 00:54:37 -0400808 }
809 } else if (ssl->s3->alert_dispatch) {
David Benjaminfa214e42016-05-10 17:03:10 -0400810 /* Finish sending the close_notify. */
David Benjaminf0ee9072016-06-15 17:44:37 -0400811 if (ssl->method->dispatch_alert(ssl) <= 0) {
David Benjaminfa214e42016-05-10 17:03:10 -0400812 return -1;
David Benjamin27bbae42015-09-13 00:54:37 -0400813 }
David Benjaminfa214e42016-05-10 17:03:10 -0400814 } else if (ssl->s3->recv_shutdown != ssl_shutdown_close_notify) {
815 /* Wait for the peer's close_notify. */
David Benjaminf0ee9072016-06-15 17:44:37 -0400816 ssl->method->read_close_notify(ssl);
David Benjaminfa214e42016-05-10 17:03:10 -0400817 if (ssl->s3->recv_shutdown != ssl_shutdown_close_notify) {
818 return -1;
David Benjamin27bbae42015-09-13 00:54:37 -0400819 }
820 }
821
David Benjaminfa214e42016-05-10 17:03:10 -0400822 /* Return 0 for unidirectional shutdown and 1 for bidirectional shutdown. */
823 return ssl->s3->recv_shutdown == ssl_shutdown_close_notify;
David Benjamin27bbae42015-09-13 00:54:37 -0400824}
825
David Benjamin1d4f4c02016-07-26 18:03:08 -0400826int SSL_send_fatal_alert(SSL *ssl, uint8_t alert) {
827 if (ssl->s3->alert_dispatch) {
828 if (ssl->s3->send_alert[0] != SSL3_AL_FATAL ||
829 ssl->s3->send_alert[1] != alert) {
830 /* We are already attempting to write a different alert. */
831 OPENSSL_PUT_ERROR(SSL, SSL_R_PROTOCOL_IS_SHUTDOWN);
832 return -1;
833 }
834 return ssl->method->dispatch_alert(ssl);
835 }
836
837 return ssl3_send_alert(ssl, SSL3_AL_FATAL, alert);
838}
839
Steven Valdez08b65f42016-12-07 15:29:45 -0500840void SSL_CTX_set_early_data_enabled(SSL_CTX *ctx, int enabled) {
841 ctx->enable_early_data = !!enabled;
842}
843
David Benjamin287fc4f2016-12-10 15:12:03 -0500844static int bio_retry_reason_to_error(int reason) {
845 switch (reason) {
846 case BIO_RR_CONNECT:
847 return SSL_ERROR_WANT_CONNECT;
848 case BIO_RR_ACCEPT:
849 return SSL_ERROR_WANT_ACCEPT;
850 default:
851 return SSL_ERROR_SYSCALL;
852 }
853}
David Benjamin27bbae42015-09-13 00:54:37 -0400854
David Benjamin287fc4f2016-12-10 15:12:03 -0500855int SSL_get_error(const SSL *ssl, int ret_code) {
David Benjamin27bbae42015-09-13 00:54:37 -0400856 if (ret_code > 0) {
857 return SSL_ERROR_NONE;
858 }
859
860 /* Make things return SSL_ERROR_SYSCALL when doing SSL_do_handshake etc,
861 * where we do encode the error */
David Benjamin287fc4f2016-12-10 15:12:03 -0500862 uint32_t err = ERR_peek_error();
David Benjamin27bbae42015-09-13 00:54:37 -0400863 if (err != 0) {
864 if (ERR_GET_LIB(err) == ERR_LIB_SYS) {
865 return SSL_ERROR_SYSCALL;
866 }
867 return SSL_ERROR_SSL;
868 }
869
870 if (ret_code == 0) {
David Benjaminfa214e42016-05-10 17:03:10 -0400871 if (ssl->s3->recv_shutdown == ssl_shutdown_close_notify) {
David Benjamin27bbae42015-09-13 00:54:37 -0400872 return SSL_ERROR_ZERO_RETURN;
873 }
874 /* An EOF was observed which violates the protocol, and the underlying
875 * transport does not participate in the error queue. Bubble up to the
876 * caller. */
877 return SSL_ERROR_SYSCALL;
878 }
879
David Benjamin287fc4f2016-12-10 15:12:03 -0500880 switch (ssl->rwstate) {
881 case SSL_PENDING_SESSION:
882 return SSL_ERROR_PENDING_SESSION;
David Benjamin27bbae42015-09-13 00:54:37 -0400883
David Benjamin287fc4f2016-12-10 15:12:03 -0500884 case SSL_CERTIFICATE_SELECTION_PENDING:
885 return SSL_ERROR_PENDING_CERTIFICATE;
David Benjamin27bbae42015-09-13 00:54:37 -0400886
David Benjamin287fc4f2016-12-10 15:12:03 -0500887 case SSL_READING: {
888 BIO *bio = SSL_get_rbio(ssl);
889 if (BIO_should_read(bio)) {
890 return SSL_ERROR_WANT_READ;
David Benjamin27bbae42015-09-13 00:54:37 -0400891 }
892
David Benjamin287fc4f2016-12-10 15:12:03 -0500893 if (BIO_should_write(bio)) {
894 /* TODO(davidben): OpenSSL historically checked for writes on the read
895 * BIO. Can this be removed? */
896 return SSL_ERROR_WANT_WRITE;
David Benjamin27bbae42015-09-13 00:54:37 -0400897 }
898
David Benjamin287fc4f2016-12-10 15:12:03 -0500899 if (BIO_should_io_special(bio)) {
900 return bio_retry_reason_to_error(BIO_get_retry_reason(bio));
David Benjamin27bbae42015-09-13 00:54:37 -0400901 }
902
David Benjamin287fc4f2016-12-10 15:12:03 -0500903 break;
904 }
905
906 case SSL_WRITING: {
907 BIO *bio = SSL_get_wbio(ssl);
908 if (BIO_should_write(bio)) {
909 return SSL_ERROR_WANT_WRITE;
David Benjamin27bbae42015-09-13 00:54:37 -0400910 }
911
David Benjamin287fc4f2016-12-10 15:12:03 -0500912 if (BIO_should_read(bio)) {
913 /* TODO(davidben): OpenSSL historically checked for reads on the write
914 * BIO. Can this be removed? */
915 return SSL_ERROR_WANT_READ;
916 }
917
918 if (BIO_should_io_special(bio)) {
919 return bio_retry_reason_to_error(BIO_get_retry_reason(bio));
920 }
921
922 break;
David Benjamin27bbae42015-09-13 00:54:37 -0400923 }
David Benjamin27bbae42015-09-13 00:54:37 -0400924
David Benjamin287fc4f2016-12-10 15:12:03 -0500925 case SSL_X509_LOOKUP:
926 return SSL_ERROR_WANT_X509_LOOKUP;
David Benjamin27bbae42015-09-13 00:54:37 -0400927
David Benjamin287fc4f2016-12-10 15:12:03 -0500928 case SSL_CHANNEL_ID_LOOKUP:
929 return SSL_ERROR_WANT_CHANNEL_ID_LOOKUP;
David Benjamin27bbae42015-09-13 00:54:37 -0400930
David Benjamin287fc4f2016-12-10 15:12:03 -0500931 case SSL_PRIVATE_KEY_OPERATION:
932 return SSL_ERROR_WANT_PRIVATE_KEY_OPERATION;
David Benjamin27bbae42015-09-13 00:54:37 -0400933 }
934
935 return SSL_ERROR_SYSCALL;
936}
937
David Benjamine34bcc92016-09-21 16:53:09 -0400938static int set_min_version(const SSL_PROTOCOL_METHOD *method, uint16_t *out,
939 uint16_t version) {
940 if (version == 0) {
941 *out = method->min_version;
942 return 1;
943 }
944
Steven Valdezfdd10992016-09-15 16:27:05 -0400945 if (version == TLS1_3_VERSION) {
946 version = TLS1_3_DRAFT_VERSION;
947 }
948
David Benjamine34bcc92016-09-21 16:53:09 -0400949 return method->version_from_wire(out, version);
950}
951
952static int set_max_version(const SSL_PROTOCOL_METHOD *method, uint16_t *out,
953 uint16_t version) {
954 if (version == 0) {
955 *out = method->max_version;
956 /* TODO(svaldez): Enable TLS 1.3 by default once fully implemented. */
957 if (*out > TLS1_2_VERSION) {
958 *out = TLS1_2_VERSION;
959 }
960 return 1;
961 }
962
Steven Valdezfdd10992016-09-15 16:27:05 -0400963 if (version == TLS1_3_VERSION) {
964 version = TLS1_3_DRAFT_VERSION;
965 }
966
David Benjamine34bcc92016-09-21 16:53:09 -0400967 return method->version_from_wire(out, version);
968}
969
David Benjamine4706902016-09-20 15:12:23 -0400970int SSL_CTX_set_min_proto_version(SSL_CTX *ctx, uint16_t version) {
David Benjamine34bcc92016-09-21 16:53:09 -0400971 return set_min_version(ctx->method, &ctx->min_version, version);
David Benjamin27bbae42015-09-13 00:54:37 -0400972}
973
David Benjamine4706902016-09-20 15:12:23 -0400974int SSL_CTX_set_max_proto_version(SSL_CTX *ctx, uint16_t version) {
David Benjamine34bcc92016-09-21 16:53:09 -0400975 return set_max_version(ctx->method, &ctx->max_version, version);
David Benjamin27bbae42015-09-13 00:54:37 -0400976}
977
David Benjamine4706902016-09-20 15:12:23 -0400978int SSL_set_min_proto_version(SSL *ssl, uint16_t version) {
David Benjamine34bcc92016-09-21 16:53:09 -0400979 return set_min_version(ssl->method, &ssl->min_version, version);
David Benjamin27bbae42015-09-13 00:54:37 -0400980}
981
David Benjamine4706902016-09-20 15:12:23 -0400982int SSL_set_max_proto_version(SSL *ssl, uint16_t version) {
David Benjamine34bcc92016-09-21 16:53:09 -0400983 return set_max_version(ssl->method, &ssl->max_version, version);
David Benjamin27bbae42015-09-13 00:54:37 -0400984}
985
986uint32_t SSL_CTX_set_options(SSL_CTX *ctx, uint32_t options) {
987 ctx->options |= options;
988 return ctx->options;
989}
990
991uint32_t SSL_CTX_clear_options(SSL_CTX *ctx, uint32_t options) {
992 ctx->options &= ~options;
993 return ctx->options;
994}
995
996uint32_t SSL_CTX_get_options(const SSL_CTX *ctx) { return ctx->options; }
997
998uint32_t SSL_set_options(SSL *ssl, uint32_t options) {
999 ssl->options |= options;
1000 return ssl->options;
1001}
1002
1003uint32_t SSL_clear_options(SSL *ssl, uint32_t options) {
1004 ssl->options &= ~options;
1005 return ssl->options;
1006}
1007
1008uint32_t SSL_get_options(const SSL *ssl) { return ssl->options; }
1009
1010uint32_t SSL_CTX_set_mode(SSL_CTX *ctx, uint32_t mode) {
1011 ctx->mode |= mode;
1012 return ctx->mode;
1013}
1014
1015uint32_t SSL_CTX_clear_mode(SSL_CTX *ctx, uint32_t mode) {
1016 ctx->mode &= ~mode;
1017 return ctx->mode;
1018}
1019
1020uint32_t SSL_CTX_get_mode(const SSL_CTX *ctx) { return ctx->mode; }
1021
1022uint32_t SSL_set_mode(SSL *ssl, uint32_t mode) {
1023 ssl->mode |= mode;
1024 return ssl->mode;
1025}
1026
1027uint32_t SSL_clear_mode(SSL *ssl, uint32_t mode) {
1028 ssl->mode &= ~mode;
1029 return ssl->mode;
1030}
1031
1032uint32_t SSL_get_mode(const SSL *ssl) { return ssl->mode; }
1033
Adam Langleyd519bf62016-12-12 11:16:44 -08001034void SSL_CTX_set0_buffer_pool(SSL_CTX *ctx, CRYPTO_BUFFER_POOL *pool) {
1035 ctx->pool = pool;
1036}
1037
David Benjaminee0c8272015-09-13 01:03:54 -04001038int SSL_get_tls_unique(const SSL *ssl, uint8_t *out, size_t *out_len,
1039 size_t max_out) {
David Benjaminced00b42016-10-08 11:24:09 -04001040 /* tls-unique is not defined for SSL 3.0 or TLS 1.3. */
1041 if (!ssl->s3->initial_handshake_complete ||
1042 ssl3_protocol_version(ssl) < TLS1_VERSION ||
1043 ssl3_protocol_version(ssl) >= TLS1_3_VERSION) {
1044 goto err;
1045 }
1046
David Benjaminee0c8272015-09-13 01:03:54 -04001047 /* The tls-unique value is the first Finished message in the handshake, which
1048 * is the client's in a full handshake and the server's for a resumption. See
1049 * https://tools.ietf.org/html/rfc5929#section-3.1. */
1050 const uint8_t *finished = ssl->s3->previous_client_finished;
1051 size_t finished_len = ssl->s3->previous_client_finished_len;
Steven Valdez87eab492016-06-27 16:34:59 -04001052 if (ssl->session != NULL) {
David Benjaminee0c8272015-09-13 01:03:54 -04001053 /* tls-unique is broken for resumed sessions unless EMS is used. */
1054 if (!ssl->session->extended_master_secret) {
1055 goto err;
1056 }
1057 finished = ssl->s3->previous_server_finished;
1058 finished_len = ssl->s3->previous_server_finished_len;
1059 }
1060
David Benjaminee0c8272015-09-13 01:03:54 -04001061 *out_len = finished_len;
1062 if (finished_len > max_out) {
1063 *out_len = max_out;
1064 }
1065
David Benjamin17cf2cb2016-12-13 01:07:13 -05001066 OPENSSL_memcpy(out, finished, *out_len);
David Benjaminee0c8272015-09-13 01:03:54 -04001067 return 1;
1068
1069err:
1070 *out_len = 0;
David Benjamin17cf2cb2016-12-13 01:07:13 -05001071 OPENSSL_memset(out, 0, max_out);
David Benjaminee0c8272015-09-13 01:03:54 -04001072 return 0;
1073}
1074
David Benjamin5960a902017-02-14 20:07:11 -05001075static int set_session_id_context(CERT *cert, const uint8_t *sid_ctx,
David Benjamin30c4c302016-12-07 22:35:24 -05001076 size_t sid_ctx_len) {
David Benjamin5960a902017-02-14 20:07:11 -05001077 if (sid_ctx_len > sizeof(cert->sid_ctx)) {
David Benjamin3570d732015-06-29 00:28:17 -04001078 OPENSSL_PUT_ERROR(SSL, SSL_R_SSL_SESSION_ID_CONTEXT_TOO_LONG);
Adam Langleyfcf25832014-12-18 17:42:32 -08001079 return 0;
1080 }
David Benjamin30c4c302016-12-07 22:35:24 -05001081
David Benjamin5960a902017-02-14 20:07:11 -05001082 OPENSSL_COMPILE_ASSERT(sizeof(cert->sid_ctx) < 256, sid_ctx_too_large);
1083 cert->sid_ctx_length = (uint8_t)sid_ctx_len;
1084 OPENSSL_memcpy(cert->sid_ctx, sid_ctx, sid_ctx_len);
Adam Langleyfcf25832014-12-18 17:42:32 -08001085 return 1;
1086}
Adam Langley95c29f32014-06-20 12:00:00 -07001087
David Benjamin5960a902017-02-14 20:07:11 -05001088int SSL_CTX_set_session_id_context(SSL_CTX *ctx, const uint8_t *sid_ctx,
1089 size_t sid_ctx_len) {
1090 return set_session_id_context(ctx->cert, sid_ctx, sid_ctx_len);
1091}
1092
Adam Langleyfcf25832014-12-18 17:42:32 -08001093int SSL_set_session_id_context(SSL *ssl, const uint8_t *sid_ctx,
David Benjamin30c4c302016-12-07 22:35:24 -05001094 size_t sid_ctx_len) {
David Benjamin5960a902017-02-14 20:07:11 -05001095 return set_session_id_context(ssl->cert, sid_ctx, sid_ctx_len);
Adam Langleyfcf25832014-12-18 17:42:32 -08001096}
Adam Langley95c29f32014-06-20 12:00:00 -07001097
David Benjamin07820b52016-12-07 21:13:41 -05001098const uint8_t *SSL_get0_session_id_context(const SSL *ssl, size_t *out_len) {
David Benjamin5960a902017-02-14 20:07:11 -05001099 *out_len = ssl->cert->sid_ctx_length;
1100 return ssl->cert->sid_ctx;
David Benjamin07820b52016-12-07 21:13:41 -05001101}
1102
Adam Langley858a88d2014-06-20 12:00:00 -07001103void ssl_cipher_preference_list_free(
Adam Langleyfcf25832014-12-18 17:42:32 -08001104 struct ssl_cipher_preference_list_st *cipher_list) {
David Benjamin5d1ec732015-04-22 13:38:00 -04001105 if (cipher_list == NULL) {
1106 return;
1107 }
Adam Langleyfcf25832014-12-18 17:42:32 -08001108 sk_SSL_CIPHER_free(cipher_list->ciphers);
1109 OPENSSL_free(cipher_list->in_group_flags);
1110 OPENSSL_free(cipher_list);
1111}
Adam Langley858a88d2014-06-20 12:00:00 -07001112
David Benjamin7481d392015-07-05 19:38:46 -04001113void SSL_certs_clear(SSL *ssl) { ssl_cert_clear_certs(ssl->cert); }
Adam Langley95c29f32014-06-20 12:00:00 -07001114
David Benjamin066fe0a2015-10-17 21:11:33 -04001115int SSL_get_fd(const SSL *ssl) { return SSL_get_rfd(ssl); }
Adam Langley95c29f32014-06-20 12:00:00 -07001116
David Benjamin066fe0a2015-10-17 21:11:33 -04001117int SSL_get_rfd(const SSL *ssl) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001118 int ret = -1;
David Benjamin066fe0a2015-10-17 21:11:33 -04001119 BIO *b = BIO_find_type(SSL_get_rbio(ssl), BIO_TYPE_DESCRIPTOR);
1120 if (b != NULL) {
1121 BIO_get_fd(b, &ret);
Adam Langleyfcf25832014-12-18 17:42:32 -08001122 }
1123 return ret;
1124}
Adam Langley95c29f32014-06-20 12:00:00 -07001125
David Benjamin066fe0a2015-10-17 21:11:33 -04001126int SSL_get_wfd(const SSL *ssl) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001127 int ret = -1;
David Benjamin066fe0a2015-10-17 21:11:33 -04001128 BIO *b = BIO_find_type(SSL_get_wbio(ssl), BIO_TYPE_DESCRIPTOR);
1129 if (b != NULL) {
1130 BIO_get_fd(b, &ret);
Adam Langleyfcf25832014-12-18 17:42:32 -08001131 }
Adam Langleyfcf25832014-12-18 17:42:32 -08001132 return ret;
1133}
Adam Langley95c29f32014-06-20 12:00:00 -07001134
David Benjamin066fe0a2015-10-17 21:11:33 -04001135int SSL_set_fd(SSL *ssl, int fd) {
David Benjamin22ce9b22016-03-06 19:26:52 -05001136 BIO *bio = BIO_new(BIO_s_socket());
Adam Langleyfcf25832014-12-18 17:42:32 -08001137 if (bio == NULL) {
David Benjamin3570d732015-06-29 00:28:17 -04001138 OPENSSL_PUT_ERROR(SSL, ERR_R_BUF_LIB);
David Benjamin066fe0a2015-10-17 21:11:33 -04001139 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001140 }
1141 BIO_set_fd(bio, fd, BIO_NOCLOSE);
David Benjamin066fe0a2015-10-17 21:11:33 -04001142 SSL_set_bio(ssl, bio, bio);
1143 return 1;
Adam Langleyfcf25832014-12-18 17:42:32 -08001144}
Adam Langley95c29f32014-06-20 12:00:00 -07001145
David Benjamin066fe0a2015-10-17 21:11:33 -04001146int SSL_set_wfd(SSL *ssl, int fd) {
David Benjamin2f871122016-05-20 14:27:17 -04001147 BIO *rbio = SSL_get_rbio(ssl);
1148 if (rbio == NULL || BIO_method_type(rbio) != BIO_TYPE_SOCKET ||
1149 BIO_get_fd(rbio, NULL) != fd) {
David Benjamin22ce9b22016-03-06 19:26:52 -05001150 BIO *bio = BIO_new(BIO_s_socket());
Adam Langleyfcf25832014-12-18 17:42:32 -08001151 if (bio == NULL) {
David Benjamin3570d732015-06-29 00:28:17 -04001152 OPENSSL_PUT_ERROR(SSL, ERR_R_BUF_LIB);
David Benjamin066fe0a2015-10-17 21:11:33 -04001153 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001154 }
1155 BIO_set_fd(bio, fd, BIO_NOCLOSE);
David Benjamin4501bd52016-08-01 13:39:41 -04001156 SSL_set0_wbio(ssl, bio);
Adam Langleyfcf25832014-12-18 17:42:32 -08001157 } else {
David Benjamin4501bd52016-08-01 13:39:41 -04001158 /* Copy the rbio over to the wbio. */
1159 BIO_up_ref(rbio);
1160 SSL_set0_wbio(ssl, rbio);
Adam Langleyfcf25832014-12-18 17:42:32 -08001161 }
1162
David Benjamin066fe0a2015-10-17 21:11:33 -04001163 return 1;
Adam Langleyfcf25832014-12-18 17:42:32 -08001164}
Adam Langley95c29f32014-06-20 12:00:00 -07001165
David Benjamin066fe0a2015-10-17 21:11:33 -04001166int SSL_set_rfd(SSL *ssl, int fd) {
David Benjamin2f871122016-05-20 14:27:17 -04001167 BIO *wbio = SSL_get_wbio(ssl);
1168 if (wbio == NULL || BIO_method_type(wbio) != BIO_TYPE_SOCKET ||
1169 BIO_get_fd(wbio, NULL) != fd) {
David Benjamin22ce9b22016-03-06 19:26:52 -05001170 BIO *bio = BIO_new(BIO_s_socket());
Adam Langleyfcf25832014-12-18 17:42:32 -08001171 if (bio == NULL) {
David Benjamin3570d732015-06-29 00:28:17 -04001172 OPENSSL_PUT_ERROR(SSL, ERR_R_BUF_LIB);
David Benjamin066fe0a2015-10-17 21:11:33 -04001173 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001174 }
1175 BIO_set_fd(bio, fd, BIO_NOCLOSE);
David Benjamin4501bd52016-08-01 13:39:41 -04001176 SSL_set0_rbio(ssl, bio);
Adam Langleyfcf25832014-12-18 17:42:32 -08001177 } else {
David Benjamin4501bd52016-08-01 13:39:41 -04001178 /* Copy the wbio over to the rbio. */
1179 BIO_up_ref(wbio);
1180 SSL_set0_rbio(ssl, wbio);
Adam Langleyfcf25832014-12-18 17:42:32 -08001181 }
David Benjamin066fe0a2015-10-17 21:11:33 -04001182 return 1;
Adam Langleyfcf25832014-12-18 17:42:32 -08001183}
Adam Langley95c29f32014-06-20 12:00:00 -07001184
David Benjamin49ddf412016-10-08 11:56:01 -04001185static size_t copy_finished(void *out, size_t out_len, const uint8_t *in,
1186 size_t in_len) {
1187 if (out_len > in_len) {
1188 out_len = in_len;
1189 }
David Benjamin17cf2cb2016-12-13 01:07:13 -05001190 OPENSSL_memcpy(out, in, out_len);
David Benjamin49ddf412016-10-08 11:56:01 -04001191 return in_len;
1192}
1193
David Benjamin1a1b34d2015-10-17 12:51:52 -04001194size_t SSL_get_finished(const SSL *ssl, void *buf, size_t count) {
David Benjaminced00b42016-10-08 11:24:09 -04001195 if (!ssl->s3->initial_handshake_complete ||
1196 ssl3_protocol_version(ssl) < TLS1_VERSION ||
1197 ssl3_protocol_version(ssl) >= TLS1_3_VERSION) {
1198 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001199 }
1200
David Benjamin49ddf412016-10-08 11:56:01 -04001201 if (ssl->server) {
1202 return copy_finished(buf, count, ssl->s3->previous_server_finished,
1203 ssl->s3->previous_server_finished_len);
David Benjaminced00b42016-10-08 11:24:09 -04001204 }
David Benjamin49ddf412016-10-08 11:56:01 -04001205
1206 return copy_finished(buf, count, ssl->s3->previous_client_finished,
1207 ssl->s3->previous_client_finished_len);
Adam Langleyfcf25832014-12-18 17:42:32 -08001208}
Adam Langley95c29f32014-06-20 12:00:00 -07001209
David Benjamin1a1b34d2015-10-17 12:51:52 -04001210size_t SSL_get_peer_finished(const SSL *ssl, void *buf, size_t count) {
David Benjaminced00b42016-10-08 11:24:09 -04001211 if (!ssl->s3->initial_handshake_complete ||
1212 ssl3_protocol_version(ssl) < TLS1_VERSION ||
1213 ssl3_protocol_version(ssl) >= TLS1_3_VERSION) {
1214 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001215 }
Adam Langley95c29f32014-06-20 12:00:00 -07001216
David Benjamin49ddf412016-10-08 11:56:01 -04001217 if (ssl->server) {
1218 return copy_finished(buf, count, ssl->s3->previous_client_finished,
1219 ssl->s3->previous_client_finished_len);
David Benjaminced00b42016-10-08 11:24:09 -04001220 }
David Benjamin49ddf412016-10-08 11:56:01 -04001221
1222 return copy_finished(buf, count, ssl->s3->previous_server_finished,
1223 ssl->s3->previous_server_finished_len);
Adam Langleyfcf25832014-12-18 17:42:32 -08001224}
Adam Langley95c29f32014-06-20 12:00:00 -07001225
David Benjamin59937042015-09-19 13:04:22 -04001226int SSL_get_verify_mode(const SSL *ssl) { return ssl->verify_mode; }
Adam Langley95c29f32014-06-20 12:00:00 -07001227
David Benjamin42fea372015-09-19 01:22:44 -04001228int SSL_get_extms_support(const SSL *ssl) {
David Benjaminfc02b592017-02-17 16:26:01 -05001229 /* TLS 1.3 does not require extended master secret and always reports as
1230 * supporting it. */
David Benjamina68c1182016-07-24 00:14:33 -04001231 if (!ssl->s3->have_version) {
1232 return 0;
1233 }
David Benjaminfc02b592017-02-17 16:26:01 -05001234 if (ssl3_protocol_version(ssl) >= TLS1_3_VERSION) {
1235 return 1;
1236 }
1237
1238 /* If the initial handshake completed, query the established session. */
1239 if (ssl->s3->established_session != NULL) {
1240 return ssl->s3->established_session->extended_master_secret;
1241 }
1242
1243 /* Otherwise, query the in-progress handshake. */
1244 if (ssl->s3->hs != NULL) {
1245 return ssl->s3->hs->extended_master_secret;
1246 }
1247 assert(0);
1248 return 0;
Matt Braithwaitecd6f54b2015-09-17 12:54:42 -07001249}
1250
David Benjamin9a41d1b2015-05-16 01:30:09 -04001251int SSL_CTX_get_read_ahead(const SSL_CTX *ctx) { return 0; }
Adam Langley95c29f32014-06-20 12:00:00 -07001252
David Benjamin0d56f882015-12-19 17:05:56 -05001253int SSL_get_read_ahead(const SSL *ssl) { return 0; }
Adam Langley95c29f32014-06-20 12:00:00 -07001254
David Benjamin9a41d1b2015-05-16 01:30:09 -04001255void SSL_CTX_set_read_ahead(SSL_CTX *ctx, int yes) { }
David Benjamin61ecccf2015-05-05 09:44:51 -04001256
David Benjamin0d56f882015-12-19 17:05:56 -05001257void SSL_set_read_ahead(SSL *ssl, int yes) { }
David Benjamin61ecccf2015-05-05 09:44:51 -04001258
David Benjamin9f859492015-10-03 10:44:30 -04001259int SSL_pending(const SSL *ssl) {
1260 if (ssl->s3->rrec.type != SSL3_RT_APPLICATION_DATA) {
1261 return 0;
1262 }
1263 return ssl->s3->rrec.length;
Adam Langleyfcf25832014-12-18 17:42:32 -08001264}
Adam Langley95c29f32014-06-20 12:00:00 -07001265
Adam Langley95c29f32014-06-20 12:00:00 -07001266/* Fix this so it checks all the valid key/cert options */
Adam Langleyfcf25832014-12-18 17:42:32 -08001267int SSL_CTX_check_private_key(const SSL_CTX *ctx) {
Adam Langley3a2b47a2017-01-24 13:59:42 -08001268 return ssl_cert_check_private_key(ctx->cert, ctx->cert->privatekey);
Adam Langleyc5ac2b62016-11-07 12:02:35 -08001269}
1270
1271/* Fix this function so that it takes an optional type parameter */
1272int SSL_check_private_key(const SSL *ssl) {
Adam Langley3a2b47a2017-01-24 13:59:42 -08001273 return ssl_cert_check_private_key(ssl->cert, ssl->cert->privatekey);
Adam Langleyfcf25832014-12-18 17:42:32 -08001274}
Adam Langley95c29f32014-06-20 12:00:00 -07001275
David Benjamin42fea372015-09-19 01:22:44 -04001276long SSL_get_default_timeout(const SSL *ssl) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001277 return SSL_DEFAULT_SESSION_TIMEOUT;
1278}
Adam Langley95c29f32014-06-20 12:00:00 -07001279
David Benjamin44d3eed2015-05-21 01:29:55 -04001280int SSL_renegotiate(SSL *ssl) {
1281 /* Caller-initiated renegotiation is not supported. */
David Benjamin3570d732015-06-29 00:28:17 -04001282 OPENSSL_PUT_ERROR(SSL, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
David Benjamin44d3eed2015-05-21 01:29:55 -04001283 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001284}
Adam Langley95c29f32014-06-20 12:00:00 -07001285
David Benjamin44d3eed2015-05-21 01:29:55 -04001286int SSL_renegotiate_pending(SSL *ssl) {
1287 return SSL_in_init(ssl) && ssl->s3->initial_handshake_complete;
Adam Langleyfcf25832014-12-18 17:42:32 -08001288}
Adam Langley95c29f32014-06-20 12:00:00 -07001289
David Benjamin936aada2016-06-07 19:09:22 -04001290int SSL_total_renegotiations(const SSL *ssl) {
1291 return ssl->s3->total_renegotiations;
1292}
1293
David Benjamin1d0a1942015-04-26 15:35:35 -04001294size_t SSL_CTX_get_max_cert_list(const SSL_CTX *ctx) {
1295 return ctx->max_cert_list;
1296}
1297
1298void SSL_CTX_set_max_cert_list(SSL_CTX *ctx, size_t max_cert_list) {
1299 if (max_cert_list > kMaxHandshakeSize) {
1300 max_cert_list = kMaxHandshakeSize;
1301 }
1302 ctx->max_cert_list = (uint32_t)max_cert_list;
1303}
1304
1305size_t SSL_get_max_cert_list(const SSL *ssl) {
1306 return ssl->max_cert_list;
1307}
1308
1309void SSL_set_max_cert_list(SSL *ssl, size_t max_cert_list) {
1310 if (max_cert_list > kMaxHandshakeSize) {
1311 max_cert_list = kMaxHandshakeSize;
1312 }
1313 ssl->max_cert_list = (uint32_t)max_cert_list;
1314}
1315
Adam Langleyce9d85e2016-01-24 15:58:39 -08001316int SSL_CTX_set_max_send_fragment(SSL_CTX *ctx, size_t max_send_fragment) {
David Benjamin1d0a1942015-04-26 15:35:35 -04001317 if (max_send_fragment < 512) {
1318 max_send_fragment = 512;
1319 }
1320 if (max_send_fragment > SSL3_RT_MAX_PLAIN_LENGTH) {
1321 max_send_fragment = SSL3_RT_MAX_PLAIN_LENGTH;
1322 }
1323 ctx->max_send_fragment = (uint16_t)max_send_fragment;
Adam Langleyce9d85e2016-01-24 15:58:39 -08001324
1325 return 1;
David Benjamin1d0a1942015-04-26 15:35:35 -04001326}
1327
Adam Langleyce9d85e2016-01-24 15:58:39 -08001328int SSL_set_max_send_fragment(SSL *ssl, size_t max_send_fragment) {
David Benjamin1d0a1942015-04-26 15:35:35 -04001329 if (max_send_fragment < 512) {
1330 max_send_fragment = 512;
1331 }
1332 if (max_send_fragment > SSL3_RT_MAX_PLAIN_LENGTH) {
1333 max_send_fragment = SSL3_RT_MAX_PLAIN_LENGTH;
1334 }
1335 ssl->max_send_fragment = (uint16_t)max_send_fragment;
Adam Langleyce9d85e2016-01-24 15:58:39 -08001336
1337 return 1;
David Benjamin1d0a1942015-04-26 15:35:35 -04001338}
1339
David Benjamincb9cf792015-05-05 09:46:14 -04001340int SSL_set_mtu(SSL *ssl, unsigned mtu) {
David Benjamince079fd2016-08-02 16:22:34 -04001341 if (!SSL_is_dtls(ssl) || mtu < dtls1_min_mtu()) {
David Benjamincb9cf792015-05-05 09:46:14 -04001342 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001343 }
David Benjamincb9cf792015-05-05 09:46:14 -04001344 ssl->d1->mtu = mtu;
1345 return 1;
1346}
1347
1348int SSL_get_secure_renegotiation_support(const SSL *ssl) {
David Benjamind2610042017-01-03 10:49:28 -05001349 if (!ssl->s3->have_version) {
1350 return 0;
1351 }
1352 return ssl3_protocol_version(ssl) >= TLS1_3_VERSION ||
1353 ssl->s3->send_connection_binding;
David Benjamincb9cf792015-05-05 09:46:14 -04001354}
1355
Adam Langleyfcf25832014-12-18 17:42:32 -08001356LHASH_OF(SSL_SESSION) *SSL_CTX_sessions(SSL_CTX *ctx) { return ctx->sessions; }
1357
David Benjamin71f7d3d2015-05-05 09:46:38 -04001358size_t SSL_CTX_sess_number(const SSL_CTX *ctx) {
1359 return lh_SSL_SESSION_num_items(ctx->sessions);
1360}
1361
1362unsigned long SSL_CTX_sess_set_cache_size(SSL_CTX *ctx, unsigned long size) {
1363 unsigned long ret = ctx->session_cache_size;
1364 ctx->session_cache_size = size;
1365 return ret;
1366}
1367
1368unsigned long SSL_CTX_sess_get_cache_size(const SSL_CTX *ctx) {
1369 return ctx->session_cache_size;
1370}
1371
1372int SSL_CTX_set_session_cache_mode(SSL_CTX *ctx, int mode) {
1373 int ret = ctx->session_cache_mode;
1374 ctx->session_cache_mode = mode;
1375 return ret;
1376}
1377
1378int SSL_CTX_get_session_cache_mode(const SSL_CTX *ctx) {
1379 return ctx->session_cache_mode;
1380}
1381
David Benjamin936aada2016-06-07 19:09:22 -04001382
1383int SSL_CTX_get_tlsext_ticket_keys(SSL_CTX *ctx, void *out, size_t len) {
1384 if (out == NULL) {
1385 return 48;
1386 }
1387 if (len != 48) {
1388 OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_TICKET_KEYS_LENGTH);
1389 return 0;
1390 }
1391 uint8_t *out_bytes = out;
David Benjamin17cf2cb2016-12-13 01:07:13 -05001392 OPENSSL_memcpy(out_bytes, ctx->tlsext_tick_key_name, 16);
1393 OPENSSL_memcpy(out_bytes + 16, ctx->tlsext_tick_hmac_key, 16);
1394 OPENSSL_memcpy(out_bytes + 32, ctx->tlsext_tick_aes_key, 16);
David Benjamin936aada2016-06-07 19:09:22 -04001395 return 1;
1396}
1397
1398int SSL_CTX_set_tlsext_ticket_keys(SSL_CTX *ctx, const void *in, size_t len) {
1399 if (in == NULL) {
1400 return 48;
1401 }
1402 if (len != 48) {
1403 OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_TICKET_KEYS_LENGTH);
1404 return 0;
1405 }
1406 const uint8_t *in_bytes = in;
David Benjamin17cf2cb2016-12-13 01:07:13 -05001407 OPENSSL_memcpy(ctx->tlsext_tick_key_name, in_bytes, 16);
1408 OPENSSL_memcpy(ctx->tlsext_tick_hmac_key, in_bytes + 16, 16);
1409 OPENSSL_memcpy(ctx->tlsext_tick_aes_key, in_bytes + 32, 16);
David Benjamin936aada2016-06-07 19:09:22 -04001410 return 1;
1411}
1412
1413int SSL_CTX_set_tlsext_ticket_key_cb(
1414 SSL_CTX *ctx, int (*callback)(SSL *ssl, uint8_t *key_name, uint8_t *iv,
1415 EVP_CIPHER_CTX *ctx, HMAC_CTX *hmac_ctx,
1416 int encrypt)) {
1417 ctx->tlsext_ticket_key_cb = callback;
1418 return 1;
1419}
1420
1421int SSL_CTX_set1_curves(SSL_CTX *ctx, const int *curves, size_t curves_len) {
1422 return tls1_set_curves(&ctx->supported_group_list,
1423 &ctx->supported_group_list_len, curves,
1424 curves_len);
1425}
1426
1427int SSL_set1_curves(SSL *ssl, const int *curves, size_t curves_len) {
1428 return tls1_set_curves(&ssl->supported_group_list,
1429 &ssl->supported_group_list_len, curves,
1430 curves_len);
1431}
1432
Alessandro Ghedini5fd18072016-09-28 21:04:25 +01001433int SSL_CTX_set1_curves_list(SSL_CTX *ctx, const char *curves) {
1434 return tls1_set_curves_list(&ctx->supported_group_list,
1435 &ctx->supported_group_list_len, curves);
1436}
1437
1438int SSL_set1_curves_list(SSL *ssl, const char *curves) {
1439 return tls1_set_curves_list(&ssl->supported_group_list,
1440 &ssl->supported_group_list_len, curves);
1441}
1442
David Benjamin9e68f192016-06-30 14:55:33 -04001443uint16_t SSL_get_curve_id(const SSL *ssl) {
1444 /* TODO(davidben): This checks the wrong session if there is a renegotiation in
1445 * progress. */
Steven Valdez87eab492016-06-27 16:34:59 -04001446 SSL_SESSION *session = SSL_get_session(ssl);
David Benjamin4882a6c2016-12-11 02:48:12 -05001447 if (session == NULL) {
David Benjamin9e68f192016-06-30 14:55:33 -04001448 return 0;
1449 }
1450
David Benjamin4882a6c2016-12-11 02:48:12 -05001451 return session->group_id;
David Benjamin9e68f192016-06-30 14:55:33 -04001452}
1453
David Benjamin936aada2016-06-07 19:09:22 -04001454int SSL_CTX_set_tmp_dh(SSL_CTX *ctx, const DH *dh) {
1455 DH_free(ctx->cert->dh_tmp);
1456 ctx->cert->dh_tmp = DHparams_dup(dh);
1457 if (ctx->cert->dh_tmp == NULL) {
1458 OPENSSL_PUT_ERROR(SSL, ERR_R_DH_LIB);
1459 return 0;
1460 }
1461 return 1;
1462}
1463
1464int SSL_set_tmp_dh(SSL *ssl, const DH *dh) {
1465 DH_free(ssl->cert->dh_tmp);
1466 ssl->cert->dh_tmp = DHparams_dup(dh);
1467 if (ssl->cert->dh_tmp == NULL) {
1468 OPENSSL_PUT_ERROR(SSL, ERR_R_DH_LIB);
1469 return 0;
1470 }
1471 return 1;
1472}
1473
David Benjamin32876b32015-09-20 12:17:03 -04001474STACK_OF(SSL_CIPHER) *SSL_get_ciphers(const SSL *ssl) {
1475 if (ssl == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001476 return NULL;
1477 }
Adam Langley0b5c1ac2014-06-20 12:00:00 -07001478
David Benjaminaf3b3d32016-10-31 16:29:57 -04001479 const struct ssl_cipher_preference_list_st *prefs =
1480 ssl_get_cipher_preferences(ssl);
1481 if (prefs == NULL) {
1482 return NULL;
Adam Langleyfcf25832014-12-18 17:42:32 -08001483 }
Adam Langley0b5c1ac2014-06-20 12:00:00 -07001484
David Benjaminaf3b3d32016-10-31 16:29:57 -04001485 return prefs->ciphers;
Adam Langleyfcf25832014-12-18 17:42:32 -08001486}
Adam Langley95c29f32014-06-20 12:00:00 -07001487
David Benjamin32876b32015-09-20 12:17:03 -04001488const char *SSL_get_cipher_list(const SSL *ssl, int n) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001489 const SSL_CIPHER *c;
David Benjamin60da0cd2015-05-03 15:21:28 -04001490 STACK_OF(SSL_CIPHER) *sk;
Adam Langley0b5c1ac2014-06-20 12:00:00 -07001491
David Benjamin32876b32015-09-20 12:17:03 -04001492 if (ssl == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001493 return NULL;
1494 }
Adam Langley95c29f32014-06-20 12:00:00 -07001495
David Benjamin32876b32015-09-20 12:17:03 -04001496 sk = SSL_get_ciphers(ssl);
Adam Langleyfcf25832014-12-18 17:42:32 -08001497 if (sk == NULL || n < 0 || (size_t)n >= sk_SSL_CIPHER_num(sk)) {
1498 return NULL;
1499 }
Adam Langley95c29f32014-06-20 12:00:00 -07001500
Adam Langleyfcf25832014-12-18 17:42:32 -08001501 c = sk_SSL_CIPHER_value(sk, n);
1502 if (c == NULL) {
1503 return NULL;
1504 }
Adam Langley95c29f32014-06-20 12:00:00 -07001505
Adam Langleyfcf25832014-12-18 17:42:32 -08001506 return c->name;
1507}
David Benjamin5491e3f2014-09-29 19:33:09 -04001508
Adam Langleyfcf25832014-12-18 17:42:32 -08001509int SSL_CTX_set_cipher_list(SSL_CTX *ctx, const char *str) {
David Benjamind2cb1c12016-11-02 17:49:09 -04001510 STACK_OF(SSL_CIPHER) *cipher_list =
Matthew Braithwaitea57dcfb2017-02-17 22:08:23 -08001511 ssl_create_cipher_list(ctx->method, &ctx->cipher_list, str,
1512 0 /* not strict */);
1513 if (cipher_list == NULL) {
1514 return 0;
1515 }
1516
1517 /* |ssl_create_cipher_list| may succeed but return an empty cipher list. */
1518 if (sk_SSL_CIPHER_num(cipher_list) == 0) {
1519 OPENSSL_PUT_ERROR(SSL, SSL_R_NO_CIPHER_MATCH);
1520 return 0;
1521 }
1522
1523 return 1;
1524}
1525
1526int SSL_CTX_set_strict_cipher_list(SSL_CTX *ctx, const char *str) {
1527 STACK_OF(SSL_CIPHER) *cipher_list =
1528 ssl_create_cipher_list(ctx->method, &ctx->cipher_list, str,
1529 1 /* strict */);
David Benjamin32876b32015-09-20 12:17:03 -04001530 if (cipher_list == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001531 return 0;
David Benjamin32876b32015-09-20 12:17:03 -04001532 }
1533
1534 /* |ssl_create_cipher_list| may succeed but return an empty cipher list. */
1535 if (sk_SSL_CIPHER_num(cipher_list) == 0) {
David Benjamin3570d732015-06-29 00:28:17 -04001536 OPENSSL_PUT_ERROR(SSL, SSL_R_NO_CIPHER_MATCH);
Adam Langleyfcf25832014-12-18 17:42:32 -08001537 return 0;
1538 }
Adam Langley95c29f32014-06-20 12:00:00 -07001539
Adam Langleyfcf25832014-12-18 17:42:32 -08001540 return 1;
1541}
David Benjamin39482a12014-07-20 13:30:15 -04001542
David Benjamin32876b32015-09-20 12:17:03 -04001543int SSL_set_cipher_list(SSL *ssl, const char *str) {
David Benjamind2cb1c12016-11-02 17:49:09 -04001544 STACK_OF(SSL_CIPHER) *cipher_list =
Matthew Braithwaitea57dcfb2017-02-17 22:08:23 -08001545 ssl_create_cipher_list(ssl->ctx->method, &ssl->cipher_list, str,
1546 0 /* not strict */);
1547 if (cipher_list == NULL) {
1548 return 0;
1549 }
1550
1551 /* |ssl_create_cipher_list| may succeed but return an empty cipher list. */
1552 if (sk_SSL_CIPHER_num(cipher_list) == 0) {
1553 OPENSSL_PUT_ERROR(SSL, SSL_R_NO_CIPHER_MATCH);
1554 return 0;
1555 }
1556
1557 return 1;
1558}
1559
1560int SSL_set_strict_cipher_list(SSL *ssl, const char *str) {
1561 STACK_OF(SSL_CIPHER) *cipher_list =
1562 ssl_create_cipher_list(ssl->ctx->method, &ssl->cipher_list, str,
1563 1 /* strict */);
David Benjamin32876b32015-09-20 12:17:03 -04001564 if (cipher_list == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001565 return 0;
David Benjamin32876b32015-09-20 12:17:03 -04001566 }
1567
1568 /* |ssl_create_cipher_list| may succeed but return an empty cipher list. */
1569 if (sk_SSL_CIPHER_num(cipher_list) == 0) {
David Benjamin3570d732015-06-29 00:28:17 -04001570 OPENSSL_PUT_ERROR(SSL, SSL_R_NO_CIPHER_MATCH);
Adam Langleyfcf25832014-12-18 17:42:32 -08001571 return 0;
1572 }
David Benjamin39482a12014-07-20 13:30:15 -04001573
Adam Langleyfcf25832014-12-18 17:42:32 -08001574 return 1;
1575}
Adam Langley95c29f32014-06-20 12:00:00 -07001576
David Benjamin07e13842015-10-17 13:48:04 -04001577const char *SSL_get_servername(const SSL *ssl, const int type) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001578 if (type != TLSEXT_NAMETYPE_host_name) {
1579 return NULL;
1580 }
Adam Langley95c29f32014-06-20 12:00:00 -07001581
David Benjamin07e13842015-10-17 13:48:04 -04001582 /* Historically, |SSL_get_servername| was also the configuration getter
1583 * corresponding to |SSL_set_tlsext_host_name|. */
1584 if (ssl->tlsext_hostname != NULL) {
1585 return ssl->tlsext_hostname;
1586 }
1587
David Benjamin4eb95cc2016-11-16 17:08:23 +09001588 /* During the handshake, report the handshake value. */
1589 if (ssl->s3->hs != NULL) {
1590 return ssl->s3->hs->hostname;
1591 }
1592
1593 /* SSL_get_servername may also be called after the handshake to look up the
1594 * SNI value.
1595 *
1596 * TODO(davidben): This is almost unused. Can we remove it? */
Steven Valdez87eab492016-06-27 16:34:59 -04001597 SSL_SESSION *session = SSL_get_session(ssl);
1598 if (session == NULL) {
David Benjamin07e13842015-10-17 13:48:04 -04001599 return NULL;
1600 }
Steven Valdez87eab492016-06-27 16:34:59 -04001601 return session->tlsext_hostname;
Adam Langleyfcf25832014-12-18 17:42:32 -08001602}
Adam Langley95c29f32014-06-20 12:00:00 -07001603
David Benjamin07e13842015-10-17 13:48:04 -04001604int SSL_get_servername_type(const SSL *ssl) {
Steven Valdez87eab492016-06-27 16:34:59 -04001605 SSL_SESSION *session = SSL_get_session(ssl);
1606 if (session == NULL || session->tlsext_hostname == NULL) {
1607 return -1;
Adam Langleyfcf25832014-12-18 17:42:32 -08001608 }
Steven Valdez87eab492016-06-27 16:34:59 -04001609 return TLSEXT_NAMETYPE_host_name;
Adam Langleyfcf25832014-12-18 17:42:32 -08001610}
Adam Langley95c29f32014-06-20 12:00:00 -07001611
Adam Langleyfcf25832014-12-18 17:42:32 -08001612void SSL_CTX_enable_signed_cert_timestamps(SSL_CTX *ctx) {
1613 ctx->signed_cert_timestamps_enabled = 1;
1614}
HÃ¥vard Molland9169c962014-08-14 14:42:37 +02001615
David Benjamin26e1ff32017-02-14 20:13:00 -05001616void SSL_enable_signed_cert_timestamps(SSL *ssl) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001617 ssl->signed_cert_timestamps_enabled = 1;
Adam Langleyfcf25832014-12-18 17:42:32 -08001618}
HÃ¥vard Molland9169c962014-08-14 14:42:37 +02001619
Adam Langleyfcf25832014-12-18 17:42:32 -08001620void SSL_CTX_enable_ocsp_stapling(SSL_CTX *ctx) {
1621 ctx->ocsp_stapling_enabled = 1;
1622}
David Benjamin6c7aed02014-08-27 16:42:38 -04001623
David Benjamin26e1ff32017-02-14 20:13:00 -05001624void SSL_enable_ocsp_stapling(SSL *ssl) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001625 ssl->ocsp_stapling_enabled = 1;
Adam Langleyfcf25832014-12-18 17:42:32 -08001626}
David Benjamin6c7aed02014-08-27 16:42:38 -04001627
Adam Langleyfcf25832014-12-18 17:42:32 -08001628void SSL_get0_signed_cert_timestamp_list(const SSL *ssl, const uint8_t **out,
1629 size_t *out_len) {
Steven Valdez87eab492016-06-27 16:34:59 -04001630 SSL_SESSION *session = SSL_get_session(ssl);
Adam Langley3cb50e02014-08-26 14:00:31 -07001631
Adam Langleyfcf25832014-12-18 17:42:32 -08001632 *out_len = 0;
1633 *out = NULL;
1634 if (ssl->server || !session || !session->tlsext_signed_cert_timestamp_list) {
1635 return;
1636 }
HÃ¥vard Molland9169c962014-08-14 14:42:37 +02001637
Adam Langleyfcf25832014-12-18 17:42:32 -08001638 *out = session->tlsext_signed_cert_timestamp_list;
1639 *out_len = session->tlsext_signed_cert_timestamp_list_length;
1640}
David Benjamin6c7aed02014-08-27 16:42:38 -04001641
Adam Langleyfcf25832014-12-18 17:42:32 -08001642void SSL_get0_ocsp_response(const SSL *ssl, const uint8_t **out,
1643 size_t *out_len) {
Steven Valdez87eab492016-06-27 16:34:59 -04001644 SSL_SESSION *session = SSL_get_session(ssl);
Adam Langleyfcf25832014-12-18 17:42:32 -08001645
1646 *out_len = 0;
1647 *out = NULL;
1648 if (ssl->server || !session || !session->ocsp_response) {
1649 return;
1650 }
1651 *out = session->ocsp_response;
1652 *out_len = session->ocsp_response_length;
1653}
David Benjamin6c7aed02014-08-27 16:42:38 -04001654
David Benjamin936aada2016-06-07 19:09:22 -04001655int SSL_set_tlsext_host_name(SSL *ssl, const char *name) {
1656 OPENSSL_free(ssl->tlsext_hostname);
1657 ssl->tlsext_hostname = NULL;
1658
1659 if (name == NULL) {
1660 return 1;
1661 }
1662
1663 size_t len = strlen(name);
1664 if (len == 0 || len > TLSEXT_MAXLEN_host_name) {
1665 OPENSSL_PUT_ERROR(SSL, SSL_R_SSL3_EXT_INVALID_SERVERNAME);
1666 return 0;
1667 }
1668 ssl->tlsext_hostname = BUF_strdup(name);
1669 if (ssl->tlsext_hostname == NULL) {
1670 OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
1671 return 0;
1672 }
1673 return 1;
1674}
1675
1676int SSL_CTX_set_tlsext_servername_callback(
1677 SSL_CTX *ctx, int (*callback)(SSL *ssl, int *out_alert, void *arg)) {
1678 ctx->tlsext_servername_callback = callback;
1679 return 1;
1680}
1681
1682int SSL_CTX_set_tlsext_servername_arg(SSL_CTX *ctx, void *arg) {
1683 ctx->tlsext_servername_arg = arg;
1684 return 1;
1685}
1686
David Benjamin977547b2015-09-16 00:25:52 -04001687int SSL_select_next_proto(uint8_t **out, uint8_t *out_len,
1688 const uint8_t *server, unsigned server_len,
1689 const uint8_t *client, unsigned client_len) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001690 unsigned int i, j;
1691 const uint8_t *result;
1692 int status = OPENSSL_NPN_UNSUPPORTED;
Adam Langley95c29f32014-06-20 12:00:00 -07001693
Adam Langleyfcf25832014-12-18 17:42:32 -08001694 /* For each protocol in server preference order, see if we support it. */
1695 for (i = 0; i < server_len;) {
1696 for (j = 0; j < client_len;) {
1697 if (server[i] == client[j] &&
David Benjamin17cf2cb2016-12-13 01:07:13 -05001698 OPENSSL_memcmp(&server[i + 1], &client[j + 1], server[i]) == 0) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001699 /* We found a match */
1700 result = &server[i];
1701 status = OPENSSL_NPN_NEGOTIATED;
1702 goto found;
1703 }
1704 j += client[j];
1705 j++;
1706 }
1707 i += server[i];
1708 i++;
1709 }
Adam Langley95c29f32014-06-20 12:00:00 -07001710
Adam Langleyfcf25832014-12-18 17:42:32 -08001711 /* There's no overlap between our protocols and the server's list. */
1712 result = client;
1713 status = OPENSSL_NPN_NO_OVERLAP;
Adam Langley95c29f32014-06-20 12:00:00 -07001714
Adam Langleyfcf25832014-12-18 17:42:32 -08001715found:
1716 *out = (uint8_t *)result + 1;
David Benjamin977547b2015-09-16 00:25:52 -04001717 *out_len = result[0];
Adam Langleyfcf25832014-12-18 17:42:32 -08001718 return status;
1719}
Adam Langley95c29f32014-06-20 12:00:00 -07001720
David Benjamin977547b2015-09-16 00:25:52 -04001721void SSL_get0_next_proto_negotiated(const SSL *ssl, const uint8_t **out_data,
1722 unsigned *out_len) {
David Benjamin79978df2015-12-25 15:56:49 -05001723 *out_data = ssl->s3->next_proto_negotiated;
David Benjamin977547b2015-09-16 00:25:52 -04001724 if (*out_data == NULL) {
1725 *out_len = 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001726 } else {
David Benjamin79978df2015-12-25 15:56:49 -05001727 *out_len = ssl->s3->next_proto_negotiated_len;
Adam Langleyfcf25832014-12-18 17:42:32 -08001728 }
Adam Langley95c29f32014-06-20 12:00:00 -07001729}
1730
Adam Langleyfcf25832014-12-18 17:42:32 -08001731void SSL_CTX_set_next_protos_advertised_cb(
1732 SSL_CTX *ctx,
David Benjamin977547b2015-09-16 00:25:52 -04001733 int (*cb)(SSL *ssl, const uint8_t **out, unsigned *out_len, void *arg),
Adam Langleyfcf25832014-12-18 17:42:32 -08001734 void *arg) {
1735 ctx->next_protos_advertised_cb = cb;
1736 ctx->next_protos_advertised_cb_arg = arg;
1737}
Adam Langley95c29f32014-06-20 12:00:00 -07001738
Adam Langleyfcf25832014-12-18 17:42:32 -08001739void SSL_CTX_set_next_proto_select_cb(
David Benjamin977547b2015-09-16 00:25:52 -04001740 SSL_CTX *ctx, int (*cb)(SSL *ssl, uint8_t **out, uint8_t *out_len,
1741 const uint8_t *in, unsigned in_len, void *arg),
Adam Langleyfcf25832014-12-18 17:42:32 -08001742 void *arg) {
1743 ctx->next_proto_select_cb = cb;
1744 ctx->next_proto_select_cb_arg = arg;
1745}
Adam Langley95c29f32014-06-20 12:00:00 -07001746
Adam Langleyfcf25832014-12-18 17:42:32 -08001747int SSL_CTX_set_alpn_protos(SSL_CTX *ctx, const uint8_t *protos,
1748 unsigned protos_len) {
David Benjamin2755a3e2015-04-22 16:17:58 -04001749 OPENSSL_free(ctx->alpn_client_proto_list);
Adam Langleyfcf25832014-12-18 17:42:32 -08001750 ctx->alpn_client_proto_list = BUF_memdup(protos, protos_len);
1751 if (!ctx->alpn_client_proto_list) {
1752 return 1;
1753 }
1754 ctx->alpn_client_proto_list_len = protos_len;
Adam Langley95c29f32014-06-20 12:00:00 -07001755
Adam Langleyfcf25832014-12-18 17:42:32 -08001756 return 0;
1757}
Adam Langley95c29f32014-06-20 12:00:00 -07001758
Adam Langleyfcf25832014-12-18 17:42:32 -08001759int SSL_set_alpn_protos(SSL *ssl, const uint8_t *protos, unsigned protos_len) {
David Benjamin2755a3e2015-04-22 16:17:58 -04001760 OPENSSL_free(ssl->alpn_client_proto_list);
Adam Langleyfcf25832014-12-18 17:42:32 -08001761 ssl->alpn_client_proto_list = BUF_memdup(protos, protos_len);
1762 if (!ssl->alpn_client_proto_list) {
1763 return 1;
1764 }
1765 ssl->alpn_client_proto_list_len = protos_len;
Adam Langley95c29f32014-06-20 12:00:00 -07001766
Adam Langleyfcf25832014-12-18 17:42:32 -08001767 return 0;
1768}
Adam Langley95c29f32014-06-20 12:00:00 -07001769
Adam Langleyfcf25832014-12-18 17:42:32 -08001770void SSL_CTX_set_alpn_select_cb(SSL_CTX *ctx,
1771 int (*cb)(SSL *ssl, const uint8_t **out,
David Benjamin8984f1f2015-09-16 00:10:19 -04001772 uint8_t *out_len, const uint8_t *in,
1773 unsigned in_len, void *arg),
Adam Langleyfcf25832014-12-18 17:42:32 -08001774 void *arg) {
1775 ctx->alpn_select_cb = cb;
1776 ctx->alpn_select_cb_arg = arg;
1777}
Adam Langley95c29f32014-06-20 12:00:00 -07001778
David Benjamin8984f1f2015-09-16 00:10:19 -04001779void SSL_get0_alpn_selected(const SSL *ssl, const uint8_t **out_data,
1780 unsigned *out_len) {
1781 *out_data = NULL;
Adam Langleyfcf25832014-12-18 17:42:32 -08001782 if (ssl->s3) {
David Benjamin8984f1f2015-09-16 00:10:19 -04001783 *out_data = ssl->s3->alpn_selected;
Adam Langleyfcf25832014-12-18 17:42:32 -08001784 }
David Benjamin8984f1f2015-09-16 00:10:19 -04001785 if (*out_data == NULL) {
1786 *out_len = 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001787 } else {
David Benjamin8984f1f2015-09-16 00:10:19 -04001788 *out_len = ssl->s3->alpn_selected_len;
Adam Langleyfcf25832014-12-18 17:42:32 -08001789 }
1790}
Adam Langley95c29f32014-06-20 12:00:00 -07001791
David Benjamin936aada2016-06-07 19:09:22 -04001792
David Benjamineebd3c82016-12-06 17:43:58 -05001793void SSL_CTX_set_tls_channel_id_enabled(SSL_CTX *ctx, int enabled) {
1794 ctx->tlsext_channel_id_enabled = !!enabled;
1795}
1796
David Benjamin936aada2016-06-07 19:09:22 -04001797int SSL_CTX_enable_tls_channel_id(SSL_CTX *ctx) {
David Benjamineebd3c82016-12-06 17:43:58 -05001798 SSL_CTX_set_tls_channel_id_enabled(ctx, 1);
David Benjamin936aada2016-06-07 19:09:22 -04001799 return 1;
1800}
1801
David Benjamineebd3c82016-12-06 17:43:58 -05001802void SSL_set_tls_channel_id_enabled(SSL *ssl, int enabled) {
1803 ssl->tlsext_channel_id_enabled = !!enabled;
1804}
1805
David Benjamin936aada2016-06-07 19:09:22 -04001806int SSL_enable_tls_channel_id(SSL *ssl) {
David Benjamineebd3c82016-12-06 17:43:58 -05001807 SSL_set_tls_channel_id_enabled(ssl, 1);
David Benjamin936aada2016-06-07 19:09:22 -04001808 return 1;
1809}
1810
1811static int is_p256_key(EVP_PKEY *private_key) {
1812 const EC_KEY *ec_key = EVP_PKEY_get0_EC_KEY(private_key);
1813 return ec_key != NULL &&
1814 EC_GROUP_get_curve_name(EC_KEY_get0_group(ec_key)) ==
1815 NID_X9_62_prime256v1;
1816}
1817
1818int SSL_CTX_set1_tls_channel_id(SSL_CTX *ctx, EVP_PKEY *private_key) {
1819 if (!is_p256_key(private_key)) {
1820 OPENSSL_PUT_ERROR(SSL, SSL_R_CHANNEL_ID_NOT_P256);
1821 return 0;
1822 }
1823
1824 EVP_PKEY_free(ctx->tlsext_channel_id_private);
Adam Langley310d3f62016-07-12 10:39:20 -07001825 EVP_PKEY_up_ref(private_key);
1826 ctx->tlsext_channel_id_private = private_key;
David Benjamin936aada2016-06-07 19:09:22 -04001827 ctx->tlsext_channel_id_enabled = 1;
1828
1829 return 1;
1830}
1831
1832int SSL_set1_tls_channel_id(SSL *ssl, EVP_PKEY *private_key) {
1833 if (!is_p256_key(private_key)) {
1834 OPENSSL_PUT_ERROR(SSL, SSL_R_CHANNEL_ID_NOT_P256);
1835 return 0;
1836 }
1837
1838 EVP_PKEY_free(ssl->tlsext_channel_id_private);
Adam Langley310d3f62016-07-12 10:39:20 -07001839 EVP_PKEY_up_ref(private_key);
1840 ssl->tlsext_channel_id_private = private_key;
David Benjamin936aada2016-06-07 19:09:22 -04001841 ssl->tlsext_channel_id_enabled = 1;
1842
1843 return 1;
1844}
1845
1846size_t SSL_get_tls_channel_id(SSL *ssl, uint8_t *out, size_t max_out) {
1847 if (!ssl->s3->tlsext_channel_id_valid) {
1848 return 0;
1849 }
David Benjamin17cf2cb2016-12-13 01:07:13 -05001850 OPENSSL_memcpy(out, ssl->s3->tlsext_channel_id,
1851 (max_out < 64) ? max_out : 64);
David Benjamin936aada2016-06-07 19:09:22 -04001852 return 64;
1853}
1854
David Benjamin936aada2016-06-07 19:09:22 -04001855size_t SSL_get0_certificate_types(SSL *ssl, const uint8_t **out_types) {
David Benjamina0486782016-10-06 19:11:32 -04001856 if (ssl->server || ssl->s3->hs == NULL) {
David Benjamin936aada2016-06-07 19:09:22 -04001857 *out_types = NULL;
1858 return 0;
1859 }
David Benjamina0486782016-10-06 19:11:32 -04001860 *out_types = ssl->s3->hs->certificate_types;
1861 return ssl->s3->hs->num_certificate_types;
David Benjamin936aada2016-06-07 19:09:22 -04001862}
1863
David Benjaminf3c8f8d2016-11-17 17:20:47 +09001864void ssl_update_cache(SSL_HANDSHAKE *hs, int mode) {
1865 SSL *const ssl = hs->ssl;
David Benjamin1269ddd2015-10-18 15:18:55 -04001866 SSL_CTX *ctx = ssl->initial_ctx;
David Benjaminb6d0c6d2015-03-19 19:07:26 -04001867 /* Never cache sessions with empty session IDs. */
Steven Valdez87eab492016-06-27 16:34:59 -04001868 if (ssl->s3->established_session->session_id_length == 0 ||
David Benjamin1269ddd2015-10-18 15:18:55 -04001869 (ctx->session_cache_mode & mode) != mode) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001870 return;
1871 }
Adam Langley95c29f32014-06-20 12:00:00 -07001872
David Benjamin1269ddd2015-10-18 15:18:55 -04001873 /* Clients never use the internal session cache. */
1874 int use_internal_cache = ssl->server && !(ctx->session_cache_mode &
1875 SSL_SESS_CACHE_NO_INTERNAL_STORE);
David Benjamin95d31822015-06-15 19:53:32 -04001876
David Benjamin1269ddd2015-10-18 15:18:55 -04001877 /* A client may see new sessions on abbreviated handshakes if the server
1878 * decides to renew the ticket. Once the handshake is completed, it should be
1879 * inserted into the cache. */
Steven Valdez87eab492016-06-27 16:34:59 -04001880 if (ssl->s3->established_session != ssl->session ||
David Benjaminf3c8f8d2016-11-17 17:20:47 +09001881 (!ssl->server && hs->ticket_expected)) {
David Benjamin1269ddd2015-10-18 15:18:55 -04001882 if (use_internal_cache) {
Steven Valdez87eab492016-06-27 16:34:59 -04001883 SSL_CTX_add_session(ctx, ssl->s3->established_session);
David Benjamin1269ddd2015-10-18 15:18:55 -04001884 }
David Benjaminb9195402016-08-05 10:51:43 -04001885 if (ctx->new_session_cb != NULL) {
1886 SSL_SESSION_up_ref(ssl->s3->established_session);
1887 if (!ctx->new_session_cb(ssl, ssl->s3->established_session)) {
1888 /* |new_session_cb|'s return value signals whether it took ownership. */
1889 SSL_SESSION_free(ssl->s3->established_session);
1890 }
Adam Langleyfcf25832014-12-18 17:42:32 -08001891 }
1892 }
Adam Langley95c29f32014-06-20 12:00:00 -07001893
David Benjamin1269ddd2015-10-18 15:18:55 -04001894 if (use_internal_cache &&
1895 !(ctx->session_cache_mode & SSL_SESS_CACHE_NO_AUTO_CLEAR)) {
David Benjaminb6d0c6d2015-03-19 19:07:26 -04001896 /* Automatically flush the internal session cache every 255 connections. */
1897 int flush_cache = 0;
Adam Langley4bdb6e42015-05-15 15:29:21 -07001898 CRYPTO_MUTEX_lock_write(&ctx->lock);
David Benjaminb6d0c6d2015-03-19 19:07:26 -04001899 ctx->handshakes_since_cache_flush++;
1900 if (ctx->handshakes_since_cache_flush >= 255) {
1901 flush_cache = 1;
1902 ctx->handshakes_since_cache_flush = 0;
1903 }
David Benjamin29270de2016-05-24 15:28:36 +00001904 CRYPTO_MUTEX_unlock_write(&ctx->lock);
David Benjaminb6d0c6d2015-03-19 19:07:26 -04001905
1906 if (flush_cache) {
David Benjamin721e8b72016-08-03 13:13:17 -04001907 struct timeval now;
1908 ssl_get_current_time(ssl, &now);
1909 SSL_CTX_flush_sessions(ctx, (long)now.tv_sec);
Adam Langleyfcf25832014-12-18 17:42:32 -08001910 }
1911 }
1912}
Adam Langley95c29f32014-06-20 12:00:00 -07001913
Adam Langleyfcf25832014-12-18 17:42:32 -08001914static const char *ssl_get_version(int version) {
1915 switch (version) {
Steven Valdezfdd10992016-09-15 16:27:05 -04001916 /* Report TLS 1.3 draft version as TLS 1.3 in the public API. */
1917 case TLS1_3_DRAFT_VERSION:
Steven Valdez4f94b1c2016-05-24 12:31:07 -04001918 return "TLSv1.3";
1919
Adam Langleyfcf25832014-12-18 17:42:32 -08001920 case TLS1_2_VERSION:
1921 return "TLSv1.2";
Adam Langley95c29f32014-06-20 12:00:00 -07001922
Adam Langleyfcf25832014-12-18 17:42:32 -08001923 case TLS1_1_VERSION:
1924 return "TLSv1.1";
Adam Langley95c29f32014-06-20 12:00:00 -07001925
Adam Langleyfcf25832014-12-18 17:42:32 -08001926 case TLS1_VERSION:
1927 return "TLSv1";
Adam Langley95c29f32014-06-20 12:00:00 -07001928
Adam Langleyfcf25832014-12-18 17:42:32 -08001929 case SSL3_VERSION:
1930 return "SSLv3";
Adam Langley95c29f32014-06-20 12:00:00 -07001931
David Benjamin1c722b72015-04-20 13:53:10 -04001932 case DTLS1_VERSION:
1933 return "DTLSv1";
1934
1935 case DTLS1_2_VERSION:
1936 return "DTLSv1.2";
1937
Adam Langleyfcf25832014-12-18 17:42:32 -08001938 default:
1939 return "unknown";
1940 }
1941}
Adam Langley95c29f32014-06-20 12:00:00 -07001942
David Benjamin42fea372015-09-19 01:22:44 -04001943const char *SSL_get_version(const SSL *ssl) {
1944 return ssl_get_version(ssl->version);
Adam Langleyfcf25832014-12-18 17:42:32 -08001945}
Adam Langley95c29f32014-06-20 12:00:00 -07001946
David Benjamina6b8cdf2015-09-13 14:07:33 -04001947const char *SSL_SESSION_get_version(const SSL_SESSION *session) {
1948 return ssl_get_version(session->ssl_version);
Adam Langleyfcf25832014-12-18 17:42:32 -08001949}
Adam Langley95c29f32014-06-20 12:00:00 -07001950
David Benjamin0d56f882015-12-19 17:05:56 -05001951EVP_PKEY *SSL_get_privatekey(const SSL *ssl) {
1952 if (ssl->cert != NULL) {
1953 return ssl->cert->privatekey;
Adam Langleyfcf25832014-12-18 17:42:32 -08001954 }
1955
1956 return NULL;
1957}
1958
Adam Langleyfcf25832014-12-18 17:42:32 -08001959EVP_PKEY *SSL_CTX_get0_privatekey(const SSL_CTX *ctx) {
1960 if (ctx->cert != NULL) {
David Benjamind1d80782015-07-05 11:54:09 -04001961 return ctx->cert->privatekey;
Adam Langleyfcf25832014-12-18 17:42:32 -08001962 }
1963
1964 return NULL;
1965}
1966
David Benjamin42fea372015-09-19 01:22:44 -04001967const SSL_CIPHER *SSL_get_current_cipher(const SSL *ssl) {
David Benjamin79978df2015-12-25 15:56:49 -05001968 if (ssl->s3->aead_write_ctx == NULL) {
David Benjamina07c0fc2015-05-13 13:19:42 -04001969 return NULL;
Adam Langleyfcf25832014-12-18 17:42:32 -08001970 }
David Benjamin79978df2015-12-25 15:56:49 -05001971 return ssl->s3->aead_write_ctx->cipher;
Adam Langleyfcf25832014-12-18 17:42:32 -08001972}
1973
David Benjamin936aada2016-06-07 19:09:22 -04001974int SSL_session_reused(const SSL *ssl) {
Steven Valdez4aa154e2016-07-29 14:32:55 -04001975 return ssl->s3->session_reused;
David Benjamin936aada2016-06-07 19:09:22 -04001976}
1977
David Benjamin0d56f882015-12-19 17:05:56 -05001978const COMP_METHOD *SSL_get_current_compression(SSL *ssl) { return NULL; }
Adam Langleyfcf25832014-12-18 17:42:32 -08001979
David Benjamin0d56f882015-12-19 17:05:56 -05001980const COMP_METHOD *SSL_get_current_expansion(SSL *ssl) { return NULL; }
Adam Langleyfcf25832014-12-18 17:42:32 -08001981
Adam Langley29ec5d12016-03-01 16:12:28 -08001982int *SSL_get_server_tmp_key(SSL *ssl, EVP_PKEY **out_key) { return 0; }
1983
Adam Langleyfcf25832014-12-18 17:42:32 -08001984void SSL_CTX_set_quiet_shutdown(SSL_CTX *ctx, int mode) {
Adam Langleybb85f3d2015-10-28 18:44:11 -07001985 ctx->quiet_shutdown = (mode != 0);
Adam Langleyfcf25832014-12-18 17:42:32 -08001986}
1987
1988int SSL_CTX_get_quiet_shutdown(const SSL_CTX *ctx) {
1989 return ctx->quiet_shutdown;
1990}
1991
Adam Langleybb85f3d2015-10-28 18:44:11 -07001992void SSL_set_quiet_shutdown(SSL *ssl, int mode) {
1993 ssl->quiet_shutdown = (mode != 0);
1994}
Adam Langleyfcf25832014-12-18 17:42:32 -08001995
David Benjamin9f859492015-10-03 10:44:30 -04001996int SSL_get_quiet_shutdown(const SSL *ssl) { return ssl->quiet_shutdown; }
Adam Langleyfcf25832014-12-18 17:42:32 -08001997
David Benjamin63006a92015-10-18 00:00:06 -04001998void SSL_set_shutdown(SSL *ssl, int mode) {
1999 /* It is an error to clear any bits that have already been set. (We can't try
2000 * to get a second close_notify or send two.) */
David Benjaminfa214e42016-05-10 17:03:10 -04002001 assert((SSL_get_shutdown(ssl) & mode) == SSL_get_shutdown(ssl));
David Benjamin63006a92015-10-18 00:00:06 -04002002
David Benjaminfa214e42016-05-10 17:03:10 -04002003 if (mode & SSL_RECEIVED_SHUTDOWN &&
2004 ssl->s3->recv_shutdown == ssl_shutdown_none) {
2005 ssl->s3->recv_shutdown = ssl_shutdown_close_notify;
2006 }
2007
2008 if (mode & SSL_SENT_SHUTDOWN &&
2009 ssl->s3->send_shutdown == ssl_shutdown_none) {
2010 ssl->s3->send_shutdown = ssl_shutdown_close_notify;
2011 }
David Benjamin63006a92015-10-18 00:00:06 -04002012}
Adam Langleyfcf25832014-12-18 17:42:32 -08002013
David Benjaminfa214e42016-05-10 17:03:10 -04002014int SSL_get_shutdown(const SSL *ssl) {
2015 int ret = 0;
2016 if (ssl->s3->recv_shutdown != ssl_shutdown_none) {
2017 /* Historically, OpenSSL set |SSL_RECEIVED_SHUTDOWN| on both close_notify
2018 * and fatal alert. */
2019 ret |= SSL_RECEIVED_SHUTDOWN;
2020 }
2021 if (ssl->s3->send_shutdown == ssl_shutdown_close_notify) {
2022 /* Historically, OpenSSL set |SSL_SENT_SHUTDOWN| on only close_notify. */
2023 ret |= SSL_SENT_SHUTDOWN;
2024 }
2025 return ret;
2026}
Adam Langleyfcf25832014-12-18 17:42:32 -08002027
Steven Valdezfdd10992016-09-15 16:27:05 -04002028int SSL_version(const SSL *ssl) {
2029 /* Report TLS 1.3 draft version as TLS 1.3 in the public API. */
2030 if (ssl->version == TLS1_3_DRAFT_VERSION) {
2031 return TLS1_3_VERSION;
2032 }
2033
2034 return ssl->version;
2035}
Adam Langleyfcf25832014-12-18 17:42:32 -08002036
2037SSL_CTX *SSL_get_SSL_CTX(const SSL *ssl) { return ssl->ctx; }
2038
2039SSL_CTX *SSL_set_SSL_CTX(SSL *ssl, SSL_CTX *ctx) {
2040 if (ssl->ctx == ctx) {
2041 return ssl->ctx;
2042 }
2043
Adam Langley3509dac2017-02-01 11:59:18 -08002044 /* One cannot change the X.509 callbacks during a connection. */
2045 if (ssl->ctx->x509_method != ctx->x509_method) {
2046 assert(0);
2047 return NULL;
2048 }
2049
Adam Langleyfcf25832014-12-18 17:42:32 -08002050 if (ctx == NULL) {
2051 ctx = ssl->initial_ctx;
2052 }
2053
David Benjamin2755a3e2015-04-22 16:17:58 -04002054 ssl_cert_free(ssl->cert);
Adam Langleyfcf25832014-12-18 17:42:32 -08002055 ssl->cert = ssl_cert_dup(ctx->cert);
David Benjamin2755a3e2015-04-22 16:17:58 -04002056
David Benjaminf650c712016-12-22 15:54:51 -05002057 SSL_CTX_up_ref(ctx);
2058 SSL_CTX_free(ssl->ctx);
Adam Langleyfcf25832014-12-18 17:42:32 -08002059 ssl->ctx = ctx;
2060
Adam Langleyfcf25832014-12-18 17:42:32 -08002061 return ssl->ctx;
2062}
2063
Adam Langley95c29f32014-06-20 12:00:00 -07002064void SSL_set_info_callback(SSL *ssl,
David Benjamin82170242015-10-17 22:51:17 -04002065 void (*cb)(const SSL *ssl, int type, int value)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002066 ssl->info_callback = cb;
2067}
Adam Langley95c29f32014-06-20 12:00:00 -07002068
David Benjamin82170242015-10-17 22:51:17 -04002069void (*SSL_get_info_callback(const SSL *ssl))(const SSL *ssl, int type,
2070 int value) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002071 return ssl->info_callback;
2072}
Adam Langley95c29f32014-06-20 12:00:00 -07002073
David Benjamincb0c29f2016-12-12 17:00:50 -05002074int SSL_state(const SSL *ssl) {
David Benjamin9e766d72017-02-10 23:14:17 -05002075 return SSL_in_init(ssl) ? SSL_ST_INIT : SSL_ST_OK;
David Benjamincb0c29f2016-12-12 17:00:50 -05002076}
Adam Langley95c29f32014-06-20 12:00:00 -07002077
David Benjaminece089c2015-05-15 23:52:42 -04002078void SSL_set_state(SSL *ssl, int state) { }
Adam Langley95c29f32014-06-20 12:00:00 -07002079
Emily Stark95a79ee2016-02-25 21:12:28 -08002080char *SSL_get_shared_ciphers(const SSL *ssl, char *buf, int len) {
2081 if (len <= 0) {
2082 return NULL;
2083 }
2084 buf[0] = '\0';
2085 return buf;
2086}
2087
David Benjamin8a589332015-12-04 23:14:35 -05002088int SSL_get_ex_new_index(long argl, void *argp, CRYPTO_EX_unused *unused,
Adam Langleyfcf25832014-12-18 17:42:32 -08002089 CRYPTO_EX_dup *dup_func, CRYPTO_EX_free *free_func) {
David Benjamin9f33fc62015-04-15 17:29:53 -04002090 int index;
2091 if (!CRYPTO_get_ex_new_index(&g_ex_data_class_ssl, &index, argl, argp,
David Benjamin8a589332015-12-04 23:14:35 -05002092 dup_func, free_func)) {
David Benjamin9f33fc62015-04-15 17:29:53 -04002093 return -1;
2094 }
2095 return index;
Adam Langleyfcf25832014-12-18 17:42:32 -08002096}
Adam Langley95c29f32014-06-20 12:00:00 -07002097
David Benjamin1ac08fe2015-09-15 01:36:22 -04002098int SSL_set_ex_data(SSL *ssl, int idx, void *arg) {
2099 return CRYPTO_set_ex_data(&ssl->ex_data, idx, arg);
Adam Langleyfcf25832014-12-18 17:42:32 -08002100}
Adam Langley95c29f32014-06-20 12:00:00 -07002101
David Benjamin1ac08fe2015-09-15 01:36:22 -04002102void *SSL_get_ex_data(const SSL *ssl, int idx) {
2103 return CRYPTO_get_ex_data(&ssl->ex_data, idx);
Adam Langleyfcf25832014-12-18 17:42:32 -08002104}
Adam Langley95c29f32014-06-20 12:00:00 -07002105
David Benjamin8a589332015-12-04 23:14:35 -05002106int SSL_CTX_get_ex_new_index(long argl, void *argp, CRYPTO_EX_unused *unused,
Adam Langleyfcf25832014-12-18 17:42:32 -08002107 CRYPTO_EX_dup *dup_func,
2108 CRYPTO_EX_free *free_func) {
David Benjamin9f33fc62015-04-15 17:29:53 -04002109 int index;
2110 if (!CRYPTO_get_ex_new_index(&g_ex_data_class_ssl_ctx, &index, argl, argp,
David Benjamin8a589332015-12-04 23:14:35 -05002111 dup_func, free_func)) {
David Benjamin9f33fc62015-04-15 17:29:53 -04002112 return -1;
2113 }
2114 return index;
Adam Langleyfcf25832014-12-18 17:42:32 -08002115}
Adam Langley95c29f32014-06-20 12:00:00 -07002116
David Benjamin1ac08fe2015-09-15 01:36:22 -04002117int SSL_CTX_set_ex_data(SSL_CTX *ctx, int idx, void *arg) {
2118 return CRYPTO_set_ex_data(&ctx->ex_data, idx, arg);
Adam Langleyfcf25832014-12-18 17:42:32 -08002119}
Adam Langley95c29f32014-06-20 12:00:00 -07002120
David Benjamin1ac08fe2015-09-15 01:36:22 -04002121void *SSL_CTX_get_ex_data(const SSL_CTX *ctx, int idx) {
2122 return CRYPTO_get_ex_data(&ctx->ex_data, idx);
Adam Langleyfcf25832014-12-18 17:42:32 -08002123}
Adam Langley95c29f32014-06-20 12:00:00 -07002124
David Benjamin93d17492015-10-17 12:43:36 -04002125int SSL_want(const SSL *ssl) { return ssl->rwstate; }
Adam Langley95c29f32014-06-20 12:00:00 -07002126
Adam Langleyfcf25832014-12-18 17:42:32 -08002127void SSL_CTX_set_tmp_rsa_callback(SSL_CTX *ctx,
2128 RSA *(*cb)(SSL *ssl, int is_export,
2129 int keylength)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002130}
Adam Langley95c29f32014-06-20 12:00:00 -07002131
Adam Langleyfcf25832014-12-18 17:42:32 -08002132void SSL_set_tmp_rsa_callback(SSL *ssl, RSA *(*cb)(SSL *ssl, int is_export,
2133 int keylength)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002134}
2135
2136void SSL_CTX_set_tmp_dh_callback(SSL_CTX *ctx,
David Benjamin59015c32015-04-26 13:13:55 -04002137 DH *(*callback)(SSL *ssl, int is_export,
2138 int keylength)) {
2139 ctx->cert->dh_tmp_cb = callback;
Adam Langleyfcf25832014-12-18 17:42:32 -08002140}
2141
David Benjamin59015c32015-04-26 13:13:55 -04002142void SSL_set_tmp_dh_callback(SSL *ssl, DH *(*callback)(SSL *ssl, int is_export,
2143 int keylength)) {
2144 ssl->cert->dh_tmp_cb = callback;
Adam Langleyfcf25832014-12-18 17:42:32 -08002145}
2146
Adam Langleyfcf25832014-12-18 17:42:32 -08002147int SSL_CTX_use_psk_identity_hint(SSL_CTX *ctx, const char *identity_hint) {
2148 if (identity_hint != NULL && strlen(identity_hint) > PSK_MAX_IDENTITY_LEN) {
David Benjamin3570d732015-06-29 00:28:17 -04002149 OPENSSL_PUT_ERROR(SSL, SSL_R_DATA_LENGTH_TOO_LONG);
Adam Langleyfcf25832014-12-18 17:42:32 -08002150 return 0;
2151 }
2152
David Benjamin2755a3e2015-04-22 16:17:58 -04002153 OPENSSL_free(ctx->psk_identity_hint);
Adam Langleyfcf25832014-12-18 17:42:32 -08002154
2155 if (identity_hint != NULL) {
2156 ctx->psk_identity_hint = BUF_strdup(identity_hint);
2157 if (ctx->psk_identity_hint == NULL) {
2158 return 0;
Adam Langley95c29f32014-06-20 12:00:00 -07002159 }
Adam Langleyfcf25832014-12-18 17:42:32 -08002160 } else {
2161 ctx->psk_identity_hint = NULL;
2162 }
Adam Langley95c29f32014-06-20 12:00:00 -07002163
Adam Langleyfcf25832014-12-18 17:42:32 -08002164 return 1;
2165}
2166
David Benjamine8814df2015-09-15 08:05:54 -04002167int SSL_use_psk_identity_hint(SSL *ssl, const char *identity_hint) {
2168 if (ssl == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002169 return 0;
2170 }
2171
2172 if (identity_hint != NULL && strlen(identity_hint) > PSK_MAX_IDENTITY_LEN) {
David Benjamin3570d732015-06-29 00:28:17 -04002173 OPENSSL_PUT_ERROR(SSL, SSL_R_DATA_LENGTH_TOO_LONG);
Adam Langleyfcf25832014-12-18 17:42:32 -08002174 return 0;
2175 }
2176
2177 /* Clear currently configured hint, if any. */
David Benjamine8814df2015-09-15 08:05:54 -04002178 OPENSSL_free(ssl->psk_identity_hint);
2179 ssl->psk_identity_hint = NULL;
Adam Langleyfcf25832014-12-18 17:42:32 -08002180
David Benjamin78679342016-09-16 19:42:05 -04002181 /* Treat the empty hint as not supplying one. Plain PSK makes it possible to
2182 * send either no hint (omit ServerKeyExchange) or an empty hint, while
2183 * ECDHE_PSK can only spell empty hint. Having different capabilities is odd,
2184 * so we interpret empty and missing as identical. */
2185 if (identity_hint != NULL && identity_hint[0] != '\0') {
David Benjamine8814df2015-09-15 08:05:54 -04002186 ssl->psk_identity_hint = BUF_strdup(identity_hint);
2187 if (ssl->psk_identity_hint == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002188 return 0;
Adam Langley95c29f32014-06-20 12:00:00 -07002189 }
Adam Langleyfcf25832014-12-18 17:42:32 -08002190 }
Adam Langley95c29f32014-06-20 12:00:00 -07002191
Adam Langleyfcf25832014-12-18 17:42:32 -08002192 return 1;
2193}
Adam Langley95c29f32014-06-20 12:00:00 -07002194
David Benjamine8814df2015-09-15 08:05:54 -04002195const char *SSL_get_psk_identity_hint(const SSL *ssl) {
2196 if (ssl == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002197 return NULL;
2198 }
David Benjamine8814df2015-09-15 08:05:54 -04002199 return ssl->psk_identity_hint;
Adam Langleyfcf25832014-12-18 17:42:32 -08002200}
Adam Langley95c29f32014-06-20 12:00:00 -07002201
David Benjamine8814df2015-09-15 08:05:54 -04002202const char *SSL_get_psk_identity(const SSL *ssl) {
Steven Valdez87eab492016-06-27 16:34:59 -04002203 if (ssl == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002204 return NULL;
2205 }
Steven Valdez87eab492016-06-27 16:34:59 -04002206 SSL_SESSION *session = SSL_get_session(ssl);
2207 if (session == NULL) {
2208 return NULL;
2209 }
2210 return session->psk_identity;
Adam Langleyfcf25832014-12-18 17:42:32 -08002211}
Adam Langley95c29f32014-06-20 12:00:00 -07002212
Adam Langleyfcf25832014-12-18 17:42:32 -08002213void SSL_set_psk_client_callback(
David Benjamine8814df2015-09-15 08:05:54 -04002214 SSL *ssl, unsigned (*cb)(SSL *ssl, const char *hint, char *identity,
2215 unsigned max_identity_len, uint8_t *psk,
2216 unsigned max_psk_len)) {
2217 ssl->psk_client_callback = cb;
Adam Langleyfcf25832014-12-18 17:42:32 -08002218}
Adam Langley95c29f32014-06-20 12:00:00 -07002219
Adam Langleyfcf25832014-12-18 17:42:32 -08002220void SSL_CTX_set_psk_client_callback(
David Benjamine8814df2015-09-15 08:05:54 -04002221 SSL_CTX *ctx, unsigned (*cb)(SSL *ssl, const char *hint, char *identity,
2222 unsigned max_identity_len, uint8_t *psk,
2223 unsigned max_psk_len)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002224 ctx->psk_client_callback = cb;
2225}
Adam Langley95c29f32014-06-20 12:00:00 -07002226
Adam Langleyfcf25832014-12-18 17:42:32 -08002227void SSL_set_psk_server_callback(
David Benjamine8814df2015-09-15 08:05:54 -04002228 SSL *ssl, unsigned (*cb)(SSL *ssl, const char *identity, uint8_t *psk,
2229 unsigned max_psk_len)) {
2230 ssl->psk_server_callback = cb;
Adam Langleyfcf25832014-12-18 17:42:32 -08002231}
Adam Langley95c29f32014-06-20 12:00:00 -07002232
Adam Langleyfcf25832014-12-18 17:42:32 -08002233void SSL_CTX_set_psk_server_callback(
David Benjamine8814df2015-09-15 08:05:54 -04002234 SSL_CTX *ctx, unsigned (*cb)(SSL *ssl, const char *identity,
2235 uint8_t *psk, unsigned max_psk_len)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002236 ctx->psk_server_callback = cb;
2237}
Adam Langley95c29f32014-06-20 12:00:00 -07002238
Adam Langleyfcf25832014-12-18 17:42:32 -08002239void SSL_CTX_set_msg_callback(SSL_CTX *ctx,
2240 void (*cb)(int write_p, int version,
2241 int content_type, const void *buf,
2242 size_t len, SSL *ssl, void *arg)) {
David Benjamin59015c32015-04-26 13:13:55 -04002243 ctx->msg_callback = cb;
Adam Langleyfcf25832014-12-18 17:42:32 -08002244}
David Benjamin61ecccf2015-05-05 09:44:51 -04002245
2246void SSL_CTX_set_msg_callback_arg(SSL_CTX *ctx, void *arg) {
2247 ctx->msg_callback_arg = arg;
2248}
2249
Adam Langleyfcf25832014-12-18 17:42:32 -08002250void SSL_set_msg_callback(SSL *ssl,
2251 void (*cb)(int write_p, int version, int content_type,
2252 const void *buf, size_t len, SSL *ssl,
2253 void *arg)) {
David Benjamin59015c32015-04-26 13:13:55 -04002254 ssl->msg_callback = cb;
Adam Langleyfcf25832014-12-18 17:42:32 -08002255}
Adam Langley95c29f32014-06-20 12:00:00 -07002256
David Benjamin61ecccf2015-05-05 09:44:51 -04002257void SSL_set_msg_callback_arg(SSL *ssl, void *arg) {
2258 ssl->msg_callback_arg = arg;
2259}
2260
David Benjamind28f59c2015-11-17 22:32:50 -05002261void SSL_CTX_set_keylog_callback(SSL_CTX *ctx,
2262 void (*cb)(const SSL *ssl, const char *line)) {
2263 ctx->keylog_callback = cb;
Adam Langleyfcf25832014-12-18 17:42:32 -08002264}
Adam Langley95c29f32014-06-20 12:00:00 -07002265
David Benjamin6e3f5cc2016-09-14 14:43:14 -04002266void (*SSL_CTX_get_keylog_callback(const SSL_CTX *ctx))(const SSL *ssl,
2267 const char *line) {
2268 return ctx->keylog_callback;
2269}
2270
Taylor Brandstetter9edb2c62016-06-08 15:26:59 -07002271void SSL_CTX_set_current_time_cb(SSL_CTX *ctx,
2272 void (*cb)(const SSL *ssl,
2273 struct timeval *out_clock)) {
2274 ctx->current_time_cb = cb;
2275}
2276
Adam Langleyfcf25832014-12-18 17:42:32 -08002277static int cbb_add_hex(CBB *cbb, const uint8_t *in, size_t in_len) {
2278 static const char hextable[] = "0123456789abcdef";
2279 uint8_t *out;
Adam Langley95c29f32014-06-20 12:00:00 -07002280
Adam Langleyfcf25832014-12-18 17:42:32 -08002281 if (!CBB_add_space(cbb, &out, in_len * 2)) {
2282 return 0;
2283 }
Adam Langley95c29f32014-06-20 12:00:00 -07002284
David Benjamin54091232016-09-05 12:47:25 -04002285 for (size_t i = 0; i < in_len; i++) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002286 *(out++) = (uint8_t)hextable[in[i] >> 4];
2287 *(out++) = (uint8_t)hextable[in[i] & 0xf];
2288 }
Adam Langley95c29f32014-06-20 12:00:00 -07002289
Adam Langleyfcf25832014-12-18 17:42:32 -08002290 return 1;
2291}
David Benjamin859ec3c2014-09-02 16:29:36 -04002292
David Benjamine776cc22016-07-19 07:26:49 +02002293int ssl_log_secret(const SSL *ssl, const char *label, const uint8_t *secret,
2294 size_t secret_len) {
David Benjamind28f59c2015-11-17 22:32:50 -05002295 if (ssl->ctx->keylog_callback == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002296 return 1;
2297 }
Adam Langleyadb739e2014-06-20 12:00:00 -07002298
David Benjamind28f59c2015-11-17 22:32:50 -05002299 CBB cbb;
2300 uint8_t *out;
2301 size_t out_len;
David Benjamine776cc22016-07-19 07:26:49 +02002302 if (!CBB_init(&cbb, strlen(label) + 1 + SSL3_RANDOM_SIZE * 2 + 1 +
2303 secret_len * 2 + 1) ||
2304 !CBB_add_bytes(&cbb, (const uint8_t *)label, strlen(label)) ||
Adam Langleyfcf25832014-12-18 17:42:32 -08002305 !CBB_add_bytes(&cbb, (const uint8_t *)" ", 1) ||
David Benjamine776cc22016-07-19 07:26:49 +02002306 !cbb_add_hex(&cbb, ssl->s3->client_random, SSL3_RANDOM_SIZE) ||
2307 !CBB_add_bytes(&cbb, (const uint8_t *)" ", 1) ||
2308 !cbb_add_hex(&cbb, secret, secret_len) ||
David Benjamind28f59c2015-11-17 22:32:50 -05002309 !CBB_add_u8(&cbb, 0 /* NUL */) ||
Adam Langleyfcf25832014-12-18 17:42:32 -08002310 !CBB_finish(&cbb, &out, &out_len)) {
2311 CBB_cleanup(&cbb);
2312 return 0;
2313 }
Adam Langleyadb739e2014-06-20 12:00:00 -07002314
David Benjamind28f59c2015-11-17 22:32:50 -05002315 ssl->ctx->keylog_callback(ssl, (const char *)out);
Adam Langleyfcf25832014-12-18 17:42:32 -08002316 OPENSSL_free(out);
David Benjamind28f59c2015-11-17 22:32:50 -05002317 return 1;
Adam Langley95c29f32014-06-20 12:00:00 -07002318}
2319
David Benjamin5d8b1282015-10-17 23:26:35 -04002320int SSL_is_init_finished(const SSL *ssl) {
David Benjamin9e766d72017-02-10 23:14:17 -05002321 return !SSL_in_init(ssl);
David Benjamin5d8b1282015-10-17 23:26:35 -04002322}
2323
2324int SSL_in_init(const SSL *ssl) {
David Benjamin9e766d72017-02-10 23:14:17 -05002325 SSL_HANDSHAKE *hs = ssl->s3->hs;
2326 return hs != NULL && hs->state != SSL_ST_OK;
David Benjamin5d8b1282015-10-17 23:26:35 -04002327}
2328
2329int SSL_in_false_start(const SSL *ssl) {
David Benjamina0486782016-10-06 19:11:32 -04002330 if (ssl->s3->hs == NULL) {
2331 return 0;
2332 }
2333 return ssl->s3->hs->in_false_start;
David Benjamined7c4752015-02-16 19:16:46 -05002334}
2335
David Benjamin0d56f882015-12-19 17:05:56 -05002336int SSL_cutthrough_complete(const SSL *ssl) {
2337 return SSL_in_false_start(ssl);
Adam Langleyfcf25832014-12-18 17:42:32 -08002338}
Adam Langley95c29f32014-06-20 12:00:00 -07002339
Adam Langleyfcf25832014-12-18 17:42:32 -08002340void SSL_get_structure_sizes(size_t *ssl_size, size_t *ssl_ctx_size,
2341 size_t *ssl_session_size) {
2342 *ssl_size = sizeof(SSL);
2343 *ssl_ctx_size = sizeof(SSL_CTX);
2344 *ssl_session_size = sizeof(SSL_SESSION);
2345}
Feng Lu41aa3252014-11-21 22:47:56 -08002346
David Benjamin0d56f882015-12-19 17:05:56 -05002347int ssl3_can_false_start(const SSL *ssl) {
2348 const SSL_CIPHER *const cipher = SSL_get_current_cipher(ssl);
Adam Langleyfcf25832014-12-18 17:42:32 -08002349
Adam Langleye631d962015-04-01 13:11:01 -07002350 /* False Start only for TLS 1.2 with an ECDHE+AEAD cipher and ALPN or NPN. */
David Benjamince079fd2016-08-02 16:22:34 -04002351 return !SSL_is_dtls(ssl) &&
Steven Valdez4f94b1c2016-05-24 12:31:07 -04002352 SSL_version(ssl) == TLS1_2_VERSION &&
David Benjaminb74b0812016-10-06 19:43:48 -04002353 (ssl->s3->alpn_selected != NULL ||
2354 ssl->s3->next_proto_negotiated != NULL) &&
David Benjamin195dc782015-02-19 13:27:05 -05002355 cipher != NULL &&
Matthew Braithwaite651aaef2016-12-08 16:14:36 -08002356 cipher->algorithm_mkey == SSL_kECDHE &&
David Benjamin13414b32015-12-09 23:02:39 -05002357 cipher->algorithm_mac == SSL_AEAD;
Adam Langleyfcf25832014-12-18 17:42:32 -08002358}
2359
David Benjaminb6a0a512016-06-21 10:33:21 -04002360const struct {
2361 uint16_t version;
2362 uint32_t flag;
2363} kVersions[] = {
2364 {SSL3_VERSION, SSL_OP_NO_SSLv3},
2365 {TLS1_VERSION, SSL_OP_NO_TLSv1},
2366 {TLS1_1_VERSION, SSL_OP_NO_TLSv1_1},
2367 {TLS1_2_VERSION, SSL_OP_NO_TLSv1_2},
2368 {TLS1_3_VERSION, SSL_OP_NO_TLSv1_3},
2369};
Adam Langleyfcf25832014-12-18 17:42:32 -08002370
Steven Valdezcb966542016-08-17 16:56:14 -04002371static const size_t kVersionsLen = OPENSSL_ARRAY_SIZE(kVersions);
Adam Langleyfcf25832014-12-18 17:42:32 -08002372
David Benjamine0ff7672016-09-19 18:40:03 -04002373int ssl_get_version_range(const SSL *ssl, uint16_t *out_min_version,
2374 uint16_t *out_max_version) {
David Benjaminb6a0a512016-06-21 10:33:21 -04002375 /* For historical reasons, |SSL_OP_NO_DTLSv1| aliases |SSL_OP_NO_TLSv1|, but
2376 * DTLS 1.0 should be mapped to TLS 1.1. */
David Benjamin0d56f882015-12-19 17:05:56 -05002377 uint32_t options = ssl->options;
David Benjamince079fd2016-08-02 16:22:34 -04002378 if (SSL_is_dtls(ssl)) {
David Benjaminb6a0a512016-06-21 10:33:21 -04002379 options &= ~SSL_OP_NO_TLSv1_1;
2380 if (options & SSL_OP_NO_DTLSv1) {
2381 options |= SSL_OP_NO_TLSv1_1;
2382 }
2383 }
2384
2385 uint16_t min_version = ssl->min_version;
2386 uint16_t max_version = ssl->max_version;
2387
2388 /* Bound the range to only those implemented in this protocol. */
2389 if (min_version < ssl->method->min_version) {
2390 min_version = ssl->method->min_version;
2391 }
2392 if (max_version > ssl->method->max_version) {
2393 max_version = ssl->method->max_version;
2394 }
Adam Langleyfcf25832014-12-18 17:42:32 -08002395
2396 /* OpenSSL's API for controlling versions entails blacklisting individual
2397 * protocols. This has two problems. First, on the client, the protocol can
2398 * only express a contiguous range of versions. Second, a library consumer
2399 * trying to set a maximum version cannot disable protocol versions that get
2400 * added in a future version of the library.
2401 *
2402 * To account for both of these, OpenSSL interprets the client-side bitmask
2403 * as a min/max range by picking the lowest contiguous non-empty range of
2404 * enabled protocols. Note that this means it is impossible to set a maximum
David Benjaminb6a0a512016-06-21 10:33:21 -04002405 * version of the higest supported TLS version in a future-proof way. */
David Benjaminb6a0a512016-06-21 10:33:21 -04002406 int any_enabled = 0;
David Benjamin54091232016-09-05 12:47:25 -04002407 for (size_t i = 0; i < kVersionsLen; i++) {
David Benjaminb6a0a512016-06-21 10:33:21 -04002408 /* Only look at the versions already enabled. */
2409 if (min_version > kVersions[i].version) {
2410 continue;
Adam Langleyfcf25832014-12-18 17:42:32 -08002411 }
David Benjaminb6a0a512016-06-21 10:33:21 -04002412 if (max_version < kVersions[i].version) {
2413 break;
Adam Langleyfcf25832014-12-18 17:42:32 -08002414 }
David Benjaminb6a0a512016-06-21 10:33:21 -04002415
2416 if (!(options & kVersions[i].flag)) {
2417 /* The minimum version is the first enabled version. */
2418 if (!any_enabled) {
2419 any_enabled = 1;
2420 min_version = kVersions[i].version;
2421 }
2422 continue;
Adam Langleyfcf25832014-12-18 17:42:32 -08002423 }
David Benjaminb6a0a512016-06-21 10:33:21 -04002424
2425 /* If there is a disabled version after the first enabled one, all versions
2426 * after it are implicitly disabled. */
2427 if (any_enabled) {
2428 max_version = kVersions[i-1].version;
2429 break;
Adam Langleyfcf25832014-12-18 17:42:32 -08002430 }
2431 }
2432
David Benjamine0ff7672016-09-19 18:40:03 -04002433 if (!any_enabled) {
David Benjaminb6a0a512016-06-21 10:33:21 -04002434 OPENSSL_PUT_ERROR(SSL, SSL_R_WRONG_SSL_VERSION);
2435 return 0;
David Benjaminea72bd02014-12-21 21:27:41 -05002436 }
2437
David Benjaminb6a0a512016-06-21 10:33:21 -04002438 *out_min_version = min_version;
2439 *out_max_version = max_version;
2440 return 1;
David Benjaminea72bd02014-12-21 21:27:41 -05002441}
2442
David Benjaminb9e4fa52015-12-29 23:58:17 -05002443uint16_t ssl3_protocol_version(const SSL *ssl) {
2444 assert(ssl->s3->have_version);
David Benjamin2dc02042016-09-19 19:57:37 -04002445 uint16_t version;
2446 if (!ssl->method->version_from_wire(&version, ssl->version)) {
2447 /* TODO(davidben): Use the internal version representation for ssl->version
2448 * and map to the public API representation at API boundaries. */
2449 assert(0);
2450 return 0;
2451 }
2452
2453 return version;
David Benjaminb9e4fa52015-12-29 23:58:17 -05002454}
2455
David Benjamince079fd2016-08-02 16:22:34 -04002456int SSL_is_server(const SSL *ssl) { return ssl->server; }
2457
2458int SSL_is_dtls(const SSL *ssl) { return ssl->method->is_dtls; }
Adam Langleyfcf25832014-12-18 17:42:32 -08002459
David Benjamin731058e2016-12-03 23:15:13 -05002460void SSL_CTX_set_select_certificate_cb(SSL_CTX *ctx,
2461 int (*cb)(const SSL_CLIENT_HELLO *)) {
David Benjamind4c2bce2015-10-17 12:28:18 -04002462 ctx->select_certificate_cb = cb;
2463}
2464
David Benjamin731058e2016-12-03 23:15:13 -05002465void SSL_CTX_set_dos_protection_cb(SSL_CTX *ctx,
2466 int (*cb)(const SSL_CLIENT_HELLO *)) {
Adam Langley524e7172015-02-20 16:04:00 -08002467 ctx->dos_protection_cb = cb;
2468}
2469
David Benjamin1d5ef3b2015-10-12 19:54:18 -04002470void SSL_set_renegotiate_mode(SSL *ssl, enum ssl_renegotiate_mode_t mode) {
2471 ssl->renegotiate_mode = mode;
2472}
2473
Adam Langleyc2d32802015-11-03 18:36:10 -08002474int SSL_get_ivs(const SSL *ssl, const uint8_t **out_read_iv,
2475 const uint8_t **out_write_iv, size_t *out_iv_len) {
David Benjamin79978df2015-12-25 15:56:49 -05002476 if (ssl->s3->aead_read_ctx == NULL || ssl->s3->aead_write_ctx == NULL) {
Adam Langleyc2d32802015-11-03 18:36:10 -08002477 return 0;
2478 }
2479
2480 size_t write_iv_len;
David Benjamin79978df2015-12-25 15:56:49 -05002481 if (!EVP_AEAD_CTX_get_iv(&ssl->s3->aead_read_ctx->ctx, out_read_iv,
2482 out_iv_len) ||
2483 !EVP_AEAD_CTX_get_iv(&ssl->s3->aead_write_ctx->ctx, out_write_iv,
Adam Langleyc2d32802015-11-03 18:36:10 -08002484 &write_iv_len) ||
2485 *out_iv_len != write_iv_len) {
2486 return 0;
2487 }
2488
2489 return 1;
David Benjamine348ff42015-11-06 17:55:30 -05002490}
David Benjamin6e807652015-11-02 12:02:20 -05002491
David Benjamin91b25012016-01-21 16:39:58 -05002492static uint64_t be_to_u64(const uint8_t in[8]) {
David Benjaminde942382016-02-11 12:02:01 -05002493 return (((uint64_t)in[0]) << 56) | (((uint64_t)in[1]) << 48) |
2494 (((uint64_t)in[2]) << 40) | (((uint64_t)in[3]) << 32) |
2495 (((uint64_t)in[4]) << 24) | (((uint64_t)in[5]) << 16) |
2496 (((uint64_t)in[6]) << 8) | ((uint64_t)in[7]);
David Benjamin91b25012016-01-21 16:39:58 -05002497}
2498
2499uint64_t SSL_get_read_sequence(const SSL *ssl) {
2500 /* TODO(davidben): Internally represent sequence numbers as uint64_t. */
David Benjamince079fd2016-08-02 16:22:34 -04002501 if (SSL_is_dtls(ssl)) {
David Benjaminde942382016-02-11 12:02:01 -05002502 /* max_seq_num already includes the epoch. */
2503 assert(ssl->d1->r_epoch == (ssl->d1->bitmap.max_seq_num >> 48));
2504 return ssl->d1->bitmap.max_seq_num;
2505 }
David Benjamin91b25012016-01-21 16:39:58 -05002506 return be_to_u64(ssl->s3->read_sequence);
2507}
2508
2509uint64_t SSL_get_write_sequence(const SSL *ssl) {
David Benjaminde942382016-02-11 12:02:01 -05002510 uint64_t ret = be_to_u64(ssl->s3->write_sequence);
David Benjamince079fd2016-08-02 16:22:34 -04002511 if (SSL_is_dtls(ssl)) {
David Benjaminde942382016-02-11 12:02:01 -05002512 assert((ret >> 48) == 0);
2513 ret |= ((uint64_t)ssl->d1->w_epoch) << 48;
2514 }
2515 return ret;
David Benjamin91b25012016-01-21 16:39:58 -05002516}
2517
Steven Valdez02563852016-06-23 13:33:05 -04002518uint16_t SSL_get_peer_signature_algorithm(const SSL *ssl) {
David Benjaminf1050fd2016-12-13 20:05:36 -05002519 /* TODO(davidben): This checks the wrong session if there is a renegotiation
2520 * in progress. */
2521 SSL_SESSION *session = SSL_get_session(ssl);
2522 if (session == NULL) {
2523 return 0;
2524 }
2525
2526 return session->peer_signature_algorithm;
Steven Valdez02563852016-06-23 13:33:05 -04002527}
2528
David Benjamin96ba15f2015-12-25 14:10:17 -05002529size_t SSL_get_client_random(const SSL *ssl, uint8_t *out, size_t max_out) {
2530 if (max_out == 0) {
2531 return sizeof(ssl->s3->client_random);
2532 }
2533 if (max_out > sizeof(ssl->s3->client_random)) {
2534 max_out = sizeof(ssl->s3->client_random);
2535 }
David Benjamin17cf2cb2016-12-13 01:07:13 -05002536 OPENSSL_memcpy(out, ssl->s3->client_random, max_out);
David Benjamin96ba15f2015-12-25 14:10:17 -05002537 return max_out;
2538}
2539
2540size_t SSL_get_server_random(const SSL *ssl, uint8_t *out, size_t max_out) {
2541 if (max_out == 0) {
2542 return sizeof(ssl->s3->server_random);
2543 }
2544 if (max_out > sizeof(ssl->s3->server_random)) {
2545 max_out = sizeof(ssl->s3->server_random);
2546 }
David Benjamin17cf2cb2016-12-13 01:07:13 -05002547 OPENSSL_memcpy(out, ssl->s3->server_random, max_out);
David Benjamin96ba15f2015-12-25 14:10:17 -05002548 return max_out;
2549}
2550
David Benjaminf6494f42016-01-07 12:37:41 -08002551const SSL_CIPHER *SSL_get_pending_cipher(const SSL *ssl) {
David Benjamin45738dd2017-02-09 20:01:26 -05002552 SSL_HANDSHAKE *hs = ssl->s3->hs;
2553 if (hs == NULL) {
David Benjaminf6494f42016-01-07 12:37:41 -08002554 return NULL;
2555 }
David Benjamin45738dd2017-02-09 20:01:26 -05002556 return hs->new_cipher;
David Benjaminf6494f42016-01-07 12:37:41 -08002557}
2558
David Benjaminbbaf3672016-11-17 10:53:09 +09002559void SSL_set_retain_only_sha256_of_client_certs(SSL *ssl, int enabled) {
2560 ssl->retain_only_sha256_of_client_certs = !!enabled;
2561}
2562
David Benjamincdd0b7e2016-01-07 10:10:41 -08002563void SSL_CTX_set_retain_only_sha256_of_client_certs(SSL_CTX *ctx, int enabled) {
2564 ctx->retain_only_sha256_of_client_certs = !!enabled;
2565}
2566
David Benjamin65ac9972016-09-02 21:35:25 -04002567void SSL_CTX_set_grease_enabled(SSL_CTX *ctx, int enabled) {
2568 ctx->grease_enabled = !!enabled;
2569}
2570
David Benjamin6f600d62016-12-21 16:06:54 -05002571void SSL_CTX_set_short_header_enabled(SSL_CTX *ctx, int enabled) {
2572 ctx->short_header_enabled = !!enabled;
2573}
2574
David Benjamin27bbae42015-09-13 00:54:37 -04002575int SSL_clear(SSL *ssl) {
David Benjaminb79cc842016-12-07 15:57:14 -05002576 /* In OpenSSL, reusing a client |SSL| with |SSL_clear| causes the previously
2577 * established session to be offered the next time around. wpa_supplicant
2578 * depends on this behavior, so emulate it. */
2579 SSL_SESSION *session = NULL;
2580 if (!ssl->server && ssl->s3->established_session != NULL) {
2581 session = ssl->s3->established_session;
2582 SSL_SESSION_up_ref(session);
2583 }
2584
David Benjamin27bbae42015-09-13 00:54:37 -04002585 /* TODO(davidben): Some state on |ssl| is reset both in |SSL_new| and
2586 * |SSL_clear| because it is per-connection state rather than configuration
2587 * state. Per-connection state should be on |ssl->s3| and |ssl->d1| so it is
2588 * naturally reset at the right points between |SSL_new|, |SSL_clear|, and
2589 * |ssl3_new|. */
2590
2591 ssl->rwstate = SSL_NOTHING;
2592
2593 BUF_MEM_free(ssl->init_buf);
2594 ssl->init_buf = NULL;
David Benjamin49054542016-07-27 13:51:01 -04002595 ssl->init_msg = NULL;
2596 ssl->init_num = 0;
David Benjamin27bbae42015-09-13 00:54:37 -04002597
David Benjamin27bbae42015-09-13 00:54:37 -04002598 /* The ssl->d1->mtu is simultaneously configuration (preserved across
2599 * clear) and connection-specific state (gets reset).
2600 *
2601 * TODO(davidben): Avoid this. */
2602 unsigned mtu = 0;
2603 if (ssl->d1 != NULL) {
2604 mtu = ssl->d1->mtu;
2605 }
2606
2607 ssl->method->ssl_free(ssl);
2608 if (!ssl->method->ssl_new(ssl)) {
David Benjaminb79cc842016-12-07 15:57:14 -05002609 SSL_SESSION_free(session);
David Benjamin27bbae42015-09-13 00:54:37 -04002610 return 0;
2611 }
David Benjamin27bbae42015-09-13 00:54:37 -04002612
David Benjamince079fd2016-08-02 16:22:34 -04002613 if (SSL_is_dtls(ssl) && (SSL_get_options(ssl) & SSL_OP_NO_QUERY_MTU)) {
David Benjamin27bbae42015-09-13 00:54:37 -04002614 ssl->d1->mtu = mtu;
2615 }
2616
David Benjaminb79cc842016-12-07 15:57:14 -05002617 if (session != NULL) {
2618 SSL_set_session(ssl, session);
2619 SSL_SESSION_free(session);
2620 }
2621
David Benjamin27bbae42015-09-13 00:54:37 -04002622 return 1;
2623}
2624
David Benjamin4e9cc712016-06-01 20:16:03 -04002625void ssl_do_info_callback(const SSL *ssl, int type, int value) {
2626 void (*cb)(const SSL *ssl, int type, int value) = NULL;
2627 if (ssl->info_callback != NULL) {
2628 cb = ssl->info_callback;
2629 } else if (ssl->ctx->info_callback != NULL) {
2630 cb = ssl->ctx->info_callback;
2631 }
2632
2633 if (cb != NULL) {
2634 cb(ssl, type, value);
2635 }
2636}
2637
David Benjaminc0279992016-09-19 20:15:07 -04002638void ssl_do_msg_callback(SSL *ssl, int is_write, int content_type,
David Benjamin4e9cc712016-06-01 20:16:03 -04002639 const void *buf, size_t len) {
David Benjaminc0279992016-09-19 20:15:07 -04002640 if (ssl->msg_callback == NULL) {
2641 return;
David Benjamin4e9cc712016-06-01 20:16:03 -04002642 }
David Benjaminc0279992016-09-19 20:15:07 -04002643
2644 /* |version| is zero when calling for |SSL3_RT_HEADER| and |SSL2_VERSION| for
2645 * a V2ClientHello. */
2646 int version;
2647 switch (content_type) {
2648 case 0:
2649 /* V2ClientHello */
2650 version = SSL2_VERSION;
2651 break;
2652 case SSL3_RT_HEADER:
2653 version = 0;
2654 break;
2655 default:
Steven Valdezfdd10992016-09-15 16:27:05 -04002656 version = SSL_version(ssl);
David Benjaminc0279992016-09-19 20:15:07 -04002657 }
2658
2659 ssl->msg_callback(is_write, version, content_type, buf, len, ssl,
2660 ssl->msg_callback_arg);
David Benjamin4e9cc712016-06-01 20:16:03 -04002661}
2662
David Benjaminda881e92015-04-26 14:45:04 -04002663int SSL_CTX_sess_connect(const SSL_CTX *ctx) { return 0; }
2664int SSL_CTX_sess_connect_good(const SSL_CTX *ctx) { return 0; }
2665int SSL_CTX_sess_connect_renegotiate(const SSL_CTX *ctx) { return 0; }
2666int SSL_CTX_sess_accept(const SSL_CTX *ctx) { return 0; }
2667int SSL_CTX_sess_accept_renegotiate(const SSL_CTX *ctx) { return 0; }
2668int SSL_CTX_sess_accept_good(const SSL_CTX *ctx) { return 0; }
2669int SSL_CTX_sess_hits(const SSL_CTX *ctx) { return 0; }
2670int SSL_CTX_sess_cb_hits(const SSL_CTX *ctx) { return 0; }
2671int SSL_CTX_sess_misses(const SSL_CTX *ctx) { return 0; }
2672int SSL_CTX_sess_timeouts(const SSL_CTX *ctx) { return 0; }
2673int SSL_CTX_sess_cache_full(const SSL_CTX *ctx) { return 0; }
David Benjamin936aada2016-06-07 19:09:22 -04002674
2675int SSL_num_renegotiations(const SSL *ssl) {
2676 return SSL_total_renegotiations(ssl);
2677}
2678
2679int SSL_CTX_need_tmp_RSA(const SSL_CTX *ctx) { return 0; }
2680int SSL_need_tmp_RSA(const SSL *ssl) { return 0; }
2681int SSL_CTX_set_tmp_rsa(SSL_CTX *ctx, const RSA *rsa) { return 1; }
2682int SSL_set_tmp_rsa(SSL *ssl, const RSA *rsa) { return 1; }
Matt Braithwaite4838d8a2015-08-20 13:20:03 -07002683void ERR_load_SSL_strings(void) {}
David Benjamin27bbae42015-09-13 00:54:37 -04002684void SSL_load_error_strings(void) {}
David Benjamin936aada2016-06-07 19:09:22 -04002685int SSL_cache_hit(SSL *ssl) { return SSL_session_reused(ssl); }
2686
2687int SSL_CTX_set_tmp_ecdh(SSL_CTX *ctx, const EC_KEY *ec_key) {
2688 if (ec_key == NULL || EC_KEY_get0_group(ec_key) == NULL) {
2689 OPENSSL_PUT_ERROR(SSL, ERR_R_PASSED_NULL_PARAMETER);
2690 return 0;
2691 }
2692 int nid = EC_GROUP_get_curve_name(EC_KEY_get0_group(ec_key));
2693 return SSL_CTX_set1_curves(ctx, &nid, 1);
2694}
2695
2696int SSL_set_tmp_ecdh(SSL *ssl, const EC_KEY *ec_key) {
2697 if (ec_key == NULL || EC_KEY_get0_group(ec_key) == NULL) {
2698 OPENSSL_PUT_ERROR(SSL, ERR_R_PASSED_NULL_PARAMETER);
2699 return 0;
2700 }
2701 int nid = EC_GROUP_get_curve_name(EC_KEY_get0_group(ec_key));
2702 return SSL_set1_curves(ssl, &nid, 1);
2703}
David Benjamin721e8b72016-08-03 13:13:17 -04002704
2705void ssl_get_current_time(const SSL *ssl, struct timeval *out_clock) {
2706 if (ssl->ctx->current_time_cb != NULL) {
2707 ssl->ctx->current_time_cb(ssl, out_clock);
2708 return;
2709 }
2710
David Benjaminec978dd2016-11-04 18:59:33 -04002711#if defined(BORINGSSL_UNSAFE_DETERMINISTIC_MODE)
David Benjamin01a90572016-09-22 00:11:43 -04002712 out_clock->tv_sec = 1234;
2713 out_clock->tv_usec = 1234;
2714#elif defined(OPENSSL_WINDOWS)
David Benjamin721e8b72016-08-03 13:13:17 -04002715 struct _timeb time;
2716 _ftime(&time);
2717 out_clock->tv_sec = time.time;
2718 out_clock->tv_usec = time.millitm * 1000;
2719#else
2720 gettimeofday(out_clock, NULL);
2721#endif
2722}
David Benjamine4706902016-09-20 15:12:23 -04002723
2724int SSL_CTX_set_min_version(SSL_CTX *ctx, uint16_t version) {
2725 return SSL_CTX_set_min_proto_version(ctx, version);
2726}
2727
2728int SSL_CTX_set_max_version(SSL_CTX *ctx, uint16_t version) {
2729 return SSL_CTX_set_max_proto_version(ctx, version);
2730}
2731
2732int SSL_set_min_version(SSL *ssl, uint16_t version) {
2733 return SSL_set_min_proto_version(ssl, version);
2734}
2735
2736int SSL_set_max_version(SSL *ssl, uint16_t version) {
2737 return SSL_set_max_proto_version(ssl, version);
2738}