blob: e37f9f944d73cd008d4833567cd08d5d59fe9c33 [file] [log] [blame]
Adam Langley95c29f32014-06-20 12:00:00 -07001/* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
2 * All rights reserved.
3 *
4 * This package is an SSL implementation written
5 * by Eric Young (eay@cryptsoft.com).
6 * The implementation was written so as to conform with Netscapes SSL.
7 *
8 * This library is free for commercial and non-commercial use as long as
9 * the following conditions are aheared to. The following conditions
10 * apply to all code found in this distribution, be it the RC4, RSA,
11 * lhash, DES, etc., code; not just the SSL code. The SSL documentation
12 * included with this distribution is covered by the same copyright terms
13 * except that the holder is Tim Hudson (tjh@cryptsoft.com).
14 *
15 * Copyright remains Eric Young's, and as such any Copyright notices in
16 * the code are not to be removed.
17 * If this package is used in a product, Eric Young should be given attribution
18 * as the author of the parts of the library used.
19 * This can be in the form of a textual message at program startup or
20 * in documentation (online or textual) provided with the package.
21 *
22 * Redistribution and use in source and binary forms, with or without
23 * modification, are permitted provided that the following conditions
24 * are met:
25 * 1. Redistributions of source code must retain the copyright
26 * notice, this list of conditions and the following disclaimer.
27 * 2. Redistributions in binary form must reproduce the above copyright
28 * notice, this list of conditions and the following disclaimer in the
29 * documentation and/or other materials provided with the distribution.
30 * 3. All advertising materials mentioning features or use of this software
31 * must display the following acknowledgement:
32 * "This product includes cryptographic software written by
33 * Eric Young (eay@cryptsoft.com)"
34 * The word 'cryptographic' can be left out if the rouines from the library
35 * being used are not cryptographic related :-).
36 * 4. If you include any Windows specific code (or a derivative thereof) from
37 * the apps directory (application code) you must include an acknowledgement:
38 * "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
39 *
40 * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
41 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
42 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
43 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
44 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
45 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
46 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
47 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
48 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
49 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
50 * SUCH DAMAGE.
51 *
52 * The licence and distribution terms for any publically available version or
53 * derivative of this code cannot be changed. i.e. this code cannot simply be
54 * copied and put under another distribution licence
55 * [including the GNU Public Licence.]
56 */
57/* ====================================================================
58 * Copyright (c) 1998-2007 The OpenSSL Project. All rights reserved.
59 *
60 * Redistribution and use in source and binary forms, with or without
61 * modification, are permitted provided that the following conditions
62 * are met:
63 *
64 * 1. Redistributions of source code must retain the above copyright
65 * notice, this list of conditions and the following disclaimer.
66 *
67 * 2. Redistributions in binary form must reproduce the above copyright
68 * notice, this list of conditions and the following disclaimer in
69 * the documentation and/or other materials provided with the
70 * distribution.
71 *
72 * 3. All advertising materials mentioning features or use of this
73 * software must display the following acknowledgment:
74 * "This product includes software developed by the OpenSSL Project
75 * for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
76 *
77 * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
78 * endorse or promote products derived from this software without
79 * prior written permission. For written permission, please contact
80 * openssl-core@openssl.org.
81 *
82 * 5. Products derived from this software may not be called "OpenSSL"
83 * nor may "OpenSSL" appear in their names without prior written
84 * permission of the OpenSSL Project.
85 *
86 * 6. Redistributions of any form whatsoever must retain the following
87 * acknowledgment:
88 * "This product includes software developed by the OpenSSL Project
89 * for use in the OpenSSL Toolkit (http://www.openssl.org/)"
90 *
91 * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
92 * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
93 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
94 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
95 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
96 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
97 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
98 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
99 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
100 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
101 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
102 * OF THE POSSIBILITY OF SUCH DAMAGE.
103 * ====================================================================
104 *
105 * This product includes cryptographic software written by Eric Young
106 * (eay@cryptsoft.com). This product includes software written by Tim
107 * Hudson (tjh@cryptsoft.com).
108 *
109 */
110/* ====================================================================
111 * Copyright 2002 Sun Microsystems, Inc. ALL RIGHTS RESERVED.
112 * ECC cipher suite support in OpenSSL originally developed by
113 * SUN MICROSYSTEMS, INC., and contributed to the OpenSSL project.
114 */
115/* ====================================================================
116 * Copyright 2005 Nokia. All rights reserved.
117 *
118 * The portions of the attached software ("Contribution") is developed by
119 * Nokia Corporation and is licensed pursuant to the OpenSSL open source
120 * license.
121 *
122 * The Contribution, originally written by Mika Kousa and Pasi Eronen of
123 * Nokia Corporation, consists of the "PSK" (Pre-Shared Key) ciphersuites
124 * support (see RFC 4279) to OpenSSL.
125 *
126 * No patent licenses or other rights except those expressly stated in
127 * the OpenSSL open source license shall be deemed granted or received
128 * expressly, by implication, estoppel, or otherwise.
129 *
130 * No assurances are provided by Nokia that the Contribution does not
131 * infringe the patent or other intellectual property rights of any third
132 * party or that the license provides you with all the necessary rights
133 * to make use of the Contribution.
134 *
135 * THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IN
136 * ADDITION TO THE DISCLAIMERS INCLUDED IN THE LICENSE, NOKIA
137 * SPECIFICALLY DISCLAIMS ANY LIABILITY FOR CLAIMS BROUGHT BY YOU OR ANY
138 * OTHER ENTITY BASED ON INFRINGEMENT OF INTELLECTUAL PROPERTY RIGHTS OR
139 * OTHERWISE. */
140
David Benjamin9e4e01e2015-09-15 01:48:04 -0400141#include <openssl/ssl.h>
142
Adam Langley95c29f32014-06-20 12:00:00 -0700143#include <assert.h>
David Benjamin93d97432016-08-08 21:22:47 -0400144#include <stdlib.h>
David Benjaminf0ae1702015-04-07 23:05:04 -0400145#include <string.h>
Adam Langley95c29f32014-06-20 12:00:00 -0700146
David Benjamin39482a12014-07-20 13:30:15 -0400147#include <openssl/bytestring.h>
David Benjamin7c6d09b2015-09-05 11:00:19 -0400148#include <openssl/crypto.h>
Adam Langley95c29f32014-06-20 12:00:00 -0700149#include <openssl/dh.h>
David Benjaminf0ae1702015-04-07 23:05:04 -0400150#include <openssl/err.h>
Adam Langley95c29f32014-06-20 12:00:00 -0700151#include <openssl/lhash.h>
152#include <openssl/mem.h>
Adam Langley95c29f32014-06-20 12:00:00 -0700153#include <openssl/rand.h>
Adam Langley95c29f32014-06-20 12:00:00 -0700154
David Benjamin2ee94aa2015-04-07 22:38:30 -0400155#include "internal.h"
David Benjamin546f1a52015-04-15 16:46:09 -0400156#include "../crypto/internal.h"
157
David Benjamin721e8b72016-08-03 13:13:17 -0400158#if defined(OPENSSL_WINDOWS)
159#include <sys/timeb.h>
160#else
161#include <sys/socket.h>
162#include <sys/time.h>
163#endif
164
Adam Langley95c29f32014-06-20 12:00:00 -0700165
David Benjamin76c2efc2015-08-31 14:24:29 -0400166/* |SSL_R_UNKNOWN_PROTOCOL| is no longer emitted, but continue to define it
David Benjamin97760d52015-07-24 23:02:49 -0400167 * to avoid downstream churn. */
David Benjamin76c2efc2015-08-31 14:24:29 -0400168OPENSSL_DECLARE_ERROR_REASON(SSL, UNKNOWN_PROTOCOL)
David Benjamin97760d52015-07-24 23:02:49 -0400169
David Benjamin311c2572016-08-17 15:54:36 -0400170/* The following errors are no longer emitted, but are used in nginx without
171 * #ifdefs. */
172OPENSSL_DECLARE_ERROR_REASON(SSL, BLOCK_CIPHER_PAD_IS_WRONG)
173OPENSSL_DECLARE_ERROR_REASON(SSL, NO_CIPHERS_SPECIFIED)
174
Adam Langleyfcf25832014-12-18 17:42:32 -0800175/* Some error codes are special. Ensure the make_errors.go script never
176 * regresses this. */
177OPENSSL_COMPILE_ASSERT(SSL_R_TLSV1_ALERT_NO_RENEGOTIATION ==
178 SSL_AD_NO_RENEGOTIATION + SSL_AD_REASON_OFFSET,
179 ssl_alert_reason_code_mismatch);
David Benjamine1136082014-09-20 12:28:58 -0400180
David Benjamin1d0a1942015-04-26 15:35:35 -0400181/* kMaxHandshakeSize is the maximum size, in bytes, of a handshake message. */
182static const size_t kMaxHandshakeSize = (1u << 24) - 1;
183
David Benjaminaa585132015-06-29 23:36:17 -0400184static CRYPTO_EX_DATA_CLASS g_ex_data_class_ssl =
185 CRYPTO_EX_DATA_CLASS_INIT_WITH_APP_DATA;
186static CRYPTO_EX_DATA_CLASS g_ex_data_class_ssl_ctx =
187 CRYPTO_EX_DATA_CLASS_INIT_WITH_APP_DATA;
David Benjamin9f33fc62015-04-15 17:29:53 -0400188
David Benjamin7c6d09b2015-09-05 11:00:19 -0400189int SSL_library_init(void) {
190 CRYPTO_library_init();
191 return 1;
192}
193
Adam Langleye976e432016-02-15 14:01:10 -0800194static uint32_t ssl_session_hash(const SSL_SESSION *sess) {
195 const uint8_t *session_id = sess->session_id;
196
197 uint8_t tmp_storage[sizeof(uint32_t)];
198 if (sess->session_id_length < sizeof(tmp_storage)) {
David Benjamin17cf2cb2016-12-13 01:07:13 -0500199 OPENSSL_memset(tmp_storage, 0, sizeof(tmp_storage));
200 OPENSSL_memcpy(tmp_storage, sess->session_id, sess->session_id_length);
Adam Langleye976e432016-02-15 14:01:10 -0800201 session_id = tmp_storage;
202 }
203
David Benjamin27bbae42015-09-13 00:54:37 -0400204 uint32_t hash =
Adam Langleye976e432016-02-15 14:01:10 -0800205 ((uint32_t)session_id[0]) |
206 ((uint32_t)session_id[1] << 8) |
207 ((uint32_t)session_id[2] << 16) |
208 ((uint32_t)session_id[3] << 24);
David Benjamin7c6d09b2015-09-05 11:00:19 -0400209
David Benjamin27bbae42015-09-13 00:54:37 -0400210 return hash;
211}
212
213/* NB: If this function (or indeed the hash function which uses a sort of
214 * coarser function than this one) is changed, ensure
215 * SSL_CTX_has_matching_session_id() is checked accordingly. It relies on being
216 * able to construct an SSL_SESSION that will collide with any existing session
217 * with a matching session ID. */
218static int ssl_session_cmp(const SSL_SESSION *a, const SSL_SESSION *b) {
219 if (a->ssl_version != b->ssl_version) {
220 return 1;
Adam Langleyfcf25832014-12-18 17:42:32 -0800221 }
Adam Langley95c29f32014-06-20 12:00:00 -0700222
David Benjamin27bbae42015-09-13 00:54:37 -0400223 if (a->session_id_length != b->session_id_length) {
224 return 1;
Adam Langleyfcf25832014-12-18 17:42:32 -0800225 }
Adam Langley95c29f32014-06-20 12:00:00 -0700226
David Benjamin17cf2cb2016-12-13 01:07:13 -0500227 return OPENSSL_memcmp(a->session_id, b->session_id, a->session_id_length);
David Benjamin27bbae42015-09-13 00:54:37 -0400228}
Adam Langley95c29f32014-06-20 12:00:00 -0700229
David Benjamin27bbae42015-09-13 00:54:37 -0400230SSL_CTX *SSL_CTX_new(const SSL_METHOD *method) {
231 SSL_CTX *ret = NULL;
232
233 if (method == NULL) {
234 OPENSSL_PUT_ERROR(SSL, SSL_R_NULL_SSL_METHOD_PASSED);
235 return NULL;
Adam Langleyfcf25832014-12-18 17:42:32 -0800236 }
Adam Langley95c29f32014-06-20 12:00:00 -0700237
David Benjamin27bbae42015-09-13 00:54:37 -0400238 if (SSL_get_ex_data_X509_STORE_CTX_idx() < 0) {
239 OPENSSL_PUT_ERROR(SSL, SSL_R_X509_VERIFICATION_SETUP_PROBLEMS);
240 goto err;
David Benjamin62fd1622015-01-11 13:30:01 -0500241 }
242
Brian Smith5ba06892016-02-07 09:36:04 -1000243 ret = OPENSSL_malloc(sizeof(SSL_CTX));
David Benjamin27bbae42015-09-13 00:54:37 -0400244 if (ret == NULL) {
245 goto err;
David Benjamin62fd1622015-01-11 13:30:01 -0500246 }
247
David Benjamin17cf2cb2016-12-13 01:07:13 -0500248 OPENSSL_memset(ret, 0, sizeof(SSL_CTX));
Adam Langley95c29f32014-06-20 12:00:00 -0700249
David Benjamin27bbae42015-09-13 00:54:37 -0400250 ret->method = method->method;
Adam Langley3509dac2017-02-01 11:59:18 -0800251 ret->x509_method = method->x509_method;
David Benjamin27bbae42015-09-13 00:54:37 -0400252
253 CRYPTO_MUTEX_init(&ret->lock);
254
255 ret->session_cache_mode = SSL_SESS_CACHE_SERVER;
256 ret->session_cache_size = SSL_SESSION_CACHE_MAX_SIZE_DEFAULT;
257
David Benjamin27bbae42015-09-13 00:54:37 -0400258 ret->session_timeout = SSL_DEFAULT_SESSION_TIMEOUT;
David Benjamin17b30832017-01-28 14:00:32 -0500259 ret->session_psk_dhe_timeout = SSL_DEFAULT_SESSION_PSK_DHE_TIMEOUT;
David Benjamin27bbae42015-09-13 00:54:37 -0400260
261 ret->references = 1;
262
263 ret->max_cert_list = SSL_MAX_CERT_LIST_DEFAULT;
264 ret->verify_mode = SSL_VERIFY_NONE;
Adam Langley3509dac2017-02-01 11:59:18 -0800265 ret->cert = ssl_cert_new(method->x509_method);
David Benjamin27bbae42015-09-13 00:54:37 -0400266 if (ret->cert == NULL) {
267 goto err;
268 }
269
270 ret->sessions = lh_SSL_SESSION_new(ssl_session_hash, ssl_session_cmp);
271 if (ret->sessions == NULL) {
272 goto err;
273 }
274 ret->cert_store = X509_STORE_new();
275 if (ret->cert_store == NULL) {
276 goto err;
277 }
278
279 ssl_create_cipher_list(ret->method, &ret->cipher_list,
Matthew Braithwaitea57dcfb2017-02-17 22:08:23 -0800280 SSL_DEFAULT_CIPHER_LIST, 1 /* strict */);
David Benjamin27bbae42015-09-13 00:54:37 -0400281 if (ret->cipher_list == NULL ||
282 sk_SSL_CIPHER_num(ret->cipher_list->ciphers) <= 0) {
283 OPENSSL_PUT_ERROR(SSL, SSL_R_LIBRARY_HAS_NO_CIPHERS);
284 goto err2;
285 }
286
287 ret->param = X509_VERIFY_PARAM_new();
288 if (!ret->param) {
289 goto err;
290 }
291
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 Benjaminfc02b592017-02-17 16:26:01 -05001227 /* TLS 1.3 does not require extended master secret and always reports as
1228 * supporting it. */
David Benjamina68c1182016-07-24 00:14:33 -04001229 if (!ssl->s3->have_version) {
1230 return 0;
1231 }
David Benjaminfc02b592017-02-17 16:26:01 -05001232 if (ssl3_protocol_version(ssl) >= TLS1_3_VERSION) {
1233 return 1;
1234 }
1235
1236 /* If the initial handshake completed, query the established session. */
1237 if (ssl->s3->established_session != NULL) {
1238 return ssl->s3->established_session->extended_master_secret;
1239 }
1240
1241 /* Otherwise, query the in-progress handshake. */
1242 if (ssl->s3->hs != NULL) {
1243 return ssl->s3->hs->extended_master_secret;
1244 }
1245 assert(0);
1246 return 0;
Matt Braithwaitecd6f54b2015-09-17 12:54:42 -07001247}
1248
David Benjamin9a41d1b2015-05-16 01:30:09 -04001249int SSL_CTX_get_read_ahead(const SSL_CTX *ctx) { return 0; }
Adam Langley95c29f32014-06-20 12:00:00 -07001250
David Benjamin0d56f882015-12-19 17:05:56 -05001251int SSL_get_read_ahead(const SSL *ssl) { return 0; }
Adam Langley95c29f32014-06-20 12:00:00 -07001252
David Benjamin9a41d1b2015-05-16 01:30:09 -04001253void SSL_CTX_set_read_ahead(SSL_CTX *ctx, int yes) { }
David Benjamin61ecccf2015-05-05 09:44:51 -04001254
David Benjamin0d56f882015-12-19 17:05:56 -05001255void SSL_set_read_ahead(SSL *ssl, int yes) { }
David Benjamin61ecccf2015-05-05 09:44:51 -04001256
David Benjamin9f859492015-10-03 10:44:30 -04001257int SSL_pending(const SSL *ssl) {
1258 if (ssl->s3->rrec.type != SSL3_RT_APPLICATION_DATA) {
1259 return 0;
1260 }
1261 return ssl->s3->rrec.length;
Adam Langleyfcf25832014-12-18 17:42:32 -08001262}
Adam Langley95c29f32014-06-20 12:00:00 -07001263
Adam Langley95c29f32014-06-20 12:00:00 -07001264/* Fix this so it checks all the valid key/cert options */
Adam Langleyfcf25832014-12-18 17:42:32 -08001265int SSL_CTX_check_private_key(const SSL_CTX *ctx) {
Adam Langley3a2b47a2017-01-24 13:59:42 -08001266 return ssl_cert_check_private_key(ctx->cert, ctx->cert->privatekey);
Adam Langleyc5ac2b62016-11-07 12:02:35 -08001267}
1268
1269/* Fix this function so that it takes an optional type parameter */
1270int SSL_check_private_key(const SSL *ssl) {
Adam Langley3a2b47a2017-01-24 13:59:42 -08001271 return ssl_cert_check_private_key(ssl->cert, ssl->cert->privatekey);
Adam Langleyfcf25832014-12-18 17:42:32 -08001272}
Adam Langley95c29f32014-06-20 12:00:00 -07001273
David Benjamin42fea372015-09-19 01:22:44 -04001274long SSL_get_default_timeout(const SSL *ssl) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001275 return SSL_DEFAULT_SESSION_TIMEOUT;
1276}
Adam Langley95c29f32014-06-20 12:00:00 -07001277
David Benjamin44d3eed2015-05-21 01:29:55 -04001278int SSL_renegotiate(SSL *ssl) {
1279 /* Caller-initiated renegotiation is not supported. */
David Benjamin3570d732015-06-29 00:28:17 -04001280 OPENSSL_PUT_ERROR(SSL, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
David Benjamin44d3eed2015-05-21 01:29:55 -04001281 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001282}
Adam Langley95c29f32014-06-20 12:00:00 -07001283
David Benjamin44d3eed2015-05-21 01:29:55 -04001284int SSL_renegotiate_pending(SSL *ssl) {
1285 return SSL_in_init(ssl) && ssl->s3->initial_handshake_complete;
Adam Langleyfcf25832014-12-18 17:42:32 -08001286}
Adam Langley95c29f32014-06-20 12:00:00 -07001287
David Benjamin936aada2016-06-07 19:09:22 -04001288int SSL_total_renegotiations(const SSL *ssl) {
1289 return ssl->s3->total_renegotiations;
1290}
1291
David Benjamin1d0a1942015-04-26 15:35:35 -04001292size_t SSL_CTX_get_max_cert_list(const SSL_CTX *ctx) {
1293 return ctx->max_cert_list;
1294}
1295
1296void SSL_CTX_set_max_cert_list(SSL_CTX *ctx, size_t max_cert_list) {
1297 if (max_cert_list > kMaxHandshakeSize) {
1298 max_cert_list = kMaxHandshakeSize;
1299 }
1300 ctx->max_cert_list = (uint32_t)max_cert_list;
1301}
1302
1303size_t SSL_get_max_cert_list(const SSL *ssl) {
1304 return ssl->max_cert_list;
1305}
1306
1307void SSL_set_max_cert_list(SSL *ssl, size_t max_cert_list) {
1308 if (max_cert_list > kMaxHandshakeSize) {
1309 max_cert_list = kMaxHandshakeSize;
1310 }
1311 ssl->max_cert_list = (uint32_t)max_cert_list;
1312}
1313
Adam Langleyce9d85e2016-01-24 15:58:39 -08001314int SSL_CTX_set_max_send_fragment(SSL_CTX *ctx, size_t max_send_fragment) {
David Benjamin1d0a1942015-04-26 15:35:35 -04001315 if (max_send_fragment < 512) {
1316 max_send_fragment = 512;
1317 }
1318 if (max_send_fragment > SSL3_RT_MAX_PLAIN_LENGTH) {
1319 max_send_fragment = SSL3_RT_MAX_PLAIN_LENGTH;
1320 }
1321 ctx->max_send_fragment = (uint16_t)max_send_fragment;
Adam Langleyce9d85e2016-01-24 15:58:39 -08001322
1323 return 1;
David Benjamin1d0a1942015-04-26 15:35:35 -04001324}
1325
Adam Langleyce9d85e2016-01-24 15:58:39 -08001326int SSL_set_max_send_fragment(SSL *ssl, size_t max_send_fragment) {
David Benjamin1d0a1942015-04-26 15:35:35 -04001327 if (max_send_fragment < 512) {
1328 max_send_fragment = 512;
1329 }
1330 if (max_send_fragment > SSL3_RT_MAX_PLAIN_LENGTH) {
1331 max_send_fragment = SSL3_RT_MAX_PLAIN_LENGTH;
1332 }
1333 ssl->max_send_fragment = (uint16_t)max_send_fragment;
Adam Langleyce9d85e2016-01-24 15:58:39 -08001334
1335 return 1;
David Benjamin1d0a1942015-04-26 15:35:35 -04001336}
1337
David Benjamincb9cf792015-05-05 09:46:14 -04001338int SSL_set_mtu(SSL *ssl, unsigned mtu) {
David Benjamince079fd2016-08-02 16:22:34 -04001339 if (!SSL_is_dtls(ssl) || mtu < dtls1_min_mtu()) {
David Benjamincb9cf792015-05-05 09:46:14 -04001340 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001341 }
David Benjamincb9cf792015-05-05 09:46:14 -04001342 ssl->d1->mtu = mtu;
1343 return 1;
1344}
1345
1346int SSL_get_secure_renegotiation_support(const SSL *ssl) {
David Benjamind2610042017-01-03 10:49:28 -05001347 if (!ssl->s3->have_version) {
1348 return 0;
1349 }
1350 return ssl3_protocol_version(ssl) >= TLS1_3_VERSION ||
1351 ssl->s3->send_connection_binding;
David Benjamincb9cf792015-05-05 09:46:14 -04001352}
1353
Adam Langleyfcf25832014-12-18 17:42:32 -08001354LHASH_OF(SSL_SESSION) *SSL_CTX_sessions(SSL_CTX *ctx) { return ctx->sessions; }
1355
David Benjamin71f7d3d2015-05-05 09:46:38 -04001356size_t SSL_CTX_sess_number(const SSL_CTX *ctx) {
1357 return lh_SSL_SESSION_num_items(ctx->sessions);
1358}
1359
1360unsigned long SSL_CTX_sess_set_cache_size(SSL_CTX *ctx, unsigned long size) {
1361 unsigned long ret = ctx->session_cache_size;
1362 ctx->session_cache_size = size;
1363 return ret;
1364}
1365
1366unsigned long SSL_CTX_sess_get_cache_size(const SSL_CTX *ctx) {
1367 return ctx->session_cache_size;
1368}
1369
1370int SSL_CTX_set_session_cache_mode(SSL_CTX *ctx, int mode) {
1371 int ret = ctx->session_cache_mode;
1372 ctx->session_cache_mode = mode;
1373 return ret;
1374}
1375
1376int SSL_CTX_get_session_cache_mode(const SSL_CTX *ctx) {
1377 return ctx->session_cache_mode;
1378}
1379
David Benjamin936aada2016-06-07 19:09:22 -04001380
1381int SSL_CTX_get_tlsext_ticket_keys(SSL_CTX *ctx, void *out, size_t len) {
1382 if (out == 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 uint8_t *out_bytes = out;
David Benjamin17cf2cb2016-12-13 01:07:13 -05001390 OPENSSL_memcpy(out_bytes, ctx->tlsext_tick_key_name, 16);
1391 OPENSSL_memcpy(out_bytes + 16, ctx->tlsext_tick_hmac_key, 16);
1392 OPENSSL_memcpy(out_bytes + 32, ctx->tlsext_tick_aes_key, 16);
David Benjamin936aada2016-06-07 19:09:22 -04001393 return 1;
1394}
1395
1396int SSL_CTX_set_tlsext_ticket_keys(SSL_CTX *ctx, const void *in, size_t len) {
1397 if (in == NULL) {
1398 return 48;
1399 }
1400 if (len != 48) {
1401 OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_TICKET_KEYS_LENGTH);
1402 return 0;
1403 }
1404 const uint8_t *in_bytes = in;
David Benjamin17cf2cb2016-12-13 01:07:13 -05001405 OPENSSL_memcpy(ctx->tlsext_tick_key_name, in_bytes, 16);
1406 OPENSSL_memcpy(ctx->tlsext_tick_hmac_key, in_bytes + 16, 16);
1407 OPENSSL_memcpy(ctx->tlsext_tick_aes_key, in_bytes + 32, 16);
David Benjamin936aada2016-06-07 19:09:22 -04001408 return 1;
1409}
1410
1411int SSL_CTX_set_tlsext_ticket_key_cb(
1412 SSL_CTX *ctx, int (*callback)(SSL *ssl, uint8_t *key_name, uint8_t *iv,
1413 EVP_CIPHER_CTX *ctx, HMAC_CTX *hmac_ctx,
1414 int encrypt)) {
1415 ctx->tlsext_ticket_key_cb = callback;
1416 return 1;
1417}
1418
1419int SSL_CTX_set1_curves(SSL_CTX *ctx, const int *curves, size_t curves_len) {
1420 return tls1_set_curves(&ctx->supported_group_list,
1421 &ctx->supported_group_list_len, curves,
1422 curves_len);
1423}
1424
1425int SSL_set1_curves(SSL *ssl, const int *curves, size_t curves_len) {
1426 return tls1_set_curves(&ssl->supported_group_list,
1427 &ssl->supported_group_list_len, curves,
1428 curves_len);
1429}
1430
Alessandro Ghedini5fd18072016-09-28 21:04:25 +01001431int SSL_CTX_set1_curves_list(SSL_CTX *ctx, const char *curves) {
1432 return tls1_set_curves_list(&ctx->supported_group_list,
1433 &ctx->supported_group_list_len, curves);
1434}
1435
1436int SSL_set1_curves_list(SSL *ssl, const char *curves) {
1437 return tls1_set_curves_list(&ssl->supported_group_list,
1438 &ssl->supported_group_list_len, curves);
1439}
1440
David Benjamin9e68f192016-06-30 14:55:33 -04001441uint16_t SSL_get_curve_id(const SSL *ssl) {
1442 /* TODO(davidben): This checks the wrong session if there is a renegotiation in
1443 * progress. */
Steven Valdez87eab492016-06-27 16:34:59 -04001444 SSL_SESSION *session = SSL_get_session(ssl);
David Benjamin4882a6c2016-12-11 02:48:12 -05001445 if (session == NULL) {
David Benjamin9e68f192016-06-30 14:55:33 -04001446 return 0;
1447 }
1448
David Benjamin4882a6c2016-12-11 02:48:12 -05001449 return session->group_id;
David Benjamin9e68f192016-06-30 14:55:33 -04001450}
1451
David Benjamin936aada2016-06-07 19:09:22 -04001452int SSL_CTX_set_tmp_dh(SSL_CTX *ctx, const DH *dh) {
1453 DH_free(ctx->cert->dh_tmp);
1454 ctx->cert->dh_tmp = DHparams_dup(dh);
1455 if (ctx->cert->dh_tmp == NULL) {
1456 OPENSSL_PUT_ERROR(SSL, ERR_R_DH_LIB);
1457 return 0;
1458 }
1459 return 1;
1460}
1461
1462int SSL_set_tmp_dh(SSL *ssl, const DH *dh) {
1463 DH_free(ssl->cert->dh_tmp);
1464 ssl->cert->dh_tmp = DHparams_dup(dh);
1465 if (ssl->cert->dh_tmp == NULL) {
1466 OPENSSL_PUT_ERROR(SSL, ERR_R_DH_LIB);
1467 return 0;
1468 }
1469 return 1;
1470}
1471
David Benjamin32876b32015-09-20 12:17:03 -04001472STACK_OF(SSL_CIPHER) *SSL_get_ciphers(const SSL *ssl) {
1473 if (ssl == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001474 return NULL;
1475 }
Adam Langley0b5c1ac2014-06-20 12:00:00 -07001476
David Benjaminaf3b3d32016-10-31 16:29:57 -04001477 const struct ssl_cipher_preference_list_st *prefs =
1478 ssl_get_cipher_preferences(ssl);
1479 if (prefs == NULL) {
1480 return NULL;
Adam Langleyfcf25832014-12-18 17:42:32 -08001481 }
Adam Langley0b5c1ac2014-06-20 12:00:00 -07001482
David Benjaminaf3b3d32016-10-31 16:29:57 -04001483 return prefs->ciphers;
Adam Langleyfcf25832014-12-18 17:42:32 -08001484}
Adam Langley95c29f32014-06-20 12:00:00 -07001485
David Benjamin32876b32015-09-20 12:17:03 -04001486const char *SSL_get_cipher_list(const SSL *ssl, int n) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001487 const SSL_CIPHER *c;
David Benjamin60da0cd2015-05-03 15:21:28 -04001488 STACK_OF(SSL_CIPHER) *sk;
Adam Langley0b5c1ac2014-06-20 12:00:00 -07001489
David Benjamin32876b32015-09-20 12:17:03 -04001490 if (ssl == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001491 return NULL;
1492 }
Adam Langley95c29f32014-06-20 12:00:00 -07001493
David Benjamin32876b32015-09-20 12:17:03 -04001494 sk = SSL_get_ciphers(ssl);
Adam Langleyfcf25832014-12-18 17:42:32 -08001495 if (sk == NULL || n < 0 || (size_t)n >= sk_SSL_CIPHER_num(sk)) {
1496 return NULL;
1497 }
Adam Langley95c29f32014-06-20 12:00:00 -07001498
Adam Langleyfcf25832014-12-18 17:42:32 -08001499 c = sk_SSL_CIPHER_value(sk, n);
1500 if (c == NULL) {
1501 return NULL;
1502 }
Adam Langley95c29f32014-06-20 12:00:00 -07001503
Adam Langleyfcf25832014-12-18 17:42:32 -08001504 return c->name;
1505}
David Benjamin5491e3f2014-09-29 19:33:09 -04001506
Adam Langleyfcf25832014-12-18 17:42:32 -08001507int SSL_CTX_set_cipher_list(SSL_CTX *ctx, const char *str) {
David Benjamind2cb1c12016-11-02 17:49:09 -04001508 STACK_OF(SSL_CIPHER) *cipher_list =
Matthew Braithwaitea57dcfb2017-02-17 22:08:23 -08001509 ssl_create_cipher_list(ctx->method, &ctx->cipher_list, str,
1510 0 /* not strict */);
1511 if (cipher_list == NULL) {
1512 return 0;
1513 }
1514
1515 /* |ssl_create_cipher_list| may succeed but return an empty cipher list. */
1516 if (sk_SSL_CIPHER_num(cipher_list) == 0) {
1517 OPENSSL_PUT_ERROR(SSL, SSL_R_NO_CIPHER_MATCH);
1518 return 0;
1519 }
1520
1521 return 1;
1522}
1523
1524int SSL_CTX_set_strict_cipher_list(SSL_CTX *ctx, const char *str) {
1525 STACK_OF(SSL_CIPHER) *cipher_list =
1526 ssl_create_cipher_list(ctx->method, &ctx->cipher_list, str,
1527 1 /* strict */);
David Benjamin32876b32015-09-20 12:17:03 -04001528 if (cipher_list == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001529 return 0;
David Benjamin32876b32015-09-20 12:17:03 -04001530 }
1531
1532 /* |ssl_create_cipher_list| may succeed but return an empty cipher list. */
1533 if (sk_SSL_CIPHER_num(cipher_list) == 0) {
David Benjamin3570d732015-06-29 00:28:17 -04001534 OPENSSL_PUT_ERROR(SSL, SSL_R_NO_CIPHER_MATCH);
Adam Langleyfcf25832014-12-18 17:42:32 -08001535 return 0;
1536 }
Adam Langley95c29f32014-06-20 12:00:00 -07001537
Adam Langleyfcf25832014-12-18 17:42:32 -08001538 return 1;
1539}
David Benjamin39482a12014-07-20 13:30:15 -04001540
David Benjamin32876b32015-09-20 12:17:03 -04001541int SSL_set_cipher_list(SSL *ssl, const char *str) {
David Benjamind2cb1c12016-11-02 17:49:09 -04001542 STACK_OF(SSL_CIPHER) *cipher_list =
Matthew Braithwaitea57dcfb2017-02-17 22:08:23 -08001543 ssl_create_cipher_list(ssl->ctx->method, &ssl->cipher_list, str,
1544 0 /* not strict */);
1545 if (cipher_list == NULL) {
1546 return 0;
1547 }
1548
1549 /* |ssl_create_cipher_list| may succeed but return an empty cipher list. */
1550 if (sk_SSL_CIPHER_num(cipher_list) == 0) {
1551 OPENSSL_PUT_ERROR(SSL, SSL_R_NO_CIPHER_MATCH);
1552 return 0;
1553 }
1554
1555 return 1;
1556}
1557
1558int SSL_set_strict_cipher_list(SSL *ssl, const char *str) {
1559 STACK_OF(SSL_CIPHER) *cipher_list =
1560 ssl_create_cipher_list(ssl->ctx->method, &ssl->cipher_list, str,
1561 1 /* strict */);
David Benjamin32876b32015-09-20 12:17:03 -04001562 if (cipher_list == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001563 return 0;
David Benjamin32876b32015-09-20 12:17:03 -04001564 }
1565
1566 /* |ssl_create_cipher_list| may succeed but return an empty cipher list. */
1567 if (sk_SSL_CIPHER_num(cipher_list) == 0) {
David Benjamin3570d732015-06-29 00:28:17 -04001568 OPENSSL_PUT_ERROR(SSL, SSL_R_NO_CIPHER_MATCH);
Adam Langleyfcf25832014-12-18 17:42:32 -08001569 return 0;
1570 }
David Benjamin39482a12014-07-20 13:30:15 -04001571
Adam Langleyfcf25832014-12-18 17:42:32 -08001572 return 1;
1573}
Adam Langley95c29f32014-06-20 12:00:00 -07001574
David Benjamin07e13842015-10-17 13:48:04 -04001575const char *SSL_get_servername(const SSL *ssl, const int type) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001576 if (type != TLSEXT_NAMETYPE_host_name) {
1577 return NULL;
1578 }
Adam Langley95c29f32014-06-20 12:00:00 -07001579
David Benjamin07e13842015-10-17 13:48:04 -04001580 /* Historically, |SSL_get_servername| was also the configuration getter
1581 * corresponding to |SSL_set_tlsext_host_name|. */
1582 if (ssl->tlsext_hostname != NULL) {
1583 return ssl->tlsext_hostname;
1584 }
1585
David Benjamin4eb95cc2016-11-16 17:08:23 +09001586 /* During the handshake, report the handshake value. */
1587 if (ssl->s3->hs != NULL) {
1588 return ssl->s3->hs->hostname;
1589 }
1590
1591 /* SSL_get_servername may also be called after the handshake to look up the
1592 * SNI value.
1593 *
1594 * TODO(davidben): This is almost unused. Can we remove it? */
Steven Valdez87eab492016-06-27 16:34:59 -04001595 SSL_SESSION *session = SSL_get_session(ssl);
1596 if (session == NULL) {
David Benjamin07e13842015-10-17 13:48:04 -04001597 return NULL;
1598 }
Steven Valdez87eab492016-06-27 16:34:59 -04001599 return session->tlsext_hostname;
Adam Langleyfcf25832014-12-18 17:42:32 -08001600}
Adam Langley95c29f32014-06-20 12:00:00 -07001601
David Benjamin07e13842015-10-17 13:48:04 -04001602int SSL_get_servername_type(const SSL *ssl) {
Steven Valdez87eab492016-06-27 16:34:59 -04001603 SSL_SESSION *session = SSL_get_session(ssl);
1604 if (session == NULL || session->tlsext_hostname == NULL) {
1605 return -1;
Adam Langleyfcf25832014-12-18 17:42:32 -08001606 }
Steven Valdez87eab492016-06-27 16:34:59 -04001607 return TLSEXT_NAMETYPE_host_name;
Adam Langleyfcf25832014-12-18 17:42:32 -08001608}
Adam Langley95c29f32014-06-20 12:00:00 -07001609
Adam Langleyfcf25832014-12-18 17:42:32 -08001610void SSL_CTX_enable_signed_cert_timestamps(SSL_CTX *ctx) {
1611 ctx->signed_cert_timestamps_enabled = 1;
1612}
HÃ¥vard Molland9169c962014-08-14 14:42:37 +02001613
David Benjamin26e1ff32017-02-14 20:13:00 -05001614void SSL_enable_signed_cert_timestamps(SSL *ssl) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001615 ssl->signed_cert_timestamps_enabled = 1;
Adam Langleyfcf25832014-12-18 17:42:32 -08001616}
HÃ¥vard Molland9169c962014-08-14 14:42:37 +02001617
Adam Langleyfcf25832014-12-18 17:42:32 -08001618void SSL_CTX_enable_ocsp_stapling(SSL_CTX *ctx) {
1619 ctx->ocsp_stapling_enabled = 1;
1620}
David Benjamin6c7aed02014-08-27 16:42:38 -04001621
David Benjamin26e1ff32017-02-14 20:13:00 -05001622void SSL_enable_ocsp_stapling(SSL *ssl) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001623 ssl->ocsp_stapling_enabled = 1;
Adam Langleyfcf25832014-12-18 17:42:32 -08001624}
David Benjamin6c7aed02014-08-27 16:42:38 -04001625
Adam Langleyfcf25832014-12-18 17:42:32 -08001626void SSL_get0_signed_cert_timestamp_list(const SSL *ssl, const uint8_t **out,
1627 size_t *out_len) {
Steven Valdez87eab492016-06-27 16:34:59 -04001628 SSL_SESSION *session = SSL_get_session(ssl);
Adam Langley3cb50e02014-08-26 14:00:31 -07001629
Adam Langleyfcf25832014-12-18 17:42:32 -08001630 *out_len = 0;
1631 *out = NULL;
1632 if (ssl->server || !session || !session->tlsext_signed_cert_timestamp_list) {
1633 return;
1634 }
HÃ¥vard Molland9169c962014-08-14 14:42:37 +02001635
Adam Langleyfcf25832014-12-18 17:42:32 -08001636 *out = session->tlsext_signed_cert_timestamp_list;
1637 *out_len = session->tlsext_signed_cert_timestamp_list_length;
1638}
David Benjamin6c7aed02014-08-27 16:42:38 -04001639
Adam Langleyfcf25832014-12-18 17:42:32 -08001640void SSL_get0_ocsp_response(const SSL *ssl, const uint8_t **out,
1641 size_t *out_len) {
Steven Valdez87eab492016-06-27 16:34:59 -04001642 SSL_SESSION *session = SSL_get_session(ssl);
Adam Langleyfcf25832014-12-18 17:42:32 -08001643
1644 *out_len = 0;
1645 *out = NULL;
1646 if (ssl->server || !session || !session->ocsp_response) {
1647 return;
1648 }
1649 *out = session->ocsp_response;
1650 *out_len = session->ocsp_response_length;
1651}
David Benjamin6c7aed02014-08-27 16:42:38 -04001652
David Benjamin936aada2016-06-07 19:09:22 -04001653int SSL_set_tlsext_host_name(SSL *ssl, const char *name) {
1654 OPENSSL_free(ssl->tlsext_hostname);
1655 ssl->tlsext_hostname = NULL;
1656
1657 if (name == NULL) {
1658 return 1;
1659 }
1660
1661 size_t len = strlen(name);
1662 if (len == 0 || len > TLSEXT_MAXLEN_host_name) {
1663 OPENSSL_PUT_ERROR(SSL, SSL_R_SSL3_EXT_INVALID_SERVERNAME);
1664 return 0;
1665 }
1666 ssl->tlsext_hostname = BUF_strdup(name);
1667 if (ssl->tlsext_hostname == NULL) {
1668 OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
1669 return 0;
1670 }
1671 return 1;
1672}
1673
1674int SSL_CTX_set_tlsext_servername_callback(
1675 SSL_CTX *ctx, int (*callback)(SSL *ssl, int *out_alert, void *arg)) {
1676 ctx->tlsext_servername_callback = callback;
1677 return 1;
1678}
1679
1680int SSL_CTX_set_tlsext_servername_arg(SSL_CTX *ctx, void *arg) {
1681 ctx->tlsext_servername_arg = arg;
1682 return 1;
1683}
1684
David Benjamin977547b2015-09-16 00:25:52 -04001685int SSL_select_next_proto(uint8_t **out, uint8_t *out_len,
1686 const uint8_t *server, unsigned server_len,
1687 const uint8_t *client, unsigned client_len) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001688 unsigned int i, j;
1689 const uint8_t *result;
1690 int status = OPENSSL_NPN_UNSUPPORTED;
Adam Langley95c29f32014-06-20 12:00:00 -07001691
Adam Langleyfcf25832014-12-18 17:42:32 -08001692 /* For each protocol in server preference order, see if we support it. */
1693 for (i = 0; i < server_len;) {
1694 for (j = 0; j < client_len;) {
1695 if (server[i] == client[j] &&
David Benjamin17cf2cb2016-12-13 01:07:13 -05001696 OPENSSL_memcmp(&server[i + 1], &client[j + 1], server[i]) == 0) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001697 /* We found a match */
1698 result = &server[i];
1699 status = OPENSSL_NPN_NEGOTIATED;
1700 goto found;
1701 }
1702 j += client[j];
1703 j++;
1704 }
1705 i += server[i];
1706 i++;
1707 }
Adam Langley95c29f32014-06-20 12:00:00 -07001708
Adam Langleyfcf25832014-12-18 17:42:32 -08001709 /* There's no overlap between our protocols and the server's list. */
1710 result = client;
1711 status = OPENSSL_NPN_NO_OVERLAP;
Adam Langley95c29f32014-06-20 12:00:00 -07001712
Adam Langleyfcf25832014-12-18 17:42:32 -08001713found:
1714 *out = (uint8_t *)result + 1;
David Benjamin977547b2015-09-16 00:25:52 -04001715 *out_len = result[0];
Adam Langleyfcf25832014-12-18 17:42:32 -08001716 return status;
1717}
Adam Langley95c29f32014-06-20 12:00:00 -07001718
David Benjamin977547b2015-09-16 00:25:52 -04001719void SSL_get0_next_proto_negotiated(const SSL *ssl, const uint8_t **out_data,
1720 unsigned *out_len) {
David Benjamin79978df2015-12-25 15:56:49 -05001721 *out_data = ssl->s3->next_proto_negotiated;
David Benjamin977547b2015-09-16 00:25:52 -04001722 if (*out_data == NULL) {
1723 *out_len = 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001724 } else {
David Benjamin79978df2015-12-25 15:56:49 -05001725 *out_len = ssl->s3->next_proto_negotiated_len;
Adam Langleyfcf25832014-12-18 17:42:32 -08001726 }
Adam Langley95c29f32014-06-20 12:00:00 -07001727}
1728
Adam Langleyfcf25832014-12-18 17:42:32 -08001729void SSL_CTX_set_next_protos_advertised_cb(
1730 SSL_CTX *ctx,
David Benjamin977547b2015-09-16 00:25:52 -04001731 int (*cb)(SSL *ssl, const uint8_t **out, unsigned *out_len, void *arg),
Adam Langleyfcf25832014-12-18 17:42:32 -08001732 void *arg) {
1733 ctx->next_protos_advertised_cb = cb;
1734 ctx->next_protos_advertised_cb_arg = arg;
1735}
Adam Langley95c29f32014-06-20 12:00:00 -07001736
Adam Langleyfcf25832014-12-18 17:42:32 -08001737void SSL_CTX_set_next_proto_select_cb(
David Benjamin977547b2015-09-16 00:25:52 -04001738 SSL_CTX *ctx, int (*cb)(SSL *ssl, uint8_t **out, uint8_t *out_len,
1739 const uint8_t *in, unsigned in_len, void *arg),
Adam Langleyfcf25832014-12-18 17:42:32 -08001740 void *arg) {
1741 ctx->next_proto_select_cb = cb;
1742 ctx->next_proto_select_cb_arg = arg;
1743}
Adam Langley95c29f32014-06-20 12:00:00 -07001744
Adam Langleyfcf25832014-12-18 17:42:32 -08001745int SSL_CTX_set_alpn_protos(SSL_CTX *ctx, const uint8_t *protos,
1746 unsigned protos_len) {
David Benjamin2755a3e2015-04-22 16:17:58 -04001747 OPENSSL_free(ctx->alpn_client_proto_list);
Adam Langleyfcf25832014-12-18 17:42:32 -08001748 ctx->alpn_client_proto_list = BUF_memdup(protos, protos_len);
1749 if (!ctx->alpn_client_proto_list) {
1750 return 1;
1751 }
1752 ctx->alpn_client_proto_list_len = protos_len;
Adam Langley95c29f32014-06-20 12:00:00 -07001753
Adam Langleyfcf25832014-12-18 17:42:32 -08001754 return 0;
1755}
Adam Langley95c29f32014-06-20 12:00:00 -07001756
Adam Langleyfcf25832014-12-18 17:42:32 -08001757int SSL_set_alpn_protos(SSL *ssl, const uint8_t *protos, unsigned protos_len) {
David Benjamin2755a3e2015-04-22 16:17:58 -04001758 OPENSSL_free(ssl->alpn_client_proto_list);
Adam Langleyfcf25832014-12-18 17:42:32 -08001759 ssl->alpn_client_proto_list = BUF_memdup(protos, protos_len);
1760 if (!ssl->alpn_client_proto_list) {
1761 return 1;
1762 }
1763 ssl->alpn_client_proto_list_len = protos_len;
Adam Langley95c29f32014-06-20 12:00:00 -07001764
Adam Langleyfcf25832014-12-18 17:42:32 -08001765 return 0;
1766}
Adam Langley95c29f32014-06-20 12:00:00 -07001767
Adam Langleyfcf25832014-12-18 17:42:32 -08001768void SSL_CTX_set_alpn_select_cb(SSL_CTX *ctx,
1769 int (*cb)(SSL *ssl, const uint8_t **out,
David Benjamin8984f1f2015-09-16 00:10:19 -04001770 uint8_t *out_len, const uint8_t *in,
1771 unsigned in_len, void *arg),
Adam Langleyfcf25832014-12-18 17:42:32 -08001772 void *arg) {
1773 ctx->alpn_select_cb = cb;
1774 ctx->alpn_select_cb_arg = arg;
1775}
Adam Langley95c29f32014-06-20 12:00:00 -07001776
David Benjamin8984f1f2015-09-16 00:10:19 -04001777void SSL_get0_alpn_selected(const SSL *ssl, const uint8_t **out_data,
1778 unsigned *out_len) {
1779 *out_data = NULL;
Adam Langleyfcf25832014-12-18 17:42:32 -08001780 if (ssl->s3) {
David Benjamin8984f1f2015-09-16 00:10:19 -04001781 *out_data = ssl->s3->alpn_selected;
Adam Langleyfcf25832014-12-18 17:42:32 -08001782 }
David Benjamin8984f1f2015-09-16 00:10:19 -04001783 if (*out_data == NULL) {
1784 *out_len = 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001785 } else {
David Benjamin8984f1f2015-09-16 00:10:19 -04001786 *out_len = ssl->s3->alpn_selected_len;
Adam Langleyfcf25832014-12-18 17:42:32 -08001787 }
1788}
Adam Langley95c29f32014-06-20 12:00:00 -07001789
David Benjamin936aada2016-06-07 19:09:22 -04001790
David Benjamineebd3c82016-12-06 17:43:58 -05001791void SSL_CTX_set_tls_channel_id_enabled(SSL_CTX *ctx, int enabled) {
1792 ctx->tlsext_channel_id_enabled = !!enabled;
1793}
1794
David Benjamin936aada2016-06-07 19:09:22 -04001795int SSL_CTX_enable_tls_channel_id(SSL_CTX *ctx) {
David Benjamineebd3c82016-12-06 17:43:58 -05001796 SSL_CTX_set_tls_channel_id_enabled(ctx, 1);
David Benjamin936aada2016-06-07 19:09:22 -04001797 return 1;
1798}
1799
David Benjamineebd3c82016-12-06 17:43:58 -05001800void SSL_set_tls_channel_id_enabled(SSL *ssl, int enabled) {
1801 ssl->tlsext_channel_id_enabled = !!enabled;
1802}
1803
David Benjamin936aada2016-06-07 19:09:22 -04001804int SSL_enable_tls_channel_id(SSL *ssl) {
David Benjamineebd3c82016-12-06 17:43:58 -05001805 SSL_set_tls_channel_id_enabled(ssl, 1);
David Benjamin936aada2016-06-07 19:09:22 -04001806 return 1;
1807}
1808
1809static int is_p256_key(EVP_PKEY *private_key) {
1810 const EC_KEY *ec_key = EVP_PKEY_get0_EC_KEY(private_key);
1811 return ec_key != NULL &&
1812 EC_GROUP_get_curve_name(EC_KEY_get0_group(ec_key)) ==
1813 NID_X9_62_prime256v1;
1814}
1815
1816int SSL_CTX_set1_tls_channel_id(SSL_CTX *ctx, EVP_PKEY *private_key) {
1817 if (!is_p256_key(private_key)) {
1818 OPENSSL_PUT_ERROR(SSL, SSL_R_CHANNEL_ID_NOT_P256);
1819 return 0;
1820 }
1821
1822 EVP_PKEY_free(ctx->tlsext_channel_id_private);
Adam Langley310d3f62016-07-12 10:39:20 -07001823 EVP_PKEY_up_ref(private_key);
1824 ctx->tlsext_channel_id_private = private_key;
David Benjamin936aada2016-06-07 19:09:22 -04001825 ctx->tlsext_channel_id_enabled = 1;
1826
1827 return 1;
1828}
1829
1830int SSL_set1_tls_channel_id(SSL *ssl, EVP_PKEY *private_key) {
1831 if (!is_p256_key(private_key)) {
1832 OPENSSL_PUT_ERROR(SSL, SSL_R_CHANNEL_ID_NOT_P256);
1833 return 0;
1834 }
1835
1836 EVP_PKEY_free(ssl->tlsext_channel_id_private);
Adam Langley310d3f62016-07-12 10:39:20 -07001837 EVP_PKEY_up_ref(private_key);
1838 ssl->tlsext_channel_id_private = private_key;
David Benjamin936aada2016-06-07 19:09:22 -04001839 ssl->tlsext_channel_id_enabled = 1;
1840
1841 return 1;
1842}
1843
1844size_t SSL_get_tls_channel_id(SSL *ssl, uint8_t *out, size_t max_out) {
1845 if (!ssl->s3->tlsext_channel_id_valid) {
1846 return 0;
1847 }
David Benjamin17cf2cb2016-12-13 01:07:13 -05001848 OPENSSL_memcpy(out, ssl->s3->tlsext_channel_id,
1849 (max_out < 64) ? max_out : 64);
David Benjamin936aada2016-06-07 19:09:22 -04001850 return 64;
1851}
1852
David Benjamin936aada2016-06-07 19:09:22 -04001853size_t SSL_get0_certificate_types(SSL *ssl, const uint8_t **out_types) {
David Benjamina0486782016-10-06 19:11:32 -04001854 if (ssl->server || ssl->s3->hs == NULL) {
David Benjamin936aada2016-06-07 19:09:22 -04001855 *out_types = NULL;
1856 return 0;
1857 }
David Benjamina0486782016-10-06 19:11:32 -04001858 *out_types = ssl->s3->hs->certificate_types;
1859 return ssl->s3->hs->num_certificate_types;
David Benjamin936aada2016-06-07 19:09:22 -04001860}
1861
David Benjaminf3c8f8d2016-11-17 17:20:47 +09001862void ssl_update_cache(SSL_HANDSHAKE *hs, int mode) {
1863 SSL *const ssl = hs->ssl;
David Benjamin1269ddd2015-10-18 15:18:55 -04001864 SSL_CTX *ctx = ssl->initial_ctx;
David Benjaminb6d0c6d2015-03-19 19:07:26 -04001865 /* Never cache sessions with empty session IDs. */
Steven Valdez87eab492016-06-27 16:34:59 -04001866 if (ssl->s3->established_session->session_id_length == 0 ||
David Benjamin1269ddd2015-10-18 15:18:55 -04001867 (ctx->session_cache_mode & mode) != mode) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001868 return;
1869 }
Adam Langley95c29f32014-06-20 12:00:00 -07001870
David Benjamin1269ddd2015-10-18 15:18:55 -04001871 /* Clients never use the internal session cache. */
1872 int use_internal_cache = ssl->server && !(ctx->session_cache_mode &
1873 SSL_SESS_CACHE_NO_INTERNAL_STORE);
David Benjamin95d31822015-06-15 19:53:32 -04001874
David Benjamin1269ddd2015-10-18 15:18:55 -04001875 /* A client may see new sessions on abbreviated handshakes if the server
1876 * decides to renew the ticket. Once the handshake is completed, it should be
1877 * inserted into the cache. */
Steven Valdez87eab492016-06-27 16:34:59 -04001878 if (ssl->s3->established_session != ssl->session ||
David Benjaminf3c8f8d2016-11-17 17:20:47 +09001879 (!ssl->server && hs->ticket_expected)) {
David Benjamin1269ddd2015-10-18 15:18:55 -04001880 if (use_internal_cache) {
Steven Valdez87eab492016-06-27 16:34:59 -04001881 SSL_CTX_add_session(ctx, ssl->s3->established_session);
David Benjamin1269ddd2015-10-18 15:18:55 -04001882 }
David Benjaminb9195402016-08-05 10:51:43 -04001883 if (ctx->new_session_cb != NULL) {
1884 SSL_SESSION_up_ref(ssl->s3->established_session);
1885 if (!ctx->new_session_cb(ssl, ssl->s3->established_session)) {
1886 /* |new_session_cb|'s return value signals whether it took ownership. */
1887 SSL_SESSION_free(ssl->s3->established_session);
1888 }
Adam Langleyfcf25832014-12-18 17:42:32 -08001889 }
1890 }
Adam Langley95c29f32014-06-20 12:00:00 -07001891
David Benjamin1269ddd2015-10-18 15:18:55 -04001892 if (use_internal_cache &&
1893 !(ctx->session_cache_mode & SSL_SESS_CACHE_NO_AUTO_CLEAR)) {
David Benjaminb6d0c6d2015-03-19 19:07:26 -04001894 /* Automatically flush the internal session cache every 255 connections. */
1895 int flush_cache = 0;
Adam Langley4bdb6e42015-05-15 15:29:21 -07001896 CRYPTO_MUTEX_lock_write(&ctx->lock);
David Benjaminb6d0c6d2015-03-19 19:07:26 -04001897 ctx->handshakes_since_cache_flush++;
1898 if (ctx->handshakes_since_cache_flush >= 255) {
1899 flush_cache = 1;
1900 ctx->handshakes_since_cache_flush = 0;
1901 }
David Benjamin29270de2016-05-24 15:28:36 +00001902 CRYPTO_MUTEX_unlock_write(&ctx->lock);
David Benjaminb6d0c6d2015-03-19 19:07:26 -04001903
1904 if (flush_cache) {
David Benjamin721e8b72016-08-03 13:13:17 -04001905 struct timeval now;
1906 ssl_get_current_time(ssl, &now);
1907 SSL_CTX_flush_sessions(ctx, (long)now.tv_sec);
Adam Langleyfcf25832014-12-18 17:42:32 -08001908 }
1909 }
1910}
Adam Langley95c29f32014-06-20 12:00:00 -07001911
Adam Langleyfcf25832014-12-18 17:42:32 -08001912static const char *ssl_get_version(int version) {
1913 switch (version) {
Steven Valdezfdd10992016-09-15 16:27:05 -04001914 /* Report TLS 1.3 draft version as TLS 1.3 in the public API. */
1915 case TLS1_3_DRAFT_VERSION:
Steven Valdez4f94b1c2016-05-24 12:31:07 -04001916 return "TLSv1.3";
1917
Adam Langleyfcf25832014-12-18 17:42:32 -08001918 case TLS1_2_VERSION:
1919 return "TLSv1.2";
Adam Langley95c29f32014-06-20 12:00:00 -07001920
Adam Langleyfcf25832014-12-18 17:42:32 -08001921 case TLS1_1_VERSION:
1922 return "TLSv1.1";
Adam Langley95c29f32014-06-20 12:00:00 -07001923
Adam Langleyfcf25832014-12-18 17:42:32 -08001924 case TLS1_VERSION:
1925 return "TLSv1";
Adam Langley95c29f32014-06-20 12:00:00 -07001926
Adam Langleyfcf25832014-12-18 17:42:32 -08001927 case SSL3_VERSION:
1928 return "SSLv3";
Adam Langley95c29f32014-06-20 12:00:00 -07001929
David Benjamin1c722b72015-04-20 13:53:10 -04001930 case DTLS1_VERSION:
1931 return "DTLSv1";
1932
1933 case DTLS1_2_VERSION:
1934 return "DTLSv1.2";
1935
Adam Langleyfcf25832014-12-18 17:42:32 -08001936 default:
1937 return "unknown";
1938 }
1939}
Adam Langley95c29f32014-06-20 12:00:00 -07001940
David Benjamin42fea372015-09-19 01:22:44 -04001941const char *SSL_get_version(const SSL *ssl) {
1942 return ssl_get_version(ssl->version);
Adam Langleyfcf25832014-12-18 17:42:32 -08001943}
Adam Langley95c29f32014-06-20 12:00:00 -07001944
David Benjamina6b8cdf2015-09-13 14:07:33 -04001945const char *SSL_SESSION_get_version(const SSL_SESSION *session) {
1946 return ssl_get_version(session->ssl_version);
Adam Langleyfcf25832014-12-18 17:42:32 -08001947}
Adam Langley95c29f32014-06-20 12:00:00 -07001948
David Benjamin0d56f882015-12-19 17:05:56 -05001949EVP_PKEY *SSL_get_privatekey(const SSL *ssl) {
1950 if (ssl->cert != NULL) {
1951 return ssl->cert->privatekey;
Adam Langleyfcf25832014-12-18 17:42:32 -08001952 }
1953
1954 return NULL;
1955}
1956
Adam Langleyfcf25832014-12-18 17:42:32 -08001957EVP_PKEY *SSL_CTX_get0_privatekey(const SSL_CTX *ctx) {
1958 if (ctx->cert != NULL) {
David Benjamind1d80782015-07-05 11:54:09 -04001959 return ctx->cert->privatekey;
Adam Langleyfcf25832014-12-18 17:42:32 -08001960 }
1961
1962 return NULL;
1963}
1964
David Benjamin42fea372015-09-19 01:22:44 -04001965const SSL_CIPHER *SSL_get_current_cipher(const SSL *ssl) {
David Benjamin79978df2015-12-25 15:56:49 -05001966 if (ssl->s3->aead_write_ctx == NULL) {
David Benjamina07c0fc2015-05-13 13:19:42 -04001967 return NULL;
Adam Langleyfcf25832014-12-18 17:42:32 -08001968 }
David Benjamin79978df2015-12-25 15:56:49 -05001969 return ssl->s3->aead_write_ctx->cipher;
Adam Langleyfcf25832014-12-18 17:42:32 -08001970}
1971
David Benjamin936aada2016-06-07 19:09:22 -04001972int SSL_session_reused(const SSL *ssl) {
Steven Valdez4aa154e2016-07-29 14:32:55 -04001973 return ssl->s3->session_reused;
David Benjamin936aada2016-06-07 19:09:22 -04001974}
1975
David Benjamin0d56f882015-12-19 17:05:56 -05001976const COMP_METHOD *SSL_get_current_compression(SSL *ssl) { return NULL; }
Adam Langleyfcf25832014-12-18 17:42:32 -08001977
David Benjamin0d56f882015-12-19 17:05:56 -05001978const COMP_METHOD *SSL_get_current_expansion(SSL *ssl) { return NULL; }
Adam Langleyfcf25832014-12-18 17:42:32 -08001979
Adam Langley29ec5d12016-03-01 16:12:28 -08001980int *SSL_get_server_tmp_key(SSL *ssl, EVP_PKEY **out_key) { return 0; }
1981
Adam Langleyfcf25832014-12-18 17:42:32 -08001982void SSL_CTX_set_quiet_shutdown(SSL_CTX *ctx, int mode) {
Adam Langleybb85f3d2015-10-28 18:44:11 -07001983 ctx->quiet_shutdown = (mode != 0);
Adam Langleyfcf25832014-12-18 17:42:32 -08001984}
1985
1986int SSL_CTX_get_quiet_shutdown(const SSL_CTX *ctx) {
1987 return ctx->quiet_shutdown;
1988}
1989
Adam Langleybb85f3d2015-10-28 18:44:11 -07001990void SSL_set_quiet_shutdown(SSL *ssl, int mode) {
1991 ssl->quiet_shutdown = (mode != 0);
1992}
Adam Langleyfcf25832014-12-18 17:42:32 -08001993
David Benjamin9f859492015-10-03 10:44:30 -04001994int SSL_get_quiet_shutdown(const SSL *ssl) { return ssl->quiet_shutdown; }
Adam Langleyfcf25832014-12-18 17:42:32 -08001995
David Benjamin63006a92015-10-18 00:00:06 -04001996void SSL_set_shutdown(SSL *ssl, int mode) {
1997 /* It is an error to clear any bits that have already been set. (We can't try
1998 * to get a second close_notify or send two.) */
David Benjaminfa214e42016-05-10 17:03:10 -04001999 assert((SSL_get_shutdown(ssl) & mode) == SSL_get_shutdown(ssl));
David Benjamin63006a92015-10-18 00:00:06 -04002000
David Benjaminfa214e42016-05-10 17:03:10 -04002001 if (mode & SSL_RECEIVED_SHUTDOWN &&
2002 ssl->s3->recv_shutdown == ssl_shutdown_none) {
2003 ssl->s3->recv_shutdown = ssl_shutdown_close_notify;
2004 }
2005
2006 if (mode & SSL_SENT_SHUTDOWN &&
2007 ssl->s3->send_shutdown == ssl_shutdown_none) {
2008 ssl->s3->send_shutdown = ssl_shutdown_close_notify;
2009 }
David Benjamin63006a92015-10-18 00:00:06 -04002010}
Adam Langleyfcf25832014-12-18 17:42:32 -08002011
David Benjaminfa214e42016-05-10 17:03:10 -04002012int SSL_get_shutdown(const SSL *ssl) {
2013 int ret = 0;
2014 if (ssl->s3->recv_shutdown != ssl_shutdown_none) {
2015 /* Historically, OpenSSL set |SSL_RECEIVED_SHUTDOWN| on both close_notify
2016 * and fatal alert. */
2017 ret |= SSL_RECEIVED_SHUTDOWN;
2018 }
2019 if (ssl->s3->send_shutdown == ssl_shutdown_close_notify) {
2020 /* Historically, OpenSSL set |SSL_SENT_SHUTDOWN| on only close_notify. */
2021 ret |= SSL_SENT_SHUTDOWN;
2022 }
2023 return ret;
2024}
Adam Langleyfcf25832014-12-18 17:42:32 -08002025
Steven Valdezfdd10992016-09-15 16:27:05 -04002026int SSL_version(const SSL *ssl) {
2027 /* Report TLS 1.3 draft version as TLS 1.3 in the public API. */
2028 if (ssl->version == TLS1_3_DRAFT_VERSION) {
2029 return TLS1_3_VERSION;
2030 }
2031
2032 return ssl->version;
2033}
Adam Langleyfcf25832014-12-18 17:42:32 -08002034
2035SSL_CTX *SSL_get_SSL_CTX(const SSL *ssl) { return ssl->ctx; }
2036
2037SSL_CTX *SSL_set_SSL_CTX(SSL *ssl, SSL_CTX *ctx) {
2038 if (ssl->ctx == ctx) {
2039 return ssl->ctx;
2040 }
2041
Adam Langley3509dac2017-02-01 11:59:18 -08002042 /* One cannot change the X.509 callbacks during a connection. */
2043 if (ssl->ctx->x509_method != ctx->x509_method) {
2044 assert(0);
2045 return NULL;
2046 }
2047
Adam Langleyfcf25832014-12-18 17:42:32 -08002048 if (ctx == NULL) {
2049 ctx = ssl->initial_ctx;
2050 }
2051
David Benjamin2755a3e2015-04-22 16:17:58 -04002052 ssl_cert_free(ssl->cert);
Adam Langleyfcf25832014-12-18 17:42:32 -08002053 ssl->cert = ssl_cert_dup(ctx->cert);
David Benjamin2755a3e2015-04-22 16:17:58 -04002054
David Benjaminf650c712016-12-22 15:54:51 -05002055 SSL_CTX_up_ref(ctx);
2056 SSL_CTX_free(ssl->ctx);
Adam Langleyfcf25832014-12-18 17:42:32 -08002057 ssl->ctx = ctx;
2058
Adam Langleyfcf25832014-12-18 17:42:32 -08002059 return ssl->ctx;
2060}
2061
Adam Langley95c29f32014-06-20 12:00:00 -07002062void SSL_set_info_callback(SSL *ssl,
David Benjamin82170242015-10-17 22:51:17 -04002063 void (*cb)(const SSL *ssl, int type, int value)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002064 ssl->info_callback = cb;
2065}
Adam Langley95c29f32014-06-20 12:00:00 -07002066
David Benjamin82170242015-10-17 22:51:17 -04002067void (*SSL_get_info_callback(const SSL *ssl))(const SSL *ssl, int type,
2068 int value) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002069 return ssl->info_callback;
2070}
Adam Langley95c29f32014-06-20 12:00:00 -07002071
David Benjamincb0c29f2016-12-12 17:00:50 -05002072int SSL_state(const SSL *ssl) {
David Benjamin9e766d72017-02-10 23:14:17 -05002073 return SSL_in_init(ssl) ? SSL_ST_INIT : SSL_ST_OK;
David Benjamincb0c29f2016-12-12 17:00:50 -05002074}
Adam Langley95c29f32014-06-20 12:00:00 -07002075
David Benjaminece089c2015-05-15 23:52:42 -04002076void SSL_set_state(SSL *ssl, int state) { }
Adam Langley95c29f32014-06-20 12:00:00 -07002077
Emily Stark95a79ee2016-02-25 21:12:28 -08002078char *SSL_get_shared_ciphers(const SSL *ssl, char *buf, int len) {
2079 if (len <= 0) {
2080 return NULL;
2081 }
2082 buf[0] = '\0';
2083 return buf;
2084}
2085
David Benjamin8a589332015-12-04 23:14:35 -05002086int SSL_get_ex_new_index(long argl, void *argp, CRYPTO_EX_unused *unused,
Adam Langleyfcf25832014-12-18 17:42:32 -08002087 CRYPTO_EX_dup *dup_func, CRYPTO_EX_free *free_func) {
David Benjamin9f33fc62015-04-15 17:29:53 -04002088 int index;
2089 if (!CRYPTO_get_ex_new_index(&g_ex_data_class_ssl, &index, argl, argp,
David Benjamin8a589332015-12-04 23:14:35 -05002090 dup_func, free_func)) {
David Benjamin9f33fc62015-04-15 17:29:53 -04002091 return -1;
2092 }
2093 return index;
Adam Langleyfcf25832014-12-18 17:42:32 -08002094}
Adam Langley95c29f32014-06-20 12:00:00 -07002095
David Benjamin1ac08fe2015-09-15 01:36:22 -04002096int SSL_set_ex_data(SSL *ssl, int idx, void *arg) {
2097 return CRYPTO_set_ex_data(&ssl->ex_data, idx, arg);
Adam Langleyfcf25832014-12-18 17:42:32 -08002098}
Adam Langley95c29f32014-06-20 12:00:00 -07002099
David Benjamin1ac08fe2015-09-15 01:36:22 -04002100void *SSL_get_ex_data(const SSL *ssl, int idx) {
2101 return CRYPTO_get_ex_data(&ssl->ex_data, idx);
Adam Langleyfcf25832014-12-18 17:42:32 -08002102}
Adam Langley95c29f32014-06-20 12:00:00 -07002103
David Benjamin8a589332015-12-04 23:14:35 -05002104int SSL_CTX_get_ex_new_index(long argl, void *argp, CRYPTO_EX_unused *unused,
Adam Langleyfcf25832014-12-18 17:42:32 -08002105 CRYPTO_EX_dup *dup_func,
2106 CRYPTO_EX_free *free_func) {
David Benjamin9f33fc62015-04-15 17:29:53 -04002107 int index;
2108 if (!CRYPTO_get_ex_new_index(&g_ex_data_class_ssl_ctx, &index, argl, argp,
David Benjamin8a589332015-12-04 23:14:35 -05002109 dup_func, free_func)) {
David Benjamin9f33fc62015-04-15 17:29:53 -04002110 return -1;
2111 }
2112 return index;
Adam Langleyfcf25832014-12-18 17:42:32 -08002113}
Adam Langley95c29f32014-06-20 12:00:00 -07002114
David Benjamin1ac08fe2015-09-15 01:36:22 -04002115int SSL_CTX_set_ex_data(SSL_CTX *ctx, int idx, void *arg) {
2116 return CRYPTO_set_ex_data(&ctx->ex_data, idx, arg);
Adam Langleyfcf25832014-12-18 17:42:32 -08002117}
Adam Langley95c29f32014-06-20 12:00:00 -07002118
David Benjamin1ac08fe2015-09-15 01:36:22 -04002119void *SSL_CTX_get_ex_data(const SSL_CTX *ctx, int idx) {
2120 return CRYPTO_get_ex_data(&ctx->ex_data, idx);
Adam Langleyfcf25832014-12-18 17:42:32 -08002121}
Adam Langley95c29f32014-06-20 12:00:00 -07002122
David Benjamin93d17492015-10-17 12:43:36 -04002123int SSL_want(const SSL *ssl) { return ssl->rwstate; }
Adam Langley95c29f32014-06-20 12:00:00 -07002124
Adam Langleyfcf25832014-12-18 17:42:32 -08002125void SSL_CTX_set_tmp_rsa_callback(SSL_CTX *ctx,
2126 RSA *(*cb)(SSL *ssl, int is_export,
2127 int keylength)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002128}
Adam Langley95c29f32014-06-20 12:00:00 -07002129
Adam Langleyfcf25832014-12-18 17:42:32 -08002130void SSL_set_tmp_rsa_callback(SSL *ssl, RSA *(*cb)(SSL *ssl, int is_export,
2131 int keylength)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002132}
2133
2134void SSL_CTX_set_tmp_dh_callback(SSL_CTX *ctx,
David Benjamin59015c32015-04-26 13:13:55 -04002135 DH *(*callback)(SSL *ssl, int is_export,
2136 int keylength)) {
2137 ctx->cert->dh_tmp_cb = callback;
Adam Langleyfcf25832014-12-18 17:42:32 -08002138}
2139
David Benjamin59015c32015-04-26 13:13:55 -04002140void SSL_set_tmp_dh_callback(SSL *ssl, DH *(*callback)(SSL *ssl, int is_export,
2141 int keylength)) {
2142 ssl->cert->dh_tmp_cb = callback;
Adam Langleyfcf25832014-12-18 17:42:32 -08002143}
2144
Adam Langleyfcf25832014-12-18 17:42:32 -08002145int SSL_CTX_use_psk_identity_hint(SSL_CTX *ctx, const char *identity_hint) {
2146 if (identity_hint != NULL && strlen(identity_hint) > PSK_MAX_IDENTITY_LEN) {
David Benjamin3570d732015-06-29 00:28:17 -04002147 OPENSSL_PUT_ERROR(SSL, SSL_R_DATA_LENGTH_TOO_LONG);
Adam Langleyfcf25832014-12-18 17:42:32 -08002148 return 0;
2149 }
2150
David Benjamin2755a3e2015-04-22 16:17:58 -04002151 OPENSSL_free(ctx->psk_identity_hint);
Adam Langleyfcf25832014-12-18 17:42:32 -08002152
2153 if (identity_hint != NULL) {
2154 ctx->psk_identity_hint = BUF_strdup(identity_hint);
2155 if (ctx->psk_identity_hint == NULL) {
2156 return 0;
Adam Langley95c29f32014-06-20 12:00:00 -07002157 }
Adam Langleyfcf25832014-12-18 17:42:32 -08002158 } else {
2159 ctx->psk_identity_hint = NULL;
2160 }
Adam Langley95c29f32014-06-20 12:00:00 -07002161
Adam Langleyfcf25832014-12-18 17:42:32 -08002162 return 1;
2163}
2164
David Benjamine8814df2015-09-15 08:05:54 -04002165int SSL_use_psk_identity_hint(SSL *ssl, const char *identity_hint) {
2166 if (ssl == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002167 return 0;
2168 }
2169
2170 if (identity_hint != NULL && strlen(identity_hint) > PSK_MAX_IDENTITY_LEN) {
David Benjamin3570d732015-06-29 00:28:17 -04002171 OPENSSL_PUT_ERROR(SSL, SSL_R_DATA_LENGTH_TOO_LONG);
Adam Langleyfcf25832014-12-18 17:42:32 -08002172 return 0;
2173 }
2174
2175 /* Clear currently configured hint, if any. */
David Benjamine8814df2015-09-15 08:05:54 -04002176 OPENSSL_free(ssl->psk_identity_hint);
2177 ssl->psk_identity_hint = NULL;
Adam Langleyfcf25832014-12-18 17:42:32 -08002178
David Benjamin78679342016-09-16 19:42:05 -04002179 /* Treat the empty hint as not supplying one. Plain PSK makes it possible to
2180 * send either no hint (omit ServerKeyExchange) or an empty hint, while
2181 * ECDHE_PSK can only spell empty hint. Having different capabilities is odd,
2182 * so we interpret empty and missing as identical. */
2183 if (identity_hint != NULL && identity_hint[0] != '\0') {
David Benjamine8814df2015-09-15 08:05:54 -04002184 ssl->psk_identity_hint = BUF_strdup(identity_hint);
2185 if (ssl->psk_identity_hint == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002186 return 0;
Adam Langley95c29f32014-06-20 12:00:00 -07002187 }
Adam Langleyfcf25832014-12-18 17:42:32 -08002188 }
Adam Langley95c29f32014-06-20 12:00:00 -07002189
Adam Langleyfcf25832014-12-18 17:42:32 -08002190 return 1;
2191}
Adam Langley95c29f32014-06-20 12:00:00 -07002192
David Benjamine8814df2015-09-15 08:05:54 -04002193const char *SSL_get_psk_identity_hint(const SSL *ssl) {
2194 if (ssl == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002195 return NULL;
2196 }
David Benjamine8814df2015-09-15 08:05:54 -04002197 return ssl->psk_identity_hint;
Adam Langleyfcf25832014-12-18 17:42:32 -08002198}
Adam Langley95c29f32014-06-20 12:00:00 -07002199
David Benjamine8814df2015-09-15 08:05:54 -04002200const char *SSL_get_psk_identity(const SSL *ssl) {
Steven Valdez87eab492016-06-27 16:34:59 -04002201 if (ssl == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002202 return NULL;
2203 }
Steven Valdez87eab492016-06-27 16:34:59 -04002204 SSL_SESSION *session = SSL_get_session(ssl);
2205 if (session == NULL) {
2206 return NULL;
2207 }
2208 return session->psk_identity;
Adam Langleyfcf25832014-12-18 17:42:32 -08002209}
Adam Langley95c29f32014-06-20 12:00:00 -07002210
Adam Langleyfcf25832014-12-18 17:42:32 -08002211void SSL_set_psk_client_callback(
David Benjamine8814df2015-09-15 08:05:54 -04002212 SSL *ssl, unsigned (*cb)(SSL *ssl, const char *hint, char *identity,
2213 unsigned max_identity_len, uint8_t *psk,
2214 unsigned max_psk_len)) {
2215 ssl->psk_client_callback = cb;
Adam Langleyfcf25832014-12-18 17:42:32 -08002216}
Adam Langley95c29f32014-06-20 12:00:00 -07002217
Adam Langleyfcf25832014-12-18 17:42:32 -08002218void SSL_CTX_set_psk_client_callback(
David Benjamine8814df2015-09-15 08:05:54 -04002219 SSL_CTX *ctx, unsigned (*cb)(SSL *ssl, const char *hint, char *identity,
2220 unsigned max_identity_len, uint8_t *psk,
2221 unsigned max_psk_len)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002222 ctx->psk_client_callback = cb;
2223}
Adam Langley95c29f32014-06-20 12:00:00 -07002224
Adam Langleyfcf25832014-12-18 17:42:32 -08002225void SSL_set_psk_server_callback(
David Benjamine8814df2015-09-15 08:05:54 -04002226 SSL *ssl, unsigned (*cb)(SSL *ssl, const char *identity, uint8_t *psk,
2227 unsigned max_psk_len)) {
2228 ssl->psk_server_callback = cb;
Adam Langleyfcf25832014-12-18 17:42:32 -08002229}
Adam Langley95c29f32014-06-20 12:00:00 -07002230
Adam Langleyfcf25832014-12-18 17:42:32 -08002231void SSL_CTX_set_psk_server_callback(
David Benjamine8814df2015-09-15 08:05:54 -04002232 SSL_CTX *ctx, unsigned (*cb)(SSL *ssl, const char *identity,
2233 uint8_t *psk, unsigned max_psk_len)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002234 ctx->psk_server_callback = cb;
2235}
Adam Langley95c29f32014-06-20 12:00:00 -07002236
Adam Langleyfcf25832014-12-18 17:42:32 -08002237void SSL_CTX_set_msg_callback(SSL_CTX *ctx,
2238 void (*cb)(int write_p, int version,
2239 int content_type, const void *buf,
2240 size_t len, SSL *ssl, void *arg)) {
David Benjamin59015c32015-04-26 13:13:55 -04002241 ctx->msg_callback = cb;
Adam Langleyfcf25832014-12-18 17:42:32 -08002242}
David Benjamin61ecccf2015-05-05 09:44:51 -04002243
2244void SSL_CTX_set_msg_callback_arg(SSL_CTX *ctx, void *arg) {
2245 ctx->msg_callback_arg = arg;
2246}
2247
Adam Langleyfcf25832014-12-18 17:42:32 -08002248void SSL_set_msg_callback(SSL *ssl,
2249 void (*cb)(int write_p, int version, int content_type,
2250 const void *buf, size_t len, SSL *ssl,
2251 void *arg)) {
David Benjamin59015c32015-04-26 13:13:55 -04002252 ssl->msg_callback = cb;
Adam Langleyfcf25832014-12-18 17:42:32 -08002253}
Adam Langley95c29f32014-06-20 12:00:00 -07002254
David Benjamin61ecccf2015-05-05 09:44:51 -04002255void SSL_set_msg_callback_arg(SSL *ssl, void *arg) {
2256 ssl->msg_callback_arg = arg;
2257}
2258
David Benjamind28f59c2015-11-17 22:32:50 -05002259void SSL_CTX_set_keylog_callback(SSL_CTX *ctx,
2260 void (*cb)(const SSL *ssl, const char *line)) {
2261 ctx->keylog_callback = cb;
Adam Langleyfcf25832014-12-18 17:42:32 -08002262}
Adam Langley95c29f32014-06-20 12:00:00 -07002263
David Benjamin6e3f5cc2016-09-14 14:43:14 -04002264void (*SSL_CTX_get_keylog_callback(const SSL_CTX *ctx))(const SSL *ssl,
2265 const char *line) {
2266 return ctx->keylog_callback;
2267}
2268
Taylor Brandstetter9edb2c62016-06-08 15:26:59 -07002269void SSL_CTX_set_current_time_cb(SSL_CTX *ctx,
2270 void (*cb)(const SSL *ssl,
2271 struct timeval *out_clock)) {
2272 ctx->current_time_cb = cb;
2273}
2274
Adam Langleyfcf25832014-12-18 17:42:32 -08002275static int cbb_add_hex(CBB *cbb, const uint8_t *in, size_t in_len) {
2276 static const char hextable[] = "0123456789abcdef";
2277 uint8_t *out;
Adam Langley95c29f32014-06-20 12:00:00 -07002278
Adam Langleyfcf25832014-12-18 17:42:32 -08002279 if (!CBB_add_space(cbb, &out, in_len * 2)) {
2280 return 0;
2281 }
Adam Langley95c29f32014-06-20 12:00:00 -07002282
David Benjamin54091232016-09-05 12:47:25 -04002283 for (size_t i = 0; i < in_len; i++) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002284 *(out++) = (uint8_t)hextable[in[i] >> 4];
2285 *(out++) = (uint8_t)hextable[in[i] & 0xf];
2286 }
Adam Langley95c29f32014-06-20 12:00:00 -07002287
Adam Langleyfcf25832014-12-18 17:42:32 -08002288 return 1;
2289}
David Benjamin859ec3c2014-09-02 16:29:36 -04002290
David Benjamine776cc22016-07-19 07:26:49 +02002291int ssl_log_secret(const SSL *ssl, const char *label, const uint8_t *secret,
2292 size_t secret_len) {
David Benjamind28f59c2015-11-17 22:32:50 -05002293 if (ssl->ctx->keylog_callback == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002294 return 1;
2295 }
Adam Langleyadb739e2014-06-20 12:00:00 -07002296
David Benjamind28f59c2015-11-17 22:32:50 -05002297 CBB cbb;
2298 uint8_t *out;
2299 size_t out_len;
David Benjamine776cc22016-07-19 07:26:49 +02002300 if (!CBB_init(&cbb, strlen(label) + 1 + SSL3_RANDOM_SIZE * 2 + 1 +
2301 secret_len * 2 + 1) ||
2302 !CBB_add_bytes(&cbb, (const uint8_t *)label, strlen(label)) ||
Adam Langleyfcf25832014-12-18 17:42:32 -08002303 !CBB_add_bytes(&cbb, (const uint8_t *)" ", 1) ||
David Benjamine776cc22016-07-19 07:26:49 +02002304 !cbb_add_hex(&cbb, ssl->s3->client_random, SSL3_RANDOM_SIZE) ||
2305 !CBB_add_bytes(&cbb, (const uint8_t *)" ", 1) ||
2306 !cbb_add_hex(&cbb, secret, secret_len) ||
David Benjamind28f59c2015-11-17 22:32:50 -05002307 !CBB_add_u8(&cbb, 0 /* NUL */) ||
Adam Langleyfcf25832014-12-18 17:42:32 -08002308 !CBB_finish(&cbb, &out, &out_len)) {
2309 CBB_cleanup(&cbb);
2310 return 0;
2311 }
Adam Langleyadb739e2014-06-20 12:00:00 -07002312
David Benjamind28f59c2015-11-17 22:32:50 -05002313 ssl->ctx->keylog_callback(ssl, (const char *)out);
Adam Langleyfcf25832014-12-18 17:42:32 -08002314 OPENSSL_free(out);
David Benjamind28f59c2015-11-17 22:32:50 -05002315 return 1;
Adam Langley95c29f32014-06-20 12:00:00 -07002316}
2317
David Benjamin5d8b1282015-10-17 23:26:35 -04002318int SSL_is_init_finished(const SSL *ssl) {
David Benjamin9e766d72017-02-10 23:14:17 -05002319 return !SSL_in_init(ssl);
David Benjamin5d8b1282015-10-17 23:26:35 -04002320}
2321
2322int SSL_in_init(const SSL *ssl) {
David Benjamin9e766d72017-02-10 23:14:17 -05002323 SSL_HANDSHAKE *hs = ssl->s3->hs;
2324 return hs != NULL && hs->state != SSL_ST_OK;
David Benjamin5d8b1282015-10-17 23:26:35 -04002325}
2326
2327int SSL_in_false_start(const SSL *ssl) {
David Benjamina0486782016-10-06 19:11:32 -04002328 if (ssl->s3->hs == NULL) {
2329 return 0;
2330 }
2331 return ssl->s3->hs->in_false_start;
David Benjamined7c4752015-02-16 19:16:46 -05002332}
2333
David Benjamin0d56f882015-12-19 17:05:56 -05002334int SSL_cutthrough_complete(const SSL *ssl) {
2335 return SSL_in_false_start(ssl);
Adam Langleyfcf25832014-12-18 17:42:32 -08002336}
Adam Langley95c29f32014-06-20 12:00:00 -07002337
Adam Langleyfcf25832014-12-18 17:42:32 -08002338void SSL_get_structure_sizes(size_t *ssl_size, size_t *ssl_ctx_size,
2339 size_t *ssl_session_size) {
2340 *ssl_size = sizeof(SSL);
2341 *ssl_ctx_size = sizeof(SSL_CTX);
2342 *ssl_session_size = sizeof(SSL_SESSION);
2343}
Feng Lu41aa3252014-11-21 22:47:56 -08002344
David Benjamin0d56f882015-12-19 17:05:56 -05002345int ssl3_can_false_start(const SSL *ssl) {
2346 const SSL_CIPHER *const cipher = SSL_get_current_cipher(ssl);
Adam Langleyfcf25832014-12-18 17:42:32 -08002347
Adam Langleye631d962015-04-01 13:11:01 -07002348 /* False Start only for TLS 1.2 with an ECDHE+AEAD cipher and ALPN or NPN. */
David Benjamince079fd2016-08-02 16:22:34 -04002349 return !SSL_is_dtls(ssl) &&
Steven Valdez4f94b1c2016-05-24 12:31:07 -04002350 SSL_version(ssl) == TLS1_2_VERSION &&
David Benjaminb74b0812016-10-06 19:43:48 -04002351 (ssl->s3->alpn_selected != NULL ||
2352 ssl->s3->next_proto_negotiated != NULL) &&
David Benjamin195dc782015-02-19 13:27:05 -05002353 cipher != NULL &&
Matthew Braithwaite651aaef2016-12-08 16:14:36 -08002354 cipher->algorithm_mkey == SSL_kECDHE &&
David Benjamin13414b32015-12-09 23:02:39 -05002355 cipher->algorithm_mac == SSL_AEAD;
Adam Langleyfcf25832014-12-18 17:42:32 -08002356}
2357
David Benjaminb6a0a512016-06-21 10:33:21 -04002358const struct {
2359 uint16_t version;
2360 uint32_t flag;
2361} kVersions[] = {
2362 {SSL3_VERSION, SSL_OP_NO_SSLv3},
2363 {TLS1_VERSION, SSL_OP_NO_TLSv1},
2364 {TLS1_1_VERSION, SSL_OP_NO_TLSv1_1},
2365 {TLS1_2_VERSION, SSL_OP_NO_TLSv1_2},
2366 {TLS1_3_VERSION, SSL_OP_NO_TLSv1_3},
2367};
Adam Langleyfcf25832014-12-18 17:42:32 -08002368
Steven Valdezcb966542016-08-17 16:56:14 -04002369static const size_t kVersionsLen = OPENSSL_ARRAY_SIZE(kVersions);
Adam Langleyfcf25832014-12-18 17:42:32 -08002370
David Benjamine0ff7672016-09-19 18:40:03 -04002371int ssl_get_version_range(const SSL *ssl, uint16_t *out_min_version,
2372 uint16_t *out_max_version) {
David Benjaminb6a0a512016-06-21 10:33:21 -04002373 /* For historical reasons, |SSL_OP_NO_DTLSv1| aliases |SSL_OP_NO_TLSv1|, but
2374 * DTLS 1.0 should be mapped to TLS 1.1. */
David Benjamin0d56f882015-12-19 17:05:56 -05002375 uint32_t options = ssl->options;
David Benjamince079fd2016-08-02 16:22:34 -04002376 if (SSL_is_dtls(ssl)) {
David Benjaminb6a0a512016-06-21 10:33:21 -04002377 options &= ~SSL_OP_NO_TLSv1_1;
2378 if (options & SSL_OP_NO_DTLSv1) {
2379 options |= SSL_OP_NO_TLSv1_1;
2380 }
2381 }
2382
2383 uint16_t min_version = ssl->min_version;
2384 uint16_t max_version = ssl->max_version;
2385
2386 /* Bound the range to only those implemented in this protocol. */
2387 if (min_version < ssl->method->min_version) {
2388 min_version = ssl->method->min_version;
2389 }
2390 if (max_version > ssl->method->max_version) {
2391 max_version = ssl->method->max_version;
2392 }
Adam Langleyfcf25832014-12-18 17:42:32 -08002393
2394 /* OpenSSL's API for controlling versions entails blacklisting individual
2395 * protocols. This has two problems. First, on the client, the protocol can
2396 * only express a contiguous range of versions. Second, a library consumer
2397 * trying to set a maximum version cannot disable protocol versions that get
2398 * added in a future version of the library.
2399 *
2400 * To account for both of these, OpenSSL interprets the client-side bitmask
2401 * as a min/max range by picking the lowest contiguous non-empty range of
2402 * enabled protocols. Note that this means it is impossible to set a maximum
David Benjaminb6a0a512016-06-21 10:33:21 -04002403 * version of the higest supported TLS version in a future-proof way. */
David Benjaminb6a0a512016-06-21 10:33:21 -04002404 int any_enabled = 0;
David Benjamin54091232016-09-05 12:47:25 -04002405 for (size_t i = 0; i < kVersionsLen; i++) {
David Benjaminb6a0a512016-06-21 10:33:21 -04002406 /* Only look at the versions already enabled. */
2407 if (min_version > kVersions[i].version) {
2408 continue;
Adam Langleyfcf25832014-12-18 17:42:32 -08002409 }
David Benjaminb6a0a512016-06-21 10:33:21 -04002410 if (max_version < kVersions[i].version) {
2411 break;
Adam Langleyfcf25832014-12-18 17:42:32 -08002412 }
David Benjaminb6a0a512016-06-21 10:33:21 -04002413
2414 if (!(options & kVersions[i].flag)) {
2415 /* The minimum version is the first enabled version. */
2416 if (!any_enabled) {
2417 any_enabled = 1;
2418 min_version = kVersions[i].version;
2419 }
2420 continue;
Adam Langleyfcf25832014-12-18 17:42:32 -08002421 }
David Benjaminb6a0a512016-06-21 10:33:21 -04002422
2423 /* If there is a disabled version after the first enabled one, all versions
2424 * after it are implicitly disabled. */
2425 if (any_enabled) {
2426 max_version = kVersions[i-1].version;
2427 break;
Adam Langleyfcf25832014-12-18 17:42:32 -08002428 }
2429 }
2430
David Benjamine0ff7672016-09-19 18:40:03 -04002431 if (!any_enabled) {
David Benjaminb6a0a512016-06-21 10:33:21 -04002432 OPENSSL_PUT_ERROR(SSL, SSL_R_WRONG_SSL_VERSION);
2433 return 0;
David Benjaminea72bd02014-12-21 21:27:41 -05002434 }
2435
David Benjaminb6a0a512016-06-21 10:33:21 -04002436 *out_min_version = min_version;
2437 *out_max_version = max_version;
2438 return 1;
David Benjaminea72bd02014-12-21 21:27:41 -05002439}
2440
David Benjaminb9e4fa52015-12-29 23:58:17 -05002441uint16_t ssl3_protocol_version(const SSL *ssl) {
2442 assert(ssl->s3->have_version);
David Benjamin2dc02042016-09-19 19:57:37 -04002443 uint16_t version;
2444 if (!ssl->method->version_from_wire(&version, ssl->version)) {
2445 /* TODO(davidben): Use the internal version representation for ssl->version
2446 * and map to the public API representation at API boundaries. */
2447 assert(0);
2448 return 0;
2449 }
2450
2451 return version;
David Benjaminb9e4fa52015-12-29 23:58:17 -05002452}
2453
David Benjamince079fd2016-08-02 16:22:34 -04002454int SSL_is_server(const SSL *ssl) { return ssl->server; }
2455
2456int SSL_is_dtls(const SSL *ssl) { return ssl->method->is_dtls; }
Adam Langleyfcf25832014-12-18 17:42:32 -08002457
David Benjamin731058e2016-12-03 23:15:13 -05002458void SSL_CTX_set_select_certificate_cb(SSL_CTX *ctx,
2459 int (*cb)(const SSL_CLIENT_HELLO *)) {
David Benjamind4c2bce2015-10-17 12:28:18 -04002460 ctx->select_certificate_cb = cb;
2461}
2462
David Benjamin731058e2016-12-03 23:15:13 -05002463void SSL_CTX_set_dos_protection_cb(SSL_CTX *ctx,
2464 int (*cb)(const SSL_CLIENT_HELLO *)) {
Adam Langley524e7172015-02-20 16:04:00 -08002465 ctx->dos_protection_cb = cb;
2466}
2467
David Benjamin1d5ef3b2015-10-12 19:54:18 -04002468void SSL_set_renegotiate_mode(SSL *ssl, enum ssl_renegotiate_mode_t mode) {
2469 ssl->renegotiate_mode = mode;
2470}
2471
Adam Langleyc2d32802015-11-03 18:36:10 -08002472int SSL_get_ivs(const SSL *ssl, const uint8_t **out_read_iv,
2473 const uint8_t **out_write_iv, size_t *out_iv_len) {
David Benjamin79978df2015-12-25 15:56:49 -05002474 if (ssl->s3->aead_read_ctx == NULL || ssl->s3->aead_write_ctx == NULL) {
Adam Langleyc2d32802015-11-03 18:36:10 -08002475 return 0;
2476 }
2477
2478 size_t write_iv_len;
David Benjamin79978df2015-12-25 15:56:49 -05002479 if (!EVP_AEAD_CTX_get_iv(&ssl->s3->aead_read_ctx->ctx, out_read_iv,
2480 out_iv_len) ||
2481 !EVP_AEAD_CTX_get_iv(&ssl->s3->aead_write_ctx->ctx, out_write_iv,
Adam Langleyc2d32802015-11-03 18:36:10 -08002482 &write_iv_len) ||
2483 *out_iv_len != write_iv_len) {
2484 return 0;
2485 }
2486
2487 return 1;
David Benjamine348ff42015-11-06 17:55:30 -05002488}
David Benjamin6e807652015-11-02 12:02:20 -05002489
David Benjamin91b25012016-01-21 16:39:58 -05002490static uint64_t be_to_u64(const uint8_t in[8]) {
David Benjaminde942382016-02-11 12:02:01 -05002491 return (((uint64_t)in[0]) << 56) | (((uint64_t)in[1]) << 48) |
2492 (((uint64_t)in[2]) << 40) | (((uint64_t)in[3]) << 32) |
2493 (((uint64_t)in[4]) << 24) | (((uint64_t)in[5]) << 16) |
2494 (((uint64_t)in[6]) << 8) | ((uint64_t)in[7]);
David Benjamin91b25012016-01-21 16:39:58 -05002495}
2496
2497uint64_t SSL_get_read_sequence(const SSL *ssl) {
2498 /* TODO(davidben): Internally represent sequence numbers as uint64_t. */
David Benjamince079fd2016-08-02 16:22:34 -04002499 if (SSL_is_dtls(ssl)) {
David Benjaminde942382016-02-11 12:02:01 -05002500 /* max_seq_num already includes the epoch. */
2501 assert(ssl->d1->r_epoch == (ssl->d1->bitmap.max_seq_num >> 48));
2502 return ssl->d1->bitmap.max_seq_num;
2503 }
David Benjamin91b25012016-01-21 16:39:58 -05002504 return be_to_u64(ssl->s3->read_sequence);
2505}
2506
2507uint64_t SSL_get_write_sequence(const SSL *ssl) {
David Benjaminde942382016-02-11 12:02:01 -05002508 uint64_t ret = be_to_u64(ssl->s3->write_sequence);
David Benjamince079fd2016-08-02 16:22:34 -04002509 if (SSL_is_dtls(ssl)) {
David Benjaminde942382016-02-11 12:02:01 -05002510 assert((ret >> 48) == 0);
2511 ret |= ((uint64_t)ssl->d1->w_epoch) << 48;
2512 }
2513 return ret;
David Benjamin91b25012016-01-21 16:39:58 -05002514}
2515
Steven Valdez02563852016-06-23 13:33:05 -04002516uint16_t SSL_get_peer_signature_algorithm(const SSL *ssl) {
David Benjaminf1050fd2016-12-13 20:05:36 -05002517 /* TODO(davidben): This checks the wrong session if there is a renegotiation
2518 * in progress. */
2519 SSL_SESSION *session = SSL_get_session(ssl);
2520 if (session == NULL) {
2521 return 0;
2522 }
2523
2524 return session->peer_signature_algorithm;
Steven Valdez02563852016-06-23 13:33:05 -04002525}
2526
David Benjamin96ba15f2015-12-25 14:10:17 -05002527size_t SSL_get_client_random(const SSL *ssl, uint8_t *out, size_t max_out) {
2528 if (max_out == 0) {
2529 return sizeof(ssl->s3->client_random);
2530 }
2531 if (max_out > sizeof(ssl->s3->client_random)) {
2532 max_out = sizeof(ssl->s3->client_random);
2533 }
David Benjamin17cf2cb2016-12-13 01:07:13 -05002534 OPENSSL_memcpy(out, ssl->s3->client_random, max_out);
David Benjamin96ba15f2015-12-25 14:10:17 -05002535 return max_out;
2536}
2537
2538size_t SSL_get_server_random(const SSL *ssl, uint8_t *out, size_t max_out) {
2539 if (max_out == 0) {
2540 return sizeof(ssl->s3->server_random);
2541 }
2542 if (max_out > sizeof(ssl->s3->server_random)) {
2543 max_out = sizeof(ssl->s3->server_random);
2544 }
David Benjamin17cf2cb2016-12-13 01:07:13 -05002545 OPENSSL_memcpy(out, ssl->s3->server_random, max_out);
David Benjamin96ba15f2015-12-25 14:10:17 -05002546 return max_out;
2547}
2548
David Benjaminf6494f42016-01-07 12:37:41 -08002549const SSL_CIPHER *SSL_get_pending_cipher(const SSL *ssl) {
David Benjamin45738dd2017-02-09 20:01:26 -05002550 SSL_HANDSHAKE *hs = ssl->s3->hs;
2551 if (hs == NULL) {
David Benjaminf6494f42016-01-07 12:37:41 -08002552 return NULL;
2553 }
David Benjamin45738dd2017-02-09 20:01:26 -05002554 return hs->new_cipher;
David Benjaminf6494f42016-01-07 12:37:41 -08002555}
2556
David Benjaminbbaf3672016-11-17 10:53:09 +09002557void SSL_set_retain_only_sha256_of_client_certs(SSL *ssl, int enabled) {
2558 ssl->retain_only_sha256_of_client_certs = !!enabled;
2559}
2560
David Benjamincdd0b7e2016-01-07 10:10:41 -08002561void SSL_CTX_set_retain_only_sha256_of_client_certs(SSL_CTX *ctx, int enabled) {
2562 ctx->retain_only_sha256_of_client_certs = !!enabled;
2563}
2564
David Benjamin65ac9972016-09-02 21:35:25 -04002565void SSL_CTX_set_grease_enabled(SSL_CTX *ctx, int enabled) {
2566 ctx->grease_enabled = !!enabled;
2567}
2568
David Benjamin6f600d62016-12-21 16:06:54 -05002569void SSL_CTX_set_short_header_enabled(SSL_CTX *ctx, int enabled) {
2570 ctx->short_header_enabled = !!enabled;
2571}
2572
David Benjamin27bbae42015-09-13 00:54:37 -04002573int SSL_clear(SSL *ssl) {
David Benjaminb79cc842016-12-07 15:57:14 -05002574 /* In OpenSSL, reusing a client |SSL| with |SSL_clear| causes the previously
2575 * established session to be offered the next time around. wpa_supplicant
2576 * depends on this behavior, so emulate it. */
2577 SSL_SESSION *session = NULL;
2578 if (!ssl->server && ssl->s3->established_session != NULL) {
2579 session = ssl->s3->established_session;
2580 SSL_SESSION_up_ref(session);
2581 }
2582
David Benjamin27bbae42015-09-13 00:54:37 -04002583 /* TODO(davidben): Some state on |ssl| is reset both in |SSL_new| and
2584 * |SSL_clear| because it is per-connection state rather than configuration
2585 * state. Per-connection state should be on |ssl->s3| and |ssl->d1| so it is
2586 * naturally reset at the right points between |SSL_new|, |SSL_clear|, and
2587 * |ssl3_new|. */
2588
2589 ssl->rwstate = SSL_NOTHING;
2590
2591 BUF_MEM_free(ssl->init_buf);
2592 ssl->init_buf = NULL;
David Benjamin49054542016-07-27 13:51:01 -04002593 ssl->init_msg = NULL;
2594 ssl->init_num = 0;
David Benjamin27bbae42015-09-13 00:54:37 -04002595
David Benjamin27bbae42015-09-13 00:54:37 -04002596 /* The ssl->d1->mtu is simultaneously configuration (preserved across
2597 * clear) and connection-specific state (gets reset).
2598 *
2599 * TODO(davidben): Avoid this. */
2600 unsigned mtu = 0;
2601 if (ssl->d1 != NULL) {
2602 mtu = ssl->d1->mtu;
2603 }
2604
2605 ssl->method->ssl_free(ssl);
2606 if (!ssl->method->ssl_new(ssl)) {
David Benjaminb79cc842016-12-07 15:57:14 -05002607 SSL_SESSION_free(session);
David Benjamin27bbae42015-09-13 00:54:37 -04002608 return 0;
2609 }
David Benjamin27bbae42015-09-13 00:54:37 -04002610
David Benjamince079fd2016-08-02 16:22:34 -04002611 if (SSL_is_dtls(ssl) && (SSL_get_options(ssl) & SSL_OP_NO_QUERY_MTU)) {
David Benjamin27bbae42015-09-13 00:54:37 -04002612 ssl->d1->mtu = mtu;
2613 }
2614
David Benjaminb79cc842016-12-07 15:57:14 -05002615 if (session != NULL) {
2616 SSL_set_session(ssl, session);
2617 SSL_SESSION_free(session);
2618 }
2619
David Benjamin27bbae42015-09-13 00:54:37 -04002620 return 1;
2621}
2622
David Benjamin4e9cc712016-06-01 20:16:03 -04002623void ssl_do_info_callback(const SSL *ssl, int type, int value) {
2624 void (*cb)(const SSL *ssl, int type, int value) = NULL;
2625 if (ssl->info_callback != NULL) {
2626 cb = ssl->info_callback;
2627 } else if (ssl->ctx->info_callback != NULL) {
2628 cb = ssl->ctx->info_callback;
2629 }
2630
2631 if (cb != NULL) {
2632 cb(ssl, type, value);
2633 }
2634}
2635
David Benjaminc0279992016-09-19 20:15:07 -04002636void ssl_do_msg_callback(SSL *ssl, int is_write, int content_type,
David Benjamin4e9cc712016-06-01 20:16:03 -04002637 const void *buf, size_t len) {
David Benjaminc0279992016-09-19 20:15:07 -04002638 if (ssl->msg_callback == NULL) {
2639 return;
David Benjamin4e9cc712016-06-01 20:16:03 -04002640 }
David Benjaminc0279992016-09-19 20:15:07 -04002641
2642 /* |version| is zero when calling for |SSL3_RT_HEADER| and |SSL2_VERSION| for
2643 * a V2ClientHello. */
2644 int version;
2645 switch (content_type) {
2646 case 0:
2647 /* V2ClientHello */
2648 version = SSL2_VERSION;
2649 break;
2650 case SSL3_RT_HEADER:
2651 version = 0;
2652 break;
2653 default:
Steven Valdezfdd10992016-09-15 16:27:05 -04002654 version = SSL_version(ssl);
David Benjaminc0279992016-09-19 20:15:07 -04002655 }
2656
2657 ssl->msg_callback(is_write, version, content_type, buf, len, ssl,
2658 ssl->msg_callback_arg);
David Benjamin4e9cc712016-06-01 20:16:03 -04002659}
2660
David Benjaminda881e92015-04-26 14:45:04 -04002661int SSL_CTX_sess_connect(const SSL_CTX *ctx) { return 0; }
2662int SSL_CTX_sess_connect_good(const SSL_CTX *ctx) { return 0; }
2663int SSL_CTX_sess_connect_renegotiate(const SSL_CTX *ctx) { return 0; }
2664int SSL_CTX_sess_accept(const SSL_CTX *ctx) { return 0; }
2665int SSL_CTX_sess_accept_renegotiate(const SSL_CTX *ctx) { return 0; }
2666int SSL_CTX_sess_accept_good(const SSL_CTX *ctx) { return 0; }
2667int SSL_CTX_sess_hits(const SSL_CTX *ctx) { return 0; }
2668int SSL_CTX_sess_cb_hits(const SSL_CTX *ctx) { return 0; }
2669int SSL_CTX_sess_misses(const SSL_CTX *ctx) { return 0; }
2670int SSL_CTX_sess_timeouts(const SSL_CTX *ctx) { return 0; }
2671int SSL_CTX_sess_cache_full(const SSL_CTX *ctx) { return 0; }
David Benjamin936aada2016-06-07 19:09:22 -04002672
2673int SSL_num_renegotiations(const SSL *ssl) {
2674 return SSL_total_renegotiations(ssl);
2675}
2676
2677int SSL_CTX_need_tmp_RSA(const SSL_CTX *ctx) { return 0; }
2678int SSL_need_tmp_RSA(const SSL *ssl) { return 0; }
2679int SSL_CTX_set_tmp_rsa(SSL_CTX *ctx, const RSA *rsa) { return 1; }
2680int SSL_set_tmp_rsa(SSL *ssl, const RSA *rsa) { return 1; }
Matt Braithwaite4838d8a2015-08-20 13:20:03 -07002681void ERR_load_SSL_strings(void) {}
David Benjamin27bbae42015-09-13 00:54:37 -04002682void SSL_load_error_strings(void) {}
David Benjamin936aada2016-06-07 19:09:22 -04002683int SSL_cache_hit(SSL *ssl) { return SSL_session_reused(ssl); }
2684
2685int SSL_CTX_set_tmp_ecdh(SSL_CTX *ctx, const EC_KEY *ec_key) {
2686 if (ec_key == NULL || EC_KEY_get0_group(ec_key) == NULL) {
2687 OPENSSL_PUT_ERROR(SSL, ERR_R_PASSED_NULL_PARAMETER);
2688 return 0;
2689 }
2690 int nid = EC_GROUP_get_curve_name(EC_KEY_get0_group(ec_key));
2691 return SSL_CTX_set1_curves(ctx, &nid, 1);
2692}
2693
2694int SSL_set_tmp_ecdh(SSL *ssl, const EC_KEY *ec_key) {
2695 if (ec_key == NULL || EC_KEY_get0_group(ec_key) == NULL) {
2696 OPENSSL_PUT_ERROR(SSL, ERR_R_PASSED_NULL_PARAMETER);
2697 return 0;
2698 }
2699 int nid = EC_GROUP_get_curve_name(EC_KEY_get0_group(ec_key));
2700 return SSL_set1_curves(ssl, &nid, 1);
2701}
David Benjamin721e8b72016-08-03 13:13:17 -04002702
2703void ssl_get_current_time(const SSL *ssl, struct timeval *out_clock) {
2704 if (ssl->ctx->current_time_cb != NULL) {
2705 ssl->ctx->current_time_cb(ssl, out_clock);
2706 return;
2707 }
2708
David Benjaminec978dd2016-11-04 18:59:33 -04002709#if defined(BORINGSSL_UNSAFE_DETERMINISTIC_MODE)
David Benjamin01a90572016-09-22 00:11:43 -04002710 out_clock->tv_sec = 1234;
2711 out_clock->tv_usec = 1234;
2712#elif defined(OPENSSL_WINDOWS)
David Benjamin721e8b72016-08-03 13:13:17 -04002713 struct _timeb time;
2714 _ftime(&time);
2715 out_clock->tv_sec = time.time;
2716 out_clock->tv_usec = time.millitm * 1000;
2717#else
2718 gettimeofday(out_clock, NULL);
2719#endif
2720}
David Benjamine4706902016-09-20 15:12:23 -04002721
2722int SSL_CTX_set_min_version(SSL_CTX *ctx, uint16_t version) {
2723 return SSL_CTX_set_min_proto_version(ctx, version);
2724}
2725
2726int SSL_CTX_set_max_version(SSL_CTX *ctx, uint16_t version) {
2727 return SSL_CTX_set_max_proto_version(ctx, version);
2728}
2729
2730int SSL_set_min_version(SSL *ssl, uint16_t version) {
2731 return SSL_set_min_proto_version(ssl, version);
2732}
2733
2734int SSL_set_max_version(SSL *ssl, uint16_t version) {
2735 return SSL_set_max_proto_version(ssl, version);
2736}