blob: 57178cf59fcfcca4d2c26ddcf5dd4a31d9635d38 [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,
David Benjamind2cb1c12016-11-02 17:49:09 -0400280 SSL_DEFAULT_CIPHER_LIST);
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
292 ret->client_CA = sk_X509_NAME_new_null();
293 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);
361 sk_X509_NAME_pop_free(ctx->client_CA, X509_NAME_free);
362 sk_SRTP_PROTECTION_PROFILE_free(ctx->srtp_profiles);
363 OPENSSL_free(ctx->psk_identity_hint);
Steven Valdezce902a92016-05-17 11:47:53 -0400364 OPENSSL_free(ctx->supported_group_list);
David Benjamin27bbae42015-09-13 00:54:37 -0400365 OPENSSL_free(ctx->alpn_client_proto_list);
David Benjamin27bbae42015-09-13 00:54:37 -0400366 EVP_PKEY_free(ctx->tlsext_channel_id_private);
David Benjamin27bbae42015-09-13 00:54:37 -0400367
368 OPENSSL_free(ctx);
Adam Langleyfcf25832014-12-18 17:42:32 -0800369}
Adam Langley95c29f32014-06-20 12:00:00 -0700370
Adam Langleyfcf25832014-12-18 17:42:32 -0800371SSL *SSL_new(SSL_CTX *ctx) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800372 if (ctx == NULL) {
David Benjamin3570d732015-06-29 00:28:17 -0400373 OPENSSL_PUT_ERROR(SSL, SSL_R_NULL_SSL_CTX);
Adam Langleyfcf25832014-12-18 17:42:32 -0800374 return NULL;
375 }
376 if (ctx->method == NULL) {
David Benjamin3570d732015-06-29 00:28:17 -0400377 OPENSSL_PUT_ERROR(SSL, SSL_R_SSL_CTX_HAS_NO_DEFAULT_SSL_VERSION);
Adam Langleyfcf25832014-12-18 17:42:32 -0800378 return NULL;
379 }
Adam Langley95c29f32014-06-20 12:00:00 -0700380
Brian Smith5ba06892016-02-07 09:36:04 -1000381 SSL *ssl = OPENSSL_malloc(sizeof(SSL));
David Benjamin0d56f882015-12-19 17:05:56 -0500382 if (ssl == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800383 goto err;
384 }
David Benjamin17cf2cb2016-12-13 01:07:13 -0500385 OPENSSL_memset(ssl, 0, sizeof(SSL));
Adam Langley95c29f32014-06-20 12:00:00 -0700386
David Benjamin0d56f882015-12-19 17:05:56 -0500387 ssl->min_version = ctx->min_version;
388 ssl->max_version = ctx->max_version;
David Benjamin1eb367c2014-12-12 18:17:51 -0500389
Taylor Brandstetter376a0fe2016-05-10 19:30:28 -0700390 /* RFC 6347 states that implementations SHOULD use an initial timer value of
391 * 1 second. */
392 ssl->initial_timeout_duration_ms = 1000;
393
David Benjamin0d56f882015-12-19 17:05:56 -0500394 ssl->options = ctx->options;
395 ssl->mode = ctx->mode;
396 ssl->max_cert_list = ctx->max_cert_list;
Adam Langley95c29f32014-06-20 12:00:00 -0700397
David Benjamin0d56f882015-12-19 17:05:56 -0500398 ssl->cert = ssl_cert_dup(ctx->cert);
399 if (ssl->cert == NULL) {
David Benjamina5a3eeb2015-03-18 20:26:30 -0400400 goto err;
Adam Langleyfcf25832014-12-18 17:42:32 -0800401 }
Adam Langley95c29f32014-06-20 12:00:00 -0700402
David Benjamin0d56f882015-12-19 17:05:56 -0500403 ssl->msg_callback = ctx->msg_callback;
404 ssl->msg_callback_arg = ctx->msg_callback_arg;
405 ssl->verify_mode = ctx->verify_mode;
David Benjamin0d56f882015-12-19 17:05:56 -0500406 ssl->verify_callback = ctx->default_verify_callback;
David Benjaminbbaf3672016-11-17 10:53:09 +0900407 ssl->retain_only_sha256_of_client_certs =
408 ctx->retain_only_sha256_of_client_certs;
Adam Langley95c29f32014-06-20 12:00:00 -0700409
David Benjamin0d56f882015-12-19 17:05:56 -0500410 ssl->param = X509_VERIFY_PARAM_new();
411 if (!ssl->param) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800412 goto err;
413 }
David Benjamin0d56f882015-12-19 17:05:56 -0500414 X509_VERIFY_PARAM_inherit(ssl->param, ctx->param);
415 ssl->quiet_shutdown = ctx->quiet_shutdown;
416 ssl->max_send_fragment = ctx->max_send_fragment;
Adam Langley95c29f32014-06-20 12:00:00 -0700417
David Benjaminf650c712016-12-22 15:54:51 -0500418 SSL_CTX_up_ref(ctx);
David Benjamin0d56f882015-12-19 17:05:56 -0500419 ssl->ctx = ctx;
David Benjaminf650c712016-12-22 15:54:51 -0500420 SSL_CTX_up_ref(ctx);
David Benjamin0d56f882015-12-19 17:05:56 -0500421 ssl->initial_ctx = ctx;
Adam Langley95c29f32014-06-20 12:00:00 -0700422
Steven Valdezce902a92016-05-17 11:47:53 -0400423 if (ctx->supported_group_list) {
David Benjamin17b30832017-01-28 14:00:32 -0500424 ssl->supported_group_list = BUF_memdup(ctx->supported_group_list,
425 ctx->supported_group_list_len * 2);
Steven Valdezce902a92016-05-17 11:47:53 -0400426 if (!ssl->supported_group_list) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800427 goto err;
428 }
Steven Valdezce902a92016-05-17 11:47:53 -0400429 ssl->supported_group_list_len = ctx->supported_group_list_len;
Adam Langleyfcf25832014-12-18 17:42:32 -0800430 }
Adam Langley95c29f32014-06-20 12:00:00 -0700431
David Benjamin17b30832017-01-28 14:00:32 -0500432 if (ctx->alpn_client_proto_list) {
433 ssl->alpn_client_proto_list = BUF_memdup(ctx->alpn_client_proto_list,
434 ctx->alpn_client_proto_list_len);
David Benjamin0d56f882015-12-19 17:05:56 -0500435 if (ssl->alpn_client_proto_list == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800436 goto err;
437 }
David Benjamin17b30832017-01-28 14:00:32 -0500438 ssl->alpn_client_proto_list_len = ctx->alpn_client_proto_list_len;
Adam Langleyfcf25832014-12-18 17:42:32 -0800439 }
Adam Langley95c29f32014-06-20 12:00:00 -0700440
David Benjamin0d56f882015-12-19 17:05:56 -0500441 ssl->method = ctx->method;
Adam Langley95c29f32014-06-20 12:00:00 -0700442
David Benjamin0d56f882015-12-19 17:05:56 -0500443 if (!ssl->method->ssl_new(ssl)) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800444 goto err;
445 }
Adam Langley95c29f32014-06-20 12:00:00 -0700446
David Benjamin0d56f882015-12-19 17:05:56 -0500447 ssl->rwstate = SSL_NOTHING;
Adam Langley95c29f32014-06-20 12:00:00 -0700448
David Benjamin0d56f882015-12-19 17:05:56 -0500449 CRYPTO_new_ex_data(&ssl->ex_data);
Adam Langley95c29f32014-06-20 12:00:00 -0700450
David Benjamin0d56f882015-12-19 17:05:56 -0500451 ssl->psk_identity_hint = NULL;
Adam Langleyfcf25832014-12-18 17:42:32 -0800452 if (ctx->psk_identity_hint) {
David Benjamin0d56f882015-12-19 17:05:56 -0500453 ssl->psk_identity_hint = BUF_strdup(ctx->psk_identity_hint);
454 if (ssl->psk_identity_hint == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800455 goto err;
456 }
457 }
David Benjamin0d56f882015-12-19 17:05:56 -0500458 ssl->psk_client_callback = ctx->psk_client_callback;
459 ssl->psk_server_callback = ctx->psk_server_callback;
Adam Langley95c29f32014-06-20 12:00:00 -0700460
David Benjamin0d56f882015-12-19 17:05:56 -0500461 ssl->tlsext_channel_id_enabled = ctx->tlsext_channel_id_enabled;
David Benjamin02ddbfd2015-01-11 13:09:11 -0500462 if (ctx->tlsext_channel_id_private) {
Adam Langley310d3f62016-07-12 10:39:20 -0700463 EVP_PKEY_up_ref(ctx->tlsext_channel_id_private);
464 ssl->tlsext_channel_id_private = ctx->tlsext_channel_id_private;
David Benjamin02ddbfd2015-01-11 13:09:11 -0500465 }
466
David Benjamin17b30832017-01-28 14:00:32 -0500467 ssl->signed_cert_timestamps_enabled = ctx->signed_cert_timestamps_enabled;
468 ssl->ocsp_stapling_enabled = ctx->ocsp_stapling_enabled;
HÃ¥vard Molland9169c962014-08-14 14:42:37 +0200469
David Benjamin0d56f882015-12-19 17:05:56 -0500470 return ssl;
Adam Langleyfcf25832014-12-18 17:42:32 -0800471
Adam Langley95c29f32014-06-20 12:00:00 -0700472err:
David Benjamin0d56f882015-12-19 17:05:56 -0500473 SSL_free(ssl);
David Benjamin3570d732015-06-29 00:28:17 -0400474 OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
Adam Langley95c29f32014-06-20 12:00:00 -0700475
Adam Langleyfcf25832014-12-18 17:42:32 -0800476 return NULL;
477}
Adam Langley95c29f32014-06-20 12:00:00 -0700478
David Benjamin27bbae42015-09-13 00:54:37 -0400479void SSL_free(SSL *ssl) {
480 if (ssl == NULL) {
481 return;
482 }
483
484 X509_VERIFY_PARAM_free(ssl->param);
485
486 CRYPTO_free_ex_data(&g_ex_data_class_ssl, ssl, &ssl->ex_data);
487
David Benjamin27bbae42015-09-13 00:54:37 -0400488 BIO_free_all(ssl->rbio);
David Benjaminf715c422016-06-11 19:01:56 -0400489 BIO_free_all(ssl->wbio);
David Benjamin27bbae42015-09-13 00:54:37 -0400490
491 BUF_MEM_free(ssl->init_buf);
492
493 /* add extra stuff */
494 ssl_cipher_preference_list_free(ssl->cipher_list);
David Benjamin27bbae42015-09-13 00:54:37 -0400495
David Benjamin27bbae42015-09-13 00:54:37 -0400496 SSL_SESSION_free(ssl->session);
497
David Benjamin27bbae42015-09-13 00:54:37 -0400498 ssl_cert_free(ssl->cert);
499
500 OPENSSL_free(ssl->tlsext_hostname);
501 SSL_CTX_free(ssl->initial_ctx);
Steven Valdezce902a92016-05-17 11:47:53 -0400502 OPENSSL_free(ssl->supported_group_list);
David Benjamin27bbae42015-09-13 00:54:37 -0400503 OPENSSL_free(ssl->alpn_client_proto_list);
504 EVP_PKEY_free(ssl->tlsext_channel_id_private);
505 OPENSSL_free(ssl->psk_identity_hint);
506 sk_X509_NAME_pop_free(ssl->client_CA, X509_NAME_free);
David Benjamin27bbae42015-09-13 00:54:37 -0400507 sk_SRTP_PROTECTION_PROFILE_free(ssl->srtp_profiles);
508
509 if (ssl->method != NULL) {
510 ssl->method->ssl_free(ssl);
511 }
512 SSL_CTX_free(ssl->ctx);
513
514 OPENSSL_free(ssl);
515}
516
517void SSL_set_connect_state(SSL *ssl) {
518 ssl->server = 0;
David Benjamin9f1dc822016-06-07 17:03:46 -0400519 ssl->handshake_func = ssl3_connect;
David Benjamin27bbae42015-09-13 00:54:37 -0400520}
521
522void SSL_set_accept_state(SSL *ssl) {
523 ssl->server = 1;
David Benjamin9f1dc822016-06-07 17:03:46 -0400524 ssl->handshake_func = ssl3_accept;
David Benjamin27bbae42015-09-13 00:54:37 -0400525}
526
David Benjamin4501bd52016-08-01 13:39:41 -0400527void SSL_set0_rbio(SSL *ssl, BIO *rbio) {
David Benjaminf715c422016-06-11 19:01:56 -0400528 BIO_free_all(ssl->rbio);
529 ssl->rbio = rbio;
530}
531
David Benjamin4501bd52016-08-01 13:39:41 -0400532void SSL_set0_wbio(SSL *ssl, BIO *wbio) {
David Benjaminf715c422016-06-11 19:01:56 -0400533 BIO_free_all(ssl->wbio);
David Benjamin27bbae42015-09-13 00:54:37 -0400534 ssl->wbio = wbio;
535}
536
David Benjaminf715c422016-06-11 19:01:56 -0400537void SSL_set_bio(SSL *ssl, BIO *rbio, BIO *wbio) {
538 /* For historical reasons, this function has many different cases in ownership
539 * handling. */
540
David Benjamin4501bd52016-08-01 13:39:41 -0400541 /* If nothing has changed, do nothing */
542 if (rbio == SSL_get_rbio(ssl) && wbio == SSL_get_wbio(ssl)) {
543 return;
544 }
545
David Benjaminf715c422016-06-11 19:01:56 -0400546 /* If the two arguments are equal, one fewer reference is granted than
547 * taken. */
548 if (rbio != NULL && rbio == wbio) {
549 BIO_up_ref(rbio);
550 }
551
David Benjamin4501bd52016-08-01 13:39:41 -0400552 /* If only the wbio is changed, adopt only one reference. */
David Benjaminf715c422016-06-11 19:01:56 -0400553 if (rbio == SSL_get_rbio(ssl)) {
David Benjamin4501bd52016-08-01 13:39:41 -0400554 SSL_set0_wbio(ssl, wbio);
David Benjaminf715c422016-06-11 19:01:56 -0400555 return;
556 }
David Benjamin4501bd52016-08-01 13:39:41 -0400557
558 /* There is an asymmetry here for historical reasons. If only the rbio is
559 * changed AND the rbio and wbio were originally different, then we only adopt
560 * one reference. */
561 if (wbio == SSL_get_wbio(ssl) && SSL_get_rbio(ssl) != SSL_get_wbio(ssl)) {
562 SSL_set0_rbio(ssl, rbio);
David Benjaminf715c422016-06-11 19:01:56 -0400563 return;
564 }
565
566 /* Otherwise, adopt both references. */
David Benjamin4501bd52016-08-01 13:39:41 -0400567 SSL_set0_rbio(ssl, rbio);
568 SSL_set0_wbio(ssl, wbio);
David Benjaminf715c422016-06-11 19:01:56 -0400569}
570
David Benjamin27bbae42015-09-13 00:54:37 -0400571BIO *SSL_get_rbio(const SSL *ssl) { return ssl->rbio; }
572
David Benjamindaf207a2017-01-03 18:37:41 -0500573BIO *SSL_get_wbio(const SSL *ssl) { return ssl->wbio; }
David Benjamin27bbae42015-09-13 00:54:37 -0400574
David Benjamin2be4aa72017-01-02 07:56:51 -0500575void ssl_reset_error_state(SSL *ssl) {
576 /* Functions which use |SSL_get_error| must reset I/O and error state on
577 * entry. */
David Benjamin4c5ddb82016-03-11 22:56:19 -0500578 ssl->rwstate = SSL_NOTHING;
David Benjamin15c14882016-03-14 14:25:46 -0400579 ERR_clear_error();
David Benjamin0d275bd2016-06-01 20:19:34 -0400580 ERR_clear_system_error();
David Benjamin2be4aa72017-01-02 07:56:51 -0500581}
582
583int SSL_do_handshake(SSL *ssl) {
584 ssl_reset_error_state(ssl);
David Benjamin15c14882016-03-14 14:25:46 -0400585
David Benjamin27bbae42015-09-13 00:54:37 -0400586 if (ssl->handshake_func == NULL) {
587 OPENSSL_PUT_ERROR(SSL, SSL_R_CONNECTION_TYPE_NOT_SET);
588 return -1;
589 }
590
591 if (!SSL_in_init(ssl)) {
592 return 1;
593 }
594
David Benjamin2644a132016-12-11 13:41:17 -0500595 if (ssl->s3->hs == NULL) {
596 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
597 return -1;
David Benjamince8c9d22016-11-14 10:45:16 +0900598 }
599
600 /* Run the handshake. */
601 assert(ssl->s3->hs != NULL);
602 int ret = ssl->handshake_func(ssl->s3->hs);
603 if (ret <= 0) {
604 return ret;
605 }
606
607 /* Destroy the handshake object if the handshake has completely finished. */
608 if (!SSL_in_init(ssl)) {
609 ssl_handshake_free(ssl->s3->hs);
610 ssl->s3->hs = NULL;
611 }
612
613 return 1;
David Benjamin27bbae42015-09-13 00:54:37 -0400614}
615
616int SSL_connect(SSL *ssl) {
David Benjaminb2a73182016-03-10 01:25:26 -0500617 if (ssl->handshake_func == NULL) {
David Benjamin27bbae42015-09-13 00:54:37 -0400618 /* Not properly initialized yet */
619 SSL_set_connect_state(ssl);
620 }
621
David Benjamin15c14882016-03-14 14:25:46 -0400622 return SSL_do_handshake(ssl);
David Benjamin27bbae42015-09-13 00:54:37 -0400623}
624
625int SSL_accept(SSL *ssl) {
David Benjaminb2a73182016-03-10 01:25:26 -0500626 if (ssl->handshake_func == NULL) {
David Benjamin27bbae42015-09-13 00:54:37 -0400627 /* Not properly initialized yet */
628 SSL_set_accept_state(ssl);
629 }
630
David Benjamin15c14882016-03-14 14:25:46 -0400631 return SSL_do_handshake(ssl);
David Benjamin27bbae42015-09-13 00:54:37 -0400632}
633
David Benjamin163f29a2016-07-28 11:05:58 -0400634static int ssl_do_renegotiate(SSL *ssl) {
David Benjamin34941c02016-10-08 11:45:31 -0400635 /* We do not accept renegotiations as a server or SSL 3.0. SSL 3.0 will be
636 * removed entirely in the future and requires retaining more data for
637 * renegotiation_info. */
638 if (ssl->server || ssl->version == SSL3_VERSION) {
David Benjamin163f29a2016-07-28 11:05:58 -0400639 goto no_renegotiation;
640 }
641
642 if (ssl->s3->tmp.message_type != SSL3_MT_HELLO_REQUEST ||
643 ssl->init_num != 0) {
644 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_DECODE_ERROR);
645 OPENSSL_PUT_ERROR(SSL, SSL_R_BAD_HELLO_REQUEST);
646 return 0;
647 }
648
649 switch (ssl->renegotiate_mode) {
650 case ssl_renegotiate_ignore:
651 /* Ignore the HelloRequest. */
652 return 1;
653
654 case ssl_renegotiate_once:
655 if (ssl->s3->total_renegotiations != 0) {
656 goto no_renegotiation;
657 }
658 break;
659
660 case ssl_renegotiate_never:
661 goto no_renegotiation;
662
663 case ssl_renegotiate_freely:
664 break;
665 }
666
667 /* Renegotiation is only supported at quiescent points in the application
668 * protocol, namely in HTTPS, just before reading the HTTP response. Require
669 * the record-layer be idle and avoid complexities of sending a handshake
670 * record while an application_data record is being written. */
671 if (ssl_write_buffer_is_pending(ssl)) {
672 goto no_renegotiation;
673 }
674
675 /* Begin a new handshake. */
David Benjamin2644a132016-12-11 13:41:17 -0500676 if (ssl->s3->hs != NULL) {
677 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
678 return 0;
679 }
680 ssl->s3->hs = ssl_handshake_new(ssl);
681 if (ssl->s3->hs == NULL) {
682 return 0;
683 }
684
David Benjamin163f29a2016-07-28 11:05:58 -0400685 ssl->s3->total_renegotiations++;
David Benjamin163f29a2016-07-28 11:05:58 -0400686 return 1;
687
688no_renegotiation:
689 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_NO_RENEGOTIATION);
690 OPENSSL_PUT_ERROR(SSL, SSL_R_NO_RENEGOTIATION);
691 return 0;
692}
693
694static int ssl_do_post_handshake(SSL *ssl) {
695 if (ssl3_protocol_version(ssl) < TLS1_3_VERSION) {
696 return ssl_do_renegotiate(ssl);
697 }
698
Steven Valdez8e1c7be2016-07-26 12:39:22 -0400699 return tls13_post_handshake(ssl);
David Benjamin163f29a2016-07-28 11:05:58 -0400700}
701
David Benjamin15c14882016-03-14 14:25:46 -0400702static int ssl_read_impl(SSL *ssl, void *buf, int num, int peek) {
David Benjamin2be4aa72017-01-02 07:56:51 -0500703 ssl_reset_error_state(ssl);
David Benjamin15c14882016-03-14 14:25:46 -0400704
David Benjaminb2a73182016-03-10 01:25:26 -0500705 if (ssl->handshake_func == NULL) {
David Benjamin27bbae42015-09-13 00:54:37 -0400706 OPENSSL_PUT_ERROR(SSL, SSL_R_UNINITIALIZED);
707 return -1;
708 }
709
David Benjamin163f29a2016-07-28 11:05:58 -0400710 for (;;) {
711 /* Complete the current handshake, if any. False Start will cause
712 * |SSL_do_handshake| to return mid-handshake, so this may require multiple
713 * iterations. */
714 while (SSL_in_init(ssl)) {
715 int ret = SSL_do_handshake(ssl);
716 if (ret < 0) {
717 return ret;
718 }
719 if (ret == 0) {
720 OPENSSL_PUT_ERROR(SSL, SSL_R_SSL_HANDSHAKE_FAILURE);
721 return -1;
722 }
723 }
724
725 int got_handshake;
726 int ret = ssl->method->read_app_data(ssl, &got_handshake, buf, num, peek);
727 if (ret > 0 || !got_handshake) {
Steven Valdez32635b82016-08-16 11:25:03 -0400728 ssl->s3->key_update_count = 0;
David Benjaminc79845c2016-03-10 01:28:00 -0500729 return ret;
730 }
David Benjamin163f29a2016-07-28 11:05:58 -0400731
732 /* Handle the post-handshake message and try again. */
733 if (!ssl_do_post_handshake(ssl)) {
David Benjaminc79845c2016-03-10 01:28:00 -0500734 return -1;
735 }
David Benjamin163f29a2016-07-28 11:05:58 -0400736 ssl->method->release_current_message(ssl, 1 /* free buffer */);
David Benjaminc79845c2016-03-10 01:28:00 -0500737 }
David Benjamin15c14882016-03-14 14:25:46 -0400738}
739
740int SSL_read(SSL *ssl, void *buf, int num) {
741 return ssl_read_impl(ssl, buf, num, 0 /* consume bytes */);
David Benjamin27bbae42015-09-13 00:54:37 -0400742}
743
744int SSL_peek(SSL *ssl, void *buf, int num) {
David Benjamin15c14882016-03-14 14:25:46 -0400745 return ssl_read_impl(ssl, buf, num, 1 /* peek */);
David Benjamin27bbae42015-09-13 00:54:37 -0400746}
747
748int SSL_write(SSL *ssl, const void *buf, int num) {
David Benjamin2be4aa72017-01-02 07:56:51 -0500749 ssl_reset_error_state(ssl);
David Benjamin15c14882016-03-14 14:25:46 -0400750
David Benjaminb2a73182016-03-10 01:25:26 -0500751 if (ssl->handshake_func == NULL) {
David Benjamin27bbae42015-09-13 00:54:37 -0400752 OPENSSL_PUT_ERROR(SSL, SSL_R_UNINITIALIZED);
753 return -1;
754 }
755
David Benjaminfa214e42016-05-10 17:03:10 -0400756 if (ssl->s3->send_shutdown != ssl_shutdown_none) {
David Benjamin27bbae42015-09-13 00:54:37 -0400757 OPENSSL_PUT_ERROR(SSL, SSL_R_PROTOCOL_IS_SHUTDOWN);
758 return -1;
759 }
760
David Benjamind7ac1432016-03-10 00:41:25 -0500761 /* If necessary, complete the handshake implicitly. */
762 if (SSL_in_init(ssl) && !SSL_in_false_start(ssl)) {
763 int ret = SSL_do_handshake(ssl);
764 if (ret < 0) {
765 return ret;
766 }
767 if (ret == 0) {
768 OPENSSL_PUT_ERROR(SSL, SSL_R_SSL_HANDSHAKE_FAILURE);
769 return -1;
770 }
771 }
772
David Benjaminf0ee9072016-06-15 17:44:37 -0400773 return ssl->method->write_app_data(ssl, buf, num);
David Benjamin27bbae42015-09-13 00:54:37 -0400774}
775
776int SSL_shutdown(SSL *ssl) {
David Benjamin2be4aa72017-01-02 07:56:51 -0500777 ssl_reset_error_state(ssl);
David Benjamin15c14882016-03-14 14:25:46 -0400778
David Benjaminb2a73182016-03-10 01:25:26 -0500779 if (ssl->handshake_func == NULL) {
David Benjamin27bbae42015-09-13 00:54:37 -0400780 OPENSSL_PUT_ERROR(SSL, SSL_R_UNINITIALIZED);
781 return -1;
782 }
783
David Benjamin12709db2017-02-17 13:51:50 -0500784 /* If we are in the middle of a handshake, silently succeed. Consumers often
785 * call this function before |SSL_free|, whether the handshake succeeded or
786 * not. We assume the caller has already handled failed handshakes. */
Steven Valdeza14934f2016-02-29 10:05:08 -0500787 if (SSL_in_init(ssl)) {
David Benjamin12709db2017-02-17 13:51:50 -0500788 return 1;
Steven Valdeza14934f2016-02-29 10:05:08 -0500789 }
790
David Benjamin27bbae42015-09-13 00:54:37 -0400791 if (ssl->quiet_shutdown) {
David Benjaminfa214e42016-05-10 17:03:10 -0400792 /* Do nothing if configured not to send a close_notify. */
793 ssl->s3->send_shutdown = ssl_shutdown_close_notify;
794 ssl->s3->recv_shutdown = ssl_shutdown_close_notify;
David Benjamin27bbae42015-09-13 00:54:37 -0400795 return 1;
796 }
797
David Benjaminfa214e42016-05-10 17:03:10 -0400798 /* This function completes in two stages. It sends a close_notify and then it
799 * waits for a close_notify to come in. Perform exactly one action and return
800 * whether or not it succeeds. */
David Benjamin27bbae42015-09-13 00:54:37 -0400801
David Benjaminfa214e42016-05-10 17:03:10 -0400802 if (ssl->s3->send_shutdown != ssl_shutdown_close_notify) {
803 /* Send a close_notify. */
804 if (ssl3_send_alert(ssl, SSL3_AL_WARNING, SSL_AD_CLOSE_NOTIFY) <= 0) {
805 return -1;
David Benjamin27bbae42015-09-13 00:54:37 -0400806 }
807 } else if (ssl->s3->alert_dispatch) {
David Benjaminfa214e42016-05-10 17:03:10 -0400808 /* Finish sending the close_notify. */
David Benjaminf0ee9072016-06-15 17:44:37 -0400809 if (ssl->method->dispatch_alert(ssl) <= 0) {
David Benjaminfa214e42016-05-10 17:03:10 -0400810 return -1;
David Benjamin27bbae42015-09-13 00:54:37 -0400811 }
David Benjaminfa214e42016-05-10 17:03:10 -0400812 } else if (ssl->s3->recv_shutdown != ssl_shutdown_close_notify) {
813 /* Wait for the peer's close_notify. */
David Benjaminf0ee9072016-06-15 17:44:37 -0400814 ssl->method->read_close_notify(ssl);
David Benjaminfa214e42016-05-10 17:03:10 -0400815 if (ssl->s3->recv_shutdown != ssl_shutdown_close_notify) {
816 return -1;
David Benjamin27bbae42015-09-13 00:54:37 -0400817 }
818 }
819
David Benjaminfa214e42016-05-10 17:03:10 -0400820 /* Return 0 for unidirectional shutdown and 1 for bidirectional shutdown. */
821 return ssl->s3->recv_shutdown == ssl_shutdown_close_notify;
David Benjamin27bbae42015-09-13 00:54:37 -0400822}
823
David Benjamin1d4f4c02016-07-26 18:03:08 -0400824int SSL_send_fatal_alert(SSL *ssl, uint8_t alert) {
825 if (ssl->s3->alert_dispatch) {
826 if (ssl->s3->send_alert[0] != SSL3_AL_FATAL ||
827 ssl->s3->send_alert[1] != alert) {
828 /* We are already attempting to write a different alert. */
829 OPENSSL_PUT_ERROR(SSL, SSL_R_PROTOCOL_IS_SHUTDOWN);
830 return -1;
831 }
832 return ssl->method->dispatch_alert(ssl);
833 }
834
835 return ssl3_send_alert(ssl, SSL3_AL_FATAL, alert);
836}
837
Steven Valdez08b65f42016-12-07 15:29:45 -0500838void SSL_CTX_set_early_data_enabled(SSL_CTX *ctx, int enabled) {
839 ctx->enable_early_data = !!enabled;
840}
841
David Benjamin287fc4f2016-12-10 15:12:03 -0500842static int bio_retry_reason_to_error(int reason) {
843 switch (reason) {
844 case BIO_RR_CONNECT:
845 return SSL_ERROR_WANT_CONNECT;
846 case BIO_RR_ACCEPT:
847 return SSL_ERROR_WANT_ACCEPT;
848 default:
849 return SSL_ERROR_SYSCALL;
850 }
851}
David Benjamin27bbae42015-09-13 00:54:37 -0400852
David Benjamin287fc4f2016-12-10 15:12:03 -0500853int SSL_get_error(const SSL *ssl, int ret_code) {
David Benjamin27bbae42015-09-13 00:54:37 -0400854 if (ret_code > 0) {
855 return SSL_ERROR_NONE;
856 }
857
858 /* Make things return SSL_ERROR_SYSCALL when doing SSL_do_handshake etc,
859 * where we do encode the error */
David Benjamin287fc4f2016-12-10 15:12:03 -0500860 uint32_t err = ERR_peek_error();
David Benjamin27bbae42015-09-13 00:54:37 -0400861 if (err != 0) {
862 if (ERR_GET_LIB(err) == ERR_LIB_SYS) {
863 return SSL_ERROR_SYSCALL;
864 }
865 return SSL_ERROR_SSL;
866 }
867
868 if (ret_code == 0) {
David Benjaminfa214e42016-05-10 17:03:10 -0400869 if (ssl->s3->recv_shutdown == ssl_shutdown_close_notify) {
David Benjamin27bbae42015-09-13 00:54:37 -0400870 return SSL_ERROR_ZERO_RETURN;
871 }
872 /* An EOF was observed which violates the protocol, and the underlying
873 * transport does not participate in the error queue. Bubble up to the
874 * caller. */
875 return SSL_ERROR_SYSCALL;
876 }
877
David Benjamin287fc4f2016-12-10 15:12:03 -0500878 switch (ssl->rwstate) {
879 case SSL_PENDING_SESSION:
880 return SSL_ERROR_PENDING_SESSION;
David Benjamin27bbae42015-09-13 00:54:37 -0400881
David Benjamin287fc4f2016-12-10 15:12:03 -0500882 case SSL_CERTIFICATE_SELECTION_PENDING:
883 return SSL_ERROR_PENDING_CERTIFICATE;
David Benjamin27bbae42015-09-13 00:54:37 -0400884
David Benjamin287fc4f2016-12-10 15:12:03 -0500885 case SSL_READING: {
886 BIO *bio = SSL_get_rbio(ssl);
887 if (BIO_should_read(bio)) {
888 return SSL_ERROR_WANT_READ;
David Benjamin27bbae42015-09-13 00:54:37 -0400889 }
890
David Benjamin287fc4f2016-12-10 15:12:03 -0500891 if (BIO_should_write(bio)) {
892 /* TODO(davidben): OpenSSL historically checked for writes on the read
893 * BIO. Can this be removed? */
894 return SSL_ERROR_WANT_WRITE;
David Benjamin27bbae42015-09-13 00:54:37 -0400895 }
896
David Benjamin287fc4f2016-12-10 15:12:03 -0500897 if (BIO_should_io_special(bio)) {
898 return bio_retry_reason_to_error(BIO_get_retry_reason(bio));
David Benjamin27bbae42015-09-13 00:54:37 -0400899 }
900
David Benjamin287fc4f2016-12-10 15:12:03 -0500901 break;
902 }
903
904 case SSL_WRITING: {
905 BIO *bio = SSL_get_wbio(ssl);
906 if (BIO_should_write(bio)) {
907 return SSL_ERROR_WANT_WRITE;
David Benjamin27bbae42015-09-13 00:54:37 -0400908 }
909
David Benjamin287fc4f2016-12-10 15:12:03 -0500910 if (BIO_should_read(bio)) {
911 /* TODO(davidben): OpenSSL historically checked for reads on the write
912 * BIO. Can this be removed? */
913 return SSL_ERROR_WANT_READ;
914 }
915
916 if (BIO_should_io_special(bio)) {
917 return bio_retry_reason_to_error(BIO_get_retry_reason(bio));
918 }
919
920 break;
David Benjamin27bbae42015-09-13 00:54:37 -0400921 }
David Benjamin27bbae42015-09-13 00:54:37 -0400922
David Benjamin287fc4f2016-12-10 15:12:03 -0500923 case SSL_X509_LOOKUP:
924 return SSL_ERROR_WANT_X509_LOOKUP;
David Benjamin27bbae42015-09-13 00:54:37 -0400925
David Benjamin287fc4f2016-12-10 15:12:03 -0500926 case SSL_CHANNEL_ID_LOOKUP:
927 return SSL_ERROR_WANT_CHANNEL_ID_LOOKUP;
David Benjamin27bbae42015-09-13 00:54:37 -0400928
David Benjamin287fc4f2016-12-10 15:12:03 -0500929 case SSL_PRIVATE_KEY_OPERATION:
930 return SSL_ERROR_WANT_PRIVATE_KEY_OPERATION;
David Benjamin27bbae42015-09-13 00:54:37 -0400931 }
932
933 return SSL_ERROR_SYSCALL;
934}
935
David Benjamine34bcc92016-09-21 16:53:09 -0400936static int set_min_version(const SSL_PROTOCOL_METHOD *method, uint16_t *out,
937 uint16_t version) {
938 if (version == 0) {
939 *out = method->min_version;
940 return 1;
941 }
942
Steven Valdezfdd10992016-09-15 16:27:05 -0400943 if (version == TLS1_3_VERSION) {
944 version = TLS1_3_DRAFT_VERSION;
945 }
946
David Benjamine34bcc92016-09-21 16:53:09 -0400947 return method->version_from_wire(out, version);
948}
949
950static int set_max_version(const SSL_PROTOCOL_METHOD *method, uint16_t *out,
951 uint16_t version) {
952 if (version == 0) {
953 *out = method->max_version;
954 /* TODO(svaldez): Enable TLS 1.3 by default once fully implemented. */
955 if (*out > TLS1_2_VERSION) {
956 *out = TLS1_2_VERSION;
957 }
958 return 1;
959 }
960
Steven Valdezfdd10992016-09-15 16:27:05 -0400961 if (version == TLS1_3_VERSION) {
962 version = TLS1_3_DRAFT_VERSION;
963 }
964
David Benjamine34bcc92016-09-21 16:53:09 -0400965 return method->version_from_wire(out, version);
966}
967
David Benjamine4706902016-09-20 15:12:23 -0400968int SSL_CTX_set_min_proto_version(SSL_CTX *ctx, uint16_t version) {
David Benjamine34bcc92016-09-21 16:53:09 -0400969 return set_min_version(ctx->method, &ctx->min_version, version);
David Benjamin27bbae42015-09-13 00:54:37 -0400970}
971
David Benjamine4706902016-09-20 15:12:23 -0400972int SSL_CTX_set_max_proto_version(SSL_CTX *ctx, uint16_t version) {
David Benjamine34bcc92016-09-21 16:53:09 -0400973 return set_max_version(ctx->method, &ctx->max_version, version);
David Benjamin27bbae42015-09-13 00:54:37 -0400974}
975
David Benjamine4706902016-09-20 15:12:23 -0400976int SSL_set_min_proto_version(SSL *ssl, uint16_t version) {
David Benjamine34bcc92016-09-21 16:53:09 -0400977 return set_min_version(ssl->method, &ssl->min_version, version);
David Benjamin27bbae42015-09-13 00:54:37 -0400978}
979
David Benjamine4706902016-09-20 15:12:23 -0400980int SSL_set_max_proto_version(SSL *ssl, uint16_t version) {
David Benjamine34bcc92016-09-21 16:53:09 -0400981 return set_max_version(ssl->method, &ssl->max_version, version);
David Benjamin27bbae42015-09-13 00:54:37 -0400982}
983
984uint32_t SSL_CTX_set_options(SSL_CTX *ctx, uint32_t options) {
985 ctx->options |= options;
986 return ctx->options;
987}
988
989uint32_t SSL_CTX_clear_options(SSL_CTX *ctx, uint32_t options) {
990 ctx->options &= ~options;
991 return ctx->options;
992}
993
994uint32_t SSL_CTX_get_options(const SSL_CTX *ctx) { return ctx->options; }
995
996uint32_t SSL_set_options(SSL *ssl, uint32_t options) {
997 ssl->options |= options;
998 return ssl->options;
999}
1000
1001uint32_t SSL_clear_options(SSL *ssl, uint32_t options) {
1002 ssl->options &= ~options;
1003 return ssl->options;
1004}
1005
1006uint32_t SSL_get_options(const SSL *ssl) { return ssl->options; }
1007
1008uint32_t SSL_CTX_set_mode(SSL_CTX *ctx, uint32_t mode) {
1009 ctx->mode |= mode;
1010 return ctx->mode;
1011}
1012
1013uint32_t SSL_CTX_clear_mode(SSL_CTX *ctx, uint32_t mode) {
1014 ctx->mode &= ~mode;
1015 return ctx->mode;
1016}
1017
1018uint32_t SSL_CTX_get_mode(const SSL_CTX *ctx) { return ctx->mode; }
1019
1020uint32_t SSL_set_mode(SSL *ssl, uint32_t mode) {
1021 ssl->mode |= mode;
1022 return ssl->mode;
1023}
1024
1025uint32_t SSL_clear_mode(SSL *ssl, uint32_t mode) {
1026 ssl->mode &= ~mode;
1027 return ssl->mode;
1028}
1029
1030uint32_t SSL_get_mode(const SSL *ssl) { return ssl->mode; }
1031
Adam Langleyd519bf62016-12-12 11:16:44 -08001032void SSL_CTX_set0_buffer_pool(SSL_CTX *ctx, CRYPTO_BUFFER_POOL *pool) {
1033 ctx->pool = pool;
1034}
1035
David Benjaminee0c8272015-09-13 01:03:54 -04001036int SSL_get_tls_unique(const SSL *ssl, uint8_t *out, size_t *out_len,
1037 size_t max_out) {
David Benjaminced00b42016-10-08 11:24:09 -04001038 /* tls-unique is not defined for SSL 3.0 or TLS 1.3. */
1039 if (!ssl->s3->initial_handshake_complete ||
1040 ssl3_protocol_version(ssl) < TLS1_VERSION ||
1041 ssl3_protocol_version(ssl) >= TLS1_3_VERSION) {
1042 goto err;
1043 }
1044
David Benjaminee0c8272015-09-13 01:03:54 -04001045 /* The tls-unique value is the first Finished message in the handshake, which
1046 * is the client's in a full handshake and the server's for a resumption. See
1047 * https://tools.ietf.org/html/rfc5929#section-3.1. */
1048 const uint8_t *finished = ssl->s3->previous_client_finished;
1049 size_t finished_len = ssl->s3->previous_client_finished_len;
Steven Valdez87eab492016-06-27 16:34:59 -04001050 if (ssl->session != NULL) {
David Benjaminee0c8272015-09-13 01:03:54 -04001051 /* tls-unique is broken for resumed sessions unless EMS is used. */
1052 if (!ssl->session->extended_master_secret) {
1053 goto err;
1054 }
1055 finished = ssl->s3->previous_server_finished;
1056 finished_len = ssl->s3->previous_server_finished_len;
1057 }
1058
David Benjaminee0c8272015-09-13 01:03:54 -04001059 *out_len = finished_len;
1060 if (finished_len > max_out) {
1061 *out_len = max_out;
1062 }
1063
David Benjamin17cf2cb2016-12-13 01:07:13 -05001064 OPENSSL_memcpy(out, finished, *out_len);
David Benjaminee0c8272015-09-13 01:03:54 -04001065 return 1;
1066
1067err:
1068 *out_len = 0;
David Benjamin17cf2cb2016-12-13 01:07:13 -05001069 OPENSSL_memset(out, 0, max_out);
David Benjaminee0c8272015-09-13 01:03:54 -04001070 return 0;
1071}
1072
David Benjamin5960a902017-02-14 20:07:11 -05001073static int set_session_id_context(CERT *cert, const uint8_t *sid_ctx,
David Benjamin30c4c302016-12-07 22:35:24 -05001074 size_t sid_ctx_len) {
David Benjamin5960a902017-02-14 20:07:11 -05001075 if (sid_ctx_len > sizeof(cert->sid_ctx)) {
David Benjamin3570d732015-06-29 00:28:17 -04001076 OPENSSL_PUT_ERROR(SSL, SSL_R_SSL_SESSION_ID_CONTEXT_TOO_LONG);
Adam Langleyfcf25832014-12-18 17:42:32 -08001077 return 0;
1078 }
David Benjamin30c4c302016-12-07 22:35:24 -05001079
David Benjamin5960a902017-02-14 20:07:11 -05001080 OPENSSL_COMPILE_ASSERT(sizeof(cert->sid_ctx) < 256, sid_ctx_too_large);
1081 cert->sid_ctx_length = (uint8_t)sid_ctx_len;
1082 OPENSSL_memcpy(cert->sid_ctx, sid_ctx, sid_ctx_len);
Adam Langleyfcf25832014-12-18 17:42:32 -08001083 return 1;
1084}
Adam Langley95c29f32014-06-20 12:00:00 -07001085
David Benjamin5960a902017-02-14 20:07:11 -05001086int SSL_CTX_set_session_id_context(SSL_CTX *ctx, const uint8_t *sid_ctx,
1087 size_t sid_ctx_len) {
1088 return set_session_id_context(ctx->cert, sid_ctx, sid_ctx_len);
1089}
1090
Adam Langleyfcf25832014-12-18 17:42:32 -08001091int SSL_set_session_id_context(SSL *ssl, const uint8_t *sid_ctx,
David Benjamin30c4c302016-12-07 22:35:24 -05001092 size_t sid_ctx_len) {
David Benjamin5960a902017-02-14 20:07:11 -05001093 return set_session_id_context(ssl->cert, sid_ctx, sid_ctx_len);
Adam Langleyfcf25832014-12-18 17:42:32 -08001094}
Adam Langley95c29f32014-06-20 12:00:00 -07001095
David Benjamin07820b52016-12-07 21:13:41 -05001096const uint8_t *SSL_get0_session_id_context(const SSL *ssl, size_t *out_len) {
David Benjamin5960a902017-02-14 20:07:11 -05001097 *out_len = ssl->cert->sid_ctx_length;
1098 return ssl->cert->sid_ctx;
David Benjamin07820b52016-12-07 21:13:41 -05001099}
1100
Adam Langley858a88d2014-06-20 12:00:00 -07001101void ssl_cipher_preference_list_free(
Adam Langleyfcf25832014-12-18 17:42:32 -08001102 struct ssl_cipher_preference_list_st *cipher_list) {
David Benjamin5d1ec732015-04-22 13:38:00 -04001103 if (cipher_list == NULL) {
1104 return;
1105 }
Adam Langleyfcf25832014-12-18 17:42:32 -08001106 sk_SSL_CIPHER_free(cipher_list->ciphers);
1107 OPENSSL_free(cipher_list->in_group_flags);
1108 OPENSSL_free(cipher_list);
1109}
Adam Langley858a88d2014-06-20 12:00:00 -07001110
David Benjamin7481d392015-07-05 19:38:46 -04001111void SSL_certs_clear(SSL *ssl) { ssl_cert_clear_certs(ssl->cert); }
Adam Langley95c29f32014-06-20 12:00:00 -07001112
David Benjamin066fe0a2015-10-17 21:11:33 -04001113int SSL_get_fd(const SSL *ssl) { return SSL_get_rfd(ssl); }
Adam Langley95c29f32014-06-20 12:00:00 -07001114
David Benjamin066fe0a2015-10-17 21:11:33 -04001115int SSL_get_rfd(const SSL *ssl) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001116 int ret = -1;
David Benjamin066fe0a2015-10-17 21:11:33 -04001117 BIO *b = BIO_find_type(SSL_get_rbio(ssl), BIO_TYPE_DESCRIPTOR);
1118 if (b != NULL) {
1119 BIO_get_fd(b, &ret);
Adam Langleyfcf25832014-12-18 17:42:32 -08001120 }
1121 return ret;
1122}
Adam Langley95c29f32014-06-20 12:00:00 -07001123
David Benjamin066fe0a2015-10-17 21:11:33 -04001124int SSL_get_wfd(const SSL *ssl) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001125 int ret = -1;
David Benjamin066fe0a2015-10-17 21:11:33 -04001126 BIO *b = BIO_find_type(SSL_get_wbio(ssl), BIO_TYPE_DESCRIPTOR);
1127 if (b != NULL) {
1128 BIO_get_fd(b, &ret);
Adam Langleyfcf25832014-12-18 17:42:32 -08001129 }
Adam Langleyfcf25832014-12-18 17:42:32 -08001130 return ret;
1131}
Adam Langley95c29f32014-06-20 12:00:00 -07001132
David Benjamin066fe0a2015-10-17 21:11:33 -04001133int SSL_set_fd(SSL *ssl, int fd) {
David Benjamin22ce9b22016-03-06 19:26:52 -05001134 BIO *bio = BIO_new(BIO_s_socket());
Adam Langleyfcf25832014-12-18 17:42:32 -08001135 if (bio == NULL) {
David Benjamin3570d732015-06-29 00:28:17 -04001136 OPENSSL_PUT_ERROR(SSL, ERR_R_BUF_LIB);
David Benjamin066fe0a2015-10-17 21:11:33 -04001137 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001138 }
1139 BIO_set_fd(bio, fd, BIO_NOCLOSE);
David Benjamin066fe0a2015-10-17 21:11:33 -04001140 SSL_set_bio(ssl, bio, bio);
1141 return 1;
Adam Langleyfcf25832014-12-18 17:42:32 -08001142}
Adam Langley95c29f32014-06-20 12:00:00 -07001143
David Benjamin066fe0a2015-10-17 21:11:33 -04001144int SSL_set_wfd(SSL *ssl, int fd) {
David Benjamin2f871122016-05-20 14:27:17 -04001145 BIO *rbio = SSL_get_rbio(ssl);
1146 if (rbio == NULL || BIO_method_type(rbio) != BIO_TYPE_SOCKET ||
1147 BIO_get_fd(rbio, NULL) != fd) {
David Benjamin22ce9b22016-03-06 19:26:52 -05001148 BIO *bio = BIO_new(BIO_s_socket());
Adam Langleyfcf25832014-12-18 17:42:32 -08001149 if (bio == NULL) {
David Benjamin3570d732015-06-29 00:28:17 -04001150 OPENSSL_PUT_ERROR(SSL, ERR_R_BUF_LIB);
David Benjamin066fe0a2015-10-17 21:11:33 -04001151 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001152 }
1153 BIO_set_fd(bio, fd, BIO_NOCLOSE);
David Benjamin4501bd52016-08-01 13:39:41 -04001154 SSL_set0_wbio(ssl, bio);
Adam Langleyfcf25832014-12-18 17:42:32 -08001155 } else {
David Benjamin4501bd52016-08-01 13:39:41 -04001156 /* Copy the rbio over to the wbio. */
1157 BIO_up_ref(rbio);
1158 SSL_set0_wbio(ssl, rbio);
Adam Langleyfcf25832014-12-18 17:42:32 -08001159 }
1160
David Benjamin066fe0a2015-10-17 21:11:33 -04001161 return 1;
Adam Langleyfcf25832014-12-18 17:42:32 -08001162}
Adam Langley95c29f32014-06-20 12:00:00 -07001163
David Benjamin066fe0a2015-10-17 21:11:33 -04001164int SSL_set_rfd(SSL *ssl, int fd) {
David Benjamin2f871122016-05-20 14:27:17 -04001165 BIO *wbio = SSL_get_wbio(ssl);
1166 if (wbio == NULL || BIO_method_type(wbio) != BIO_TYPE_SOCKET ||
1167 BIO_get_fd(wbio, NULL) != fd) {
David Benjamin22ce9b22016-03-06 19:26:52 -05001168 BIO *bio = BIO_new(BIO_s_socket());
Adam Langleyfcf25832014-12-18 17:42:32 -08001169 if (bio == NULL) {
David Benjamin3570d732015-06-29 00:28:17 -04001170 OPENSSL_PUT_ERROR(SSL, ERR_R_BUF_LIB);
David Benjamin066fe0a2015-10-17 21:11:33 -04001171 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001172 }
1173 BIO_set_fd(bio, fd, BIO_NOCLOSE);
David Benjamin4501bd52016-08-01 13:39:41 -04001174 SSL_set0_rbio(ssl, bio);
Adam Langleyfcf25832014-12-18 17:42:32 -08001175 } else {
David Benjamin4501bd52016-08-01 13:39:41 -04001176 /* Copy the wbio over to the rbio. */
1177 BIO_up_ref(wbio);
1178 SSL_set0_rbio(ssl, wbio);
Adam Langleyfcf25832014-12-18 17:42:32 -08001179 }
David Benjamin066fe0a2015-10-17 21:11:33 -04001180 return 1;
Adam Langleyfcf25832014-12-18 17:42:32 -08001181}
Adam Langley95c29f32014-06-20 12:00:00 -07001182
David Benjamin49ddf412016-10-08 11:56:01 -04001183static size_t copy_finished(void *out, size_t out_len, const uint8_t *in,
1184 size_t in_len) {
1185 if (out_len > in_len) {
1186 out_len = in_len;
1187 }
David Benjamin17cf2cb2016-12-13 01:07:13 -05001188 OPENSSL_memcpy(out, in, out_len);
David Benjamin49ddf412016-10-08 11:56:01 -04001189 return in_len;
1190}
1191
David Benjamin1a1b34d2015-10-17 12:51:52 -04001192size_t SSL_get_finished(const SSL *ssl, void *buf, size_t count) {
David Benjaminced00b42016-10-08 11:24:09 -04001193 if (!ssl->s3->initial_handshake_complete ||
1194 ssl3_protocol_version(ssl) < TLS1_VERSION ||
1195 ssl3_protocol_version(ssl) >= TLS1_3_VERSION) {
1196 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001197 }
1198
David Benjamin49ddf412016-10-08 11:56:01 -04001199 if (ssl->server) {
1200 return copy_finished(buf, count, ssl->s3->previous_server_finished,
1201 ssl->s3->previous_server_finished_len);
David Benjaminced00b42016-10-08 11:24:09 -04001202 }
David Benjamin49ddf412016-10-08 11:56:01 -04001203
1204 return copy_finished(buf, count, ssl->s3->previous_client_finished,
1205 ssl->s3->previous_client_finished_len);
Adam Langleyfcf25832014-12-18 17:42:32 -08001206}
Adam Langley95c29f32014-06-20 12:00:00 -07001207
David Benjamin1a1b34d2015-10-17 12:51:52 -04001208size_t SSL_get_peer_finished(const SSL *ssl, void *buf, size_t count) {
David Benjaminced00b42016-10-08 11:24:09 -04001209 if (!ssl->s3->initial_handshake_complete ||
1210 ssl3_protocol_version(ssl) < TLS1_VERSION ||
1211 ssl3_protocol_version(ssl) >= TLS1_3_VERSION) {
1212 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001213 }
Adam Langley95c29f32014-06-20 12:00:00 -07001214
David Benjamin49ddf412016-10-08 11:56:01 -04001215 if (ssl->server) {
1216 return copy_finished(buf, count, ssl->s3->previous_client_finished,
1217 ssl->s3->previous_client_finished_len);
David Benjaminced00b42016-10-08 11:24:09 -04001218 }
David Benjamin49ddf412016-10-08 11:56:01 -04001219
1220 return copy_finished(buf, count, ssl->s3->previous_server_finished,
1221 ssl->s3->previous_server_finished_len);
Adam Langleyfcf25832014-12-18 17:42:32 -08001222}
Adam Langley95c29f32014-06-20 12:00:00 -07001223
David Benjamin59937042015-09-19 13:04:22 -04001224int SSL_get_verify_mode(const SSL *ssl) { return ssl->verify_mode; }
Adam Langley95c29f32014-06-20 12:00:00 -07001225
David Benjamin42fea372015-09-19 01:22:44 -04001226int SSL_get_extms_support(const SSL *ssl) {
David Benjamina68c1182016-07-24 00:14:33 -04001227 if (!ssl->s3->have_version) {
1228 return 0;
1229 }
Steven Valdez143e8b32016-07-11 13:19:03 -04001230 return ssl3_protocol_version(ssl) >= TLS1_3_VERSION ||
1231 ssl->s3->tmp.extended_master_secret == 1;
Matt Braithwaitecd6f54b2015-09-17 12:54:42 -07001232}
1233
David Benjamin9a41d1b2015-05-16 01:30:09 -04001234int SSL_CTX_get_read_ahead(const SSL_CTX *ctx) { return 0; }
Adam Langley95c29f32014-06-20 12:00:00 -07001235
David Benjamin0d56f882015-12-19 17:05:56 -05001236int SSL_get_read_ahead(const SSL *ssl) { return 0; }
Adam Langley95c29f32014-06-20 12:00:00 -07001237
David Benjamin9a41d1b2015-05-16 01:30:09 -04001238void SSL_CTX_set_read_ahead(SSL_CTX *ctx, int yes) { }
David Benjamin61ecccf2015-05-05 09:44:51 -04001239
David Benjamin0d56f882015-12-19 17:05:56 -05001240void SSL_set_read_ahead(SSL *ssl, int yes) { }
David Benjamin61ecccf2015-05-05 09:44:51 -04001241
David Benjamin9f859492015-10-03 10:44:30 -04001242int SSL_pending(const SSL *ssl) {
1243 if (ssl->s3->rrec.type != SSL3_RT_APPLICATION_DATA) {
1244 return 0;
1245 }
1246 return ssl->s3->rrec.length;
Adam Langleyfcf25832014-12-18 17:42:32 -08001247}
Adam Langley95c29f32014-06-20 12:00:00 -07001248
Adam Langley95c29f32014-06-20 12:00:00 -07001249/* Fix this so it checks all the valid key/cert options */
Adam Langleyfcf25832014-12-18 17:42:32 -08001250int SSL_CTX_check_private_key(const SSL_CTX *ctx) {
Adam Langley3a2b47a2017-01-24 13:59:42 -08001251 return ssl_cert_check_private_key(ctx->cert, ctx->cert->privatekey);
Adam Langleyc5ac2b62016-11-07 12:02:35 -08001252}
1253
1254/* Fix this function so that it takes an optional type parameter */
1255int SSL_check_private_key(const SSL *ssl) {
Adam Langley3a2b47a2017-01-24 13:59:42 -08001256 return ssl_cert_check_private_key(ssl->cert, ssl->cert->privatekey);
Adam Langleyfcf25832014-12-18 17:42:32 -08001257}
Adam Langley95c29f32014-06-20 12:00:00 -07001258
David Benjamin42fea372015-09-19 01:22:44 -04001259long SSL_get_default_timeout(const SSL *ssl) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001260 return SSL_DEFAULT_SESSION_TIMEOUT;
1261}
Adam Langley95c29f32014-06-20 12:00:00 -07001262
David Benjamin44d3eed2015-05-21 01:29:55 -04001263int SSL_renegotiate(SSL *ssl) {
1264 /* Caller-initiated renegotiation is not supported. */
David Benjamin3570d732015-06-29 00:28:17 -04001265 OPENSSL_PUT_ERROR(SSL, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
David Benjamin44d3eed2015-05-21 01:29:55 -04001266 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001267}
Adam Langley95c29f32014-06-20 12:00:00 -07001268
David Benjamin44d3eed2015-05-21 01:29:55 -04001269int SSL_renegotiate_pending(SSL *ssl) {
1270 return SSL_in_init(ssl) && ssl->s3->initial_handshake_complete;
Adam Langleyfcf25832014-12-18 17:42:32 -08001271}
Adam Langley95c29f32014-06-20 12:00:00 -07001272
David Benjamin936aada2016-06-07 19:09:22 -04001273int SSL_total_renegotiations(const SSL *ssl) {
1274 return ssl->s3->total_renegotiations;
1275}
1276
David Benjamin1d0a1942015-04-26 15:35:35 -04001277size_t SSL_CTX_get_max_cert_list(const SSL_CTX *ctx) {
1278 return ctx->max_cert_list;
1279}
1280
1281void SSL_CTX_set_max_cert_list(SSL_CTX *ctx, size_t max_cert_list) {
1282 if (max_cert_list > kMaxHandshakeSize) {
1283 max_cert_list = kMaxHandshakeSize;
1284 }
1285 ctx->max_cert_list = (uint32_t)max_cert_list;
1286}
1287
1288size_t SSL_get_max_cert_list(const SSL *ssl) {
1289 return ssl->max_cert_list;
1290}
1291
1292void SSL_set_max_cert_list(SSL *ssl, size_t max_cert_list) {
1293 if (max_cert_list > kMaxHandshakeSize) {
1294 max_cert_list = kMaxHandshakeSize;
1295 }
1296 ssl->max_cert_list = (uint32_t)max_cert_list;
1297}
1298
Adam Langleyce9d85e2016-01-24 15:58:39 -08001299int SSL_CTX_set_max_send_fragment(SSL_CTX *ctx, size_t max_send_fragment) {
David Benjamin1d0a1942015-04-26 15:35:35 -04001300 if (max_send_fragment < 512) {
1301 max_send_fragment = 512;
1302 }
1303 if (max_send_fragment > SSL3_RT_MAX_PLAIN_LENGTH) {
1304 max_send_fragment = SSL3_RT_MAX_PLAIN_LENGTH;
1305 }
1306 ctx->max_send_fragment = (uint16_t)max_send_fragment;
Adam Langleyce9d85e2016-01-24 15:58:39 -08001307
1308 return 1;
David Benjamin1d0a1942015-04-26 15:35:35 -04001309}
1310
Adam Langleyce9d85e2016-01-24 15:58:39 -08001311int SSL_set_max_send_fragment(SSL *ssl, size_t max_send_fragment) {
David Benjamin1d0a1942015-04-26 15:35:35 -04001312 if (max_send_fragment < 512) {
1313 max_send_fragment = 512;
1314 }
1315 if (max_send_fragment > SSL3_RT_MAX_PLAIN_LENGTH) {
1316 max_send_fragment = SSL3_RT_MAX_PLAIN_LENGTH;
1317 }
1318 ssl->max_send_fragment = (uint16_t)max_send_fragment;
Adam Langleyce9d85e2016-01-24 15:58:39 -08001319
1320 return 1;
David Benjamin1d0a1942015-04-26 15:35:35 -04001321}
1322
David Benjamincb9cf792015-05-05 09:46:14 -04001323int SSL_set_mtu(SSL *ssl, unsigned mtu) {
David Benjamince079fd2016-08-02 16:22:34 -04001324 if (!SSL_is_dtls(ssl) || mtu < dtls1_min_mtu()) {
David Benjamincb9cf792015-05-05 09:46:14 -04001325 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001326 }
David Benjamincb9cf792015-05-05 09:46:14 -04001327 ssl->d1->mtu = mtu;
1328 return 1;
1329}
1330
1331int SSL_get_secure_renegotiation_support(const SSL *ssl) {
David Benjamind2610042017-01-03 10:49:28 -05001332 if (!ssl->s3->have_version) {
1333 return 0;
1334 }
1335 return ssl3_protocol_version(ssl) >= TLS1_3_VERSION ||
1336 ssl->s3->send_connection_binding;
David Benjamincb9cf792015-05-05 09:46:14 -04001337}
1338
Adam Langleyfcf25832014-12-18 17:42:32 -08001339LHASH_OF(SSL_SESSION) *SSL_CTX_sessions(SSL_CTX *ctx) { return ctx->sessions; }
1340
David Benjamin71f7d3d2015-05-05 09:46:38 -04001341size_t SSL_CTX_sess_number(const SSL_CTX *ctx) {
1342 return lh_SSL_SESSION_num_items(ctx->sessions);
1343}
1344
1345unsigned long SSL_CTX_sess_set_cache_size(SSL_CTX *ctx, unsigned long size) {
1346 unsigned long ret = ctx->session_cache_size;
1347 ctx->session_cache_size = size;
1348 return ret;
1349}
1350
1351unsigned long SSL_CTX_sess_get_cache_size(const SSL_CTX *ctx) {
1352 return ctx->session_cache_size;
1353}
1354
1355int SSL_CTX_set_session_cache_mode(SSL_CTX *ctx, int mode) {
1356 int ret = ctx->session_cache_mode;
1357 ctx->session_cache_mode = mode;
1358 return ret;
1359}
1360
1361int SSL_CTX_get_session_cache_mode(const SSL_CTX *ctx) {
1362 return ctx->session_cache_mode;
1363}
1364
David Benjamin936aada2016-06-07 19:09:22 -04001365
1366int SSL_CTX_get_tlsext_ticket_keys(SSL_CTX *ctx, void *out, size_t len) {
1367 if (out == NULL) {
1368 return 48;
1369 }
1370 if (len != 48) {
1371 OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_TICKET_KEYS_LENGTH);
1372 return 0;
1373 }
1374 uint8_t *out_bytes = out;
David Benjamin17cf2cb2016-12-13 01:07:13 -05001375 OPENSSL_memcpy(out_bytes, ctx->tlsext_tick_key_name, 16);
1376 OPENSSL_memcpy(out_bytes + 16, ctx->tlsext_tick_hmac_key, 16);
1377 OPENSSL_memcpy(out_bytes + 32, ctx->tlsext_tick_aes_key, 16);
David Benjamin936aada2016-06-07 19:09:22 -04001378 return 1;
1379}
1380
1381int SSL_CTX_set_tlsext_ticket_keys(SSL_CTX *ctx, const void *in, size_t len) {
1382 if (in == NULL) {
1383 return 48;
1384 }
1385 if (len != 48) {
1386 OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_TICKET_KEYS_LENGTH);
1387 return 0;
1388 }
1389 const uint8_t *in_bytes = in;
David Benjamin17cf2cb2016-12-13 01:07:13 -05001390 OPENSSL_memcpy(ctx->tlsext_tick_key_name, in_bytes, 16);
1391 OPENSSL_memcpy(ctx->tlsext_tick_hmac_key, in_bytes + 16, 16);
1392 OPENSSL_memcpy(ctx->tlsext_tick_aes_key, in_bytes + 32, 16);
David Benjamin936aada2016-06-07 19:09:22 -04001393 return 1;
1394}
1395
1396int SSL_CTX_set_tlsext_ticket_key_cb(
1397 SSL_CTX *ctx, int (*callback)(SSL *ssl, uint8_t *key_name, uint8_t *iv,
1398 EVP_CIPHER_CTX *ctx, HMAC_CTX *hmac_ctx,
1399 int encrypt)) {
1400 ctx->tlsext_ticket_key_cb = callback;
1401 return 1;
1402}
1403
1404int SSL_CTX_set1_curves(SSL_CTX *ctx, const int *curves, size_t curves_len) {
1405 return tls1_set_curves(&ctx->supported_group_list,
1406 &ctx->supported_group_list_len, curves,
1407 curves_len);
1408}
1409
1410int SSL_set1_curves(SSL *ssl, const int *curves, size_t curves_len) {
1411 return tls1_set_curves(&ssl->supported_group_list,
1412 &ssl->supported_group_list_len, curves,
1413 curves_len);
1414}
1415
Alessandro Ghedini5fd18072016-09-28 21:04:25 +01001416int SSL_CTX_set1_curves_list(SSL_CTX *ctx, const char *curves) {
1417 return tls1_set_curves_list(&ctx->supported_group_list,
1418 &ctx->supported_group_list_len, curves);
1419}
1420
1421int SSL_set1_curves_list(SSL *ssl, const char *curves) {
1422 return tls1_set_curves_list(&ssl->supported_group_list,
1423 &ssl->supported_group_list_len, curves);
1424}
1425
David Benjamin9e68f192016-06-30 14:55:33 -04001426uint16_t SSL_get_curve_id(const SSL *ssl) {
1427 /* TODO(davidben): This checks the wrong session if there is a renegotiation in
1428 * progress. */
Steven Valdez87eab492016-06-27 16:34:59 -04001429 SSL_SESSION *session = SSL_get_session(ssl);
David Benjamin4882a6c2016-12-11 02:48:12 -05001430 if (session == NULL) {
David Benjamin9e68f192016-06-30 14:55:33 -04001431 return 0;
1432 }
1433
David Benjamin4882a6c2016-12-11 02:48:12 -05001434 return session->group_id;
David Benjamin9e68f192016-06-30 14:55:33 -04001435}
1436
David Benjamin936aada2016-06-07 19:09:22 -04001437int SSL_CTX_set_tmp_dh(SSL_CTX *ctx, const DH *dh) {
1438 DH_free(ctx->cert->dh_tmp);
1439 ctx->cert->dh_tmp = DHparams_dup(dh);
1440 if (ctx->cert->dh_tmp == NULL) {
1441 OPENSSL_PUT_ERROR(SSL, ERR_R_DH_LIB);
1442 return 0;
1443 }
1444 return 1;
1445}
1446
1447int SSL_set_tmp_dh(SSL *ssl, const DH *dh) {
1448 DH_free(ssl->cert->dh_tmp);
1449 ssl->cert->dh_tmp = DHparams_dup(dh);
1450 if (ssl->cert->dh_tmp == NULL) {
1451 OPENSSL_PUT_ERROR(SSL, ERR_R_DH_LIB);
1452 return 0;
1453 }
1454 return 1;
1455}
1456
David Benjamin32876b32015-09-20 12:17:03 -04001457STACK_OF(SSL_CIPHER) *SSL_get_ciphers(const SSL *ssl) {
1458 if (ssl == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001459 return NULL;
1460 }
Adam Langley0b5c1ac2014-06-20 12:00:00 -07001461
David Benjaminaf3b3d32016-10-31 16:29:57 -04001462 const struct ssl_cipher_preference_list_st *prefs =
1463 ssl_get_cipher_preferences(ssl);
1464 if (prefs == NULL) {
1465 return NULL;
Adam Langleyfcf25832014-12-18 17:42:32 -08001466 }
Adam Langley0b5c1ac2014-06-20 12:00:00 -07001467
David Benjaminaf3b3d32016-10-31 16:29:57 -04001468 return prefs->ciphers;
Adam Langleyfcf25832014-12-18 17:42:32 -08001469}
Adam Langley95c29f32014-06-20 12:00:00 -07001470
David Benjamin32876b32015-09-20 12:17:03 -04001471const char *SSL_get_cipher_list(const SSL *ssl, int n) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001472 const SSL_CIPHER *c;
David Benjamin60da0cd2015-05-03 15:21:28 -04001473 STACK_OF(SSL_CIPHER) *sk;
Adam Langley0b5c1ac2014-06-20 12:00:00 -07001474
David Benjamin32876b32015-09-20 12:17:03 -04001475 if (ssl == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001476 return NULL;
1477 }
Adam Langley95c29f32014-06-20 12:00:00 -07001478
David Benjamin32876b32015-09-20 12:17:03 -04001479 sk = SSL_get_ciphers(ssl);
Adam Langleyfcf25832014-12-18 17:42:32 -08001480 if (sk == NULL || n < 0 || (size_t)n >= sk_SSL_CIPHER_num(sk)) {
1481 return NULL;
1482 }
Adam Langley95c29f32014-06-20 12:00:00 -07001483
Adam Langleyfcf25832014-12-18 17:42:32 -08001484 c = sk_SSL_CIPHER_value(sk, n);
1485 if (c == NULL) {
1486 return NULL;
1487 }
Adam Langley95c29f32014-06-20 12:00:00 -07001488
Adam Langleyfcf25832014-12-18 17:42:32 -08001489 return c->name;
1490}
David Benjamin5491e3f2014-09-29 19:33:09 -04001491
Adam Langleyfcf25832014-12-18 17:42:32 -08001492int SSL_CTX_set_cipher_list(SSL_CTX *ctx, const char *str) {
David Benjamind2cb1c12016-11-02 17:49:09 -04001493 STACK_OF(SSL_CIPHER) *cipher_list =
1494 ssl_create_cipher_list(ctx->method, &ctx->cipher_list, str);
David Benjamin32876b32015-09-20 12:17:03 -04001495 if (cipher_list == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001496 return 0;
David Benjamin32876b32015-09-20 12:17:03 -04001497 }
1498
1499 /* |ssl_create_cipher_list| may succeed but return an empty cipher list. */
1500 if (sk_SSL_CIPHER_num(cipher_list) == 0) {
David Benjamin3570d732015-06-29 00:28:17 -04001501 OPENSSL_PUT_ERROR(SSL, SSL_R_NO_CIPHER_MATCH);
Adam Langleyfcf25832014-12-18 17:42:32 -08001502 return 0;
1503 }
Adam Langley95c29f32014-06-20 12:00:00 -07001504
Adam Langleyfcf25832014-12-18 17:42:32 -08001505 return 1;
1506}
David Benjamin39482a12014-07-20 13:30:15 -04001507
David Benjamin32876b32015-09-20 12:17:03 -04001508int SSL_set_cipher_list(SSL *ssl, const char *str) {
David Benjamind2cb1c12016-11-02 17:49:09 -04001509 STACK_OF(SSL_CIPHER) *cipher_list =
1510 ssl_create_cipher_list(ssl->ctx->method, &ssl->cipher_list, str);
David Benjamin32876b32015-09-20 12:17:03 -04001511 if (cipher_list == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001512 return 0;
David Benjamin32876b32015-09-20 12:17:03 -04001513 }
1514
1515 /* |ssl_create_cipher_list| may succeed but return an empty cipher list. */
1516 if (sk_SSL_CIPHER_num(cipher_list) == 0) {
David Benjamin3570d732015-06-29 00:28:17 -04001517 OPENSSL_PUT_ERROR(SSL, SSL_R_NO_CIPHER_MATCH);
Adam Langleyfcf25832014-12-18 17:42:32 -08001518 return 0;
1519 }
David Benjamin39482a12014-07-20 13:30:15 -04001520
Adam Langleyfcf25832014-12-18 17:42:32 -08001521 return 1;
1522}
Adam Langley95c29f32014-06-20 12:00:00 -07001523
David Benjamin07e13842015-10-17 13:48:04 -04001524const char *SSL_get_servername(const SSL *ssl, const int type) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001525 if (type != TLSEXT_NAMETYPE_host_name) {
1526 return NULL;
1527 }
Adam Langley95c29f32014-06-20 12:00:00 -07001528
David Benjamin07e13842015-10-17 13:48:04 -04001529 /* Historically, |SSL_get_servername| was also the configuration getter
1530 * corresponding to |SSL_set_tlsext_host_name|. */
1531 if (ssl->tlsext_hostname != NULL) {
1532 return ssl->tlsext_hostname;
1533 }
1534
David Benjamin4eb95cc2016-11-16 17:08:23 +09001535 /* During the handshake, report the handshake value. */
1536 if (ssl->s3->hs != NULL) {
1537 return ssl->s3->hs->hostname;
1538 }
1539
1540 /* SSL_get_servername may also be called after the handshake to look up the
1541 * SNI value.
1542 *
1543 * TODO(davidben): This is almost unused. Can we remove it? */
Steven Valdez87eab492016-06-27 16:34:59 -04001544 SSL_SESSION *session = SSL_get_session(ssl);
1545 if (session == NULL) {
David Benjamin07e13842015-10-17 13:48:04 -04001546 return NULL;
1547 }
Steven Valdez87eab492016-06-27 16:34:59 -04001548 return session->tlsext_hostname;
Adam Langleyfcf25832014-12-18 17:42:32 -08001549}
Adam Langley95c29f32014-06-20 12:00:00 -07001550
David Benjamin07e13842015-10-17 13:48:04 -04001551int SSL_get_servername_type(const SSL *ssl) {
Steven Valdez87eab492016-06-27 16:34:59 -04001552 SSL_SESSION *session = SSL_get_session(ssl);
1553 if (session == NULL || session->tlsext_hostname == NULL) {
1554 return -1;
Adam Langleyfcf25832014-12-18 17:42:32 -08001555 }
Steven Valdez87eab492016-06-27 16:34:59 -04001556 return TLSEXT_NAMETYPE_host_name;
Adam Langleyfcf25832014-12-18 17:42:32 -08001557}
Adam Langley95c29f32014-06-20 12:00:00 -07001558
Adam Langleyfcf25832014-12-18 17:42:32 -08001559void SSL_CTX_enable_signed_cert_timestamps(SSL_CTX *ctx) {
1560 ctx->signed_cert_timestamps_enabled = 1;
1561}
HÃ¥vard Molland9169c962014-08-14 14:42:37 +02001562
David Benjamin26e1ff32017-02-14 20:13:00 -05001563void SSL_enable_signed_cert_timestamps(SSL *ssl) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001564 ssl->signed_cert_timestamps_enabled = 1;
Adam Langleyfcf25832014-12-18 17:42:32 -08001565}
HÃ¥vard Molland9169c962014-08-14 14:42:37 +02001566
Adam Langleyfcf25832014-12-18 17:42:32 -08001567void SSL_CTX_enable_ocsp_stapling(SSL_CTX *ctx) {
1568 ctx->ocsp_stapling_enabled = 1;
1569}
David Benjamin6c7aed02014-08-27 16:42:38 -04001570
David Benjamin26e1ff32017-02-14 20:13:00 -05001571void SSL_enable_ocsp_stapling(SSL *ssl) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001572 ssl->ocsp_stapling_enabled = 1;
Adam Langleyfcf25832014-12-18 17:42:32 -08001573}
David Benjamin6c7aed02014-08-27 16:42:38 -04001574
Adam Langleyfcf25832014-12-18 17:42:32 -08001575void SSL_get0_signed_cert_timestamp_list(const SSL *ssl, const uint8_t **out,
1576 size_t *out_len) {
Steven Valdez87eab492016-06-27 16:34:59 -04001577 SSL_SESSION *session = SSL_get_session(ssl);
Adam Langley3cb50e02014-08-26 14:00:31 -07001578
Adam Langleyfcf25832014-12-18 17:42:32 -08001579 *out_len = 0;
1580 *out = NULL;
1581 if (ssl->server || !session || !session->tlsext_signed_cert_timestamp_list) {
1582 return;
1583 }
HÃ¥vard Molland9169c962014-08-14 14:42:37 +02001584
Adam Langleyfcf25832014-12-18 17:42:32 -08001585 *out = session->tlsext_signed_cert_timestamp_list;
1586 *out_len = session->tlsext_signed_cert_timestamp_list_length;
1587}
David Benjamin6c7aed02014-08-27 16:42:38 -04001588
Adam Langleyfcf25832014-12-18 17:42:32 -08001589void SSL_get0_ocsp_response(const SSL *ssl, const uint8_t **out,
1590 size_t *out_len) {
Steven Valdez87eab492016-06-27 16:34:59 -04001591 SSL_SESSION *session = SSL_get_session(ssl);
Adam Langleyfcf25832014-12-18 17:42:32 -08001592
1593 *out_len = 0;
1594 *out = NULL;
1595 if (ssl->server || !session || !session->ocsp_response) {
1596 return;
1597 }
1598 *out = session->ocsp_response;
1599 *out_len = session->ocsp_response_length;
1600}
David Benjamin6c7aed02014-08-27 16:42:38 -04001601
David Benjamin936aada2016-06-07 19:09:22 -04001602int SSL_set_tlsext_host_name(SSL *ssl, const char *name) {
1603 OPENSSL_free(ssl->tlsext_hostname);
1604 ssl->tlsext_hostname = NULL;
1605
1606 if (name == NULL) {
1607 return 1;
1608 }
1609
1610 size_t len = strlen(name);
1611 if (len == 0 || len > TLSEXT_MAXLEN_host_name) {
1612 OPENSSL_PUT_ERROR(SSL, SSL_R_SSL3_EXT_INVALID_SERVERNAME);
1613 return 0;
1614 }
1615 ssl->tlsext_hostname = BUF_strdup(name);
1616 if (ssl->tlsext_hostname == NULL) {
1617 OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
1618 return 0;
1619 }
1620 return 1;
1621}
1622
1623int SSL_CTX_set_tlsext_servername_callback(
1624 SSL_CTX *ctx, int (*callback)(SSL *ssl, int *out_alert, void *arg)) {
1625 ctx->tlsext_servername_callback = callback;
1626 return 1;
1627}
1628
1629int SSL_CTX_set_tlsext_servername_arg(SSL_CTX *ctx, void *arg) {
1630 ctx->tlsext_servername_arg = arg;
1631 return 1;
1632}
1633
David Benjamin977547b2015-09-16 00:25:52 -04001634int SSL_select_next_proto(uint8_t **out, uint8_t *out_len,
1635 const uint8_t *server, unsigned server_len,
1636 const uint8_t *client, unsigned client_len) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001637 unsigned int i, j;
1638 const uint8_t *result;
1639 int status = OPENSSL_NPN_UNSUPPORTED;
Adam Langley95c29f32014-06-20 12:00:00 -07001640
Adam Langleyfcf25832014-12-18 17:42:32 -08001641 /* For each protocol in server preference order, see if we support it. */
1642 for (i = 0; i < server_len;) {
1643 for (j = 0; j < client_len;) {
1644 if (server[i] == client[j] &&
David Benjamin17cf2cb2016-12-13 01:07:13 -05001645 OPENSSL_memcmp(&server[i + 1], &client[j + 1], server[i]) == 0) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001646 /* We found a match */
1647 result = &server[i];
1648 status = OPENSSL_NPN_NEGOTIATED;
1649 goto found;
1650 }
1651 j += client[j];
1652 j++;
1653 }
1654 i += server[i];
1655 i++;
1656 }
Adam Langley95c29f32014-06-20 12:00:00 -07001657
Adam Langleyfcf25832014-12-18 17:42:32 -08001658 /* There's no overlap between our protocols and the server's list. */
1659 result = client;
1660 status = OPENSSL_NPN_NO_OVERLAP;
Adam Langley95c29f32014-06-20 12:00:00 -07001661
Adam Langleyfcf25832014-12-18 17:42:32 -08001662found:
1663 *out = (uint8_t *)result + 1;
David Benjamin977547b2015-09-16 00:25:52 -04001664 *out_len = result[0];
Adam Langleyfcf25832014-12-18 17:42:32 -08001665 return status;
1666}
Adam Langley95c29f32014-06-20 12:00:00 -07001667
David Benjamin977547b2015-09-16 00:25:52 -04001668void SSL_get0_next_proto_negotiated(const SSL *ssl, const uint8_t **out_data,
1669 unsigned *out_len) {
David Benjamin79978df2015-12-25 15:56:49 -05001670 *out_data = ssl->s3->next_proto_negotiated;
David Benjamin977547b2015-09-16 00:25:52 -04001671 if (*out_data == NULL) {
1672 *out_len = 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001673 } else {
David Benjamin79978df2015-12-25 15:56:49 -05001674 *out_len = ssl->s3->next_proto_negotiated_len;
Adam Langleyfcf25832014-12-18 17:42:32 -08001675 }
Adam Langley95c29f32014-06-20 12:00:00 -07001676}
1677
Adam Langleyfcf25832014-12-18 17:42:32 -08001678void SSL_CTX_set_next_protos_advertised_cb(
1679 SSL_CTX *ctx,
David Benjamin977547b2015-09-16 00:25:52 -04001680 int (*cb)(SSL *ssl, const uint8_t **out, unsigned *out_len, void *arg),
Adam Langleyfcf25832014-12-18 17:42:32 -08001681 void *arg) {
1682 ctx->next_protos_advertised_cb = cb;
1683 ctx->next_protos_advertised_cb_arg = arg;
1684}
Adam Langley95c29f32014-06-20 12:00:00 -07001685
Adam Langleyfcf25832014-12-18 17:42:32 -08001686void SSL_CTX_set_next_proto_select_cb(
David Benjamin977547b2015-09-16 00:25:52 -04001687 SSL_CTX *ctx, int (*cb)(SSL *ssl, uint8_t **out, uint8_t *out_len,
1688 const uint8_t *in, unsigned in_len, void *arg),
Adam Langleyfcf25832014-12-18 17:42:32 -08001689 void *arg) {
1690 ctx->next_proto_select_cb = cb;
1691 ctx->next_proto_select_cb_arg = arg;
1692}
Adam Langley95c29f32014-06-20 12:00:00 -07001693
Adam Langleyfcf25832014-12-18 17:42:32 -08001694int SSL_CTX_set_alpn_protos(SSL_CTX *ctx, const uint8_t *protos,
1695 unsigned protos_len) {
David Benjamin2755a3e2015-04-22 16:17:58 -04001696 OPENSSL_free(ctx->alpn_client_proto_list);
Adam Langleyfcf25832014-12-18 17:42:32 -08001697 ctx->alpn_client_proto_list = BUF_memdup(protos, protos_len);
1698 if (!ctx->alpn_client_proto_list) {
1699 return 1;
1700 }
1701 ctx->alpn_client_proto_list_len = protos_len;
Adam Langley95c29f32014-06-20 12:00:00 -07001702
Adam Langleyfcf25832014-12-18 17:42:32 -08001703 return 0;
1704}
Adam Langley95c29f32014-06-20 12:00:00 -07001705
Adam Langleyfcf25832014-12-18 17:42:32 -08001706int SSL_set_alpn_protos(SSL *ssl, const uint8_t *protos, unsigned protos_len) {
David Benjamin2755a3e2015-04-22 16:17:58 -04001707 OPENSSL_free(ssl->alpn_client_proto_list);
Adam Langleyfcf25832014-12-18 17:42:32 -08001708 ssl->alpn_client_proto_list = BUF_memdup(protos, protos_len);
1709 if (!ssl->alpn_client_proto_list) {
1710 return 1;
1711 }
1712 ssl->alpn_client_proto_list_len = protos_len;
Adam Langley95c29f32014-06-20 12:00:00 -07001713
Adam Langleyfcf25832014-12-18 17:42:32 -08001714 return 0;
1715}
Adam Langley95c29f32014-06-20 12:00:00 -07001716
Adam Langleyfcf25832014-12-18 17:42:32 -08001717void SSL_CTX_set_alpn_select_cb(SSL_CTX *ctx,
1718 int (*cb)(SSL *ssl, const uint8_t **out,
David Benjamin8984f1f2015-09-16 00:10:19 -04001719 uint8_t *out_len, const uint8_t *in,
1720 unsigned in_len, void *arg),
Adam Langleyfcf25832014-12-18 17:42:32 -08001721 void *arg) {
1722 ctx->alpn_select_cb = cb;
1723 ctx->alpn_select_cb_arg = arg;
1724}
Adam Langley95c29f32014-06-20 12:00:00 -07001725
David Benjamin8984f1f2015-09-16 00:10:19 -04001726void SSL_get0_alpn_selected(const SSL *ssl, const uint8_t **out_data,
1727 unsigned *out_len) {
1728 *out_data = NULL;
Adam Langleyfcf25832014-12-18 17:42:32 -08001729 if (ssl->s3) {
David Benjamin8984f1f2015-09-16 00:10:19 -04001730 *out_data = ssl->s3->alpn_selected;
Adam Langleyfcf25832014-12-18 17:42:32 -08001731 }
David Benjamin8984f1f2015-09-16 00:10:19 -04001732 if (*out_data == NULL) {
1733 *out_len = 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001734 } else {
David Benjamin8984f1f2015-09-16 00:10:19 -04001735 *out_len = ssl->s3->alpn_selected_len;
Adam Langleyfcf25832014-12-18 17:42:32 -08001736 }
1737}
Adam Langley95c29f32014-06-20 12:00:00 -07001738
David Benjamin936aada2016-06-07 19:09:22 -04001739
David Benjamineebd3c82016-12-06 17:43:58 -05001740void SSL_CTX_set_tls_channel_id_enabled(SSL_CTX *ctx, int enabled) {
1741 ctx->tlsext_channel_id_enabled = !!enabled;
1742}
1743
David Benjamin936aada2016-06-07 19:09:22 -04001744int SSL_CTX_enable_tls_channel_id(SSL_CTX *ctx) {
David Benjamineebd3c82016-12-06 17:43:58 -05001745 SSL_CTX_set_tls_channel_id_enabled(ctx, 1);
David Benjamin936aada2016-06-07 19:09:22 -04001746 return 1;
1747}
1748
David Benjamineebd3c82016-12-06 17:43:58 -05001749void SSL_set_tls_channel_id_enabled(SSL *ssl, int enabled) {
1750 ssl->tlsext_channel_id_enabled = !!enabled;
1751}
1752
David Benjamin936aada2016-06-07 19:09:22 -04001753int SSL_enable_tls_channel_id(SSL *ssl) {
David Benjamineebd3c82016-12-06 17:43:58 -05001754 SSL_set_tls_channel_id_enabled(ssl, 1);
David Benjamin936aada2016-06-07 19:09:22 -04001755 return 1;
1756}
1757
1758static int is_p256_key(EVP_PKEY *private_key) {
1759 const EC_KEY *ec_key = EVP_PKEY_get0_EC_KEY(private_key);
1760 return ec_key != NULL &&
1761 EC_GROUP_get_curve_name(EC_KEY_get0_group(ec_key)) ==
1762 NID_X9_62_prime256v1;
1763}
1764
1765int SSL_CTX_set1_tls_channel_id(SSL_CTX *ctx, EVP_PKEY *private_key) {
1766 if (!is_p256_key(private_key)) {
1767 OPENSSL_PUT_ERROR(SSL, SSL_R_CHANNEL_ID_NOT_P256);
1768 return 0;
1769 }
1770
1771 EVP_PKEY_free(ctx->tlsext_channel_id_private);
Adam Langley310d3f62016-07-12 10:39:20 -07001772 EVP_PKEY_up_ref(private_key);
1773 ctx->tlsext_channel_id_private = private_key;
David Benjamin936aada2016-06-07 19:09:22 -04001774 ctx->tlsext_channel_id_enabled = 1;
1775
1776 return 1;
1777}
1778
1779int SSL_set1_tls_channel_id(SSL *ssl, EVP_PKEY *private_key) {
1780 if (!is_p256_key(private_key)) {
1781 OPENSSL_PUT_ERROR(SSL, SSL_R_CHANNEL_ID_NOT_P256);
1782 return 0;
1783 }
1784
1785 EVP_PKEY_free(ssl->tlsext_channel_id_private);
Adam Langley310d3f62016-07-12 10:39:20 -07001786 EVP_PKEY_up_ref(private_key);
1787 ssl->tlsext_channel_id_private = private_key;
David Benjamin936aada2016-06-07 19:09:22 -04001788 ssl->tlsext_channel_id_enabled = 1;
1789
1790 return 1;
1791}
1792
1793size_t SSL_get_tls_channel_id(SSL *ssl, uint8_t *out, size_t max_out) {
1794 if (!ssl->s3->tlsext_channel_id_valid) {
1795 return 0;
1796 }
David Benjamin17cf2cb2016-12-13 01:07:13 -05001797 OPENSSL_memcpy(out, ssl->s3->tlsext_channel_id,
1798 (max_out < 64) ? max_out : 64);
David Benjamin936aada2016-06-07 19:09:22 -04001799 return 64;
1800}
1801
David Benjamin936aada2016-06-07 19:09:22 -04001802size_t SSL_get0_certificate_types(SSL *ssl, const uint8_t **out_types) {
David Benjamina0486782016-10-06 19:11:32 -04001803 if (ssl->server || ssl->s3->hs == NULL) {
David Benjamin936aada2016-06-07 19:09:22 -04001804 *out_types = NULL;
1805 return 0;
1806 }
David Benjamina0486782016-10-06 19:11:32 -04001807 *out_types = ssl->s3->hs->certificate_types;
1808 return ssl->s3->hs->num_certificate_types;
David Benjamin936aada2016-06-07 19:09:22 -04001809}
1810
David Benjaminf3c8f8d2016-11-17 17:20:47 +09001811void ssl_update_cache(SSL_HANDSHAKE *hs, int mode) {
1812 SSL *const ssl = hs->ssl;
David Benjamin1269ddd2015-10-18 15:18:55 -04001813 SSL_CTX *ctx = ssl->initial_ctx;
David Benjaminb6d0c6d2015-03-19 19:07:26 -04001814 /* Never cache sessions with empty session IDs. */
Steven Valdez87eab492016-06-27 16:34:59 -04001815 if (ssl->s3->established_session->session_id_length == 0 ||
David Benjamin1269ddd2015-10-18 15:18:55 -04001816 (ctx->session_cache_mode & mode) != mode) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001817 return;
1818 }
Adam Langley95c29f32014-06-20 12:00:00 -07001819
David Benjamin1269ddd2015-10-18 15:18:55 -04001820 /* Clients never use the internal session cache. */
1821 int use_internal_cache = ssl->server && !(ctx->session_cache_mode &
1822 SSL_SESS_CACHE_NO_INTERNAL_STORE);
David Benjamin95d31822015-06-15 19:53:32 -04001823
David Benjamin1269ddd2015-10-18 15:18:55 -04001824 /* A client may see new sessions on abbreviated handshakes if the server
1825 * decides to renew the ticket. Once the handshake is completed, it should be
1826 * inserted into the cache. */
Steven Valdez87eab492016-06-27 16:34:59 -04001827 if (ssl->s3->established_session != ssl->session ||
David Benjaminf3c8f8d2016-11-17 17:20:47 +09001828 (!ssl->server && hs->ticket_expected)) {
David Benjamin1269ddd2015-10-18 15:18:55 -04001829 if (use_internal_cache) {
Steven Valdez87eab492016-06-27 16:34:59 -04001830 SSL_CTX_add_session(ctx, ssl->s3->established_session);
David Benjamin1269ddd2015-10-18 15:18:55 -04001831 }
David Benjaminb9195402016-08-05 10:51:43 -04001832 if (ctx->new_session_cb != NULL) {
1833 SSL_SESSION_up_ref(ssl->s3->established_session);
1834 if (!ctx->new_session_cb(ssl, ssl->s3->established_session)) {
1835 /* |new_session_cb|'s return value signals whether it took ownership. */
1836 SSL_SESSION_free(ssl->s3->established_session);
1837 }
Adam Langleyfcf25832014-12-18 17:42:32 -08001838 }
1839 }
Adam Langley95c29f32014-06-20 12:00:00 -07001840
David Benjamin1269ddd2015-10-18 15:18:55 -04001841 if (use_internal_cache &&
1842 !(ctx->session_cache_mode & SSL_SESS_CACHE_NO_AUTO_CLEAR)) {
David Benjaminb6d0c6d2015-03-19 19:07:26 -04001843 /* Automatically flush the internal session cache every 255 connections. */
1844 int flush_cache = 0;
Adam Langley4bdb6e42015-05-15 15:29:21 -07001845 CRYPTO_MUTEX_lock_write(&ctx->lock);
David Benjaminb6d0c6d2015-03-19 19:07:26 -04001846 ctx->handshakes_since_cache_flush++;
1847 if (ctx->handshakes_since_cache_flush >= 255) {
1848 flush_cache = 1;
1849 ctx->handshakes_since_cache_flush = 0;
1850 }
David Benjamin29270de2016-05-24 15:28:36 +00001851 CRYPTO_MUTEX_unlock_write(&ctx->lock);
David Benjaminb6d0c6d2015-03-19 19:07:26 -04001852
1853 if (flush_cache) {
David Benjamin721e8b72016-08-03 13:13:17 -04001854 struct timeval now;
1855 ssl_get_current_time(ssl, &now);
1856 SSL_CTX_flush_sessions(ctx, (long)now.tv_sec);
Adam Langleyfcf25832014-12-18 17:42:32 -08001857 }
1858 }
1859}
Adam Langley95c29f32014-06-20 12:00:00 -07001860
Adam Langleyfcf25832014-12-18 17:42:32 -08001861static const char *ssl_get_version(int version) {
1862 switch (version) {
Steven Valdezfdd10992016-09-15 16:27:05 -04001863 /* Report TLS 1.3 draft version as TLS 1.3 in the public API. */
1864 case TLS1_3_DRAFT_VERSION:
Steven Valdez4f94b1c2016-05-24 12:31:07 -04001865 return "TLSv1.3";
1866
Adam Langleyfcf25832014-12-18 17:42:32 -08001867 case TLS1_2_VERSION:
1868 return "TLSv1.2";
Adam Langley95c29f32014-06-20 12:00:00 -07001869
Adam Langleyfcf25832014-12-18 17:42:32 -08001870 case TLS1_1_VERSION:
1871 return "TLSv1.1";
Adam Langley95c29f32014-06-20 12:00:00 -07001872
Adam Langleyfcf25832014-12-18 17:42:32 -08001873 case TLS1_VERSION:
1874 return "TLSv1";
Adam Langley95c29f32014-06-20 12:00:00 -07001875
Adam Langleyfcf25832014-12-18 17:42:32 -08001876 case SSL3_VERSION:
1877 return "SSLv3";
Adam Langley95c29f32014-06-20 12:00:00 -07001878
David Benjamin1c722b72015-04-20 13:53:10 -04001879 case DTLS1_VERSION:
1880 return "DTLSv1";
1881
1882 case DTLS1_2_VERSION:
1883 return "DTLSv1.2";
1884
Adam Langleyfcf25832014-12-18 17:42:32 -08001885 default:
1886 return "unknown";
1887 }
1888}
Adam Langley95c29f32014-06-20 12:00:00 -07001889
David Benjamin42fea372015-09-19 01:22:44 -04001890const char *SSL_get_version(const SSL *ssl) {
1891 return ssl_get_version(ssl->version);
Adam Langleyfcf25832014-12-18 17:42:32 -08001892}
Adam Langley95c29f32014-06-20 12:00:00 -07001893
David Benjamina6b8cdf2015-09-13 14:07:33 -04001894const char *SSL_SESSION_get_version(const SSL_SESSION *session) {
1895 return ssl_get_version(session->ssl_version);
Adam Langleyfcf25832014-12-18 17:42:32 -08001896}
Adam Langley95c29f32014-06-20 12:00:00 -07001897
David Benjamin0d56f882015-12-19 17:05:56 -05001898EVP_PKEY *SSL_get_privatekey(const SSL *ssl) {
1899 if (ssl->cert != NULL) {
1900 return ssl->cert->privatekey;
Adam Langleyfcf25832014-12-18 17:42:32 -08001901 }
1902
1903 return NULL;
1904}
1905
Adam Langleyfcf25832014-12-18 17:42:32 -08001906EVP_PKEY *SSL_CTX_get0_privatekey(const SSL_CTX *ctx) {
1907 if (ctx->cert != NULL) {
David Benjamind1d80782015-07-05 11:54:09 -04001908 return ctx->cert->privatekey;
Adam Langleyfcf25832014-12-18 17:42:32 -08001909 }
1910
1911 return NULL;
1912}
1913
David Benjamin42fea372015-09-19 01:22:44 -04001914const SSL_CIPHER *SSL_get_current_cipher(const SSL *ssl) {
David Benjamin79978df2015-12-25 15:56:49 -05001915 if (ssl->s3->aead_write_ctx == NULL) {
David Benjamina07c0fc2015-05-13 13:19:42 -04001916 return NULL;
Adam Langleyfcf25832014-12-18 17:42:32 -08001917 }
David Benjamin79978df2015-12-25 15:56:49 -05001918 return ssl->s3->aead_write_ctx->cipher;
Adam Langleyfcf25832014-12-18 17:42:32 -08001919}
1920
David Benjamin936aada2016-06-07 19:09:22 -04001921int SSL_session_reused(const SSL *ssl) {
Steven Valdez4aa154e2016-07-29 14:32:55 -04001922 return ssl->s3->session_reused;
David Benjamin936aada2016-06-07 19:09:22 -04001923}
1924
David Benjamin0d56f882015-12-19 17:05:56 -05001925const COMP_METHOD *SSL_get_current_compression(SSL *ssl) { return NULL; }
Adam Langleyfcf25832014-12-18 17:42:32 -08001926
David Benjamin0d56f882015-12-19 17:05:56 -05001927const COMP_METHOD *SSL_get_current_expansion(SSL *ssl) { return NULL; }
Adam Langleyfcf25832014-12-18 17:42:32 -08001928
Adam Langley29ec5d12016-03-01 16:12:28 -08001929int *SSL_get_server_tmp_key(SSL *ssl, EVP_PKEY **out_key) { return 0; }
1930
Adam Langleyfcf25832014-12-18 17:42:32 -08001931void SSL_CTX_set_quiet_shutdown(SSL_CTX *ctx, int mode) {
Adam Langleybb85f3d2015-10-28 18:44:11 -07001932 ctx->quiet_shutdown = (mode != 0);
Adam Langleyfcf25832014-12-18 17:42:32 -08001933}
1934
1935int SSL_CTX_get_quiet_shutdown(const SSL_CTX *ctx) {
1936 return ctx->quiet_shutdown;
1937}
1938
Adam Langleybb85f3d2015-10-28 18:44:11 -07001939void SSL_set_quiet_shutdown(SSL *ssl, int mode) {
1940 ssl->quiet_shutdown = (mode != 0);
1941}
Adam Langleyfcf25832014-12-18 17:42:32 -08001942
David Benjamin9f859492015-10-03 10:44:30 -04001943int SSL_get_quiet_shutdown(const SSL *ssl) { return ssl->quiet_shutdown; }
Adam Langleyfcf25832014-12-18 17:42:32 -08001944
David Benjamin63006a92015-10-18 00:00:06 -04001945void SSL_set_shutdown(SSL *ssl, int mode) {
1946 /* It is an error to clear any bits that have already been set. (We can't try
1947 * to get a second close_notify or send two.) */
David Benjaminfa214e42016-05-10 17:03:10 -04001948 assert((SSL_get_shutdown(ssl) & mode) == SSL_get_shutdown(ssl));
David Benjamin63006a92015-10-18 00:00:06 -04001949
David Benjaminfa214e42016-05-10 17:03:10 -04001950 if (mode & SSL_RECEIVED_SHUTDOWN &&
1951 ssl->s3->recv_shutdown == ssl_shutdown_none) {
1952 ssl->s3->recv_shutdown = ssl_shutdown_close_notify;
1953 }
1954
1955 if (mode & SSL_SENT_SHUTDOWN &&
1956 ssl->s3->send_shutdown == ssl_shutdown_none) {
1957 ssl->s3->send_shutdown = ssl_shutdown_close_notify;
1958 }
David Benjamin63006a92015-10-18 00:00:06 -04001959}
Adam Langleyfcf25832014-12-18 17:42:32 -08001960
David Benjaminfa214e42016-05-10 17:03:10 -04001961int SSL_get_shutdown(const SSL *ssl) {
1962 int ret = 0;
1963 if (ssl->s3->recv_shutdown != ssl_shutdown_none) {
1964 /* Historically, OpenSSL set |SSL_RECEIVED_SHUTDOWN| on both close_notify
1965 * and fatal alert. */
1966 ret |= SSL_RECEIVED_SHUTDOWN;
1967 }
1968 if (ssl->s3->send_shutdown == ssl_shutdown_close_notify) {
1969 /* Historically, OpenSSL set |SSL_SENT_SHUTDOWN| on only close_notify. */
1970 ret |= SSL_SENT_SHUTDOWN;
1971 }
1972 return ret;
1973}
Adam Langleyfcf25832014-12-18 17:42:32 -08001974
Steven Valdezfdd10992016-09-15 16:27:05 -04001975int SSL_version(const SSL *ssl) {
1976 /* Report TLS 1.3 draft version as TLS 1.3 in the public API. */
1977 if (ssl->version == TLS1_3_DRAFT_VERSION) {
1978 return TLS1_3_VERSION;
1979 }
1980
1981 return ssl->version;
1982}
Adam Langleyfcf25832014-12-18 17:42:32 -08001983
1984SSL_CTX *SSL_get_SSL_CTX(const SSL *ssl) { return ssl->ctx; }
1985
1986SSL_CTX *SSL_set_SSL_CTX(SSL *ssl, SSL_CTX *ctx) {
1987 if (ssl->ctx == ctx) {
1988 return ssl->ctx;
1989 }
1990
Adam Langley3509dac2017-02-01 11:59:18 -08001991 /* One cannot change the X.509 callbacks during a connection. */
1992 if (ssl->ctx->x509_method != ctx->x509_method) {
1993 assert(0);
1994 return NULL;
1995 }
1996
Adam Langleyfcf25832014-12-18 17:42:32 -08001997 if (ctx == NULL) {
1998 ctx = ssl->initial_ctx;
1999 }
2000
David Benjamin2755a3e2015-04-22 16:17:58 -04002001 ssl_cert_free(ssl->cert);
Adam Langleyfcf25832014-12-18 17:42:32 -08002002 ssl->cert = ssl_cert_dup(ctx->cert);
David Benjamin2755a3e2015-04-22 16:17:58 -04002003
David Benjaminf650c712016-12-22 15:54:51 -05002004 SSL_CTX_up_ref(ctx);
2005 SSL_CTX_free(ssl->ctx);
Adam Langleyfcf25832014-12-18 17:42:32 -08002006 ssl->ctx = ctx;
2007
Adam Langleyfcf25832014-12-18 17:42:32 -08002008 return ssl->ctx;
2009}
2010
Adam Langley95c29f32014-06-20 12:00:00 -07002011void SSL_set_info_callback(SSL *ssl,
David Benjamin82170242015-10-17 22:51:17 -04002012 void (*cb)(const SSL *ssl, int type, int value)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002013 ssl->info_callback = cb;
2014}
Adam Langley95c29f32014-06-20 12:00:00 -07002015
David Benjamin82170242015-10-17 22:51:17 -04002016void (*SSL_get_info_callback(const SSL *ssl))(const SSL *ssl, int type,
2017 int value) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002018 return ssl->info_callback;
2019}
Adam Langley95c29f32014-06-20 12:00:00 -07002020
David Benjamincb0c29f2016-12-12 17:00:50 -05002021int SSL_state(const SSL *ssl) {
David Benjamin9e766d72017-02-10 23:14:17 -05002022 return SSL_in_init(ssl) ? SSL_ST_INIT : SSL_ST_OK;
David Benjamincb0c29f2016-12-12 17:00:50 -05002023}
Adam Langley95c29f32014-06-20 12:00:00 -07002024
David Benjaminece089c2015-05-15 23:52:42 -04002025void SSL_set_state(SSL *ssl, int state) { }
Adam Langley95c29f32014-06-20 12:00:00 -07002026
Emily Stark95a79ee2016-02-25 21:12:28 -08002027char *SSL_get_shared_ciphers(const SSL *ssl, char *buf, int len) {
2028 if (len <= 0) {
2029 return NULL;
2030 }
2031 buf[0] = '\0';
2032 return buf;
2033}
2034
David Benjamin8a589332015-12-04 23:14:35 -05002035int SSL_get_ex_new_index(long argl, void *argp, CRYPTO_EX_unused *unused,
Adam Langleyfcf25832014-12-18 17:42:32 -08002036 CRYPTO_EX_dup *dup_func, CRYPTO_EX_free *free_func) {
David Benjamin9f33fc62015-04-15 17:29:53 -04002037 int index;
2038 if (!CRYPTO_get_ex_new_index(&g_ex_data_class_ssl, &index, argl, argp,
David Benjamin8a589332015-12-04 23:14:35 -05002039 dup_func, free_func)) {
David Benjamin9f33fc62015-04-15 17:29:53 -04002040 return -1;
2041 }
2042 return index;
Adam Langleyfcf25832014-12-18 17:42:32 -08002043}
Adam Langley95c29f32014-06-20 12:00:00 -07002044
David Benjamin1ac08fe2015-09-15 01:36:22 -04002045int SSL_set_ex_data(SSL *ssl, int idx, void *arg) {
2046 return CRYPTO_set_ex_data(&ssl->ex_data, idx, arg);
Adam Langleyfcf25832014-12-18 17:42:32 -08002047}
Adam Langley95c29f32014-06-20 12:00:00 -07002048
David Benjamin1ac08fe2015-09-15 01:36:22 -04002049void *SSL_get_ex_data(const SSL *ssl, int idx) {
2050 return CRYPTO_get_ex_data(&ssl->ex_data, idx);
Adam Langleyfcf25832014-12-18 17:42:32 -08002051}
Adam Langley95c29f32014-06-20 12:00:00 -07002052
David Benjamin8a589332015-12-04 23:14:35 -05002053int SSL_CTX_get_ex_new_index(long argl, void *argp, CRYPTO_EX_unused *unused,
Adam Langleyfcf25832014-12-18 17:42:32 -08002054 CRYPTO_EX_dup *dup_func,
2055 CRYPTO_EX_free *free_func) {
David Benjamin9f33fc62015-04-15 17:29:53 -04002056 int index;
2057 if (!CRYPTO_get_ex_new_index(&g_ex_data_class_ssl_ctx, &index, argl, argp,
David Benjamin8a589332015-12-04 23:14:35 -05002058 dup_func, free_func)) {
David Benjamin9f33fc62015-04-15 17:29:53 -04002059 return -1;
2060 }
2061 return index;
Adam Langleyfcf25832014-12-18 17:42:32 -08002062}
Adam Langley95c29f32014-06-20 12:00:00 -07002063
David Benjamin1ac08fe2015-09-15 01:36:22 -04002064int SSL_CTX_set_ex_data(SSL_CTX *ctx, int idx, void *arg) {
2065 return CRYPTO_set_ex_data(&ctx->ex_data, idx, arg);
Adam Langleyfcf25832014-12-18 17:42:32 -08002066}
Adam Langley95c29f32014-06-20 12:00:00 -07002067
David Benjamin1ac08fe2015-09-15 01:36:22 -04002068void *SSL_CTX_get_ex_data(const SSL_CTX *ctx, int idx) {
2069 return CRYPTO_get_ex_data(&ctx->ex_data, idx);
Adam Langleyfcf25832014-12-18 17:42:32 -08002070}
Adam Langley95c29f32014-06-20 12:00:00 -07002071
David Benjamin93d17492015-10-17 12:43:36 -04002072int SSL_want(const SSL *ssl) { return ssl->rwstate; }
Adam Langley95c29f32014-06-20 12:00:00 -07002073
Adam Langleyfcf25832014-12-18 17:42:32 -08002074void SSL_CTX_set_tmp_rsa_callback(SSL_CTX *ctx,
2075 RSA *(*cb)(SSL *ssl, int is_export,
2076 int keylength)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002077}
Adam Langley95c29f32014-06-20 12:00:00 -07002078
Adam Langleyfcf25832014-12-18 17:42:32 -08002079void SSL_set_tmp_rsa_callback(SSL *ssl, RSA *(*cb)(SSL *ssl, int is_export,
2080 int keylength)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002081}
2082
2083void SSL_CTX_set_tmp_dh_callback(SSL_CTX *ctx,
David Benjamin59015c32015-04-26 13:13:55 -04002084 DH *(*callback)(SSL *ssl, int is_export,
2085 int keylength)) {
2086 ctx->cert->dh_tmp_cb = callback;
Adam Langleyfcf25832014-12-18 17:42:32 -08002087}
2088
David Benjamin59015c32015-04-26 13:13:55 -04002089void SSL_set_tmp_dh_callback(SSL *ssl, DH *(*callback)(SSL *ssl, int is_export,
2090 int keylength)) {
2091 ssl->cert->dh_tmp_cb = callback;
Adam Langleyfcf25832014-12-18 17:42:32 -08002092}
2093
Adam Langleyfcf25832014-12-18 17:42:32 -08002094int SSL_CTX_use_psk_identity_hint(SSL_CTX *ctx, const char *identity_hint) {
2095 if (identity_hint != NULL && strlen(identity_hint) > PSK_MAX_IDENTITY_LEN) {
David Benjamin3570d732015-06-29 00:28:17 -04002096 OPENSSL_PUT_ERROR(SSL, SSL_R_DATA_LENGTH_TOO_LONG);
Adam Langleyfcf25832014-12-18 17:42:32 -08002097 return 0;
2098 }
2099
David Benjamin2755a3e2015-04-22 16:17:58 -04002100 OPENSSL_free(ctx->psk_identity_hint);
Adam Langleyfcf25832014-12-18 17:42:32 -08002101
2102 if (identity_hint != NULL) {
2103 ctx->psk_identity_hint = BUF_strdup(identity_hint);
2104 if (ctx->psk_identity_hint == NULL) {
2105 return 0;
Adam Langley95c29f32014-06-20 12:00:00 -07002106 }
Adam Langleyfcf25832014-12-18 17:42:32 -08002107 } else {
2108 ctx->psk_identity_hint = NULL;
2109 }
Adam Langley95c29f32014-06-20 12:00:00 -07002110
Adam Langleyfcf25832014-12-18 17:42:32 -08002111 return 1;
2112}
2113
David Benjamine8814df2015-09-15 08:05:54 -04002114int SSL_use_psk_identity_hint(SSL *ssl, const char *identity_hint) {
2115 if (ssl == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002116 return 0;
2117 }
2118
2119 if (identity_hint != NULL && strlen(identity_hint) > PSK_MAX_IDENTITY_LEN) {
David Benjamin3570d732015-06-29 00:28:17 -04002120 OPENSSL_PUT_ERROR(SSL, SSL_R_DATA_LENGTH_TOO_LONG);
Adam Langleyfcf25832014-12-18 17:42:32 -08002121 return 0;
2122 }
2123
2124 /* Clear currently configured hint, if any. */
David Benjamine8814df2015-09-15 08:05:54 -04002125 OPENSSL_free(ssl->psk_identity_hint);
2126 ssl->psk_identity_hint = NULL;
Adam Langleyfcf25832014-12-18 17:42:32 -08002127
David Benjamin78679342016-09-16 19:42:05 -04002128 /* Treat the empty hint as not supplying one. Plain PSK makes it possible to
2129 * send either no hint (omit ServerKeyExchange) or an empty hint, while
2130 * ECDHE_PSK can only spell empty hint. Having different capabilities is odd,
2131 * so we interpret empty and missing as identical. */
2132 if (identity_hint != NULL && identity_hint[0] != '\0') {
David Benjamine8814df2015-09-15 08:05:54 -04002133 ssl->psk_identity_hint = BUF_strdup(identity_hint);
2134 if (ssl->psk_identity_hint == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002135 return 0;
Adam Langley95c29f32014-06-20 12:00:00 -07002136 }
Adam Langleyfcf25832014-12-18 17:42:32 -08002137 }
Adam Langley95c29f32014-06-20 12:00:00 -07002138
Adam Langleyfcf25832014-12-18 17:42:32 -08002139 return 1;
2140}
Adam Langley95c29f32014-06-20 12:00:00 -07002141
David Benjamine8814df2015-09-15 08:05:54 -04002142const char *SSL_get_psk_identity_hint(const SSL *ssl) {
2143 if (ssl == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002144 return NULL;
2145 }
David Benjamine8814df2015-09-15 08:05:54 -04002146 return ssl->psk_identity_hint;
Adam Langleyfcf25832014-12-18 17:42:32 -08002147}
Adam Langley95c29f32014-06-20 12:00:00 -07002148
David Benjamine8814df2015-09-15 08:05:54 -04002149const char *SSL_get_psk_identity(const SSL *ssl) {
Steven Valdez87eab492016-06-27 16:34:59 -04002150 if (ssl == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002151 return NULL;
2152 }
Steven Valdez87eab492016-06-27 16:34:59 -04002153 SSL_SESSION *session = SSL_get_session(ssl);
2154 if (session == NULL) {
2155 return NULL;
2156 }
2157 return session->psk_identity;
Adam Langleyfcf25832014-12-18 17:42:32 -08002158}
Adam Langley95c29f32014-06-20 12:00:00 -07002159
Adam Langleyfcf25832014-12-18 17:42:32 -08002160void SSL_set_psk_client_callback(
David Benjamine8814df2015-09-15 08:05:54 -04002161 SSL *ssl, unsigned (*cb)(SSL *ssl, const char *hint, char *identity,
2162 unsigned max_identity_len, uint8_t *psk,
2163 unsigned max_psk_len)) {
2164 ssl->psk_client_callback = cb;
Adam Langleyfcf25832014-12-18 17:42:32 -08002165}
Adam Langley95c29f32014-06-20 12:00:00 -07002166
Adam Langleyfcf25832014-12-18 17:42:32 -08002167void SSL_CTX_set_psk_client_callback(
David Benjamine8814df2015-09-15 08:05:54 -04002168 SSL_CTX *ctx, unsigned (*cb)(SSL *ssl, const char *hint, char *identity,
2169 unsigned max_identity_len, uint8_t *psk,
2170 unsigned max_psk_len)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002171 ctx->psk_client_callback = cb;
2172}
Adam Langley95c29f32014-06-20 12:00:00 -07002173
Adam Langleyfcf25832014-12-18 17:42:32 -08002174void SSL_set_psk_server_callback(
David Benjamine8814df2015-09-15 08:05:54 -04002175 SSL *ssl, unsigned (*cb)(SSL *ssl, const char *identity, uint8_t *psk,
2176 unsigned max_psk_len)) {
2177 ssl->psk_server_callback = cb;
Adam Langleyfcf25832014-12-18 17:42:32 -08002178}
Adam Langley95c29f32014-06-20 12:00:00 -07002179
Adam Langleyfcf25832014-12-18 17:42:32 -08002180void SSL_CTX_set_psk_server_callback(
David Benjamine8814df2015-09-15 08:05:54 -04002181 SSL_CTX *ctx, unsigned (*cb)(SSL *ssl, const char *identity,
2182 uint8_t *psk, unsigned max_psk_len)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002183 ctx->psk_server_callback = cb;
2184}
Adam Langley95c29f32014-06-20 12:00:00 -07002185
Adam Langleyfcf25832014-12-18 17:42:32 -08002186void SSL_CTX_set_msg_callback(SSL_CTX *ctx,
2187 void (*cb)(int write_p, int version,
2188 int content_type, const void *buf,
2189 size_t len, SSL *ssl, void *arg)) {
David Benjamin59015c32015-04-26 13:13:55 -04002190 ctx->msg_callback = cb;
Adam Langleyfcf25832014-12-18 17:42:32 -08002191}
David Benjamin61ecccf2015-05-05 09:44:51 -04002192
2193void SSL_CTX_set_msg_callback_arg(SSL_CTX *ctx, void *arg) {
2194 ctx->msg_callback_arg = arg;
2195}
2196
Adam Langleyfcf25832014-12-18 17:42:32 -08002197void SSL_set_msg_callback(SSL *ssl,
2198 void (*cb)(int write_p, int version, int content_type,
2199 const void *buf, size_t len, SSL *ssl,
2200 void *arg)) {
David Benjamin59015c32015-04-26 13:13:55 -04002201 ssl->msg_callback = cb;
Adam Langleyfcf25832014-12-18 17:42:32 -08002202}
Adam Langley95c29f32014-06-20 12:00:00 -07002203
David Benjamin61ecccf2015-05-05 09:44:51 -04002204void SSL_set_msg_callback_arg(SSL *ssl, void *arg) {
2205 ssl->msg_callback_arg = arg;
2206}
2207
David Benjamind28f59c2015-11-17 22:32:50 -05002208void SSL_CTX_set_keylog_callback(SSL_CTX *ctx,
2209 void (*cb)(const SSL *ssl, const char *line)) {
2210 ctx->keylog_callback = cb;
Adam Langleyfcf25832014-12-18 17:42:32 -08002211}
Adam Langley95c29f32014-06-20 12:00:00 -07002212
David Benjamin6e3f5cc2016-09-14 14:43:14 -04002213void (*SSL_CTX_get_keylog_callback(const SSL_CTX *ctx))(const SSL *ssl,
2214 const char *line) {
2215 return ctx->keylog_callback;
2216}
2217
Taylor Brandstetter9edb2c62016-06-08 15:26:59 -07002218void SSL_CTX_set_current_time_cb(SSL_CTX *ctx,
2219 void (*cb)(const SSL *ssl,
2220 struct timeval *out_clock)) {
2221 ctx->current_time_cb = cb;
2222}
2223
Adam Langleyfcf25832014-12-18 17:42:32 -08002224static int cbb_add_hex(CBB *cbb, const uint8_t *in, size_t in_len) {
2225 static const char hextable[] = "0123456789abcdef";
2226 uint8_t *out;
Adam Langley95c29f32014-06-20 12:00:00 -07002227
Adam Langleyfcf25832014-12-18 17:42:32 -08002228 if (!CBB_add_space(cbb, &out, in_len * 2)) {
2229 return 0;
2230 }
Adam Langley95c29f32014-06-20 12:00:00 -07002231
David Benjamin54091232016-09-05 12:47:25 -04002232 for (size_t i = 0; i < in_len; i++) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002233 *(out++) = (uint8_t)hextable[in[i] >> 4];
2234 *(out++) = (uint8_t)hextable[in[i] & 0xf];
2235 }
Adam Langley95c29f32014-06-20 12:00:00 -07002236
Adam Langleyfcf25832014-12-18 17:42:32 -08002237 return 1;
2238}
David Benjamin859ec3c2014-09-02 16:29:36 -04002239
David Benjamine776cc22016-07-19 07:26:49 +02002240int ssl_log_secret(const SSL *ssl, const char *label, const uint8_t *secret,
2241 size_t secret_len) {
David Benjamind28f59c2015-11-17 22:32:50 -05002242 if (ssl->ctx->keylog_callback == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002243 return 1;
2244 }
Adam Langleyadb739e2014-06-20 12:00:00 -07002245
David Benjamind28f59c2015-11-17 22:32:50 -05002246 CBB cbb;
2247 uint8_t *out;
2248 size_t out_len;
David Benjamine776cc22016-07-19 07:26:49 +02002249 if (!CBB_init(&cbb, strlen(label) + 1 + SSL3_RANDOM_SIZE * 2 + 1 +
2250 secret_len * 2 + 1) ||
2251 !CBB_add_bytes(&cbb, (const uint8_t *)label, strlen(label)) ||
Adam Langleyfcf25832014-12-18 17:42:32 -08002252 !CBB_add_bytes(&cbb, (const uint8_t *)" ", 1) ||
David Benjamine776cc22016-07-19 07:26:49 +02002253 !cbb_add_hex(&cbb, ssl->s3->client_random, SSL3_RANDOM_SIZE) ||
2254 !CBB_add_bytes(&cbb, (const uint8_t *)" ", 1) ||
2255 !cbb_add_hex(&cbb, secret, secret_len) ||
David Benjamind28f59c2015-11-17 22:32:50 -05002256 !CBB_add_u8(&cbb, 0 /* NUL */) ||
Adam Langleyfcf25832014-12-18 17:42:32 -08002257 !CBB_finish(&cbb, &out, &out_len)) {
2258 CBB_cleanup(&cbb);
2259 return 0;
2260 }
Adam Langleyadb739e2014-06-20 12:00:00 -07002261
David Benjamind28f59c2015-11-17 22:32:50 -05002262 ssl->ctx->keylog_callback(ssl, (const char *)out);
Adam Langleyfcf25832014-12-18 17:42:32 -08002263 OPENSSL_free(out);
David Benjamind28f59c2015-11-17 22:32:50 -05002264 return 1;
Adam Langley95c29f32014-06-20 12:00:00 -07002265}
2266
David Benjamin5d8b1282015-10-17 23:26:35 -04002267int SSL_is_init_finished(const SSL *ssl) {
David Benjamin9e766d72017-02-10 23:14:17 -05002268 return !SSL_in_init(ssl);
David Benjamin5d8b1282015-10-17 23:26:35 -04002269}
2270
2271int SSL_in_init(const SSL *ssl) {
David Benjamin9e766d72017-02-10 23:14:17 -05002272 SSL_HANDSHAKE *hs = ssl->s3->hs;
2273 return hs != NULL && hs->state != SSL_ST_OK;
David Benjamin5d8b1282015-10-17 23:26:35 -04002274}
2275
2276int SSL_in_false_start(const SSL *ssl) {
David Benjamina0486782016-10-06 19:11:32 -04002277 if (ssl->s3->hs == NULL) {
2278 return 0;
2279 }
2280 return ssl->s3->hs->in_false_start;
David Benjamined7c4752015-02-16 19:16:46 -05002281}
2282
David Benjamin0d56f882015-12-19 17:05:56 -05002283int SSL_cutthrough_complete(const SSL *ssl) {
2284 return SSL_in_false_start(ssl);
Adam Langleyfcf25832014-12-18 17:42:32 -08002285}
Adam Langley95c29f32014-06-20 12:00:00 -07002286
Adam Langleyfcf25832014-12-18 17:42:32 -08002287void SSL_get_structure_sizes(size_t *ssl_size, size_t *ssl_ctx_size,
2288 size_t *ssl_session_size) {
2289 *ssl_size = sizeof(SSL);
2290 *ssl_ctx_size = sizeof(SSL_CTX);
2291 *ssl_session_size = sizeof(SSL_SESSION);
2292}
Feng Lu41aa3252014-11-21 22:47:56 -08002293
David Benjamin0d56f882015-12-19 17:05:56 -05002294int ssl3_can_false_start(const SSL *ssl) {
2295 const SSL_CIPHER *const cipher = SSL_get_current_cipher(ssl);
Adam Langleyfcf25832014-12-18 17:42:32 -08002296
Adam Langleye631d962015-04-01 13:11:01 -07002297 /* False Start only for TLS 1.2 with an ECDHE+AEAD cipher and ALPN or NPN. */
David Benjamince079fd2016-08-02 16:22:34 -04002298 return !SSL_is_dtls(ssl) &&
Steven Valdez4f94b1c2016-05-24 12:31:07 -04002299 SSL_version(ssl) == TLS1_2_VERSION &&
David Benjaminb74b0812016-10-06 19:43:48 -04002300 (ssl->s3->alpn_selected != NULL ||
2301 ssl->s3->next_proto_negotiated != NULL) &&
David Benjamin195dc782015-02-19 13:27:05 -05002302 cipher != NULL &&
Matthew Braithwaite651aaef2016-12-08 16:14:36 -08002303 cipher->algorithm_mkey == SSL_kECDHE &&
David Benjamin13414b32015-12-09 23:02:39 -05002304 cipher->algorithm_mac == SSL_AEAD;
Adam Langleyfcf25832014-12-18 17:42:32 -08002305}
2306
David Benjaminb6a0a512016-06-21 10:33:21 -04002307const struct {
2308 uint16_t version;
2309 uint32_t flag;
2310} kVersions[] = {
2311 {SSL3_VERSION, SSL_OP_NO_SSLv3},
2312 {TLS1_VERSION, SSL_OP_NO_TLSv1},
2313 {TLS1_1_VERSION, SSL_OP_NO_TLSv1_1},
2314 {TLS1_2_VERSION, SSL_OP_NO_TLSv1_2},
2315 {TLS1_3_VERSION, SSL_OP_NO_TLSv1_3},
2316};
Adam Langleyfcf25832014-12-18 17:42:32 -08002317
Steven Valdezcb966542016-08-17 16:56:14 -04002318static const size_t kVersionsLen = OPENSSL_ARRAY_SIZE(kVersions);
Adam Langleyfcf25832014-12-18 17:42:32 -08002319
David Benjamine0ff7672016-09-19 18:40:03 -04002320int ssl_get_version_range(const SSL *ssl, uint16_t *out_min_version,
2321 uint16_t *out_max_version) {
David Benjaminb6a0a512016-06-21 10:33:21 -04002322 /* For historical reasons, |SSL_OP_NO_DTLSv1| aliases |SSL_OP_NO_TLSv1|, but
2323 * DTLS 1.0 should be mapped to TLS 1.1. */
David Benjamin0d56f882015-12-19 17:05:56 -05002324 uint32_t options = ssl->options;
David Benjamince079fd2016-08-02 16:22:34 -04002325 if (SSL_is_dtls(ssl)) {
David Benjaminb6a0a512016-06-21 10:33:21 -04002326 options &= ~SSL_OP_NO_TLSv1_1;
2327 if (options & SSL_OP_NO_DTLSv1) {
2328 options |= SSL_OP_NO_TLSv1_1;
2329 }
2330 }
2331
2332 uint16_t min_version = ssl->min_version;
2333 uint16_t max_version = ssl->max_version;
2334
2335 /* Bound the range to only those implemented in this protocol. */
2336 if (min_version < ssl->method->min_version) {
2337 min_version = ssl->method->min_version;
2338 }
2339 if (max_version > ssl->method->max_version) {
2340 max_version = ssl->method->max_version;
2341 }
Adam Langleyfcf25832014-12-18 17:42:32 -08002342
2343 /* OpenSSL's API for controlling versions entails blacklisting individual
2344 * protocols. This has two problems. First, on the client, the protocol can
2345 * only express a contiguous range of versions. Second, a library consumer
2346 * trying to set a maximum version cannot disable protocol versions that get
2347 * added in a future version of the library.
2348 *
2349 * To account for both of these, OpenSSL interprets the client-side bitmask
2350 * as a min/max range by picking the lowest contiguous non-empty range of
2351 * enabled protocols. Note that this means it is impossible to set a maximum
David Benjaminb6a0a512016-06-21 10:33:21 -04002352 * version of the higest supported TLS version in a future-proof way. */
David Benjaminb6a0a512016-06-21 10:33:21 -04002353 int any_enabled = 0;
David Benjamin54091232016-09-05 12:47:25 -04002354 for (size_t i = 0; i < kVersionsLen; i++) {
David Benjaminb6a0a512016-06-21 10:33:21 -04002355 /* Only look at the versions already enabled. */
2356 if (min_version > kVersions[i].version) {
2357 continue;
Adam Langleyfcf25832014-12-18 17:42:32 -08002358 }
David Benjaminb6a0a512016-06-21 10:33:21 -04002359 if (max_version < kVersions[i].version) {
2360 break;
Adam Langleyfcf25832014-12-18 17:42:32 -08002361 }
David Benjaminb6a0a512016-06-21 10:33:21 -04002362
2363 if (!(options & kVersions[i].flag)) {
2364 /* The minimum version is the first enabled version. */
2365 if (!any_enabled) {
2366 any_enabled = 1;
2367 min_version = kVersions[i].version;
2368 }
2369 continue;
Adam Langleyfcf25832014-12-18 17:42:32 -08002370 }
David Benjaminb6a0a512016-06-21 10:33:21 -04002371
2372 /* If there is a disabled version after the first enabled one, all versions
2373 * after it are implicitly disabled. */
2374 if (any_enabled) {
2375 max_version = kVersions[i-1].version;
2376 break;
Adam Langleyfcf25832014-12-18 17:42:32 -08002377 }
2378 }
2379
David Benjamine0ff7672016-09-19 18:40:03 -04002380 if (!any_enabled) {
David Benjaminb6a0a512016-06-21 10:33:21 -04002381 OPENSSL_PUT_ERROR(SSL, SSL_R_WRONG_SSL_VERSION);
2382 return 0;
David Benjaminea72bd02014-12-21 21:27:41 -05002383 }
2384
David Benjaminb6a0a512016-06-21 10:33:21 -04002385 *out_min_version = min_version;
2386 *out_max_version = max_version;
2387 return 1;
David Benjaminea72bd02014-12-21 21:27:41 -05002388}
2389
David Benjaminb9e4fa52015-12-29 23:58:17 -05002390uint16_t ssl3_protocol_version(const SSL *ssl) {
2391 assert(ssl->s3->have_version);
David Benjamin2dc02042016-09-19 19:57:37 -04002392 uint16_t version;
2393 if (!ssl->method->version_from_wire(&version, ssl->version)) {
2394 /* TODO(davidben): Use the internal version representation for ssl->version
2395 * and map to the public API representation at API boundaries. */
2396 assert(0);
2397 return 0;
2398 }
2399
2400 return version;
David Benjaminb9e4fa52015-12-29 23:58:17 -05002401}
2402
David Benjamince079fd2016-08-02 16:22:34 -04002403int SSL_is_server(const SSL *ssl) { return ssl->server; }
2404
2405int SSL_is_dtls(const SSL *ssl) { return ssl->method->is_dtls; }
Adam Langleyfcf25832014-12-18 17:42:32 -08002406
David Benjamin731058e2016-12-03 23:15:13 -05002407void SSL_CTX_set_select_certificate_cb(SSL_CTX *ctx,
2408 int (*cb)(const SSL_CLIENT_HELLO *)) {
David Benjamind4c2bce2015-10-17 12:28:18 -04002409 ctx->select_certificate_cb = cb;
2410}
2411
David Benjamin731058e2016-12-03 23:15:13 -05002412void SSL_CTX_set_dos_protection_cb(SSL_CTX *ctx,
2413 int (*cb)(const SSL_CLIENT_HELLO *)) {
Adam Langley524e7172015-02-20 16:04:00 -08002414 ctx->dos_protection_cb = cb;
2415}
2416
David Benjamin1d5ef3b2015-10-12 19:54:18 -04002417void SSL_set_renegotiate_mode(SSL *ssl, enum ssl_renegotiate_mode_t mode) {
2418 ssl->renegotiate_mode = mode;
2419}
2420
Adam Langleyc2d32802015-11-03 18:36:10 -08002421int SSL_get_ivs(const SSL *ssl, const uint8_t **out_read_iv,
2422 const uint8_t **out_write_iv, size_t *out_iv_len) {
David Benjamin79978df2015-12-25 15:56:49 -05002423 if (ssl->s3->aead_read_ctx == NULL || ssl->s3->aead_write_ctx == NULL) {
Adam Langleyc2d32802015-11-03 18:36:10 -08002424 return 0;
2425 }
2426
2427 size_t write_iv_len;
David Benjamin79978df2015-12-25 15:56:49 -05002428 if (!EVP_AEAD_CTX_get_iv(&ssl->s3->aead_read_ctx->ctx, out_read_iv,
2429 out_iv_len) ||
2430 !EVP_AEAD_CTX_get_iv(&ssl->s3->aead_write_ctx->ctx, out_write_iv,
Adam Langleyc2d32802015-11-03 18:36:10 -08002431 &write_iv_len) ||
2432 *out_iv_len != write_iv_len) {
2433 return 0;
2434 }
2435
2436 return 1;
David Benjamine348ff42015-11-06 17:55:30 -05002437}
David Benjamin6e807652015-11-02 12:02:20 -05002438
David Benjamin91b25012016-01-21 16:39:58 -05002439static uint64_t be_to_u64(const uint8_t in[8]) {
David Benjaminde942382016-02-11 12:02:01 -05002440 return (((uint64_t)in[0]) << 56) | (((uint64_t)in[1]) << 48) |
2441 (((uint64_t)in[2]) << 40) | (((uint64_t)in[3]) << 32) |
2442 (((uint64_t)in[4]) << 24) | (((uint64_t)in[5]) << 16) |
2443 (((uint64_t)in[6]) << 8) | ((uint64_t)in[7]);
David Benjamin91b25012016-01-21 16:39:58 -05002444}
2445
2446uint64_t SSL_get_read_sequence(const SSL *ssl) {
2447 /* TODO(davidben): Internally represent sequence numbers as uint64_t. */
David Benjamince079fd2016-08-02 16:22:34 -04002448 if (SSL_is_dtls(ssl)) {
David Benjaminde942382016-02-11 12:02:01 -05002449 /* max_seq_num already includes the epoch. */
2450 assert(ssl->d1->r_epoch == (ssl->d1->bitmap.max_seq_num >> 48));
2451 return ssl->d1->bitmap.max_seq_num;
2452 }
David Benjamin91b25012016-01-21 16:39:58 -05002453 return be_to_u64(ssl->s3->read_sequence);
2454}
2455
2456uint64_t SSL_get_write_sequence(const SSL *ssl) {
David Benjaminde942382016-02-11 12:02:01 -05002457 uint64_t ret = be_to_u64(ssl->s3->write_sequence);
David Benjamince079fd2016-08-02 16:22:34 -04002458 if (SSL_is_dtls(ssl)) {
David Benjaminde942382016-02-11 12:02:01 -05002459 assert((ret >> 48) == 0);
2460 ret |= ((uint64_t)ssl->d1->w_epoch) << 48;
2461 }
2462 return ret;
David Benjamin91b25012016-01-21 16:39:58 -05002463}
2464
Steven Valdez02563852016-06-23 13:33:05 -04002465uint16_t SSL_get_peer_signature_algorithm(const SSL *ssl) {
David Benjaminf1050fd2016-12-13 20:05:36 -05002466 /* TODO(davidben): This checks the wrong session if there is a renegotiation
2467 * in progress. */
2468 SSL_SESSION *session = SSL_get_session(ssl);
2469 if (session == NULL) {
2470 return 0;
2471 }
2472
2473 return session->peer_signature_algorithm;
Steven Valdez02563852016-06-23 13:33:05 -04002474}
2475
David Benjamin96ba15f2015-12-25 14:10:17 -05002476size_t SSL_get_client_random(const SSL *ssl, uint8_t *out, size_t max_out) {
2477 if (max_out == 0) {
2478 return sizeof(ssl->s3->client_random);
2479 }
2480 if (max_out > sizeof(ssl->s3->client_random)) {
2481 max_out = sizeof(ssl->s3->client_random);
2482 }
David Benjamin17cf2cb2016-12-13 01:07:13 -05002483 OPENSSL_memcpy(out, ssl->s3->client_random, max_out);
David Benjamin96ba15f2015-12-25 14:10:17 -05002484 return max_out;
2485}
2486
2487size_t SSL_get_server_random(const SSL *ssl, uint8_t *out, size_t max_out) {
2488 if (max_out == 0) {
2489 return sizeof(ssl->s3->server_random);
2490 }
2491 if (max_out > sizeof(ssl->s3->server_random)) {
2492 max_out = sizeof(ssl->s3->server_random);
2493 }
David Benjamin17cf2cb2016-12-13 01:07:13 -05002494 OPENSSL_memcpy(out, ssl->s3->server_random, max_out);
David Benjamin96ba15f2015-12-25 14:10:17 -05002495 return max_out;
2496}
2497
David Benjaminf6494f42016-01-07 12:37:41 -08002498const SSL_CIPHER *SSL_get_pending_cipher(const SSL *ssl) {
2499 if (!SSL_in_init(ssl)) {
2500 return NULL;
2501 }
2502 return ssl->s3->tmp.new_cipher;
2503}
2504
David Benjaminbbaf3672016-11-17 10:53:09 +09002505void SSL_set_retain_only_sha256_of_client_certs(SSL *ssl, int enabled) {
2506 ssl->retain_only_sha256_of_client_certs = !!enabled;
2507}
2508
David Benjamincdd0b7e2016-01-07 10:10:41 -08002509void SSL_CTX_set_retain_only_sha256_of_client_certs(SSL_CTX *ctx, int enabled) {
2510 ctx->retain_only_sha256_of_client_certs = !!enabled;
2511}
2512
David Benjamin65ac9972016-09-02 21:35:25 -04002513void SSL_CTX_set_grease_enabled(SSL_CTX *ctx, int enabled) {
2514 ctx->grease_enabled = !!enabled;
2515}
2516
David Benjamin6f600d62016-12-21 16:06:54 -05002517void SSL_CTX_set_short_header_enabled(SSL_CTX *ctx, int enabled) {
2518 ctx->short_header_enabled = !!enabled;
2519}
2520
David Benjamin27bbae42015-09-13 00:54:37 -04002521int SSL_clear(SSL *ssl) {
David Benjaminb79cc842016-12-07 15:57:14 -05002522 /* In OpenSSL, reusing a client |SSL| with |SSL_clear| causes the previously
2523 * established session to be offered the next time around. wpa_supplicant
2524 * depends on this behavior, so emulate it. */
2525 SSL_SESSION *session = NULL;
2526 if (!ssl->server && ssl->s3->established_session != NULL) {
2527 session = ssl->s3->established_session;
2528 SSL_SESSION_up_ref(session);
2529 }
2530
David Benjamin27bbae42015-09-13 00:54:37 -04002531 /* TODO(davidben): Some state on |ssl| is reset both in |SSL_new| and
2532 * |SSL_clear| because it is per-connection state rather than configuration
2533 * state. Per-connection state should be on |ssl->s3| and |ssl->d1| so it is
2534 * naturally reset at the right points between |SSL_new|, |SSL_clear|, and
2535 * |ssl3_new|. */
2536
2537 ssl->rwstate = SSL_NOTHING;
2538
2539 BUF_MEM_free(ssl->init_buf);
2540 ssl->init_buf = NULL;
David Benjamin49054542016-07-27 13:51:01 -04002541 ssl->init_msg = NULL;
2542 ssl->init_num = 0;
David Benjamin27bbae42015-09-13 00:54:37 -04002543
David Benjamin27bbae42015-09-13 00:54:37 -04002544 /* The ssl->d1->mtu is simultaneously configuration (preserved across
2545 * clear) and connection-specific state (gets reset).
2546 *
2547 * TODO(davidben): Avoid this. */
2548 unsigned mtu = 0;
2549 if (ssl->d1 != NULL) {
2550 mtu = ssl->d1->mtu;
2551 }
2552
2553 ssl->method->ssl_free(ssl);
2554 if (!ssl->method->ssl_new(ssl)) {
David Benjaminb79cc842016-12-07 15:57:14 -05002555 SSL_SESSION_free(session);
David Benjamin27bbae42015-09-13 00:54:37 -04002556 return 0;
2557 }
David Benjamin27bbae42015-09-13 00:54:37 -04002558
David Benjamince079fd2016-08-02 16:22:34 -04002559 if (SSL_is_dtls(ssl) && (SSL_get_options(ssl) & SSL_OP_NO_QUERY_MTU)) {
David Benjamin27bbae42015-09-13 00:54:37 -04002560 ssl->d1->mtu = mtu;
2561 }
2562
David Benjaminb79cc842016-12-07 15:57:14 -05002563 if (session != NULL) {
2564 SSL_set_session(ssl, session);
2565 SSL_SESSION_free(session);
2566 }
2567
David Benjamin27bbae42015-09-13 00:54:37 -04002568 return 1;
2569}
2570
David Benjamin4e9cc712016-06-01 20:16:03 -04002571void ssl_do_info_callback(const SSL *ssl, int type, int value) {
2572 void (*cb)(const SSL *ssl, int type, int value) = NULL;
2573 if (ssl->info_callback != NULL) {
2574 cb = ssl->info_callback;
2575 } else if (ssl->ctx->info_callback != NULL) {
2576 cb = ssl->ctx->info_callback;
2577 }
2578
2579 if (cb != NULL) {
2580 cb(ssl, type, value);
2581 }
2582}
2583
David Benjaminc0279992016-09-19 20:15:07 -04002584void ssl_do_msg_callback(SSL *ssl, int is_write, int content_type,
David Benjamin4e9cc712016-06-01 20:16:03 -04002585 const void *buf, size_t len) {
David Benjaminc0279992016-09-19 20:15:07 -04002586 if (ssl->msg_callback == NULL) {
2587 return;
David Benjamin4e9cc712016-06-01 20:16:03 -04002588 }
David Benjaminc0279992016-09-19 20:15:07 -04002589
2590 /* |version| is zero when calling for |SSL3_RT_HEADER| and |SSL2_VERSION| for
2591 * a V2ClientHello. */
2592 int version;
2593 switch (content_type) {
2594 case 0:
2595 /* V2ClientHello */
2596 version = SSL2_VERSION;
2597 break;
2598 case SSL3_RT_HEADER:
2599 version = 0;
2600 break;
2601 default:
Steven Valdezfdd10992016-09-15 16:27:05 -04002602 version = SSL_version(ssl);
David Benjaminc0279992016-09-19 20:15:07 -04002603 }
2604
2605 ssl->msg_callback(is_write, version, content_type, buf, len, ssl,
2606 ssl->msg_callback_arg);
David Benjamin4e9cc712016-06-01 20:16:03 -04002607}
2608
David Benjaminda881e92015-04-26 14:45:04 -04002609int SSL_CTX_sess_connect(const SSL_CTX *ctx) { return 0; }
2610int SSL_CTX_sess_connect_good(const SSL_CTX *ctx) { return 0; }
2611int SSL_CTX_sess_connect_renegotiate(const SSL_CTX *ctx) { return 0; }
2612int SSL_CTX_sess_accept(const SSL_CTX *ctx) { return 0; }
2613int SSL_CTX_sess_accept_renegotiate(const SSL_CTX *ctx) { return 0; }
2614int SSL_CTX_sess_accept_good(const SSL_CTX *ctx) { return 0; }
2615int SSL_CTX_sess_hits(const SSL_CTX *ctx) { return 0; }
2616int SSL_CTX_sess_cb_hits(const SSL_CTX *ctx) { return 0; }
2617int SSL_CTX_sess_misses(const SSL_CTX *ctx) { return 0; }
2618int SSL_CTX_sess_timeouts(const SSL_CTX *ctx) { return 0; }
2619int SSL_CTX_sess_cache_full(const SSL_CTX *ctx) { return 0; }
David Benjamin936aada2016-06-07 19:09:22 -04002620
2621int SSL_num_renegotiations(const SSL *ssl) {
2622 return SSL_total_renegotiations(ssl);
2623}
2624
2625int SSL_CTX_need_tmp_RSA(const SSL_CTX *ctx) { return 0; }
2626int SSL_need_tmp_RSA(const SSL *ssl) { return 0; }
2627int SSL_CTX_set_tmp_rsa(SSL_CTX *ctx, const RSA *rsa) { return 1; }
2628int SSL_set_tmp_rsa(SSL *ssl, const RSA *rsa) { return 1; }
Matt Braithwaite4838d8a2015-08-20 13:20:03 -07002629void ERR_load_SSL_strings(void) {}
David Benjamin27bbae42015-09-13 00:54:37 -04002630void SSL_load_error_strings(void) {}
David Benjamin936aada2016-06-07 19:09:22 -04002631int SSL_cache_hit(SSL *ssl) { return SSL_session_reused(ssl); }
2632
2633int SSL_CTX_set_tmp_ecdh(SSL_CTX *ctx, const EC_KEY *ec_key) {
2634 if (ec_key == NULL || EC_KEY_get0_group(ec_key) == NULL) {
2635 OPENSSL_PUT_ERROR(SSL, ERR_R_PASSED_NULL_PARAMETER);
2636 return 0;
2637 }
2638 int nid = EC_GROUP_get_curve_name(EC_KEY_get0_group(ec_key));
2639 return SSL_CTX_set1_curves(ctx, &nid, 1);
2640}
2641
2642int SSL_set_tmp_ecdh(SSL *ssl, const EC_KEY *ec_key) {
2643 if (ec_key == NULL || EC_KEY_get0_group(ec_key) == NULL) {
2644 OPENSSL_PUT_ERROR(SSL, ERR_R_PASSED_NULL_PARAMETER);
2645 return 0;
2646 }
2647 int nid = EC_GROUP_get_curve_name(EC_KEY_get0_group(ec_key));
2648 return SSL_set1_curves(ssl, &nid, 1);
2649}
David Benjamin721e8b72016-08-03 13:13:17 -04002650
2651void ssl_get_current_time(const SSL *ssl, struct timeval *out_clock) {
2652 if (ssl->ctx->current_time_cb != NULL) {
2653 ssl->ctx->current_time_cb(ssl, out_clock);
2654 return;
2655 }
2656
David Benjaminec978dd2016-11-04 18:59:33 -04002657#if defined(BORINGSSL_UNSAFE_DETERMINISTIC_MODE)
David Benjamin01a90572016-09-22 00:11:43 -04002658 out_clock->tv_sec = 1234;
2659 out_clock->tv_usec = 1234;
2660#elif defined(OPENSSL_WINDOWS)
David Benjamin721e8b72016-08-03 13:13:17 -04002661 struct _timeb time;
2662 _ftime(&time);
2663 out_clock->tv_sec = time.time;
2664 out_clock->tv_usec = time.millitm * 1000;
2665#else
2666 gettimeofday(out_clock, NULL);
2667#endif
2668}
David Benjamine4706902016-09-20 15:12:23 -04002669
2670int SSL_CTX_set_min_version(SSL_CTX *ctx, uint16_t version) {
2671 return SSL_CTX_set_min_proto_version(ctx, version);
2672}
2673
2674int SSL_CTX_set_max_version(SSL_CTX *ctx, uint16_t version) {
2675 return SSL_CTX_set_max_proto_version(ctx, version);
2676}
2677
2678int SSL_set_min_version(SSL *ssl, uint16_t version) {
2679 return SSL_set_min_proto_version(ssl, version);
2680}
2681
2682int SSL_set_max_version(SSL *ssl, uint16_t version) {
2683 return SSL_set_max_proto_version(ssl, version);
2684}