blob: 88d5f29c39d32c2afac984899dd678d3a083dee6 [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
Brian Smith5ba06892016-02-07 09:36:04 -1000238 ret = OPENSSL_malloc(sizeof(SSL_CTX));
David Benjamin27bbae42015-09-13 00:54:37 -0400239 if (ret == NULL) {
240 goto err;
David Benjamin62fd1622015-01-11 13:30:01 -0500241 }
242
David Benjamin17cf2cb2016-12-13 01:07:13 -0500243 OPENSSL_memset(ret, 0, sizeof(SSL_CTX));
Adam Langley95c29f32014-06-20 12:00:00 -0700244
David Benjamin27bbae42015-09-13 00:54:37 -0400245 ret->method = method->method;
Adam Langley3509dac2017-02-01 11:59:18 -0800246 ret->x509_method = method->x509_method;
David Benjamin27bbae42015-09-13 00:54:37 -0400247
248 CRYPTO_MUTEX_init(&ret->lock);
249
250 ret->session_cache_mode = SSL_SESS_CACHE_SERVER;
251 ret->session_cache_size = SSL_SESSION_CACHE_MAX_SIZE_DEFAULT;
252
David Benjamin27bbae42015-09-13 00:54:37 -0400253 ret->session_timeout = SSL_DEFAULT_SESSION_TIMEOUT;
David Benjamin17b30832017-01-28 14:00:32 -0500254 ret->session_psk_dhe_timeout = SSL_DEFAULT_SESSION_PSK_DHE_TIMEOUT;
David Benjamin27bbae42015-09-13 00:54:37 -0400255
256 ret->references = 1;
257
258 ret->max_cert_list = SSL_MAX_CERT_LIST_DEFAULT;
259 ret->verify_mode = SSL_VERIFY_NONE;
Adam Langley3509dac2017-02-01 11:59:18 -0800260 ret->cert = ssl_cert_new(method->x509_method);
David Benjamin27bbae42015-09-13 00:54:37 -0400261 if (ret->cert == NULL) {
262 goto err;
263 }
264
265 ret->sessions = lh_SSL_SESSION_new(ssl_session_hash, ssl_session_cmp);
266 if (ret->sessions == NULL) {
267 goto err;
268 }
Adam Langley2a3b3432017-02-10 13:56:48 -0800269
270 if (!ret->x509_method->ssl_ctx_new(ret)) {
David Benjamin27bbae42015-09-13 00:54:37 -0400271 goto err;
272 }
273
Matthew Braithwaite6ad20dc2017-02-21 16:41:33 -0800274 if (!SSL_CTX_set_strict_cipher_list(ret, SSL_DEFAULT_CIPHER_LIST)) {
David Benjamin27bbae42015-09-13 00:54:37 -0400275 goto err2;
276 }
277
Adam Langley34b4c822017-02-02 10:57:17 -0800278 ret->client_CA = sk_CRYPTO_BUFFER_new_null();
David Benjamin27bbae42015-09-13 00:54:37 -0400279 if (ret->client_CA == NULL) {
280 goto err;
281 }
282
David Benjamin8a589332015-12-04 23:14:35 -0500283 CRYPTO_new_ex_data(&ret->ex_data);
David Benjamin27bbae42015-09-13 00:54:37 -0400284
285 ret->max_send_fragment = SSL3_RT_MAX_PLAIN_LENGTH;
286
287 /* Setup RFC4507 ticket keys */
288 if (!RAND_bytes(ret->tlsext_tick_key_name, 16) ||
289 !RAND_bytes(ret->tlsext_tick_hmac_key, 16) ||
290 !RAND_bytes(ret->tlsext_tick_aes_key, 16)) {
291 ret->options |= SSL_OP_NO_TICKET;
292 }
293
David Benjamina983b4c2016-11-09 14:21:12 -0500294 /* Disable the auto-chaining feature by default. Once this has stuck without
295 * problems, the feature will be removed entirely. */
296 ret->mode = SSL_MODE_NO_AUTO_CHAIN;
297
David Benjamin27bbae42015-09-13 00:54:37 -0400298 /* Lock the SSL_CTX to the specified version, for compatibility with legacy
299 * uses of SSL_METHOD. */
David Benjamine34bcc92016-09-21 16:53:09 -0400300 if (!SSL_CTX_set_max_proto_version(ret, method->version) ||
301 !SSL_CTX_set_min_proto_version(ret, method->version)) {
302 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
303 goto err2;
David Benjamin27bbae42015-09-13 00:54:37 -0400304 }
305
306 return ret;
307
308err:
309 OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
310err2:
311 SSL_CTX_free(ret);
312 return NULL;
313}
314
Adam Langley84cd1592016-06-30 18:29:44 -0700315int SSL_CTX_up_ref(SSL_CTX *ctx) {
316 CRYPTO_refcount_inc(&ctx->references);
317 return 1;
318}
319
David Benjamin27bbae42015-09-13 00:54:37 -0400320void SSL_CTX_free(SSL_CTX *ctx) {
321 if (ctx == NULL ||
322 !CRYPTO_refcount_dec_and_test_zero(&ctx->references)) {
323 return;
324 }
325
David Benjamin27bbae42015-09-13 00:54:37 -0400326 /* Free internal session cache. However: the remove_cb() may reference the
327 * ex_data of SSL_CTX, thus the ex_data store can only be removed after the
328 * sessions were flushed. As the ex_data handling routines might also touch
329 * the session cache, the most secure solution seems to be: empty (flush) the
330 * cache, then free ex_data, then finally free the cache. (See ticket
331 * [openssl.org #212].) */
332 SSL_CTX_flush_sessions(ctx, 0);
333
334 CRYPTO_free_ex_data(&g_ex_data_class_ssl_ctx, ctx, &ctx->ex_data);
335
336 CRYPTO_MUTEX_cleanup(&ctx->lock);
337 lh_SSL_SESSION_free(ctx->sessions);
David Benjamin27bbae42015-09-13 00:54:37 -0400338 ssl_cipher_preference_list_free(ctx->cipher_list);
David Benjamin27bbae42015-09-13 00:54:37 -0400339 ssl_cert_free(ctx->cert);
340 sk_SSL_CUSTOM_EXTENSION_pop_free(ctx->client_custom_extensions,
341 SSL_CUSTOM_EXTENSION_free);
342 sk_SSL_CUSTOM_EXTENSION_pop_free(ctx->server_custom_extensions,
343 SSL_CUSTOM_EXTENSION_free);
Adam Langley34b4c822017-02-02 10:57:17 -0800344 sk_CRYPTO_BUFFER_pop_free(ctx->client_CA, CRYPTO_BUFFER_free);
Adam Langley2a3b3432017-02-10 13:56:48 -0800345 ctx->x509_method->ssl_ctx_free(ctx);
David Benjamin27bbae42015-09-13 00:54:37 -0400346 sk_SRTP_PROTECTION_PROFILE_free(ctx->srtp_profiles);
347 OPENSSL_free(ctx->psk_identity_hint);
Steven Valdezce902a92016-05-17 11:47:53 -0400348 OPENSSL_free(ctx->supported_group_list);
David Benjamin27bbae42015-09-13 00:54:37 -0400349 OPENSSL_free(ctx->alpn_client_proto_list);
David Benjamin27bbae42015-09-13 00:54:37 -0400350 EVP_PKEY_free(ctx->tlsext_channel_id_private);
David Benjamin27bbae42015-09-13 00:54:37 -0400351
352 OPENSSL_free(ctx);
Adam Langleyfcf25832014-12-18 17:42:32 -0800353}
Adam Langley95c29f32014-06-20 12:00:00 -0700354
Adam Langleyfcf25832014-12-18 17:42:32 -0800355SSL *SSL_new(SSL_CTX *ctx) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800356 if (ctx == NULL) {
David Benjamin3570d732015-06-29 00:28:17 -0400357 OPENSSL_PUT_ERROR(SSL, SSL_R_NULL_SSL_CTX);
Adam Langleyfcf25832014-12-18 17:42:32 -0800358 return NULL;
359 }
360 if (ctx->method == NULL) {
David Benjamin3570d732015-06-29 00:28:17 -0400361 OPENSSL_PUT_ERROR(SSL, SSL_R_SSL_CTX_HAS_NO_DEFAULT_SSL_VERSION);
Adam Langleyfcf25832014-12-18 17:42:32 -0800362 return NULL;
363 }
Adam Langley95c29f32014-06-20 12:00:00 -0700364
Brian Smith5ba06892016-02-07 09:36:04 -1000365 SSL *ssl = OPENSSL_malloc(sizeof(SSL));
David Benjamin0d56f882015-12-19 17:05:56 -0500366 if (ssl == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800367 goto err;
368 }
David Benjamin17cf2cb2016-12-13 01:07:13 -0500369 OPENSSL_memset(ssl, 0, sizeof(SSL));
Adam Langley95c29f32014-06-20 12:00:00 -0700370
David Benjamin0d56f882015-12-19 17:05:56 -0500371 ssl->min_version = ctx->min_version;
372 ssl->max_version = ctx->max_version;
David Benjamin1eb367c2014-12-12 18:17:51 -0500373
Taylor Brandstetter376a0fe2016-05-10 19:30:28 -0700374 /* RFC 6347 states that implementations SHOULD use an initial timer value of
375 * 1 second. */
376 ssl->initial_timeout_duration_ms = 1000;
377
David Benjamin0d56f882015-12-19 17:05:56 -0500378 ssl->options = ctx->options;
379 ssl->mode = ctx->mode;
380 ssl->max_cert_list = ctx->max_cert_list;
Adam Langley95c29f32014-06-20 12:00:00 -0700381
David Benjamin0d56f882015-12-19 17:05:56 -0500382 ssl->cert = ssl_cert_dup(ctx->cert);
383 if (ssl->cert == NULL) {
David Benjamina5a3eeb2015-03-18 20:26:30 -0400384 goto err;
Adam Langleyfcf25832014-12-18 17:42:32 -0800385 }
Adam Langley95c29f32014-06-20 12:00:00 -0700386
David Benjamin0d56f882015-12-19 17:05:56 -0500387 ssl->msg_callback = ctx->msg_callback;
388 ssl->msg_callback_arg = ctx->msg_callback_arg;
389 ssl->verify_mode = ctx->verify_mode;
David Benjamin0d56f882015-12-19 17:05:56 -0500390 ssl->verify_callback = ctx->default_verify_callback;
David Benjaminbbaf3672016-11-17 10:53:09 +0900391 ssl->retain_only_sha256_of_client_certs =
392 ctx->retain_only_sha256_of_client_certs;
Adam Langley95c29f32014-06-20 12:00:00 -0700393
David Benjamin0d56f882015-12-19 17:05:56 -0500394 ssl->quiet_shutdown = ctx->quiet_shutdown;
395 ssl->max_send_fragment = ctx->max_send_fragment;
Adam Langley95c29f32014-06-20 12:00:00 -0700396
David Benjaminf650c712016-12-22 15:54:51 -0500397 SSL_CTX_up_ref(ctx);
David Benjamin0d56f882015-12-19 17:05:56 -0500398 ssl->ctx = ctx;
David Benjaminf650c712016-12-22 15:54:51 -0500399 SSL_CTX_up_ref(ctx);
David Benjaminbe497062017-03-10 16:08:36 -0500400 ssl->session_ctx = ctx;
Adam Langley95c29f32014-06-20 12:00:00 -0700401
Adam Langley2a3b3432017-02-10 13:56:48 -0800402 if (!ssl->ctx->x509_method->ssl_new(ssl)) {
403 goto err;
404 }
405
Steven Valdezce902a92016-05-17 11:47:53 -0400406 if (ctx->supported_group_list) {
David Benjamin17b30832017-01-28 14:00:32 -0500407 ssl->supported_group_list = BUF_memdup(ctx->supported_group_list,
408 ctx->supported_group_list_len * 2);
Steven Valdezce902a92016-05-17 11:47:53 -0400409 if (!ssl->supported_group_list) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800410 goto err;
411 }
Steven Valdezce902a92016-05-17 11:47:53 -0400412 ssl->supported_group_list_len = ctx->supported_group_list_len;
Adam Langleyfcf25832014-12-18 17:42:32 -0800413 }
Adam Langley95c29f32014-06-20 12:00:00 -0700414
David Benjamin17b30832017-01-28 14:00:32 -0500415 if (ctx->alpn_client_proto_list) {
416 ssl->alpn_client_proto_list = BUF_memdup(ctx->alpn_client_proto_list,
417 ctx->alpn_client_proto_list_len);
David Benjamin0d56f882015-12-19 17:05:56 -0500418 if (ssl->alpn_client_proto_list == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800419 goto err;
420 }
David Benjamin17b30832017-01-28 14:00:32 -0500421 ssl->alpn_client_proto_list_len = ctx->alpn_client_proto_list_len;
Adam Langleyfcf25832014-12-18 17:42:32 -0800422 }
Adam Langley95c29f32014-06-20 12:00:00 -0700423
David Benjamin0d56f882015-12-19 17:05:56 -0500424 ssl->method = ctx->method;
Adam Langley95c29f32014-06-20 12:00:00 -0700425
David Benjamin0d56f882015-12-19 17:05:56 -0500426 if (!ssl->method->ssl_new(ssl)) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800427 goto err;
428 }
Adam Langley95c29f32014-06-20 12:00:00 -0700429
David Benjamin0d56f882015-12-19 17:05:56 -0500430 ssl->rwstate = SSL_NOTHING;
Adam Langley95c29f32014-06-20 12:00:00 -0700431
David Benjamin0d56f882015-12-19 17:05:56 -0500432 CRYPTO_new_ex_data(&ssl->ex_data);
Adam Langley95c29f32014-06-20 12:00:00 -0700433
David Benjamin0d56f882015-12-19 17:05:56 -0500434 ssl->psk_identity_hint = NULL;
Adam Langleyfcf25832014-12-18 17:42:32 -0800435 if (ctx->psk_identity_hint) {
David Benjamin0d56f882015-12-19 17:05:56 -0500436 ssl->psk_identity_hint = BUF_strdup(ctx->psk_identity_hint);
437 if (ssl->psk_identity_hint == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -0800438 goto err;
439 }
440 }
David Benjamin0d56f882015-12-19 17:05:56 -0500441 ssl->psk_client_callback = ctx->psk_client_callback;
442 ssl->psk_server_callback = ctx->psk_server_callback;
Adam Langley95c29f32014-06-20 12:00:00 -0700443
David Benjamin0d56f882015-12-19 17:05:56 -0500444 ssl->tlsext_channel_id_enabled = ctx->tlsext_channel_id_enabled;
David Benjamin02ddbfd2015-01-11 13:09:11 -0500445 if (ctx->tlsext_channel_id_private) {
Adam Langley310d3f62016-07-12 10:39:20 -0700446 EVP_PKEY_up_ref(ctx->tlsext_channel_id_private);
447 ssl->tlsext_channel_id_private = ctx->tlsext_channel_id_private;
David Benjamin02ddbfd2015-01-11 13:09:11 -0500448 }
449
David Benjamin17b30832017-01-28 14:00:32 -0500450 ssl->signed_cert_timestamps_enabled = ctx->signed_cert_timestamps_enabled;
451 ssl->ocsp_stapling_enabled = ctx->ocsp_stapling_enabled;
HÃ¥vard Molland9169c962014-08-14 14:42:37 +0200452
David Benjamin0d56f882015-12-19 17:05:56 -0500453 return ssl;
Adam Langleyfcf25832014-12-18 17:42:32 -0800454
Adam Langley95c29f32014-06-20 12:00:00 -0700455err:
David Benjamin0d56f882015-12-19 17:05:56 -0500456 SSL_free(ssl);
David Benjamin3570d732015-06-29 00:28:17 -0400457 OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
Adam Langley95c29f32014-06-20 12:00:00 -0700458
Adam Langleyfcf25832014-12-18 17:42:32 -0800459 return NULL;
460}
Adam Langley95c29f32014-06-20 12:00:00 -0700461
David Benjamin27bbae42015-09-13 00:54:37 -0400462void SSL_free(SSL *ssl) {
463 if (ssl == NULL) {
464 return;
465 }
466
Adam Langley2a3b3432017-02-10 13:56:48 -0800467 ssl->ctx->x509_method->ssl_free(ssl);
David Benjamin27bbae42015-09-13 00:54:37 -0400468 CRYPTO_free_ex_data(&g_ex_data_class_ssl, ssl, &ssl->ex_data);
469
David Benjamin27bbae42015-09-13 00:54:37 -0400470 BIO_free_all(ssl->rbio);
David Benjaminf715c422016-06-11 19:01:56 -0400471 BIO_free_all(ssl->wbio);
David Benjamin27bbae42015-09-13 00:54:37 -0400472
473 BUF_MEM_free(ssl->init_buf);
474
475 /* add extra stuff */
476 ssl_cipher_preference_list_free(ssl->cipher_list);
David Benjamin27bbae42015-09-13 00:54:37 -0400477
David Benjamin27bbae42015-09-13 00:54:37 -0400478 SSL_SESSION_free(ssl->session);
479
David Benjamin27bbae42015-09-13 00:54:37 -0400480 ssl_cert_free(ssl->cert);
481
482 OPENSSL_free(ssl->tlsext_hostname);
David Benjaminbe497062017-03-10 16:08:36 -0500483 SSL_CTX_free(ssl->session_ctx);
Steven Valdezce902a92016-05-17 11:47:53 -0400484 OPENSSL_free(ssl->supported_group_list);
David Benjamin27bbae42015-09-13 00:54:37 -0400485 OPENSSL_free(ssl->alpn_client_proto_list);
486 EVP_PKEY_free(ssl->tlsext_channel_id_private);
487 OPENSSL_free(ssl->psk_identity_hint);
Adam Langley34b4c822017-02-02 10:57:17 -0800488 sk_CRYPTO_BUFFER_pop_free(ssl->client_CA, CRYPTO_BUFFER_free);
David Benjamin27bbae42015-09-13 00:54:37 -0400489 sk_SRTP_PROTECTION_PROFILE_free(ssl->srtp_profiles);
490
491 if (ssl->method != NULL) {
492 ssl->method->ssl_free(ssl);
493 }
494 SSL_CTX_free(ssl->ctx);
495
496 OPENSSL_free(ssl);
497}
498
499void SSL_set_connect_state(SSL *ssl) {
500 ssl->server = 0;
David Benjamin9f1dc822016-06-07 17:03:46 -0400501 ssl->handshake_func = ssl3_connect;
David Benjamin27bbae42015-09-13 00:54:37 -0400502}
503
504void SSL_set_accept_state(SSL *ssl) {
505 ssl->server = 1;
David Benjamin9f1dc822016-06-07 17:03:46 -0400506 ssl->handshake_func = ssl3_accept;
David Benjamin27bbae42015-09-13 00:54:37 -0400507}
508
David Benjamin4501bd52016-08-01 13:39:41 -0400509void SSL_set0_rbio(SSL *ssl, BIO *rbio) {
David Benjaminf715c422016-06-11 19:01:56 -0400510 BIO_free_all(ssl->rbio);
511 ssl->rbio = rbio;
512}
513
David Benjamin4501bd52016-08-01 13:39:41 -0400514void SSL_set0_wbio(SSL *ssl, BIO *wbio) {
David Benjaminf715c422016-06-11 19:01:56 -0400515 BIO_free_all(ssl->wbio);
David Benjamin27bbae42015-09-13 00:54:37 -0400516 ssl->wbio = wbio;
517}
518
David Benjaminf715c422016-06-11 19:01:56 -0400519void SSL_set_bio(SSL *ssl, BIO *rbio, BIO *wbio) {
520 /* For historical reasons, this function has many different cases in ownership
521 * handling. */
522
David Benjamin4501bd52016-08-01 13:39:41 -0400523 /* If nothing has changed, do nothing */
524 if (rbio == SSL_get_rbio(ssl) && wbio == SSL_get_wbio(ssl)) {
525 return;
526 }
527
David Benjaminf715c422016-06-11 19:01:56 -0400528 /* If the two arguments are equal, one fewer reference is granted than
529 * taken. */
530 if (rbio != NULL && rbio == wbio) {
531 BIO_up_ref(rbio);
532 }
533
David Benjamin4501bd52016-08-01 13:39:41 -0400534 /* If only the wbio is changed, adopt only one reference. */
David Benjaminf715c422016-06-11 19:01:56 -0400535 if (rbio == SSL_get_rbio(ssl)) {
David Benjamin4501bd52016-08-01 13:39:41 -0400536 SSL_set0_wbio(ssl, wbio);
David Benjaminf715c422016-06-11 19:01:56 -0400537 return;
538 }
David Benjamin4501bd52016-08-01 13:39:41 -0400539
540 /* There is an asymmetry here for historical reasons. If only the rbio is
541 * changed AND the rbio and wbio were originally different, then we only adopt
542 * one reference. */
543 if (wbio == SSL_get_wbio(ssl) && SSL_get_rbio(ssl) != SSL_get_wbio(ssl)) {
544 SSL_set0_rbio(ssl, rbio);
David Benjaminf715c422016-06-11 19:01:56 -0400545 return;
546 }
547
548 /* Otherwise, adopt both references. */
David Benjamin4501bd52016-08-01 13:39:41 -0400549 SSL_set0_rbio(ssl, rbio);
550 SSL_set0_wbio(ssl, wbio);
David Benjaminf715c422016-06-11 19:01:56 -0400551}
552
David Benjamin27bbae42015-09-13 00:54:37 -0400553BIO *SSL_get_rbio(const SSL *ssl) { return ssl->rbio; }
554
David Benjamindaf207a2017-01-03 18:37:41 -0500555BIO *SSL_get_wbio(const SSL *ssl) { return ssl->wbio; }
David Benjamin27bbae42015-09-13 00:54:37 -0400556
David Benjamin2be4aa72017-01-02 07:56:51 -0500557void ssl_reset_error_state(SSL *ssl) {
558 /* Functions which use |SSL_get_error| must reset I/O and error state on
559 * entry. */
David Benjamin4c5ddb82016-03-11 22:56:19 -0500560 ssl->rwstate = SSL_NOTHING;
David Benjamin15c14882016-03-14 14:25:46 -0400561 ERR_clear_error();
David Benjamin0d275bd2016-06-01 20:19:34 -0400562 ERR_clear_system_error();
David Benjamin2be4aa72017-01-02 07:56:51 -0500563}
564
565int SSL_do_handshake(SSL *ssl) {
566 ssl_reset_error_state(ssl);
David Benjamin15c14882016-03-14 14:25:46 -0400567
David Benjamin27bbae42015-09-13 00:54:37 -0400568 if (ssl->handshake_func == NULL) {
569 OPENSSL_PUT_ERROR(SSL, SSL_R_CONNECTION_TYPE_NOT_SET);
570 return -1;
571 }
572
573 if (!SSL_in_init(ssl)) {
574 return 1;
575 }
576
David Benjamin2644a132016-12-11 13:41:17 -0500577 if (ssl->s3->hs == NULL) {
578 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
579 return -1;
David Benjamince8c9d22016-11-14 10:45:16 +0900580 }
581
582 /* Run the handshake. */
583 assert(ssl->s3->hs != NULL);
584 int ret = ssl->handshake_func(ssl->s3->hs);
585 if (ret <= 0) {
586 return ret;
587 }
588
589 /* Destroy the handshake object if the handshake has completely finished. */
590 if (!SSL_in_init(ssl)) {
591 ssl_handshake_free(ssl->s3->hs);
592 ssl->s3->hs = NULL;
593 }
594
595 return 1;
David Benjamin27bbae42015-09-13 00:54:37 -0400596}
597
598int SSL_connect(SSL *ssl) {
David Benjaminb2a73182016-03-10 01:25:26 -0500599 if (ssl->handshake_func == NULL) {
David Benjamin27bbae42015-09-13 00:54:37 -0400600 /* Not properly initialized yet */
601 SSL_set_connect_state(ssl);
602 }
603
David Benjamin15c14882016-03-14 14:25:46 -0400604 return SSL_do_handshake(ssl);
David Benjamin27bbae42015-09-13 00:54:37 -0400605}
606
607int SSL_accept(SSL *ssl) {
David Benjaminb2a73182016-03-10 01:25:26 -0500608 if (ssl->handshake_func == NULL) {
David Benjamin27bbae42015-09-13 00:54:37 -0400609 /* Not properly initialized yet */
610 SSL_set_accept_state(ssl);
611 }
612
David Benjamin15c14882016-03-14 14:25:46 -0400613 return SSL_do_handshake(ssl);
David Benjamin27bbae42015-09-13 00:54:37 -0400614}
615
David Benjamin163f29a2016-07-28 11:05:58 -0400616static int ssl_do_renegotiate(SSL *ssl) {
David Benjamin34941c02016-10-08 11:45:31 -0400617 /* We do not accept renegotiations as a server or SSL 3.0. SSL 3.0 will be
618 * removed entirely in the future and requires retaining more data for
619 * renegotiation_info. */
620 if (ssl->server || ssl->version == SSL3_VERSION) {
David Benjamin163f29a2016-07-28 11:05:58 -0400621 goto no_renegotiation;
622 }
623
624 if (ssl->s3->tmp.message_type != SSL3_MT_HELLO_REQUEST ||
625 ssl->init_num != 0) {
626 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_DECODE_ERROR);
627 OPENSSL_PUT_ERROR(SSL, SSL_R_BAD_HELLO_REQUEST);
628 return 0;
629 }
630
631 switch (ssl->renegotiate_mode) {
632 case ssl_renegotiate_ignore:
633 /* Ignore the HelloRequest. */
634 return 1;
635
636 case ssl_renegotiate_once:
637 if (ssl->s3->total_renegotiations != 0) {
638 goto no_renegotiation;
639 }
640 break;
641
642 case ssl_renegotiate_never:
643 goto no_renegotiation;
644
645 case ssl_renegotiate_freely:
646 break;
647 }
648
649 /* Renegotiation is only supported at quiescent points in the application
650 * protocol, namely in HTTPS, just before reading the HTTP response. Require
651 * the record-layer be idle and avoid complexities of sending a handshake
652 * record while an application_data record is being written. */
653 if (ssl_write_buffer_is_pending(ssl)) {
654 goto no_renegotiation;
655 }
656
657 /* Begin a new handshake. */
David Benjamin2644a132016-12-11 13:41:17 -0500658 if (ssl->s3->hs != NULL) {
659 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
660 return 0;
661 }
662 ssl->s3->hs = ssl_handshake_new(ssl);
663 if (ssl->s3->hs == NULL) {
664 return 0;
665 }
666
David Benjamin163f29a2016-07-28 11:05:58 -0400667 ssl->s3->total_renegotiations++;
David Benjamin163f29a2016-07-28 11:05:58 -0400668 return 1;
669
670no_renegotiation:
671 ssl3_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_NO_RENEGOTIATION);
672 OPENSSL_PUT_ERROR(SSL, SSL_R_NO_RENEGOTIATION);
673 return 0;
674}
675
676static int ssl_do_post_handshake(SSL *ssl) {
677 if (ssl3_protocol_version(ssl) < TLS1_3_VERSION) {
678 return ssl_do_renegotiate(ssl);
679 }
680
Steven Valdez8e1c7be2016-07-26 12:39:22 -0400681 return tls13_post_handshake(ssl);
David Benjamin163f29a2016-07-28 11:05:58 -0400682}
683
David Benjamin15c14882016-03-14 14:25:46 -0400684static int ssl_read_impl(SSL *ssl, void *buf, int num, int peek) {
David Benjamin2be4aa72017-01-02 07:56:51 -0500685 ssl_reset_error_state(ssl);
David Benjamin15c14882016-03-14 14:25:46 -0400686
David Benjaminb2a73182016-03-10 01:25:26 -0500687 if (ssl->handshake_func == NULL) {
David Benjamin27bbae42015-09-13 00:54:37 -0400688 OPENSSL_PUT_ERROR(SSL, SSL_R_UNINITIALIZED);
689 return -1;
690 }
691
David Benjamin163f29a2016-07-28 11:05:58 -0400692 for (;;) {
693 /* Complete the current handshake, if any. False Start will cause
694 * |SSL_do_handshake| to return mid-handshake, so this may require multiple
695 * iterations. */
696 while (SSL_in_init(ssl)) {
697 int ret = SSL_do_handshake(ssl);
698 if (ret < 0) {
699 return ret;
700 }
701 if (ret == 0) {
702 OPENSSL_PUT_ERROR(SSL, SSL_R_SSL_HANDSHAKE_FAILURE);
703 return -1;
704 }
705 }
706
707 int got_handshake;
708 int ret = ssl->method->read_app_data(ssl, &got_handshake, buf, num, peek);
709 if (ret > 0 || !got_handshake) {
Steven Valdez32635b82016-08-16 11:25:03 -0400710 ssl->s3->key_update_count = 0;
David Benjaminc79845c2016-03-10 01:28:00 -0500711 return ret;
712 }
David Benjamin163f29a2016-07-28 11:05:58 -0400713
714 /* Handle the post-handshake message and try again. */
715 if (!ssl_do_post_handshake(ssl)) {
David Benjaminc79845c2016-03-10 01:28:00 -0500716 return -1;
717 }
David Benjamin163f29a2016-07-28 11:05:58 -0400718 ssl->method->release_current_message(ssl, 1 /* free buffer */);
David Benjaminc79845c2016-03-10 01:28:00 -0500719 }
David Benjamin15c14882016-03-14 14:25:46 -0400720}
721
722int SSL_read(SSL *ssl, void *buf, int num) {
723 return ssl_read_impl(ssl, buf, num, 0 /* consume bytes */);
David Benjamin27bbae42015-09-13 00:54:37 -0400724}
725
726int SSL_peek(SSL *ssl, void *buf, int num) {
David Benjamin15c14882016-03-14 14:25:46 -0400727 return ssl_read_impl(ssl, buf, num, 1 /* peek */);
David Benjamin27bbae42015-09-13 00:54:37 -0400728}
729
730int SSL_write(SSL *ssl, const void *buf, int num) {
David Benjamin2be4aa72017-01-02 07:56:51 -0500731 ssl_reset_error_state(ssl);
David Benjamin15c14882016-03-14 14:25:46 -0400732
David Benjaminb2a73182016-03-10 01:25:26 -0500733 if (ssl->handshake_func == NULL) {
David Benjamin27bbae42015-09-13 00:54:37 -0400734 OPENSSL_PUT_ERROR(SSL, SSL_R_UNINITIALIZED);
735 return -1;
736 }
737
David Benjaminfa214e42016-05-10 17:03:10 -0400738 if (ssl->s3->send_shutdown != ssl_shutdown_none) {
David Benjamin27bbae42015-09-13 00:54:37 -0400739 OPENSSL_PUT_ERROR(SSL, SSL_R_PROTOCOL_IS_SHUTDOWN);
740 return -1;
741 }
742
David Benjamind7ac1432016-03-10 00:41:25 -0500743 /* If necessary, complete the handshake implicitly. */
744 if (SSL_in_init(ssl) && !SSL_in_false_start(ssl)) {
745 int ret = SSL_do_handshake(ssl);
746 if (ret < 0) {
747 return ret;
748 }
749 if (ret == 0) {
750 OPENSSL_PUT_ERROR(SSL, SSL_R_SSL_HANDSHAKE_FAILURE);
751 return -1;
752 }
753 }
754
David Benjaminf0ee9072016-06-15 17:44:37 -0400755 return ssl->method->write_app_data(ssl, buf, num);
David Benjamin27bbae42015-09-13 00:54:37 -0400756}
757
758int SSL_shutdown(SSL *ssl) {
David Benjamin2be4aa72017-01-02 07:56:51 -0500759 ssl_reset_error_state(ssl);
David Benjamin15c14882016-03-14 14:25:46 -0400760
David Benjaminb2a73182016-03-10 01:25:26 -0500761 if (ssl->handshake_func == NULL) {
David Benjamin27bbae42015-09-13 00:54:37 -0400762 OPENSSL_PUT_ERROR(SSL, SSL_R_UNINITIALIZED);
763 return -1;
764 }
765
David Benjamin12709db2017-02-17 13:51:50 -0500766 /* If we are in the middle of a handshake, silently succeed. Consumers often
767 * call this function before |SSL_free|, whether the handshake succeeded or
768 * not. We assume the caller has already handled failed handshakes. */
Steven Valdeza14934f2016-02-29 10:05:08 -0500769 if (SSL_in_init(ssl)) {
David Benjamin12709db2017-02-17 13:51:50 -0500770 return 1;
Steven Valdeza14934f2016-02-29 10:05:08 -0500771 }
772
David Benjamin27bbae42015-09-13 00:54:37 -0400773 if (ssl->quiet_shutdown) {
David Benjaminfa214e42016-05-10 17:03:10 -0400774 /* Do nothing if configured not to send a close_notify. */
775 ssl->s3->send_shutdown = ssl_shutdown_close_notify;
776 ssl->s3->recv_shutdown = ssl_shutdown_close_notify;
David Benjamin27bbae42015-09-13 00:54:37 -0400777 return 1;
778 }
779
David Benjaminfa214e42016-05-10 17:03:10 -0400780 /* This function completes in two stages. It sends a close_notify and then it
781 * waits for a close_notify to come in. Perform exactly one action and return
782 * whether or not it succeeds. */
David Benjamin27bbae42015-09-13 00:54:37 -0400783
David Benjaminfa214e42016-05-10 17:03:10 -0400784 if (ssl->s3->send_shutdown != ssl_shutdown_close_notify) {
785 /* Send a close_notify. */
786 if (ssl3_send_alert(ssl, SSL3_AL_WARNING, SSL_AD_CLOSE_NOTIFY) <= 0) {
787 return -1;
David Benjamin27bbae42015-09-13 00:54:37 -0400788 }
789 } else if (ssl->s3->alert_dispatch) {
David Benjaminfa214e42016-05-10 17:03:10 -0400790 /* Finish sending the close_notify. */
David Benjaminf0ee9072016-06-15 17:44:37 -0400791 if (ssl->method->dispatch_alert(ssl) <= 0) {
David Benjaminfa214e42016-05-10 17:03:10 -0400792 return -1;
David Benjamin27bbae42015-09-13 00:54:37 -0400793 }
David Benjaminfa214e42016-05-10 17:03:10 -0400794 } else if (ssl->s3->recv_shutdown != ssl_shutdown_close_notify) {
795 /* Wait for the peer's close_notify. */
David Benjaminf0ee9072016-06-15 17:44:37 -0400796 ssl->method->read_close_notify(ssl);
David Benjaminfa214e42016-05-10 17:03:10 -0400797 if (ssl->s3->recv_shutdown != ssl_shutdown_close_notify) {
798 return -1;
David Benjamin27bbae42015-09-13 00:54:37 -0400799 }
800 }
801
David Benjaminfa214e42016-05-10 17:03:10 -0400802 /* Return 0 for unidirectional shutdown and 1 for bidirectional shutdown. */
803 return ssl->s3->recv_shutdown == ssl_shutdown_close_notify;
David Benjamin27bbae42015-09-13 00:54:37 -0400804}
805
David Benjamin1d4f4c02016-07-26 18:03:08 -0400806int SSL_send_fatal_alert(SSL *ssl, uint8_t alert) {
807 if (ssl->s3->alert_dispatch) {
808 if (ssl->s3->send_alert[0] != SSL3_AL_FATAL ||
809 ssl->s3->send_alert[1] != alert) {
810 /* We are already attempting to write a different alert. */
811 OPENSSL_PUT_ERROR(SSL, SSL_R_PROTOCOL_IS_SHUTDOWN);
812 return -1;
813 }
814 return ssl->method->dispatch_alert(ssl);
815 }
816
817 return ssl3_send_alert(ssl, SSL3_AL_FATAL, alert);
818}
819
Steven Valdez08b65f42016-12-07 15:29:45 -0500820void SSL_CTX_set_early_data_enabled(SSL_CTX *ctx, int enabled) {
821 ctx->enable_early_data = !!enabled;
822}
823
Steven Valdez2d850622017-01-11 11:34:52 -0500824int SSL_early_data_accepted(const SSL *ssl) {
825 return ssl->early_data_accepted;
826}
827
David Benjamin287fc4f2016-12-10 15:12:03 -0500828static int bio_retry_reason_to_error(int reason) {
829 switch (reason) {
830 case BIO_RR_CONNECT:
831 return SSL_ERROR_WANT_CONNECT;
832 case BIO_RR_ACCEPT:
833 return SSL_ERROR_WANT_ACCEPT;
834 default:
835 return SSL_ERROR_SYSCALL;
836 }
837}
David Benjamin27bbae42015-09-13 00:54:37 -0400838
David Benjamin287fc4f2016-12-10 15:12:03 -0500839int SSL_get_error(const SSL *ssl, int ret_code) {
David Benjamin27bbae42015-09-13 00:54:37 -0400840 if (ret_code > 0) {
841 return SSL_ERROR_NONE;
842 }
843
844 /* Make things return SSL_ERROR_SYSCALL when doing SSL_do_handshake etc,
845 * where we do encode the error */
David Benjamin287fc4f2016-12-10 15:12:03 -0500846 uint32_t err = ERR_peek_error();
David Benjamin27bbae42015-09-13 00:54:37 -0400847 if (err != 0) {
848 if (ERR_GET_LIB(err) == ERR_LIB_SYS) {
849 return SSL_ERROR_SYSCALL;
850 }
851 return SSL_ERROR_SSL;
852 }
853
854 if (ret_code == 0) {
David Benjaminfa214e42016-05-10 17:03:10 -0400855 if (ssl->s3->recv_shutdown == ssl_shutdown_close_notify) {
David Benjamin27bbae42015-09-13 00:54:37 -0400856 return SSL_ERROR_ZERO_RETURN;
857 }
858 /* An EOF was observed which violates the protocol, and the underlying
859 * transport does not participate in the error queue. Bubble up to the
860 * caller. */
861 return SSL_ERROR_SYSCALL;
862 }
863
David Benjamin287fc4f2016-12-10 15:12:03 -0500864 switch (ssl->rwstate) {
865 case SSL_PENDING_SESSION:
866 return SSL_ERROR_PENDING_SESSION;
David Benjamin27bbae42015-09-13 00:54:37 -0400867
David Benjamin287fc4f2016-12-10 15:12:03 -0500868 case SSL_CERTIFICATE_SELECTION_PENDING:
869 return SSL_ERROR_PENDING_CERTIFICATE;
David Benjamin27bbae42015-09-13 00:54:37 -0400870
David Benjamin287fc4f2016-12-10 15:12:03 -0500871 case SSL_READING: {
872 BIO *bio = SSL_get_rbio(ssl);
873 if (BIO_should_read(bio)) {
874 return SSL_ERROR_WANT_READ;
David Benjamin27bbae42015-09-13 00:54:37 -0400875 }
876
David Benjamin287fc4f2016-12-10 15:12:03 -0500877 if (BIO_should_write(bio)) {
878 /* TODO(davidben): OpenSSL historically checked for writes on the read
879 * BIO. Can this be removed? */
880 return SSL_ERROR_WANT_WRITE;
David Benjamin27bbae42015-09-13 00:54:37 -0400881 }
882
David Benjamin287fc4f2016-12-10 15:12:03 -0500883 if (BIO_should_io_special(bio)) {
884 return bio_retry_reason_to_error(BIO_get_retry_reason(bio));
David Benjamin27bbae42015-09-13 00:54:37 -0400885 }
886
David Benjamin287fc4f2016-12-10 15:12:03 -0500887 break;
888 }
889
890 case SSL_WRITING: {
891 BIO *bio = SSL_get_wbio(ssl);
892 if (BIO_should_write(bio)) {
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_read(bio)) {
897 /* TODO(davidben): OpenSSL historically checked for reads on the write
898 * BIO. Can this be removed? */
899 return SSL_ERROR_WANT_READ;
900 }
901
902 if (BIO_should_io_special(bio)) {
903 return bio_retry_reason_to_error(BIO_get_retry_reason(bio));
904 }
905
906 break;
David Benjamin27bbae42015-09-13 00:54:37 -0400907 }
David Benjamin27bbae42015-09-13 00:54:37 -0400908
David Benjamin287fc4f2016-12-10 15:12:03 -0500909 case SSL_X509_LOOKUP:
910 return SSL_ERROR_WANT_X509_LOOKUP;
David Benjamin27bbae42015-09-13 00:54:37 -0400911
David Benjamin287fc4f2016-12-10 15:12:03 -0500912 case SSL_CHANNEL_ID_LOOKUP:
913 return SSL_ERROR_WANT_CHANNEL_ID_LOOKUP;
David Benjamin27bbae42015-09-13 00:54:37 -0400914
David Benjamin287fc4f2016-12-10 15:12:03 -0500915 case SSL_PRIVATE_KEY_OPERATION:
916 return SSL_ERROR_WANT_PRIVATE_KEY_OPERATION;
Adam Langley4c341d02017-03-08 19:33:21 -0800917
918 case SSL_PENDING_TICKET:
919 return SSL_ERROR_PENDING_TICKET;
David Benjamin27bbae42015-09-13 00:54:37 -0400920 }
921
922 return SSL_ERROR_SYSCALL;
923}
924
David Benjamine34bcc92016-09-21 16:53:09 -0400925static int set_min_version(const SSL_PROTOCOL_METHOD *method, uint16_t *out,
926 uint16_t version) {
927 if (version == 0) {
928 *out = method->min_version;
929 return 1;
930 }
931
Steven Valdezfdd10992016-09-15 16:27:05 -0400932 if (version == TLS1_3_VERSION) {
933 version = TLS1_3_DRAFT_VERSION;
934 }
935
David Benjamine34bcc92016-09-21 16:53:09 -0400936 return method->version_from_wire(out, version);
937}
938
939static int set_max_version(const SSL_PROTOCOL_METHOD *method, uint16_t *out,
940 uint16_t version) {
941 if (version == 0) {
942 *out = method->max_version;
943 /* TODO(svaldez): Enable TLS 1.3 by default once fully implemented. */
944 if (*out > TLS1_2_VERSION) {
945 *out = TLS1_2_VERSION;
946 }
947 return 1;
948 }
949
Steven Valdezfdd10992016-09-15 16:27:05 -0400950 if (version == TLS1_3_VERSION) {
951 version = TLS1_3_DRAFT_VERSION;
952 }
953
David Benjamine34bcc92016-09-21 16:53:09 -0400954 return method->version_from_wire(out, version);
955}
956
David Benjamine4706902016-09-20 15:12:23 -0400957int SSL_CTX_set_min_proto_version(SSL_CTX *ctx, uint16_t version) {
David Benjamine34bcc92016-09-21 16:53:09 -0400958 return set_min_version(ctx->method, &ctx->min_version, version);
David Benjamin27bbae42015-09-13 00:54:37 -0400959}
960
David Benjamine4706902016-09-20 15:12:23 -0400961int SSL_CTX_set_max_proto_version(SSL_CTX *ctx, uint16_t version) {
David Benjamine34bcc92016-09-21 16:53:09 -0400962 return set_max_version(ctx->method, &ctx->max_version, version);
David Benjamin27bbae42015-09-13 00:54:37 -0400963}
964
David Benjamine4706902016-09-20 15:12:23 -0400965int SSL_set_min_proto_version(SSL *ssl, uint16_t version) {
David Benjamine34bcc92016-09-21 16:53:09 -0400966 return set_min_version(ssl->method, &ssl->min_version, version);
David Benjamin27bbae42015-09-13 00:54:37 -0400967}
968
David Benjamine4706902016-09-20 15:12:23 -0400969int SSL_set_max_proto_version(SSL *ssl, uint16_t version) {
David Benjamine34bcc92016-09-21 16:53:09 -0400970 return set_max_version(ssl->method, &ssl->max_version, version);
David Benjamin27bbae42015-09-13 00:54:37 -0400971}
972
973uint32_t SSL_CTX_set_options(SSL_CTX *ctx, uint32_t options) {
974 ctx->options |= options;
975 return ctx->options;
976}
977
978uint32_t SSL_CTX_clear_options(SSL_CTX *ctx, uint32_t options) {
979 ctx->options &= ~options;
980 return ctx->options;
981}
982
983uint32_t SSL_CTX_get_options(const SSL_CTX *ctx) { return ctx->options; }
984
985uint32_t SSL_set_options(SSL *ssl, uint32_t options) {
986 ssl->options |= options;
987 return ssl->options;
988}
989
990uint32_t SSL_clear_options(SSL *ssl, uint32_t options) {
991 ssl->options &= ~options;
992 return ssl->options;
993}
994
995uint32_t SSL_get_options(const SSL *ssl) { return ssl->options; }
996
997uint32_t SSL_CTX_set_mode(SSL_CTX *ctx, uint32_t mode) {
998 ctx->mode |= mode;
999 return ctx->mode;
1000}
1001
1002uint32_t SSL_CTX_clear_mode(SSL_CTX *ctx, uint32_t mode) {
1003 ctx->mode &= ~mode;
1004 return ctx->mode;
1005}
1006
1007uint32_t SSL_CTX_get_mode(const SSL_CTX *ctx) { return ctx->mode; }
1008
1009uint32_t SSL_set_mode(SSL *ssl, uint32_t mode) {
1010 ssl->mode |= mode;
1011 return ssl->mode;
1012}
1013
1014uint32_t SSL_clear_mode(SSL *ssl, uint32_t mode) {
1015 ssl->mode &= ~mode;
1016 return ssl->mode;
1017}
1018
1019uint32_t SSL_get_mode(const SSL *ssl) { return ssl->mode; }
1020
Adam Langleyd519bf62016-12-12 11:16:44 -08001021void SSL_CTX_set0_buffer_pool(SSL_CTX *ctx, CRYPTO_BUFFER_POOL *pool) {
1022 ctx->pool = pool;
1023}
1024
David Benjaminee0c8272015-09-13 01:03:54 -04001025int SSL_get_tls_unique(const SSL *ssl, uint8_t *out, size_t *out_len,
1026 size_t max_out) {
David Benjaminced00b42016-10-08 11:24:09 -04001027 /* tls-unique is not defined for SSL 3.0 or TLS 1.3. */
1028 if (!ssl->s3->initial_handshake_complete ||
1029 ssl3_protocol_version(ssl) < TLS1_VERSION ||
1030 ssl3_protocol_version(ssl) >= TLS1_3_VERSION) {
1031 goto err;
1032 }
1033
David Benjaminee0c8272015-09-13 01:03:54 -04001034 /* The tls-unique value is the first Finished message in the handshake, which
1035 * is the client's in a full handshake and the server's for a resumption. See
1036 * https://tools.ietf.org/html/rfc5929#section-3.1. */
1037 const uint8_t *finished = ssl->s3->previous_client_finished;
1038 size_t finished_len = ssl->s3->previous_client_finished_len;
Steven Valdez87eab492016-06-27 16:34:59 -04001039 if (ssl->session != NULL) {
David Benjaminee0c8272015-09-13 01:03:54 -04001040 /* tls-unique is broken for resumed sessions unless EMS is used. */
1041 if (!ssl->session->extended_master_secret) {
1042 goto err;
1043 }
1044 finished = ssl->s3->previous_server_finished;
1045 finished_len = ssl->s3->previous_server_finished_len;
1046 }
1047
David Benjaminee0c8272015-09-13 01:03:54 -04001048 *out_len = finished_len;
1049 if (finished_len > max_out) {
1050 *out_len = max_out;
1051 }
1052
David Benjamin17cf2cb2016-12-13 01:07:13 -05001053 OPENSSL_memcpy(out, finished, *out_len);
David Benjaminee0c8272015-09-13 01:03:54 -04001054 return 1;
1055
1056err:
1057 *out_len = 0;
David Benjamin17cf2cb2016-12-13 01:07:13 -05001058 OPENSSL_memset(out, 0, max_out);
David Benjaminee0c8272015-09-13 01:03:54 -04001059 return 0;
1060}
1061
David Benjamin5960a902017-02-14 20:07:11 -05001062static int set_session_id_context(CERT *cert, const uint8_t *sid_ctx,
David Benjamin30c4c302016-12-07 22:35:24 -05001063 size_t sid_ctx_len) {
David Benjamin5960a902017-02-14 20:07:11 -05001064 if (sid_ctx_len > sizeof(cert->sid_ctx)) {
David Benjamin3570d732015-06-29 00:28:17 -04001065 OPENSSL_PUT_ERROR(SSL, SSL_R_SSL_SESSION_ID_CONTEXT_TOO_LONG);
Adam Langleyfcf25832014-12-18 17:42:32 -08001066 return 0;
1067 }
David Benjamin30c4c302016-12-07 22:35:24 -05001068
David Benjamin5960a902017-02-14 20:07:11 -05001069 OPENSSL_COMPILE_ASSERT(sizeof(cert->sid_ctx) < 256, sid_ctx_too_large);
1070 cert->sid_ctx_length = (uint8_t)sid_ctx_len;
1071 OPENSSL_memcpy(cert->sid_ctx, sid_ctx, sid_ctx_len);
Adam Langleyfcf25832014-12-18 17:42:32 -08001072 return 1;
1073}
Adam Langley95c29f32014-06-20 12:00:00 -07001074
David Benjamin5960a902017-02-14 20:07:11 -05001075int SSL_CTX_set_session_id_context(SSL_CTX *ctx, const uint8_t *sid_ctx,
1076 size_t sid_ctx_len) {
1077 return set_session_id_context(ctx->cert, sid_ctx, sid_ctx_len);
1078}
1079
Adam Langleyfcf25832014-12-18 17:42:32 -08001080int SSL_set_session_id_context(SSL *ssl, const uint8_t *sid_ctx,
David Benjamin30c4c302016-12-07 22:35:24 -05001081 size_t sid_ctx_len) {
David Benjamin5960a902017-02-14 20:07:11 -05001082 return set_session_id_context(ssl->cert, sid_ctx, sid_ctx_len);
Adam Langleyfcf25832014-12-18 17:42:32 -08001083}
Adam Langley95c29f32014-06-20 12:00:00 -07001084
David Benjamin07820b52016-12-07 21:13:41 -05001085const uint8_t *SSL_get0_session_id_context(const SSL *ssl, size_t *out_len) {
David Benjamin5960a902017-02-14 20:07:11 -05001086 *out_len = ssl->cert->sid_ctx_length;
1087 return ssl->cert->sid_ctx;
David Benjamin07820b52016-12-07 21:13:41 -05001088}
1089
Adam Langley858a88d2014-06-20 12:00:00 -07001090void ssl_cipher_preference_list_free(
Adam Langleyfcf25832014-12-18 17:42:32 -08001091 struct ssl_cipher_preference_list_st *cipher_list) {
David Benjamin5d1ec732015-04-22 13:38:00 -04001092 if (cipher_list == NULL) {
1093 return;
1094 }
Adam Langleyfcf25832014-12-18 17:42:32 -08001095 sk_SSL_CIPHER_free(cipher_list->ciphers);
1096 OPENSSL_free(cipher_list->in_group_flags);
1097 OPENSSL_free(cipher_list);
1098}
Adam Langley858a88d2014-06-20 12:00:00 -07001099
David Benjamin7481d392015-07-05 19:38:46 -04001100void SSL_certs_clear(SSL *ssl) { ssl_cert_clear_certs(ssl->cert); }
Adam Langley95c29f32014-06-20 12:00:00 -07001101
David Benjamin066fe0a2015-10-17 21:11:33 -04001102int SSL_get_fd(const SSL *ssl) { return SSL_get_rfd(ssl); }
Adam Langley95c29f32014-06-20 12:00:00 -07001103
David Benjamin066fe0a2015-10-17 21:11:33 -04001104int SSL_get_rfd(const SSL *ssl) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001105 int ret = -1;
David Benjamin066fe0a2015-10-17 21:11:33 -04001106 BIO *b = BIO_find_type(SSL_get_rbio(ssl), BIO_TYPE_DESCRIPTOR);
1107 if (b != NULL) {
1108 BIO_get_fd(b, &ret);
Adam Langleyfcf25832014-12-18 17:42:32 -08001109 }
1110 return ret;
1111}
Adam Langley95c29f32014-06-20 12:00:00 -07001112
David Benjamin066fe0a2015-10-17 21:11:33 -04001113int SSL_get_wfd(const SSL *ssl) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001114 int ret = -1;
David Benjamin066fe0a2015-10-17 21:11:33 -04001115 BIO *b = BIO_find_type(SSL_get_wbio(ssl), BIO_TYPE_DESCRIPTOR);
1116 if (b != NULL) {
1117 BIO_get_fd(b, &ret);
Adam Langleyfcf25832014-12-18 17:42:32 -08001118 }
Adam Langleyfcf25832014-12-18 17:42:32 -08001119 return ret;
1120}
Adam Langley95c29f32014-06-20 12:00:00 -07001121
David Benjamin066fe0a2015-10-17 21:11:33 -04001122int SSL_set_fd(SSL *ssl, int fd) {
David Benjamin22ce9b22016-03-06 19:26:52 -05001123 BIO *bio = BIO_new(BIO_s_socket());
Adam Langleyfcf25832014-12-18 17:42:32 -08001124 if (bio == NULL) {
David Benjamin3570d732015-06-29 00:28:17 -04001125 OPENSSL_PUT_ERROR(SSL, ERR_R_BUF_LIB);
David Benjamin066fe0a2015-10-17 21:11:33 -04001126 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001127 }
1128 BIO_set_fd(bio, fd, BIO_NOCLOSE);
David Benjamin066fe0a2015-10-17 21:11:33 -04001129 SSL_set_bio(ssl, bio, bio);
1130 return 1;
Adam Langleyfcf25832014-12-18 17:42:32 -08001131}
Adam Langley95c29f32014-06-20 12:00:00 -07001132
David Benjamin066fe0a2015-10-17 21:11:33 -04001133int SSL_set_wfd(SSL *ssl, int fd) {
David Benjamin2f871122016-05-20 14:27:17 -04001134 BIO *rbio = SSL_get_rbio(ssl);
1135 if (rbio == NULL || BIO_method_type(rbio) != BIO_TYPE_SOCKET ||
1136 BIO_get_fd(rbio, NULL) != fd) {
David Benjamin22ce9b22016-03-06 19:26:52 -05001137 BIO *bio = BIO_new(BIO_s_socket());
Adam Langleyfcf25832014-12-18 17:42:32 -08001138 if (bio == NULL) {
David Benjamin3570d732015-06-29 00:28:17 -04001139 OPENSSL_PUT_ERROR(SSL, ERR_R_BUF_LIB);
David Benjamin066fe0a2015-10-17 21:11:33 -04001140 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001141 }
1142 BIO_set_fd(bio, fd, BIO_NOCLOSE);
David Benjamin4501bd52016-08-01 13:39:41 -04001143 SSL_set0_wbio(ssl, bio);
Adam Langleyfcf25832014-12-18 17:42:32 -08001144 } else {
David Benjamin4501bd52016-08-01 13:39:41 -04001145 /* Copy the rbio over to the wbio. */
1146 BIO_up_ref(rbio);
1147 SSL_set0_wbio(ssl, rbio);
Adam Langleyfcf25832014-12-18 17:42:32 -08001148 }
1149
David Benjamin066fe0a2015-10-17 21:11:33 -04001150 return 1;
Adam Langleyfcf25832014-12-18 17:42:32 -08001151}
Adam Langley95c29f32014-06-20 12:00:00 -07001152
David Benjamin066fe0a2015-10-17 21:11:33 -04001153int SSL_set_rfd(SSL *ssl, int fd) {
David Benjamin2f871122016-05-20 14:27:17 -04001154 BIO *wbio = SSL_get_wbio(ssl);
1155 if (wbio == NULL || BIO_method_type(wbio) != BIO_TYPE_SOCKET ||
1156 BIO_get_fd(wbio, NULL) != fd) {
David Benjamin22ce9b22016-03-06 19:26:52 -05001157 BIO *bio = BIO_new(BIO_s_socket());
Adam Langleyfcf25832014-12-18 17:42:32 -08001158 if (bio == NULL) {
David Benjamin3570d732015-06-29 00:28:17 -04001159 OPENSSL_PUT_ERROR(SSL, ERR_R_BUF_LIB);
David Benjamin066fe0a2015-10-17 21:11:33 -04001160 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001161 }
1162 BIO_set_fd(bio, fd, BIO_NOCLOSE);
David Benjamin4501bd52016-08-01 13:39:41 -04001163 SSL_set0_rbio(ssl, bio);
Adam Langleyfcf25832014-12-18 17:42:32 -08001164 } else {
David Benjamin4501bd52016-08-01 13:39:41 -04001165 /* Copy the wbio over to the rbio. */
1166 BIO_up_ref(wbio);
1167 SSL_set0_rbio(ssl, wbio);
Adam Langleyfcf25832014-12-18 17:42:32 -08001168 }
David Benjamin066fe0a2015-10-17 21:11:33 -04001169 return 1;
Adam Langleyfcf25832014-12-18 17:42:32 -08001170}
Adam Langley95c29f32014-06-20 12:00:00 -07001171
David Benjamin49ddf412016-10-08 11:56:01 -04001172static size_t copy_finished(void *out, size_t out_len, const uint8_t *in,
1173 size_t in_len) {
1174 if (out_len > in_len) {
1175 out_len = in_len;
1176 }
David Benjamin17cf2cb2016-12-13 01:07:13 -05001177 OPENSSL_memcpy(out, in, out_len);
David Benjamin49ddf412016-10-08 11:56:01 -04001178 return in_len;
1179}
1180
David Benjamin1a1b34d2015-10-17 12:51:52 -04001181size_t SSL_get_finished(const SSL *ssl, void *buf, size_t count) {
David Benjaminced00b42016-10-08 11:24:09 -04001182 if (!ssl->s3->initial_handshake_complete ||
1183 ssl3_protocol_version(ssl) < TLS1_VERSION ||
1184 ssl3_protocol_version(ssl) >= TLS1_3_VERSION) {
1185 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001186 }
1187
David Benjamin49ddf412016-10-08 11:56:01 -04001188 if (ssl->server) {
1189 return copy_finished(buf, count, ssl->s3->previous_server_finished,
1190 ssl->s3->previous_server_finished_len);
David Benjaminced00b42016-10-08 11:24:09 -04001191 }
David Benjamin49ddf412016-10-08 11:56:01 -04001192
1193 return copy_finished(buf, count, ssl->s3->previous_client_finished,
1194 ssl->s3->previous_client_finished_len);
Adam Langleyfcf25832014-12-18 17:42:32 -08001195}
Adam Langley95c29f32014-06-20 12:00:00 -07001196
David Benjamin1a1b34d2015-10-17 12:51:52 -04001197size_t SSL_get_peer_finished(const SSL *ssl, void *buf, size_t count) {
David Benjaminced00b42016-10-08 11:24:09 -04001198 if (!ssl->s3->initial_handshake_complete ||
1199 ssl3_protocol_version(ssl) < TLS1_VERSION ||
1200 ssl3_protocol_version(ssl) >= TLS1_3_VERSION) {
1201 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001202 }
Adam Langley95c29f32014-06-20 12:00:00 -07001203
David Benjamin49ddf412016-10-08 11:56:01 -04001204 if (ssl->server) {
1205 return copy_finished(buf, count, ssl->s3->previous_client_finished,
1206 ssl->s3->previous_client_finished_len);
David Benjaminced00b42016-10-08 11:24:09 -04001207 }
David Benjamin49ddf412016-10-08 11:56:01 -04001208
1209 return copy_finished(buf, count, ssl->s3->previous_server_finished,
1210 ssl->s3->previous_server_finished_len);
Adam Langleyfcf25832014-12-18 17:42:32 -08001211}
Adam Langley95c29f32014-06-20 12:00:00 -07001212
David Benjamin59937042015-09-19 13:04:22 -04001213int SSL_get_verify_mode(const SSL *ssl) { return ssl->verify_mode; }
Adam Langley95c29f32014-06-20 12:00:00 -07001214
David Benjamin42fea372015-09-19 01:22:44 -04001215int SSL_get_extms_support(const SSL *ssl) {
David Benjaminfc02b592017-02-17 16:26:01 -05001216 /* TLS 1.3 does not require extended master secret and always reports as
1217 * supporting it. */
David Benjamina68c1182016-07-24 00:14:33 -04001218 if (!ssl->s3->have_version) {
1219 return 0;
1220 }
David Benjaminfc02b592017-02-17 16:26:01 -05001221 if (ssl3_protocol_version(ssl) >= TLS1_3_VERSION) {
1222 return 1;
1223 }
1224
1225 /* If the initial handshake completed, query the established session. */
1226 if (ssl->s3->established_session != NULL) {
1227 return ssl->s3->established_session->extended_master_secret;
1228 }
1229
1230 /* Otherwise, query the in-progress handshake. */
1231 if (ssl->s3->hs != NULL) {
1232 return ssl->s3->hs->extended_master_secret;
1233 }
1234 assert(0);
1235 return 0;
Matt Braithwaitecd6f54b2015-09-17 12:54:42 -07001236}
1237
David Benjamin9a41d1b2015-05-16 01:30:09 -04001238int SSL_CTX_get_read_ahead(const SSL_CTX *ctx) { return 0; }
Adam Langley95c29f32014-06-20 12:00:00 -07001239
David Benjamin0d56f882015-12-19 17:05:56 -05001240int SSL_get_read_ahead(const SSL *ssl) { return 0; }
Adam Langley95c29f32014-06-20 12:00:00 -07001241
David Benjamin9a41d1b2015-05-16 01:30:09 -04001242void SSL_CTX_set_read_ahead(SSL_CTX *ctx, int yes) { }
David Benjamin61ecccf2015-05-05 09:44:51 -04001243
David Benjamin0d56f882015-12-19 17:05:56 -05001244void SSL_set_read_ahead(SSL *ssl, int yes) { }
David Benjamin61ecccf2015-05-05 09:44:51 -04001245
David Benjamin9f859492015-10-03 10:44:30 -04001246int SSL_pending(const SSL *ssl) {
1247 if (ssl->s3->rrec.type != SSL3_RT_APPLICATION_DATA) {
1248 return 0;
1249 }
1250 return ssl->s3->rrec.length;
Adam Langleyfcf25832014-12-18 17:42:32 -08001251}
Adam Langley95c29f32014-06-20 12:00:00 -07001252
Adam Langley95c29f32014-06-20 12:00:00 -07001253/* Fix this so it checks all the valid key/cert options */
Adam Langleyfcf25832014-12-18 17:42:32 -08001254int SSL_CTX_check_private_key(const SSL_CTX *ctx) {
Adam Langley3a2b47a2017-01-24 13:59:42 -08001255 return ssl_cert_check_private_key(ctx->cert, ctx->cert->privatekey);
Adam Langleyc5ac2b62016-11-07 12:02:35 -08001256}
1257
1258/* Fix this function so that it takes an optional type parameter */
1259int SSL_check_private_key(const SSL *ssl) {
Adam Langley3a2b47a2017-01-24 13:59:42 -08001260 return ssl_cert_check_private_key(ssl->cert, ssl->cert->privatekey);
Adam Langleyfcf25832014-12-18 17:42:32 -08001261}
Adam Langley95c29f32014-06-20 12:00:00 -07001262
David Benjamin42fea372015-09-19 01:22:44 -04001263long SSL_get_default_timeout(const SSL *ssl) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001264 return SSL_DEFAULT_SESSION_TIMEOUT;
1265}
Adam Langley95c29f32014-06-20 12:00:00 -07001266
David Benjamin44d3eed2015-05-21 01:29:55 -04001267int SSL_renegotiate(SSL *ssl) {
1268 /* Caller-initiated renegotiation is not supported. */
David Benjamin3570d732015-06-29 00:28:17 -04001269 OPENSSL_PUT_ERROR(SSL, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
David Benjamin44d3eed2015-05-21 01:29:55 -04001270 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001271}
Adam Langley95c29f32014-06-20 12:00:00 -07001272
David Benjamin44d3eed2015-05-21 01:29:55 -04001273int SSL_renegotiate_pending(SSL *ssl) {
1274 return SSL_in_init(ssl) && ssl->s3->initial_handshake_complete;
Adam Langleyfcf25832014-12-18 17:42:32 -08001275}
Adam Langley95c29f32014-06-20 12:00:00 -07001276
David Benjamin936aada2016-06-07 19:09:22 -04001277int SSL_total_renegotiations(const SSL *ssl) {
1278 return ssl->s3->total_renegotiations;
1279}
1280
David Benjamin1d0a1942015-04-26 15:35:35 -04001281size_t SSL_CTX_get_max_cert_list(const SSL_CTX *ctx) {
1282 return ctx->max_cert_list;
1283}
1284
1285void SSL_CTX_set_max_cert_list(SSL_CTX *ctx, size_t max_cert_list) {
1286 if (max_cert_list > kMaxHandshakeSize) {
1287 max_cert_list = kMaxHandshakeSize;
1288 }
1289 ctx->max_cert_list = (uint32_t)max_cert_list;
1290}
1291
1292size_t SSL_get_max_cert_list(const SSL *ssl) {
1293 return ssl->max_cert_list;
1294}
1295
1296void SSL_set_max_cert_list(SSL *ssl, size_t max_cert_list) {
1297 if (max_cert_list > kMaxHandshakeSize) {
1298 max_cert_list = kMaxHandshakeSize;
1299 }
1300 ssl->max_cert_list = (uint32_t)max_cert_list;
1301}
1302
Adam Langleyce9d85e2016-01-24 15:58:39 -08001303int SSL_CTX_set_max_send_fragment(SSL_CTX *ctx, size_t max_send_fragment) {
David Benjamin1d0a1942015-04-26 15:35:35 -04001304 if (max_send_fragment < 512) {
1305 max_send_fragment = 512;
1306 }
1307 if (max_send_fragment > SSL3_RT_MAX_PLAIN_LENGTH) {
1308 max_send_fragment = SSL3_RT_MAX_PLAIN_LENGTH;
1309 }
1310 ctx->max_send_fragment = (uint16_t)max_send_fragment;
Adam Langleyce9d85e2016-01-24 15:58:39 -08001311
1312 return 1;
David Benjamin1d0a1942015-04-26 15:35:35 -04001313}
1314
Adam Langleyce9d85e2016-01-24 15:58:39 -08001315int SSL_set_max_send_fragment(SSL *ssl, size_t max_send_fragment) {
David Benjamin1d0a1942015-04-26 15:35:35 -04001316 if (max_send_fragment < 512) {
1317 max_send_fragment = 512;
1318 }
1319 if (max_send_fragment > SSL3_RT_MAX_PLAIN_LENGTH) {
1320 max_send_fragment = SSL3_RT_MAX_PLAIN_LENGTH;
1321 }
1322 ssl->max_send_fragment = (uint16_t)max_send_fragment;
Adam Langleyce9d85e2016-01-24 15:58:39 -08001323
1324 return 1;
David Benjamin1d0a1942015-04-26 15:35:35 -04001325}
1326
David Benjamincb9cf792015-05-05 09:46:14 -04001327int SSL_set_mtu(SSL *ssl, unsigned mtu) {
David Benjamince079fd2016-08-02 16:22:34 -04001328 if (!SSL_is_dtls(ssl) || mtu < dtls1_min_mtu()) {
David Benjamincb9cf792015-05-05 09:46:14 -04001329 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001330 }
David Benjamincb9cf792015-05-05 09:46:14 -04001331 ssl->d1->mtu = mtu;
1332 return 1;
1333}
1334
1335int SSL_get_secure_renegotiation_support(const SSL *ssl) {
David Benjamind2610042017-01-03 10:49:28 -05001336 if (!ssl->s3->have_version) {
1337 return 0;
1338 }
1339 return ssl3_protocol_version(ssl) >= TLS1_3_VERSION ||
1340 ssl->s3->send_connection_binding;
David Benjamincb9cf792015-05-05 09:46:14 -04001341}
1342
Adam Langleyfcf25832014-12-18 17:42:32 -08001343LHASH_OF(SSL_SESSION) *SSL_CTX_sessions(SSL_CTX *ctx) { return ctx->sessions; }
1344
David Benjamin71f7d3d2015-05-05 09:46:38 -04001345size_t SSL_CTX_sess_number(const SSL_CTX *ctx) {
1346 return lh_SSL_SESSION_num_items(ctx->sessions);
1347}
1348
1349unsigned long SSL_CTX_sess_set_cache_size(SSL_CTX *ctx, unsigned long size) {
1350 unsigned long ret = ctx->session_cache_size;
1351 ctx->session_cache_size = size;
1352 return ret;
1353}
1354
1355unsigned long SSL_CTX_sess_get_cache_size(const SSL_CTX *ctx) {
1356 return ctx->session_cache_size;
1357}
1358
1359int SSL_CTX_set_session_cache_mode(SSL_CTX *ctx, int mode) {
1360 int ret = ctx->session_cache_mode;
1361 ctx->session_cache_mode = mode;
1362 return ret;
1363}
1364
1365int SSL_CTX_get_session_cache_mode(const SSL_CTX *ctx) {
1366 return ctx->session_cache_mode;
1367}
1368
David Benjamin936aada2016-06-07 19:09:22 -04001369
1370int SSL_CTX_get_tlsext_ticket_keys(SSL_CTX *ctx, void *out, size_t len) {
1371 if (out == NULL) {
1372 return 48;
1373 }
1374 if (len != 48) {
1375 OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_TICKET_KEYS_LENGTH);
1376 return 0;
1377 }
1378 uint8_t *out_bytes = out;
David Benjamin17cf2cb2016-12-13 01:07:13 -05001379 OPENSSL_memcpy(out_bytes, ctx->tlsext_tick_key_name, 16);
1380 OPENSSL_memcpy(out_bytes + 16, ctx->tlsext_tick_hmac_key, 16);
1381 OPENSSL_memcpy(out_bytes + 32, ctx->tlsext_tick_aes_key, 16);
David Benjamin936aada2016-06-07 19:09:22 -04001382 return 1;
1383}
1384
1385int SSL_CTX_set_tlsext_ticket_keys(SSL_CTX *ctx, const void *in, size_t len) {
1386 if (in == NULL) {
1387 return 48;
1388 }
1389 if (len != 48) {
1390 OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_TICKET_KEYS_LENGTH);
1391 return 0;
1392 }
1393 const uint8_t *in_bytes = in;
David Benjamin17cf2cb2016-12-13 01:07:13 -05001394 OPENSSL_memcpy(ctx->tlsext_tick_key_name, in_bytes, 16);
1395 OPENSSL_memcpy(ctx->tlsext_tick_hmac_key, in_bytes + 16, 16);
1396 OPENSSL_memcpy(ctx->tlsext_tick_aes_key, in_bytes + 32, 16);
David Benjamin936aada2016-06-07 19:09:22 -04001397 return 1;
1398}
1399
1400int SSL_CTX_set_tlsext_ticket_key_cb(
1401 SSL_CTX *ctx, int (*callback)(SSL *ssl, uint8_t *key_name, uint8_t *iv,
1402 EVP_CIPHER_CTX *ctx, HMAC_CTX *hmac_ctx,
1403 int encrypt)) {
1404 ctx->tlsext_ticket_key_cb = callback;
1405 return 1;
1406}
1407
1408int SSL_CTX_set1_curves(SSL_CTX *ctx, const int *curves, size_t curves_len) {
1409 return tls1_set_curves(&ctx->supported_group_list,
1410 &ctx->supported_group_list_len, curves,
1411 curves_len);
1412}
1413
1414int SSL_set1_curves(SSL *ssl, const int *curves, size_t curves_len) {
1415 return tls1_set_curves(&ssl->supported_group_list,
1416 &ssl->supported_group_list_len, curves,
1417 curves_len);
1418}
1419
Alessandro Ghedini5fd18072016-09-28 21:04:25 +01001420int SSL_CTX_set1_curves_list(SSL_CTX *ctx, const char *curves) {
1421 return tls1_set_curves_list(&ctx->supported_group_list,
1422 &ctx->supported_group_list_len, curves);
1423}
1424
1425int SSL_set1_curves_list(SSL *ssl, const char *curves) {
1426 return tls1_set_curves_list(&ssl->supported_group_list,
1427 &ssl->supported_group_list_len, curves);
1428}
1429
David Benjamin9e68f192016-06-30 14:55:33 -04001430uint16_t SSL_get_curve_id(const SSL *ssl) {
1431 /* TODO(davidben): This checks the wrong session if there is a renegotiation in
1432 * progress. */
Steven Valdez87eab492016-06-27 16:34:59 -04001433 SSL_SESSION *session = SSL_get_session(ssl);
David Benjamin4882a6c2016-12-11 02:48:12 -05001434 if (session == NULL) {
David Benjamin9e68f192016-06-30 14:55:33 -04001435 return 0;
1436 }
1437
David Benjamin4882a6c2016-12-11 02:48:12 -05001438 return session->group_id;
David Benjamin9e68f192016-06-30 14:55:33 -04001439}
1440
David Benjamin936aada2016-06-07 19:09:22 -04001441int SSL_CTX_set_tmp_dh(SSL_CTX *ctx, const DH *dh) {
1442 DH_free(ctx->cert->dh_tmp);
1443 ctx->cert->dh_tmp = DHparams_dup(dh);
1444 if (ctx->cert->dh_tmp == NULL) {
1445 OPENSSL_PUT_ERROR(SSL, ERR_R_DH_LIB);
1446 return 0;
1447 }
1448 return 1;
1449}
1450
1451int SSL_set_tmp_dh(SSL *ssl, const DH *dh) {
1452 DH_free(ssl->cert->dh_tmp);
1453 ssl->cert->dh_tmp = DHparams_dup(dh);
1454 if (ssl->cert->dh_tmp == NULL) {
1455 OPENSSL_PUT_ERROR(SSL, ERR_R_DH_LIB);
1456 return 0;
1457 }
1458 return 1;
1459}
1460
David Benjamin8ebeabf2017-03-02 22:04:07 -05001461OPENSSL_EXPORT STACK_OF(SSL_CIPHER) *SSL_CTX_get_ciphers(const SSL_CTX *ctx) {
1462 return ctx->cipher_list->ciphers;
1463}
1464
David Benjamin32876b32015-09-20 12:17:03 -04001465STACK_OF(SSL_CIPHER) *SSL_get_ciphers(const SSL *ssl) {
1466 if (ssl == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001467 return NULL;
1468 }
Adam Langley0b5c1ac2014-06-20 12:00:00 -07001469
David Benjaminaf3b3d32016-10-31 16:29:57 -04001470 const struct ssl_cipher_preference_list_st *prefs =
1471 ssl_get_cipher_preferences(ssl);
1472 if (prefs == NULL) {
1473 return NULL;
Adam Langleyfcf25832014-12-18 17:42:32 -08001474 }
Adam Langley0b5c1ac2014-06-20 12:00:00 -07001475
David Benjaminaf3b3d32016-10-31 16:29:57 -04001476 return prefs->ciphers;
Adam Langleyfcf25832014-12-18 17:42:32 -08001477}
Adam Langley95c29f32014-06-20 12:00:00 -07001478
David Benjamin32876b32015-09-20 12:17:03 -04001479const char *SSL_get_cipher_list(const SSL *ssl, int n) {
David Benjamin32876b32015-09-20 12:17:03 -04001480 if (ssl == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001481 return NULL;
1482 }
Adam Langley95c29f32014-06-20 12:00:00 -07001483
David Benjamin8ebeabf2017-03-02 22:04:07 -05001484 STACK_OF(SSL_CIPHER) *sk = SSL_get_ciphers(ssl);
Adam Langleyfcf25832014-12-18 17:42:32 -08001485 if (sk == NULL || n < 0 || (size_t)n >= sk_SSL_CIPHER_num(sk)) {
1486 return NULL;
1487 }
Adam Langley95c29f32014-06-20 12:00:00 -07001488
David Benjamin8ebeabf2017-03-02 22:04:07 -05001489 const SSL_CIPHER *c = sk_SSL_CIPHER_value(sk, n);
Adam Langleyfcf25832014-12-18 17:42:32 -08001490 if (c == NULL) {
1491 return NULL;
1492 }
Adam Langley95c29f32014-06-20 12:00:00 -07001493
Adam Langleyfcf25832014-12-18 17:42:32 -08001494 return c->name;
1495}
David Benjamin5491e3f2014-09-29 19:33:09 -04001496
Adam Langleyfcf25832014-12-18 17:42:32 -08001497int SSL_CTX_set_cipher_list(SSL_CTX *ctx, const char *str) {
Matthew Braithwaite6ad20dc2017-02-21 16:41:33 -08001498 return ssl_create_cipher_list(ctx->method, &ctx->cipher_list, str,
1499 0 /* not strict */);
Matthew Braithwaitea57dcfb2017-02-17 22:08:23 -08001500}
1501
1502int SSL_CTX_set_strict_cipher_list(SSL_CTX *ctx, const char *str) {
Matthew Braithwaite6ad20dc2017-02-21 16:41:33 -08001503 return ssl_create_cipher_list(ctx->method, &ctx->cipher_list, str,
1504 1 /* strict */);
Adam Langleyfcf25832014-12-18 17:42:32 -08001505}
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) {
Matthew Braithwaite6ad20dc2017-02-21 16:41:33 -08001508 return ssl_create_cipher_list(ssl->ctx->method, &ssl->cipher_list, str,
1509 0 /* not strict */);
Matthew Braithwaitea57dcfb2017-02-17 22:08:23 -08001510}
1511
1512int SSL_set_strict_cipher_list(SSL *ssl, const char *str) {
Matthew Braithwaite6ad20dc2017-02-21 16:41:33 -08001513 return ssl_create_cipher_list(ssl->ctx->method, &ssl->cipher_list, str,
1514 1 /* strict */);
Adam Langleyfcf25832014-12-18 17:42:32 -08001515}
Adam Langley95c29f32014-06-20 12:00:00 -07001516
David Benjamin07e13842015-10-17 13:48:04 -04001517const char *SSL_get_servername(const SSL *ssl, const int type) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001518 if (type != TLSEXT_NAMETYPE_host_name) {
1519 return NULL;
1520 }
Adam Langley95c29f32014-06-20 12:00:00 -07001521
David Benjamin07e13842015-10-17 13:48:04 -04001522 /* Historically, |SSL_get_servername| was also the configuration getter
1523 * corresponding to |SSL_set_tlsext_host_name|. */
1524 if (ssl->tlsext_hostname != NULL) {
1525 return ssl->tlsext_hostname;
1526 }
1527
David Benjamin4eb95cc2016-11-16 17:08:23 +09001528 /* During the handshake, report the handshake value. */
1529 if (ssl->s3->hs != NULL) {
1530 return ssl->s3->hs->hostname;
1531 }
1532
1533 /* SSL_get_servername may also be called after the handshake to look up the
1534 * SNI value.
1535 *
1536 * TODO(davidben): This is almost unused. Can we remove it? */
Steven Valdez87eab492016-06-27 16:34:59 -04001537 SSL_SESSION *session = SSL_get_session(ssl);
1538 if (session == NULL) {
David Benjamin07e13842015-10-17 13:48:04 -04001539 return NULL;
1540 }
Steven Valdez87eab492016-06-27 16:34:59 -04001541 return session->tlsext_hostname;
Adam Langleyfcf25832014-12-18 17:42:32 -08001542}
Adam Langley95c29f32014-06-20 12:00:00 -07001543
David Benjamin07e13842015-10-17 13:48:04 -04001544int SSL_get_servername_type(const SSL *ssl) {
Steven Valdez87eab492016-06-27 16:34:59 -04001545 SSL_SESSION *session = SSL_get_session(ssl);
1546 if (session == NULL || session->tlsext_hostname == NULL) {
1547 return -1;
Adam Langleyfcf25832014-12-18 17:42:32 -08001548 }
Steven Valdez87eab492016-06-27 16:34:59 -04001549 return TLSEXT_NAMETYPE_host_name;
Adam Langleyfcf25832014-12-18 17:42:32 -08001550}
Adam Langley95c29f32014-06-20 12:00:00 -07001551
Adam Langleyfcf25832014-12-18 17:42:32 -08001552void SSL_CTX_enable_signed_cert_timestamps(SSL_CTX *ctx) {
1553 ctx->signed_cert_timestamps_enabled = 1;
1554}
HÃ¥vard Molland9169c962014-08-14 14:42:37 +02001555
Adam Langleyfe366722017-03-07 16:41:04 -08001556void SSL_CTX_i_promise_to_verify_certs_after_the_handshake(SSL_CTX *ctx) {
1557 ctx->i_promise_to_verify_certs_after_the_handshake = 1;
1558}
1559
David Benjamin26e1ff32017-02-14 20:13:00 -05001560void SSL_enable_signed_cert_timestamps(SSL *ssl) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001561 ssl->signed_cert_timestamps_enabled = 1;
Adam Langleyfcf25832014-12-18 17:42:32 -08001562}
HÃ¥vard Molland9169c962014-08-14 14:42:37 +02001563
Adam Langleyfcf25832014-12-18 17:42:32 -08001564void SSL_CTX_enable_ocsp_stapling(SSL_CTX *ctx) {
1565 ctx->ocsp_stapling_enabled = 1;
1566}
David Benjamin6c7aed02014-08-27 16:42:38 -04001567
David Benjamin26e1ff32017-02-14 20:13:00 -05001568void SSL_enable_ocsp_stapling(SSL *ssl) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001569 ssl->ocsp_stapling_enabled = 1;
Adam Langleyfcf25832014-12-18 17:42:32 -08001570}
David Benjamin6c7aed02014-08-27 16:42:38 -04001571
Adam Langleyfcf25832014-12-18 17:42:32 -08001572void SSL_get0_signed_cert_timestamp_list(const SSL *ssl, const uint8_t **out,
1573 size_t *out_len) {
Steven Valdez87eab492016-06-27 16:34:59 -04001574 SSL_SESSION *session = SSL_get_session(ssl);
Adam Langley3cb50e02014-08-26 14:00:31 -07001575
Adam Langleyfcf25832014-12-18 17:42:32 -08001576 *out_len = 0;
1577 *out = NULL;
1578 if (ssl->server || !session || !session->tlsext_signed_cert_timestamp_list) {
1579 return;
1580 }
HÃ¥vard Molland9169c962014-08-14 14:42:37 +02001581
Adam Langleyfcf25832014-12-18 17:42:32 -08001582 *out = session->tlsext_signed_cert_timestamp_list;
1583 *out_len = session->tlsext_signed_cert_timestamp_list_length;
1584}
David Benjamin6c7aed02014-08-27 16:42:38 -04001585
Adam Langleyfcf25832014-12-18 17:42:32 -08001586void SSL_get0_ocsp_response(const SSL *ssl, const uint8_t **out,
1587 size_t *out_len) {
Steven Valdez87eab492016-06-27 16:34:59 -04001588 SSL_SESSION *session = SSL_get_session(ssl);
Adam Langleyfcf25832014-12-18 17:42:32 -08001589
1590 *out_len = 0;
1591 *out = NULL;
1592 if (ssl->server || !session || !session->ocsp_response) {
1593 return;
1594 }
1595 *out = session->ocsp_response;
1596 *out_len = session->ocsp_response_length;
1597}
David Benjamin6c7aed02014-08-27 16:42:38 -04001598
David Benjamin936aada2016-06-07 19:09:22 -04001599int SSL_set_tlsext_host_name(SSL *ssl, const char *name) {
1600 OPENSSL_free(ssl->tlsext_hostname);
1601 ssl->tlsext_hostname = NULL;
1602
1603 if (name == NULL) {
1604 return 1;
1605 }
1606
1607 size_t len = strlen(name);
1608 if (len == 0 || len > TLSEXT_MAXLEN_host_name) {
1609 OPENSSL_PUT_ERROR(SSL, SSL_R_SSL3_EXT_INVALID_SERVERNAME);
1610 return 0;
1611 }
1612 ssl->tlsext_hostname = BUF_strdup(name);
1613 if (ssl->tlsext_hostname == NULL) {
1614 OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
1615 return 0;
1616 }
1617 return 1;
1618}
1619
1620int SSL_CTX_set_tlsext_servername_callback(
1621 SSL_CTX *ctx, int (*callback)(SSL *ssl, int *out_alert, void *arg)) {
1622 ctx->tlsext_servername_callback = callback;
1623 return 1;
1624}
1625
1626int SSL_CTX_set_tlsext_servername_arg(SSL_CTX *ctx, void *arg) {
1627 ctx->tlsext_servername_arg = arg;
1628 return 1;
1629}
1630
David Benjamin977547b2015-09-16 00:25:52 -04001631int SSL_select_next_proto(uint8_t **out, uint8_t *out_len,
1632 const uint8_t *server, unsigned server_len,
1633 const uint8_t *client, unsigned client_len) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001634 unsigned int i, j;
1635 const uint8_t *result;
1636 int status = OPENSSL_NPN_UNSUPPORTED;
Adam Langley95c29f32014-06-20 12:00:00 -07001637
Adam Langleyfcf25832014-12-18 17:42:32 -08001638 /* For each protocol in server preference order, see if we support it. */
1639 for (i = 0; i < server_len;) {
1640 for (j = 0; j < client_len;) {
1641 if (server[i] == client[j] &&
David Benjamin17cf2cb2016-12-13 01:07:13 -05001642 OPENSSL_memcmp(&server[i + 1], &client[j + 1], server[i]) == 0) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001643 /* We found a match */
1644 result = &server[i];
1645 status = OPENSSL_NPN_NEGOTIATED;
1646 goto found;
1647 }
1648 j += client[j];
1649 j++;
1650 }
1651 i += server[i];
1652 i++;
1653 }
Adam Langley95c29f32014-06-20 12:00:00 -07001654
Adam Langleyfcf25832014-12-18 17:42:32 -08001655 /* There's no overlap between our protocols and the server's list. */
1656 result = client;
1657 status = OPENSSL_NPN_NO_OVERLAP;
Adam Langley95c29f32014-06-20 12:00:00 -07001658
Adam Langleyfcf25832014-12-18 17:42:32 -08001659found:
1660 *out = (uint8_t *)result + 1;
David Benjamin977547b2015-09-16 00:25:52 -04001661 *out_len = result[0];
Adam Langleyfcf25832014-12-18 17:42:32 -08001662 return status;
1663}
Adam Langley95c29f32014-06-20 12:00:00 -07001664
David Benjamin977547b2015-09-16 00:25:52 -04001665void SSL_get0_next_proto_negotiated(const SSL *ssl, const uint8_t **out_data,
1666 unsigned *out_len) {
David Benjamin79978df2015-12-25 15:56:49 -05001667 *out_data = ssl->s3->next_proto_negotiated;
David Benjamin977547b2015-09-16 00:25:52 -04001668 if (*out_data == NULL) {
1669 *out_len = 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001670 } else {
David Benjamin79978df2015-12-25 15:56:49 -05001671 *out_len = ssl->s3->next_proto_negotiated_len;
Adam Langleyfcf25832014-12-18 17:42:32 -08001672 }
Adam Langley95c29f32014-06-20 12:00:00 -07001673}
1674
Adam Langleyfcf25832014-12-18 17:42:32 -08001675void SSL_CTX_set_next_protos_advertised_cb(
1676 SSL_CTX *ctx,
David Benjamin977547b2015-09-16 00:25:52 -04001677 int (*cb)(SSL *ssl, const uint8_t **out, unsigned *out_len, void *arg),
Adam Langleyfcf25832014-12-18 17:42:32 -08001678 void *arg) {
1679 ctx->next_protos_advertised_cb = cb;
1680 ctx->next_protos_advertised_cb_arg = arg;
1681}
Adam Langley95c29f32014-06-20 12:00:00 -07001682
Adam Langleyfcf25832014-12-18 17:42:32 -08001683void SSL_CTX_set_next_proto_select_cb(
David Benjamin977547b2015-09-16 00:25:52 -04001684 SSL_CTX *ctx, int (*cb)(SSL *ssl, uint8_t **out, uint8_t *out_len,
1685 const uint8_t *in, unsigned in_len, void *arg),
Adam Langleyfcf25832014-12-18 17:42:32 -08001686 void *arg) {
1687 ctx->next_proto_select_cb = cb;
1688 ctx->next_proto_select_cb_arg = arg;
1689}
Adam Langley95c29f32014-06-20 12:00:00 -07001690
Adam Langleyfcf25832014-12-18 17:42:32 -08001691int SSL_CTX_set_alpn_protos(SSL_CTX *ctx, const uint8_t *protos,
1692 unsigned protos_len) {
David Benjamin2755a3e2015-04-22 16:17:58 -04001693 OPENSSL_free(ctx->alpn_client_proto_list);
Adam Langleyfcf25832014-12-18 17:42:32 -08001694 ctx->alpn_client_proto_list = BUF_memdup(protos, protos_len);
1695 if (!ctx->alpn_client_proto_list) {
1696 return 1;
1697 }
1698 ctx->alpn_client_proto_list_len = protos_len;
Adam Langley95c29f32014-06-20 12:00:00 -07001699
Adam Langleyfcf25832014-12-18 17:42:32 -08001700 return 0;
1701}
Adam Langley95c29f32014-06-20 12:00:00 -07001702
Adam Langleyfcf25832014-12-18 17:42:32 -08001703int SSL_set_alpn_protos(SSL *ssl, const uint8_t *protos, unsigned protos_len) {
David Benjamin2755a3e2015-04-22 16:17:58 -04001704 OPENSSL_free(ssl->alpn_client_proto_list);
Adam Langleyfcf25832014-12-18 17:42:32 -08001705 ssl->alpn_client_proto_list = BUF_memdup(protos, protos_len);
1706 if (!ssl->alpn_client_proto_list) {
1707 return 1;
1708 }
1709 ssl->alpn_client_proto_list_len = protos_len;
Adam Langley95c29f32014-06-20 12:00:00 -07001710
Adam Langleyfcf25832014-12-18 17:42:32 -08001711 return 0;
1712}
Adam Langley95c29f32014-06-20 12:00:00 -07001713
Adam Langleyfcf25832014-12-18 17:42:32 -08001714void SSL_CTX_set_alpn_select_cb(SSL_CTX *ctx,
1715 int (*cb)(SSL *ssl, const uint8_t **out,
David Benjamin8984f1f2015-09-16 00:10:19 -04001716 uint8_t *out_len, const uint8_t *in,
1717 unsigned in_len, void *arg),
Adam Langleyfcf25832014-12-18 17:42:32 -08001718 void *arg) {
1719 ctx->alpn_select_cb = cb;
1720 ctx->alpn_select_cb_arg = arg;
1721}
Adam Langley95c29f32014-06-20 12:00:00 -07001722
David Benjamin8984f1f2015-09-16 00:10:19 -04001723void SSL_get0_alpn_selected(const SSL *ssl, const uint8_t **out_data,
1724 unsigned *out_len) {
1725 *out_data = NULL;
Adam Langleyfcf25832014-12-18 17:42:32 -08001726 if (ssl->s3) {
David Benjamin8984f1f2015-09-16 00:10:19 -04001727 *out_data = ssl->s3->alpn_selected;
Adam Langleyfcf25832014-12-18 17:42:32 -08001728 }
David Benjamin8984f1f2015-09-16 00:10:19 -04001729 if (*out_data == NULL) {
1730 *out_len = 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001731 } else {
David Benjamin8984f1f2015-09-16 00:10:19 -04001732 *out_len = ssl->s3->alpn_selected_len;
Adam Langleyfcf25832014-12-18 17:42:32 -08001733 }
1734}
Adam Langley95c29f32014-06-20 12:00:00 -07001735
David Benjamin936aada2016-06-07 19:09:22 -04001736
David Benjamineebd3c82016-12-06 17:43:58 -05001737void SSL_CTX_set_tls_channel_id_enabled(SSL_CTX *ctx, int enabled) {
1738 ctx->tlsext_channel_id_enabled = !!enabled;
1739}
1740
David Benjamin936aada2016-06-07 19:09:22 -04001741int SSL_CTX_enable_tls_channel_id(SSL_CTX *ctx) {
David Benjamineebd3c82016-12-06 17:43:58 -05001742 SSL_CTX_set_tls_channel_id_enabled(ctx, 1);
David Benjamin936aada2016-06-07 19:09:22 -04001743 return 1;
1744}
1745
David Benjamineebd3c82016-12-06 17:43:58 -05001746void SSL_set_tls_channel_id_enabled(SSL *ssl, int enabled) {
1747 ssl->tlsext_channel_id_enabled = !!enabled;
1748}
1749
David Benjamin936aada2016-06-07 19:09:22 -04001750int SSL_enable_tls_channel_id(SSL *ssl) {
David Benjamineebd3c82016-12-06 17:43:58 -05001751 SSL_set_tls_channel_id_enabled(ssl, 1);
David Benjamin936aada2016-06-07 19:09:22 -04001752 return 1;
1753}
1754
1755static int is_p256_key(EVP_PKEY *private_key) {
1756 const EC_KEY *ec_key = EVP_PKEY_get0_EC_KEY(private_key);
1757 return ec_key != NULL &&
1758 EC_GROUP_get_curve_name(EC_KEY_get0_group(ec_key)) ==
1759 NID_X9_62_prime256v1;
1760}
1761
1762int SSL_CTX_set1_tls_channel_id(SSL_CTX *ctx, EVP_PKEY *private_key) {
1763 if (!is_p256_key(private_key)) {
1764 OPENSSL_PUT_ERROR(SSL, SSL_R_CHANNEL_ID_NOT_P256);
1765 return 0;
1766 }
1767
1768 EVP_PKEY_free(ctx->tlsext_channel_id_private);
Adam Langley310d3f62016-07-12 10:39:20 -07001769 EVP_PKEY_up_ref(private_key);
1770 ctx->tlsext_channel_id_private = private_key;
David Benjamin936aada2016-06-07 19:09:22 -04001771 ctx->tlsext_channel_id_enabled = 1;
1772
1773 return 1;
1774}
1775
1776int SSL_set1_tls_channel_id(SSL *ssl, EVP_PKEY *private_key) {
1777 if (!is_p256_key(private_key)) {
1778 OPENSSL_PUT_ERROR(SSL, SSL_R_CHANNEL_ID_NOT_P256);
1779 return 0;
1780 }
1781
1782 EVP_PKEY_free(ssl->tlsext_channel_id_private);
Adam Langley310d3f62016-07-12 10:39:20 -07001783 EVP_PKEY_up_ref(private_key);
1784 ssl->tlsext_channel_id_private = private_key;
David Benjamin936aada2016-06-07 19:09:22 -04001785 ssl->tlsext_channel_id_enabled = 1;
1786
1787 return 1;
1788}
1789
1790size_t SSL_get_tls_channel_id(SSL *ssl, uint8_t *out, size_t max_out) {
1791 if (!ssl->s3->tlsext_channel_id_valid) {
1792 return 0;
1793 }
David Benjamin17cf2cb2016-12-13 01:07:13 -05001794 OPENSSL_memcpy(out, ssl->s3->tlsext_channel_id,
1795 (max_out < 64) ? max_out : 64);
David Benjamin936aada2016-06-07 19:09:22 -04001796 return 64;
1797}
1798
David Benjamin936aada2016-06-07 19:09:22 -04001799size_t SSL_get0_certificate_types(SSL *ssl, const uint8_t **out_types) {
David Benjamina0486782016-10-06 19:11:32 -04001800 if (ssl->server || ssl->s3->hs == NULL) {
David Benjamin936aada2016-06-07 19:09:22 -04001801 *out_types = NULL;
1802 return 0;
1803 }
David Benjamina0486782016-10-06 19:11:32 -04001804 *out_types = ssl->s3->hs->certificate_types;
1805 return ssl->s3->hs->num_certificate_types;
David Benjamin936aada2016-06-07 19:09:22 -04001806}
1807
David Benjaminf3c8f8d2016-11-17 17:20:47 +09001808void ssl_update_cache(SSL_HANDSHAKE *hs, int mode) {
1809 SSL *const ssl = hs->ssl;
David Benjaminbe497062017-03-10 16:08:36 -05001810 SSL_CTX *ctx = ssl->session_ctx;
David Benjaminb6d0c6d2015-03-19 19:07:26 -04001811 /* Never cache sessions with empty session IDs. */
Steven Valdez87eab492016-06-27 16:34:59 -04001812 if (ssl->s3->established_session->session_id_length == 0 ||
David Benjamin1269ddd2015-10-18 15:18:55 -04001813 (ctx->session_cache_mode & mode) != mode) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001814 return;
1815 }
Adam Langley95c29f32014-06-20 12:00:00 -07001816
David Benjamin1269ddd2015-10-18 15:18:55 -04001817 /* Clients never use the internal session cache. */
1818 int use_internal_cache = ssl->server && !(ctx->session_cache_mode &
1819 SSL_SESS_CACHE_NO_INTERNAL_STORE);
David Benjamin95d31822015-06-15 19:53:32 -04001820
David Benjamin1269ddd2015-10-18 15:18:55 -04001821 /* A client may see new sessions on abbreviated handshakes if the server
1822 * decides to renew the ticket. Once the handshake is completed, it should be
1823 * inserted into the cache. */
Steven Valdez87eab492016-06-27 16:34:59 -04001824 if (ssl->s3->established_session != ssl->session ||
David Benjaminf3c8f8d2016-11-17 17:20:47 +09001825 (!ssl->server && hs->ticket_expected)) {
David Benjamin1269ddd2015-10-18 15:18:55 -04001826 if (use_internal_cache) {
Steven Valdez87eab492016-06-27 16:34:59 -04001827 SSL_CTX_add_session(ctx, ssl->s3->established_session);
David Benjamin1269ddd2015-10-18 15:18:55 -04001828 }
David Benjaminb9195402016-08-05 10:51:43 -04001829 if (ctx->new_session_cb != NULL) {
1830 SSL_SESSION_up_ref(ssl->s3->established_session);
1831 if (!ctx->new_session_cb(ssl, ssl->s3->established_session)) {
1832 /* |new_session_cb|'s return value signals whether it took ownership. */
1833 SSL_SESSION_free(ssl->s3->established_session);
1834 }
Adam Langleyfcf25832014-12-18 17:42:32 -08001835 }
1836 }
Adam Langley95c29f32014-06-20 12:00:00 -07001837
David Benjamin1269ddd2015-10-18 15:18:55 -04001838 if (use_internal_cache &&
1839 !(ctx->session_cache_mode & SSL_SESS_CACHE_NO_AUTO_CLEAR)) {
David Benjaminb6d0c6d2015-03-19 19:07:26 -04001840 /* Automatically flush the internal session cache every 255 connections. */
1841 int flush_cache = 0;
Adam Langley4bdb6e42015-05-15 15:29:21 -07001842 CRYPTO_MUTEX_lock_write(&ctx->lock);
David Benjaminb6d0c6d2015-03-19 19:07:26 -04001843 ctx->handshakes_since_cache_flush++;
1844 if (ctx->handshakes_since_cache_flush >= 255) {
1845 flush_cache = 1;
1846 ctx->handshakes_since_cache_flush = 0;
1847 }
David Benjamin29270de2016-05-24 15:28:36 +00001848 CRYPTO_MUTEX_unlock_write(&ctx->lock);
David Benjaminb6d0c6d2015-03-19 19:07:26 -04001849
1850 if (flush_cache) {
David Benjaminad8f5e12017-02-20 17:00:20 -05001851 struct OPENSSL_timeval now;
David Benjamin721e8b72016-08-03 13:13:17 -04001852 ssl_get_current_time(ssl, &now);
David Benjaminad8f5e12017-02-20 17:00:20 -05001853 SSL_CTX_flush_sessions(ctx, now.tv_sec);
Adam Langleyfcf25832014-12-18 17:42:32 -08001854 }
1855 }
1856}
Adam Langley95c29f32014-06-20 12:00:00 -07001857
Adam Langleyfcf25832014-12-18 17:42:32 -08001858static const char *ssl_get_version(int version) {
1859 switch (version) {
Steven Valdezfdd10992016-09-15 16:27:05 -04001860 /* Report TLS 1.3 draft version as TLS 1.3 in the public API. */
1861 case TLS1_3_DRAFT_VERSION:
Steven Valdez4f94b1c2016-05-24 12:31:07 -04001862 return "TLSv1.3";
1863
Adam Langleyfcf25832014-12-18 17:42:32 -08001864 case TLS1_2_VERSION:
1865 return "TLSv1.2";
Adam Langley95c29f32014-06-20 12:00:00 -07001866
Adam Langleyfcf25832014-12-18 17:42:32 -08001867 case TLS1_1_VERSION:
1868 return "TLSv1.1";
Adam Langley95c29f32014-06-20 12:00:00 -07001869
Adam Langleyfcf25832014-12-18 17:42:32 -08001870 case TLS1_VERSION:
1871 return "TLSv1";
Adam Langley95c29f32014-06-20 12:00:00 -07001872
Adam Langleyfcf25832014-12-18 17:42:32 -08001873 case SSL3_VERSION:
1874 return "SSLv3";
Adam Langley95c29f32014-06-20 12:00:00 -07001875
David Benjamin1c722b72015-04-20 13:53:10 -04001876 case DTLS1_VERSION:
1877 return "DTLSv1";
1878
1879 case DTLS1_2_VERSION:
1880 return "DTLSv1.2";
1881
Adam Langleyfcf25832014-12-18 17:42:32 -08001882 default:
1883 return "unknown";
1884 }
1885}
Adam Langley95c29f32014-06-20 12:00:00 -07001886
David Benjamin42fea372015-09-19 01:22:44 -04001887const char *SSL_get_version(const SSL *ssl) {
1888 return ssl_get_version(ssl->version);
Adam Langleyfcf25832014-12-18 17:42:32 -08001889}
Adam Langley95c29f32014-06-20 12:00:00 -07001890
David Benjamina6b8cdf2015-09-13 14:07:33 -04001891const char *SSL_SESSION_get_version(const SSL_SESSION *session) {
1892 return ssl_get_version(session->ssl_version);
Adam Langleyfcf25832014-12-18 17:42:32 -08001893}
Adam Langley95c29f32014-06-20 12:00:00 -07001894
David Benjamin0d56f882015-12-19 17:05:56 -05001895EVP_PKEY *SSL_get_privatekey(const SSL *ssl) {
1896 if (ssl->cert != NULL) {
1897 return ssl->cert->privatekey;
Adam Langleyfcf25832014-12-18 17:42:32 -08001898 }
1899
1900 return NULL;
1901}
1902
Adam Langleyfcf25832014-12-18 17:42:32 -08001903EVP_PKEY *SSL_CTX_get0_privatekey(const SSL_CTX *ctx) {
1904 if (ctx->cert != NULL) {
David Benjamind1d80782015-07-05 11:54:09 -04001905 return ctx->cert->privatekey;
Adam Langleyfcf25832014-12-18 17:42:32 -08001906 }
1907
1908 return NULL;
1909}
1910
David Benjamin42fea372015-09-19 01:22:44 -04001911const SSL_CIPHER *SSL_get_current_cipher(const SSL *ssl) {
David Benjamin79978df2015-12-25 15:56:49 -05001912 if (ssl->s3->aead_write_ctx == NULL) {
David Benjamina07c0fc2015-05-13 13:19:42 -04001913 return NULL;
Adam Langleyfcf25832014-12-18 17:42:32 -08001914 }
David Benjamin79978df2015-12-25 15:56:49 -05001915 return ssl->s3->aead_write_ctx->cipher;
Adam Langleyfcf25832014-12-18 17:42:32 -08001916}
1917
David Benjamin936aada2016-06-07 19:09:22 -04001918int SSL_session_reused(const SSL *ssl) {
Steven Valdez4aa154e2016-07-29 14:32:55 -04001919 return ssl->s3->session_reused;
David Benjamin936aada2016-06-07 19:09:22 -04001920}
1921
David Benjamin0d56f882015-12-19 17:05:56 -05001922const COMP_METHOD *SSL_get_current_compression(SSL *ssl) { return NULL; }
Adam Langleyfcf25832014-12-18 17:42:32 -08001923
David Benjamin0d56f882015-12-19 17:05:56 -05001924const COMP_METHOD *SSL_get_current_expansion(SSL *ssl) { return NULL; }
Adam Langleyfcf25832014-12-18 17:42:32 -08001925
Adam Langley29ec5d12016-03-01 16:12:28 -08001926int *SSL_get_server_tmp_key(SSL *ssl, EVP_PKEY **out_key) { return 0; }
1927
Adam Langleyfcf25832014-12-18 17:42:32 -08001928void SSL_CTX_set_quiet_shutdown(SSL_CTX *ctx, int mode) {
Adam Langleybb85f3d2015-10-28 18:44:11 -07001929 ctx->quiet_shutdown = (mode != 0);
Adam Langleyfcf25832014-12-18 17:42:32 -08001930}
1931
1932int SSL_CTX_get_quiet_shutdown(const SSL_CTX *ctx) {
1933 return ctx->quiet_shutdown;
1934}
1935
Adam Langleybb85f3d2015-10-28 18:44:11 -07001936void SSL_set_quiet_shutdown(SSL *ssl, int mode) {
1937 ssl->quiet_shutdown = (mode != 0);
1938}
Adam Langleyfcf25832014-12-18 17:42:32 -08001939
David Benjamin9f859492015-10-03 10:44:30 -04001940int SSL_get_quiet_shutdown(const SSL *ssl) { return ssl->quiet_shutdown; }
Adam Langleyfcf25832014-12-18 17:42:32 -08001941
David Benjamin63006a92015-10-18 00:00:06 -04001942void SSL_set_shutdown(SSL *ssl, int mode) {
1943 /* It is an error to clear any bits that have already been set. (We can't try
1944 * to get a second close_notify or send two.) */
David Benjaminfa214e42016-05-10 17:03:10 -04001945 assert((SSL_get_shutdown(ssl) & mode) == SSL_get_shutdown(ssl));
David Benjamin63006a92015-10-18 00:00:06 -04001946
David Benjaminfa214e42016-05-10 17:03:10 -04001947 if (mode & SSL_RECEIVED_SHUTDOWN &&
1948 ssl->s3->recv_shutdown == ssl_shutdown_none) {
1949 ssl->s3->recv_shutdown = ssl_shutdown_close_notify;
1950 }
1951
1952 if (mode & SSL_SENT_SHUTDOWN &&
1953 ssl->s3->send_shutdown == ssl_shutdown_none) {
1954 ssl->s3->send_shutdown = ssl_shutdown_close_notify;
1955 }
David Benjamin63006a92015-10-18 00:00:06 -04001956}
Adam Langleyfcf25832014-12-18 17:42:32 -08001957
David Benjaminfa214e42016-05-10 17:03:10 -04001958int SSL_get_shutdown(const SSL *ssl) {
1959 int ret = 0;
1960 if (ssl->s3->recv_shutdown != ssl_shutdown_none) {
1961 /* Historically, OpenSSL set |SSL_RECEIVED_SHUTDOWN| on both close_notify
1962 * and fatal alert. */
1963 ret |= SSL_RECEIVED_SHUTDOWN;
1964 }
1965 if (ssl->s3->send_shutdown == ssl_shutdown_close_notify) {
1966 /* Historically, OpenSSL set |SSL_SENT_SHUTDOWN| on only close_notify. */
1967 ret |= SSL_SENT_SHUTDOWN;
1968 }
1969 return ret;
1970}
Adam Langleyfcf25832014-12-18 17:42:32 -08001971
Steven Valdezfdd10992016-09-15 16:27:05 -04001972int SSL_version(const SSL *ssl) {
1973 /* Report TLS 1.3 draft version as TLS 1.3 in the public API. */
1974 if (ssl->version == TLS1_3_DRAFT_VERSION) {
1975 return TLS1_3_VERSION;
1976 }
1977
1978 return ssl->version;
1979}
Adam Langleyfcf25832014-12-18 17:42:32 -08001980
1981SSL_CTX *SSL_get_SSL_CTX(const SSL *ssl) { return ssl->ctx; }
1982
1983SSL_CTX *SSL_set_SSL_CTX(SSL *ssl, SSL_CTX *ctx) {
1984 if (ssl->ctx == ctx) {
1985 return ssl->ctx;
1986 }
1987
Adam Langley3509dac2017-02-01 11:59:18 -08001988 /* One cannot change the X.509 callbacks during a connection. */
1989 if (ssl->ctx->x509_method != ctx->x509_method) {
1990 assert(0);
1991 return NULL;
1992 }
1993
Adam Langleyfcf25832014-12-18 17:42:32 -08001994 if (ctx == NULL) {
David Benjaminbe497062017-03-10 16:08:36 -05001995 ctx = ssl->session_ctx;
Adam Langleyfcf25832014-12-18 17:42:32 -08001996 }
1997
David Benjamin2755a3e2015-04-22 16:17:58 -04001998 ssl_cert_free(ssl->cert);
Adam Langleyfcf25832014-12-18 17:42:32 -08001999 ssl->cert = ssl_cert_dup(ctx->cert);
David Benjamin2755a3e2015-04-22 16:17:58 -04002000
David Benjaminf650c712016-12-22 15:54:51 -05002001 SSL_CTX_up_ref(ctx);
2002 SSL_CTX_free(ssl->ctx);
Adam Langleyfcf25832014-12-18 17:42:32 -08002003 ssl->ctx = ctx;
2004
Adam Langleyfcf25832014-12-18 17:42:32 -08002005 return ssl->ctx;
2006}
2007
Adam Langley95c29f32014-06-20 12:00:00 -07002008void SSL_set_info_callback(SSL *ssl,
David Benjamin82170242015-10-17 22:51:17 -04002009 void (*cb)(const SSL *ssl, int type, int value)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002010 ssl->info_callback = cb;
2011}
Adam Langley95c29f32014-06-20 12:00:00 -07002012
David Benjamin82170242015-10-17 22:51:17 -04002013void (*SSL_get_info_callback(const SSL *ssl))(const SSL *ssl, int type,
2014 int value) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002015 return ssl->info_callback;
2016}
Adam Langley95c29f32014-06-20 12:00:00 -07002017
David Benjamincb0c29f2016-12-12 17:00:50 -05002018int SSL_state(const SSL *ssl) {
David Benjamin9e766d72017-02-10 23:14:17 -05002019 return SSL_in_init(ssl) ? SSL_ST_INIT : SSL_ST_OK;
David Benjamincb0c29f2016-12-12 17:00:50 -05002020}
Adam Langley95c29f32014-06-20 12:00:00 -07002021
David Benjaminece089c2015-05-15 23:52:42 -04002022void SSL_set_state(SSL *ssl, int state) { }
Adam Langley95c29f32014-06-20 12:00:00 -07002023
Emily Stark95a79ee2016-02-25 21:12:28 -08002024char *SSL_get_shared_ciphers(const SSL *ssl, char *buf, int len) {
2025 if (len <= 0) {
2026 return NULL;
2027 }
2028 buf[0] = '\0';
2029 return buf;
2030}
2031
David Benjamin8a589332015-12-04 23:14:35 -05002032int SSL_get_ex_new_index(long argl, void *argp, CRYPTO_EX_unused *unused,
Adam Langleyfcf25832014-12-18 17:42:32 -08002033 CRYPTO_EX_dup *dup_func, CRYPTO_EX_free *free_func) {
David Benjamin9f33fc62015-04-15 17:29:53 -04002034 int index;
2035 if (!CRYPTO_get_ex_new_index(&g_ex_data_class_ssl, &index, argl, argp,
David Benjamin8a589332015-12-04 23:14:35 -05002036 dup_func, free_func)) {
David Benjamin9f33fc62015-04-15 17:29:53 -04002037 return -1;
2038 }
2039 return index;
Adam Langleyfcf25832014-12-18 17:42:32 -08002040}
Adam Langley95c29f32014-06-20 12:00:00 -07002041
David Benjamin1ac08fe2015-09-15 01:36:22 -04002042int SSL_set_ex_data(SSL *ssl, int idx, void *arg) {
2043 return CRYPTO_set_ex_data(&ssl->ex_data, idx, arg);
Adam Langleyfcf25832014-12-18 17:42:32 -08002044}
Adam Langley95c29f32014-06-20 12:00:00 -07002045
David Benjamin1ac08fe2015-09-15 01:36:22 -04002046void *SSL_get_ex_data(const SSL *ssl, int idx) {
2047 return CRYPTO_get_ex_data(&ssl->ex_data, idx);
Adam Langleyfcf25832014-12-18 17:42:32 -08002048}
Adam Langley95c29f32014-06-20 12:00:00 -07002049
David Benjamin8a589332015-12-04 23:14:35 -05002050int SSL_CTX_get_ex_new_index(long argl, void *argp, CRYPTO_EX_unused *unused,
Adam Langleyfcf25832014-12-18 17:42:32 -08002051 CRYPTO_EX_dup *dup_func,
2052 CRYPTO_EX_free *free_func) {
David Benjamin9f33fc62015-04-15 17:29:53 -04002053 int index;
2054 if (!CRYPTO_get_ex_new_index(&g_ex_data_class_ssl_ctx, &index, argl, argp,
David Benjamin8a589332015-12-04 23:14:35 -05002055 dup_func, free_func)) {
David Benjamin9f33fc62015-04-15 17:29:53 -04002056 return -1;
2057 }
2058 return index;
Adam Langleyfcf25832014-12-18 17:42:32 -08002059}
Adam Langley95c29f32014-06-20 12:00:00 -07002060
David Benjamin1ac08fe2015-09-15 01:36:22 -04002061int SSL_CTX_set_ex_data(SSL_CTX *ctx, int idx, void *arg) {
2062 return CRYPTO_set_ex_data(&ctx->ex_data, idx, arg);
Adam Langleyfcf25832014-12-18 17:42:32 -08002063}
Adam Langley95c29f32014-06-20 12:00:00 -07002064
David Benjamin1ac08fe2015-09-15 01:36:22 -04002065void *SSL_CTX_get_ex_data(const SSL_CTX *ctx, int idx) {
2066 return CRYPTO_get_ex_data(&ctx->ex_data, idx);
Adam Langleyfcf25832014-12-18 17:42:32 -08002067}
Adam Langley95c29f32014-06-20 12:00:00 -07002068
David Benjamin93d17492015-10-17 12:43:36 -04002069int SSL_want(const SSL *ssl) { return ssl->rwstate; }
Adam Langley95c29f32014-06-20 12:00:00 -07002070
Adam Langleyfcf25832014-12-18 17:42:32 -08002071void SSL_CTX_set_tmp_rsa_callback(SSL_CTX *ctx,
2072 RSA *(*cb)(SSL *ssl, int is_export,
2073 int keylength)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002074}
Adam Langley95c29f32014-06-20 12:00:00 -07002075
Adam Langleyfcf25832014-12-18 17:42:32 -08002076void SSL_set_tmp_rsa_callback(SSL *ssl, RSA *(*cb)(SSL *ssl, int is_export,
2077 int keylength)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002078}
2079
2080void SSL_CTX_set_tmp_dh_callback(SSL_CTX *ctx,
David Benjamin59015c32015-04-26 13:13:55 -04002081 DH *(*callback)(SSL *ssl, int is_export,
2082 int keylength)) {
2083 ctx->cert->dh_tmp_cb = callback;
Adam Langleyfcf25832014-12-18 17:42:32 -08002084}
2085
David Benjamin59015c32015-04-26 13:13:55 -04002086void SSL_set_tmp_dh_callback(SSL *ssl, DH *(*callback)(SSL *ssl, int is_export,
2087 int keylength)) {
2088 ssl->cert->dh_tmp_cb = callback;
Adam Langleyfcf25832014-12-18 17:42:32 -08002089}
2090
Adam Langleyfcf25832014-12-18 17:42:32 -08002091int SSL_CTX_use_psk_identity_hint(SSL_CTX *ctx, const char *identity_hint) {
2092 if (identity_hint != NULL && strlen(identity_hint) > PSK_MAX_IDENTITY_LEN) {
David Benjamin3570d732015-06-29 00:28:17 -04002093 OPENSSL_PUT_ERROR(SSL, SSL_R_DATA_LENGTH_TOO_LONG);
Adam Langleyfcf25832014-12-18 17:42:32 -08002094 return 0;
2095 }
2096
David Benjamin2755a3e2015-04-22 16:17:58 -04002097 OPENSSL_free(ctx->psk_identity_hint);
Adam Langleyfcf25832014-12-18 17:42:32 -08002098
2099 if (identity_hint != NULL) {
2100 ctx->psk_identity_hint = BUF_strdup(identity_hint);
2101 if (ctx->psk_identity_hint == NULL) {
2102 return 0;
Adam Langley95c29f32014-06-20 12:00:00 -07002103 }
Adam Langleyfcf25832014-12-18 17:42:32 -08002104 } else {
2105 ctx->psk_identity_hint = NULL;
2106 }
Adam Langley95c29f32014-06-20 12:00:00 -07002107
Adam Langleyfcf25832014-12-18 17:42:32 -08002108 return 1;
2109}
2110
David Benjamine8814df2015-09-15 08:05:54 -04002111int SSL_use_psk_identity_hint(SSL *ssl, const char *identity_hint) {
2112 if (ssl == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002113 return 0;
2114 }
2115
2116 if (identity_hint != NULL && strlen(identity_hint) > PSK_MAX_IDENTITY_LEN) {
David Benjamin3570d732015-06-29 00:28:17 -04002117 OPENSSL_PUT_ERROR(SSL, SSL_R_DATA_LENGTH_TOO_LONG);
Adam Langleyfcf25832014-12-18 17:42:32 -08002118 return 0;
2119 }
2120
2121 /* Clear currently configured hint, if any. */
David Benjamine8814df2015-09-15 08:05:54 -04002122 OPENSSL_free(ssl->psk_identity_hint);
2123 ssl->psk_identity_hint = NULL;
Adam Langleyfcf25832014-12-18 17:42:32 -08002124
David Benjamin78679342016-09-16 19:42:05 -04002125 /* Treat the empty hint as not supplying one. Plain PSK makes it possible to
2126 * send either no hint (omit ServerKeyExchange) or an empty hint, while
2127 * ECDHE_PSK can only spell empty hint. Having different capabilities is odd,
2128 * so we interpret empty and missing as identical. */
2129 if (identity_hint != NULL && identity_hint[0] != '\0') {
David Benjamine8814df2015-09-15 08:05:54 -04002130 ssl->psk_identity_hint = BUF_strdup(identity_hint);
2131 if (ssl->psk_identity_hint == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002132 return 0;
Adam Langley95c29f32014-06-20 12:00:00 -07002133 }
Adam Langleyfcf25832014-12-18 17:42:32 -08002134 }
Adam Langley95c29f32014-06-20 12:00:00 -07002135
Adam Langleyfcf25832014-12-18 17:42:32 -08002136 return 1;
2137}
Adam Langley95c29f32014-06-20 12:00:00 -07002138
David Benjamine8814df2015-09-15 08:05:54 -04002139const char *SSL_get_psk_identity_hint(const SSL *ssl) {
2140 if (ssl == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002141 return NULL;
2142 }
David Benjamine8814df2015-09-15 08:05:54 -04002143 return ssl->psk_identity_hint;
Adam Langleyfcf25832014-12-18 17:42:32 -08002144}
Adam Langley95c29f32014-06-20 12:00:00 -07002145
David Benjamine8814df2015-09-15 08:05:54 -04002146const char *SSL_get_psk_identity(const SSL *ssl) {
Steven Valdez87eab492016-06-27 16:34:59 -04002147 if (ssl == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002148 return NULL;
2149 }
Steven Valdez87eab492016-06-27 16:34:59 -04002150 SSL_SESSION *session = SSL_get_session(ssl);
2151 if (session == NULL) {
2152 return NULL;
2153 }
2154 return session->psk_identity;
Adam Langleyfcf25832014-12-18 17:42:32 -08002155}
Adam Langley95c29f32014-06-20 12:00:00 -07002156
Adam Langleyfcf25832014-12-18 17:42:32 -08002157void SSL_set_psk_client_callback(
David Benjamine8814df2015-09-15 08:05:54 -04002158 SSL *ssl, unsigned (*cb)(SSL *ssl, const char *hint, char *identity,
2159 unsigned max_identity_len, uint8_t *psk,
2160 unsigned max_psk_len)) {
2161 ssl->psk_client_callback = cb;
Adam Langleyfcf25832014-12-18 17:42:32 -08002162}
Adam Langley95c29f32014-06-20 12:00:00 -07002163
Adam Langleyfcf25832014-12-18 17:42:32 -08002164void SSL_CTX_set_psk_client_callback(
David Benjamine8814df2015-09-15 08:05:54 -04002165 SSL_CTX *ctx, unsigned (*cb)(SSL *ssl, const char *hint, char *identity,
2166 unsigned max_identity_len, uint8_t *psk,
2167 unsigned max_psk_len)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002168 ctx->psk_client_callback = cb;
2169}
Adam Langley95c29f32014-06-20 12:00:00 -07002170
Adam Langleyfcf25832014-12-18 17:42:32 -08002171void SSL_set_psk_server_callback(
David Benjamine8814df2015-09-15 08:05:54 -04002172 SSL *ssl, unsigned (*cb)(SSL *ssl, const char *identity, uint8_t *psk,
2173 unsigned max_psk_len)) {
2174 ssl->psk_server_callback = cb;
Adam Langleyfcf25832014-12-18 17:42:32 -08002175}
Adam Langley95c29f32014-06-20 12:00:00 -07002176
Adam Langleyfcf25832014-12-18 17:42:32 -08002177void SSL_CTX_set_psk_server_callback(
David Benjamine8814df2015-09-15 08:05:54 -04002178 SSL_CTX *ctx, unsigned (*cb)(SSL *ssl, const char *identity,
2179 uint8_t *psk, unsigned max_psk_len)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002180 ctx->psk_server_callback = cb;
2181}
Adam Langley95c29f32014-06-20 12:00:00 -07002182
Adam Langleyfcf25832014-12-18 17:42:32 -08002183void SSL_CTX_set_msg_callback(SSL_CTX *ctx,
2184 void (*cb)(int write_p, int version,
2185 int content_type, const void *buf,
2186 size_t len, SSL *ssl, void *arg)) {
David Benjamin59015c32015-04-26 13:13:55 -04002187 ctx->msg_callback = cb;
Adam Langleyfcf25832014-12-18 17:42:32 -08002188}
David Benjamin61ecccf2015-05-05 09:44:51 -04002189
2190void SSL_CTX_set_msg_callback_arg(SSL_CTX *ctx, void *arg) {
2191 ctx->msg_callback_arg = arg;
2192}
2193
Adam Langleyfcf25832014-12-18 17:42:32 -08002194void SSL_set_msg_callback(SSL *ssl,
2195 void (*cb)(int write_p, int version, int content_type,
2196 const void *buf, size_t len, SSL *ssl,
2197 void *arg)) {
David Benjamin59015c32015-04-26 13:13:55 -04002198 ssl->msg_callback = cb;
Adam Langleyfcf25832014-12-18 17:42:32 -08002199}
Adam Langley95c29f32014-06-20 12:00:00 -07002200
David Benjamin61ecccf2015-05-05 09:44:51 -04002201void SSL_set_msg_callback_arg(SSL *ssl, void *arg) {
2202 ssl->msg_callback_arg = arg;
2203}
2204
David Benjamind28f59c2015-11-17 22:32:50 -05002205void SSL_CTX_set_keylog_callback(SSL_CTX *ctx,
2206 void (*cb)(const SSL *ssl, const char *line)) {
2207 ctx->keylog_callback = cb;
Adam Langleyfcf25832014-12-18 17:42:32 -08002208}
Adam Langley95c29f32014-06-20 12:00:00 -07002209
David Benjamin6e3f5cc2016-09-14 14:43:14 -04002210void (*SSL_CTX_get_keylog_callback(const SSL_CTX *ctx))(const SSL *ssl,
2211 const char *line) {
2212 return ctx->keylog_callback;
2213}
2214
Taylor Brandstetter9edb2c62016-06-08 15:26:59 -07002215void SSL_CTX_set_current_time_cb(SSL_CTX *ctx,
2216 void (*cb)(const SSL *ssl,
2217 struct timeval *out_clock)) {
2218 ctx->current_time_cb = cb;
2219}
2220
Adam Langleyfcf25832014-12-18 17:42:32 -08002221static int cbb_add_hex(CBB *cbb, const uint8_t *in, size_t in_len) {
2222 static const char hextable[] = "0123456789abcdef";
2223 uint8_t *out;
Adam Langley95c29f32014-06-20 12:00:00 -07002224
Adam Langleyfcf25832014-12-18 17:42:32 -08002225 if (!CBB_add_space(cbb, &out, in_len * 2)) {
2226 return 0;
2227 }
Adam Langley95c29f32014-06-20 12:00:00 -07002228
David Benjamin54091232016-09-05 12:47:25 -04002229 for (size_t i = 0; i < in_len; i++) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002230 *(out++) = (uint8_t)hextable[in[i] >> 4];
2231 *(out++) = (uint8_t)hextable[in[i] & 0xf];
2232 }
Adam Langley95c29f32014-06-20 12:00:00 -07002233
Adam Langleyfcf25832014-12-18 17:42:32 -08002234 return 1;
2235}
David Benjamin859ec3c2014-09-02 16:29:36 -04002236
David Benjamine776cc22016-07-19 07:26:49 +02002237int ssl_log_secret(const SSL *ssl, const char *label, const uint8_t *secret,
2238 size_t secret_len) {
David Benjamind28f59c2015-11-17 22:32:50 -05002239 if (ssl->ctx->keylog_callback == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002240 return 1;
2241 }
Adam Langleyadb739e2014-06-20 12:00:00 -07002242
David Benjamind28f59c2015-11-17 22:32:50 -05002243 CBB cbb;
2244 uint8_t *out;
2245 size_t out_len;
David Benjamine776cc22016-07-19 07:26:49 +02002246 if (!CBB_init(&cbb, strlen(label) + 1 + SSL3_RANDOM_SIZE * 2 + 1 +
2247 secret_len * 2 + 1) ||
2248 !CBB_add_bytes(&cbb, (const uint8_t *)label, strlen(label)) ||
Adam Langleyfcf25832014-12-18 17:42:32 -08002249 !CBB_add_bytes(&cbb, (const uint8_t *)" ", 1) ||
David Benjamine776cc22016-07-19 07:26:49 +02002250 !cbb_add_hex(&cbb, ssl->s3->client_random, SSL3_RANDOM_SIZE) ||
2251 !CBB_add_bytes(&cbb, (const uint8_t *)" ", 1) ||
2252 !cbb_add_hex(&cbb, secret, secret_len) ||
David Benjamind28f59c2015-11-17 22:32:50 -05002253 !CBB_add_u8(&cbb, 0 /* NUL */) ||
Adam Langleyfcf25832014-12-18 17:42:32 -08002254 !CBB_finish(&cbb, &out, &out_len)) {
2255 CBB_cleanup(&cbb);
2256 return 0;
2257 }
Adam Langleyadb739e2014-06-20 12:00:00 -07002258
David Benjamind28f59c2015-11-17 22:32:50 -05002259 ssl->ctx->keylog_callback(ssl, (const char *)out);
Adam Langleyfcf25832014-12-18 17:42:32 -08002260 OPENSSL_free(out);
David Benjamind28f59c2015-11-17 22:32:50 -05002261 return 1;
Adam Langley95c29f32014-06-20 12:00:00 -07002262}
2263
David Benjamin5d8b1282015-10-17 23:26:35 -04002264int SSL_is_init_finished(const SSL *ssl) {
David Benjamin9e766d72017-02-10 23:14:17 -05002265 return !SSL_in_init(ssl);
David Benjamin5d8b1282015-10-17 23:26:35 -04002266}
2267
2268int SSL_in_init(const SSL *ssl) {
David Benjamin9e766d72017-02-10 23:14:17 -05002269 SSL_HANDSHAKE *hs = ssl->s3->hs;
2270 return hs != NULL && hs->state != SSL_ST_OK;
David Benjamin5d8b1282015-10-17 23:26:35 -04002271}
2272
2273int SSL_in_false_start(const SSL *ssl) {
David Benjamina0486782016-10-06 19:11:32 -04002274 if (ssl->s3->hs == NULL) {
2275 return 0;
2276 }
2277 return ssl->s3->hs->in_false_start;
David Benjamined7c4752015-02-16 19:16:46 -05002278}
2279
David Benjamin0d56f882015-12-19 17:05:56 -05002280int SSL_cutthrough_complete(const SSL *ssl) {
2281 return SSL_in_false_start(ssl);
Adam Langleyfcf25832014-12-18 17:42:32 -08002282}
Adam Langley95c29f32014-06-20 12:00:00 -07002283
Adam Langleyfcf25832014-12-18 17:42:32 -08002284void SSL_get_structure_sizes(size_t *ssl_size, size_t *ssl_ctx_size,
2285 size_t *ssl_session_size) {
2286 *ssl_size = sizeof(SSL);
2287 *ssl_ctx_size = sizeof(SSL_CTX);
2288 *ssl_session_size = sizeof(SSL_SESSION);
2289}
Feng Lu41aa3252014-11-21 22:47:56 -08002290
David Benjamin0d56f882015-12-19 17:05:56 -05002291int ssl3_can_false_start(const SSL *ssl) {
2292 const SSL_CIPHER *const cipher = SSL_get_current_cipher(ssl);
Adam Langleyfcf25832014-12-18 17:42:32 -08002293
Adam Langleye631d962015-04-01 13:11:01 -07002294 /* False Start only for TLS 1.2 with an ECDHE+AEAD cipher and ALPN or NPN. */
David Benjamince079fd2016-08-02 16:22:34 -04002295 return !SSL_is_dtls(ssl) &&
Steven Valdez4f94b1c2016-05-24 12:31:07 -04002296 SSL_version(ssl) == TLS1_2_VERSION &&
David Benjaminb74b0812016-10-06 19:43:48 -04002297 (ssl->s3->alpn_selected != NULL ||
2298 ssl->s3->next_proto_negotiated != NULL) &&
David Benjamin195dc782015-02-19 13:27:05 -05002299 cipher != NULL &&
Matthew Braithwaite651aaef2016-12-08 16:14:36 -08002300 cipher->algorithm_mkey == SSL_kECDHE &&
David Benjamin13414b32015-12-09 23:02:39 -05002301 cipher->algorithm_mac == SSL_AEAD;
Adam Langleyfcf25832014-12-18 17:42:32 -08002302}
2303
David Benjaminb6a0a512016-06-21 10:33:21 -04002304const struct {
2305 uint16_t version;
2306 uint32_t flag;
2307} kVersions[] = {
2308 {SSL3_VERSION, SSL_OP_NO_SSLv3},
2309 {TLS1_VERSION, SSL_OP_NO_TLSv1},
2310 {TLS1_1_VERSION, SSL_OP_NO_TLSv1_1},
2311 {TLS1_2_VERSION, SSL_OP_NO_TLSv1_2},
2312 {TLS1_3_VERSION, SSL_OP_NO_TLSv1_3},
2313};
Adam Langleyfcf25832014-12-18 17:42:32 -08002314
Steven Valdezcb966542016-08-17 16:56:14 -04002315static const size_t kVersionsLen = OPENSSL_ARRAY_SIZE(kVersions);
Adam Langleyfcf25832014-12-18 17:42:32 -08002316
David Benjamine0ff7672016-09-19 18:40:03 -04002317int ssl_get_version_range(const SSL *ssl, uint16_t *out_min_version,
2318 uint16_t *out_max_version) {
David Benjaminb6a0a512016-06-21 10:33:21 -04002319 /* For historical reasons, |SSL_OP_NO_DTLSv1| aliases |SSL_OP_NO_TLSv1|, but
2320 * DTLS 1.0 should be mapped to TLS 1.1. */
David Benjamin0d56f882015-12-19 17:05:56 -05002321 uint32_t options = ssl->options;
David Benjamince079fd2016-08-02 16:22:34 -04002322 if (SSL_is_dtls(ssl)) {
David Benjaminb6a0a512016-06-21 10:33:21 -04002323 options &= ~SSL_OP_NO_TLSv1_1;
2324 if (options & SSL_OP_NO_DTLSv1) {
2325 options |= SSL_OP_NO_TLSv1_1;
2326 }
2327 }
2328
2329 uint16_t min_version = ssl->min_version;
2330 uint16_t max_version = ssl->max_version;
2331
2332 /* Bound the range to only those implemented in this protocol. */
2333 if (min_version < ssl->method->min_version) {
2334 min_version = ssl->method->min_version;
2335 }
2336 if (max_version > ssl->method->max_version) {
2337 max_version = ssl->method->max_version;
2338 }
Adam Langleyfcf25832014-12-18 17:42:32 -08002339
2340 /* OpenSSL's API for controlling versions entails blacklisting individual
2341 * protocols. This has two problems. First, on the client, the protocol can
2342 * only express a contiguous range of versions. Second, a library consumer
2343 * trying to set a maximum version cannot disable protocol versions that get
2344 * added in a future version of the library.
2345 *
2346 * To account for both of these, OpenSSL interprets the client-side bitmask
2347 * as a min/max range by picking the lowest contiguous non-empty range of
2348 * enabled protocols. Note that this means it is impossible to set a maximum
David Benjaminb6a0a512016-06-21 10:33:21 -04002349 * version of the higest supported TLS version in a future-proof way. */
David Benjaminb6a0a512016-06-21 10:33:21 -04002350 int any_enabled = 0;
David Benjamin54091232016-09-05 12:47:25 -04002351 for (size_t i = 0; i < kVersionsLen; i++) {
David Benjaminb6a0a512016-06-21 10:33:21 -04002352 /* Only look at the versions already enabled. */
2353 if (min_version > kVersions[i].version) {
2354 continue;
Adam Langleyfcf25832014-12-18 17:42:32 -08002355 }
David Benjaminb6a0a512016-06-21 10:33:21 -04002356 if (max_version < kVersions[i].version) {
2357 break;
Adam Langleyfcf25832014-12-18 17:42:32 -08002358 }
David Benjaminb6a0a512016-06-21 10:33:21 -04002359
2360 if (!(options & kVersions[i].flag)) {
2361 /* The minimum version is the first enabled version. */
2362 if (!any_enabled) {
2363 any_enabled = 1;
2364 min_version = kVersions[i].version;
2365 }
2366 continue;
Adam Langleyfcf25832014-12-18 17:42:32 -08002367 }
David Benjaminb6a0a512016-06-21 10:33:21 -04002368
2369 /* If there is a disabled version after the first enabled one, all versions
2370 * after it are implicitly disabled. */
2371 if (any_enabled) {
2372 max_version = kVersions[i-1].version;
2373 break;
Adam Langleyfcf25832014-12-18 17:42:32 -08002374 }
2375 }
2376
David Benjamine0ff7672016-09-19 18:40:03 -04002377 if (!any_enabled) {
David Benjaminb6a0a512016-06-21 10:33:21 -04002378 OPENSSL_PUT_ERROR(SSL, SSL_R_WRONG_SSL_VERSION);
2379 return 0;
David Benjaminea72bd02014-12-21 21:27:41 -05002380 }
2381
David Benjaminb6a0a512016-06-21 10:33:21 -04002382 *out_min_version = min_version;
2383 *out_max_version = max_version;
2384 return 1;
David Benjaminea72bd02014-12-21 21:27:41 -05002385}
2386
David Benjaminb9e4fa52015-12-29 23:58:17 -05002387uint16_t ssl3_protocol_version(const SSL *ssl) {
2388 assert(ssl->s3->have_version);
David Benjamin2dc02042016-09-19 19:57:37 -04002389 uint16_t version;
2390 if (!ssl->method->version_from_wire(&version, ssl->version)) {
2391 /* TODO(davidben): Use the internal version representation for ssl->version
2392 * and map to the public API representation at API boundaries. */
2393 assert(0);
2394 return 0;
2395 }
2396
2397 return version;
David Benjaminb9e4fa52015-12-29 23:58:17 -05002398}
2399
David Benjamince079fd2016-08-02 16:22:34 -04002400int SSL_is_server(const SSL *ssl) { return ssl->server; }
2401
2402int SSL_is_dtls(const SSL *ssl) { return ssl->method->is_dtls; }
Adam Langleyfcf25832014-12-18 17:42:32 -08002403
Alessandro Ghedini57e81e62017-03-14 23:36:00 +00002404void SSL_CTX_set_select_certificate_cb(
2405 SSL_CTX *ctx,
2406 enum ssl_select_cert_result_t (*cb)(const SSL_CLIENT_HELLO *)) {
David Benjamind4c2bce2015-10-17 12:28:18 -04002407 ctx->select_certificate_cb = cb;
2408}
2409
David Benjamin731058e2016-12-03 23:15:13 -05002410void SSL_CTX_set_dos_protection_cb(SSL_CTX *ctx,
2411 int (*cb)(const SSL_CLIENT_HELLO *)) {
Adam Langley524e7172015-02-20 16:04:00 -08002412 ctx->dos_protection_cb = cb;
2413}
2414
David Benjamin1d5ef3b2015-10-12 19:54:18 -04002415void SSL_set_renegotiate_mode(SSL *ssl, enum ssl_renegotiate_mode_t mode) {
2416 ssl->renegotiate_mode = mode;
2417}
2418
Adam Langleyc2d32802015-11-03 18:36:10 -08002419int SSL_get_ivs(const SSL *ssl, const uint8_t **out_read_iv,
2420 const uint8_t **out_write_iv, size_t *out_iv_len) {
David Benjamin79978df2015-12-25 15:56:49 -05002421 if (ssl->s3->aead_read_ctx == NULL || ssl->s3->aead_write_ctx == NULL) {
Adam Langleyc2d32802015-11-03 18:36:10 -08002422 return 0;
2423 }
2424
2425 size_t write_iv_len;
David Benjamin79978df2015-12-25 15:56:49 -05002426 if (!EVP_AEAD_CTX_get_iv(&ssl->s3->aead_read_ctx->ctx, out_read_iv,
2427 out_iv_len) ||
2428 !EVP_AEAD_CTX_get_iv(&ssl->s3->aead_write_ctx->ctx, out_write_iv,
Adam Langleyc2d32802015-11-03 18:36:10 -08002429 &write_iv_len) ||
2430 *out_iv_len != write_iv_len) {
2431 return 0;
2432 }
2433
2434 return 1;
David Benjamine348ff42015-11-06 17:55:30 -05002435}
David Benjamin6e807652015-11-02 12:02:20 -05002436
David Benjamin91b25012016-01-21 16:39:58 -05002437static uint64_t be_to_u64(const uint8_t in[8]) {
David Benjaminde942382016-02-11 12:02:01 -05002438 return (((uint64_t)in[0]) << 56) | (((uint64_t)in[1]) << 48) |
2439 (((uint64_t)in[2]) << 40) | (((uint64_t)in[3]) << 32) |
2440 (((uint64_t)in[4]) << 24) | (((uint64_t)in[5]) << 16) |
2441 (((uint64_t)in[6]) << 8) | ((uint64_t)in[7]);
David Benjamin91b25012016-01-21 16:39:58 -05002442}
2443
2444uint64_t SSL_get_read_sequence(const SSL *ssl) {
2445 /* TODO(davidben): Internally represent sequence numbers as uint64_t. */
David Benjamince079fd2016-08-02 16:22:34 -04002446 if (SSL_is_dtls(ssl)) {
David Benjaminde942382016-02-11 12:02:01 -05002447 /* max_seq_num already includes the epoch. */
2448 assert(ssl->d1->r_epoch == (ssl->d1->bitmap.max_seq_num >> 48));
2449 return ssl->d1->bitmap.max_seq_num;
2450 }
David Benjamin91b25012016-01-21 16:39:58 -05002451 return be_to_u64(ssl->s3->read_sequence);
2452}
2453
2454uint64_t SSL_get_write_sequence(const SSL *ssl) {
David Benjaminde942382016-02-11 12:02:01 -05002455 uint64_t ret = be_to_u64(ssl->s3->write_sequence);
David Benjamince079fd2016-08-02 16:22:34 -04002456 if (SSL_is_dtls(ssl)) {
David Benjaminde942382016-02-11 12:02:01 -05002457 assert((ret >> 48) == 0);
2458 ret |= ((uint64_t)ssl->d1->w_epoch) << 48;
2459 }
2460 return ret;
David Benjamin91b25012016-01-21 16:39:58 -05002461}
2462
Steven Valdez02563852016-06-23 13:33:05 -04002463uint16_t SSL_get_peer_signature_algorithm(const SSL *ssl) {
David Benjaminf1050fd2016-12-13 20:05:36 -05002464 /* TODO(davidben): This checks the wrong session if there is a renegotiation
2465 * in progress. */
2466 SSL_SESSION *session = SSL_get_session(ssl);
2467 if (session == NULL) {
2468 return 0;
2469 }
2470
2471 return session->peer_signature_algorithm;
Steven Valdez02563852016-06-23 13:33:05 -04002472}
2473
David Benjamin96ba15f2015-12-25 14:10:17 -05002474size_t SSL_get_client_random(const SSL *ssl, uint8_t *out, size_t max_out) {
2475 if (max_out == 0) {
2476 return sizeof(ssl->s3->client_random);
2477 }
2478 if (max_out > sizeof(ssl->s3->client_random)) {
2479 max_out = sizeof(ssl->s3->client_random);
2480 }
David Benjamin17cf2cb2016-12-13 01:07:13 -05002481 OPENSSL_memcpy(out, ssl->s3->client_random, max_out);
David Benjamin96ba15f2015-12-25 14:10:17 -05002482 return max_out;
2483}
2484
2485size_t SSL_get_server_random(const SSL *ssl, uint8_t *out, size_t max_out) {
2486 if (max_out == 0) {
2487 return sizeof(ssl->s3->server_random);
2488 }
2489 if (max_out > sizeof(ssl->s3->server_random)) {
2490 max_out = sizeof(ssl->s3->server_random);
2491 }
David Benjamin17cf2cb2016-12-13 01:07:13 -05002492 OPENSSL_memcpy(out, ssl->s3->server_random, max_out);
David Benjamin96ba15f2015-12-25 14:10:17 -05002493 return max_out;
2494}
2495
David Benjaminf6494f42016-01-07 12:37:41 -08002496const SSL_CIPHER *SSL_get_pending_cipher(const SSL *ssl) {
David Benjamin45738dd2017-02-09 20:01:26 -05002497 SSL_HANDSHAKE *hs = ssl->s3->hs;
2498 if (hs == NULL) {
David Benjaminf6494f42016-01-07 12:37:41 -08002499 return NULL;
2500 }
David Benjamin45738dd2017-02-09 20:01:26 -05002501 return hs->new_cipher;
David Benjaminf6494f42016-01-07 12:37:41 -08002502}
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 Benjamin35ac5b72017-03-03 15:05:56 -05002516int32_t SSL_get_ticket_age_skew(const SSL *ssl) {
2517 return ssl->s3->ticket_age_skew;
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
David Benjaminad8f5e12017-02-20 17:00:20 -05002650void ssl_get_current_time(const SSL *ssl, struct OPENSSL_timeval *out_clock) {
David Benjamin721e8b72016-08-03 13:13:17 -04002651 if (ssl->ctx->current_time_cb != NULL) {
David Benjaminad8f5e12017-02-20 17:00:20 -05002652 /* TODO(davidben): Update current_time_cb to use OPENSSL_timeval. See
2653 * https://crbug.com/boringssl/155. */
2654 struct timeval clock;
2655 ssl->ctx->current_time_cb(ssl, &clock);
2656 if (clock.tv_sec < 0) {
2657 assert(0);
2658 out_clock->tv_sec = 0;
2659 out_clock->tv_usec = 0;
2660 } else {
2661 out_clock->tv_sec = (uint64_t)clock.tv_sec;
2662 out_clock->tv_usec = (uint32_t)clock.tv_usec;
2663 }
David Benjamin721e8b72016-08-03 13:13:17 -04002664 return;
2665 }
2666
David Benjaminec978dd2016-11-04 18:59:33 -04002667#if defined(BORINGSSL_UNSAFE_DETERMINISTIC_MODE)
David Benjamin01a90572016-09-22 00:11:43 -04002668 out_clock->tv_sec = 1234;
2669 out_clock->tv_usec = 1234;
2670#elif defined(OPENSSL_WINDOWS)
David Benjamin721e8b72016-08-03 13:13:17 -04002671 struct _timeb time;
2672 _ftime(&time);
David Benjaminad8f5e12017-02-20 17:00:20 -05002673 if (time.time < 0) {
2674 assert(0);
2675 out_clock->tv_sec = 0;
2676 out_clock->tv_usec = 0;
2677 } else {
2678 out_clock->tv_sec = time.time;
2679 out_clock->tv_usec = time.millitm * 1000;
2680 }
David Benjamin721e8b72016-08-03 13:13:17 -04002681#else
David Benjaminad8f5e12017-02-20 17:00:20 -05002682 struct timeval clock;
2683 gettimeofday(&clock, NULL);
2684 if (clock.tv_sec < 0) {
2685 assert(0);
2686 out_clock->tv_sec = 0;
2687 out_clock->tv_usec = 0;
2688 } else {
2689 out_clock->tv_sec = (uint64_t)clock.tv_sec;
2690 out_clock->tv_usec = (uint32_t)clock.tv_usec;
2691 }
David Benjamin721e8b72016-08-03 13:13:17 -04002692#endif
2693}
David Benjamine4706902016-09-20 15:12:23 -04002694
2695int SSL_CTX_set_min_version(SSL_CTX *ctx, uint16_t version) {
2696 return SSL_CTX_set_min_proto_version(ctx, version);
2697}
2698
2699int SSL_CTX_set_max_version(SSL_CTX *ctx, uint16_t version) {
2700 return SSL_CTX_set_max_proto_version(ctx, version);
2701}
2702
2703int SSL_set_min_version(SSL *ssl, uint16_t version) {
2704 return SSL_set_min_proto_version(ssl, version);
2705}
2706
2707int SSL_set_max_version(SSL *ssl, uint16_t version) {
2708 return SSL_set_max_proto_version(ssl, version);
2709}
Adam Langley4c341d02017-03-08 19:33:21 -08002710
2711void SSL_CTX_set_ticket_aead_method(SSL_CTX *ctx,
2712 const SSL_TICKET_AEAD_METHOD *aead_method) {
2713 ctx->ticket_aead_method = aead_method;
2714}