blob: d16c952f11d28e233f8f56e7fec546f22f71a38f [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
David Benjamin287fc4f2016-12-10 15:12:03 -0500824static int bio_retry_reason_to_error(int reason) {
825 switch (reason) {
826 case BIO_RR_CONNECT:
827 return SSL_ERROR_WANT_CONNECT;
828 case BIO_RR_ACCEPT:
829 return SSL_ERROR_WANT_ACCEPT;
830 default:
831 return SSL_ERROR_SYSCALL;
832 }
833}
David Benjamin27bbae42015-09-13 00:54:37 -0400834
David Benjamin287fc4f2016-12-10 15:12:03 -0500835int SSL_get_error(const SSL *ssl, int ret_code) {
David Benjamin27bbae42015-09-13 00:54:37 -0400836 if (ret_code > 0) {
837 return SSL_ERROR_NONE;
838 }
839
840 /* Make things return SSL_ERROR_SYSCALL when doing SSL_do_handshake etc,
841 * where we do encode the error */
David Benjamin287fc4f2016-12-10 15:12:03 -0500842 uint32_t err = ERR_peek_error();
David Benjamin27bbae42015-09-13 00:54:37 -0400843 if (err != 0) {
844 if (ERR_GET_LIB(err) == ERR_LIB_SYS) {
845 return SSL_ERROR_SYSCALL;
846 }
847 return SSL_ERROR_SSL;
848 }
849
850 if (ret_code == 0) {
David Benjaminfa214e42016-05-10 17:03:10 -0400851 if (ssl->s3->recv_shutdown == ssl_shutdown_close_notify) {
David Benjamin27bbae42015-09-13 00:54:37 -0400852 return SSL_ERROR_ZERO_RETURN;
853 }
854 /* An EOF was observed which violates the protocol, and the underlying
855 * transport does not participate in the error queue. Bubble up to the
856 * caller. */
857 return SSL_ERROR_SYSCALL;
858 }
859
David Benjamin287fc4f2016-12-10 15:12:03 -0500860 switch (ssl->rwstate) {
861 case SSL_PENDING_SESSION:
862 return SSL_ERROR_PENDING_SESSION;
David Benjamin27bbae42015-09-13 00:54:37 -0400863
David Benjamin287fc4f2016-12-10 15:12:03 -0500864 case SSL_CERTIFICATE_SELECTION_PENDING:
865 return SSL_ERROR_PENDING_CERTIFICATE;
David Benjamin27bbae42015-09-13 00:54:37 -0400866
David Benjamin287fc4f2016-12-10 15:12:03 -0500867 case SSL_READING: {
868 BIO *bio = SSL_get_rbio(ssl);
869 if (BIO_should_read(bio)) {
870 return SSL_ERROR_WANT_READ;
David Benjamin27bbae42015-09-13 00:54:37 -0400871 }
872
David Benjamin287fc4f2016-12-10 15:12:03 -0500873 if (BIO_should_write(bio)) {
874 /* TODO(davidben): OpenSSL historically checked for writes on the read
875 * BIO. Can this be removed? */
876 return SSL_ERROR_WANT_WRITE;
David Benjamin27bbae42015-09-13 00:54:37 -0400877 }
878
David Benjamin287fc4f2016-12-10 15:12:03 -0500879 if (BIO_should_io_special(bio)) {
880 return bio_retry_reason_to_error(BIO_get_retry_reason(bio));
David Benjamin27bbae42015-09-13 00:54:37 -0400881 }
882
David Benjamin287fc4f2016-12-10 15:12:03 -0500883 break;
884 }
885
886 case SSL_WRITING: {
887 BIO *bio = SSL_get_wbio(ssl);
888 if (BIO_should_write(bio)) {
889 return SSL_ERROR_WANT_WRITE;
David Benjamin27bbae42015-09-13 00:54:37 -0400890 }
891
David Benjamin287fc4f2016-12-10 15:12:03 -0500892 if (BIO_should_read(bio)) {
893 /* TODO(davidben): OpenSSL historically checked for reads on the write
894 * BIO. Can this be removed? */
895 return SSL_ERROR_WANT_READ;
896 }
897
898 if (BIO_should_io_special(bio)) {
899 return bio_retry_reason_to_error(BIO_get_retry_reason(bio));
900 }
901
902 break;
David Benjamin27bbae42015-09-13 00:54:37 -0400903 }
David Benjamin27bbae42015-09-13 00:54:37 -0400904
David Benjamin287fc4f2016-12-10 15:12:03 -0500905 case SSL_X509_LOOKUP:
906 return SSL_ERROR_WANT_X509_LOOKUP;
David Benjamin27bbae42015-09-13 00:54:37 -0400907
David Benjamin287fc4f2016-12-10 15:12:03 -0500908 case SSL_CHANNEL_ID_LOOKUP:
909 return SSL_ERROR_WANT_CHANNEL_ID_LOOKUP;
David Benjamin27bbae42015-09-13 00:54:37 -0400910
David Benjamin287fc4f2016-12-10 15:12:03 -0500911 case SSL_PRIVATE_KEY_OPERATION:
912 return SSL_ERROR_WANT_PRIVATE_KEY_OPERATION;
Adam Langley4c341d02017-03-08 19:33:21 -0800913
914 case SSL_PENDING_TICKET:
915 return SSL_ERROR_PENDING_TICKET;
David Benjamin27bbae42015-09-13 00:54:37 -0400916 }
917
918 return SSL_ERROR_SYSCALL;
919}
920
David Benjamine34bcc92016-09-21 16:53:09 -0400921static int set_min_version(const SSL_PROTOCOL_METHOD *method, uint16_t *out,
922 uint16_t version) {
923 if (version == 0) {
924 *out = method->min_version;
925 return 1;
926 }
927
Steven Valdezfdd10992016-09-15 16:27:05 -0400928 if (version == TLS1_3_VERSION) {
929 version = TLS1_3_DRAFT_VERSION;
930 }
931
David Benjamine34bcc92016-09-21 16:53:09 -0400932 return method->version_from_wire(out, version);
933}
934
935static int set_max_version(const SSL_PROTOCOL_METHOD *method, uint16_t *out,
936 uint16_t version) {
937 if (version == 0) {
938 *out = method->max_version;
939 /* TODO(svaldez): Enable TLS 1.3 by default once fully implemented. */
940 if (*out > TLS1_2_VERSION) {
941 *out = TLS1_2_VERSION;
942 }
943 return 1;
944 }
945
Steven Valdezfdd10992016-09-15 16:27:05 -0400946 if (version == TLS1_3_VERSION) {
947 version = TLS1_3_DRAFT_VERSION;
948 }
949
David Benjamine34bcc92016-09-21 16:53:09 -0400950 return method->version_from_wire(out, version);
951}
952
David Benjamine4706902016-09-20 15:12:23 -0400953int SSL_CTX_set_min_proto_version(SSL_CTX *ctx, uint16_t version) {
David Benjamine34bcc92016-09-21 16:53:09 -0400954 return set_min_version(ctx->method, &ctx->min_version, version);
David Benjamin27bbae42015-09-13 00:54:37 -0400955}
956
David Benjamine4706902016-09-20 15:12:23 -0400957int SSL_CTX_set_max_proto_version(SSL_CTX *ctx, uint16_t version) {
David Benjamine34bcc92016-09-21 16:53:09 -0400958 return set_max_version(ctx->method, &ctx->max_version, version);
David Benjamin27bbae42015-09-13 00:54:37 -0400959}
960
David Benjamine4706902016-09-20 15:12:23 -0400961int SSL_set_min_proto_version(SSL *ssl, uint16_t version) {
David Benjamine34bcc92016-09-21 16:53:09 -0400962 return set_min_version(ssl->method, &ssl->min_version, version);
David Benjamin27bbae42015-09-13 00:54:37 -0400963}
964
David Benjamine4706902016-09-20 15:12:23 -0400965int SSL_set_max_proto_version(SSL *ssl, uint16_t version) {
David Benjamine34bcc92016-09-21 16:53:09 -0400966 return set_max_version(ssl->method, &ssl->max_version, version);
David Benjamin27bbae42015-09-13 00:54:37 -0400967}
968
969uint32_t SSL_CTX_set_options(SSL_CTX *ctx, uint32_t options) {
970 ctx->options |= options;
971 return ctx->options;
972}
973
974uint32_t SSL_CTX_clear_options(SSL_CTX *ctx, uint32_t options) {
975 ctx->options &= ~options;
976 return ctx->options;
977}
978
979uint32_t SSL_CTX_get_options(const SSL_CTX *ctx) { return ctx->options; }
980
981uint32_t SSL_set_options(SSL *ssl, uint32_t options) {
982 ssl->options |= options;
983 return ssl->options;
984}
985
986uint32_t SSL_clear_options(SSL *ssl, uint32_t options) {
987 ssl->options &= ~options;
988 return ssl->options;
989}
990
991uint32_t SSL_get_options(const SSL *ssl) { return ssl->options; }
992
993uint32_t SSL_CTX_set_mode(SSL_CTX *ctx, uint32_t mode) {
994 ctx->mode |= mode;
995 return ctx->mode;
996}
997
998uint32_t SSL_CTX_clear_mode(SSL_CTX *ctx, uint32_t mode) {
999 ctx->mode &= ~mode;
1000 return ctx->mode;
1001}
1002
1003uint32_t SSL_CTX_get_mode(const SSL_CTX *ctx) { return ctx->mode; }
1004
1005uint32_t SSL_set_mode(SSL *ssl, uint32_t mode) {
1006 ssl->mode |= mode;
1007 return ssl->mode;
1008}
1009
1010uint32_t SSL_clear_mode(SSL *ssl, uint32_t mode) {
1011 ssl->mode &= ~mode;
1012 return ssl->mode;
1013}
1014
1015uint32_t SSL_get_mode(const SSL *ssl) { return ssl->mode; }
1016
Adam Langleyd519bf62016-12-12 11:16:44 -08001017void SSL_CTX_set0_buffer_pool(SSL_CTX *ctx, CRYPTO_BUFFER_POOL *pool) {
1018 ctx->pool = pool;
1019}
1020
David Benjaminee0c8272015-09-13 01:03:54 -04001021int SSL_get_tls_unique(const SSL *ssl, uint8_t *out, size_t *out_len,
1022 size_t max_out) {
David Benjaminced00b42016-10-08 11:24:09 -04001023 /* tls-unique is not defined for SSL 3.0 or TLS 1.3. */
1024 if (!ssl->s3->initial_handshake_complete ||
1025 ssl3_protocol_version(ssl) < TLS1_VERSION ||
1026 ssl3_protocol_version(ssl) >= TLS1_3_VERSION) {
1027 goto err;
1028 }
1029
David Benjaminee0c8272015-09-13 01:03:54 -04001030 /* The tls-unique value is the first Finished message in the handshake, which
1031 * is the client's in a full handshake and the server's for a resumption. See
1032 * https://tools.ietf.org/html/rfc5929#section-3.1. */
1033 const uint8_t *finished = ssl->s3->previous_client_finished;
1034 size_t finished_len = ssl->s3->previous_client_finished_len;
Steven Valdez87eab492016-06-27 16:34:59 -04001035 if (ssl->session != NULL) {
David Benjaminee0c8272015-09-13 01:03:54 -04001036 /* tls-unique is broken for resumed sessions unless EMS is used. */
1037 if (!ssl->session->extended_master_secret) {
1038 goto err;
1039 }
1040 finished = ssl->s3->previous_server_finished;
1041 finished_len = ssl->s3->previous_server_finished_len;
1042 }
1043
David Benjaminee0c8272015-09-13 01:03:54 -04001044 *out_len = finished_len;
1045 if (finished_len > max_out) {
1046 *out_len = max_out;
1047 }
1048
David Benjamin17cf2cb2016-12-13 01:07:13 -05001049 OPENSSL_memcpy(out, finished, *out_len);
David Benjaminee0c8272015-09-13 01:03:54 -04001050 return 1;
1051
1052err:
1053 *out_len = 0;
David Benjamin17cf2cb2016-12-13 01:07:13 -05001054 OPENSSL_memset(out, 0, max_out);
David Benjaminee0c8272015-09-13 01:03:54 -04001055 return 0;
1056}
1057
David Benjamin5960a902017-02-14 20:07:11 -05001058static int set_session_id_context(CERT *cert, const uint8_t *sid_ctx,
David Benjamin30c4c302016-12-07 22:35:24 -05001059 size_t sid_ctx_len) {
David Benjamin5960a902017-02-14 20:07:11 -05001060 if (sid_ctx_len > sizeof(cert->sid_ctx)) {
David Benjamin3570d732015-06-29 00:28:17 -04001061 OPENSSL_PUT_ERROR(SSL, SSL_R_SSL_SESSION_ID_CONTEXT_TOO_LONG);
Adam Langleyfcf25832014-12-18 17:42:32 -08001062 return 0;
1063 }
David Benjamin30c4c302016-12-07 22:35:24 -05001064
David Benjamin5960a902017-02-14 20:07:11 -05001065 OPENSSL_COMPILE_ASSERT(sizeof(cert->sid_ctx) < 256, sid_ctx_too_large);
1066 cert->sid_ctx_length = (uint8_t)sid_ctx_len;
1067 OPENSSL_memcpy(cert->sid_ctx, sid_ctx, sid_ctx_len);
Adam Langleyfcf25832014-12-18 17:42:32 -08001068 return 1;
1069}
Adam Langley95c29f32014-06-20 12:00:00 -07001070
David Benjamin5960a902017-02-14 20:07:11 -05001071int SSL_CTX_set_session_id_context(SSL_CTX *ctx, const uint8_t *sid_ctx,
1072 size_t sid_ctx_len) {
1073 return set_session_id_context(ctx->cert, sid_ctx, sid_ctx_len);
1074}
1075
Adam Langleyfcf25832014-12-18 17:42:32 -08001076int SSL_set_session_id_context(SSL *ssl, const uint8_t *sid_ctx,
David Benjamin30c4c302016-12-07 22:35:24 -05001077 size_t sid_ctx_len) {
David Benjamin5960a902017-02-14 20:07:11 -05001078 return set_session_id_context(ssl->cert, sid_ctx, sid_ctx_len);
Adam Langleyfcf25832014-12-18 17:42:32 -08001079}
Adam Langley95c29f32014-06-20 12:00:00 -07001080
David Benjamin07820b52016-12-07 21:13:41 -05001081const uint8_t *SSL_get0_session_id_context(const SSL *ssl, size_t *out_len) {
David Benjamin5960a902017-02-14 20:07:11 -05001082 *out_len = ssl->cert->sid_ctx_length;
1083 return ssl->cert->sid_ctx;
David Benjamin07820b52016-12-07 21:13:41 -05001084}
1085
Adam Langley858a88d2014-06-20 12:00:00 -07001086void ssl_cipher_preference_list_free(
Adam Langleyfcf25832014-12-18 17:42:32 -08001087 struct ssl_cipher_preference_list_st *cipher_list) {
David Benjamin5d1ec732015-04-22 13:38:00 -04001088 if (cipher_list == NULL) {
1089 return;
1090 }
Adam Langleyfcf25832014-12-18 17:42:32 -08001091 sk_SSL_CIPHER_free(cipher_list->ciphers);
1092 OPENSSL_free(cipher_list->in_group_flags);
1093 OPENSSL_free(cipher_list);
1094}
Adam Langley858a88d2014-06-20 12:00:00 -07001095
David Benjamin7481d392015-07-05 19:38:46 -04001096void SSL_certs_clear(SSL *ssl) { ssl_cert_clear_certs(ssl->cert); }
Adam Langley95c29f32014-06-20 12:00:00 -07001097
David Benjamin066fe0a2015-10-17 21:11:33 -04001098int SSL_get_fd(const SSL *ssl) { return SSL_get_rfd(ssl); }
Adam Langley95c29f32014-06-20 12:00:00 -07001099
David Benjamin066fe0a2015-10-17 21:11:33 -04001100int SSL_get_rfd(const SSL *ssl) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001101 int ret = -1;
David Benjamin066fe0a2015-10-17 21:11:33 -04001102 BIO *b = BIO_find_type(SSL_get_rbio(ssl), BIO_TYPE_DESCRIPTOR);
1103 if (b != NULL) {
1104 BIO_get_fd(b, &ret);
Adam Langleyfcf25832014-12-18 17:42:32 -08001105 }
1106 return ret;
1107}
Adam Langley95c29f32014-06-20 12:00:00 -07001108
David Benjamin066fe0a2015-10-17 21:11:33 -04001109int SSL_get_wfd(const SSL *ssl) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001110 int ret = -1;
David Benjamin066fe0a2015-10-17 21:11:33 -04001111 BIO *b = BIO_find_type(SSL_get_wbio(ssl), BIO_TYPE_DESCRIPTOR);
1112 if (b != NULL) {
1113 BIO_get_fd(b, &ret);
Adam Langleyfcf25832014-12-18 17:42:32 -08001114 }
Adam Langleyfcf25832014-12-18 17:42:32 -08001115 return ret;
1116}
Adam Langley95c29f32014-06-20 12:00:00 -07001117
David Benjamin066fe0a2015-10-17 21:11:33 -04001118int SSL_set_fd(SSL *ssl, int fd) {
David Benjamin22ce9b22016-03-06 19:26:52 -05001119 BIO *bio = BIO_new(BIO_s_socket());
Adam Langleyfcf25832014-12-18 17:42:32 -08001120 if (bio == NULL) {
David Benjamin3570d732015-06-29 00:28:17 -04001121 OPENSSL_PUT_ERROR(SSL, ERR_R_BUF_LIB);
David Benjamin066fe0a2015-10-17 21:11:33 -04001122 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001123 }
1124 BIO_set_fd(bio, fd, BIO_NOCLOSE);
David Benjamin066fe0a2015-10-17 21:11:33 -04001125 SSL_set_bio(ssl, bio, bio);
1126 return 1;
Adam Langleyfcf25832014-12-18 17:42:32 -08001127}
Adam Langley95c29f32014-06-20 12:00:00 -07001128
David Benjamin066fe0a2015-10-17 21:11:33 -04001129int SSL_set_wfd(SSL *ssl, int fd) {
David Benjamin2f871122016-05-20 14:27:17 -04001130 BIO *rbio = SSL_get_rbio(ssl);
1131 if (rbio == NULL || BIO_method_type(rbio) != BIO_TYPE_SOCKET ||
1132 BIO_get_fd(rbio, NULL) != fd) {
David Benjamin22ce9b22016-03-06 19:26:52 -05001133 BIO *bio = BIO_new(BIO_s_socket());
Adam Langleyfcf25832014-12-18 17:42:32 -08001134 if (bio == NULL) {
David Benjamin3570d732015-06-29 00:28:17 -04001135 OPENSSL_PUT_ERROR(SSL, ERR_R_BUF_LIB);
David Benjamin066fe0a2015-10-17 21:11:33 -04001136 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001137 }
1138 BIO_set_fd(bio, fd, BIO_NOCLOSE);
David Benjamin4501bd52016-08-01 13:39:41 -04001139 SSL_set0_wbio(ssl, bio);
Adam Langleyfcf25832014-12-18 17:42:32 -08001140 } else {
David Benjamin4501bd52016-08-01 13:39:41 -04001141 /* Copy the rbio over to the wbio. */
1142 BIO_up_ref(rbio);
1143 SSL_set0_wbio(ssl, rbio);
Adam Langleyfcf25832014-12-18 17:42:32 -08001144 }
1145
David Benjamin066fe0a2015-10-17 21:11:33 -04001146 return 1;
Adam Langleyfcf25832014-12-18 17:42:32 -08001147}
Adam Langley95c29f32014-06-20 12:00:00 -07001148
David Benjamin066fe0a2015-10-17 21:11:33 -04001149int SSL_set_rfd(SSL *ssl, int fd) {
David Benjamin2f871122016-05-20 14:27:17 -04001150 BIO *wbio = SSL_get_wbio(ssl);
1151 if (wbio == NULL || BIO_method_type(wbio) != BIO_TYPE_SOCKET ||
1152 BIO_get_fd(wbio, NULL) != fd) {
David Benjamin22ce9b22016-03-06 19:26:52 -05001153 BIO *bio = BIO_new(BIO_s_socket());
Adam Langleyfcf25832014-12-18 17:42:32 -08001154 if (bio == NULL) {
David Benjamin3570d732015-06-29 00:28:17 -04001155 OPENSSL_PUT_ERROR(SSL, ERR_R_BUF_LIB);
David Benjamin066fe0a2015-10-17 21:11:33 -04001156 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001157 }
1158 BIO_set_fd(bio, fd, BIO_NOCLOSE);
David Benjamin4501bd52016-08-01 13:39:41 -04001159 SSL_set0_rbio(ssl, bio);
Adam Langleyfcf25832014-12-18 17:42:32 -08001160 } else {
David Benjamin4501bd52016-08-01 13:39:41 -04001161 /* Copy the wbio over to the rbio. */
1162 BIO_up_ref(wbio);
1163 SSL_set0_rbio(ssl, wbio);
Adam Langleyfcf25832014-12-18 17:42:32 -08001164 }
David Benjamin066fe0a2015-10-17 21:11:33 -04001165 return 1;
Adam Langleyfcf25832014-12-18 17:42:32 -08001166}
Adam Langley95c29f32014-06-20 12:00:00 -07001167
David Benjamin49ddf412016-10-08 11:56:01 -04001168static size_t copy_finished(void *out, size_t out_len, const uint8_t *in,
1169 size_t in_len) {
1170 if (out_len > in_len) {
1171 out_len = in_len;
1172 }
David Benjamin17cf2cb2016-12-13 01:07:13 -05001173 OPENSSL_memcpy(out, in, out_len);
David Benjamin49ddf412016-10-08 11:56:01 -04001174 return in_len;
1175}
1176
David Benjamin1a1b34d2015-10-17 12:51:52 -04001177size_t SSL_get_finished(const SSL *ssl, void *buf, size_t count) {
David Benjaminced00b42016-10-08 11:24:09 -04001178 if (!ssl->s3->initial_handshake_complete ||
1179 ssl3_protocol_version(ssl) < TLS1_VERSION ||
1180 ssl3_protocol_version(ssl) >= TLS1_3_VERSION) {
1181 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001182 }
1183
David Benjamin49ddf412016-10-08 11:56:01 -04001184 if (ssl->server) {
1185 return copy_finished(buf, count, ssl->s3->previous_server_finished,
1186 ssl->s3->previous_server_finished_len);
David Benjaminced00b42016-10-08 11:24:09 -04001187 }
David Benjamin49ddf412016-10-08 11:56:01 -04001188
1189 return copy_finished(buf, count, ssl->s3->previous_client_finished,
1190 ssl->s3->previous_client_finished_len);
Adam Langleyfcf25832014-12-18 17:42:32 -08001191}
Adam Langley95c29f32014-06-20 12:00:00 -07001192
David Benjamin1a1b34d2015-10-17 12:51:52 -04001193size_t SSL_get_peer_finished(const SSL *ssl, void *buf, size_t count) {
David Benjaminced00b42016-10-08 11:24:09 -04001194 if (!ssl->s3->initial_handshake_complete ||
1195 ssl3_protocol_version(ssl) < TLS1_VERSION ||
1196 ssl3_protocol_version(ssl) >= TLS1_3_VERSION) {
1197 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001198 }
Adam Langley95c29f32014-06-20 12:00:00 -07001199
David Benjamin49ddf412016-10-08 11:56:01 -04001200 if (ssl->server) {
1201 return copy_finished(buf, count, ssl->s3->previous_client_finished,
1202 ssl->s3->previous_client_finished_len);
David Benjaminced00b42016-10-08 11:24:09 -04001203 }
David Benjamin49ddf412016-10-08 11:56:01 -04001204
1205 return copy_finished(buf, count, ssl->s3->previous_server_finished,
1206 ssl->s3->previous_server_finished_len);
Adam Langleyfcf25832014-12-18 17:42:32 -08001207}
Adam Langley95c29f32014-06-20 12:00:00 -07001208
David Benjamin59937042015-09-19 13:04:22 -04001209int SSL_get_verify_mode(const SSL *ssl) { return ssl->verify_mode; }
Adam Langley95c29f32014-06-20 12:00:00 -07001210
David Benjamin42fea372015-09-19 01:22:44 -04001211int SSL_get_extms_support(const SSL *ssl) {
David Benjaminfc02b592017-02-17 16:26:01 -05001212 /* TLS 1.3 does not require extended master secret and always reports as
1213 * supporting it. */
David Benjamina68c1182016-07-24 00:14:33 -04001214 if (!ssl->s3->have_version) {
1215 return 0;
1216 }
David Benjaminfc02b592017-02-17 16:26:01 -05001217 if (ssl3_protocol_version(ssl) >= TLS1_3_VERSION) {
1218 return 1;
1219 }
1220
1221 /* If the initial handshake completed, query the established session. */
1222 if (ssl->s3->established_session != NULL) {
1223 return ssl->s3->established_session->extended_master_secret;
1224 }
1225
1226 /* Otherwise, query the in-progress handshake. */
1227 if (ssl->s3->hs != NULL) {
1228 return ssl->s3->hs->extended_master_secret;
1229 }
1230 assert(0);
1231 return 0;
Matt Braithwaitecd6f54b2015-09-17 12:54:42 -07001232}
1233
David Benjamin9a41d1b2015-05-16 01:30:09 -04001234int SSL_CTX_get_read_ahead(const SSL_CTX *ctx) { return 0; }
Adam Langley95c29f32014-06-20 12:00:00 -07001235
David Benjamin0d56f882015-12-19 17:05:56 -05001236int SSL_get_read_ahead(const SSL *ssl) { return 0; }
Adam Langley95c29f32014-06-20 12:00:00 -07001237
David Benjamin9a41d1b2015-05-16 01:30:09 -04001238void SSL_CTX_set_read_ahead(SSL_CTX *ctx, int yes) { }
David Benjamin61ecccf2015-05-05 09:44:51 -04001239
David Benjamin0d56f882015-12-19 17:05:56 -05001240void SSL_set_read_ahead(SSL *ssl, int yes) { }
David Benjamin61ecccf2015-05-05 09:44:51 -04001241
David Benjamin9f859492015-10-03 10:44:30 -04001242int SSL_pending(const SSL *ssl) {
1243 if (ssl->s3->rrec.type != SSL3_RT_APPLICATION_DATA) {
1244 return 0;
1245 }
1246 return ssl->s3->rrec.length;
Adam Langleyfcf25832014-12-18 17:42:32 -08001247}
Adam Langley95c29f32014-06-20 12:00:00 -07001248
Adam Langley95c29f32014-06-20 12:00:00 -07001249/* Fix this so it checks all the valid key/cert options */
Adam Langleyfcf25832014-12-18 17:42:32 -08001250int SSL_CTX_check_private_key(const SSL_CTX *ctx) {
Adam Langley3a2b47a2017-01-24 13:59:42 -08001251 return ssl_cert_check_private_key(ctx->cert, ctx->cert->privatekey);
Adam Langleyc5ac2b62016-11-07 12:02:35 -08001252}
1253
1254/* Fix this function so that it takes an optional type parameter */
1255int SSL_check_private_key(const SSL *ssl) {
Adam Langley3a2b47a2017-01-24 13:59:42 -08001256 return ssl_cert_check_private_key(ssl->cert, ssl->cert->privatekey);
Adam Langleyfcf25832014-12-18 17:42:32 -08001257}
Adam Langley95c29f32014-06-20 12:00:00 -07001258
David Benjamin42fea372015-09-19 01:22:44 -04001259long SSL_get_default_timeout(const SSL *ssl) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001260 return SSL_DEFAULT_SESSION_TIMEOUT;
1261}
Adam Langley95c29f32014-06-20 12:00:00 -07001262
David Benjamin44d3eed2015-05-21 01:29:55 -04001263int SSL_renegotiate(SSL *ssl) {
1264 /* Caller-initiated renegotiation is not supported. */
David Benjamin3570d732015-06-29 00:28:17 -04001265 OPENSSL_PUT_ERROR(SSL, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
David Benjamin44d3eed2015-05-21 01:29:55 -04001266 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001267}
Adam Langley95c29f32014-06-20 12:00:00 -07001268
David Benjamin44d3eed2015-05-21 01:29:55 -04001269int SSL_renegotiate_pending(SSL *ssl) {
1270 return SSL_in_init(ssl) && ssl->s3->initial_handshake_complete;
Adam Langleyfcf25832014-12-18 17:42:32 -08001271}
Adam Langley95c29f32014-06-20 12:00:00 -07001272
David Benjamin936aada2016-06-07 19:09:22 -04001273int SSL_total_renegotiations(const SSL *ssl) {
1274 return ssl->s3->total_renegotiations;
1275}
1276
David Benjamin1d0a1942015-04-26 15:35:35 -04001277size_t SSL_CTX_get_max_cert_list(const SSL_CTX *ctx) {
1278 return ctx->max_cert_list;
1279}
1280
1281void SSL_CTX_set_max_cert_list(SSL_CTX *ctx, size_t max_cert_list) {
1282 if (max_cert_list > kMaxHandshakeSize) {
1283 max_cert_list = kMaxHandshakeSize;
1284 }
1285 ctx->max_cert_list = (uint32_t)max_cert_list;
1286}
1287
1288size_t SSL_get_max_cert_list(const SSL *ssl) {
1289 return ssl->max_cert_list;
1290}
1291
1292void SSL_set_max_cert_list(SSL *ssl, size_t max_cert_list) {
1293 if (max_cert_list > kMaxHandshakeSize) {
1294 max_cert_list = kMaxHandshakeSize;
1295 }
1296 ssl->max_cert_list = (uint32_t)max_cert_list;
1297}
1298
Adam Langleyce9d85e2016-01-24 15:58:39 -08001299int SSL_CTX_set_max_send_fragment(SSL_CTX *ctx, size_t max_send_fragment) {
David Benjamin1d0a1942015-04-26 15:35:35 -04001300 if (max_send_fragment < 512) {
1301 max_send_fragment = 512;
1302 }
1303 if (max_send_fragment > SSL3_RT_MAX_PLAIN_LENGTH) {
1304 max_send_fragment = SSL3_RT_MAX_PLAIN_LENGTH;
1305 }
1306 ctx->max_send_fragment = (uint16_t)max_send_fragment;
Adam Langleyce9d85e2016-01-24 15:58:39 -08001307
1308 return 1;
David Benjamin1d0a1942015-04-26 15:35:35 -04001309}
1310
Adam Langleyce9d85e2016-01-24 15:58:39 -08001311int SSL_set_max_send_fragment(SSL *ssl, size_t max_send_fragment) {
David Benjamin1d0a1942015-04-26 15:35:35 -04001312 if (max_send_fragment < 512) {
1313 max_send_fragment = 512;
1314 }
1315 if (max_send_fragment > SSL3_RT_MAX_PLAIN_LENGTH) {
1316 max_send_fragment = SSL3_RT_MAX_PLAIN_LENGTH;
1317 }
1318 ssl->max_send_fragment = (uint16_t)max_send_fragment;
Adam Langleyce9d85e2016-01-24 15:58:39 -08001319
1320 return 1;
David Benjamin1d0a1942015-04-26 15:35:35 -04001321}
1322
David Benjamincb9cf792015-05-05 09:46:14 -04001323int SSL_set_mtu(SSL *ssl, unsigned mtu) {
David Benjamince079fd2016-08-02 16:22:34 -04001324 if (!SSL_is_dtls(ssl) || mtu < dtls1_min_mtu()) {
David Benjamincb9cf792015-05-05 09:46:14 -04001325 return 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001326 }
David Benjamincb9cf792015-05-05 09:46:14 -04001327 ssl->d1->mtu = mtu;
1328 return 1;
1329}
1330
1331int SSL_get_secure_renegotiation_support(const SSL *ssl) {
David Benjamind2610042017-01-03 10:49:28 -05001332 if (!ssl->s3->have_version) {
1333 return 0;
1334 }
1335 return ssl3_protocol_version(ssl) >= TLS1_3_VERSION ||
1336 ssl->s3->send_connection_binding;
David Benjamincb9cf792015-05-05 09:46:14 -04001337}
1338
Adam Langleyfcf25832014-12-18 17:42:32 -08001339LHASH_OF(SSL_SESSION) *SSL_CTX_sessions(SSL_CTX *ctx) { return ctx->sessions; }
1340
David Benjamin71f7d3d2015-05-05 09:46:38 -04001341size_t SSL_CTX_sess_number(const SSL_CTX *ctx) {
1342 return lh_SSL_SESSION_num_items(ctx->sessions);
1343}
1344
1345unsigned long SSL_CTX_sess_set_cache_size(SSL_CTX *ctx, unsigned long size) {
1346 unsigned long ret = ctx->session_cache_size;
1347 ctx->session_cache_size = size;
1348 return ret;
1349}
1350
1351unsigned long SSL_CTX_sess_get_cache_size(const SSL_CTX *ctx) {
1352 return ctx->session_cache_size;
1353}
1354
1355int SSL_CTX_set_session_cache_mode(SSL_CTX *ctx, int mode) {
1356 int ret = ctx->session_cache_mode;
1357 ctx->session_cache_mode = mode;
1358 return ret;
1359}
1360
1361int SSL_CTX_get_session_cache_mode(const SSL_CTX *ctx) {
1362 return ctx->session_cache_mode;
1363}
1364
David Benjamin936aada2016-06-07 19:09:22 -04001365
1366int SSL_CTX_get_tlsext_ticket_keys(SSL_CTX *ctx, void *out, size_t len) {
1367 if (out == NULL) {
1368 return 48;
1369 }
1370 if (len != 48) {
1371 OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_TICKET_KEYS_LENGTH);
1372 return 0;
1373 }
1374 uint8_t *out_bytes = out;
David Benjamin17cf2cb2016-12-13 01:07:13 -05001375 OPENSSL_memcpy(out_bytes, ctx->tlsext_tick_key_name, 16);
1376 OPENSSL_memcpy(out_bytes + 16, ctx->tlsext_tick_hmac_key, 16);
1377 OPENSSL_memcpy(out_bytes + 32, ctx->tlsext_tick_aes_key, 16);
David Benjamin936aada2016-06-07 19:09:22 -04001378 return 1;
1379}
1380
1381int SSL_CTX_set_tlsext_ticket_keys(SSL_CTX *ctx, const void *in, size_t len) {
1382 if (in == NULL) {
1383 return 48;
1384 }
1385 if (len != 48) {
1386 OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_TICKET_KEYS_LENGTH);
1387 return 0;
1388 }
1389 const uint8_t *in_bytes = in;
David Benjamin17cf2cb2016-12-13 01:07:13 -05001390 OPENSSL_memcpy(ctx->tlsext_tick_key_name, in_bytes, 16);
1391 OPENSSL_memcpy(ctx->tlsext_tick_hmac_key, in_bytes + 16, 16);
1392 OPENSSL_memcpy(ctx->tlsext_tick_aes_key, in_bytes + 32, 16);
David Benjamin936aada2016-06-07 19:09:22 -04001393 return 1;
1394}
1395
1396int SSL_CTX_set_tlsext_ticket_key_cb(
1397 SSL_CTX *ctx, int (*callback)(SSL *ssl, uint8_t *key_name, uint8_t *iv,
1398 EVP_CIPHER_CTX *ctx, HMAC_CTX *hmac_ctx,
1399 int encrypt)) {
1400 ctx->tlsext_ticket_key_cb = callback;
1401 return 1;
1402}
1403
1404int SSL_CTX_set1_curves(SSL_CTX *ctx, const int *curves, size_t curves_len) {
1405 return tls1_set_curves(&ctx->supported_group_list,
1406 &ctx->supported_group_list_len, curves,
1407 curves_len);
1408}
1409
1410int SSL_set1_curves(SSL *ssl, const int *curves, size_t curves_len) {
1411 return tls1_set_curves(&ssl->supported_group_list,
1412 &ssl->supported_group_list_len, curves,
1413 curves_len);
1414}
1415
Alessandro Ghedini5fd18072016-09-28 21:04:25 +01001416int SSL_CTX_set1_curves_list(SSL_CTX *ctx, const char *curves) {
1417 return tls1_set_curves_list(&ctx->supported_group_list,
1418 &ctx->supported_group_list_len, curves);
1419}
1420
1421int SSL_set1_curves_list(SSL *ssl, const char *curves) {
1422 return tls1_set_curves_list(&ssl->supported_group_list,
1423 &ssl->supported_group_list_len, curves);
1424}
1425
David Benjamin9e68f192016-06-30 14:55:33 -04001426uint16_t SSL_get_curve_id(const SSL *ssl) {
1427 /* TODO(davidben): This checks the wrong session if there is a renegotiation in
1428 * progress. */
Steven Valdez87eab492016-06-27 16:34:59 -04001429 SSL_SESSION *session = SSL_get_session(ssl);
David Benjamin4882a6c2016-12-11 02:48:12 -05001430 if (session == NULL) {
David Benjamin9e68f192016-06-30 14:55:33 -04001431 return 0;
1432 }
1433
David Benjamin4882a6c2016-12-11 02:48:12 -05001434 return session->group_id;
David Benjamin9e68f192016-06-30 14:55:33 -04001435}
1436
David Benjamin936aada2016-06-07 19:09:22 -04001437int SSL_CTX_set_tmp_dh(SSL_CTX *ctx, const DH *dh) {
1438 DH_free(ctx->cert->dh_tmp);
1439 ctx->cert->dh_tmp = DHparams_dup(dh);
1440 if (ctx->cert->dh_tmp == NULL) {
1441 OPENSSL_PUT_ERROR(SSL, ERR_R_DH_LIB);
1442 return 0;
1443 }
1444 return 1;
1445}
1446
1447int SSL_set_tmp_dh(SSL *ssl, const DH *dh) {
1448 DH_free(ssl->cert->dh_tmp);
1449 ssl->cert->dh_tmp = DHparams_dup(dh);
1450 if (ssl->cert->dh_tmp == NULL) {
1451 OPENSSL_PUT_ERROR(SSL, ERR_R_DH_LIB);
1452 return 0;
1453 }
1454 return 1;
1455}
1456
David Benjamin8ebeabf2017-03-02 22:04:07 -05001457OPENSSL_EXPORT STACK_OF(SSL_CIPHER) *SSL_CTX_get_ciphers(const SSL_CTX *ctx) {
1458 return ctx->cipher_list->ciphers;
1459}
1460
David Benjamin32876b32015-09-20 12:17:03 -04001461STACK_OF(SSL_CIPHER) *SSL_get_ciphers(const SSL *ssl) {
1462 if (ssl == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001463 return NULL;
1464 }
Adam Langley0b5c1ac2014-06-20 12:00:00 -07001465
David Benjaminaf3b3d32016-10-31 16:29:57 -04001466 const struct ssl_cipher_preference_list_st *prefs =
1467 ssl_get_cipher_preferences(ssl);
1468 if (prefs == NULL) {
1469 return NULL;
Adam Langleyfcf25832014-12-18 17:42:32 -08001470 }
Adam Langley0b5c1ac2014-06-20 12:00:00 -07001471
David Benjaminaf3b3d32016-10-31 16:29:57 -04001472 return prefs->ciphers;
Adam Langleyfcf25832014-12-18 17:42:32 -08001473}
Adam Langley95c29f32014-06-20 12:00:00 -07001474
David Benjamin32876b32015-09-20 12:17:03 -04001475const char *SSL_get_cipher_list(const SSL *ssl, int n) {
David Benjamin32876b32015-09-20 12:17:03 -04001476 if (ssl == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001477 return NULL;
1478 }
Adam Langley95c29f32014-06-20 12:00:00 -07001479
David Benjamin8ebeabf2017-03-02 22:04:07 -05001480 STACK_OF(SSL_CIPHER) *sk = SSL_get_ciphers(ssl);
Adam Langleyfcf25832014-12-18 17:42:32 -08001481 if (sk == NULL || n < 0 || (size_t)n >= sk_SSL_CIPHER_num(sk)) {
1482 return NULL;
1483 }
Adam Langley95c29f32014-06-20 12:00:00 -07001484
David Benjamin8ebeabf2017-03-02 22:04:07 -05001485 const SSL_CIPHER *c = sk_SSL_CIPHER_value(sk, n);
Adam Langleyfcf25832014-12-18 17:42:32 -08001486 if (c == NULL) {
1487 return NULL;
1488 }
Adam Langley95c29f32014-06-20 12:00:00 -07001489
Adam Langleyfcf25832014-12-18 17:42:32 -08001490 return c->name;
1491}
David Benjamin5491e3f2014-09-29 19:33:09 -04001492
Adam Langleyfcf25832014-12-18 17:42:32 -08001493int SSL_CTX_set_cipher_list(SSL_CTX *ctx, const char *str) {
Matthew Braithwaite6ad20dc2017-02-21 16:41:33 -08001494 return ssl_create_cipher_list(ctx->method, &ctx->cipher_list, str,
1495 0 /* not strict */);
Matthew Braithwaitea57dcfb2017-02-17 22:08:23 -08001496}
1497
1498int SSL_CTX_set_strict_cipher_list(SSL_CTX *ctx, const char *str) {
Matthew Braithwaite6ad20dc2017-02-21 16:41:33 -08001499 return ssl_create_cipher_list(ctx->method, &ctx->cipher_list, str,
1500 1 /* strict */);
Adam Langleyfcf25832014-12-18 17:42:32 -08001501}
David Benjamin39482a12014-07-20 13:30:15 -04001502
David Benjamin32876b32015-09-20 12:17:03 -04001503int SSL_set_cipher_list(SSL *ssl, const char *str) {
Matthew Braithwaite6ad20dc2017-02-21 16:41:33 -08001504 return ssl_create_cipher_list(ssl->ctx->method, &ssl->cipher_list, str,
1505 0 /* not strict */);
Matthew Braithwaitea57dcfb2017-02-17 22:08:23 -08001506}
1507
1508int SSL_set_strict_cipher_list(SSL *ssl, const char *str) {
Matthew Braithwaite6ad20dc2017-02-21 16:41:33 -08001509 return ssl_create_cipher_list(ssl->ctx->method, &ssl->cipher_list, str,
1510 1 /* strict */);
Adam Langleyfcf25832014-12-18 17:42:32 -08001511}
Adam Langley95c29f32014-06-20 12:00:00 -07001512
David Benjamin07e13842015-10-17 13:48:04 -04001513const char *SSL_get_servername(const SSL *ssl, const int type) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001514 if (type != TLSEXT_NAMETYPE_host_name) {
1515 return NULL;
1516 }
Adam Langley95c29f32014-06-20 12:00:00 -07001517
David Benjamin07e13842015-10-17 13:48:04 -04001518 /* Historically, |SSL_get_servername| was also the configuration getter
1519 * corresponding to |SSL_set_tlsext_host_name|. */
1520 if (ssl->tlsext_hostname != NULL) {
1521 return ssl->tlsext_hostname;
1522 }
1523
David Benjamin4eb95cc2016-11-16 17:08:23 +09001524 /* During the handshake, report the handshake value. */
1525 if (ssl->s3->hs != NULL) {
1526 return ssl->s3->hs->hostname;
1527 }
1528
1529 /* SSL_get_servername may also be called after the handshake to look up the
1530 * SNI value.
1531 *
1532 * TODO(davidben): This is almost unused. Can we remove it? */
Steven Valdez87eab492016-06-27 16:34:59 -04001533 SSL_SESSION *session = SSL_get_session(ssl);
1534 if (session == NULL) {
David Benjamin07e13842015-10-17 13:48:04 -04001535 return NULL;
1536 }
Steven Valdez87eab492016-06-27 16:34:59 -04001537 return session->tlsext_hostname;
Adam Langleyfcf25832014-12-18 17:42:32 -08001538}
Adam Langley95c29f32014-06-20 12:00:00 -07001539
David Benjamin07e13842015-10-17 13:48:04 -04001540int SSL_get_servername_type(const SSL *ssl) {
Steven Valdez87eab492016-06-27 16:34:59 -04001541 SSL_SESSION *session = SSL_get_session(ssl);
1542 if (session == NULL || session->tlsext_hostname == NULL) {
1543 return -1;
Adam Langleyfcf25832014-12-18 17:42:32 -08001544 }
Steven Valdez87eab492016-06-27 16:34:59 -04001545 return TLSEXT_NAMETYPE_host_name;
Adam Langleyfcf25832014-12-18 17:42:32 -08001546}
Adam Langley95c29f32014-06-20 12:00:00 -07001547
Adam Langleyfcf25832014-12-18 17:42:32 -08001548void SSL_CTX_enable_signed_cert_timestamps(SSL_CTX *ctx) {
1549 ctx->signed_cert_timestamps_enabled = 1;
1550}
HÃ¥vard Molland9169c962014-08-14 14:42:37 +02001551
Adam Langleyfe366722017-03-07 16:41:04 -08001552void SSL_CTX_i_promise_to_verify_certs_after_the_handshake(SSL_CTX *ctx) {
1553 ctx->i_promise_to_verify_certs_after_the_handshake = 1;
1554}
1555
David Benjamin26e1ff32017-02-14 20:13:00 -05001556void SSL_enable_signed_cert_timestamps(SSL *ssl) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001557 ssl->signed_cert_timestamps_enabled = 1;
Adam Langleyfcf25832014-12-18 17:42:32 -08001558}
HÃ¥vard Molland9169c962014-08-14 14:42:37 +02001559
Adam Langleyfcf25832014-12-18 17:42:32 -08001560void SSL_CTX_enable_ocsp_stapling(SSL_CTX *ctx) {
1561 ctx->ocsp_stapling_enabled = 1;
1562}
David Benjamin6c7aed02014-08-27 16:42:38 -04001563
David Benjamin26e1ff32017-02-14 20:13:00 -05001564void SSL_enable_ocsp_stapling(SSL *ssl) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001565 ssl->ocsp_stapling_enabled = 1;
Adam Langleyfcf25832014-12-18 17:42:32 -08001566}
David Benjamin6c7aed02014-08-27 16:42:38 -04001567
Adam Langleyfcf25832014-12-18 17:42:32 -08001568void SSL_get0_signed_cert_timestamp_list(const SSL *ssl, const uint8_t **out,
1569 size_t *out_len) {
Steven Valdez87eab492016-06-27 16:34:59 -04001570 SSL_SESSION *session = SSL_get_session(ssl);
Adam Langley3cb50e02014-08-26 14:00:31 -07001571
Adam Langleyfcf25832014-12-18 17:42:32 -08001572 *out_len = 0;
1573 *out = NULL;
1574 if (ssl->server || !session || !session->tlsext_signed_cert_timestamp_list) {
1575 return;
1576 }
HÃ¥vard Molland9169c962014-08-14 14:42:37 +02001577
Adam Langleyfcf25832014-12-18 17:42:32 -08001578 *out = session->tlsext_signed_cert_timestamp_list;
1579 *out_len = session->tlsext_signed_cert_timestamp_list_length;
1580}
David Benjamin6c7aed02014-08-27 16:42:38 -04001581
Adam Langleyfcf25832014-12-18 17:42:32 -08001582void SSL_get0_ocsp_response(const SSL *ssl, const uint8_t **out,
1583 size_t *out_len) {
Steven Valdez87eab492016-06-27 16:34:59 -04001584 SSL_SESSION *session = SSL_get_session(ssl);
Adam Langleyfcf25832014-12-18 17:42:32 -08001585
1586 *out_len = 0;
1587 *out = NULL;
1588 if (ssl->server || !session || !session->ocsp_response) {
1589 return;
1590 }
1591 *out = session->ocsp_response;
1592 *out_len = session->ocsp_response_length;
1593}
David Benjamin6c7aed02014-08-27 16:42:38 -04001594
David Benjamin936aada2016-06-07 19:09:22 -04001595int SSL_set_tlsext_host_name(SSL *ssl, const char *name) {
1596 OPENSSL_free(ssl->tlsext_hostname);
1597 ssl->tlsext_hostname = NULL;
1598
1599 if (name == NULL) {
1600 return 1;
1601 }
1602
1603 size_t len = strlen(name);
1604 if (len == 0 || len > TLSEXT_MAXLEN_host_name) {
1605 OPENSSL_PUT_ERROR(SSL, SSL_R_SSL3_EXT_INVALID_SERVERNAME);
1606 return 0;
1607 }
1608 ssl->tlsext_hostname = BUF_strdup(name);
1609 if (ssl->tlsext_hostname == NULL) {
1610 OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
1611 return 0;
1612 }
1613 return 1;
1614}
1615
1616int SSL_CTX_set_tlsext_servername_callback(
1617 SSL_CTX *ctx, int (*callback)(SSL *ssl, int *out_alert, void *arg)) {
1618 ctx->tlsext_servername_callback = callback;
1619 return 1;
1620}
1621
1622int SSL_CTX_set_tlsext_servername_arg(SSL_CTX *ctx, void *arg) {
1623 ctx->tlsext_servername_arg = arg;
1624 return 1;
1625}
1626
David Benjamin977547b2015-09-16 00:25:52 -04001627int SSL_select_next_proto(uint8_t **out, uint8_t *out_len,
1628 const uint8_t *server, unsigned server_len,
1629 const uint8_t *client, unsigned client_len) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001630 unsigned int i, j;
1631 const uint8_t *result;
1632 int status = OPENSSL_NPN_UNSUPPORTED;
Adam Langley95c29f32014-06-20 12:00:00 -07001633
Adam Langleyfcf25832014-12-18 17:42:32 -08001634 /* For each protocol in server preference order, see if we support it. */
1635 for (i = 0; i < server_len;) {
1636 for (j = 0; j < client_len;) {
1637 if (server[i] == client[j] &&
David Benjamin17cf2cb2016-12-13 01:07:13 -05001638 OPENSSL_memcmp(&server[i + 1], &client[j + 1], server[i]) == 0) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001639 /* We found a match */
1640 result = &server[i];
1641 status = OPENSSL_NPN_NEGOTIATED;
1642 goto found;
1643 }
1644 j += client[j];
1645 j++;
1646 }
1647 i += server[i];
1648 i++;
1649 }
Adam Langley95c29f32014-06-20 12:00:00 -07001650
Adam Langleyfcf25832014-12-18 17:42:32 -08001651 /* There's no overlap between our protocols and the server's list. */
1652 result = client;
1653 status = OPENSSL_NPN_NO_OVERLAP;
Adam Langley95c29f32014-06-20 12:00:00 -07001654
Adam Langleyfcf25832014-12-18 17:42:32 -08001655found:
1656 *out = (uint8_t *)result + 1;
David Benjamin977547b2015-09-16 00:25:52 -04001657 *out_len = result[0];
Adam Langleyfcf25832014-12-18 17:42:32 -08001658 return status;
1659}
Adam Langley95c29f32014-06-20 12:00:00 -07001660
David Benjamin977547b2015-09-16 00:25:52 -04001661void SSL_get0_next_proto_negotiated(const SSL *ssl, const uint8_t **out_data,
1662 unsigned *out_len) {
David Benjamin79978df2015-12-25 15:56:49 -05001663 *out_data = ssl->s3->next_proto_negotiated;
David Benjamin977547b2015-09-16 00:25:52 -04001664 if (*out_data == NULL) {
1665 *out_len = 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001666 } else {
David Benjamin79978df2015-12-25 15:56:49 -05001667 *out_len = ssl->s3->next_proto_negotiated_len;
Adam Langleyfcf25832014-12-18 17:42:32 -08001668 }
Adam Langley95c29f32014-06-20 12:00:00 -07001669}
1670
Adam Langleyfcf25832014-12-18 17:42:32 -08001671void SSL_CTX_set_next_protos_advertised_cb(
1672 SSL_CTX *ctx,
David Benjamin977547b2015-09-16 00:25:52 -04001673 int (*cb)(SSL *ssl, const uint8_t **out, unsigned *out_len, void *arg),
Adam Langleyfcf25832014-12-18 17:42:32 -08001674 void *arg) {
1675 ctx->next_protos_advertised_cb = cb;
1676 ctx->next_protos_advertised_cb_arg = arg;
1677}
Adam Langley95c29f32014-06-20 12:00:00 -07001678
Adam Langleyfcf25832014-12-18 17:42:32 -08001679void SSL_CTX_set_next_proto_select_cb(
David Benjamin977547b2015-09-16 00:25:52 -04001680 SSL_CTX *ctx, int (*cb)(SSL *ssl, uint8_t **out, uint8_t *out_len,
1681 const uint8_t *in, unsigned in_len, void *arg),
Adam Langleyfcf25832014-12-18 17:42:32 -08001682 void *arg) {
1683 ctx->next_proto_select_cb = cb;
1684 ctx->next_proto_select_cb_arg = arg;
1685}
Adam Langley95c29f32014-06-20 12:00:00 -07001686
Adam Langleyfcf25832014-12-18 17:42:32 -08001687int SSL_CTX_set_alpn_protos(SSL_CTX *ctx, const uint8_t *protos,
1688 unsigned protos_len) {
David Benjamin2755a3e2015-04-22 16:17:58 -04001689 OPENSSL_free(ctx->alpn_client_proto_list);
Adam Langleyfcf25832014-12-18 17:42:32 -08001690 ctx->alpn_client_proto_list = BUF_memdup(protos, protos_len);
1691 if (!ctx->alpn_client_proto_list) {
1692 return 1;
1693 }
1694 ctx->alpn_client_proto_list_len = protos_len;
Adam Langley95c29f32014-06-20 12:00:00 -07001695
Adam Langleyfcf25832014-12-18 17:42:32 -08001696 return 0;
1697}
Adam Langley95c29f32014-06-20 12:00:00 -07001698
Adam Langleyfcf25832014-12-18 17:42:32 -08001699int SSL_set_alpn_protos(SSL *ssl, const uint8_t *protos, unsigned protos_len) {
David Benjamin2755a3e2015-04-22 16:17:58 -04001700 OPENSSL_free(ssl->alpn_client_proto_list);
Adam Langleyfcf25832014-12-18 17:42:32 -08001701 ssl->alpn_client_proto_list = BUF_memdup(protos, protos_len);
1702 if (!ssl->alpn_client_proto_list) {
1703 return 1;
1704 }
1705 ssl->alpn_client_proto_list_len = protos_len;
Adam Langley95c29f32014-06-20 12:00:00 -07001706
Adam Langleyfcf25832014-12-18 17:42:32 -08001707 return 0;
1708}
Adam Langley95c29f32014-06-20 12:00:00 -07001709
Adam Langleyfcf25832014-12-18 17:42:32 -08001710void SSL_CTX_set_alpn_select_cb(SSL_CTX *ctx,
1711 int (*cb)(SSL *ssl, const uint8_t **out,
David Benjamin8984f1f2015-09-16 00:10:19 -04001712 uint8_t *out_len, const uint8_t *in,
1713 unsigned in_len, void *arg),
Adam Langleyfcf25832014-12-18 17:42:32 -08001714 void *arg) {
1715 ctx->alpn_select_cb = cb;
1716 ctx->alpn_select_cb_arg = arg;
1717}
Adam Langley95c29f32014-06-20 12:00:00 -07001718
David Benjamin8984f1f2015-09-16 00:10:19 -04001719void SSL_get0_alpn_selected(const SSL *ssl, const uint8_t **out_data,
1720 unsigned *out_len) {
1721 *out_data = NULL;
Adam Langleyfcf25832014-12-18 17:42:32 -08001722 if (ssl->s3) {
David Benjamin8984f1f2015-09-16 00:10:19 -04001723 *out_data = ssl->s3->alpn_selected;
Adam Langleyfcf25832014-12-18 17:42:32 -08001724 }
David Benjamin8984f1f2015-09-16 00:10:19 -04001725 if (*out_data == NULL) {
1726 *out_len = 0;
Adam Langleyfcf25832014-12-18 17:42:32 -08001727 } else {
David Benjamin8984f1f2015-09-16 00:10:19 -04001728 *out_len = ssl->s3->alpn_selected_len;
Adam Langleyfcf25832014-12-18 17:42:32 -08001729 }
1730}
Adam Langley95c29f32014-06-20 12:00:00 -07001731
David Benjamin936aada2016-06-07 19:09:22 -04001732
David Benjamineebd3c82016-12-06 17:43:58 -05001733void SSL_CTX_set_tls_channel_id_enabled(SSL_CTX *ctx, int enabled) {
1734 ctx->tlsext_channel_id_enabled = !!enabled;
1735}
1736
David Benjamin936aada2016-06-07 19:09:22 -04001737int SSL_CTX_enable_tls_channel_id(SSL_CTX *ctx) {
David Benjamineebd3c82016-12-06 17:43:58 -05001738 SSL_CTX_set_tls_channel_id_enabled(ctx, 1);
David Benjamin936aada2016-06-07 19:09:22 -04001739 return 1;
1740}
1741
David Benjamineebd3c82016-12-06 17:43:58 -05001742void SSL_set_tls_channel_id_enabled(SSL *ssl, int enabled) {
1743 ssl->tlsext_channel_id_enabled = !!enabled;
1744}
1745
David Benjamin936aada2016-06-07 19:09:22 -04001746int SSL_enable_tls_channel_id(SSL *ssl) {
David Benjamineebd3c82016-12-06 17:43:58 -05001747 SSL_set_tls_channel_id_enabled(ssl, 1);
David Benjamin936aada2016-06-07 19:09:22 -04001748 return 1;
1749}
1750
1751static int is_p256_key(EVP_PKEY *private_key) {
1752 const EC_KEY *ec_key = EVP_PKEY_get0_EC_KEY(private_key);
1753 return ec_key != NULL &&
1754 EC_GROUP_get_curve_name(EC_KEY_get0_group(ec_key)) ==
1755 NID_X9_62_prime256v1;
1756}
1757
1758int SSL_CTX_set1_tls_channel_id(SSL_CTX *ctx, EVP_PKEY *private_key) {
1759 if (!is_p256_key(private_key)) {
1760 OPENSSL_PUT_ERROR(SSL, SSL_R_CHANNEL_ID_NOT_P256);
1761 return 0;
1762 }
1763
1764 EVP_PKEY_free(ctx->tlsext_channel_id_private);
Adam Langley310d3f62016-07-12 10:39:20 -07001765 EVP_PKEY_up_ref(private_key);
1766 ctx->tlsext_channel_id_private = private_key;
David Benjamin936aada2016-06-07 19:09:22 -04001767 ctx->tlsext_channel_id_enabled = 1;
1768
1769 return 1;
1770}
1771
1772int SSL_set1_tls_channel_id(SSL *ssl, EVP_PKEY *private_key) {
1773 if (!is_p256_key(private_key)) {
1774 OPENSSL_PUT_ERROR(SSL, SSL_R_CHANNEL_ID_NOT_P256);
1775 return 0;
1776 }
1777
1778 EVP_PKEY_free(ssl->tlsext_channel_id_private);
Adam Langley310d3f62016-07-12 10:39:20 -07001779 EVP_PKEY_up_ref(private_key);
1780 ssl->tlsext_channel_id_private = private_key;
David Benjamin936aada2016-06-07 19:09:22 -04001781 ssl->tlsext_channel_id_enabled = 1;
1782
1783 return 1;
1784}
1785
1786size_t SSL_get_tls_channel_id(SSL *ssl, uint8_t *out, size_t max_out) {
1787 if (!ssl->s3->tlsext_channel_id_valid) {
1788 return 0;
1789 }
David Benjamin17cf2cb2016-12-13 01:07:13 -05001790 OPENSSL_memcpy(out, ssl->s3->tlsext_channel_id,
1791 (max_out < 64) ? max_out : 64);
David Benjamin936aada2016-06-07 19:09:22 -04001792 return 64;
1793}
1794
David Benjamin936aada2016-06-07 19:09:22 -04001795size_t SSL_get0_certificate_types(SSL *ssl, const uint8_t **out_types) {
David Benjamina0486782016-10-06 19:11:32 -04001796 if (ssl->server || ssl->s3->hs == NULL) {
David Benjamin936aada2016-06-07 19:09:22 -04001797 *out_types = NULL;
1798 return 0;
1799 }
David Benjamina0486782016-10-06 19:11:32 -04001800 *out_types = ssl->s3->hs->certificate_types;
1801 return ssl->s3->hs->num_certificate_types;
David Benjamin936aada2016-06-07 19:09:22 -04001802}
1803
David Benjaminf3c8f8d2016-11-17 17:20:47 +09001804void ssl_update_cache(SSL_HANDSHAKE *hs, int mode) {
1805 SSL *const ssl = hs->ssl;
David Benjaminbe497062017-03-10 16:08:36 -05001806 SSL_CTX *ctx = ssl->session_ctx;
David Benjaminb6d0c6d2015-03-19 19:07:26 -04001807 /* Never cache sessions with empty session IDs. */
Steven Valdez87eab492016-06-27 16:34:59 -04001808 if (ssl->s3->established_session->session_id_length == 0 ||
David Benjamin1269ddd2015-10-18 15:18:55 -04001809 (ctx->session_cache_mode & mode) != mode) {
Adam Langleyfcf25832014-12-18 17:42:32 -08001810 return;
1811 }
Adam Langley95c29f32014-06-20 12:00:00 -07001812
David Benjamin1269ddd2015-10-18 15:18:55 -04001813 /* Clients never use the internal session cache. */
1814 int use_internal_cache = ssl->server && !(ctx->session_cache_mode &
1815 SSL_SESS_CACHE_NO_INTERNAL_STORE);
David Benjamin95d31822015-06-15 19:53:32 -04001816
David Benjamin1269ddd2015-10-18 15:18:55 -04001817 /* A client may see new sessions on abbreviated handshakes if the server
1818 * decides to renew the ticket. Once the handshake is completed, it should be
1819 * inserted into the cache. */
Steven Valdez87eab492016-06-27 16:34:59 -04001820 if (ssl->s3->established_session != ssl->session ||
David Benjaminf3c8f8d2016-11-17 17:20:47 +09001821 (!ssl->server && hs->ticket_expected)) {
David Benjamin1269ddd2015-10-18 15:18:55 -04001822 if (use_internal_cache) {
Steven Valdez87eab492016-06-27 16:34:59 -04001823 SSL_CTX_add_session(ctx, ssl->s3->established_session);
David Benjamin1269ddd2015-10-18 15:18:55 -04001824 }
David Benjaminb9195402016-08-05 10:51:43 -04001825 if (ctx->new_session_cb != NULL) {
1826 SSL_SESSION_up_ref(ssl->s3->established_session);
1827 if (!ctx->new_session_cb(ssl, ssl->s3->established_session)) {
1828 /* |new_session_cb|'s return value signals whether it took ownership. */
1829 SSL_SESSION_free(ssl->s3->established_session);
1830 }
Adam Langleyfcf25832014-12-18 17:42:32 -08001831 }
1832 }
Adam Langley95c29f32014-06-20 12:00:00 -07001833
David Benjamin1269ddd2015-10-18 15:18:55 -04001834 if (use_internal_cache &&
1835 !(ctx->session_cache_mode & SSL_SESS_CACHE_NO_AUTO_CLEAR)) {
David Benjaminb6d0c6d2015-03-19 19:07:26 -04001836 /* Automatically flush the internal session cache every 255 connections. */
1837 int flush_cache = 0;
Adam Langley4bdb6e42015-05-15 15:29:21 -07001838 CRYPTO_MUTEX_lock_write(&ctx->lock);
David Benjaminb6d0c6d2015-03-19 19:07:26 -04001839 ctx->handshakes_since_cache_flush++;
1840 if (ctx->handshakes_since_cache_flush >= 255) {
1841 flush_cache = 1;
1842 ctx->handshakes_since_cache_flush = 0;
1843 }
David Benjamin29270de2016-05-24 15:28:36 +00001844 CRYPTO_MUTEX_unlock_write(&ctx->lock);
David Benjaminb6d0c6d2015-03-19 19:07:26 -04001845
1846 if (flush_cache) {
David Benjaminad8f5e12017-02-20 17:00:20 -05001847 struct OPENSSL_timeval now;
David Benjamin721e8b72016-08-03 13:13:17 -04001848 ssl_get_current_time(ssl, &now);
David Benjaminad8f5e12017-02-20 17:00:20 -05001849 SSL_CTX_flush_sessions(ctx, now.tv_sec);
Adam Langleyfcf25832014-12-18 17:42:32 -08001850 }
1851 }
1852}
Adam Langley95c29f32014-06-20 12:00:00 -07001853
Adam Langleyfcf25832014-12-18 17:42:32 -08001854static const char *ssl_get_version(int version) {
1855 switch (version) {
Steven Valdezfdd10992016-09-15 16:27:05 -04001856 /* Report TLS 1.3 draft version as TLS 1.3 in the public API. */
1857 case TLS1_3_DRAFT_VERSION:
Steven Valdez4f94b1c2016-05-24 12:31:07 -04001858 return "TLSv1.3";
1859
Adam Langleyfcf25832014-12-18 17:42:32 -08001860 case TLS1_2_VERSION:
1861 return "TLSv1.2";
Adam Langley95c29f32014-06-20 12:00:00 -07001862
Adam Langleyfcf25832014-12-18 17:42:32 -08001863 case TLS1_1_VERSION:
1864 return "TLSv1.1";
Adam Langley95c29f32014-06-20 12:00:00 -07001865
Adam Langleyfcf25832014-12-18 17:42:32 -08001866 case TLS1_VERSION:
1867 return "TLSv1";
Adam Langley95c29f32014-06-20 12:00:00 -07001868
Adam Langleyfcf25832014-12-18 17:42:32 -08001869 case SSL3_VERSION:
1870 return "SSLv3";
Adam Langley95c29f32014-06-20 12:00:00 -07001871
David Benjamin1c722b72015-04-20 13:53:10 -04001872 case DTLS1_VERSION:
1873 return "DTLSv1";
1874
1875 case DTLS1_2_VERSION:
1876 return "DTLSv1.2";
1877
Adam Langleyfcf25832014-12-18 17:42:32 -08001878 default:
1879 return "unknown";
1880 }
1881}
Adam Langley95c29f32014-06-20 12:00:00 -07001882
David Benjamin42fea372015-09-19 01:22:44 -04001883const char *SSL_get_version(const SSL *ssl) {
1884 return ssl_get_version(ssl->version);
Adam Langleyfcf25832014-12-18 17:42:32 -08001885}
Adam Langley95c29f32014-06-20 12:00:00 -07001886
David Benjamina6b8cdf2015-09-13 14:07:33 -04001887const char *SSL_SESSION_get_version(const SSL_SESSION *session) {
1888 return ssl_get_version(session->ssl_version);
Adam Langleyfcf25832014-12-18 17:42:32 -08001889}
Adam Langley95c29f32014-06-20 12:00:00 -07001890
David Benjamin0d56f882015-12-19 17:05:56 -05001891EVP_PKEY *SSL_get_privatekey(const SSL *ssl) {
1892 if (ssl->cert != NULL) {
1893 return ssl->cert->privatekey;
Adam Langleyfcf25832014-12-18 17:42:32 -08001894 }
1895
1896 return NULL;
1897}
1898
Adam Langleyfcf25832014-12-18 17:42:32 -08001899EVP_PKEY *SSL_CTX_get0_privatekey(const SSL_CTX *ctx) {
1900 if (ctx->cert != NULL) {
David Benjamind1d80782015-07-05 11:54:09 -04001901 return ctx->cert->privatekey;
Adam Langleyfcf25832014-12-18 17:42:32 -08001902 }
1903
1904 return NULL;
1905}
1906
David Benjamin42fea372015-09-19 01:22:44 -04001907const SSL_CIPHER *SSL_get_current_cipher(const SSL *ssl) {
David Benjamin79978df2015-12-25 15:56:49 -05001908 if (ssl->s3->aead_write_ctx == NULL) {
David Benjamina07c0fc2015-05-13 13:19:42 -04001909 return NULL;
Adam Langleyfcf25832014-12-18 17:42:32 -08001910 }
David Benjamin79978df2015-12-25 15:56:49 -05001911 return ssl->s3->aead_write_ctx->cipher;
Adam Langleyfcf25832014-12-18 17:42:32 -08001912}
1913
David Benjamin936aada2016-06-07 19:09:22 -04001914int SSL_session_reused(const SSL *ssl) {
Steven Valdez4aa154e2016-07-29 14:32:55 -04001915 return ssl->s3->session_reused;
David Benjamin936aada2016-06-07 19:09:22 -04001916}
1917
David Benjamin0d56f882015-12-19 17:05:56 -05001918const COMP_METHOD *SSL_get_current_compression(SSL *ssl) { return NULL; }
Adam Langleyfcf25832014-12-18 17:42:32 -08001919
David Benjamin0d56f882015-12-19 17:05:56 -05001920const COMP_METHOD *SSL_get_current_expansion(SSL *ssl) { return NULL; }
Adam Langleyfcf25832014-12-18 17:42:32 -08001921
Adam Langley29ec5d12016-03-01 16:12:28 -08001922int *SSL_get_server_tmp_key(SSL *ssl, EVP_PKEY **out_key) { return 0; }
1923
Adam Langleyfcf25832014-12-18 17:42:32 -08001924void SSL_CTX_set_quiet_shutdown(SSL_CTX *ctx, int mode) {
Adam Langleybb85f3d2015-10-28 18:44:11 -07001925 ctx->quiet_shutdown = (mode != 0);
Adam Langleyfcf25832014-12-18 17:42:32 -08001926}
1927
1928int SSL_CTX_get_quiet_shutdown(const SSL_CTX *ctx) {
1929 return ctx->quiet_shutdown;
1930}
1931
Adam Langleybb85f3d2015-10-28 18:44:11 -07001932void SSL_set_quiet_shutdown(SSL *ssl, int mode) {
1933 ssl->quiet_shutdown = (mode != 0);
1934}
Adam Langleyfcf25832014-12-18 17:42:32 -08001935
David Benjamin9f859492015-10-03 10:44:30 -04001936int SSL_get_quiet_shutdown(const SSL *ssl) { return ssl->quiet_shutdown; }
Adam Langleyfcf25832014-12-18 17:42:32 -08001937
David Benjamin63006a92015-10-18 00:00:06 -04001938void SSL_set_shutdown(SSL *ssl, int mode) {
1939 /* It is an error to clear any bits that have already been set. (We can't try
1940 * to get a second close_notify or send two.) */
David Benjaminfa214e42016-05-10 17:03:10 -04001941 assert((SSL_get_shutdown(ssl) & mode) == SSL_get_shutdown(ssl));
David Benjamin63006a92015-10-18 00:00:06 -04001942
David Benjaminfa214e42016-05-10 17:03:10 -04001943 if (mode & SSL_RECEIVED_SHUTDOWN &&
1944 ssl->s3->recv_shutdown == ssl_shutdown_none) {
1945 ssl->s3->recv_shutdown = ssl_shutdown_close_notify;
1946 }
1947
1948 if (mode & SSL_SENT_SHUTDOWN &&
1949 ssl->s3->send_shutdown == ssl_shutdown_none) {
1950 ssl->s3->send_shutdown = ssl_shutdown_close_notify;
1951 }
David Benjamin63006a92015-10-18 00:00:06 -04001952}
Adam Langleyfcf25832014-12-18 17:42:32 -08001953
David Benjaminfa214e42016-05-10 17:03:10 -04001954int SSL_get_shutdown(const SSL *ssl) {
1955 int ret = 0;
1956 if (ssl->s3->recv_shutdown != ssl_shutdown_none) {
1957 /* Historically, OpenSSL set |SSL_RECEIVED_SHUTDOWN| on both close_notify
1958 * and fatal alert. */
1959 ret |= SSL_RECEIVED_SHUTDOWN;
1960 }
1961 if (ssl->s3->send_shutdown == ssl_shutdown_close_notify) {
1962 /* Historically, OpenSSL set |SSL_SENT_SHUTDOWN| on only close_notify. */
1963 ret |= SSL_SENT_SHUTDOWN;
1964 }
1965 return ret;
1966}
Adam Langleyfcf25832014-12-18 17:42:32 -08001967
Steven Valdezfdd10992016-09-15 16:27:05 -04001968int SSL_version(const SSL *ssl) {
1969 /* Report TLS 1.3 draft version as TLS 1.3 in the public API. */
1970 if (ssl->version == TLS1_3_DRAFT_VERSION) {
1971 return TLS1_3_VERSION;
1972 }
1973
1974 return ssl->version;
1975}
Adam Langleyfcf25832014-12-18 17:42:32 -08001976
1977SSL_CTX *SSL_get_SSL_CTX(const SSL *ssl) { return ssl->ctx; }
1978
1979SSL_CTX *SSL_set_SSL_CTX(SSL *ssl, SSL_CTX *ctx) {
1980 if (ssl->ctx == ctx) {
1981 return ssl->ctx;
1982 }
1983
Adam Langley3509dac2017-02-01 11:59:18 -08001984 /* One cannot change the X.509 callbacks during a connection. */
1985 if (ssl->ctx->x509_method != ctx->x509_method) {
1986 assert(0);
1987 return NULL;
1988 }
1989
Adam Langleyfcf25832014-12-18 17:42:32 -08001990 if (ctx == NULL) {
David Benjaminbe497062017-03-10 16:08:36 -05001991 ctx = ssl->session_ctx;
Adam Langleyfcf25832014-12-18 17:42:32 -08001992 }
1993
David Benjamin2755a3e2015-04-22 16:17:58 -04001994 ssl_cert_free(ssl->cert);
Adam Langleyfcf25832014-12-18 17:42:32 -08001995 ssl->cert = ssl_cert_dup(ctx->cert);
David Benjamin2755a3e2015-04-22 16:17:58 -04001996
David Benjaminf650c712016-12-22 15:54:51 -05001997 SSL_CTX_up_ref(ctx);
1998 SSL_CTX_free(ssl->ctx);
Adam Langleyfcf25832014-12-18 17:42:32 -08001999 ssl->ctx = ctx;
2000
Adam Langleyfcf25832014-12-18 17:42:32 -08002001 return ssl->ctx;
2002}
2003
Adam Langley95c29f32014-06-20 12:00:00 -07002004void SSL_set_info_callback(SSL *ssl,
David Benjamin82170242015-10-17 22:51:17 -04002005 void (*cb)(const SSL *ssl, int type, int value)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002006 ssl->info_callback = cb;
2007}
Adam Langley95c29f32014-06-20 12:00:00 -07002008
David Benjamin82170242015-10-17 22:51:17 -04002009void (*SSL_get_info_callback(const SSL *ssl))(const SSL *ssl, int type,
2010 int value) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002011 return ssl->info_callback;
2012}
Adam Langley95c29f32014-06-20 12:00:00 -07002013
David Benjamincb0c29f2016-12-12 17:00:50 -05002014int SSL_state(const SSL *ssl) {
David Benjamin9e766d72017-02-10 23:14:17 -05002015 return SSL_in_init(ssl) ? SSL_ST_INIT : SSL_ST_OK;
David Benjamincb0c29f2016-12-12 17:00:50 -05002016}
Adam Langley95c29f32014-06-20 12:00:00 -07002017
David Benjaminece089c2015-05-15 23:52:42 -04002018void SSL_set_state(SSL *ssl, int state) { }
Adam Langley95c29f32014-06-20 12:00:00 -07002019
Emily Stark95a79ee2016-02-25 21:12:28 -08002020char *SSL_get_shared_ciphers(const SSL *ssl, char *buf, int len) {
2021 if (len <= 0) {
2022 return NULL;
2023 }
2024 buf[0] = '\0';
2025 return buf;
2026}
2027
David Benjamin8a589332015-12-04 23:14:35 -05002028int SSL_get_ex_new_index(long argl, void *argp, CRYPTO_EX_unused *unused,
Adam Langleyfcf25832014-12-18 17:42:32 -08002029 CRYPTO_EX_dup *dup_func, CRYPTO_EX_free *free_func) {
David Benjamin9f33fc62015-04-15 17:29:53 -04002030 int index;
2031 if (!CRYPTO_get_ex_new_index(&g_ex_data_class_ssl, &index, argl, argp,
David Benjamin8a589332015-12-04 23:14:35 -05002032 dup_func, free_func)) {
David Benjamin9f33fc62015-04-15 17:29:53 -04002033 return -1;
2034 }
2035 return index;
Adam Langleyfcf25832014-12-18 17:42:32 -08002036}
Adam Langley95c29f32014-06-20 12:00:00 -07002037
David Benjamin1ac08fe2015-09-15 01:36:22 -04002038int SSL_set_ex_data(SSL *ssl, int idx, void *arg) {
2039 return CRYPTO_set_ex_data(&ssl->ex_data, idx, arg);
Adam Langleyfcf25832014-12-18 17:42:32 -08002040}
Adam Langley95c29f32014-06-20 12:00:00 -07002041
David Benjamin1ac08fe2015-09-15 01:36:22 -04002042void *SSL_get_ex_data(const SSL *ssl, int idx) {
2043 return CRYPTO_get_ex_data(&ssl->ex_data, idx);
Adam Langleyfcf25832014-12-18 17:42:32 -08002044}
Adam Langley95c29f32014-06-20 12:00:00 -07002045
David Benjamin8a589332015-12-04 23:14:35 -05002046int SSL_CTX_get_ex_new_index(long argl, void *argp, CRYPTO_EX_unused *unused,
Adam Langleyfcf25832014-12-18 17:42:32 -08002047 CRYPTO_EX_dup *dup_func,
2048 CRYPTO_EX_free *free_func) {
David Benjamin9f33fc62015-04-15 17:29:53 -04002049 int index;
2050 if (!CRYPTO_get_ex_new_index(&g_ex_data_class_ssl_ctx, &index, argl, argp,
David Benjamin8a589332015-12-04 23:14:35 -05002051 dup_func, free_func)) {
David Benjamin9f33fc62015-04-15 17:29:53 -04002052 return -1;
2053 }
2054 return index;
Adam Langleyfcf25832014-12-18 17:42:32 -08002055}
Adam Langley95c29f32014-06-20 12:00:00 -07002056
David Benjamin1ac08fe2015-09-15 01:36:22 -04002057int SSL_CTX_set_ex_data(SSL_CTX *ctx, int idx, void *arg) {
2058 return CRYPTO_set_ex_data(&ctx->ex_data, idx, arg);
Adam Langleyfcf25832014-12-18 17:42:32 -08002059}
Adam Langley95c29f32014-06-20 12:00:00 -07002060
David Benjamin1ac08fe2015-09-15 01:36:22 -04002061void *SSL_CTX_get_ex_data(const SSL_CTX *ctx, int idx) {
2062 return CRYPTO_get_ex_data(&ctx->ex_data, idx);
Adam Langleyfcf25832014-12-18 17:42:32 -08002063}
Adam Langley95c29f32014-06-20 12:00:00 -07002064
David Benjamin93d17492015-10-17 12:43:36 -04002065int SSL_want(const SSL *ssl) { return ssl->rwstate; }
Adam Langley95c29f32014-06-20 12:00:00 -07002066
Adam Langleyfcf25832014-12-18 17:42:32 -08002067void SSL_CTX_set_tmp_rsa_callback(SSL_CTX *ctx,
2068 RSA *(*cb)(SSL *ssl, int is_export,
2069 int keylength)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002070}
Adam Langley95c29f32014-06-20 12:00:00 -07002071
Adam Langleyfcf25832014-12-18 17:42:32 -08002072void SSL_set_tmp_rsa_callback(SSL *ssl, RSA *(*cb)(SSL *ssl, int is_export,
2073 int keylength)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002074}
2075
2076void SSL_CTX_set_tmp_dh_callback(SSL_CTX *ctx,
David Benjamin59015c32015-04-26 13:13:55 -04002077 DH *(*callback)(SSL *ssl, int is_export,
2078 int keylength)) {
2079 ctx->cert->dh_tmp_cb = callback;
Adam Langleyfcf25832014-12-18 17:42:32 -08002080}
2081
David Benjamin59015c32015-04-26 13:13:55 -04002082void SSL_set_tmp_dh_callback(SSL *ssl, DH *(*callback)(SSL *ssl, int is_export,
2083 int keylength)) {
2084 ssl->cert->dh_tmp_cb = callback;
Adam Langleyfcf25832014-12-18 17:42:32 -08002085}
2086
Adam Langleyfcf25832014-12-18 17:42:32 -08002087int SSL_CTX_use_psk_identity_hint(SSL_CTX *ctx, const char *identity_hint) {
2088 if (identity_hint != NULL && strlen(identity_hint) > PSK_MAX_IDENTITY_LEN) {
David Benjamin3570d732015-06-29 00:28:17 -04002089 OPENSSL_PUT_ERROR(SSL, SSL_R_DATA_LENGTH_TOO_LONG);
Adam Langleyfcf25832014-12-18 17:42:32 -08002090 return 0;
2091 }
2092
David Benjamin2755a3e2015-04-22 16:17:58 -04002093 OPENSSL_free(ctx->psk_identity_hint);
Adam Langleyfcf25832014-12-18 17:42:32 -08002094
2095 if (identity_hint != NULL) {
2096 ctx->psk_identity_hint = BUF_strdup(identity_hint);
2097 if (ctx->psk_identity_hint == NULL) {
2098 return 0;
Adam Langley95c29f32014-06-20 12:00:00 -07002099 }
Adam Langleyfcf25832014-12-18 17:42:32 -08002100 } else {
2101 ctx->psk_identity_hint = NULL;
2102 }
Adam Langley95c29f32014-06-20 12:00:00 -07002103
Adam Langleyfcf25832014-12-18 17:42:32 -08002104 return 1;
2105}
2106
David Benjamine8814df2015-09-15 08:05:54 -04002107int SSL_use_psk_identity_hint(SSL *ssl, const char *identity_hint) {
2108 if (ssl == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002109 return 0;
2110 }
2111
2112 if (identity_hint != NULL && strlen(identity_hint) > PSK_MAX_IDENTITY_LEN) {
David Benjamin3570d732015-06-29 00:28:17 -04002113 OPENSSL_PUT_ERROR(SSL, SSL_R_DATA_LENGTH_TOO_LONG);
Adam Langleyfcf25832014-12-18 17:42:32 -08002114 return 0;
2115 }
2116
2117 /* Clear currently configured hint, if any. */
David Benjamine8814df2015-09-15 08:05:54 -04002118 OPENSSL_free(ssl->psk_identity_hint);
2119 ssl->psk_identity_hint = NULL;
Adam Langleyfcf25832014-12-18 17:42:32 -08002120
David Benjamin78679342016-09-16 19:42:05 -04002121 /* Treat the empty hint as not supplying one. Plain PSK makes it possible to
2122 * send either no hint (omit ServerKeyExchange) or an empty hint, while
2123 * ECDHE_PSK can only spell empty hint. Having different capabilities is odd,
2124 * so we interpret empty and missing as identical. */
2125 if (identity_hint != NULL && identity_hint[0] != '\0') {
David Benjamine8814df2015-09-15 08:05:54 -04002126 ssl->psk_identity_hint = BUF_strdup(identity_hint);
2127 if (ssl->psk_identity_hint == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002128 return 0;
Adam Langley95c29f32014-06-20 12:00:00 -07002129 }
Adam Langleyfcf25832014-12-18 17:42:32 -08002130 }
Adam Langley95c29f32014-06-20 12:00:00 -07002131
Adam Langleyfcf25832014-12-18 17:42:32 -08002132 return 1;
2133}
Adam Langley95c29f32014-06-20 12:00:00 -07002134
David Benjamine8814df2015-09-15 08:05:54 -04002135const char *SSL_get_psk_identity_hint(const SSL *ssl) {
2136 if (ssl == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002137 return NULL;
2138 }
David Benjamine8814df2015-09-15 08:05:54 -04002139 return ssl->psk_identity_hint;
Adam Langleyfcf25832014-12-18 17:42:32 -08002140}
Adam Langley95c29f32014-06-20 12:00:00 -07002141
David Benjamine8814df2015-09-15 08:05:54 -04002142const char *SSL_get_psk_identity(const SSL *ssl) {
Steven Valdez87eab492016-06-27 16:34:59 -04002143 if (ssl == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002144 return NULL;
2145 }
Steven Valdez87eab492016-06-27 16:34:59 -04002146 SSL_SESSION *session = SSL_get_session(ssl);
2147 if (session == NULL) {
2148 return NULL;
2149 }
2150 return session->psk_identity;
Adam Langleyfcf25832014-12-18 17:42:32 -08002151}
Adam Langley95c29f32014-06-20 12:00:00 -07002152
Adam Langleyfcf25832014-12-18 17:42:32 -08002153void SSL_set_psk_client_callback(
David Benjamine8814df2015-09-15 08:05:54 -04002154 SSL *ssl, unsigned (*cb)(SSL *ssl, const char *hint, char *identity,
2155 unsigned max_identity_len, uint8_t *psk,
2156 unsigned max_psk_len)) {
2157 ssl->psk_client_callback = cb;
Adam Langleyfcf25832014-12-18 17:42:32 -08002158}
Adam Langley95c29f32014-06-20 12:00:00 -07002159
Adam Langleyfcf25832014-12-18 17:42:32 -08002160void SSL_CTX_set_psk_client_callback(
David Benjamine8814df2015-09-15 08:05:54 -04002161 SSL_CTX *ctx, unsigned (*cb)(SSL *ssl, const char *hint, char *identity,
2162 unsigned max_identity_len, uint8_t *psk,
2163 unsigned max_psk_len)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002164 ctx->psk_client_callback = cb;
2165}
Adam Langley95c29f32014-06-20 12:00:00 -07002166
Adam Langleyfcf25832014-12-18 17:42:32 -08002167void SSL_set_psk_server_callback(
David Benjamine8814df2015-09-15 08:05:54 -04002168 SSL *ssl, unsigned (*cb)(SSL *ssl, const char *identity, uint8_t *psk,
2169 unsigned max_psk_len)) {
2170 ssl->psk_server_callback = cb;
Adam Langleyfcf25832014-12-18 17:42:32 -08002171}
Adam Langley95c29f32014-06-20 12:00:00 -07002172
Adam Langleyfcf25832014-12-18 17:42:32 -08002173void SSL_CTX_set_psk_server_callback(
David Benjamine8814df2015-09-15 08:05:54 -04002174 SSL_CTX *ctx, unsigned (*cb)(SSL *ssl, const char *identity,
2175 uint8_t *psk, unsigned max_psk_len)) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002176 ctx->psk_server_callback = cb;
2177}
Adam Langley95c29f32014-06-20 12:00:00 -07002178
Adam Langleyfcf25832014-12-18 17:42:32 -08002179void SSL_CTX_set_msg_callback(SSL_CTX *ctx,
2180 void (*cb)(int write_p, int version,
2181 int content_type, const void *buf,
2182 size_t len, SSL *ssl, void *arg)) {
David Benjamin59015c32015-04-26 13:13:55 -04002183 ctx->msg_callback = cb;
Adam Langleyfcf25832014-12-18 17:42:32 -08002184}
David Benjamin61ecccf2015-05-05 09:44:51 -04002185
2186void SSL_CTX_set_msg_callback_arg(SSL_CTX *ctx, void *arg) {
2187 ctx->msg_callback_arg = arg;
2188}
2189
Adam Langleyfcf25832014-12-18 17:42:32 -08002190void SSL_set_msg_callback(SSL *ssl,
2191 void (*cb)(int write_p, int version, int content_type,
2192 const void *buf, size_t len, SSL *ssl,
2193 void *arg)) {
David Benjamin59015c32015-04-26 13:13:55 -04002194 ssl->msg_callback = cb;
Adam Langleyfcf25832014-12-18 17:42:32 -08002195}
Adam Langley95c29f32014-06-20 12:00:00 -07002196
David Benjamin61ecccf2015-05-05 09:44:51 -04002197void SSL_set_msg_callback_arg(SSL *ssl, void *arg) {
2198 ssl->msg_callback_arg = arg;
2199}
2200
David Benjamind28f59c2015-11-17 22:32:50 -05002201void SSL_CTX_set_keylog_callback(SSL_CTX *ctx,
2202 void (*cb)(const SSL *ssl, const char *line)) {
2203 ctx->keylog_callback = cb;
Adam Langleyfcf25832014-12-18 17:42:32 -08002204}
Adam Langley95c29f32014-06-20 12:00:00 -07002205
David Benjamin6e3f5cc2016-09-14 14:43:14 -04002206void (*SSL_CTX_get_keylog_callback(const SSL_CTX *ctx))(const SSL *ssl,
2207 const char *line) {
2208 return ctx->keylog_callback;
2209}
2210
Taylor Brandstetter9edb2c62016-06-08 15:26:59 -07002211void SSL_CTX_set_current_time_cb(SSL_CTX *ctx,
2212 void (*cb)(const SSL *ssl,
2213 struct timeval *out_clock)) {
2214 ctx->current_time_cb = cb;
2215}
2216
Adam Langleyfcf25832014-12-18 17:42:32 -08002217static int cbb_add_hex(CBB *cbb, const uint8_t *in, size_t in_len) {
2218 static const char hextable[] = "0123456789abcdef";
2219 uint8_t *out;
Adam Langley95c29f32014-06-20 12:00:00 -07002220
Adam Langleyfcf25832014-12-18 17:42:32 -08002221 if (!CBB_add_space(cbb, &out, in_len * 2)) {
2222 return 0;
2223 }
Adam Langley95c29f32014-06-20 12:00:00 -07002224
David Benjamin54091232016-09-05 12:47:25 -04002225 for (size_t i = 0; i < in_len; i++) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002226 *(out++) = (uint8_t)hextable[in[i] >> 4];
2227 *(out++) = (uint8_t)hextable[in[i] & 0xf];
2228 }
Adam Langley95c29f32014-06-20 12:00:00 -07002229
Adam Langleyfcf25832014-12-18 17:42:32 -08002230 return 1;
2231}
David Benjamin859ec3c2014-09-02 16:29:36 -04002232
David Benjamine776cc22016-07-19 07:26:49 +02002233int ssl_log_secret(const SSL *ssl, const char *label, const uint8_t *secret,
2234 size_t secret_len) {
David Benjamind28f59c2015-11-17 22:32:50 -05002235 if (ssl->ctx->keylog_callback == NULL) {
Adam Langleyfcf25832014-12-18 17:42:32 -08002236 return 1;
2237 }
Adam Langleyadb739e2014-06-20 12:00:00 -07002238
David Benjamind28f59c2015-11-17 22:32:50 -05002239 CBB cbb;
2240 uint8_t *out;
2241 size_t out_len;
David Benjamine776cc22016-07-19 07:26:49 +02002242 if (!CBB_init(&cbb, strlen(label) + 1 + SSL3_RANDOM_SIZE * 2 + 1 +
2243 secret_len * 2 + 1) ||
2244 !CBB_add_bytes(&cbb, (const uint8_t *)label, strlen(label)) ||
Adam Langleyfcf25832014-12-18 17:42:32 -08002245 !CBB_add_bytes(&cbb, (const uint8_t *)" ", 1) ||
David Benjamine776cc22016-07-19 07:26:49 +02002246 !cbb_add_hex(&cbb, ssl->s3->client_random, SSL3_RANDOM_SIZE) ||
2247 !CBB_add_bytes(&cbb, (const uint8_t *)" ", 1) ||
2248 !cbb_add_hex(&cbb, secret, secret_len) ||
David Benjamind28f59c2015-11-17 22:32:50 -05002249 !CBB_add_u8(&cbb, 0 /* NUL */) ||
Adam Langleyfcf25832014-12-18 17:42:32 -08002250 !CBB_finish(&cbb, &out, &out_len)) {
2251 CBB_cleanup(&cbb);
2252 return 0;
2253 }
Adam Langleyadb739e2014-06-20 12:00:00 -07002254
David Benjamind28f59c2015-11-17 22:32:50 -05002255 ssl->ctx->keylog_callback(ssl, (const char *)out);
Adam Langleyfcf25832014-12-18 17:42:32 -08002256 OPENSSL_free(out);
David Benjamind28f59c2015-11-17 22:32:50 -05002257 return 1;
Adam Langley95c29f32014-06-20 12:00:00 -07002258}
2259
David Benjamin5d8b1282015-10-17 23:26:35 -04002260int SSL_is_init_finished(const SSL *ssl) {
David Benjamin9e766d72017-02-10 23:14:17 -05002261 return !SSL_in_init(ssl);
David Benjamin5d8b1282015-10-17 23:26:35 -04002262}
2263
2264int SSL_in_init(const SSL *ssl) {
David Benjamin9e766d72017-02-10 23:14:17 -05002265 SSL_HANDSHAKE *hs = ssl->s3->hs;
2266 return hs != NULL && hs->state != SSL_ST_OK;
David Benjamin5d8b1282015-10-17 23:26:35 -04002267}
2268
2269int SSL_in_false_start(const SSL *ssl) {
David Benjamina0486782016-10-06 19:11:32 -04002270 if (ssl->s3->hs == NULL) {
2271 return 0;
2272 }
2273 return ssl->s3->hs->in_false_start;
David Benjamined7c4752015-02-16 19:16:46 -05002274}
2275
David Benjamin0d56f882015-12-19 17:05:56 -05002276int SSL_cutthrough_complete(const SSL *ssl) {
2277 return SSL_in_false_start(ssl);
Adam Langleyfcf25832014-12-18 17:42:32 -08002278}
Adam Langley95c29f32014-06-20 12:00:00 -07002279
Adam Langleyfcf25832014-12-18 17:42:32 -08002280void SSL_get_structure_sizes(size_t *ssl_size, size_t *ssl_ctx_size,
2281 size_t *ssl_session_size) {
2282 *ssl_size = sizeof(SSL);
2283 *ssl_ctx_size = sizeof(SSL_CTX);
2284 *ssl_session_size = sizeof(SSL_SESSION);
2285}
Feng Lu41aa3252014-11-21 22:47:56 -08002286
David Benjamin0d56f882015-12-19 17:05:56 -05002287int ssl3_can_false_start(const SSL *ssl) {
2288 const SSL_CIPHER *const cipher = SSL_get_current_cipher(ssl);
Adam Langleyfcf25832014-12-18 17:42:32 -08002289
Adam Langleye631d962015-04-01 13:11:01 -07002290 /* False Start only for TLS 1.2 with an ECDHE+AEAD cipher and ALPN or NPN. */
David Benjamince079fd2016-08-02 16:22:34 -04002291 return !SSL_is_dtls(ssl) &&
Steven Valdez4f94b1c2016-05-24 12:31:07 -04002292 SSL_version(ssl) == TLS1_2_VERSION &&
David Benjaminb74b0812016-10-06 19:43:48 -04002293 (ssl->s3->alpn_selected != NULL ||
2294 ssl->s3->next_proto_negotiated != NULL) &&
David Benjamin195dc782015-02-19 13:27:05 -05002295 cipher != NULL &&
Matthew Braithwaite651aaef2016-12-08 16:14:36 -08002296 cipher->algorithm_mkey == SSL_kECDHE &&
David Benjamin13414b32015-12-09 23:02:39 -05002297 cipher->algorithm_mac == SSL_AEAD;
Adam Langleyfcf25832014-12-18 17:42:32 -08002298}
2299
David Benjaminb6a0a512016-06-21 10:33:21 -04002300const struct {
2301 uint16_t version;
2302 uint32_t flag;
2303} kVersions[] = {
2304 {SSL3_VERSION, SSL_OP_NO_SSLv3},
2305 {TLS1_VERSION, SSL_OP_NO_TLSv1},
2306 {TLS1_1_VERSION, SSL_OP_NO_TLSv1_1},
2307 {TLS1_2_VERSION, SSL_OP_NO_TLSv1_2},
2308 {TLS1_3_VERSION, SSL_OP_NO_TLSv1_3},
2309};
Adam Langleyfcf25832014-12-18 17:42:32 -08002310
Steven Valdezcb966542016-08-17 16:56:14 -04002311static const size_t kVersionsLen = OPENSSL_ARRAY_SIZE(kVersions);
Adam Langleyfcf25832014-12-18 17:42:32 -08002312
David Benjamine0ff7672016-09-19 18:40:03 -04002313int ssl_get_version_range(const SSL *ssl, uint16_t *out_min_version,
2314 uint16_t *out_max_version) {
David Benjaminb6a0a512016-06-21 10:33:21 -04002315 /* For historical reasons, |SSL_OP_NO_DTLSv1| aliases |SSL_OP_NO_TLSv1|, but
2316 * DTLS 1.0 should be mapped to TLS 1.1. */
David Benjamin0d56f882015-12-19 17:05:56 -05002317 uint32_t options = ssl->options;
David Benjamince079fd2016-08-02 16:22:34 -04002318 if (SSL_is_dtls(ssl)) {
David Benjaminb6a0a512016-06-21 10:33:21 -04002319 options &= ~SSL_OP_NO_TLSv1_1;
2320 if (options & SSL_OP_NO_DTLSv1) {
2321 options |= SSL_OP_NO_TLSv1_1;
2322 }
2323 }
2324
2325 uint16_t min_version = ssl->min_version;
2326 uint16_t max_version = ssl->max_version;
2327
2328 /* Bound the range to only those implemented in this protocol. */
2329 if (min_version < ssl->method->min_version) {
2330 min_version = ssl->method->min_version;
2331 }
2332 if (max_version > ssl->method->max_version) {
2333 max_version = ssl->method->max_version;
2334 }
Adam Langleyfcf25832014-12-18 17:42:32 -08002335
2336 /* OpenSSL's API for controlling versions entails blacklisting individual
2337 * protocols. This has two problems. First, on the client, the protocol can
2338 * only express a contiguous range of versions. Second, a library consumer
2339 * trying to set a maximum version cannot disable protocol versions that get
2340 * added in a future version of the library.
2341 *
2342 * To account for both of these, OpenSSL interprets the client-side bitmask
2343 * as a min/max range by picking the lowest contiguous non-empty range of
2344 * enabled protocols. Note that this means it is impossible to set a maximum
David Benjaminb6a0a512016-06-21 10:33:21 -04002345 * version of the higest supported TLS version in a future-proof way. */
David Benjaminb6a0a512016-06-21 10:33:21 -04002346 int any_enabled = 0;
David Benjamin54091232016-09-05 12:47:25 -04002347 for (size_t i = 0; i < kVersionsLen; i++) {
David Benjaminb6a0a512016-06-21 10:33:21 -04002348 /* Only look at the versions already enabled. */
2349 if (min_version > kVersions[i].version) {
2350 continue;
Adam Langleyfcf25832014-12-18 17:42:32 -08002351 }
David Benjaminb6a0a512016-06-21 10:33:21 -04002352 if (max_version < kVersions[i].version) {
2353 break;
Adam Langleyfcf25832014-12-18 17:42:32 -08002354 }
David Benjaminb6a0a512016-06-21 10:33:21 -04002355
2356 if (!(options & kVersions[i].flag)) {
2357 /* The minimum version is the first enabled version. */
2358 if (!any_enabled) {
2359 any_enabled = 1;
2360 min_version = kVersions[i].version;
2361 }
2362 continue;
Adam Langleyfcf25832014-12-18 17:42:32 -08002363 }
David Benjaminb6a0a512016-06-21 10:33:21 -04002364
2365 /* If there is a disabled version after the first enabled one, all versions
2366 * after it are implicitly disabled. */
2367 if (any_enabled) {
2368 max_version = kVersions[i-1].version;
2369 break;
Adam Langleyfcf25832014-12-18 17:42:32 -08002370 }
2371 }
2372
David Benjamine0ff7672016-09-19 18:40:03 -04002373 if (!any_enabled) {
David Benjaminb6a0a512016-06-21 10:33:21 -04002374 OPENSSL_PUT_ERROR(SSL, SSL_R_WRONG_SSL_VERSION);
2375 return 0;
David Benjaminea72bd02014-12-21 21:27:41 -05002376 }
2377
David Benjaminb6a0a512016-06-21 10:33:21 -04002378 *out_min_version = min_version;
2379 *out_max_version = max_version;
2380 return 1;
David Benjaminea72bd02014-12-21 21:27:41 -05002381}
2382
David Benjaminb9e4fa52015-12-29 23:58:17 -05002383uint16_t ssl3_protocol_version(const SSL *ssl) {
2384 assert(ssl->s3->have_version);
David Benjamin2dc02042016-09-19 19:57:37 -04002385 uint16_t version;
2386 if (!ssl->method->version_from_wire(&version, ssl->version)) {
2387 /* TODO(davidben): Use the internal version representation for ssl->version
2388 * and map to the public API representation at API boundaries. */
2389 assert(0);
2390 return 0;
2391 }
2392
2393 return version;
David Benjaminb9e4fa52015-12-29 23:58:17 -05002394}
2395
David Benjamince079fd2016-08-02 16:22:34 -04002396int SSL_is_server(const SSL *ssl) { return ssl->server; }
2397
2398int SSL_is_dtls(const SSL *ssl) { return ssl->method->is_dtls; }
Adam Langleyfcf25832014-12-18 17:42:32 -08002399
David Benjamin731058e2016-12-03 23:15:13 -05002400void SSL_CTX_set_select_certificate_cb(SSL_CTX *ctx,
2401 int (*cb)(const SSL_CLIENT_HELLO *)) {
David Benjamind4c2bce2015-10-17 12:28:18 -04002402 ctx->select_certificate_cb = cb;
2403}
2404
David Benjamin731058e2016-12-03 23:15:13 -05002405void SSL_CTX_set_dos_protection_cb(SSL_CTX *ctx,
2406 int (*cb)(const SSL_CLIENT_HELLO *)) {
Adam Langley524e7172015-02-20 16:04:00 -08002407 ctx->dos_protection_cb = cb;
2408}
2409
David Benjamin1d5ef3b2015-10-12 19:54:18 -04002410void SSL_set_renegotiate_mode(SSL *ssl, enum ssl_renegotiate_mode_t mode) {
2411 ssl->renegotiate_mode = mode;
2412}
2413
Adam Langleyc2d32802015-11-03 18:36:10 -08002414int SSL_get_ivs(const SSL *ssl, const uint8_t **out_read_iv,
2415 const uint8_t **out_write_iv, size_t *out_iv_len) {
David Benjamin79978df2015-12-25 15:56:49 -05002416 if (ssl->s3->aead_read_ctx == NULL || ssl->s3->aead_write_ctx == NULL) {
Adam Langleyc2d32802015-11-03 18:36:10 -08002417 return 0;
2418 }
2419
2420 size_t write_iv_len;
David Benjamin79978df2015-12-25 15:56:49 -05002421 if (!EVP_AEAD_CTX_get_iv(&ssl->s3->aead_read_ctx->ctx, out_read_iv,
2422 out_iv_len) ||
2423 !EVP_AEAD_CTX_get_iv(&ssl->s3->aead_write_ctx->ctx, out_write_iv,
Adam Langleyc2d32802015-11-03 18:36:10 -08002424 &write_iv_len) ||
2425 *out_iv_len != write_iv_len) {
2426 return 0;
2427 }
2428
2429 return 1;
David Benjamine348ff42015-11-06 17:55:30 -05002430}
David Benjamin6e807652015-11-02 12:02:20 -05002431
David Benjamin91b25012016-01-21 16:39:58 -05002432static uint64_t be_to_u64(const uint8_t in[8]) {
David Benjaminde942382016-02-11 12:02:01 -05002433 return (((uint64_t)in[0]) << 56) | (((uint64_t)in[1]) << 48) |
2434 (((uint64_t)in[2]) << 40) | (((uint64_t)in[3]) << 32) |
2435 (((uint64_t)in[4]) << 24) | (((uint64_t)in[5]) << 16) |
2436 (((uint64_t)in[6]) << 8) | ((uint64_t)in[7]);
David Benjamin91b25012016-01-21 16:39:58 -05002437}
2438
2439uint64_t SSL_get_read_sequence(const SSL *ssl) {
2440 /* TODO(davidben): Internally represent sequence numbers as uint64_t. */
David Benjamince079fd2016-08-02 16:22:34 -04002441 if (SSL_is_dtls(ssl)) {
David Benjaminde942382016-02-11 12:02:01 -05002442 /* max_seq_num already includes the epoch. */
2443 assert(ssl->d1->r_epoch == (ssl->d1->bitmap.max_seq_num >> 48));
2444 return ssl->d1->bitmap.max_seq_num;
2445 }
David Benjamin91b25012016-01-21 16:39:58 -05002446 return be_to_u64(ssl->s3->read_sequence);
2447}
2448
2449uint64_t SSL_get_write_sequence(const SSL *ssl) {
David Benjaminde942382016-02-11 12:02:01 -05002450 uint64_t ret = be_to_u64(ssl->s3->write_sequence);
David Benjamince079fd2016-08-02 16:22:34 -04002451 if (SSL_is_dtls(ssl)) {
David Benjaminde942382016-02-11 12:02:01 -05002452 assert((ret >> 48) == 0);
2453 ret |= ((uint64_t)ssl->d1->w_epoch) << 48;
2454 }
2455 return ret;
David Benjamin91b25012016-01-21 16:39:58 -05002456}
2457
Steven Valdez02563852016-06-23 13:33:05 -04002458uint16_t SSL_get_peer_signature_algorithm(const SSL *ssl) {
David Benjaminf1050fd2016-12-13 20:05:36 -05002459 /* TODO(davidben): This checks the wrong session if there is a renegotiation
2460 * in progress. */
2461 SSL_SESSION *session = SSL_get_session(ssl);
2462 if (session == NULL) {
2463 return 0;
2464 }
2465
2466 return session->peer_signature_algorithm;
Steven Valdez02563852016-06-23 13:33:05 -04002467}
2468
David Benjamin96ba15f2015-12-25 14:10:17 -05002469size_t SSL_get_client_random(const SSL *ssl, uint8_t *out, size_t max_out) {
2470 if (max_out == 0) {
2471 return sizeof(ssl->s3->client_random);
2472 }
2473 if (max_out > sizeof(ssl->s3->client_random)) {
2474 max_out = sizeof(ssl->s3->client_random);
2475 }
David Benjamin17cf2cb2016-12-13 01:07:13 -05002476 OPENSSL_memcpy(out, ssl->s3->client_random, max_out);
David Benjamin96ba15f2015-12-25 14:10:17 -05002477 return max_out;
2478}
2479
2480size_t SSL_get_server_random(const SSL *ssl, uint8_t *out, size_t max_out) {
2481 if (max_out == 0) {
2482 return sizeof(ssl->s3->server_random);
2483 }
2484 if (max_out > sizeof(ssl->s3->server_random)) {
2485 max_out = sizeof(ssl->s3->server_random);
2486 }
David Benjamin17cf2cb2016-12-13 01:07:13 -05002487 OPENSSL_memcpy(out, ssl->s3->server_random, max_out);
David Benjamin96ba15f2015-12-25 14:10:17 -05002488 return max_out;
2489}
2490
David Benjaminf6494f42016-01-07 12:37:41 -08002491const SSL_CIPHER *SSL_get_pending_cipher(const SSL *ssl) {
David Benjamin45738dd2017-02-09 20:01:26 -05002492 SSL_HANDSHAKE *hs = ssl->s3->hs;
2493 if (hs == NULL) {
David Benjaminf6494f42016-01-07 12:37:41 -08002494 return NULL;
2495 }
David Benjamin45738dd2017-02-09 20:01:26 -05002496 return hs->new_cipher;
David Benjaminf6494f42016-01-07 12:37:41 -08002497}
2498
David Benjaminbbaf3672016-11-17 10:53:09 +09002499void SSL_set_retain_only_sha256_of_client_certs(SSL *ssl, int enabled) {
2500 ssl->retain_only_sha256_of_client_certs = !!enabled;
2501}
2502
David Benjamincdd0b7e2016-01-07 10:10:41 -08002503void SSL_CTX_set_retain_only_sha256_of_client_certs(SSL_CTX *ctx, int enabled) {
2504 ctx->retain_only_sha256_of_client_certs = !!enabled;
2505}
2506
David Benjamin65ac9972016-09-02 21:35:25 -04002507void SSL_CTX_set_grease_enabled(SSL_CTX *ctx, int enabled) {
2508 ctx->grease_enabled = !!enabled;
2509}
2510
David Benjamin35ac5b72017-03-03 15:05:56 -05002511int32_t SSL_get_ticket_age_skew(const SSL *ssl) {
2512 return ssl->s3->ticket_age_skew;
2513}
2514
David Benjamin27bbae42015-09-13 00:54:37 -04002515int SSL_clear(SSL *ssl) {
David Benjaminb79cc842016-12-07 15:57:14 -05002516 /* In OpenSSL, reusing a client |SSL| with |SSL_clear| causes the previously
2517 * established session to be offered the next time around. wpa_supplicant
2518 * depends on this behavior, so emulate it. */
2519 SSL_SESSION *session = NULL;
2520 if (!ssl->server && ssl->s3->established_session != NULL) {
2521 session = ssl->s3->established_session;
2522 SSL_SESSION_up_ref(session);
2523 }
2524
David Benjamin27bbae42015-09-13 00:54:37 -04002525 /* TODO(davidben): Some state on |ssl| is reset both in |SSL_new| and
2526 * |SSL_clear| because it is per-connection state rather than configuration
2527 * state. Per-connection state should be on |ssl->s3| and |ssl->d1| so it is
2528 * naturally reset at the right points between |SSL_new|, |SSL_clear|, and
2529 * |ssl3_new|. */
2530
2531 ssl->rwstate = SSL_NOTHING;
2532
2533 BUF_MEM_free(ssl->init_buf);
2534 ssl->init_buf = NULL;
David Benjamin49054542016-07-27 13:51:01 -04002535 ssl->init_msg = NULL;
2536 ssl->init_num = 0;
David Benjamin27bbae42015-09-13 00:54:37 -04002537
David Benjamin27bbae42015-09-13 00:54:37 -04002538 /* The ssl->d1->mtu is simultaneously configuration (preserved across
2539 * clear) and connection-specific state (gets reset).
2540 *
2541 * TODO(davidben): Avoid this. */
2542 unsigned mtu = 0;
2543 if (ssl->d1 != NULL) {
2544 mtu = ssl->d1->mtu;
2545 }
2546
2547 ssl->method->ssl_free(ssl);
2548 if (!ssl->method->ssl_new(ssl)) {
David Benjaminb79cc842016-12-07 15:57:14 -05002549 SSL_SESSION_free(session);
David Benjamin27bbae42015-09-13 00:54:37 -04002550 return 0;
2551 }
David Benjamin27bbae42015-09-13 00:54:37 -04002552
David Benjamince079fd2016-08-02 16:22:34 -04002553 if (SSL_is_dtls(ssl) && (SSL_get_options(ssl) & SSL_OP_NO_QUERY_MTU)) {
David Benjamin27bbae42015-09-13 00:54:37 -04002554 ssl->d1->mtu = mtu;
2555 }
2556
David Benjaminb79cc842016-12-07 15:57:14 -05002557 if (session != NULL) {
2558 SSL_set_session(ssl, session);
2559 SSL_SESSION_free(session);
2560 }
2561
David Benjamin27bbae42015-09-13 00:54:37 -04002562 return 1;
2563}
2564
David Benjamin4e9cc712016-06-01 20:16:03 -04002565void ssl_do_info_callback(const SSL *ssl, int type, int value) {
2566 void (*cb)(const SSL *ssl, int type, int value) = NULL;
2567 if (ssl->info_callback != NULL) {
2568 cb = ssl->info_callback;
2569 } else if (ssl->ctx->info_callback != NULL) {
2570 cb = ssl->ctx->info_callback;
2571 }
2572
2573 if (cb != NULL) {
2574 cb(ssl, type, value);
2575 }
2576}
2577
David Benjaminc0279992016-09-19 20:15:07 -04002578void ssl_do_msg_callback(SSL *ssl, int is_write, int content_type,
David Benjamin4e9cc712016-06-01 20:16:03 -04002579 const void *buf, size_t len) {
David Benjaminc0279992016-09-19 20:15:07 -04002580 if (ssl->msg_callback == NULL) {
2581 return;
David Benjamin4e9cc712016-06-01 20:16:03 -04002582 }
David Benjaminc0279992016-09-19 20:15:07 -04002583
2584 /* |version| is zero when calling for |SSL3_RT_HEADER| and |SSL2_VERSION| for
2585 * a V2ClientHello. */
2586 int version;
2587 switch (content_type) {
2588 case 0:
2589 /* V2ClientHello */
2590 version = SSL2_VERSION;
2591 break;
2592 case SSL3_RT_HEADER:
2593 version = 0;
2594 break;
2595 default:
Steven Valdezfdd10992016-09-15 16:27:05 -04002596 version = SSL_version(ssl);
David Benjaminc0279992016-09-19 20:15:07 -04002597 }
2598
2599 ssl->msg_callback(is_write, version, content_type, buf, len, ssl,
2600 ssl->msg_callback_arg);
David Benjamin4e9cc712016-06-01 20:16:03 -04002601}
2602
David Benjaminda881e92015-04-26 14:45:04 -04002603int SSL_CTX_sess_connect(const SSL_CTX *ctx) { return 0; }
2604int SSL_CTX_sess_connect_good(const SSL_CTX *ctx) { return 0; }
2605int SSL_CTX_sess_connect_renegotiate(const SSL_CTX *ctx) { return 0; }
2606int SSL_CTX_sess_accept(const SSL_CTX *ctx) { return 0; }
2607int SSL_CTX_sess_accept_renegotiate(const SSL_CTX *ctx) { return 0; }
2608int SSL_CTX_sess_accept_good(const SSL_CTX *ctx) { return 0; }
2609int SSL_CTX_sess_hits(const SSL_CTX *ctx) { return 0; }
2610int SSL_CTX_sess_cb_hits(const SSL_CTX *ctx) { return 0; }
2611int SSL_CTX_sess_misses(const SSL_CTX *ctx) { return 0; }
2612int SSL_CTX_sess_timeouts(const SSL_CTX *ctx) { return 0; }
2613int SSL_CTX_sess_cache_full(const SSL_CTX *ctx) { return 0; }
David Benjamin936aada2016-06-07 19:09:22 -04002614
2615int SSL_num_renegotiations(const SSL *ssl) {
2616 return SSL_total_renegotiations(ssl);
2617}
2618
2619int SSL_CTX_need_tmp_RSA(const SSL_CTX *ctx) { return 0; }
2620int SSL_need_tmp_RSA(const SSL *ssl) { return 0; }
2621int SSL_CTX_set_tmp_rsa(SSL_CTX *ctx, const RSA *rsa) { return 1; }
2622int SSL_set_tmp_rsa(SSL *ssl, const RSA *rsa) { return 1; }
Matt Braithwaite4838d8a2015-08-20 13:20:03 -07002623void ERR_load_SSL_strings(void) {}
David Benjamin27bbae42015-09-13 00:54:37 -04002624void SSL_load_error_strings(void) {}
David Benjamin936aada2016-06-07 19:09:22 -04002625int SSL_cache_hit(SSL *ssl) { return SSL_session_reused(ssl); }
2626
2627int SSL_CTX_set_tmp_ecdh(SSL_CTX *ctx, const EC_KEY *ec_key) {
2628 if (ec_key == NULL || EC_KEY_get0_group(ec_key) == NULL) {
2629 OPENSSL_PUT_ERROR(SSL, ERR_R_PASSED_NULL_PARAMETER);
2630 return 0;
2631 }
2632 int nid = EC_GROUP_get_curve_name(EC_KEY_get0_group(ec_key));
2633 return SSL_CTX_set1_curves(ctx, &nid, 1);
2634}
2635
2636int SSL_set_tmp_ecdh(SSL *ssl, const EC_KEY *ec_key) {
2637 if (ec_key == NULL || EC_KEY_get0_group(ec_key) == NULL) {
2638 OPENSSL_PUT_ERROR(SSL, ERR_R_PASSED_NULL_PARAMETER);
2639 return 0;
2640 }
2641 int nid = EC_GROUP_get_curve_name(EC_KEY_get0_group(ec_key));
2642 return SSL_set1_curves(ssl, &nid, 1);
2643}
David Benjamin721e8b72016-08-03 13:13:17 -04002644
David Benjaminad8f5e12017-02-20 17:00:20 -05002645void ssl_get_current_time(const SSL *ssl, struct OPENSSL_timeval *out_clock) {
David Benjamin721e8b72016-08-03 13:13:17 -04002646 if (ssl->ctx->current_time_cb != NULL) {
David Benjaminad8f5e12017-02-20 17:00:20 -05002647 /* TODO(davidben): Update current_time_cb to use OPENSSL_timeval. See
2648 * https://crbug.com/boringssl/155. */
2649 struct timeval clock;
2650 ssl->ctx->current_time_cb(ssl, &clock);
2651 if (clock.tv_sec < 0) {
2652 assert(0);
2653 out_clock->tv_sec = 0;
2654 out_clock->tv_usec = 0;
2655 } else {
2656 out_clock->tv_sec = (uint64_t)clock.tv_sec;
2657 out_clock->tv_usec = (uint32_t)clock.tv_usec;
2658 }
David Benjamin721e8b72016-08-03 13:13:17 -04002659 return;
2660 }
2661
David Benjaminec978dd2016-11-04 18:59:33 -04002662#if defined(BORINGSSL_UNSAFE_DETERMINISTIC_MODE)
David Benjamin01a90572016-09-22 00:11:43 -04002663 out_clock->tv_sec = 1234;
2664 out_clock->tv_usec = 1234;
2665#elif defined(OPENSSL_WINDOWS)
David Benjamin721e8b72016-08-03 13:13:17 -04002666 struct _timeb time;
2667 _ftime(&time);
David Benjaminad8f5e12017-02-20 17:00:20 -05002668 if (time.time < 0) {
2669 assert(0);
2670 out_clock->tv_sec = 0;
2671 out_clock->tv_usec = 0;
2672 } else {
2673 out_clock->tv_sec = time.time;
2674 out_clock->tv_usec = time.millitm * 1000;
2675 }
David Benjamin721e8b72016-08-03 13:13:17 -04002676#else
David Benjaminad8f5e12017-02-20 17:00:20 -05002677 struct timeval clock;
2678 gettimeofday(&clock, NULL);
2679 if (clock.tv_sec < 0) {
2680 assert(0);
2681 out_clock->tv_sec = 0;
2682 out_clock->tv_usec = 0;
2683 } else {
2684 out_clock->tv_sec = (uint64_t)clock.tv_sec;
2685 out_clock->tv_usec = (uint32_t)clock.tv_usec;
2686 }
David Benjamin721e8b72016-08-03 13:13:17 -04002687#endif
2688}
David Benjamine4706902016-09-20 15:12:23 -04002689
2690int SSL_CTX_set_min_version(SSL_CTX *ctx, uint16_t version) {
2691 return SSL_CTX_set_min_proto_version(ctx, version);
2692}
2693
2694int SSL_CTX_set_max_version(SSL_CTX *ctx, uint16_t version) {
2695 return SSL_CTX_set_max_proto_version(ctx, version);
2696}
2697
2698int SSL_set_min_version(SSL *ssl, uint16_t version) {
2699 return SSL_set_min_proto_version(ssl, version);
2700}
2701
2702int SSL_set_max_version(SSL *ssl, uint16_t version) {
2703 return SSL_set_max_proto_version(ssl, version);
2704}
Adam Langley4c341d02017-03-08 19:33:21 -08002705
2706void SSL_CTX_set_ticket_aead_method(SSL_CTX *ctx,
2707 const SSL_TICKET_AEAD_METHOD *aead_method) {
2708 ctx->ticket_aead_method = aead_method;
2709}