blob: 9bf09df1e49d241aad071650ffd0f0a80b875a5c [file] [log] [blame]
Adam Langley95c29f32014-06-20 12:00:00 -07001/* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com)
2 * All rights reserved.
3 *
4 * This package is an SSL implementation written
5 * by Eric Young (eay@cryptsoft.com).
6 * The implementation was written so as to conform with Netscapes SSL.
7 *
8 * This library is free for commercial and non-commercial use as long as
9 * the following conditions are aheared to. The following conditions
10 * apply to all code found in this distribution, be it the RC4, RSA,
11 * lhash, DES, etc., code; not just the SSL code. The SSL documentation
12 * included with this distribution is covered by the same copyright terms
13 * except that the holder is Tim Hudson (tjh@cryptsoft.com).
14 *
15 * Copyright remains Eric Young's, and as such any Copyright notices in
16 * the code are not to be removed.
17 * If this package is used in a product, Eric Young should be given attribution
18 * as the author of the parts of the library used.
19 * This can be in the form of a textual message at program startup or
20 * in documentation (online or textual) provided with the package.
21 *
22 * Redistribution and use in source and binary forms, with or without
23 * modification, are permitted provided that the following conditions
24 * are met:
25 * 1. Redistributions of source code must retain the copyright
26 * notice, this list of conditions and the following disclaimer.
27 * 2. Redistributions in binary form must reproduce the above copyright
28 * notice, this list of conditions and the following disclaimer in the
29 * documentation and/or other materials provided with the distribution.
30 * 3. All advertising materials mentioning features or use of this software
31 * must display the following acknowledgement:
32 * "This product includes cryptographic software written by
33 * Eric Young (eay@cryptsoft.com)"
34 * The word 'cryptographic' can be left out if the rouines from the library
35 * being used are not cryptographic related :-).
36 * 4. If you include any Windows specific code (or a derivative thereof) from
37 * the apps directory (application code) you must include an acknowledgement:
38 * "This product includes software written by Tim Hudson (tjh@cryptsoft.com)"
39 *
40 * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
41 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
42 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
43 * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
44 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
45 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
46 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
47 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
48 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
49 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
50 * SUCH DAMAGE.
51 *
52 * The licence and distribution terms for any publically available version or
53 * derivative of this code cannot be changed. i.e. this code cannot simply be
54 * copied and put under another distribution licence
55 * [including the GNU Public Licence.]
56 */
57/* ====================================================================
58 * Copyright (c) 1998-2007 The OpenSSL Project. All rights reserved.
59 *
60 * Redistribution and use in source and binary forms, with or without
61 * modification, are permitted provided that the following conditions
62 * are met:
63 *
64 * 1. Redistributions of source code must retain the above copyright
65 * notice, this list of conditions and the following disclaimer.
66 *
67 * 2. Redistributions in binary form must reproduce the above copyright
68 * notice, this list of conditions and the following disclaimer in
69 * the documentation and/or other materials provided with the
70 * distribution.
71 *
72 * 3. All advertising materials mentioning features or use of this
73 * software must display the following acknowledgment:
74 * "This product includes software developed by the OpenSSL Project
75 * for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
76 *
77 * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
78 * endorse or promote products derived from this software without
79 * prior written permission. For written permission, please contact
80 * openssl-core@openssl.org.
81 *
82 * 5. Products derived from this software may not be called "OpenSSL"
83 * nor may "OpenSSL" appear in their names without prior written
84 * permission of the OpenSSL Project.
85 *
86 * 6. Redistributions of any form whatsoever must retain the following
87 * acknowledgment:
88 * "This product includes software developed by the OpenSSL Project
89 * for use in the OpenSSL Toolkit (http://www.openssl.org/)"
90 *
91 * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
92 * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
93 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
94 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
95 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
96 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
97 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
98 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
99 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
100 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
101 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
102 * OF THE POSSIBILITY OF SUCH DAMAGE.
103 * ====================================================================
104 *
105 * This product includes cryptographic software written by Eric Young
106 * (eay@cryptsoft.com). This product includes software written by Tim
107 * Hudson (tjh@cryptsoft.com).
108 *
109 */
110/* ====================================================================
111 * Copyright 2002 Sun Microsystems, Inc. ALL RIGHTS RESERVED.
112 * ECC cipher suite support in OpenSSL originally developed by
113 * SUN MICROSYSTEMS, INC., and contributed to the OpenSSL project.
114 */
115/* ====================================================================
116 * Copyright 2005 Nokia. All rights reserved.
117 *
118 * The portions of the attached software ("Contribution") is developed by
119 * Nokia Corporation and is licensed pursuant to the OpenSSL open source
120 * license.
121 *
122 * The Contribution, originally written by Mika Kousa and Pasi Eronen of
123 * Nokia Corporation, consists of the "PSK" (Pre-Shared Key) ciphersuites
124 * support (see RFC 4279) to OpenSSL.
125 *
126 * No patent licenses or other rights except those expressly stated in
127 * the OpenSSL open source license shall be deemed granted or received
128 * expressly, by implication, estoppel, or otherwise.
129 *
130 * No assurances are provided by Nokia that the Contribution does not
131 * infringe the patent or other intellectual property rights of any third
132 * party or that the license provides you with all the necessary rights
133 * to make use of the Contribution.
134 *
135 * THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IN
136 * ADDITION TO THE DISCLAIMERS INCLUDED IN THE LICENSE, NOKIA
137 * SPECIFICALLY DISCLAIMS ANY LIABILITY FOR CLAIMS BROUGHT BY YOU OR ANY
138 * OTHER ENTITY BASED ON INFRINGEMENT OF INTELLECTUAL PROPERTY RIGHTS OR
139 * OTHERWISE. */
140
David Benjamin9e4e01e2015-09-15 01:48:04 -0400141#include <openssl/ssl.h>
142
Adam Langley95c29f32014-06-20 12:00:00 -0700143#include <assert.h>
David Benjamin93d97432016-08-08 21:22:47 -0400144#include <stdlib.h>
David Benjaminf0ae1702015-04-07 23:05:04 -0400145#include <string.h>
Adam Langley95c29f32014-06-20 12:00:00 -0700146
David Benjamin39482a12014-07-20 13:30:15 -0400147#include <openssl/bytestring.h>
David Benjamin7c6d09b2015-09-05 11:00:19 -0400148#include <openssl/crypto.h>
Adam Langley95c29f32014-06-20 12:00:00 -0700149#include <openssl/dh.h>
David Benjaminf0ae1702015-04-07 23:05:04 -0400150#include <openssl/err.h>
Adam Langley95c29f32014-06-20 12:00:00 -0700151#include <openssl/lhash.h>
152#include <openssl/mem.h>
Adam Langley95c29f32014-06-20 12:00:00 -0700153#include <openssl/rand.h>
Adam Langley95c29f32014-06-20 12:00:00 -0700154
David Benjamin2ee94aa2015-04-07 22:38:30 -0400155#include "internal.h"
David Benjamin546f1a52015-04-15 16:46:09 -0400156#include "../crypto/internal.h"
157
David Benjamin721e8b72016-08-03 13:13:17 -0400158#if defined(OPENSSL_WINDOWS)
159#include <sys/timeb.h>
160#else
161#include <sys/socket.h>
162#include <sys/time.h>
163#endif
164
Adam Langley95c29f32014-06-20 12:00:00 -0700165
David Benjamin76c2efc2015-08-31 14:24:29 -0400166/* |SSL_R_UNKNOWN_PROTOCOL| is no longer emitted, but continue to define it
David Benjamin97760d52015-07-24 23:02:49 -0400167 * to avoid downstream churn. */
David Benjamin76c2efc2015-08-31 14:24:29 -0400168OPENSSL_DECLARE_ERROR_REASON(SSL, UNKNOWN_PROTOCOL)
David Benjamin97760d52015-07-24 23:02:49 -0400169
David Benjamin311c2572016-08-17 15:54:36 -0400170/* The following errors are no longer emitted, but are used in nginx without
171 * #ifdefs. */
172OPENSSL_DECLARE_ERROR_REASON(SSL, BLOCK_CIPHER_PAD_IS_WRONG)
173OPENSSL_DECLARE_ERROR_REASON(SSL, NO_CIPHERS_SPECIFIED)
174
Adam Langleyfcf25832014-12-18 17:42:32 -0800175/* Some error codes are special. Ensure the make_errors.go script never
176 * regresses this. */
177OPENSSL_COMPILE_ASSERT(SSL_R_TLSV1_ALERT_NO_RENEGOTIATION ==
178 SSL_AD_NO_RENEGOTIATION + SSL_AD_REASON_OFFSET,
179 ssl_alert_reason_code_mismatch);
David Benjamine1136082014-09-20 12:28:58 -0400180
David Benjamin1d0a1942015-04-26 15:35:35 -0400181/* kMaxHandshakeSize is the maximum size, in bytes, of a handshake message. */
182static const size_t kMaxHandshakeSize = (1u << 24) - 1;
183
David Benjaminaa585132015-06-29 23:36:17 -0400184static CRYPTO_EX_DATA_CLASS g_ex_data_class_ssl =
185 CRYPTO_EX_DATA_CLASS_INIT_WITH_APP_DATA;
186static CRYPTO_EX_DATA_CLASS g_ex_data_class_ssl_ctx =
187 CRYPTO_EX_DATA_CLASS_INIT_WITH_APP_DATA;
David Benjamin9f33fc62015-04-15 17:29:53 -0400188
David Benjamin7c6d09b2015-09-05 11:00:19 -0400189int SSL_library_init(void) {
190 CRYPTO_library_init();
191 return 1;
192}
193
Adam Langleye976e432016-02-15 14:01:10 -0800194static uint32_t ssl_session_hash(const SSL_SESSION *sess) {
195 const uint8_t *session_id = sess->session_id;
196
197 uint8_t tmp_storage[sizeof(uint32_t)];
198 if (sess->session_id_length < sizeof(tmp_storage)) {
David Benjamin17cf2cb2016-12-13 01:07:13 -0500199 OPENSSL_memset(tmp_storage, 0, sizeof(tmp_storage));
200 OPENSSL_memcpy(tmp_storage, sess->session_id, sess->session_id_length);
Adam Langleye976e432016-02-15 14:01:10 -0800201 session_id = tmp_storage;
202 }
203
David Benjamin27bbae42015-09-13 00:54:37 -0400204 uint32_t hash =
Adam Langleye976e432016-02-15 14:01:10 -0800205 ((uint32_t)session_id[0]) |
206 ((uint32_t)session_id[1] << 8) |
207 ((uint32_t)session_id[2] << 16) |
208 ((uint32_t)session_id[3] << 24);
David Benjamin7c6d09b2015-09-05 11:00:19 -0400209
David Benjamin27bbae42015-09-13 00:54:37 -0400210 return hash;
211}
212
213/* NB: If this function (or indeed the hash function which uses a sort of
214 * coarser function than this one) is changed, ensure
215 * SSL_CTX_has_matching_session_id() is checked accordingly. It relies on being
216 * able to construct an SSL_SESSION that will collide with any existing session
217 * with a matching session ID. */
218static int ssl_session_cmp(const SSL_SESSION *a, const SSL_SESSION *b) {
219 if (a->ssl_version != b->ssl_version) {
220 return 1;
Adam Langleyfcf25832014-12-18 17:42:32 -0800221 }
Adam Langley95c29f32014-06-20 12:00:00 -0700222
David Benjamin27bbae42015-09-13 00:54:37 -0400223 if (a->session_id_length != b->session_id_length) {
224 return 1;
Adam Langleyfcf25832014-12-18 17:42:32 -0800225 }
Adam Langley95c29f32014-06-20 12:00:00 -0700226
David Benjamin17cf2cb2016-12-13 01:07:13 -0500227 return OPENSSL_memcmp(a->session_id, b->session_id, a->session_id_length);
David Benjamin27bbae42015-09-13 00:54:37 -0400228}
Adam Langley95c29f32014-06-20 12:00:00 -0700229
David Benjamin27bbae42015-09-13 00:54:37 -0400230SSL_CTX *SSL_CTX_new(const SSL_METHOD *method) {
231 SSL_CTX *ret = NULL;
232
233 if (method == NULL) {
234 OPENSSL_PUT_ERROR(SSL, SSL_R_NULL_SSL_METHOD_PASSED);
235 return NULL;
Adam Langleyfcf25832014-12-18 17:42:32 -0800236 }
Adam Langley95c29f32014-06-20 12:00:00 -0700237
David Benjamin27bbae42015-09-13 00:54:37 -0400238 if (SSL_get_ex_data_X509_STORE_CTX_idx() < 0) {
239 OPENSSL_PUT_ERROR(SSL, SSL_R_X509_VERIFICATION_SETUP_PROBLEMS);
240 goto err;
David Benjamin62fd1622015-01-11 13:30:01 -0500241 }
242
Brian Smith5ba06892016-02-07 09:36:04 -1000243 ret = OPENSSL_malloc(sizeof(SSL_CTX));
David Benjamin27bbae42015-09-13 00:54:37 -0400244 if (ret == NULL) {
245 goto err;
David Benjamin62fd1622015-01-11 13:30:01 -0500246 }
247
David Benjamin17cf2cb2016-12-13 01:07:13 -0500248 OPENSSL_memset(ret, 0, sizeof(SSL_CTX));
Adam Langley95c29f32014-06-20 12:00:00 -0700249
David Benjamin27bbae42015-09-13 00:54:37 -0400250 ret->method = method->method;
Adam Langley3509dac2017-02-01 11:59:18 -0800251 ret->x509_method = method->x509_method;
David Benjamin27bbae42015-09-13 00:54:37 -0400252
253 CRYPTO_MUTEX_init(&ret->lock);
254
255 ret->session_cache_mode = SSL_SESS_CACHE_SERVER;
256 ret->session_cache_size = SSL_SESSION_CACHE_MAX_SIZE_DEFAULT;
257
David Benjamin27bbae42015-09-13 00:54:37 -0400258 ret->session_timeout = SSL_DEFAULT_SESSION_TIMEOUT;
David Benjamin17b30832017-01-28 14:00:32 -0500259 ret->session_psk_dhe_timeout = SSL_DEFAULT_SESSION_PSK_DHE_TIMEOUT;
David Benjamin27bbae42015-09-13 00:54:37 -0400260
261 ret->references = 1;
262
263 ret->max_cert_list = SSL_MAX_CERT_LIST_DEFAULT;
264 ret->verify_mode = SSL_VERIFY_NONE;
Adam Langley3509dac2017-02-01 11:59:18 -0800265 ret->cert = ssl_cert_new(method->x509_method);
David Benjamin27bbae42015-09-13 00:54:37 -0400266 if (ret->cert == NULL) {
267 goto err;
268 }
269
270 ret->sessions = lh_SSL_SESSION_new(ssl_session_hash, ssl_session_cmp);
271 if (ret->sessions == NULL) {
272 goto err;
273 }
274 ret->cert_store = X509_STORE_new();
275 if (ret->cert_store == NULL) {
276 goto err;
277 }
278
279 ssl_create_cipher_list(ret->method, &ret->cipher_list,
David Benjamind2cb1c12016-11-02 17:49:09 -0400280 SSL_DEFAULT_CIPHER_LIST);
David Benjamin27bbae42015-09-13 00:54:37 -0400281 if (ret->cipher_list == NULL ||
282 sk_SSL_CIPHER_num(ret->cipher_list->ciphers) <= 0) {
283 OPENSSL_PUT_ERROR(SSL, SSL_R_LIBRARY_HAS_NO_CIPHERS);
284 goto err2;
285 }
286
287 ret->param = X509_VERIFY_PARAM_new();
288 if (!ret->param) {
289 goto err;
290 }
291
292 ret->client_CA = sk_X509_NAME_new_null();
293 if (ret->client_CA == NULL) {
294 goto err;
295 }
296
David Benjamin8a589332015-12-04 23:14:35 -0500297 CRYPTO_new_ex_data(&ret->ex_data);
David Benjamin27bbae42015-09-13 00:54:37 -0400298
299 ret->max_send_fragment = SSL3_RT_MAX_PLAIN_LENGTH;
300
301 /* Setup RFC4507 ticket keys */
302 if (!RAND_bytes(ret->tlsext_tick_key_name, 16) ||
303 !RAND_bytes(ret->tlsext_tick_hmac_key, 16) ||
304 !RAND_bytes(ret->tlsext_tick_aes_key, 16)) {
305 ret->options |= SSL_OP_NO_TICKET;
306 }
307
David Benjamina983b4c2016-11-09 14:21:12 -0500308 /* Disable the auto-chaining feature by default. Once this has stuck without
309 * problems, the feature will be removed entirely. */
310 ret->mode = SSL_MODE_NO_AUTO_CHAIN;
311
David Benjamin27bbae42015-09-13 00:54:37 -0400312 /* Lock the SSL_CTX to the specified version, for compatibility with legacy
313 * uses of SSL_METHOD. */
David Benjamine34bcc92016-09-21 16:53:09 -0400314 if (!SSL_CTX_set_max_proto_version(ret, method->version) ||
315 !SSL_CTX_set_min_proto_version(ret, method->version)) {
316 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
317 goto err2;
David Benjamin27bbae42015-09-13 00:54:37 -0400318 }
319
320 return ret;
321
322err:
323 OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
324err2:
325 SSL_CTX_free(ret);
326 return NULL;
327}
328
Adam Langley84cd1592016-06-30 18:29:44 -0700329int SSL_CTX_up_ref(SSL_CTX *ctx) {
330 CRYPTO_refcount_inc(&ctx->references);
331 return 1;
332}
333
David Benjamin27bbae42015-09-13 00:54:37 -0400334void SSL_CTX_free(SSL_CTX *ctx) {
335 if (ctx == NULL ||
336 !CRYPTO_refcount_dec_and_test_zero(&ctx->references)) {
337 return;
338 }
339
340 X509_VERIFY_PARAM_free(ctx->param);
341
342 /* Free internal session cache. However: the remove_cb() may reference the
343 * ex_data of SSL_CTX, thus the ex_data store can only be removed after the
344 * sessions were flushed. As the ex_data handling routines might also touch
345 * the session cache, the most secure solution seems to be: empty (flush) the
346 * cache, then free ex_data, then finally free the cache. (See ticket
347 * [openssl.org #212].) */
348 SSL_CTX_flush_sessions(ctx, 0);
349
350 CRYPTO_free_ex_data(&g_ex_data_class_ssl_ctx, ctx, &ctx->ex_data);
351
352 CRYPTO_MUTEX_cleanup(&ctx->lock);
353 lh_SSL_SESSION_free(ctx->sessions);
354 X509_STORE_free(ctx->cert_store);
355 ssl_cipher_preference_list_free(ctx->cipher_list);
David Benjamin27bbae42015-09-13 00:54:37 -0400356 ssl_cert_free(ctx->cert);
357 sk_SSL_CUSTOM_EXTENSION_pop_free(ctx->client_custom_extensions,
358 SSL_CUSTOM_EXTENSION_free);
359 sk_SSL_CUSTOM_EXTENSION_pop_free(ctx->server_custom_extensions,
360 SSL_CUSTOM_EXTENSION_free);
361 sk_X509_NAME_pop_free(ctx->client_CA, X509_NAME_free);
362 sk_SRTP_PROTECTION_PROFILE_free(ctx->srtp_profiles);
363 OPENSSL_free(ctx->psk_identity_hint);
Steven Valdezce902a92016-05-17 11:47:53 -0400364 OPENSSL_free(ctx->supported_group_list);
David Benjamin27bbae42015-09-13 00:54:37 -0400365 OPENSSL_free(ctx->alpn_client_proto_list);
David Benjamin27bbae42015-09-13 00:54:37 -0400366 EVP_PKEY_free(ctx->tlsext_channel_id_private);
David Benjamin27bbae42015-09-13 00:54:37 -0400367
368 OPENSSL_free(ctx);
Adam Langleyfcf25832014-12-18 17:42:32 -0800369}
Adam Langley95c29f32014-06-20 12:00:00 -0700370
Adam Langleyfcf25832014-12-18 17:42:32 -0800371SSL *SSL_new(SSL_CTX *ctx) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800372 if (ctx == NULL) {
David Benjamin3570d732015-06-29 00:28:17 -0400373 OPENSSL_PUT_ERROR(SSL, SSL_R_NULL_SSL_CTX);
Adam Langleyfcf25832014-12-18 17:42:32 -0800374 return NULL;
375 }
376 if (ctx->method == NULL) {
David Benjamin3570d732015-06-29 00:28:17 -0400377 OPENSSL_PUT_ERROR(SSL, SSL_R_SSL_CTX_HAS_NO_DEFAULT_SSL_VERSION);
Adam Langleyfcf25832014-12-18 17:42:32 -0800378 return NULL;
379 }
Adam Langley95c29f32014-06-20 12:00:00 -0700380
Brian Smith5ba06892016-02-07 09:36:04 -1000381 SSL *ssl = OPENSSL_malloc(sizeof(SSL));
David Benjamin0d56f882015-12-19 17:05:56 -0500382 if (ssl == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800383 goto err;
384 }
David Benjamin17cf2cb2016-12-13 01:07:13 -0500385 OPENSSL_memset(ssl, 0, sizeof(SSL));
Adam Langley95c29f32014-06-20 12:00:00 -0700386
David Benjamin0d56f882015-12-19 17:05:56 -0500387 ssl->min_version = ctx->min_version;
388 ssl->max_version = ctx->max_version;
David Benjamin1eb367c2014-12-12 18:17:51 -0500389
Taylor Brandstetter376a0fe2016-05-10 19:30:28 -0700390 /* RFC 6347 states that implementations SHOULD use an initial timer value of
391 * 1 second. */
392 ssl->initial_timeout_duration_ms = 1000;
393
David Benjamin0d56f882015-12-19 17:05:56 -0500394 ssl->options = ctx->options;
395 ssl->mode = ctx->mode;
396 ssl->max_cert_list = ctx->max_cert_list;
Adam Langley95c29f32014-06-20 12:00:00 -0700397
David Benjamin0d56f882015-12-19 17:05:56 -0500398 ssl->cert = ssl_cert_dup(ctx->cert);
399 if (ssl->cert == NULL) {
David Benjamina5a3eeb2015-03-18 20:26:30 -0400400 goto err;
Adam Langleyfcf25832014-12-18 17:42:32 -0800401 }
Adam Langley95c29f32014-06-20 12:00:00 -0700402
David Benjamin0d56f882015-12-19 17:05:56 -0500403 ssl->msg_callback = ctx->msg_callback;
404 ssl->msg_callback_arg = ctx->msg_callback_arg;
405 ssl->verify_mode = ctx->verify_mode;
David Benjamin0d56f882015-12-19 17:05:56 -0500406 ssl->verify_callback = ctx->default_verify_callback;
David Benjaminbbaf3672016-11-17 10:53:09 +0900407 ssl->retain_only_sha256_of_client_certs =
408 ctx->retain_only_sha256_of_client_certs;
Adam Langley95c29f32014-06-20 12:00:00 -0700409
David Benjamin0d56f882015-12-19 17:05:56 -0500410 ssl->param = X509_VERIFY_PARAM_new();
411 if (!ssl->param) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800412 goto err;
413 }
David Benjamin0d56f882015-12-19 17:05:56 -0500414 X509_VERIFY_PARAM_inherit(ssl->param, ctx->param);
415 ssl->quiet_shutdown = ctx->quiet_shutdown;
416 ssl->max_send_fragment = ctx->max_send_fragment;
Adam Langley95c29f32014-06-20 12:00:00 -0700417
David Benjaminf650c712016-12-22 15:54:51 -0500418 SSL_CTX_up_ref(ctx);
David Benjamin0d56f882015-12-19 17:05:56 -0500419 ssl->ctx = ctx;
David Benjaminf650c712016-12-22 15:54:51 -0500420 SSL_CTX_up_ref(ctx);
David Benjamin0d56f882015-12-19 17:05:56 -0500421 ssl->initial_ctx = ctx;
Adam Langley95c29f32014-06-20 12:00:00 -0700422
Steven Valdezce902a92016-05-17 11:47:53 -0400423 if (ctx->supported_group_list) {
David Benjamin17b30832017-01-28 14:00:32 -0500424 ssl->supported_group_list = BUF_memdup(ctx->supported_group_list,
425 ctx->supported_group_list_len * 2);
Steven Valdezce902a92016-05-17 11:47:53 -0400426 if (!ssl->supported_group_list) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800427 goto err;
428 }
Steven Valdezce902a92016-05-17 11:47:53 -0400429 ssl->supported_group_list_len = ctx->supported_group_list_len;
Adam Langleyfcf25832014-12-18 17:42:32 -0800430 }
Adam Langley95c29f32014-06-20 12:00:00 -0700431
David Benjamin17b30832017-01-28 14:00:32 -0500432 if (ctx->alpn_client_proto_list) {
433 ssl->alpn_client_proto_list = BUF_memdup(ctx->alpn_client_proto_list,
434 ctx->alpn_client_proto_list_len);
David Benjamin0d56f882015-12-19 17:05:56 -0500435 if (ssl->alpn_client_proto_list == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800436 goto err;
437 }
David Benjamin17b30832017-01-28 14:00:32 -0500438 ssl->alpn_client_proto_list_len = ctx->alpn_client_proto_list_len;
Adam Langleyfcf25832014-12-18 17:42:32 -0800439 }
Adam Langley95c29f32014-06-20 12:00:00 -0700440
David Benjamin0d56f882015-12-19 17:05:56 -0500441 ssl->method = ctx->method;
Adam Langley95c29f32014-06-20 12:00:00 -0700442
David Benjamin0d56f882015-12-19 17:05:56 -0500443 if (!ssl->method->ssl_new(ssl)) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800444 goto err;
445 }
Adam Langley95c29f32014-06-20 12:00:00 -0700446
David Benjamin0d56f882015-12-19 17:05:56 -0500447 ssl->rwstate = SSL_NOTHING;
Adam Langley95c29f32014-06-20 12:00:00 -0700448
David Benjamin0d56f882015-12-19 17:05:56 -0500449 CRYPTO_new_ex_data(&ssl->ex_data);
Adam Langley95c29f32014-06-20 12:00:00 -0700450
David Benjamin0d56f882015-12-19 17:05:56 -0500451 ssl->psk_identity_hint = NULL;
Adam Langleyfcf25832014-12-18 17:42:32 -0800452 if (ctx->psk_identity_hint) {
David Benjamin0d56f882015-12-19 17:05:56 -0500453 ssl->psk_identity_hint = BUF_strdup(ctx->psk_identity_hint);
454 if (ssl->psk_identity_hint == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800455 goto err;
456 }
457 }
David Benjamin0d56f882015-12-19 17:05:56 -0500458 ssl->psk_client_callback = ctx->psk_client_callback;
459 ssl->psk_server_callback = ctx->psk_server_callback;
Adam Langley95c29f32014-06-20 12:00:00 -0700460
David Benjamin0d56f882015-12-19 17:05:56 -0500461 ssl->tlsext_channel_id_enabled = ctx->tlsext_channel_id_enabled;
David Benjamin02ddbfd2015-01-11 13:09:11 -0500462 if (ctx->tlsext_channel_id_private) {
Adam Langley310d3f62016-07-12 10:39:20 -0700463 EVP_PKEY_up_ref(ctx->tlsext_channel_id_private);
464 ssl->tlsext_channel_id_private = ctx->tlsext_channel_id_private;
David Benjamin02ddbfd2015-01-11 13:09:11 -0500465 }
466
David Benjamin17b30832017-01-28 14:00:32 -0500467 ssl->signed_cert_timestamps_enabled = ctx->signed_cert_timestamps_enabled;
468 ssl->ocsp_stapling_enabled = ctx->ocsp_stapling_enabled;
HÃ¥vard Molland9169c962014-08-14 14:42:37 +0200469
David Benjamin0d56f882015-12-19 17:05:56 -0500470 return ssl;
Adam Langleyfcf25832014-12-18 17:42:32 -0800471
Adam Langley95c29f32014-06-20 12:00:00 -0700472err:
David Benjamin0d56f882015-12-19 17:05:56 -0500473 SSL_free(ssl);
David Benjamin3570d732015-06-29 00:28:17 -0400474 OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
Adam Langley95c29f32014-06-20 12:00:00 -0700475
Adam Langleyfcf25832014-12-18 17:42:32 -0800476 return NULL;
477}
Adam Langley95c29f32014-06-20 12:00:00 -0700478
David Benjamin27bbae42015-09-13 00:54:37 -0400479void SSL_free(SSL *ssl) {
480 if (ssl == NULL) {
481 return;
482 }
483
484 X509_VERIFY_PARAM_free(ssl->param);
485
486 CRYPTO_free_ex_data(&g_ex_data_class_ssl, ssl, &ssl->ex_data);
487
David Benjamin27bbae42015-09-13 00:54:37 -0400488 BIO_free_all(ssl->rbio);
David Benjaminf715c422016-06-11 19:01:56 -0400489 BIO_free_all(ssl->wbio);
David Benjamin27bbae42015-09-13 00:54:37 -0400490
491 BUF_MEM_free(ssl->init_buf);
492
493 /* add extra stuff */
494 ssl_cipher_preference_list_free(ssl->cipher_list);
David Benjamin27bbae42015-09-13 00:54:37 -0400495
David Benjamin27bbae42015-09-13 00:54:37 -0400496 SSL_SESSION_free(ssl->session);
497
David Benjamin27bbae42015-09-13 00:54:37 -0400498 ssl_cert_free(ssl->cert);
499
500 OPENSSL_free(ssl->tlsext_hostname);
501 SSL_CTX_free(ssl->initial_ctx);
Steven Valdezce902a92016-05-17 11:47:53 -0400502 OPENSSL_free(ssl->supported_group_list);
David Benjamin27bbae42015-09-13 00:54:37 -0400503 OPENSSL_free(ssl->alpn_client_proto_list);
504 EVP_PKEY_free(ssl->tlsext_channel_id_private);
505 OPENSSL_free(ssl->psk_identity_hint);
506 sk_X509_NAME_pop_free(ssl->client_CA, X509_NAME_free);
David Benjamin27bbae42015-09-13 00:54:37 -0400507 sk_SRTP_PROTECTION_PROFILE_free(ssl->srtp_profiles);
508
509 if (ssl->method != NULL) {
510 ssl->method->ssl_free(ssl);
511 }
512 SSL_CTX_free(ssl->ctx);
513
514 OPENSSL_free(ssl);
515}
516
517void SSL_set_connect_state(SSL *ssl) {
518 ssl->server = 0;
David Benjamin9f1dc822016-06-07 17:03:46 -0400519 ssl->handshake_func = ssl3_connect;
David Benjamin27bbae42015-09-13 00:54:37 -0400520}
521
522void SSL_set_accept_state(SSL *ssl) {
523 ssl->server = 1;
David Benjamin9f1dc822016-06-07 17:03:46 -0400524 ssl->handshake_func = ssl3_accept;
David Benjamin27bbae42015-09-13 00:54:37 -0400525}
526
David Benjamin4501bd52016-08-01 13:39:41 -0400527void SSL_set0_rbio(SSL *ssl, BIO *rbio) {
David Benjaminf715c422016-06-11 19:01:56 -0400528 BIO_free_all(ssl->rbio);
529 ssl->rbio = rbio;
530}
531
David Benjamin4501bd52016-08-01 13:39:41 -0400532void SSL_set0_wbio(SSL *ssl, BIO *wbio) {
David Benjaminf715c422016-06-11 19:01:56 -0400533 BIO_free_all(ssl->wbio);
David Benjamin27bbae42015-09-13 00:54:37 -0400534 ssl->wbio = wbio;
535}
536
David Benjaminf715c422016-06-11 19:01:56 -0400537void SSL_set_bio(SSL *ssl, BIO *rbio, BIO *wbio) {
538 /* For historical reasons, this function has many different cases in ownership
539 * handling. */
540
David Benjamin4501bd52016-08-01 13:39:41 -0400541 /* If nothing has changed, do nothing */
542 if (rbio == SSL_get_rbio(ssl) && wbio == SSL_get_wbio(ssl)) {
543 return;
544 }
545
David Benjaminf715c422016-06-11 19:01:56 -0400546 /* If the two arguments are equal, one fewer reference is granted than
547 * taken. */
548 if (rbio != NULL && rbio == wbio) {
549 BIO_up_ref(rbio);
550 }
551
David Benjamin4501bd52016-08-01 13:39:41 -0400552 /* If only the wbio is changed, adopt only one reference. */
David Benjaminf715c422016-06-11 19:01:56 -0400553 if (rbio == SSL_get_rbio(ssl)) {
David Benjamin4501bd52016-08-01 13:39:41 -0400554 SSL_set0_wbio(ssl, wbio);
David Benjaminf715c422016-06-11 19:01:56 -0400555 return;
556 }
David Benjamin4501bd52016-08-01 13:39:41 -0400557
558 /* There is an asymmetry here for historical reasons. If only the rbio is
559 * changed AND the rbio and wbio were originally different, then we only adopt
560 * one reference. */
561 if (wbio == SSL_get_wbio(ssl) && SSL_get_rbio(ssl) != SSL_get_wbio(ssl)) {
562 SSL_set0_rbio(ssl, rbio);
David Benjaminf715c422016-06-11 19:01:56 -0400563 return;
564 }
565
566 /* Otherwise, adopt both references. */
David Benjamin4501bd52016-08-01 13:39:41 -0400567 SSL_set0_rbio(ssl, rbio);
568 SSL_set0_wbio(ssl, wbio);
David Benjaminf715c422016-06-11 19:01:56 -0400569}
570
David Benjamin27bbae42015-09-13 00:54:37 -0400571BIO *SSL_get_rbio(const SSL *ssl) { return ssl->rbio; }
572
David Benjamindaf207a2017-01-03 18:37:41 -0500573BIO *SSL_get_wbio(const SSL *ssl) { return ssl->wbio; }
David Benjamin27bbae42015-09-13 00:54:37 -0400574
David Benjamin2be4aa72017-01-02 07:56:51 -0500575void ssl_reset_error_state(SSL *ssl) {
576 /* Functions which use |SSL_get_error| must reset I/O and error state on
577 * entry. */
David Benjamin4c5ddb82016-03-11 22:56:19 -0500578 ssl->rwstate = SSL_NOTHING;
David Benjamin15c14882016-03-14 14:25:46 -0400579 ERR_clear_error();
David Benjamin0d275bd2016-06-01 20:19:34 -0400580 ERR_clear_system_error();
David Benjamin2be4aa72017-01-02 07:56:51 -0500581}
582
583int SSL_do_handshake(SSL *ssl) {
584 ssl_reset_error_state(ssl);
David Benjamin15c14882016-03-14 14:25:46 -0400585
David Benjamin27bbae42015-09-13 00:54:37 -0400586 if (ssl->handshake_func == NULL) {
587 OPENSSL_PUT_ERROR(SSL, SSL_R_CONNECTION_TYPE_NOT_SET);
588 return -1;
589 }
590
591 if (!SSL_in_init(ssl)) {
592 return 1;
593 }
594
David Benjamin2644a132016-12-11 13:41:17 -0500595 if (ssl->s3->hs == NULL) {
596 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
597 return -1;
David Benjamince8c9d22016-11-14 10:45:16 +0900598 }
599
600 /* Run the handshake. */
601 assert(ssl->s3->hs != NULL);
602 int ret = ssl->handshake_func(ssl->s3->hs);
603 if (ret <= 0) {
604 return ret;
605 }
606
607 /* Destroy the handshake object if the handshake has completely finished. */
608 if (!SSL_in_init(ssl)) {
609 ssl_handshake_free(ssl->s3->hs);
610 ssl->s3->hs = NULL;
611 }
612
613 return 1;
David Benjamin27bbae42015-09-13 00:54:37 -0400614}
615
616int SSL_connect(SSL *ssl) {
David Benjaminb2a73182016-03-10 01:25:26 -0500617 if (ssl->handshake_func == NULL) {
David Benjamin27bbae42015-09-13 00:54:37 -0400618 /* Not properly initialized yet */
619 SSL_set_connect_state(ssl);
620 }
621
David Benjamin15c14882016-03-14 14:25:46 -0400622 return SSL_do_handshake(ssl);
David Benjamin27bbae42015-09-13 00:54:37 -0400623}
624
625int SSL_accept(SSL *ssl) {
David Benjaminb2a73182016-03-10 01:25:26 -0500626 if (ssl->handshake_func == NULL) {
David Benjamin27bbae42015-09-13 00:54:37 -0400627 /* Not properly initialized yet */
628 SSL_set_accept_state(ssl);
629 }
630
David Benjamin15c14882016-03-14 14:25:46 -0400631 return SSL_do_handshake(ssl);
David Benjamin27bbae42015-09-13 00:54:37 -0400632}
633
David Benjamin163f29a2016-07-28 11:05:58 -0400634static int ssl_do_renegotiate(SSL *ssl) {
David Benjamin34941c02016-10-08 11:45:31 -0400635 /* We do not accept renegotiations as a server or SSL 3.0. SSL 3.0 will be
636 * removed entirely in the future and requires retaining more data for
637 * renegotiation_info. */
638 if (ssl->server || ssl->version == SSL3_VERSION) {
David Benjamin163f29a2016-07-28 11:05:58 -0400639 goto no_renegotiation;
640 }
641
642 if (ssl->s3->tmp.message_type != SSL3_MT_HELLO_REQUEST ||
643 ssl->init_num != 0) {
644 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_DECODE_ERROR);
645 OPENSSL_PUT_ERROR(SSL, SSL_R_BAD_HELLO_REQUEST);
646 return 0;
647 }
648
649 switch (ssl->renegotiate_mode) {
650 case ssl_renegotiate_ignore:
651 /* Ignore the HelloRequest. */
652 return 1;
653
654 case ssl_renegotiate_once:
655 if (ssl->s3->total_renegotiations != 0) {
656 goto no_renegotiation;
657 }
658 break;
659
660 case ssl_renegotiate_never:
661 goto no_renegotiation;
662
663 case ssl_renegotiate_freely:
664 break;
665 }
666
667 /* Renegotiation is only supported at quiescent points in the application
668 * protocol, namely in HTTPS, just before reading the HTTP response. Require
669 * the record-layer be idle and avoid complexities of sending a handshake
670 * record while an application_data record is being written. */
671 if (ssl_write_buffer_is_pending(ssl)) {
672 goto no_renegotiation;
673 }
674
675 /* Begin a new handshake. */
David Benjamin2644a132016-12-11 13:41:17 -0500676 if (ssl->s3->hs != NULL) {
677 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
678 return 0;
679 }
680 ssl->s3->hs = ssl_handshake_new(ssl);
681 if (ssl->s3->hs == NULL) {
682 return 0;
683 }
684
David Benjamin163f29a2016-07-28 11:05:58 -0400685 ssl->s3->total_renegotiations++;
David Benjamin163f29a2016-07-28 11:05:58 -0400686 return 1;
687
688no_renegotiation:
689 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_NO_RENEGOTIATION);
690 OPENSSL_PUT_ERROR(SSL, SSL_R_NO_RENEGOTIATION);
691 return 0;
692}
693
694static int ssl_do_post_handshake(SSL *ssl) {
695 if (ssl3_protocol_version(ssl) < TLS1_3_VERSION) {
696 return ssl_do_renegotiate(ssl);
697 }
698
Steven Valdez8e1c7be2016-07-26 12:39:22 -0400699 return tls13_post_handshake(ssl);
David Benjamin163f29a2016-07-28 11:05:58 -0400700}
701
David Benjamin15c14882016-03-14 14:25:46 -0400702static int ssl_read_impl(SSL *ssl, void *buf, int num, int peek) {
David Benjamin2be4aa72017-01-02 07:56:51 -0500703 ssl_reset_error_state(ssl);
David Benjamin15c14882016-03-14 14:25:46 -0400704
David Benjaminb2a73182016-03-10 01:25:26 -0500705 if (ssl->handshake_func == NULL) {
David Benjamin27bbae42015-09-13 00:54:37 -0400706 OPENSSL_PUT_ERROR(SSL, SSL_R_UNINITIALIZED);
707 return -1;
708 }
709
David Benjamin163f29a2016-07-28 11:05:58 -0400710 for (;;) {
711 /* Complete the current handshake, if any. False Start will cause
712 * |SSL_do_handshake| to return mid-handshake, so this may require multiple
713 * iterations. */
714 while (SSL_in_init(ssl)) {
715 int ret = SSL_do_handshake(ssl);
716 if (ret < 0) {
717 return ret;
718 }
719 if (ret == 0) {
720 OPENSSL_PUT_ERROR(SSL, SSL_R_SSL_HANDSHAKE_FAILURE);
721 return -1;
722 }
723 }
724
725 int got_handshake;
726 int ret = ssl->method->read_app_data(ssl, &got_handshake, buf, num, peek);
727 if (ret > 0 || !got_handshake) {
Steven Valdez32635b82016-08-16 11:25:03 -0400728 ssl->s3->key_update_count = 0;
David Benjaminc79845c2016-03-10 01:28:00 -0500729 return ret;
730 }
David Benjamin163f29a2016-07-28 11:05:58 -0400731
732 /* Handle the post-handshake message and try again. */
733 if (!ssl_do_post_handshake(ssl)) {
David Benjaminc79845c2016-03-10 01:28:00 -0500734 return -1;
735 }
David Benjamin163f29a2016-07-28 11:05:58 -0400736 ssl->method->release_current_message(ssl, 1 /* free buffer */);
David Benjaminc79845c2016-03-10 01:28:00 -0500737 }
David Benjamin15c14882016-03-14 14:25:46 -0400738}
739
740int SSL_read(SSL *ssl, void *buf, int num) {
741 return ssl_read_impl(ssl, buf, num, 0 /* consume bytes */);
David Benjamin27bbae42015-09-13 00:54:37 -0400742}
743
744int SSL_peek(SSL *ssl, void *buf, int num) {
David Benjamin15c14882016-03-14 14:25:46 -0400745 return ssl_read_impl(ssl, buf, num, 1 /* peek */);
David Benjamin27bbae42015-09-13 00:54:37 -0400746}
747
748int SSL_write(SSL *ssl, const void *buf, int num) {
David Benjamin2be4aa72017-01-02 07:56:51 -0500749 ssl_reset_error_state(ssl);
David Benjamin15c14882016-03-14 14:25:46 -0400750
David Benjaminb2a73182016-03-10 01:25:26 -0500751 if (ssl->handshake_func == NULL) {
David Benjamin27bbae42015-09-13 00:54:37 -0400752 OPENSSL_PUT_ERROR(SSL, SSL_R_UNINITIALIZED);
753 return -1;
754 }
755
David Benjaminfa214e42016-05-10 17:03:10 -0400756 if (ssl->s3->send_shutdown != ssl_shutdown_none) {
David Benjamin27bbae42015-09-13 00:54:37 -0400757 OPENSSL_PUT_ERROR(SSL, SSL_R_PROTOCOL_IS_SHUTDOWN);
758 return -1;
759 }
760
David Benjamind7ac1432016-03-10 00:41:25 -0500761 /* If necessary, complete the handshake implicitly. */
762 if (SSL_in_init(ssl) && !SSL_in_false_start(ssl)) {
763 int ret = SSL_do_handshake(ssl);
764 if (ret < 0) {
765 return ret;
766 }
767 if (ret == 0) {
768 OPENSSL_PUT_ERROR(SSL, SSL_R_SSL_HANDSHAKE_FAILURE);
769 return -1;
770 }
771 }
772
David Benjaminf0ee9072016-06-15 17:44:37 -0400773 return ssl->method->write_app_data(ssl, buf, num);
David Benjamin27bbae42015-09-13 00:54:37 -0400774}
775
776int SSL_shutdown(SSL *ssl) {
David Benjamin2be4aa72017-01-02 07:56:51 -0500777 ssl_reset_error_state(ssl);
David Benjamin15c14882016-03-14 14:25:46 -0400778
David Benjaminb2a73182016-03-10 01:25:26 -0500779 if (ssl->handshake_func == NULL) {
David Benjamin27bbae42015-09-13 00:54:37 -0400780 OPENSSL_PUT_ERROR(SSL, SSL_R_UNINITIALIZED);
781 return -1;
782 }
783
Steven Valdeza14934f2016-02-29 10:05:08 -0500784 /* We can't shutdown properly if we are in the middle of a handshake. */
785 if (SSL_in_init(ssl)) {
786 OPENSSL_PUT_ERROR(SSL, SSL_R_SHUTDOWN_WHILE_IN_INIT);
787 return -1;
788 }
789
David Benjamin27bbae42015-09-13 00:54:37 -0400790 if (ssl->quiet_shutdown) {
David Benjaminfa214e42016-05-10 17:03:10 -0400791 /* Do nothing if configured not to send a close_notify. */
792 ssl->s3->send_shutdown = ssl_shutdown_close_notify;
793 ssl->s3->recv_shutdown = ssl_shutdown_close_notify;
David Benjamin27bbae42015-09-13 00:54:37 -0400794 return 1;
795 }
796
David Benjaminfa214e42016-05-10 17:03:10 -0400797 /* This function completes in two stages. It sends a close_notify and then it
798 * waits for a close_notify to come in. Perform exactly one action and return
799 * whether or not it succeeds. */
David Benjamin27bbae42015-09-13 00:54:37 -0400800
David Benjaminfa214e42016-05-10 17:03:10 -0400801 if (ssl->s3->send_shutdown != ssl_shutdown_close_notify) {
802 /* Send a close_notify. */
803 if (ssl3_send_alert(ssl, SSL3_AL_WARNING, SSL_AD_CLOSE_NOTIFY) <= 0) {
804 return -1;
David Benjamin27bbae42015-09-13 00:54:37 -0400805 }
806 } else if (ssl->s3->alert_dispatch) {
David Benjaminfa214e42016-05-10 17:03:10 -0400807 /* Finish sending the close_notify. */
David Benjaminf0ee9072016-06-15 17:44:37 -0400808 if (ssl->method->dispatch_alert(ssl) <= 0) {
David Benjaminfa214e42016-05-10 17:03:10 -0400809 return -1;
David Benjamin27bbae42015-09-13 00:54:37 -0400810 }
David Benjaminfa214e42016-05-10 17:03:10 -0400811 } else if (ssl->s3->recv_shutdown != ssl_shutdown_close_notify) {
812 /* Wait for the peer's close_notify. */
David Benjaminf0ee9072016-06-15 17:44:37 -0400813 ssl->method->read_close_notify(ssl);
David Benjaminfa214e42016-05-10 17:03:10 -0400814 if (ssl->s3->recv_shutdown != ssl_shutdown_close_notify) {
815 return -1;
David Benjamin27bbae42015-09-13 00:54:37 -0400816 }
817 }
818
David Benjaminfa214e42016-05-10 17:03:10 -0400819 /* Return 0 for unidirectional shutdown and 1 for bidirectional shutdown. */
820 return ssl->s3->recv_shutdown == ssl_shutdown_close_notify;
David Benjamin27bbae42015-09-13 00:54:37 -0400821}
822
David Benjamin1d4f4c02016-07-26 18:03:08 -0400823int SSL_send_fatal_alert(SSL *ssl, uint8_t alert) {
824 if (ssl->s3->alert_dispatch) {
825 if (ssl->s3->send_alert[0] != SSL3_AL_FATAL ||
826 ssl->s3->send_alert[1] != alert) {
827 /* We are already attempting to write a different alert. */
828 OPENSSL_PUT_ERROR(SSL, SSL_R_PROTOCOL_IS_SHUTDOWN);
829 return -1;
830 }
831 return ssl->method->dispatch_alert(ssl);
832 }
833
834 return ssl3_send_alert(ssl, SSL3_AL_FATAL, alert);
835}
836
Steven Valdez08b65f42016-12-07 15:29:45 -0500837void SSL_CTX_set_early_data_enabled(SSL_CTX *ctx, int enabled) {
838 ctx->enable_early_data = !!enabled;
839}
840
David Benjamin287fc4f2016-12-10 15:12:03 -0500841static int bio_retry_reason_to_error(int reason) {
842 switch (reason) {
843 case BIO_RR_CONNECT:
844 return SSL_ERROR_WANT_CONNECT;
845 case BIO_RR_ACCEPT:
846 return SSL_ERROR_WANT_ACCEPT;
847 default:
848 return SSL_ERROR_SYSCALL;
849 }
850}
David Benjamin27bbae42015-09-13 00:54:37 -0400851
David Benjamin287fc4f2016-12-10 15:12:03 -0500852int SSL_get_error(const SSL *ssl, int ret_code) {
David Benjamin27bbae42015-09-13 00:54:37 -0400853 if (ret_code > 0) {
854 return SSL_ERROR_NONE;
855 }
856
857 /* Make things return SSL_ERROR_SYSCALL when doing SSL_do_handshake etc,
858 * where we do encode the error */
David Benjamin287fc4f2016-12-10 15:12:03 -0500859 uint32_t err = ERR_peek_error();
David Benjamin27bbae42015-09-13 00:54:37 -0400860 if (err != 0) {
861 if (ERR_GET_LIB(err) == ERR_LIB_SYS) {
862 return SSL_ERROR_SYSCALL;
863 }
864 return SSL_ERROR_SSL;
865 }
866
867 if (ret_code == 0) {
David Benjaminfa214e42016-05-10 17:03:10 -0400868 if (ssl->s3->recv_shutdown == ssl_shutdown_close_notify) {
David Benjamin27bbae42015-09-13 00:54:37 -0400869 return SSL_ERROR_ZERO_RETURN;
870 }
871 /* An EOF was observed which violates the protocol, and the underlying
872 * transport does not participate in the error queue. Bubble up to the
873 * caller. */
874 return SSL_ERROR_SYSCALL;
875 }
876
David Benjamin287fc4f2016-12-10 15:12:03 -0500877 switch (ssl->rwstate) {
878 case SSL_PENDING_SESSION:
879 return SSL_ERROR_PENDING_SESSION;
David Benjamin27bbae42015-09-13 00:54:37 -0400880
David Benjamin287fc4f2016-12-10 15:12:03 -0500881 case SSL_CERTIFICATE_SELECTION_PENDING:
882 return SSL_ERROR_PENDING_CERTIFICATE;
David Benjamin27bbae42015-09-13 00:54:37 -0400883
David Benjamin287fc4f2016-12-10 15:12:03 -0500884 case SSL_READING: {
885 BIO *bio = SSL_get_rbio(ssl);
886 if (BIO_should_read(bio)) {
887 return SSL_ERROR_WANT_READ;
David Benjamin27bbae42015-09-13 00:54:37 -0400888 }
889
David Benjamin287fc4f2016-12-10 15:12:03 -0500890 if (BIO_should_write(bio)) {
891 /* TODO(davidben): OpenSSL historically checked for writes on the read
892 * BIO. Can this be removed? */
893 return SSL_ERROR_WANT_WRITE;
David Benjamin27bbae42015-09-13 00:54:37 -0400894 }
895
David Benjamin287fc4f2016-12-10 15:12:03 -0500896 if (BIO_should_io_special(bio)) {
897 return bio_retry_reason_to_error(BIO_get_retry_reason(bio));
David Benjamin27bbae42015-09-13 00:54:37 -0400898 }
899
David Benjamin287fc4f2016-12-10 15:12:03 -0500900 break;
901 }
902
903 case SSL_WRITING: {
904 BIO *bio = SSL_get_wbio(ssl);
905 if (BIO_should_write(bio)) {
906 return SSL_ERROR_WANT_WRITE;
David Benjamin27bbae42015-09-13 00:54:37 -0400907 }
908
David Benjamin287fc4f2016-12-10 15:12:03 -0500909 if (BIO_should_read(bio)) {
910 /* TODO(davidben): OpenSSL historically checked for reads on the write
911 * BIO. Can this be removed? */
912 return SSL_ERROR_WANT_READ;
913 }
914
915 if (BIO_should_io_special(bio)) {
916 return bio_retry_reason_to_error(BIO_get_retry_reason(bio));
917 }
918
919 break;
David Benjamin27bbae42015-09-13 00:54:37 -0400920 }
David Benjamin27bbae42015-09-13 00:54:37 -0400921
David Benjamin287fc4f2016-12-10 15:12:03 -0500922 case SSL_X509_LOOKUP:
923 return SSL_ERROR_WANT_X509_LOOKUP;
David Benjamin27bbae42015-09-13 00:54:37 -0400924
David Benjamin287fc4f2016-12-10 15:12:03 -0500925 case SSL_CHANNEL_ID_LOOKUP:
926 return SSL_ERROR_WANT_CHANNEL_ID_LOOKUP;
David Benjamin27bbae42015-09-13 00:54:37 -0400927
David Benjamin287fc4f2016-12-10 15:12:03 -0500928 case SSL_PRIVATE_KEY_OPERATION:
929 return SSL_ERROR_WANT_PRIVATE_KEY_OPERATION;
David Benjamin27bbae42015-09-13 00:54:37 -0400930 }
931
932 return SSL_ERROR_SYSCALL;
933}
934
David Benjamine34bcc92016-09-21 16:53:09 -0400935static int set_min_version(const SSL_PROTOCOL_METHOD *method, uint16_t *out,
936 uint16_t version) {
937 if (version == 0) {
938 *out = method->min_version;
939 return 1;
940 }
941
Steven Valdezfdd10992016-09-15 16:27:05 -0400942 if (version == TLS1_3_VERSION) {
943 version = TLS1_3_DRAFT_VERSION;
944 }
945
David Benjamine34bcc92016-09-21 16:53:09 -0400946 return method->version_from_wire(out, version);
947}
948
949static int set_max_version(const SSL_PROTOCOL_METHOD *method, uint16_t *out,
950 uint16_t version) {
951 if (version == 0) {
952 *out = method->max_version;
953 /* TODO(svaldez): Enable TLS 1.3 by default once fully implemented. */
954 if (*out > TLS1_2_VERSION) {
955 *out = TLS1_2_VERSION;
956 }
957 return 1;
958 }
959
Steven Valdezfdd10992016-09-15 16:27:05 -0400960 if (version == TLS1_3_VERSION) {
961 version = TLS1_3_DRAFT_VERSION;
962 }
963
David Benjamine34bcc92016-09-21 16:53:09 -0400964 return method->version_from_wire(out, version);
965}
966
David Benjamine4706902016-09-20 15:12:23 -0400967int SSL_CTX_set_min_proto_version(SSL_CTX *ctx, uint16_t version) {
David Benjamine34bcc92016-09-21 16:53:09 -0400968 return set_min_version(ctx->method, &ctx->min_version, version);
David Benjamin27bbae42015-09-13 00:54:37 -0400969}
970
David Benjamine4706902016-09-20 15:12:23 -0400971int SSL_CTX_set_max_proto_version(SSL_CTX *ctx, uint16_t version) {
David Benjamine34bcc92016-09-21 16:53:09 -0400972 return set_max_version(ctx->method, &ctx->max_version, version);
David Benjamin27bbae42015-09-13 00:54:37 -0400973}
974
David Benjamine4706902016-09-20 15:12:23 -0400975int SSL_set_min_proto_version(SSL *ssl, uint16_t version) {
David Benjamine34bcc92016-09-21 16:53:09 -0400976 return set_min_version(ssl->method, &ssl->min_version, version);
David Benjamin27bbae42015-09-13 00:54:37 -0400977}
978
David Benjamine4706902016-09-20 15:12:23 -0400979int SSL_set_max_proto_version(SSL *ssl, uint16_t version) {
David Benjamine34bcc92016-09-21 16:53:09 -0400980 return set_max_version(ssl->method, &ssl->max_version, version);
David Benjamin27bbae42015-09-13 00:54:37 -0400981}
982
983uint32_t SSL_CTX_set_options(SSL_CTX *ctx, uint32_t options) {
984 ctx->options |= options;
985 return ctx->options;
986}
987
988uint32_t SSL_CTX_clear_options(SSL_CTX *ctx, uint32_t options) {
989 ctx->options &= ~options;
990 return ctx->options;
991}
992
993uint32_t SSL_CTX_get_options(const SSL_CTX *ctx) { return ctx->options; }
994
995uint32_t SSL_set_options(SSL *ssl, uint32_t options) {
996 ssl->options |= options;
997 return ssl->options;
998}
999
1000uint32_t SSL_clear_options(SSL *ssl, uint32_t options) {
1001 ssl->options &= ~options;
1002 return ssl->options;
1003}
1004
1005uint32_t SSL_get_options(const SSL *ssl) { return ssl->options; }
1006
1007uint32_t SSL_CTX_set_mode(SSL_CTX *ctx, uint32_t mode) {
1008 ctx->mode |= mode;
1009 return ctx->mode;
1010}
1011
1012uint32_t SSL_CTX_clear_mode(SSL_CTX *ctx, uint32_t mode) {
1013 ctx->mode &= ~mode;
1014 return ctx->mode;
1015}
1016
1017uint32_t SSL_CTX_get_mode(const SSL_CTX *ctx) { return ctx->mode; }
1018
1019uint32_t SSL_set_mode(SSL *ssl, uint32_t mode) {
1020 ssl->mode |= mode;
1021 return ssl->mode;
1022}
1023
1024uint32_t SSL_clear_mode(SSL *ssl, uint32_t mode) {
1025 ssl->mode &= ~mode;
1026 return ssl->mode;
1027}
1028
1029uint32_t SSL_get_mode(const SSL *ssl) { return ssl->mode; }
1030
Adam Langleyd519bf62016-12-12 11:16:44 -08001031void SSL_CTX_set0_buffer_pool(SSL_CTX *ctx, CRYPTO_BUFFER_POOL *pool) {
1032 ctx->pool = pool;
1033}
1034
David Benjaminee0c8272015-09-13 01:03:54 -04001035int SSL_get_tls_unique(const SSL *ssl, uint8_t *out, size_t *out_len,
1036 size_t max_out) {
David Benjaminced00b42016-10-08 11:24:09 -04001037 /* tls-unique is not defined for SSL 3.0 or TLS 1.3. */
1038 if (!ssl->s3->initial_handshake_complete ||
1039 ssl3_protocol_version(ssl) < TLS1_VERSION ||
1040 ssl3_protocol_version(ssl) >= TLS1_3_VERSION) {
1041 goto err;
1042 }
1043
David Benjaminee0c8272015-09-13 01:03:54 -04001044 /* The tls-unique value is the first Finished message in the handshake, which
1045 * is the client's in a full handshake and the server's for a resumption. See
1046 * https://tools.ietf.org/html/rfc5929#section-3.1. */
1047 const uint8_t *finished = ssl->s3->previous_client_finished;
1048 size_t finished_len = ssl->s3->previous_client_finished_len;
Steven Valdez87eab492016-06-27 16:34:59 -04001049 if (ssl->session != NULL) {
David Benjaminee0c8272015-09-13 01:03:54 -04001050 /* tls-unique is broken for resumed sessions unless EMS is used. */
1051 if (!ssl->session->extended_master_secret) {
1052 goto err;
1053 }
1054 finished = ssl->s3->previous_server_finished;
1055 finished_len = ssl->s3->previous_server_finished_len;
1056 }
1057
David Benjaminee0c8272015-09-13 01:03:54 -04001058 *out_len = finished_len;
1059 if (finished_len > max_out) {
1060 *out_len = max_out;
1061 }
1062
David Benjamin17cf2cb2016-12-13 01:07:13 -05001063 OPENSSL_memcpy(out, finished, *out_len);
David Benjaminee0c8272015-09-13 01:03:54 -04001064 return 1;
1065
1066err:
1067 *out_len = 0;
David Benjamin17cf2cb2016-12-13 01:07:13 -05001068 OPENSSL_memset(out, 0, max_out);
David Benjaminee0c8272015-09-13 01:03:54 -04001069 return 0;
1070}
1071
David Benjamin5960a902017-02-14 20:07:11 -05001072static int set_session_id_context(CERT *cert, const uint8_t *sid_ctx,
David Benjamin30c4c302016-12-07 22:35:24 -05001073 size_t sid_ctx_len) {
David Benjamin5960a902017-02-14 20:07:11 -05001074 if (sid_ctx_len > sizeof(cert->sid_ctx)) {
David Benjamin3570d732015-06-29 00:28:17 -04001075 OPENSSL_PUT_ERROR(SSL, SSL_R_SSL_SESSION_ID_CONTEXT_TOO_LONG);
Adam Langleyfcf25832014-12-18 17:42:32 -08001076 return 0;
1077 }
David Benjamin30c4c302016-12-07 22:35:24 -05001078
David Benjamin5960a902017-02-14 20:07:11 -05001079 OPENSSL_COMPILE_ASSERT(sizeof(cert->sid_ctx) < 256, sid_ctx_too_large);
1080 cert->sid_ctx_length = (uint8_t)sid_ctx_len;
1081 OPENSSL_memcpy(cert->sid_ctx, sid_ctx, sid_ctx_len);
Adam Langleyfcf25832014-12-18 17:42:32 -08001082 return 1;
1083}
Adam Langley95c29f32014-06-20 12:00:00 -07001084
David Benjamin5960a902017-02-14 20:07:11 -05001085int SSL_CTX_set_session_id_context(SSL_CTX *ctx, const uint8_t *sid_ctx,
1086 size_t sid_ctx_len) {
1087 return set_session_id_context(ctx->cert, sid_ctx, sid_ctx_len);
1088}
1089
Adam Langleyfcf25832014-12-18 17:42:32 -08001090int SSL_set_session_id_context(SSL *ssl, const uint8_t *sid_ctx,
David Benjamin30c4c302016-12-07 22:35:24 -05001091 size_t sid_ctx_len) {
David Benjamin5960a902017-02-14 20:07:11 -05001092 return set_session_id_context(ssl->cert, sid_ctx, sid_ctx_len);
Adam Langleyfcf25832014-12-18 17:42:32 -08001093}
Adam Langley95c29f32014-06-20 12:00:00 -07001094
David Benjamin07820b52016-12-07 21:13:41 -05001095const uint8_t *SSL_get0_session_id_context(const SSL *ssl, size_t *out_len) {
David Benjamin5960a902017-02-14 20:07:11 -05001096 *out_len = ssl->cert->sid_ctx_length;
1097 return ssl->cert->sid_ctx;
David Benjamin07820b52016-12-07 21:13:41 -05001098}
1099
Adam Langley858a88d2014-06-20 12:00:00 -07001100void ssl_cipher_preference_list_free(
Adam Langleyfcf25832014-12-18 17:42:32 -08001101 struct ssl_cipher_preference_list_st *cipher_list) {
David Benjamin5d1ec732015-04-22 13:38:00 -04001102 if (cipher_list == NULL) {
1103 return;
1104 }
Adam Langleyfcf25832014-12-18 17:42:32 -08001105 sk_SSL_CIPHER_free(cipher_list->ciphers);
1106 OPENSSL_free(cipher_list->in_group_flags);
1107 OPENSSL_free(cipher_list);
1108}
Adam Langley858a88d2014-06-20 12:00:00 -07001109
David Benjamin7481d392015-07-05 19:38:46 -04001110void SSL_certs_clear(SSL *ssl) { ssl_cert_clear_certs(ssl->cert); }
Adam Langley95c29f32014-06-20 12:00:00 -07001111
David Benjamin066fe0a2015-10-17 21:11:33 -04001112int SSL_get_fd(const SSL *ssl) { return SSL_get_rfd(ssl); }
Adam Langley95c29f32014-06-20 12:00:00 -07001113
David Benjamin066fe0a2015-10-17 21:11:33 -04001114int SSL_get_rfd(const SSL *ssl) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001115 int ret = -1;
David Benjamin066fe0a2015-10-17 21:11:33 -04001116 BIO *b = BIO_find_type(SSL_get_rbio(ssl), BIO_TYPE_DESCRIPTOR);
1117 if (b != NULL) {
1118 BIO_get_fd(b, &ret);
Adam Langleyfcf25832014-12-18 17:42:32 -08001119 }
1120 return ret;
1121}
Adam Langley95c29f32014-06-20 12:00:00 -07001122
David Benjamin066fe0a2015-10-17 21:11:33 -04001123int SSL_get_wfd(const SSL *ssl) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001124 int ret = -1;
David Benjamin066fe0a2015-10-17 21:11:33 -04001125 BIO *b = BIO_find_type(SSL_get_wbio(ssl), BIO_TYPE_DESCRIPTOR);
1126 if (b != NULL) {
1127 BIO_get_fd(b, &ret);
Adam Langleyfcf25832014-12-18 17:42:32 -08001128 }
Adam Langleyfcf25832014-12-18 17:42:32 -08001129 return ret;
1130}
Adam Langley95c29f32014-06-20 12:00:00 -07001131
David Benjamin066fe0a2015-10-17 21:11:33 -04001132int SSL_set_fd(SSL *ssl, int fd) {
David Benjamin22ce9b22016-03-06 19:26:52 -05001133 BIO *bio = BIO_new(BIO_s_socket());
Adam Langleyfcf25832014-12-18 17:42:32 -08001134 if (bio == NULL) {
David Benjamin3570d732015-06-29 00:28:17 -04001135 OPENSSL_PUT_ERROR(SSL, ERR_R_BUF_LIB);
David Benjamin066fe0a2015-10-17 21:11:33 -04001136 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001137 }
1138 BIO_set_fd(bio, fd, BIO_NOCLOSE);
David Benjamin066fe0a2015-10-17 21:11:33 -04001139 SSL_set_bio(ssl, bio, bio);
1140 return 1;
Adam Langleyfcf25832014-12-18 17:42:32 -08001141}
Adam Langley95c29f32014-06-20 12:00:00 -07001142
David Benjamin066fe0a2015-10-17 21:11:33 -04001143int SSL_set_wfd(SSL *ssl, int fd) {
David Benjamin2f871122016-05-20 14:27:17 -04001144 BIO *rbio = SSL_get_rbio(ssl);
1145 if (rbio == NULL || BIO_method_type(rbio) != BIO_TYPE_SOCKET ||
1146 BIO_get_fd(rbio, NULL) != fd) {
David Benjamin22ce9b22016-03-06 19:26:52 -05001147 BIO *bio = BIO_new(BIO_s_socket());
Adam Langleyfcf25832014-12-18 17:42:32 -08001148 if (bio == NULL) {
David Benjamin3570d732015-06-29 00:28:17 -04001149 OPENSSL_PUT_ERROR(SSL, ERR_R_BUF_LIB);
David Benjamin066fe0a2015-10-17 21:11:33 -04001150 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001151 }
1152 BIO_set_fd(bio, fd, BIO_NOCLOSE);
David Benjamin4501bd52016-08-01 13:39:41 -04001153 SSL_set0_wbio(ssl, bio);
Adam Langleyfcf25832014-12-18 17:42:32 -08001154 } else {
David Benjamin4501bd52016-08-01 13:39:41 -04001155 /* Copy the rbio over to the wbio. */
1156 BIO_up_ref(rbio);
1157 SSL_set0_wbio(ssl, rbio);
Adam Langleyfcf25832014-12-18 17:42:32 -08001158 }
1159
David Benjamin066fe0a2015-10-17 21:11:33 -04001160 return 1;
Adam Langleyfcf25832014-12-18 17:42:32 -08001161}
Adam Langley95c29f32014-06-20 12:00:00 -07001162
David Benjamin066fe0a2015-10-17 21:11:33 -04001163int SSL_set_rfd(SSL *ssl, int fd) {
David Benjamin2f871122016-05-20 14:27:17 -04001164 BIO *wbio = SSL_get_wbio(ssl);
1165 if (wbio == NULL || BIO_method_type(wbio) != BIO_TYPE_SOCKET ||
1166 BIO_get_fd(wbio, NULL) != fd) {
David Benjamin22ce9b22016-03-06 19:26:52 -05001167 BIO *bio = BIO_new(BIO_s_socket());
Adam Langleyfcf25832014-12-18 17:42:32 -08001168 if (bio == NULL) {
David Benjamin3570d732015-06-29 00:28:17 -04001169 OPENSSL_PUT_ERROR(SSL, ERR_R_BUF_LIB);
David Benjamin066fe0a2015-10-17 21:11:33 -04001170 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001171 }
1172 BIO_set_fd(bio, fd, BIO_NOCLOSE);
David Benjamin4501bd52016-08-01 13:39:41 -04001173 SSL_set0_rbio(ssl, bio);
Adam Langleyfcf25832014-12-18 17:42:32 -08001174 } else {
David Benjamin4501bd52016-08-01 13:39:41 -04001175 /* Copy the wbio over to the rbio. */
1176 BIO_up_ref(wbio);
1177 SSL_set0_rbio(ssl, wbio);
Adam Langleyfcf25832014-12-18 17:42:32 -08001178 }
David Benjamin066fe0a2015-10-17 21:11:33 -04001179 return 1;
Adam Langleyfcf25832014-12-18 17:42:32 -08001180}
Adam Langley95c29f32014-06-20 12:00:00 -07001181
David Benjamin49ddf412016-10-08 11:56:01 -04001182static size_t copy_finished(void *out, size_t out_len, const uint8_t *in,
1183 size_t in_len) {
1184 if (out_len > in_len) {
1185 out_len = in_len;
1186 }
David Benjamin17cf2cb2016-12-13 01:07:13 -05001187 OPENSSL_memcpy(out, in, out_len);
David Benjamin49ddf412016-10-08 11:56:01 -04001188 return in_len;
1189}
1190
David Benjamin1a1b34d2015-10-17 12:51:52 -04001191size_t SSL_get_finished(const SSL *ssl, void *buf, size_t count) {
David Benjaminced00b42016-10-08 11:24:09 -04001192 if (!ssl->s3->initial_handshake_complete ||
1193 ssl3_protocol_version(ssl) < TLS1_VERSION ||
1194 ssl3_protocol_version(ssl) >= TLS1_3_VERSION) {
1195 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001196 }
1197
David Benjamin49ddf412016-10-08 11:56:01 -04001198 if (ssl->server) {
1199 return copy_finished(buf, count, ssl->s3->previous_server_finished,
1200 ssl->s3->previous_server_finished_len);
David Benjaminced00b42016-10-08 11:24:09 -04001201 }
David Benjamin49ddf412016-10-08 11:56:01 -04001202
1203 return copy_finished(buf, count, ssl->s3->previous_client_finished,
1204 ssl->s3->previous_client_finished_len);
Adam Langleyfcf25832014-12-18 17:42:32 -08001205}
Adam Langley95c29f32014-06-20 12:00:00 -07001206
David Benjamin1a1b34d2015-10-17 12:51:52 -04001207size_t SSL_get_peer_finished(const SSL *ssl, void *buf, size_t count) {
David Benjaminced00b42016-10-08 11:24:09 -04001208 if (!ssl->s3->initial_handshake_complete ||
1209 ssl3_protocol_version(ssl) < TLS1_VERSION ||
1210 ssl3_protocol_version(ssl) >= TLS1_3_VERSION) {
1211 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001212 }
Adam Langley95c29f32014-06-20 12:00:00 -07001213
David Benjamin49ddf412016-10-08 11:56:01 -04001214 if (ssl->server) {
1215 return copy_finished(buf, count, ssl->s3->previous_client_finished,
1216 ssl->s3->previous_client_finished_len);
David Benjaminced00b42016-10-08 11:24:09 -04001217 }
David Benjamin49ddf412016-10-08 11:56:01 -04001218
1219 return copy_finished(buf, count, ssl->s3->previous_server_finished,
1220 ssl->s3->previous_server_finished_len);
Adam Langleyfcf25832014-12-18 17:42:32 -08001221}
Adam Langley95c29f32014-06-20 12:00:00 -07001222
David Benjamin59937042015-09-19 13:04:22 -04001223int SSL_get_verify_mode(const SSL *ssl) { return ssl->verify_mode; }
Adam Langley95c29f32014-06-20 12:00:00 -07001224
David Benjamin42fea372015-09-19 01:22:44 -04001225int SSL_get_extms_support(const SSL *ssl) {
David Benjamina68c1182016-07-24 00:14:33 -04001226 if (!ssl->s3->have_version) {
1227 return 0;
1228 }
Steven Valdez143e8b32016-07-11 13:19:03 -04001229 return ssl3_protocol_version(ssl) >= TLS1_3_VERSION ||
1230 ssl->s3->tmp.extended_master_secret == 1;
Matt Braithwaitecd6f54b2015-09-17 12:54:42 -07001231}
1232
David Benjamin9a41d1b2015-05-16 01:30:09 -04001233int SSL_CTX_get_read_ahead(const SSL_CTX *ctx) { return 0; }
Adam Langley95c29f32014-06-20 12:00:00 -07001234
David Benjamin0d56f882015-12-19 17:05:56 -05001235int SSL_get_read_ahead(const SSL *ssl) { return 0; }
Adam Langley95c29f32014-06-20 12:00:00 -07001236
David Benjamin9a41d1b2015-05-16 01:30:09 -04001237void SSL_CTX_set_read_ahead(SSL_CTX *ctx, int yes) { }
David Benjamin61ecccf2015-05-05 09:44:51 -04001238
David Benjamin0d56f882015-12-19 17:05:56 -05001239void SSL_set_read_ahead(SSL *ssl, int yes) { }
David Benjamin61ecccf2015-05-05 09:44:51 -04001240
David Benjamin9f859492015-10-03 10:44:30 -04001241int SSL_pending(const SSL *ssl) {
1242 if (ssl->s3->rrec.type != SSL3_RT_APPLICATION_DATA) {
1243 return 0;
1244 }
1245 return ssl->s3->rrec.length;
Adam Langleyfcf25832014-12-18 17:42:32 -08001246}
Adam Langley95c29f32014-06-20 12:00:00 -07001247
Adam Langley95c29f32014-06-20 12:00:00 -07001248/* Fix this so it checks all the valid key/cert options */
Adam Langleyfcf25832014-12-18 17:42:32 -08001249int SSL_CTX_check_private_key(const SSL_CTX *ctx) {
Adam Langley3a2b47a2017-01-24 13:59:42 -08001250 return ssl_cert_check_private_key(ctx->cert, ctx->cert->privatekey);
Adam Langleyc5ac2b62016-11-07 12:02:35 -08001251}
1252
1253/* Fix this function so that it takes an optional type parameter */
1254int SSL_check_private_key(const SSL *ssl) {
Adam Langley3a2b47a2017-01-24 13:59:42 -08001255 return ssl_cert_check_private_key(ssl->cert, ssl->cert->privatekey);
Adam Langleyfcf25832014-12-18 17:42:32 -08001256}
Adam Langley95c29f32014-06-20 12:00:00 -07001257
David Benjamin42fea372015-09-19 01:22:44 -04001258long SSL_get_default_timeout(const SSL *ssl) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001259 return SSL_DEFAULT_SESSION_TIMEOUT;
1260}
Adam Langley95c29f32014-06-20 12:00:00 -07001261
David Benjamin44d3eed2015-05-21 01:29:55 -04001262int SSL_renegotiate(SSL *ssl) {
1263 /* Caller-initiated renegotiation is not supported. */
David Benjamin3570d732015-06-29 00:28:17 -04001264 OPENSSL_PUT_ERROR(SSL, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
David Benjamin44d3eed2015-05-21 01:29:55 -04001265 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001266}
Adam Langley95c29f32014-06-20 12:00:00 -07001267
David Benjamin44d3eed2015-05-21 01:29:55 -04001268int SSL_renegotiate_pending(SSL *ssl) {
1269 return SSL_in_init(ssl) && ssl->s3->initial_handshake_complete;
Adam Langleyfcf25832014-12-18 17:42:32 -08001270}
Adam Langley95c29f32014-06-20 12:00:00 -07001271
David Benjamin936aada2016-06-07 19:09:22 -04001272int SSL_total_renegotiations(const SSL *ssl) {
1273 return ssl->s3->total_renegotiations;
1274}
1275
David Benjamin1d0a1942015-04-26 15:35:35 -04001276size_t SSL_CTX_get_max_cert_list(const SSL_CTX *ctx) {
1277 return ctx->max_cert_list;
1278}
1279
1280void SSL_CTX_set_max_cert_list(SSL_CTX *ctx, size_t max_cert_list) {
1281 if (max_cert_list > kMaxHandshakeSize) {
1282 max_cert_list = kMaxHandshakeSize;
1283 }
1284 ctx->max_cert_list = (uint32_t)max_cert_list;
1285}
1286
1287size_t SSL_get_max_cert_list(const SSL *ssl) {
1288 return ssl->max_cert_list;
1289}
1290
1291void SSL_set_max_cert_list(SSL *ssl, size_t max_cert_list) {
1292 if (max_cert_list > kMaxHandshakeSize) {
1293 max_cert_list = kMaxHandshakeSize;
1294 }
1295 ssl->max_cert_list = (uint32_t)max_cert_list;
1296}
1297
Adam Langleyce9d85e2016-01-24 15:58:39 -08001298int SSL_CTX_set_max_send_fragment(SSL_CTX *ctx, size_t max_send_fragment) {
David Benjamin1d0a1942015-04-26 15:35:35 -04001299 if (max_send_fragment < 512) {
1300 max_send_fragment = 512;
1301 }
1302 if (max_send_fragment > SSL3_RT_MAX_PLAIN_LENGTH) {
1303 max_send_fragment = SSL3_RT_MAX_PLAIN_LENGTH;
1304 }
1305 ctx->max_send_fragment = (uint16_t)max_send_fragment;
Adam Langleyce9d85e2016-01-24 15:58:39 -08001306
1307 return 1;
David Benjamin1d0a1942015-04-26 15:35:35 -04001308}
1309
Adam Langleyce9d85e2016-01-24 15:58:39 -08001310int SSL_set_max_send_fragment(SSL *ssl, size_t max_send_fragment) {
David Benjamin1d0a1942015-04-26 15:35:35 -04001311 if (max_send_fragment < 512) {
1312 max_send_fragment = 512;
1313 }
1314 if (max_send_fragment > SSL3_RT_MAX_PLAIN_LENGTH) {
1315 max_send_fragment = SSL3_RT_MAX_PLAIN_LENGTH;
1316 }
1317 ssl->max_send_fragment = (uint16_t)max_send_fragment;
Adam Langleyce9d85e2016-01-24 15:58:39 -08001318
1319 return 1;
David Benjamin1d0a1942015-04-26 15:35:35 -04001320}
1321
David Benjamincb9cf792015-05-05 09:46:14 -04001322int SSL_set_mtu(SSL *ssl, unsigned mtu) {
David Benjamince079fd2016-08-02 16:22:34 -04001323 if (!SSL_is_dtls(ssl) || mtu < dtls1_min_mtu()) {
David Benjamincb9cf792015-05-05 09:46:14 -04001324 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001325 }
David Benjamincb9cf792015-05-05 09:46:14 -04001326 ssl->d1->mtu = mtu;
1327 return 1;
1328}
1329
1330int SSL_get_secure_renegotiation_support(const SSL *ssl) {
David Benjamind2610042017-01-03 10:49:28 -05001331 if (!ssl->s3->have_version) {
1332 return 0;
1333 }
1334 return ssl3_protocol_version(ssl) >= TLS1_3_VERSION ||
1335 ssl->s3->send_connection_binding;
David Benjamincb9cf792015-05-05 09:46:14 -04001336}
1337
Adam Langleyfcf25832014-12-18 17:42:32 -08001338LHASH_OF(SSL_SESSION) *SSL_CTX_sessions(SSL_CTX *ctx) { return ctx->sessions; }
1339
David Benjamin71f7d3d2015-05-05 09:46:38 -04001340size_t SSL_CTX_sess_number(const SSL_CTX *ctx) {
1341 return lh_SSL_SESSION_num_items(ctx->sessions);
1342}
1343
1344unsigned long SSL_CTX_sess_set_cache_size(SSL_CTX *ctx, unsigned long size) {
1345 unsigned long ret = ctx->session_cache_size;
1346 ctx->session_cache_size = size;
1347 return ret;
1348}
1349
1350unsigned long SSL_CTX_sess_get_cache_size(const SSL_CTX *ctx) {
1351 return ctx->session_cache_size;
1352}
1353
1354int SSL_CTX_set_session_cache_mode(SSL_CTX *ctx, int mode) {
1355 int ret = ctx->session_cache_mode;
1356 ctx->session_cache_mode = mode;
1357 return ret;
1358}
1359
1360int SSL_CTX_get_session_cache_mode(const SSL_CTX *ctx) {
1361 return ctx->session_cache_mode;
1362}
1363
David Benjamin936aada2016-06-07 19:09:22 -04001364
1365int SSL_CTX_get_tlsext_ticket_keys(SSL_CTX *ctx, void *out, size_t len) {
1366 if (out == NULL) {
1367 return 48;
1368 }
1369 if (len != 48) {
1370 OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_TICKET_KEYS_LENGTH);
1371 return 0;
1372 }
1373 uint8_t *out_bytes = out;
David Benjamin17cf2cb2016-12-13 01:07:13 -05001374 OPENSSL_memcpy(out_bytes, ctx->tlsext_tick_key_name, 16);
1375 OPENSSL_memcpy(out_bytes + 16, ctx->tlsext_tick_hmac_key, 16);
1376 OPENSSL_memcpy(out_bytes + 32, ctx->tlsext_tick_aes_key, 16);
David Benjamin936aada2016-06-07 19:09:22 -04001377 return 1;
1378}
1379
1380int SSL_CTX_set_tlsext_ticket_keys(SSL_CTX *ctx, const void *in, size_t len) {
1381 if (in == NULL) {
1382 return 48;
1383 }
1384 if (len != 48) {
1385 OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_TICKET_KEYS_LENGTH);
1386 return 0;
1387 }
1388 const uint8_t *in_bytes = in;
David Benjamin17cf2cb2016-12-13 01:07:13 -05001389 OPENSSL_memcpy(ctx->tlsext_tick_key_name, in_bytes, 16);
1390 OPENSSL_memcpy(ctx->tlsext_tick_hmac_key, in_bytes + 16, 16);
1391 OPENSSL_memcpy(ctx->tlsext_tick_aes_key, in_bytes + 32, 16);
David Benjamin936aada2016-06-07 19:09:22 -04001392 return 1;
1393}
1394
1395int SSL_CTX_set_tlsext_ticket_key_cb(
1396 SSL_CTX *ctx, int (*callback)(SSL *ssl, uint8_t *key_name, uint8_t *iv,
1397 EVP_CIPHER_CTX *ctx, HMAC_CTX *hmac_ctx,
1398 int encrypt)) {
1399 ctx->tlsext_ticket_key_cb = callback;
1400 return 1;
1401}
1402
1403int SSL_CTX_set1_curves(SSL_CTX *ctx, const int *curves, size_t curves_len) {
1404 return tls1_set_curves(&ctx->supported_group_list,
1405 &ctx->supported_group_list_len, curves,
1406 curves_len);
1407}
1408
1409int SSL_set1_curves(SSL *ssl, const int *curves, size_t curves_len) {
1410 return tls1_set_curves(&ssl->supported_group_list,
1411 &ssl->supported_group_list_len, curves,
1412 curves_len);
1413}
1414
Alessandro Ghedini5fd18072016-09-28 21:04:25 +01001415int SSL_CTX_set1_curves_list(SSL_CTX *ctx, const char *curves) {
1416 return tls1_set_curves_list(&ctx->supported_group_list,
1417 &ctx->supported_group_list_len, curves);
1418}
1419
1420int SSL_set1_curves_list(SSL *ssl, const char *curves) {
1421 return tls1_set_curves_list(&ssl->supported_group_list,
1422 &ssl->supported_group_list_len, curves);
1423}
1424
David Benjamin9e68f192016-06-30 14:55:33 -04001425uint16_t SSL_get_curve_id(const SSL *ssl) {
1426 /* TODO(davidben): This checks the wrong session if there is a renegotiation in
1427 * progress. */
Steven Valdez87eab492016-06-27 16:34:59 -04001428 SSL_SESSION *session = SSL_get_session(ssl);
David Benjamin4882a6c2016-12-11 02:48:12 -05001429 if (session == NULL) {
David Benjamin9e68f192016-06-30 14:55:33 -04001430 return 0;
1431 }
1432
David Benjamin4882a6c2016-12-11 02:48:12 -05001433 return session->group_id;
David Benjamin9e68f192016-06-30 14:55:33 -04001434}
1435
David Benjamin936aada2016-06-07 19:09:22 -04001436int SSL_CTX_set_tmp_dh(SSL_CTX *ctx, const DH *dh) {
1437 DH_free(ctx->cert->dh_tmp);
1438 ctx->cert->dh_tmp = DHparams_dup(dh);
1439 if (ctx->cert->dh_tmp == NULL) {
1440 OPENSSL_PUT_ERROR(SSL, ERR_R_DH_LIB);
1441 return 0;
1442 }
1443 return 1;
1444}
1445
1446int SSL_set_tmp_dh(SSL *ssl, const DH *dh) {
1447 DH_free(ssl->cert->dh_tmp);
1448 ssl->cert->dh_tmp = DHparams_dup(dh);
1449 if (ssl->cert->dh_tmp == NULL) {
1450 OPENSSL_PUT_ERROR(SSL, ERR_R_DH_LIB);
1451 return 0;
1452 }
1453 return 1;
1454}
1455
David Benjamin32876b32015-09-20 12:17:03 -04001456STACK_OF(SSL_CIPHER) *SSL_get_ciphers(const SSL *ssl) {
1457 if (ssl == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001458 return NULL;
1459 }
Adam Langley0b5c1ac2014-06-20 12:00:00 -07001460
David Benjaminaf3b3d32016-10-31 16:29:57 -04001461 const struct ssl_cipher_preference_list_st *prefs =
1462 ssl_get_cipher_preferences(ssl);
1463 if (prefs == NULL) {
1464 return NULL;
Adam Langleyfcf25832014-12-18 17:42:32 -08001465 }
Adam Langley0b5c1ac2014-06-20 12:00:00 -07001466
David Benjaminaf3b3d32016-10-31 16:29:57 -04001467 return prefs->ciphers;
Adam Langleyfcf25832014-12-18 17:42:32 -08001468}
Adam Langley95c29f32014-06-20 12:00:00 -07001469
David Benjamin32876b32015-09-20 12:17:03 -04001470const char *SSL_get_cipher_list(const SSL *ssl, int n) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001471 const SSL_CIPHER *c;
David Benjamin60da0cd2015-05-03 15:21:28 -04001472 STACK_OF(SSL_CIPHER) *sk;
Adam Langley0b5c1ac2014-06-20 12:00:00 -07001473
David Benjamin32876b32015-09-20 12:17:03 -04001474 if (ssl == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001475 return NULL;
1476 }
Adam Langley95c29f32014-06-20 12:00:00 -07001477
David Benjamin32876b32015-09-20 12:17:03 -04001478 sk = SSL_get_ciphers(ssl);
Adam Langleyfcf25832014-12-18 17:42:32 -08001479 if (sk == NULL || n < 0 || (size_t)n >= sk_SSL_CIPHER_num(sk)) {
1480 return NULL;
1481 }
Adam Langley95c29f32014-06-20 12:00:00 -07001482
Adam Langleyfcf25832014-12-18 17:42:32 -08001483 c = sk_SSL_CIPHER_value(sk, n);
1484 if (c == NULL) {
1485 return NULL;
1486 }
Adam Langley95c29f32014-06-20 12:00:00 -07001487
Adam Langleyfcf25832014-12-18 17:42:32 -08001488 return c->name;
1489}
David Benjamin5491e3f2014-09-29 19:33:09 -04001490
Adam Langleyfcf25832014-12-18 17:42:32 -08001491int SSL_CTX_set_cipher_list(SSL_CTX *ctx, const char *str) {
David Benjamind2cb1c12016-11-02 17:49:09 -04001492 STACK_OF(SSL_CIPHER) *cipher_list =
1493 ssl_create_cipher_list(ctx->method, &ctx->cipher_list, str);
David Benjamin32876b32015-09-20 12:17:03 -04001494 if (cipher_list == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001495 return 0;
David Benjamin32876b32015-09-20 12:17:03 -04001496 }
1497
1498 /* |ssl_create_cipher_list| may succeed but return an empty cipher list. */
1499 if (sk_SSL_CIPHER_num(cipher_list) == 0) {
David Benjamin3570d732015-06-29 00:28:17 -04001500 OPENSSL_PUT_ERROR(SSL, SSL_R_NO_CIPHER_MATCH);
Adam Langleyfcf25832014-12-18 17:42:32 -08001501 return 0;
1502 }
Adam Langley95c29f32014-06-20 12:00:00 -07001503
Adam Langleyfcf25832014-12-18 17:42:32 -08001504 return 1;
1505}
David Benjamin39482a12014-07-20 13:30:15 -04001506
David Benjamin32876b32015-09-20 12:17:03 -04001507int SSL_set_cipher_list(SSL *ssl, const char *str) {
David Benjamind2cb1c12016-11-02 17:49:09 -04001508 STACK_OF(SSL_CIPHER) *cipher_list =
1509 ssl_create_cipher_list(ssl->ctx->method, &ssl->cipher_list, str);
David Benjamin32876b32015-09-20 12:17:03 -04001510 if (cipher_list == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001511 return 0;
David Benjamin32876b32015-09-20 12:17:03 -04001512 }
1513
1514 /* |ssl_create_cipher_list| may succeed but return an empty cipher list. */
1515 if (sk_SSL_CIPHER_num(cipher_list) == 0) {
David Benjamin3570d732015-06-29 00:28:17 -04001516 OPENSSL_PUT_ERROR(SSL, SSL_R_NO_CIPHER_MATCH);
Adam Langleyfcf25832014-12-18 17:42:32 -08001517 return 0;
1518 }
David Benjamin39482a12014-07-20 13:30:15 -04001519
Adam Langleyfcf25832014-12-18 17:42:32 -08001520 return 1;
1521}
Adam Langley95c29f32014-06-20 12:00:00 -07001522
David Benjamin07e13842015-10-17 13:48:04 -04001523const char *SSL_get_servername(const SSL *ssl, const int type) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001524 if (type != TLSEXT_NAMETYPE_host_name) {
1525 return NULL;
1526 }
Adam Langley95c29f32014-06-20 12:00:00 -07001527
David Benjamin07e13842015-10-17 13:48:04 -04001528 /* Historically, |SSL_get_servername| was also the configuration getter
1529 * corresponding to |SSL_set_tlsext_host_name|. */
1530 if (ssl->tlsext_hostname != NULL) {
1531 return ssl->tlsext_hostname;
1532 }
1533
David Benjamin4eb95cc2016-11-16 17:08:23 +09001534 /* During the handshake, report the handshake value. */
1535 if (ssl->s3->hs != NULL) {
1536 return ssl->s3->hs->hostname;
1537 }
1538
1539 /* SSL_get_servername may also be called after the handshake to look up the
1540 * SNI value.
1541 *
1542 * TODO(davidben): This is almost unused. Can we remove it? */
Steven Valdez87eab492016-06-27 16:34:59 -04001543 SSL_SESSION *session = SSL_get_session(ssl);
1544 if (session == NULL) {
David Benjamin07e13842015-10-17 13:48:04 -04001545 return NULL;
1546 }
Steven Valdez87eab492016-06-27 16:34:59 -04001547 return session->tlsext_hostname;
Adam Langleyfcf25832014-12-18 17:42:32 -08001548}
Adam Langley95c29f32014-06-20 12:00:00 -07001549
David Benjamin07e13842015-10-17 13:48:04 -04001550int SSL_get_servername_type(const SSL *ssl) {
Steven Valdez87eab492016-06-27 16:34:59 -04001551 SSL_SESSION *session = SSL_get_session(ssl);
1552 if (session == NULL || session->tlsext_hostname == NULL) {
1553 return -1;
Adam Langleyfcf25832014-12-18 17:42:32 -08001554 }
Steven Valdez87eab492016-06-27 16:34:59 -04001555 return TLSEXT_NAMETYPE_host_name;
Adam Langleyfcf25832014-12-18 17:42:32 -08001556}
Adam Langley95c29f32014-06-20 12:00:00 -07001557
Adam Langleyfcf25832014-12-18 17:42:32 -08001558void SSL_CTX_enable_signed_cert_timestamps(SSL_CTX *ctx) {
1559 ctx->signed_cert_timestamps_enabled = 1;
1560}
HÃ¥vard Molland9169c962014-08-14 14:42:37 +02001561
David Benjamin26e1ff32017-02-14 20:13:00 -05001562void SSL_enable_signed_cert_timestamps(SSL *ssl) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001563 ssl->signed_cert_timestamps_enabled = 1;
Adam Langleyfcf25832014-12-18 17:42:32 -08001564}
HÃ¥vard Molland9169c962014-08-14 14:42:37 +02001565
Adam Langleyfcf25832014-12-18 17:42:32 -08001566void SSL_CTX_enable_ocsp_stapling(SSL_CTX *ctx) {
1567 ctx->ocsp_stapling_enabled = 1;
1568}
David Benjamin6c7aed02014-08-27 16:42:38 -04001569
David Benjamin26e1ff32017-02-14 20:13:00 -05001570void SSL_enable_ocsp_stapling(SSL *ssl) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001571 ssl->ocsp_stapling_enabled = 1;
Adam Langleyfcf25832014-12-18 17:42:32 -08001572}
David Benjamin6c7aed02014-08-27 16:42:38 -04001573
Adam Langleyfcf25832014-12-18 17:42:32 -08001574void SSL_get0_signed_cert_timestamp_list(const SSL *ssl, const uint8_t **out,
1575 size_t *out_len) {
Steven Valdez87eab492016-06-27 16:34:59 -04001576 SSL_SESSION *session = SSL_get_session(ssl);
Adam Langley3cb50e02014-08-26 14:00:31 -07001577
Adam Langleyfcf25832014-12-18 17:42:32 -08001578 *out_len = 0;
1579 *out = NULL;
1580 if (ssl->server || !session || !session->tlsext_signed_cert_timestamp_list) {
1581 return;
1582 }
HÃ¥vard Molland9169c962014-08-14 14:42:37 +02001583
Adam Langleyfcf25832014-12-18 17:42:32 -08001584 *out = session->tlsext_signed_cert_timestamp_list;
1585 *out_len = session->tlsext_signed_cert_timestamp_list_length;
1586}
David Benjamin6c7aed02014-08-27 16:42:38 -04001587
Adam Langleyfcf25832014-12-18 17:42:32 -08001588void SSL_get0_ocsp_response(const SSL *ssl, const uint8_t **out,
1589 size_t *out_len) {
Steven Valdez87eab492016-06-27 16:34:59 -04001590 SSL_SESSION *session = SSL_get_session(ssl);
Adam Langleyfcf25832014-12-18 17:42:32 -08001591
1592 *out_len = 0;
1593 *out = NULL;
1594 if (ssl->server || !session || !session->ocsp_response) {
1595 return;
1596 }
1597 *out = session->ocsp_response;
1598 *out_len = session->ocsp_response_length;
1599}
David Benjamin6c7aed02014-08-27 16:42:38 -04001600
David Benjamin936aada2016-06-07 19:09:22 -04001601int SSL_set_tlsext_host_name(SSL *ssl, const char *name) {
1602 OPENSSL_free(ssl->tlsext_hostname);
1603 ssl->tlsext_hostname = NULL;
1604
1605 if (name == NULL) {
1606 return 1;
1607 }
1608
1609 size_t len = strlen(name);
1610 if (len == 0 || len > TLSEXT_MAXLEN_host_name) {
1611 OPENSSL_PUT_ERROR(SSL, SSL_R_SSL3_EXT_INVALID_SERVERNAME);
1612 return 0;
1613 }
1614 ssl->tlsext_hostname = BUF_strdup(name);
1615 if (ssl->tlsext_hostname == NULL) {
1616 OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
1617 return 0;
1618 }
1619 return 1;
1620}
1621
1622int SSL_CTX_set_tlsext_servername_callback(
1623 SSL_CTX *ctx, int (*callback)(SSL *ssl, int *out_alert, void *arg)) {
1624 ctx->tlsext_servername_callback = callback;
1625 return 1;
1626}
1627
1628int SSL_CTX_set_tlsext_servername_arg(SSL_CTX *ctx, void *arg) {
1629 ctx->tlsext_servername_arg = arg;
1630 return 1;
1631}
1632
David Benjamin977547b2015-09-16 00:25:52 -04001633int SSL_select_next_proto(uint8_t **out, uint8_t *out_len,
1634 const uint8_t *server, unsigned server_len,
1635 const uint8_t *client, unsigned client_len) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001636 unsigned int i, j;
1637 const uint8_t *result;
1638 int status = OPENSSL_NPN_UNSUPPORTED;
Adam Langley95c29f32014-06-20 12:00:00 -07001639
Adam Langleyfcf25832014-12-18 17:42:32 -08001640 /* For each protocol in server preference order, see if we support it. */
1641 for (i = 0; i < server_len;) {
1642 for (j = 0; j < client_len;) {
1643 if (server[i] == client[j] &&
David Benjamin17cf2cb2016-12-13 01:07:13 -05001644 OPENSSL_memcmp(&server[i + 1], &client[j + 1], server[i]) == 0) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001645 /* We found a match */
1646 result = &server[i];
1647 status = OPENSSL_NPN_NEGOTIATED;
1648 goto found;
1649 }
1650 j += client[j];
1651 j++;
1652 }
1653 i += server[i];
1654 i++;
1655 }
Adam Langley95c29f32014-06-20 12:00:00 -07001656
Adam Langleyfcf25832014-12-18 17:42:32 -08001657 /* There's no overlap between our protocols and the server's list. */
1658 result = client;
1659 status = OPENSSL_NPN_NO_OVERLAP;
Adam Langley95c29f32014-06-20 12:00:00 -07001660
Adam Langleyfcf25832014-12-18 17:42:32 -08001661found:
1662 *out = (uint8_t *)result + 1;
David Benjamin977547b2015-09-16 00:25:52 -04001663 *out_len = result[0];
Adam Langleyfcf25832014-12-18 17:42:32 -08001664 return status;
1665}
Adam Langley95c29f32014-06-20 12:00:00 -07001666
David Benjamin977547b2015-09-16 00:25:52 -04001667void SSL_get0_next_proto_negotiated(const SSL *ssl, const uint8_t **out_data,
1668 unsigned *out_len) {
David Benjamin79978df2015-12-25 15:56:49 -05001669 *out_data = ssl->s3->next_proto_negotiated;
David Benjamin977547b2015-09-16 00:25:52 -04001670 if (*out_data == NULL) {
1671 *out_len = 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001672 } else {
David Benjamin79978df2015-12-25 15:56:49 -05001673 *out_len = ssl->s3->next_proto_negotiated_len;
Adam Langleyfcf25832014-12-18 17:42:32 -08001674 }
Adam Langley95c29f32014-06-20 12:00:00 -07001675}
1676
Adam Langleyfcf25832014-12-18 17:42:32 -08001677void SSL_CTX_set_next_protos_advertised_cb(
1678 SSL_CTX *ctx,
David Benjamin977547b2015-09-16 00:25:52 -04001679 int (*cb)(SSL *ssl, const uint8_t **out, unsigned *out_len, void *arg),
Adam Langleyfcf25832014-12-18 17:42:32 -08001680 void *arg) {
1681 ctx->next_protos_advertised_cb = cb;
1682 ctx->next_protos_advertised_cb_arg = arg;
1683}
Adam Langley95c29f32014-06-20 12:00:00 -07001684
Adam Langleyfcf25832014-12-18 17:42:32 -08001685void SSL_CTX_set_next_proto_select_cb(
David Benjamin977547b2015-09-16 00:25:52 -04001686 SSL_CTX *ctx, int (*cb)(SSL *ssl, uint8_t **out, uint8_t *out_len,
1687 const uint8_t *in, unsigned in_len, void *arg),
Adam Langleyfcf25832014-12-18 17:42:32 -08001688 void *arg) {
1689 ctx->next_proto_select_cb = cb;
1690 ctx->next_proto_select_cb_arg = arg;
1691}
Adam Langley95c29f32014-06-20 12:00:00 -07001692
Adam Langleyfcf25832014-12-18 17:42:32 -08001693int SSL_CTX_set_alpn_protos(SSL_CTX *ctx, const uint8_t *protos,
1694 unsigned protos_len) {
David Benjamin2755a3e2015-04-22 16:17:58 -04001695 OPENSSL_free(ctx->alpn_client_proto_list);
Adam Langleyfcf25832014-12-18 17:42:32 -08001696 ctx->alpn_client_proto_list = BUF_memdup(protos, protos_len);
1697 if (!ctx->alpn_client_proto_list) {
1698 return 1;
1699 }
1700 ctx->alpn_client_proto_list_len = protos_len;
Adam Langley95c29f32014-06-20 12:00:00 -07001701
Adam Langleyfcf25832014-12-18 17:42:32 -08001702 return 0;
1703}
Adam Langley95c29f32014-06-20 12:00:00 -07001704
Adam Langleyfcf25832014-12-18 17:42:32 -08001705int SSL_set_alpn_protos(SSL *ssl, const uint8_t *protos, unsigned protos_len) {
David Benjamin2755a3e2015-04-22 16:17:58 -04001706 OPENSSL_free(ssl->alpn_client_proto_list);
Adam Langleyfcf25832014-12-18 17:42:32 -08001707 ssl->alpn_client_proto_list = BUF_memdup(protos, protos_len);
1708 if (!ssl->alpn_client_proto_list) {
1709 return 1;
1710 }
1711 ssl->alpn_client_proto_list_len = protos_len;
Adam Langley95c29f32014-06-20 12:00:00 -07001712
Adam Langleyfcf25832014-12-18 17:42:32 -08001713 return 0;
1714}
Adam Langley95c29f32014-06-20 12:00:00 -07001715
Adam Langleyfcf25832014-12-18 17:42:32 -08001716void SSL_CTX_set_alpn_select_cb(SSL_CTX *ctx,
1717 int (*cb)(SSL *ssl, const uint8_t **out,
David Benjamin8984f1f2015-09-16 00:10:19 -04001718 uint8_t *out_len, const uint8_t *in,
1719 unsigned in_len, void *arg),
Adam Langleyfcf25832014-12-18 17:42:32 -08001720 void *arg) {
1721 ctx->alpn_select_cb = cb;
1722 ctx->alpn_select_cb_arg = arg;
1723}
Adam Langley95c29f32014-06-20 12:00:00 -07001724
David Benjamin8984f1f2015-09-16 00:10:19 -04001725void SSL_get0_alpn_selected(const SSL *ssl, const uint8_t **out_data,
1726 unsigned *out_len) {
1727 *out_data = NULL;
Adam Langleyfcf25832014-12-18 17:42:32 -08001728 if (ssl->s3) {
David Benjamin8984f1f2015-09-16 00:10:19 -04001729 *out_data = ssl->s3->alpn_selected;
Adam Langleyfcf25832014-12-18 17:42:32 -08001730 }
David Benjamin8984f1f2015-09-16 00:10:19 -04001731 if (*out_data == NULL) {
1732 *out_len = 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001733 } else {
David Benjamin8984f1f2015-09-16 00:10:19 -04001734 *out_len = ssl->s3->alpn_selected_len;
Adam Langleyfcf25832014-12-18 17:42:32 -08001735 }
1736}
Adam Langley95c29f32014-06-20 12:00:00 -07001737
David Benjamin936aada2016-06-07 19:09:22 -04001738
David Benjamineebd3c82016-12-06 17:43:58 -05001739void SSL_CTX_set_tls_channel_id_enabled(SSL_CTX *ctx, int enabled) {
1740 ctx->tlsext_channel_id_enabled = !!enabled;
1741}
1742
David Benjamin936aada2016-06-07 19:09:22 -04001743int SSL_CTX_enable_tls_channel_id(SSL_CTX *ctx) {
David Benjamineebd3c82016-12-06 17:43:58 -05001744 SSL_CTX_set_tls_channel_id_enabled(ctx, 1);
David Benjamin936aada2016-06-07 19:09:22 -04001745 return 1;
1746}
1747
David Benjamineebd3c82016-12-06 17:43:58 -05001748void SSL_set_tls_channel_id_enabled(SSL *ssl, int enabled) {
1749 ssl->tlsext_channel_id_enabled = !!enabled;
1750}
1751
David Benjamin936aada2016-06-07 19:09:22 -04001752int SSL_enable_tls_channel_id(SSL *ssl) {
David Benjamineebd3c82016-12-06 17:43:58 -05001753 SSL_set_tls_channel_id_enabled(ssl, 1);
David Benjamin936aada2016-06-07 19:09:22 -04001754 return 1;
1755}
1756
1757static int is_p256_key(EVP_PKEY *private_key) {
1758 const EC_KEY *ec_key = EVP_PKEY_get0_EC_KEY(private_key);
1759 return ec_key != NULL &&
1760 EC_GROUP_get_curve_name(EC_KEY_get0_group(ec_key)) ==
1761 NID_X9_62_prime256v1;
1762}
1763
1764int SSL_CTX_set1_tls_channel_id(SSL_CTX *ctx, EVP_PKEY *private_key) {
1765 if (!is_p256_key(private_key)) {
1766 OPENSSL_PUT_ERROR(SSL, SSL_R_CHANNEL_ID_NOT_P256);
1767 return 0;
1768 }
1769
1770 EVP_PKEY_free(ctx->tlsext_channel_id_private);
Adam Langley310d3f62016-07-12 10:39:20 -07001771 EVP_PKEY_up_ref(private_key);
1772 ctx->tlsext_channel_id_private = private_key;
David Benjamin936aada2016-06-07 19:09:22 -04001773 ctx->tlsext_channel_id_enabled = 1;
1774
1775 return 1;
1776}
1777
1778int SSL_set1_tls_channel_id(SSL *ssl, EVP_PKEY *private_key) {
1779 if (!is_p256_key(private_key)) {
1780 OPENSSL_PUT_ERROR(SSL, SSL_R_CHANNEL_ID_NOT_P256);
1781 return 0;
1782 }
1783
1784 EVP_PKEY_free(ssl->tlsext_channel_id_private);
Adam Langley310d3f62016-07-12 10:39:20 -07001785 EVP_PKEY_up_ref(private_key);
1786 ssl->tlsext_channel_id_private = private_key;
David Benjamin936aada2016-06-07 19:09:22 -04001787 ssl->tlsext_channel_id_enabled = 1;
1788
1789 return 1;
1790}
1791
1792size_t SSL_get_tls_channel_id(SSL *ssl, uint8_t *out, size_t max_out) {
1793 if (!ssl->s3->tlsext_channel_id_valid) {
1794 return 0;
1795 }
David Benjamin17cf2cb2016-12-13 01:07:13 -05001796 OPENSSL_memcpy(out, ssl->s3->tlsext_channel_id,
1797 (max_out < 64) ? max_out : 64);
David Benjamin936aada2016-06-07 19:09:22 -04001798 return 64;
1799}
1800
David Benjamin936aada2016-06-07 19:09:22 -04001801size_t SSL_get0_certificate_types(SSL *ssl, const uint8_t **out_types) {
David Benjamina0486782016-10-06 19:11:32 -04001802 if (ssl->server || ssl->s3->hs == NULL) {
David Benjamin936aada2016-06-07 19:09:22 -04001803 *out_types = NULL;
1804 return 0;
1805 }
David Benjamina0486782016-10-06 19:11:32 -04001806 *out_types = ssl->s3->hs->certificate_types;
1807 return ssl->s3->hs->num_certificate_types;
David Benjamin936aada2016-06-07 19:09:22 -04001808}
1809
David Benjaminf3c8f8d2016-11-17 17:20:47 +09001810void ssl_update_cache(SSL_HANDSHAKE *hs, int mode) {
1811 SSL *const ssl = hs->ssl;
David Benjamin1269ddd2015-10-18 15:18:55 -04001812 SSL_CTX *ctx = ssl->initial_ctx;
David Benjaminb6d0c6d2015-03-19 19:07:26 -04001813 /* Never cache sessions with empty session IDs. */
Steven Valdez87eab492016-06-27 16:34:59 -04001814 if (ssl->s3->established_session->session_id_length == 0 ||
David Benjamin1269ddd2015-10-18 15:18:55 -04001815 (ctx->session_cache_mode & mode) != mode) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001816 return;
1817 }
Adam Langley95c29f32014-06-20 12:00:00 -07001818
David Benjamin1269ddd2015-10-18 15:18:55 -04001819 /* Clients never use the internal session cache. */
1820 int use_internal_cache = ssl->server && !(ctx->session_cache_mode &
1821 SSL_SESS_CACHE_NO_INTERNAL_STORE);
David Benjamin95d31822015-06-15 19:53:32 -04001822
David Benjamin1269ddd2015-10-18 15:18:55 -04001823 /* A client may see new sessions on abbreviated handshakes if the server
1824 * decides to renew the ticket. Once the handshake is completed, it should be
1825 * inserted into the cache. */
Steven Valdez87eab492016-06-27 16:34:59 -04001826 if (ssl->s3->established_session != ssl->session ||
David Benjaminf3c8f8d2016-11-17 17:20:47 +09001827 (!ssl->server && hs->ticket_expected)) {
David Benjamin1269ddd2015-10-18 15:18:55 -04001828 if (use_internal_cache) {
Steven Valdez87eab492016-06-27 16:34:59 -04001829 SSL_CTX_add_session(ctx, ssl->s3->established_session);
David Benjamin1269ddd2015-10-18 15:18:55 -04001830 }
David Benjaminb9195402016-08-05 10:51:43 -04001831 if (ctx->new_session_cb != NULL) {
1832 SSL_SESSION_up_ref(ssl->s3->established_session);
1833 if (!ctx->new_session_cb(ssl, ssl->s3->established_session)) {
1834 /* |new_session_cb|'s return value signals whether it took ownership. */
1835 SSL_SESSION_free(ssl->s3->established_session);
1836 }
Adam Langleyfcf25832014-12-18 17:42:32 -08001837 }
1838 }
Adam Langley95c29f32014-06-20 12:00:00 -07001839
David Benjamin1269ddd2015-10-18 15:18:55 -04001840 if (use_internal_cache &&
1841 !(ctx->session_cache_mode & SSL_SESS_CACHE_NO_AUTO_CLEAR)) {
David Benjaminb6d0c6d2015-03-19 19:07:26 -04001842 /* Automatically flush the internal session cache every 255 connections. */
1843 int flush_cache = 0;
Adam Langley4bdb6e42015-05-15 15:29:21 -07001844 CRYPTO_MUTEX_lock_write(&ctx->lock);
David Benjaminb6d0c6d2015-03-19 19:07:26 -04001845 ctx->handshakes_since_cache_flush++;
1846 if (ctx->handshakes_since_cache_flush >= 255) {
1847 flush_cache = 1;
1848 ctx->handshakes_since_cache_flush = 0;
1849 }
David Benjamin29270de2016-05-24 15:28:36 +00001850 CRYPTO_MUTEX_unlock_write(&ctx->lock);
David Benjaminb6d0c6d2015-03-19 19:07:26 -04001851
1852 if (flush_cache) {
David Benjamin721e8b72016-08-03 13:13:17 -04001853 struct timeval now;
1854 ssl_get_current_time(ssl, &now);
1855 SSL_CTX_flush_sessions(ctx, (long)now.tv_sec);
Adam Langleyfcf25832014-12-18 17:42:32 -08001856 }
1857 }
1858}
Adam Langley95c29f32014-06-20 12:00:00 -07001859
Adam Langleyfcf25832014-12-18 17:42:32 -08001860static const char *ssl_get_version(int version) {
1861 switch (version) {
Steven Valdezfdd10992016-09-15 16:27:05 -04001862 /* Report TLS 1.3 draft version as TLS 1.3 in the public API. */
1863 case TLS1_3_DRAFT_VERSION:
Steven Valdez4f94b1c2016-05-24 12:31:07 -04001864 return "TLSv1.3";
1865
Adam Langleyfcf25832014-12-18 17:42:32 -08001866 case TLS1_2_VERSION:
1867 return "TLSv1.2";
Adam Langley95c29f32014-06-20 12:00:00 -07001868
Adam Langleyfcf25832014-12-18 17:42:32 -08001869 case TLS1_1_VERSION:
1870 return "TLSv1.1";
Adam Langley95c29f32014-06-20 12:00:00 -07001871
Adam Langleyfcf25832014-12-18 17:42:32 -08001872 case TLS1_VERSION:
1873 return "TLSv1";
Adam Langley95c29f32014-06-20 12:00:00 -07001874
Adam Langleyfcf25832014-12-18 17:42:32 -08001875 case SSL3_VERSION:
1876 return "SSLv3";
Adam Langley95c29f32014-06-20 12:00:00 -07001877
David Benjamin1c722b72015-04-20 13:53:10 -04001878 case DTLS1_VERSION:
1879 return "DTLSv1";
1880
1881 case DTLS1_2_VERSION:
1882 return "DTLSv1.2";
1883
Adam Langleyfcf25832014-12-18 17:42:32 -08001884 default:
1885 return "unknown";
1886 }
1887}
Adam Langley95c29f32014-06-20 12:00:00 -07001888
David Benjamin42fea372015-09-19 01:22:44 -04001889const char *SSL_get_version(const SSL *ssl) {
1890 return ssl_get_version(ssl->version);
Adam Langleyfcf25832014-12-18 17:42:32 -08001891}
Adam Langley95c29f32014-06-20 12:00:00 -07001892
David Benjamina6b8cdf2015-09-13 14:07:33 -04001893const char *SSL_SESSION_get_version(const SSL_SESSION *session) {
1894 return ssl_get_version(session->ssl_version);
Adam Langleyfcf25832014-12-18 17:42:32 -08001895}
Adam Langley95c29f32014-06-20 12:00:00 -07001896
David Benjamin0d56f882015-12-19 17:05:56 -05001897EVP_PKEY *SSL_get_privatekey(const SSL *ssl) {
1898 if (ssl->cert != NULL) {
1899 return ssl->cert->privatekey;
Adam Langleyfcf25832014-12-18 17:42:32 -08001900 }
1901
1902 return NULL;
1903}
1904
Adam Langleyfcf25832014-12-18 17:42:32 -08001905EVP_PKEY *SSL_CTX_get0_privatekey(const SSL_CTX *ctx) {
1906 if (ctx->cert != NULL) {
David Benjamind1d80782015-07-05 11:54:09 -04001907 return ctx->cert->privatekey;
Adam Langleyfcf25832014-12-18 17:42:32 -08001908 }
1909
1910 return NULL;
1911}
1912
David Benjamin42fea372015-09-19 01:22:44 -04001913const SSL_CIPHER *SSL_get_current_cipher(const SSL *ssl) {
David Benjamin79978df2015-12-25 15:56:49 -05001914 if (ssl->s3->aead_write_ctx == NULL) {
David Benjamina07c0fc2015-05-13 13:19:42 -04001915 return NULL;
Adam Langleyfcf25832014-12-18 17:42:32 -08001916 }
David Benjamin79978df2015-12-25 15:56:49 -05001917 return ssl->s3->aead_write_ctx->cipher;
Adam Langleyfcf25832014-12-18 17:42:32 -08001918}
1919
David Benjamin936aada2016-06-07 19:09:22 -04001920int SSL_session_reused(const SSL *ssl) {
Steven Valdez4aa154e2016-07-29 14:32:55 -04001921 return ssl->s3->session_reused;
David Benjamin936aada2016-06-07 19:09:22 -04001922}
1923
David Benjamin0d56f882015-12-19 17:05:56 -05001924const COMP_METHOD *SSL_get_current_compression(SSL *ssl) { return NULL; }
Adam Langleyfcf25832014-12-18 17:42:32 -08001925
David Benjamin0d56f882015-12-19 17:05:56 -05001926const COMP_METHOD *SSL_get_current_expansion(SSL *ssl) { return NULL; }
Adam Langleyfcf25832014-12-18 17:42:32 -08001927
Adam Langley29ec5d12016-03-01 16:12:28 -08001928int *SSL_get_server_tmp_key(SSL *ssl, EVP_PKEY **out_key) { return 0; }
1929
Adam Langleyfcf25832014-12-18 17:42:32 -08001930void SSL_CTX_set_quiet_shutdown(SSL_CTX *ctx, int mode) {
Adam Langleybb85f3d2015-10-28 18:44:11 -07001931 ctx->quiet_shutdown = (mode != 0);
Adam Langleyfcf25832014-12-18 17:42:32 -08001932}
1933
1934int SSL_CTX_get_quiet_shutdown(const SSL_CTX *ctx) {
1935 return ctx->quiet_shutdown;
1936}
1937
Adam Langleybb85f3d2015-10-28 18:44:11 -07001938void SSL_set_quiet_shutdown(SSL *ssl, int mode) {
1939 ssl->quiet_shutdown = (mode != 0);
1940}
Adam Langleyfcf25832014-12-18 17:42:32 -08001941
David Benjamin9f859492015-10-03 10:44:30 -04001942int SSL_get_quiet_shutdown(const SSL *ssl) { return ssl->quiet_shutdown; }
Adam Langleyfcf25832014-12-18 17:42:32 -08001943
David Benjamin63006a92015-10-18 00:00:06 -04001944void SSL_set_shutdown(SSL *ssl, int mode) {
1945 /* It is an error to clear any bits that have already been set. (We can't try
1946 * to get a second close_notify or send two.) */
David Benjaminfa214e42016-05-10 17:03:10 -04001947 assert((SSL_get_shutdown(ssl) & mode) == SSL_get_shutdown(ssl));
David Benjamin63006a92015-10-18 00:00:06 -04001948
David Benjaminfa214e42016-05-10 17:03:10 -04001949 if (mode & SSL_RECEIVED_SHUTDOWN &&
1950 ssl->s3->recv_shutdown == ssl_shutdown_none) {
1951 ssl->s3->recv_shutdown = ssl_shutdown_close_notify;
1952 }
1953
1954 if (mode & SSL_SENT_SHUTDOWN &&
1955 ssl->s3->send_shutdown == ssl_shutdown_none) {
1956 ssl->s3->send_shutdown = ssl_shutdown_close_notify;
1957 }
David Benjamin63006a92015-10-18 00:00:06 -04001958}
Adam Langleyfcf25832014-12-18 17:42:32 -08001959
David Benjaminfa214e42016-05-10 17:03:10 -04001960int SSL_get_shutdown(const SSL *ssl) {
1961 int ret = 0;
1962 if (ssl->s3->recv_shutdown != ssl_shutdown_none) {
1963 /* Historically, OpenSSL set |SSL_RECEIVED_SHUTDOWN| on both close_notify
1964 * and fatal alert. */
1965 ret |= SSL_RECEIVED_SHUTDOWN;
1966 }
1967 if (ssl->s3->send_shutdown == ssl_shutdown_close_notify) {
1968 /* Historically, OpenSSL set |SSL_SENT_SHUTDOWN| on only close_notify. */
1969 ret |= SSL_SENT_SHUTDOWN;
1970 }
1971 return ret;
1972}
Adam Langleyfcf25832014-12-18 17:42:32 -08001973
Steven Valdezfdd10992016-09-15 16:27:05 -04001974int SSL_version(const SSL *ssl) {
1975 /* Report TLS 1.3 draft version as TLS 1.3 in the public API. */
1976 if (ssl->version == TLS1_3_DRAFT_VERSION) {
1977 return TLS1_3_VERSION;
1978 }
1979
1980 return ssl->version;
1981}
Adam Langleyfcf25832014-12-18 17:42:32 -08001982
1983SSL_CTX *SSL_get_SSL_CTX(const SSL *ssl) { return ssl->ctx; }
1984
1985SSL_CTX *SSL_set_SSL_CTX(SSL *ssl, SSL_CTX *ctx) {
1986 if (ssl->ctx == ctx) {
1987 return ssl->ctx;
1988 }
1989
Adam Langley3509dac2017-02-01 11:59:18 -08001990 /* One cannot change the X.509 callbacks during a connection. */
1991 if (ssl->ctx->x509_method != ctx->x509_method) {
1992 assert(0);
1993 return NULL;
1994 }
1995
Adam Langleyfcf25832014-12-18 17:42:32 -08001996 if (ctx == NULL) {
1997 ctx = ssl->initial_ctx;
1998 }
1999
David Benjamin2755a3e2015-04-22 16:17:58 -04002000 ssl_cert_free(ssl->cert);
Adam Langleyfcf25832014-12-18 17:42:32 -08002001 ssl->cert = ssl_cert_dup(ctx->cert);
David Benjamin2755a3e2015-04-22 16:17:58 -04002002
David Benjaminf650c712016-12-22 15:54:51 -05002003 SSL_CTX_up_ref(ctx);
2004 SSL_CTX_free(ssl->ctx);
Adam Langleyfcf25832014-12-18 17:42:32 -08002005 ssl->ctx = ctx;
2006
Adam Langleyfcf25832014-12-18 17:42:32 -08002007 return ssl->ctx;
2008}
2009
Adam Langley95c29f32014-06-20 12:00:00 -07002010void SSL_set_info_callback(SSL *ssl,
David Benjamin82170242015-10-17 22:51:17 -04002011 void (*cb)(const SSL *ssl, int type, int value)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002012 ssl->info_callback = cb;
2013}
Adam Langley95c29f32014-06-20 12:00:00 -07002014
David Benjamin82170242015-10-17 22:51:17 -04002015void (*SSL_get_info_callback(const SSL *ssl))(const SSL *ssl, int type,
2016 int value) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002017 return ssl->info_callback;
2018}
Adam Langley95c29f32014-06-20 12:00:00 -07002019
David Benjamincb0c29f2016-12-12 17:00:50 -05002020int SSL_state(const SSL *ssl) {
David Benjamin9e766d72017-02-10 23:14:17 -05002021 return SSL_in_init(ssl) ? SSL_ST_INIT : SSL_ST_OK;
David Benjamincb0c29f2016-12-12 17:00:50 -05002022}
Adam Langley95c29f32014-06-20 12:00:00 -07002023
David Benjaminece089c2015-05-15 23:52:42 -04002024void SSL_set_state(SSL *ssl, int state) { }
Adam Langley95c29f32014-06-20 12:00:00 -07002025
Emily Stark95a79ee2016-02-25 21:12:28 -08002026char *SSL_get_shared_ciphers(const SSL *ssl, char *buf, int len) {
2027 if (len <= 0) {
2028 return NULL;
2029 }
2030 buf[0] = '\0';
2031 return buf;
2032}
2033
David Benjamin8a589332015-12-04 23:14:35 -05002034int SSL_get_ex_new_index(long argl, void *argp, CRYPTO_EX_unused *unused,
Adam Langleyfcf25832014-12-18 17:42:32 -08002035 CRYPTO_EX_dup *dup_func, CRYPTO_EX_free *free_func) {
David Benjamin9f33fc62015-04-15 17:29:53 -04002036 int index;
2037 if (!CRYPTO_get_ex_new_index(&g_ex_data_class_ssl, &index, argl, argp,
David Benjamin8a589332015-12-04 23:14:35 -05002038 dup_func, free_func)) {
David Benjamin9f33fc62015-04-15 17:29:53 -04002039 return -1;
2040 }
2041 return index;
Adam Langleyfcf25832014-12-18 17:42:32 -08002042}
Adam Langley95c29f32014-06-20 12:00:00 -07002043
David Benjamin1ac08fe2015-09-15 01:36:22 -04002044int SSL_set_ex_data(SSL *ssl, int idx, void *arg) {
2045 return CRYPTO_set_ex_data(&ssl->ex_data, idx, arg);
Adam Langleyfcf25832014-12-18 17:42:32 -08002046}
Adam Langley95c29f32014-06-20 12:00:00 -07002047
David Benjamin1ac08fe2015-09-15 01:36:22 -04002048void *SSL_get_ex_data(const SSL *ssl, int idx) {
2049 return CRYPTO_get_ex_data(&ssl->ex_data, idx);
Adam Langleyfcf25832014-12-18 17:42:32 -08002050}
Adam Langley95c29f32014-06-20 12:00:00 -07002051
David Benjamin8a589332015-12-04 23:14:35 -05002052int SSL_CTX_get_ex_new_index(long argl, void *argp, CRYPTO_EX_unused *unused,
Adam Langleyfcf25832014-12-18 17:42:32 -08002053 CRYPTO_EX_dup *dup_func,
2054 CRYPTO_EX_free *free_func) {
David Benjamin9f33fc62015-04-15 17:29:53 -04002055 int index;
2056 if (!CRYPTO_get_ex_new_index(&g_ex_data_class_ssl_ctx, &index, argl, argp,
David Benjamin8a589332015-12-04 23:14:35 -05002057 dup_func, free_func)) {
David Benjamin9f33fc62015-04-15 17:29:53 -04002058 return -1;
2059 }
2060 return index;
Adam Langleyfcf25832014-12-18 17:42:32 -08002061}
Adam Langley95c29f32014-06-20 12:00:00 -07002062
David Benjamin1ac08fe2015-09-15 01:36:22 -04002063int SSL_CTX_set_ex_data(SSL_CTX *ctx, int idx, void *arg) {
2064 return CRYPTO_set_ex_data(&ctx->ex_data, idx, arg);
Adam Langleyfcf25832014-12-18 17:42:32 -08002065}
Adam Langley95c29f32014-06-20 12:00:00 -07002066
David Benjamin1ac08fe2015-09-15 01:36:22 -04002067void *SSL_CTX_get_ex_data(const SSL_CTX *ctx, int idx) {
2068 return CRYPTO_get_ex_data(&ctx->ex_data, idx);
Adam Langleyfcf25832014-12-18 17:42:32 -08002069}
Adam Langley95c29f32014-06-20 12:00:00 -07002070
David Benjamin93d17492015-10-17 12:43:36 -04002071int SSL_want(const SSL *ssl) { return ssl->rwstate; }
Adam Langley95c29f32014-06-20 12:00:00 -07002072
Adam Langleyfcf25832014-12-18 17:42:32 -08002073void SSL_CTX_set_tmp_rsa_callback(SSL_CTX *ctx,
2074 RSA *(*cb)(SSL *ssl, int is_export,
2075 int keylength)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002076}
Adam Langley95c29f32014-06-20 12:00:00 -07002077
Adam Langleyfcf25832014-12-18 17:42:32 -08002078void SSL_set_tmp_rsa_callback(SSL *ssl, RSA *(*cb)(SSL *ssl, int is_export,
2079 int keylength)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002080}
2081
2082void SSL_CTX_set_tmp_dh_callback(SSL_CTX *ctx,
David Benjamin59015c32015-04-26 13:13:55 -04002083 DH *(*callback)(SSL *ssl, int is_export,
2084 int keylength)) {
2085 ctx->cert->dh_tmp_cb = callback;
Adam Langleyfcf25832014-12-18 17:42:32 -08002086}
2087
David Benjamin59015c32015-04-26 13:13:55 -04002088void SSL_set_tmp_dh_callback(SSL *ssl, DH *(*callback)(SSL *ssl, int is_export,
2089 int keylength)) {
2090 ssl->cert->dh_tmp_cb = callback;
Adam Langleyfcf25832014-12-18 17:42:32 -08002091}
2092
Adam Langleyfcf25832014-12-18 17:42:32 -08002093int SSL_CTX_use_psk_identity_hint(SSL_CTX *ctx, const char *identity_hint) {
2094 if (identity_hint != NULL && strlen(identity_hint) > PSK_MAX_IDENTITY_LEN) {
David Benjamin3570d732015-06-29 00:28:17 -04002095 OPENSSL_PUT_ERROR(SSL, SSL_R_DATA_LENGTH_TOO_LONG);
Adam Langleyfcf25832014-12-18 17:42:32 -08002096 return 0;
2097 }
2098
David Benjamin2755a3e2015-04-22 16:17:58 -04002099 OPENSSL_free(ctx->psk_identity_hint);
Adam Langleyfcf25832014-12-18 17:42:32 -08002100
2101 if (identity_hint != NULL) {
2102 ctx->psk_identity_hint = BUF_strdup(identity_hint);
2103 if (ctx->psk_identity_hint == NULL) {
2104 return 0;
Adam Langley95c29f32014-06-20 12:00:00 -07002105 }
Adam Langleyfcf25832014-12-18 17:42:32 -08002106 } else {
2107 ctx->psk_identity_hint = NULL;
2108 }
Adam Langley95c29f32014-06-20 12:00:00 -07002109
Adam Langleyfcf25832014-12-18 17:42:32 -08002110 return 1;
2111}
2112
David Benjamine8814df2015-09-15 08:05:54 -04002113int SSL_use_psk_identity_hint(SSL *ssl, const char *identity_hint) {
2114 if (ssl == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002115 return 0;
2116 }
2117
2118 if (identity_hint != NULL && strlen(identity_hint) > PSK_MAX_IDENTITY_LEN) {
David Benjamin3570d732015-06-29 00:28:17 -04002119 OPENSSL_PUT_ERROR(SSL, SSL_R_DATA_LENGTH_TOO_LONG);
Adam Langleyfcf25832014-12-18 17:42:32 -08002120 return 0;
2121 }
2122
2123 /* Clear currently configured hint, if any. */
David Benjamine8814df2015-09-15 08:05:54 -04002124 OPENSSL_free(ssl->psk_identity_hint);
2125 ssl->psk_identity_hint = NULL;
Adam Langleyfcf25832014-12-18 17:42:32 -08002126
David Benjamin78679342016-09-16 19:42:05 -04002127 /* Treat the empty hint as not supplying one. Plain PSK makes it possible to
2128 * send either no hint (omit ServerKeyExchange) or an empty hint, while
2129 * ECDHE_PSK can only spell empty hint. Having different capabilities is odd,
2130 * so we interpret empty and missing as identical. */
2131 if (identity_hint != NULL && identity_hint[0] != '\0') {
David Benjamine8814df2015-09-15 08:05:54 -04002132 ssl->psk_identity_hint = BUF_strdup(identity_hint);
2133 if (ssl->psk_identity_hint == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002134 return 0;
Adam Langley95c29f32014-06-20 12:00:00 -07002135 }
Adam Langleyfcf25832014-12-18 17:42:32 -08002136 }
Adam Langley95c29f32014-06-20 12:00:00 -07002137
Adam Langleyfcf25832014-12-18 17:42:32 -08002138 return 1;
2139}
Adam Langley95c29f32014-06-20 12:00:00 -07002140
David Benjamine8814df2015-09-15 08:05:54 -04002141const char *SSL_get_psk_identity_hint(const SSL *ssl) {
2142 if (ssl == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002143 return NULL;
2144 }
David Benjamine8814df2015-09-15 08:05:54 -04002145 return ssl->psk_identity_hint;
Adam Langleyfcf25832014-12-18 17:42:32 -08002146}
Adam Langley95c29f32014-06-20 12:00:00 -07002147
David Benjamine8814df2015-09-15 08:05:54 -04002148const char *SSL_get_psk_identity(const SSL *ssl) {
Steven Valdez87eab492016-06-27 16:34:59 -04002149 if (ssl == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002150 return NULL;
2151 }
Steven Valdez87eab492016-06-27 16:34:59 -04002152 SSL_SESSION *session = SSL_get_session(ssl);
2153 if (session == NULL) {
2154 return NULL;
2155 }
2156 return session->psk_identity;
Adam Langleyfcf25832014-12-18 17:42:32 -08002157}
Adam Langley95c29f32014-06-20 12:00:00 -07002158
Adam Langleyfcf25832014-12-18 17:42:32 -08002159void SSL_set_psk_client_callback(
David Benjamine8814df2015-09-15 08:05:54 -04002160 SSL *ssl, unsigned (*cb)(SSL *ssl, const char *hint, char *identity,
2161 unsigned max_identity_len, uint8_t *psk,
2162 unsigned max_psk_len)) {
2163 ssl->psk_client_callback = cb;
Adam Langleyfcf25832014-12-18 17:42:32 -08002164}
Adam Langley95c29f32014-06-20 12:00:00 -07002165
Adam Langleyfcf25832014-12-18 17:42:32 -08002166void SSL_CTX_set_psk_client_callback(
David Benjamine8814df2015-09-15 08:05:54 -04002167 SSL_CTX *ctx, unsigned (*cb)(SSL *ssl, const char *hint, char *identity,
2168 unsigned max_identity_len, uint8_t *psk,
2169 unsigned max_psk_len)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002170 ctx->psk_client_callback = cb;
2171}
Adam Langley95c29f32014-06-20 12:00:00 -07002172
Adam Langleyfcf25832014-12-18 17:42:32 -08002173void SSL_set_psk_server_callback(
David Benjamine8814df2015-09-15 08:05:54 -04002174 SSL *ssl, unsigned (*cb)(SSL *ssl, const char *identity, uint8_t *psk,
2175 unsigned max_psk_len)) {
2176 ssl->psk_server_callback = cb;
Adam Langleyfcf25832014-12-18 17:42:32 -08002177}
Adam Langley95c29f32014-06-20 12:00:00 -07002178
Adam Langleyfcf25832014-12-18 17:42:32 -08002179void SSL_CTX_set_psk_server_callback(
David Benjamine8814df2015-09-15 08:05:54 -04002180 SSL_CTX *ctx, unsigned (*cb)(SSL *ssl, const char *identity,
2181 uint8_t *psk, unsigned max_psk_len)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002182 ctx->psk_server_callback = cb;
2183}
Adam Langley95c29f32014-06-20 12:00:00 -07002184
Adam Langleyfcf25832014-12-18 17:42:32 -08002185void SSL_CTX_set_msg_callback(SSL_CTX *ctx,
2186 void (*cb)(int write_p, int version,
2187 int content_type, const void *buf,
2188 size_t len, SSL *ssl, void *arg)) {
David Benjamin59015c32015-04-26 13:13:55 -04002189 ctx->msg_callback = cb;
Adam Langleyfcf25832014-12-18 17:42:32 -08002190}
David Benjamin61ecccf2015-05-05 09:44:51 -04002191
2192void SSL_CTX_set_msg_callback_arg(SSL_CTX *ctx, void *arg) {
2193 ctx->msg_callback_arg = arg;
2194}
2195
Adam Langleyfcf25832014-12-18 17:42:32 -08002196void SSL_set_msg_callback(SSL *ssl,
2197 void (*cb)(int write_p, int version, int content_type,
2198 const void *buf, size_t len, SSL *ssl,
2199 void *arg)) {
David Benjamin59015c32015-04-26 13:13:55 -04002200 ssl->msg_callback = cb;
Adam Langleyfcf25832014-12-18 17:42:32 -08002201}
Adam Langley95c29f32014-06-20 12:00:00 -07002202
David Benjamin61ecccf2015-05-05 09:44:51 -04002203void SSL_set_msg_callback_arg(SSL *ssl, void *arg) {
2204 ssl->msg_callback_arg = arg;
2205}
2206
David Benjamind28f59c2015-11-17 22:32:50 -05002207void SSL_CTX_set_keylog_callback(SSL_CTX *ctx,
2208 void (*cb)(const SSL *ssl, const char *line)) {
2209 ctx->keylog_callback = cb;
Adam Langleyfcf25832014-12-18 17:42:32 -08002210}
Adam Langley95c29f32014-06-20 12:00:00 -07002211
David Benjamin6e3f5cc2016-09-14 14:43:14 -04002212void (*SSL_CTX_get_keylog_callback(const SSL_CTX *ctx))(const SSL *ssl,
2213 const char *line) {
2214 return ctx->keylog_callback;
2215}
2216
Taylor Brandstetter9edb2c62016-06-08 15:26:59 -07002217void SSL_CTX_set_current_time_cb(SSL_CTX *ctx,
2218 void (*cb)(const SSL *ssl,
2219 struct timeval *out_clock)) {
2220 ctx->current_time_cb = cb;
2221}
2222
Adam Langleyfcf25832014-12-18 17:42:32 -08002223static int cbb_add_hex(CBB *cbb, const uint8_t *in, size_t in_len) {
2224 static const char hextable[] = "0123456789abcdef";
2225 uint8_t *out;
Adam Langley95c29f32014-06-20 12:00:00 -07002226
Adam Langleyfcf25832014-12-18 17:42:32 -08002227 if (!CBB_add_space(cbb, &out, in_len * 2)) {
2228 return 0;
2229 }
Adam Langley95c29f32014-06-20 12:00:00 -07002230
David Benjamin54091232016-09-05 12:47:25 -04002231 for (size_t i = 0; i < in_len; i++) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002232 *(out++) = (uint8_t)hextable[in[i] >> 4];
2233 *(out++) = (uint8_t)hextable[in[i] & 0xf];
2234 }
Adam Langley95c29f32014-06-20 12:00:00 -07002235
Adam Langleyfcf25832014-12-18 17:42:32 -08002236 return 1;
2237}
David Benjamin859ec3c2014-09-02 16:29:36 -04002238
David Benjamine776cc22016-07-19 07:26:49 +02002239int ssl_log_secret(const SSL *ssl, const char *label, const uint8_t *secret,
2240 size_t secret_len) {
David Benjamind28f59c2015-11-17 22:32:50 -05002241 if (ssl->ctx->keylog_callback == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002242 return 1;
2243 }
Adam Langleyadb739e2014-06-20 12:00:00 -07002244
David Benjamind28f59c2015-11-17 22:32:50 -05002245 CBB cbb;
2246 uint8_t *out;
2247 size_t out_len;
David Benjamine776cc22016-07-19 07:26:49 +02002248 if (!CBB_init(&cbb, strlen(label) + 1 + SSL3_RANDOM_SIZE * 2 + 1 +
2249 secret_len * 2 + 1) ||
2250 !CBB_add_bytes(&cbb, (const uint8_t *)label, strlen(label)) ||
Adam Langleyfcf25832014-12-18 17:42:32 -08002251 !CBB_add_bytes(&cbb, (const uint8_t *)" ", 1) ||
David Benjamine776cc22016-07-19 07:26:49 +02002252 !cbb_add_hex(&cbb, ssl->s3->client_random, SSL3_RANDOM_SIZE) ||
2253 !CBB_add_bytes(&cbb, (const uint8_t *)" ", 1) ||
2254 !cbb_add_hex(&cbb, secret, secret_len) ||
David Benjamind28f59c2015-11-17 22:32:50 -05002255 !CBB_add_u8(&cbb, 0 /* NUL */) ||
Adam Langleyfcf25832014-12-18 17:42:32 -08002256 !CBB_finish(&cbb, &out, &out_len)) {
2257 CBB_cleanup(&cbb);
2258 return 0;
2259 }
Adam Langleyadb739e2014-06-20 12:00:00 -07002260
David Benjamind28f59c2015-11-17 22:32:50 -05002261 ssl->ctx->keylog_callback(ssl, (const char *)out);
Adam Langleyfcf25832014-12-18 17:42:32 -08002262 OPENSSL_free(out);
David Benjamind28f59c2015-11-17 22:32:50 -05002263 return 1;
Adam Langley95c29f32014-06-20 12:00:00 -07002264}
2265
David Benjamin5d8b1282015-10-17 23:26:35 -04002266int SSL_is_init_finished(const SSL *ssl) {
David Benjamin9e766d72017-02-10 23:14:17 -05002267 return !SSL_in_init(ssl);
David Benjamin5d8b1282015-10-17 23:26:35 -04002268}
2269
2270int SSL_in_init(const SSL *ssl) {
David Benjamin9e766d72017-02-10 23:14:17 -05002271 SSL_HANDSHAKE *hs = ssl->s3->hs;
2272 return hs != NULL && hs->state != SSL_ST_OK;
David Benjamin5d8b1282015-10-17 23:26:35 -04002273}
2274
2275int SSL_in_false_start(const SSL *ssl) {
David Benjamina0486782016-10-06 19:11:32 -04002276 if (ssl->s3->hs == NULL) {
2277 return 0;
2278 }
2279 return ssl->s3->hs->in_false_start;
David Benjamined7c4752015-02-16 19:16:46 -05002280}
2281
David Benjamin0d56f882015-12-19 17:05:56 -05002282int SSL_cutthrough_complete(const SSL *ssl) {
2283 return SSL_in_false_start(ssl);
Adam Langleyfcf25832014-12-18 17:42:32 -08002284}
Adam Langley95c29f32014-06-20 12:00:00 -07002285
Adam Langleyfcf25832014-12-18 17:42:32 -08002286void SSL_get_structure_sizes(size_t *ssl_size, size_t *ssl_ctx_size,
2287 size_t *ssl_session_size) {
2288 *ssl_size = sizeof(SSL);
2289 *ssl_ctx_size = sizeof(SSL_CTX);
2290 *ssl_session_size = sizeof(SSL_SESSION);
2291}
Feng Lu41aa3252014-11-21 22:47:56 -08002292
David Benjamin0d56f882015-12-19 17:05:56 -05002293int ssl3_can_false_start(const SSL *ssl) {
2294 const SSL_CIPHER *const cipher = SSL_get_current_cipher(ssl);
Adam Langleyfcf25832014-12-18 17:42:32 -08002295
Adam Langleye631d962015-04-01 13:11:01 -07002296 /* False Start only for TLS 1.2 with an ECDHE+AEAD cipher and ALPN or NPN. */
David Benjamince079fd2016-08-02 16:22:34 -04002297 return !SSL_is_dtls(ssl) &&
Steven Valdez4f94b1c2016-05-24 12:31:07 -04002298 SSL_version(ssl) == TLS1_2_VERSION &&
David Benjaminb74b0812016-10-06 19:43:48 -04002299 (ssl->s3->alpn_selected != NULL ||
2300 ssl->s3->next_proto_negotiated != NULL) &&
David Benjamin195dc782015-02-19 13:27:05 -05002301 cipher != NULL &&
Matthew Braithwaite651aaef2016-12-08 16:14:36 -08002302 cipher->algorithm_mkey == SSL_kECDHE &&
David Benjamin13414b32015-12-09 23:02:39 -05002303 cipher->algorithm_mac == SSL_AEAD;
Adam Langleyfcf25832014-12-18 17:42:32 -08002304}
2305
David Benjaminb6a0a512016-06-21 10:33:21 -04002306const struct {
2307 uint16_t version;
2308 uint32_t flag;
2309} kVersions[] = {
2310 {SSL3_VERSION, SSL_OP_NO_SSLv3},
2311 {TLS1_VERSION, SSL_OP_NO_TLSv1},
2312 {TLS1_1_VERSION, SSL_OP_NO_TLSv1_1},
2313 {TLS1_2_VERSION, SSL_OP_NO_TLSv1_2},
2314 {TLS1_3_VERSION, SSL_OP_NO_TLSv1_3},
2315};
Adam Langleyfcf25832014-12-18 17:42:32 -08002316
Steven Valdezcb966542016-08-17 16:56:14 -04002317static const size_t kVersionsLen = OPENSSL_ARRAY_SIZE(kVersions);
Adam Langleyfcf25832014-12-18 17:42:32 -08002318
David Benjamine0ff7672016-09-19 18:40:03 -04002319int ssl_get_version_range(const SSL *ssl, uint16_t *out_min_version,
2320 uint16_t *out_max_version) {
David Benjaminb6a0a512016-06-21 10:33:21 -04002321 /* For historical reasons, |SSL_OP_NO_DTLSv1| aliases |SSL_OP_NO_TLSv1|, but
2322 * DTLS 1.0 should be mapped to TLS 1.1. */
David Benjamin0d56f882015-12-19 17:05:56 -05002323 uint32_t options = ssl->options;
David Benjamince079fd2016-08-02 16:22:34 -04002324 if (SSL_is_dtls(ssl)) {
David Benjaminb6a0a512016-06-21 10:33:21 -04002325 options &= ~SSL_OP_NO_TLSv1_1;
2326 if (options & SSL_OP_NO_DTLSv1) {
2327 options |= SSL_OP_NO_TLSv1_1;
2328 }
2329 }
2330
2331 uint16_t min_version = ssl->min_version;
2332 uint16_t max_version = ssl->max_version;
2333
2334 /* Bound the range to only those implemented in this protocol. */
2335 if (min_version < ssl->method->min_version) {
2336 min_version = ssl->method->min_version;
2337 }
2338 if (max_version > ssl->method->max_version) {
2339 max_version = ssl->method->max_version;
2340 }
Adam Langleyfcf25832014-12-18 17:42:32 -08002341
2342 /* OpenSSL's API for controlling versions entails blacklisting individual
2343 * protocols. This has two problems. First, on the client, the protocol can
2344 * only express a contiguous range of versions. Second, a library consumer
2345 * trying to set a maximum version cannot disable protocol versions that get
2346 * added in a future version of the library.
2347 *
2348 * To account for both of these, OpenSSL interprets the client-side bitmask
2349 * as a min/max range by picking the lowest contiguous non-empty range of
2350 * enabled protocols. Note that this means it is impossible to set a maximum
David Benjaminb6a0a512016-06-21 10:33:21 -04002351 * version of the higest supported TLS version in a future-proof way. */
David Benjaminb6a0a512016-06-21 10:33:21 -04002352 int any_enabled = 0;
David Benjamin54091232016-09-05 12:47:25 -04002353 for (size_t i = 0; i < kVersionsLen; i++) {
David Benjaminb6a0a512016-06-21 10:33:21 -04002354 /* Only look at the versions already enabled. */
2355 if (min_version > kVersions[i].version) {
2356 continue;
Adam Langleyfcf25832014-12-18 17:42:32 -08002357 }
David Benjaminb6a0a512016-06-21 10:33:21 -04002358 if (max_version < kVersions[i].version) {
2359 break;
Adam Langleyfcf25832014-12-18 17:42:32 -08002360 }
David Benjaminb6a0a512016-06-21 10:33:21 -04002361
2362 if (!(options & kVersions[i].flag)) {
2363 /* The minimum version is the first enabled version. */
2364 if (!any_enabled) {
2365 any_enabled = 1;
2366 min_version = kVersions[i].version;
2367 }
2368 continue;
Adam Langleyfcf25832014-12-18 17:42:32 -08002369 }
David Benjaminb6a0a512016-06-21 10:33:21 -04002370
2371 /* If there is a disabled version after the first enabled one, all versions
2372 * after it are implicitly disabled. */
2373 if (any_enabled) {
2374 max_version = kVersions[i-1].version;
2375 break;
Adam Langleyfcf25832014-12-18 17:42:32 -08002376 }
2377 }
2378
David Benjamine0ff7672016-09-19 18:40:03 -04002379 if (!any_enabled) {
David Benjaminb6a0a512016-06-21 10:33:21 -04002380 OPENSSL_PUT_ERROR(SSL, SSL_R_WRONG_SSL_VERSION);
2381 return 0;
David Benjaminea72bd02014-12-21 21:27:41 -05002382 }
2383
David Benjaminb6a0a512016-06-21 10:33:21 -04002384 *out_min_version = min_version;
2385 *out_max_version = max_version;
2386 return 1;
David Benjaminea72bd02014-12-21 21:27:41 -05002387}
2388
David Benjaminb9e4fa52015-12-29 23:58:17 -05002389uint16_t ssl3_protocol_version(const SSL *ssl) {
2390 assert(ssl->s3->have_version);
David Benjamin2dc02042016-09-19 19:57:37 -04002391 uint16_t version;
2392 if (!ssl->method->version_from_wire(&version, ssl->version)) {
2393 /* TODO(davidben): Use the internal version representation for ssl->version
2394 * and map to the public API representation at API boundaries. */
2395 assert(0);
2396 return 0;
2397 }
2398
2399 return version;
David Benjaminb9e4fa52015-12-29 23:58:17 -05002400}
2401
David Benjamince079fd2016-08-02 16:22:34 -04002402int SSL_is_server(const SSL *ssl) { return ssl->server; }
2403
2404int SSL_is_dtls(const SSL *ssl) { return ssl->method->is_dtls; }
Adam Langleyfcf25832014-12-18 17:42:32 -08002405
David Benjamin731058e2016-12-03 23:15:13 -05002406void SSL_CTX_set_select_certificate_cb(SSL_CTX *ctx,
2407 int (*cb)(const SSL_CLIENT_HELLO *)) {
David Benjamind4c2bce2015-10-17 12:28:18 -04002408 ctx->select_certificate_cb = cb;
2409}
2410
David Benjamin731058e2016-12-03 23:15:13 -05002411void SSL_CTX_set_dos_protection_cb(SSL_CTX *ctx,
2412 int (*cb)(const SSL_CLIENT_HELLO *)) {
Adam Langley524e7172015-02-20 16:04:00 -08002413 ctx->dos_protection_cb = cb;
2414}
2415
David Benjamin1d5ef3b2015-10-12 19:54:18 -04002416void SSL_set_renegotiate_mode(SSL *ssl, enum ssl_renegotiate_mode_t mode) {
2417 ssl->renegotiate_mode = mode;
2418}
2419
Adam Langleyc2d32802015-11-03 18:36:10 -08002420int SSL_get_ivs(const SSL *ssl, const uint8_t **out_read_iv,
2421 const uint8_t **out_write_iv, size_t *out_iv_len) {
David Benjamin79978df2015-12-25 15:56:49 -05002422 if (ssl->s3->aead_read_ctx == NULL || ssl->s3->aead_write_ctx == NULL) {
Adam Langleyc2d32802015-11-03 18:36:10 -08002423 return 0;
2424 }
2425
2426 size_t write_iv_len;
David Benjamin79978df2015-12-25 15:56:49 -05002427 if (!EVP_AEAD_CTX_get_iv(&ssl->s3->aead_read_ctx->ctx, out_read_iv,
2428 out_iv_len) ||
2429 !EVP_AEAD_CTX_get_iv(&ssl->s3->aead_write_ctx->ctx, out_write_iv,
Adam Langleyc2d32802015-11-03 18:36:10 -08002430 &write_iv_len) ||
2431 *out_iv_len != write_iv_len) {
2432 return 0;
2433 }
2434
2435 return 1;
David Benjamine348ff42015-11-06 17:55:30 -05002436}
David Benjamin6e807652015-11-02 12:02:20 -05002437
David Benjamin91b25012016-01-21 16:39:58 -05002438static uint64_t be_to_u64(const uint8_t in[8]) {
David Benjaminde942382016-02-11 12:02:01 -05002439 return (((uint64_t)in[0]) << 56) | (((uint64_t)in[1]) << 48) |
2440 (((uint64_t)in[2]) << 40) | (((uint64_t)in[3]) << 32) |
2441 (((uint64_t)in[4]) << 24) | (((uint64_t)in[5]) << 16) |
2442 (((uint64_t)in[6]) << 8) | ((uint64_t)in[7]);
David Benjamin91b25012016-01-21 16:39:58 -05002443}
2444
2445uint64_t SSL_get_read_sequence(const SSL *ssl) {
2446 /* TODO(davidben): Internally represent sequence numbers as uint64_t. */
David Benjamince079fd2016-08-02 16:22:34 -04002447 if (SSL_is_dtls(ssl)) {
David Benjaminde942382016-02-11 12:02:01 -05002448 /* max_seq_num already includes the epoch. */
2449 assert(ssl->d1->r_epoch == (ssl->d1->bitmap.max_seq_num >> 48));
2450 return ssl->d1->bitmap.max_seq_num;
2451 }
David Benjamin91b25012016-01-21 16:39:58 -05002452 return be_to_u64(ssl->s3->read_sequence);
2453}
2454
2455uint64_t SSL_get_write_sequence(const SSL *ssl) {
David Benjaminde942382016-02-11 12:02:01 -05002456 uint64_t ret = be_to_u64(ssl->s3->write_sequence);
David Benjamince079fd2016-08-02 16:22:34 -04002457 if (SSL_is_dtls(ssl)) {
David Benjaminde942382016-02-11 12:02:01 -05002458 assert((ret >> 48) == 0);
2459 ret |= ((uint64_t)ssl->d1->w_epoch) << 48;
2460 }
2461 return ret;
David Benjamin91b25012016-01-21 16:39:58 -05002462}
2463
Steven Valdez02563852016-06-23 13:33:05 -04002464uint16_t SSL_get_peer_signature_algorithm(const SSL *ssl) {
David Benjaminf1050fd2016-12-13 20:05:36 -05002465 /* TODO(davidben): This checks the wrong session if there is a renegotiation
2466 * in progress. */
2467 SSL_SESSION *session = SSL_get_session(ssl);
2468 if (session == NULL) {
2469 return 0;
2470 }
2471
2472 return session->peer_signature_algorithm;
Steven Valdez02563852016-06-23 13:33:05 -04002473}
2474
David Benjamin96ba15f2015-12-25 14:10:17 -05002475size_t SSL_get_client_random(const SSL *ssl, uint8_t *out, size_t max_out) {
2476 if (max_out == 0) {
2477 return sizeof(ssl->s3->client_random);
2478 }
2479 if (max_out > sizeof(ssl->s3->client_random)) {
2480 max_out = sizeof(ssl->s3->client_random);
2481 }
David Benjamin17cf2cb2016-12-13 01:07:13 -05002482 OPENSSL_memcpy(out, ssl->s3->client_random, max_out);
David Benjamin96ba15f2015-12-25 14:10:17 -05002483 return max_out;
2484}
2485
2486size_t SSL_get_server_random(const SSL *ssl, uint8_t *out, size_t max_out) {
2487 if (max_out == 0) {
2488 return sizeof(ssl->s3->server_random);
2489 }
2490 if (max_out > sizeof(ssl->s3->server_random)) {
2491 max_out = sizeof(ssl->s3->server_random);
2492 }
David Benjamin17cf2cb2016-12-13 01:07:13 -05002493 OPENSSL_memcpy(out, ssl->s3->server_random, max_out);
David Benjamin96ba15f2015-12-25 14:10:17 -05002494 return max_out;
2495}
2496
David Benjaminf6494f42016-01-07 12:37:41 -08002497const SSL_CIPHER *SSL_get_pending_cipher(const SSL *ssl) {
2498 if (!SSL_in_init(ssl)) {
2499 return NULL;
2500 }
2501 return ssl->s3->tmp.new_cipher;
2502}
2503
David Benjaminbbaf3672016-11-17 10:53:09 +09002504void SSL_set_retain_only_sha256_of_client_certs(SSL *ssl, int enabled) {
2505 ssl->retain_only_sha256_of_client_certs = !!enabled;
2506}
2507
David Benjamincdd0b7e2016-01-07 10:10:41 -08002508void SSL_CTX_set_retain_only_sha256_of_client_certs(SSL_CTX *ctx, int enabled) {
2509 ctx->retain_only_sha256_of_client_certs = !!enabled;
2510}
2511
David Benjamin65ac9972016-09-02 21:35:25 -04002512void SSL_CTX_set_grease_enabled(SSL_CTX *ctx, int enabled) {
2513 ctx->grease_enabled = !!enabled;
2514}
2515
David Benjamin6f600d62016-12-21 16:06:54 -05002516void SSL_CTX_set_short_header_enabled(SSL_CTX *ctx, int enabled) {
2517 ctx->short_header_enabled = !!enabled;
2518}
2519
David Benjamin27bbae42015-09-13 00:54:37 -04002520int SSL_clear(SSL *ssl) {
David Benjaminb79cc842016-12-07 15:57:14 -05002521 /* In OpenSSL, reusing a client |SSL| with |SSL_clear| causes the previously
2522 * established session to be offered the next time around. wpa_supplicant
2523 * depends on this behavior, so emulate it. */
2524 SSL_SESSION *session = NULL;
2525 if (!ssl->server && ssl->s3->established_session != NULL) {
2526 session = ssl->s3->established_session;
2527 SSL_SESSION_up_ref(session);
2528 }
2529
David Benjamin27bbae42015-09-13 00:54:37 -04002530 /* TODO(davidben): Some state on |ssl| is reset both in |SSL_new| and
2531 * |SSL_clear| because it is per-connection state rather than configuration
2532 * state. Per-connection state should be on |ssl->s3| and |ssl->d1| so it is
2533 * naturally reset at the right points between |SSL_new|, |SSL_clear|, and
2534 * |ssl3_new|. */
2535
2536 ssl->rwstate = SSL_NOTHING;
2537
2538 BUF_MEM_free(ssl->init_buf);
2539 ssl->init_buf = NULL;
David Benjamin49054542016-07-27 13:51:01 -04002540 ssl->init_msg = NULL;
2541 ssl->init_num = 0;
David Benjamin27bbae42015-09-13 00:54:37 -04002542
David Benjamin27bbae42015-09-13 00:54:37 -04002543 /* The ssl->d1->mtu is simultaneously configuration (preserved across
2544 * clear) and connection-specific state (gets reset).
2545 *
2546 * TODO(davidben): Avoid this. */
2547 unsigned mtu = 0;
2548 if (ssl->d1 != NULL) {
2549 mtu = ssl->d1->mtu;
2550 }
2551
2552 ssl->method->ssl_free(ssl);
2553 if (!ssl->method->ssl_new(ssl)) {
David Benjaminb79cc842016-12-07 15:57:14 -05002554 SSL_SESSION_free(session);
David Benjamin27bbae42015-09-13 00:54:37 -04002555 return 0;
2556 }
David Benjamin27bbae42015-09-13 00:54:37 -04002557
David Benjamince079fd2016-08-02 16:22:34 -04002558 if (SSL_is_dtls(ssl) && (SSL_get_options(ssl) & SSL_OP_NO_QUERY_MTU)) {
David Benjamin27bbae42015-09-13 00:54:37 -04002559 ssl->d1->mtu = mtu;
2560 }
2561
David Benjaminb79cc842016-12-07 15:57:14 -05002562 if (session != NULL) {
2563 SSL_set_session(ssl, session);
2564 SSL_SESSION_free(session);
2565 }
2566
David Benjamin27bbae42015-09-13 00:54:37 -04002567 return 1;
2568}
2569
David Benjamin4e9cc712016-06-01 20:16:03 -04002570void ssl_do_info_callback(const SSL *ssl, int type, int value) {
2571 void (*cb)(const SSL *ssl, int type, int value) = NULL;
2572 if (ssl->info_callback != NULL) {
2573 cb = ssl->info_callback;
2574 } else if (ssl->ctx->info_callback != NULL) {
2575 cb = ssl->ctx->info_callback;
2576 }
2577
2578 if (cb != NULL) {
2579 cb(ssl, type, value);
2580 }
2581}
2582
David Benjaminc0279992016-09-19 20:15:07 -04002583void ssl_do_msg_callback(SSL *ssl, int is_write, int content_type,
David Benjamin4e9cc712016-06-01 20:16:03 -04002584 const void *buf, size_t len) {
David Benjaminc0279992016-09-19 20:15:07 -04002585 if (ssl->msg_callback == NULL) {
2586 return;
David Benjamin4e9cc712016-06-01 20:16:03 -04002587 }
David Benjaminc0279992016-09-19 20:15:07 -04002588
2589 /* |version| is zero when calling for |SSL3_RT_HEADER| and |SSL2_VERSION| for
2590 * a V2ClientHello. */
2591 int version;
2592 switch (content_type) {
2593 case 0:
2594 /* V2ClientHello */
2595 version = SSL2_VERSION;
2596 break;
2597 case SSL3_RT_HEADER:
2598 version = 0;
2599 break;
2600 default:
Steven Valdezfdd10992016-09-15 16:27:05 -04002601 version = SSL_version(ssl);
David Benjaminc0279992016-09-19 20:15:07 -04002602 }
2603
2604 ssl->msg_callback(is_write, version, content_type, buf, len, ssl,
2605 ssl->msg_callback_arg);
David Benjamin4e9cc712016-06-01 20:16:03 -04002606}
2607
David Benjaminda881e92015-04-26 14:45:04 -04002608int SSL_CTX_sess_connect(const SSL_CTX *ctx) { return 0; }
2609int SSL_CTX_sess_connect_good(const SSL_CTX *ctx) { return 0; }
2610int SSL_CTX_sess_connect_renegotiate(const SSL_CTX *ctx) { return 0; }
2611int SSL_CTX_sess_accept(const SSL_CTX *ctx) { return 0; }
2612int SSL_CTX_sess_accept_renegotiate(const SSL_CTX *ctx) { return 0; }
2613int SSL_CTX_sess_accept_good(const SSL_CTX *ctx) { return 0; }
2614int SSL_CTX_sess_hits(const SSL_CTX *ctx) { return 0; }
2615int SSL_CTX_sess_cb_hits(const SSL_CTX *ctx) { return 0; }
2616int SSL_CTX_sess_misses(const SSL_CTX *ctx) { return 0; }
2617int SSL_CTX_sess_timeouts(const SSL_CTX *ctx) { return 0; }
2618int SSL_CTX_sess_cache_full(const SSL_CTX *ctx) { return 0; }
David Benjamin936aada2016-06-07 19:09:22 -04002619
2620int SSL_num_renegotiations(const SSL *ssl) {
2621 return SSL_total_renegotiations(ssl);
2622}
2623
2624int SSL_CTX_need_tmp_RSA(const SSL_CTX *ctx) { return 0; }
2625int SSL_need_tmp_RSA(const SSL *ssl) { return 0; }
2626int SSL_CTX_set_tmp_rsa(SSL_CTX *ctx, const RSA *rsa) { return 1; }
2627int SSL_set_tmp_rsa(SSL *ssl, const RSA *rsa) { return 1; }
Matt Braithwaite4838d8a2015-08-20 13:20:03 -07002628void ERR_load_SSL_strings(void) {}
David Benjamin27bbae42015-09-13 00:54:37 -04002629void SSL_load_error_strings(void) {}
David Benjamin936aada2016-06-07 19:09:22 -04002630int SSL_cache_hit(SSL *ssl) { return SSL_session_reused(ssl); }
2631
2632int SSL_CTX_set_tmp_ecdh(SSL_CTX *ctx, const EC_KEY *ec_key) {
2633 if (ec_key == NULL || EC_KEY_get0_group(ec_key) == NULL) {
2634 OPENSSL_PUT_ERROR(SSL, ERR_R_PASSED_NULL_PARAMETER);
2635 return 0;
2636 }
2637 int nid = EC_GROUP_get_curve_name(EC_KEY_get0_group(ec_key));
2638 return SSL_CTX_set1_curves(ctx, &nid, 1);
2639}
2640
2641int SSL_set_tmp_ecdh(SSL *ssl, const EC_KEY *ec_key) {
2642 if (ec_key == NULL || EC_KEY_get0_group(ec_key) == NULL) {
2643 OPENSSL_PUT_ERROR(SSL, ERR_R_PASSED_NULL_PARAMETER);
2644 return 0;
2645 }
2646 int nid = EC_GROUP_get_curve_name(EC_KEY_get0_group(ec_key));
2647 return SSL_set1_curves(ssl, &nid, 1);
2648}
David Benjamin721e8b72016-08-03 13:13:17 -04002649
2650void ssl_get_current_time(const SSL *ssl, struct timeval *out_clock) {
2651 if (ssl->ctx->current_time_cb != NULL) {
2652 ssl->ctx->current_time_cb(ssl, out_clock);
2653 return;
2654 }
2655
David Benjaminec978dd2016-11-04 18:59:33 -04002656#if defined(BORINGSSL_UNSAFE_DETERMINISTIC_MODE)
David Benjamin01a90572016-09-22 00:11:43 -04002657 out_clock->tv_sec = 1234;
2658 out_clock->tv_usec = 1234;
2659#elif defined(OPENSSL_WINDOWS)
David Benjamin721e8b72016-08-03 13:13:17 -04002660 struct _timeb time;
2661 _ftime(&time);
2662 out_clock->tv_sec = time.time;
2663 out_clock->tv_usec = time.millitm * 1000;
2664#else
2665 gettimeofday(out_clock, NULL);
2666#endif
2667}
David Benjamine4706902016-09-20 15:12:23 -04002668
2669int SSL_CTX_set_min_version(SSL_CTX *ctx, uint16_t version) {
2670 return SSL_CTX_set_min_proto_version(ctx, version);
2671}
2672
2673int SSL_CTX_set_max_version(SSL_CTX *ctx, uint16_t version) {
2674 return SSL_CTX_set_max_proto_version(ctx, version);
2675}
2676
2677int SSL_set_min_version(SSL *ssl, uint16_t version) {
2678 return SSL_set_min_proto_version(ssl, version);
2679}
2680
2681int SSL_set_max_version(SSL *ssl, uint16_t version) {
2682 return SSL_set_max_proto_version(ssl, version);
2683}