1 /* 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
141 #include <openssl/ssl.h>
142
143 #include <assert.h>
144 #include <stdlib.h>
145 #include <string.h>
146
147 #include <openssl/bytestring.h>
148 #include <openssl/crypto.h>
149 #include <openssl/err.h>
150 #include <openssl/lhash.h>
151 #include <openssl/mem.h>
152 #include <openssl/rand.h>
153
154 #include "internal.h"
155 #include "../crypto/internal.h"
156
157 #if defined(OPENSSL_WINDOWS)
158 #include <sys/timeb.h>
159 #else
160 #include <sys/socket.h>
161 #include <sys/time.h>
162 #endif
163
164
165 BSSL_NAMESPACE_BEGIN
166
167 // |SSL_R_UNKNOWN_PROTOCOL| is no longer emitted, but continue to define it
168 // to avoid downstream churn.
169 OPENSSL_DECLARE_ERROR_REASON(SSL, UNKNOWN_PROTOCOL)
170
171 // The following errors are no longer emitted, but are used in nginx without
172 // #ifdefs.
173 OPENSSL_DECLARE_ERROR_REASON(SSL, BLOCK_CIPHER_PAD_IS_WRONG)
174 OPENSSL_DECLARE_ERROR_REASON(SSL, NO_CIPHERS_SPECIFIED)
175
176 // Some error codes are special. Ensure the make_errors.go script never
177 // regresses this.
178 static_assert(SSL_R_TLSV1_ALERT_NO_RENEGOTIATION ==
179 SSL_AD_NO_RENEGOTIATION + SSL_AD_REASON_OFFSET,
180 "alert reason code mismatch");
181
182 // kMaxHandshakeSize is the maximum size, in bytes, of a handshake message.
183 static const size_t kMaxHandshakeSize = (1u << 24) - 1;
184
185 static CRYPTO_EX_DATA_CLASS g_ex_data_class_ssl =
186 CRYPTO_EX_DATA_CLASS_INIT_WITH_APP_DATA;
187 static CRYPTO_EX_DATA_CLASS g_ex_data_class_ssl_ctx =
188 CRYPTO_EX_DATA_CLASS_INIT_WITH_APP_DATA;
189
CBBFinishArray(CBB * cbb,Array<uint8_t> * out)190 bool CBBFinishArray(CBB *cbb, Array<uint8_t> *out) {
191 uint8_t *ptr;
192 size_t len;
193 if (!CBB_finish(cbb, &ptr, &len)) {
194 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
195 return false;
196 }
197 out->Reset(ptr, len);
198 return true;
199 }
200
ssl_reset_error_state(SSL * ssl)201 void ssl_reset_error_state(SSL *ssl) {
202 // Functions which use |SSL_get_error| must reset I/O and error state on
203 // entry.
204 ssl->s3->rwstate = SSL_ERROR_NONE;
205 ERR_clear_error();
206 ERR_clear_system_error();
207 }
208
ssl_set_read_error(SSL * ssl)209 void ssl_set_read_error(SSL* ssl) {
210 ssl->s3->read_shutdown = ssl_shutdown_error;
211 ssl->s3->read_error.reset(ERR_save_state());
212 }
213
check_read_error(const SSL * ssl)214 static bool check_read_error(const SSL *ssl) {
215 if (ssl->s3->read_shutdown == ssl_shutdown_error) {
216 ERR_restore_state(ssl->s3->read_error.get());
217 return false;
218 }
219 return true;
220 }
221
ssl_can_write(const SSL * ssl)222 bool ssl_can_write(const SSL *ssl) {
223 return !SSL_in_init(ssl) || ssl->s3->hs->can_early_write;
224 }
225
ssl_can_read(const SSL * ssl)226 bool ssl_can_read(const SSL *ssl) {
227 return !SSL_in_init(ssl) || ssl->s3->hs->can_early_read;
228 }
229
ssl_open_handshake(SSL * ssl,size_t * out_consumed,uint8_t * out_alert,Span<uint8_t> in)230 ssl_open_record_t ssl_open_handshake(SSL *ssl, size_t *out_consumed,
231 uint8_t *out_alert, Span<uint8_t> in) {
232 *out_consumed = 0;
233 if (!check_read_error(ssl)) {
234 *out_alert = 0;
235 return ssl_open_record_error;
236 }
237 auto ret = ssl->method->open_handshake(ssl, out_consumed, out_alert, in);
238 if (ret == ssl_open_record_error) {
239 ssl_set_read_error(ssl);
240 }
241 return ret;
242 }
243
ssl_open_change_cipher_spec(SSL * ssl,size_t * out_consumed,uint8_t * out_alert,Span<uint8_t> in)244 ssl_open_record_t ssl_open_change_cipher_spec(SSL *ssl, size_t *out_consumed,
245 uint8_t *out_alert,
246 Span<uint8_t> in) {
247 *out_consumed = 0;
248 if (!check_read_error(ssl)) {
249 *out_alert = 0;
250 return ssl_open_record_error;
251 }
252 auto ret =
253 ssl->method->open_change_cipher_spec(ssl, out_consumed, out_alert, in);
254 if (ret == ssl_open_record_error) {
255 ssl_set_read_error(ssl);
256 }
257 return ret;
258 }
259
ssl_open_app_data(SSL * ssl,Span<uint8_t> * out,size_t * out_consumed,uint8_t * out_alert,Span<uint8_t> in)260 ssl_open_record_t ssl_open_app_data(SSL *ssl, Span<uint8_t> *out,
261 size_t *out_consumed, uint8_t *out_alert,
262 Span<uint8_t> in) {
263 *out_consumed = 0;
264 if (!check_read_error(ssl)) {
265 *out_alert = 0;
266 return ssl_open_record_error;
267 }
268 auto ret = ssl->method->open_app_data(ssl, out, out_consumed, out_alert, in);
269 if (ret == ssl_open_record_error) {
270 ssl_set_read_error(ssl);
271 }
272 return ret;
273 }
274
ssl_update_cache(SSL_HANDSHAKE * hs,int mode)275 void ssl_update_cache(SSL_HANDSHAKE *hs, int mode) {
276 SSL *const ssl = hs->ssl;
277 SSL_CTX *ctx = ssl->session_ctx.get();
278 // Never cache sessions with empty session IDs.
279 if (ssl->s3->established_session->session_id_length == 0 ||
280 ssl->s3->established_session->not_resumable ||
281 (ctx->session_cache_mode & mode) != mode) {
282 return;
283 }
284
285 // Clients never use the internal session cache.
286 int use_internal_cache = ssl->server && !(ctx->session_cache_mode &
287 SSL_SESS_CACHE_NO_INTERNAL_STORE);
288
289 // A client may see new sessions on abbreviated handshakes if the server
290 // decides to renew the ticket. Once the handshake is completed, it should be
291 // inserted into the cache.
292 if (ssl->s3->established_session.get() != ssl->session.get() ||
293 (!ssl->server && hs->ticket_expected)) {
294 if (use_internal_cache) {
295 SSL_CTX_add_session(ctx, ssl->s3->established_session.get());
296 }
297 if (ctx->new_session_cb != NULL) {
298 UniquePtr<SSL_SESSION> ref = UpRef(ssl->s3->established_session);
299 if (ctx->new_session_cb(ssl, ref.get())) {
300 // |new_session_cb|'s return value signals whether it took ownership.
301 ref.release();
302 }
303 }
304 }
305
306 if (use_internal_cache &&
307 !(ctx->session_cache_mode & SSL_SESS_CACHE_NO_AUTO_CLEAR)) {
308 // Automatically flush the internal session cache every 255 connections.
309 int flush_cache = 0;
310 CRYPTO_MUTEX_lock_write(&ctx->lock);
311 ctx->handshakes_since_cache_flush++;
312 if (ctx->handshakes_since_cache_flush >= 255) {
313 flush_cache = 1;
314 ctx->handshakes_since_cache_flush = 0;
315 }
316 CRYPTO_MUTEX_unlock_write(&ctx->lock);
317
318 if (flush_cache) {
319 struct OPENSSL_timeval now;
320 ssl_get_current_time(ssl, &now);
321 SSL_CTX_flush_sessions(ctx, now.tv_sec);
322 }
323 }
324 }
325
cbb_add_hex(CBB * cbb,Span<const uint8_t> in)326 static bool cbb_add_hex(CBB *cbb, Span<const uint8_t> in) {
327 static const char hextable[] = "0123456789abcdef";
328 uint8_t *out;
329
330 if (!CBB_add_space(cbb, &out, in.size() * 2)) {
331 return false;
332 }
333
334 for (uint8_t b : in) {
335 *(out++) = (uint8_t)hextable[b >> 4];
336 *(out++) = (uint8_t)hextable[b & 0xf];
337 }
338
339 return true;
340 }
341
ssl_log_secret(const SSL * ssl,const char * label,Span<const uint8_t> secret)342 bool ssl_log_secret(const SSL *ssl, const char *label,
343 Span<const uint8_t> secret) {
344 if (ssl->ctx->keylog_callback == NULL) {
345 return true;
346 }
347
348 ScopedCBB cbb;
349 Array<uint8_t> line;
350 if (!CBB_init(cbb.get(), strlen(label) + 1 + SSL3_RANDOM_SIZE * 2 + 1 +
351 secret.size() * 2 + 1) ||
352 !CBB_add_bytes(cbb.get(), reinterpret_cast<const uint8_t *>(label),
353 strlen(label)) ||
354 !CBB_add_u8(cbb.get(), ' ') ||
355 !cbb_add_hex(cbb.get(), ssl->s3->client_random) ||
356 !CBB_add_u8(cbb.get(), ' ') ||
357 !cbb_add_hex(cbb.get(), secret) ||
358 !CBB_add_u8(cbb.get(), 0 /* NUL */) ||
359 !CBBFinishArray(cbb.get(), &line)) {
360 return false;
361 }
362
363 ssl->ctx->keylog_callback(ssl, reinterpret_cast<const char *>(line.data()));
364 return true;
365 }
366
ssl_do_info_callback(const SSL * ssl,int type,int value)367 void ssl_do_info_callback(const SSL *ssl, int type, int value) {
368 void (*cb)(const SSL *ssl, int type, int value) = NULL;
369 if (ssl->info_callback != NULL) {
370 cb = ssl->info_callback;
371 } else if (ssl->ctx->info_callback != NULL) {
372 cb = ssl->ctx->info_callback;
373 }
374
375 if (cb != NULL) {
376 cb(ssl, type, value);
377 }
378 }
379
ssl_do_msg_callback(const SSL * ssl,int is_write,int content_type,Span<const uint8_t> in)380 void ssl_do_msg_callback(const SSL *ssl, int is_write, int content_type,
381 Span<const uint8_t> in) {
382 if (ssl->msg_callback == NULL) {
383 return;
384 }
385
386 // |version| is zero when calling for |SSL3_RT_HEADER| and |SSL2_VERSION| for
387 // a V2ClientHello.
388 int version;
389 switch (content_type) {
390 case 0:
391 // V2ClientHello
392 version = SSL2_VERSION;
393 break;
394 case SSL3_RT_HEADER:
395 version = 0;
396 break;
397 default:
398 version = SSL_version(ssl);
399 }
400
401 ssl->msg_callback(is_write, version, content_type, in.data(), in.size(),
402 const_cast<SSL *>(ssl), ssl->msg_callback_arg);
403 }
404
ssl_get_current_time(const SSL * ssl,struct OPENSSL_timeval * out_clock)405 void ssl_get_current_time(const SSL *ssl, struct OPENSSL_timeval *out_clock) {
406 // TODO(martinkr): Change callers to |ssl_ctx_get_current_time| and drop the
407 // |ssl| arg from |current_time_cb| if possible.
408 ssl_ctx_get_current_time(ssl->ctx.get(), out_clock);
409 }
410
ssl_ctx_get_current_time(const SSL_CTX * ctx,struct OPENSSL_timeval * out_clock)411 void ssl_ctx_get_current_time(const SSL_CTX *ctx,
412 struct OPENSSL_timeval *out_clock) {
413 if (ctx->current_time_cb != NULL) {
414 // TODO(davidben): Update current_time_cb to use OPENSSL_timeval. See
415 // https://crbug.com/boringssl/155.
416 struct timeval clock;
417 ctx->current_time_cb(nullptr /* ssl */, &clock);
418 if (clock.tv_sec < 0) {
419 assert(0);
420 out_clock->tv_sec = 0;
421 out_clock->tv_usec = 0;
422 } else {
423 out_clock->tv_sec = (uint64_t)clock.tv_sec;
424 out_clock->tv_usec = (uint32_t)clock.tv_usec;
425 }
426 return;
427 }
428
429 #if defined(BORINGSSL_UNSAFE_DETERMINISTIC_MODE)
430 out_clock->tv_sec = 1234;
431 out_clock->tv_usec = 1234;
432 #elif defined(OPENSSL_WINDOWS)
433 struct _timeb time;
434 _ftime(&time);
435 if (time.time < 0) {
436 assert(0);
437 out_clock->tv_sec = 0;
438 out_clock->tv_usec = 0;
439 } else {
440 out_clock->tv_sec = time.time;
441 out_clock->tv_usec = time.millitm * 1000;
442 }
443 #else
444 struct timeval clock;
445 gettimeofday(&clock, NULL);
446 if (clock.tv_sec < 0) {
447 assert(0);
448 out_clock->tv_sec = 0;
449 out_clock->tv_usec = 0;
450 } else {
451 out_clock->tv_sec = (uint64_t)clock.tv_sec;
452 out_clock->tv_usec = (uint32_t)clock.tv_usec;
453 }
454 #endif
455 }
456
SSL_CTX_set_handoff_mode(SSL_CTX * ctx,bool on)457 void SSL_CTX_set_handoff_mode(SSL_CTX *ctx, bool on) {
458 ctx->handoff = on;
459 }
460
ssl_can_renegotiate(const SSL * ssl)461 static bool ssl_can_renegotiate(const SSL *ssl) {
462 if (ssl->server || SSL_is_dtls(ssl)) {
463 return false;
464 }
465
466 if (ssl_protocol_version(ssl) >= TLS1_3_VERSION) {
467 return false;
468 }
469
470 // The config has already been shed.
471 if (!ssl->config) {
472 return false;
473 }
474
475 switch (ssl->renegotiate_mode) {
476 case ssl_renegotiate_ignore:
477 case ssl_renegotiate_never:
478 return false;
479
480 case ssl_renegotiate_freely:
481 case ssl_renegotiate_explicit:
482 return true;
483 case ssl_renegotiate_once:
484 return ssl->s3->total_renegotiations == 0;
485 }
486
487 assert(0);
488 return false;
489 }
490
ssl_maybe_shed_handshake_config(SSL * ssl)491 static void ssl_maybe_shed_handshake_config(SSL *ssl) {
492 if (ssl->s3->hs != nullptr ||
493 ssl->config == nullptr ||
494 !ssl->config->shed_handshake_config ||
495 ssl_can_renegotiate(ssl)) {
496 return;
497 }
498
499 ssl->config.reset();
500 }
501
SSL_set_handoff_mode(SSL * ssl,bool on)502 void SSL_set_handoff_mode(SSL *ssl, bool on) {
503 if (!ssl->config) {
504 return;
505 }
506 ssl->config->handoff = on;
507 }
508
SSL_get_traffic_secrets(const SSL * ssl,Span<const uint8_t> * out_read_traffic_secret,Span<const uint8_t> * out_write_traffic_secret)509 bool SSL_get_traffic_secrets(const SSL *ssl,
510 Span<const uint8_t> *out_read_traffic_secret,
511 Span<const uint8_t> *out_write_traffic_secret) {
512 if (SSL_version(ssl) < TLS1_3_VERSION) {
513 OPENSSL_PUT_ERROR(SSL, SSL_R_WRONG_SSL_VERSION);
514 return false;
515 }
516
517 if (!ssl->s3->initial_handshake_complete) {
518 OPENSSL_PUT_ERROR(SSL, SSL_R_HANDSHAKE_NOT_COMPLETE);
519 return false;
520 }
521
522 *out_read_traffic_secret = Span<const uint8_t>(
523 ssl->s3->read_traffic_secret, ssl->s3->read_traffic_secret_len);
524 *out_write_traffic_secret = Span<const uint8_t>(
525 ssl->s3->write_traffic_secret, ssl->s3->write_traffic_secret_len);
526
527 return true;
528 }
529
530 BSSL_NAMESPACE_END
531
532 using namespace bssl;
533
SSL_library_init(void)534 int SSL_library_init(void) {
535 CRYPTO_library_init();
536 return 1;
537 }
538
OPENSSL_init_ssl(uint64_t opts,const OPENSSL_INIT_SETTINGS * settings)539 int OPENSSL_init_ssl(uint64_t opts, const OPENSSL_INIT_SETTINGS *settings) {
540 CRYPTO_library_init();
541 return 1;
542 }
543
ssl_session_hash(const SSL_SESSION * sess)544 static uint32_t ssl_session_hash(const SSL_SESSION *sess) {
545 return ssl_hash_session_id(
546 MakeConstSpan(sess->session_id, sess->session_id_length));
547 }
548
ssl_session_cmp(const SSL_SESSION * a,const SSL_SESSION * b)549 static int ssl_session_cmp(const SSL_SESSION *a, const SSL_SESSION *b) {
550 if (a->session_id_length != b->session_id_length) {
551 return 1;
552 }
553
554 return OPENSSL_memcmp(a->session_id, b->session_id, a->session_id_length);
555 }
556
ssl_ctx_st(const SSL_METHOD * ssl_method)557 ssl_ctx_st::ssl_ctx_st(const SSL_METHOD *ssl_method)
558 : method(ssl_method->method),
559 x509_method(ssl_method->x509_method),
560 retain_only_sha256_of_client_certs(false),
561 quiet_shutdown(false),
562 ocsp_stapling_enabled(false),
563 signed_cert_timestamps_enabled(false),
564 channel_id_enabled(false),
565 grease_enabled(false),
566 allow_unknown_alpn_protos(false),
567 ed25519_enabled(false),
568 rsa_pss_rsae_certs_enabled(true),
569 false_start_allowed_without_alpn(false),
570 ignore_tls13_downgrade(false),
571 handoff(false),
572 enable_early_data(false),
573 pq_experiment_signal(false) {
574 CRYPTO_MUTEX_init(&lock);
575 CRYPTO_new_ex_data(&ex_data);
576 }
577
~ssl_ctx_st()578 ssl_ctx_st::~ssl_ctx_st() {
579 // Free the internal session cache. Note that this calls the caller-supplied
580 // remove callback, so we must do it before clearing ex_data. (See ticket
581 // [openssl.org #212].)
582 SSL_CTX_flush_sessions(this, 0);
583
584 CRYPTO_free_ex_data(&g_ex_data_class_ssl_ctx, this, &ex_data);
585
586 CRYPTO_MUTEX_cleanup(&lock);
587 lh_SSL_SESSION_free(sessions);
588 x509_method->ssl_ctx_free(this);
589 }
590
SSL_CTX_new(const SSL_METHOD * method)591 SSL_CTX *SSL_CTX_new(const SSL_METHOD *method) {
592 if (method == NULL) {
593 OPENSSL_PUT_ERROR(SSL, SSL_R_NULL_SSL_METHOD_PASSED);
594 return nullptr;
595 }
596
597 UniquePtr<SSL_CTX> ret = MakeUnique<SSL_CTX>(method);
598 if (!ret) {
599 return nullptr;
600 }
601
602 ret->cert = MakeUnique<CERT>(method->x509_method);
603 ret->sessions = lh_SSL_SESSION_new(ssl_session_hash, ssl_session_cmp);
604 ret->client_CA.reset(sk_CRYPTO_BUFFER_new_null());
605 if (ret->cert == nullptr ||
606 ret->sessions == nullptr ||
607 ret->client_CA == nullptr ||
608 !ret->x509_method->ssl_ctx_new(ret.get())) {
609 return nullptr;
610 }
611
612 if (!SSL_CTX_set_strict_cipher_list(ret.get(), SSL_DEFAULT_CIPHER_LIST) ||
613 // Lock the SSL_CTX to the specified version, for compatibility with
614 // legacy uses of SSL_METHOD.
615 !SSL_CTX_set_max_proto_version(ret.get(), method->version) ||
616 !SSL_CTX_set_min_proto_version(ret.get(), method->version)) {
617 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
618 return nullptr;
619 }
620
621 return ret.release();
622 }
623
SSL_CTX_up_ref(SSL_CTX * ctx)624 int SSL_CTX_up_ref(SSL_CTX *ctx) {
625 CRYPTO_refcount_inc(&ctx->references);
626 return 1;
627 }
628
SSL_CTX_free(SSL_CTX * ctx)629 void SSL_CTX_free(SSL_CTX *ctx) {
630 if (ctx == NULL ||
631 !CRYPTO_refcount_dec_and_test_zero(&ctx->references)) {
632 return;
633 }
634
635 ctx->~ssl_ctx_st();
636 OPENSSL_free(ctx);
637 }
638
ssl_st(SSL_CTX * ctx_arg)639 ssl_st::ssl_st(SSL_CTX *ctx_arg)
640 : method(ctx_arg->method),
641 max_send_fragment(ctx_arg->max_send_fragment),
642 msg_callback(ctx_arg->msg_callback),
643 msg_callback_arg(ctx_arg->msg_callback_arg),
644 ctx(UpRef(ctx_arg)),
645 session_ctx(UpRef(ctx_arg)),
646 options(ctx->options),
647 mode(ctx->mode),
648 max_cert_list(ctx->max_cert_list),
649 server(false),
650 quiet_shutdown(ctx->quiet_shutdown),
651 enable_early_data(ctx->enable_early_data) {
652 CRYPTO_new_ex_data(&ex_data);
653 }
654
~ssl_st()655 ssl_st::~ssl_st() {
656 CRYPTO_free_ex_data(&g_ex_data_class_ssl, this, &ex_data);
657 // |config| refers to |this|, so we must release it earlier.
658 config.reset();
659 if (method != NULL) {
660 method->ssl_free(this);
661 }
662 }
663
SSL_new(SSL_CTX * ctx)664 SSL *SSL_new(SSL_CTX *ctx) {
665 if (ctx == nullptr) {
666 OPENSSL_PUT_ERROR(SSL, SSL_R_NULL_SSL_CTX);
667 return nullptr;
668 }
669
670 UniquePtr<SSL> ssl = MakeUnique<SSL>(ctx);
671 if (ssl == nullptr) {
672 return nullptr;
673 }
674
675 ssl->config = MakeUnique<SSL_CONFIG>(ssl.get());
676 if (ssl->config == nullptr) {
677 return nullptr;
678 }
679 ssl->config->conf_min_version = ctx->conf_min_version;
680 ssl->config->conf_max_version = ctx->conf_max_version;
681
682 ssl->config->cert = ssl_cert_dup(ctx->cert.get());
683 if (ssl->config->cert == nullptr) {
684 return nullptr;
685 }
686
687 ssl->config->verify_mode = ctx->verify_mode;
688 ssl->config->verify_callback = ctx->default_verify_callback;
689 ssl->config->custom_verify_callback = ctx->custom_verify_callback;
690 ssl->config->retain_only_sha256_of_client_certs =
691 ctx->retain_only_sha256_of_client_certs;
692
693 if (!ssl->config->supported_group_list.CopyFrom(ctx->supported_group_list) ||
694 !ssl->config->alpn_client_proto_list.CopyFrom(
695 ctx->alpn_client_proto_list) ||
696 !ssl->config->verify_sigalgs.CopyFrom(ctx->verify_sigalgs)) {
697 return nullptr;
698 }
699
700 if (ctx->psk_identity_hint) {
701 ssl->config->psk_identity_hint.reset(
702 BUF_strdup(ctx->psk_identity_hint.get()));
703 if (ssl->config->psk_identity_hint == nullptr) {
704 return nullptr;
705 }
706 }
707 ssl->config->psk_client_callback = ctx->psk_client_callback;
708 ssl->config->psk_server_callback = ctx->psk_server_callback;
709
710 ssl->config->channel_id_enabled = ctx->channel_id_enabled;
711 ssl->config->channel_id_private = UpRef(ctx->channel_id_private);
712
713 ssl->config->signed_cert_timestamps_enabled =
714 ctx->signed_cert_timestamps_enabled;
715 ssl->config->ocsp_stapling_enabled = ctx->ocsp_stapling_enabled;
716 ssl->config->handoff = ctx->handoff;
717 ssl->config->ignore_tls13_downgrade = ctx->ignore_tls13_downgrade;
718 ssl->quic_method = ctx->quic_method;
719
720 if (!ssl->method->ssl_new(ssl.get()) ||
721 !ssl->ctx->x509_method->ssl_new(ssl->s3->hs.get())) {
722 return nullptr;
723 }
724
725 return ssl.release();
726 }
727
SSL_CONFIG(SSL * ssl_arg)728 SSL_CONFIG::SSL_CONFIG(SSL *ssl_arg)
729 : ssl(ssl_arg),
730 signed_cert_timestamps_enabled(false),
731 ocsp_stapling_enabled(false),
732 channel_id_enabled(false),
733 enforce_rsa_key_usage(false),
734 retain_only_sha256_of_client_certs(false),
735 handoff(false),
736 shed_handshake_config(false),
737 ignore_tls13_downgrade(false),
738 jdk11_workaround(false) {
739 assert(ssl);
740 }
741
~SSL_CONFIG()742 SSL_CONFIG::~SSL_CONFIG() {
743 if (ssl->ctx != nullptr) {
744 ssl->ctx->x509_method->ssl_config_free(this);
745 }
746 }
747
SSL_free(SSL * ssl)748 void SSL_free(SSL *ssl) {
749 Delete(ssl);
750 }
751
SSL_set_connect_state(SSL * ssl)752 void SSL_set_connect_state(SSL *ssl) {
753 ssl->server = false;
754 ssl->do_handshake = ssl_client_handshake;
755 }
756
SSL_set_accept_state(SSL * ssl)757 void SSL_set_accept_state(SSL *ssl) {
758 ssl->server = true;
759 ssl->do_handshake = ssl_server_handshake;
760 }
761
SSL_set0_rbio(SSL * ssl,BIO * rbio)762 void SSL_set0_rbio(SSL *ssl, BIO *rbio) {
763 ssl->rbio.reset(rbio);
764 }
765
SSL_set0_wbio(SSL * ssl,BIO * wbio)766 void SSL_set0_wbio(SSL *ssl, BIO *wbio) {
767 ssl->wbio.reset(wbio);
768 }
769
SSL_set_bio(SSL * ssl,BIO * rbio,BIO * wbio)770 void SSL_set_bio(SSL *ssl, BIO *rbio, BIO *wbio) {
771 // For historical reasons, this function has many different cases in ownership
772 // handling.
773
774 // If nothing has changed, do nothing
775 if (rbio == SSL_get_rbio(ssl) && wbio == SSL_get_wbio(ssl)) {
776 return;
777 }
778
779 // If the two arguments are equal, one fewer reference is granted than
780 // taken.
781 if (rbio != NULL && rbio == wbio) {
782 BIO_up_ref(rbio);
783 }
784
785 // If only the wbio is changed, adopt only one reference.
786 if (rbio == SSL_get_rbio(ssl)) {
787 SSL_set0_wbio(ssl, wbio);
788 return;
789 }
790
791 // There is an asymmetry here for historical reasons. If only the rbio is
792 // changed AND the rbio and wbio were originally different, then we only adopt
793 // one reference.
794 if (wbio == SSL_get_wbio(ssl) && SSL_get_rbio(ssl) != SSL_get_wbio(ssl)) {
795 SSL_set0_rbio(ssl, rbio);
796 return;
797 }
798
799 // Otherwise, adopt both references.
800 SSL_set0_rbio(ssl, rbio);
801 SSL_set0_wbio(ssl, wbio);
802 }
803
SSL_get_rbio(const SSL * ssl)804 BIO *SSL_get_rbio(const SSL *ssl) { return ssl->rbio.get(); }
805
SSL_get_wbio(const SSL * ssl)806 BIO *SSL_get_wbio(const SSL *ssl) { return ssl->wbio.get(); }
807
SSL_quic_max_handshake_flight_len(const SSL * ssl,enum ssl_encryption_level_t level)808 size_t SSL_quic_max_handshake_flight_len(const SSL *ssl,
809 enum ssl_encryption_level_t level) {
810 // Limits flights to 16K by default when there are no large
811 // (certificate-carrying) messages.
812 static const size_t kDefaultLimit = 16384;
813
814 switch (level) {
815 case ssl_encryption_initial:
816 return kDefaultLimit;
817 case ssl_encryption_early_data:
818 // QUIC does not send EndOfEarlyData.
819 return 0;
820 case ssl_encryption_handshake:
821 if (ssl->server) {
822 // Servers may receive Certificate message if configured to request
823 // client certificates.
824 if (!!(ssl->config->verify_mode & SSL_VERIFY_PEER) &&
825 ssl->max_cert_list > kDefaultLimit) {
826 return ssl->max_cert_list;
827 }
828 } else {
829 // Clients may receive both Certificate message and a CertificateRequest
830 // message.
831 if (2*ssl->max_cert_list > kDefaultLimit) {
832 return 2*ssl->max_cert_list;
833 }
834 }
835 return kDefaultLimit;
836 case ssl_encryption_application:
837 // Note there is not actually a bound on the number of NewSessionTickets
838 // one may send in a row. This level may need more involved flow
839 // control. See https://github.com/quicwg/base-drafts/issues/1834.
840 return kDefaultLimit;
841 }
842
843 return 0;
844 }
845
SSL_quic_read_level(const SSL * ssl)846 enum ssl_encryption_level_t SSL_quic_read_level(const SSL *ssl) {
847 return ssl->s3->read_level;
848 }
849
SSL_quic_write_level(const SSL * ssl)850 enum ssl_encryption_level_t SSL_quic_write_level(const SSL *ssl) {
851 return ssl->s3->write_level;
852 }
853
SSL_provide_quic_data(SSL * ssl,enum ssl_encryption_level_t level,const uint8_t * data,size_t len)854 int SSL_provide_quic_data(SSL *ssl, enum ssl_encryption_level_t level,
855 const uint8_t *data, size_t len) {
856 if (ssl->quic_method == nullptr) {
857 OPENSSL_PUT_ERROR(SSL, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
858 return 0;
859 }
860
861 if (level != ssl->s3->read_level) {
862 OPENSSL_PUT_ERROR(SSL, SSL_R_WRONG_ENCRYPTION_LEVEL_RECEIVED);
863 return 0;
864 }
865
866 size_t new_len = (ssl->s3->hs_buf ? ssl->s3->hs_buf->length : 0) + len;
867 if (new_len < len ||
868 new_len > SSL_quic_max_handshake_flight_len(ssl, level)) {
869 OPENSSL_PUT_ERROR(SSL, SSL_R_EXCESSIVE_MESSAGE_SIZE);
870 return 0;
871 }
872
873 return tls_append_handshake_data(ssl, MakeConstSpan(data, len));
874 }
875
SSL_do_handshake(SSL * ssl)876 int SSL_do_handshake(SSL *ssl) {
877 ssl_reset_error_state(ssl);
878
879 if (ssl->do_handshake == NULL) {
880 OPENSSL_PUT_ERROR(SSL, SSL_R_CONNECTION_TYPE_NOT_SET);
881 return -1;
882 }
883
884 if (!SSL_in_init(ssl)) {
885 return 1;
886 }
887
888 // Run the handshake.
889 SSL_HANDSHAKE *hs = ssl->s3->hs.get();
890
891 bool early_return = false;
892 int ret = ssl_run_handshake(hs, &early_return);
893 ssl_do_info_callback(
894 ssl, ssl->server ? SSL_CB_ACCEPT_EXIT : SSL_CB_CONNECT_EXIT, ret);
895 if (ret <= 0) {
896 return ret;
897 }
898
899 // Destroy the handshake object if the handshake has completely finished.
900 if (!early_return) {
901 ssl->s3->hs.reset();
902 ssl_maybe_shed_handshake_config(ssl);
903 }
904
905 return 1;
906 }
907
SSL_connect(SSL * ssl)908 int SSL_connect(SSL *ssl) {
909 if (ssl->do_handshake == NULL) {
910 // Not properly initialized yet
911 SSL_set_connect_state(ssl);
912 }
913
914 return SSL_do_handshake(ssl);
915 }
916
SSL_accept(SSL * ssl)917 int SSL_accept(SSL *ssl) {
918 if (ssl->do_handshake == NULL) {
919 // Not properly initialized yet
920 SSL_set_accept_state(ssl);
921 }
922
923 return SSL_do_handshake(ssl);
924 }
925
ssl_do_post_handshake(SSL * ssl,const SSLMessage & msg)926 static int ssl_do_post_handshake(SSL *ssl, const SSLMessage &msg) {
927 if (ssl_protocol_version(ssl) >= TLS1_3_VERSION) {
928 return tls13_post_handshake(ssl, msg);
929 }
930
931 // Check for renegotiation on the server before parsing to use the correct
932 // error. Renegotiation is triggered by a different message for servers.
933 if (ssl->server) {
934 OPENSSL_PUT_ERROR(SSL, SSL_R_NO_RENEGOTIATION);
935 ssl_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_NO_RENEGOTIATION);
936 return 0;
937 }
938
939 if (msg.type != SSL3_MT_HELLO_REQUEST || CBS_len(&msg.body) != 0) {
940 ssl_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_DECODE_ERROR);
941 OPENSSL_PUT_ERROR(SSL, SSL_R_BAD_HELLO_REQUEST);
942 return 0;
943 }
944
945 if (ssl->renegotiate_mode == ssl_renegotiate_ignore) {
946 return 1; // Ignore the HelloRequest.
947 }
948
949 ssl->s3->renegotiate_pending = true;
950 if (ssl->renegotiate_mode == ssl_renegotiate_explicit) {
951 return 1; // Handle it later.
952 }
953
954 if (!SSL_renegotiate(ssl)) {
955 ssl_send_alert(ssl, SSL3_AL_FATAL, SSL_AD_NO_RENEGOTIATION);
956 return 0;
957 }
958
959 return 1;
960 }
961
SSL_process_quic_post_handshake(SSL * ssl)962 int SSL_process_quic_post_handshake(SSL *ssl) {
963 ssl_reset_error_state(ssl);
964
965 if (SSL_in_init(ssl)) {
966 OPENSSL_PUT_ERROR(SSL, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
967 return 0;
968 }
969
970 // Replay post-handshake message errors.
971 if (!check_read_error(ssl)) {
972 return 0;
973 }
974
975 // Process any buffered post-handshake messages.
976 SSLMessage msg;
977 while (ssl->method->get_message(ssl, &msg)) {
978 // Handle the post-handshake message and try again.
979 if (!ssl_do_post_handshake(ssl, msg)) {
980 ssl_set_read_error(ssl);
981 return 0;
982 }
983 ssl->method->next_message(ssl);
984 }
985
986 return 1;
987 }
988
ssl_read_impl(SSL * ssl)989 static int ssl_read_impl(SSL *ssl) {
990 ssl_reset_error_state(ssl);
991
992 if (ssl->do_handshake == NULL) {
993 OPENSSL_PUT_ERROR(SSL, SSL_R_UNINITIALIZED);
994 return -1;
995 }
996
997 // Replay post-handshake message errors.
998 if (!check_read_error(ssl)) {
999 return -1;
1000 }
1001
1002 while (ssl->s3->pending_app_data.empty()) {
1003 if (ssl->s3->renegotiate_pending) {
1004 ssl->s3->rwstate = SSL_ERROR_WANT_RENEGOTIATE;
1005 return -1;
1006 }
1007
1008 // Complete the current handshake, if any. False Start will cause
1009 // |SSL_do_handshake| to return mid-handshake, so this may require multiple
1010 // iterations.
1011 while (!ssl_can_read(ssl)) {
1012 int ret = SSL_do_handshake(ssl);
1013 if (ret < 0) {
1014 return ret;
1015 }
1016 if (ret == 0) {
1017 OPENSSL_PUT_ERROR(SSL, SSL_R_SSL_HANDSHAKE_FAILURE);
1018 return -1;
1019 }
1020 }
1021
1022 // Process any buffered post-handshake messages.
1023 SSLMessage msg;
1024 if (ssl->method->get_message(ssl, &msg)) {
1025 // If we received an interrupt in early read (EndOfEarlyData), loop again
1026 // for the handshake to process it.
1027 if (SSL_in_init(ssl)) {
1028 ssl->s3->hs->can_early_read = false;
1029 continue;
1030 }
1031
1032 // Handle the post-handshake message and try again.
1033 if (!ssl_do_post_handshake(ssl, msg)) {
1034 ssl_set_read_error(ssl);
1035 return -1;
1036 }
1037 ssl->method->next_message(ssl);
1038 continue; // Loop again. We may have begun a new handshake.
1039 }
1040
1041 uint8_t alert = SSL_AD_DECODE_ERROR;
1042 size_t consumed = 0;
1043 auto ret = ssl_open_app_data(ssl, &ssl->s3->pending_app_data, &consumed,
1044 &alert, ssl->s3->read_buffer.span());
1045 bool retry;
1046 int bio_ret = ssl_handle_open_record(ssl, &retry, ret, consumed, alert);
1047 if (bio_ret <= 0) {
1048 return bio_ret;
1049 }
1050 if (!retry) {
1051 assert(!ssl->s3->pending_app_data.empty());
1052 ssl->s3->key_update_count = 0;
1053 }
1054 }
1055
1056 return 1;
1057 }
1058
SSL_read(SSL * ssl,void * buf,int num)1059 int SSL_read(SSL *ssl, void *buf, int num) {
1060 int ret = SSL_peek(ssl, buf, num);
1061 if (ret <= 0) {
1062 return ret;
1063 }
1064 // TODO(davidben): In DTLS, should the rest of the record be discarded? DTLS
1065 // is not a stream. See https://crbug.com/boringssl/65.
1066 ssl->s3->pending_app_data =
1067 ssl->s3->pending_app_data.subspan(static_cast<size_t>(ret));
1068 if (ssl->s3->pending_app_data.empty()) {
1069 ssl->s3->read_buffer.DiscardConsumed();
1070 }
1071 return ret;
1072 }
1073
SSL_peek(SSL * ssl,void * buf,int num)1074 int SSL_peek(SSL *ssl, void *buf, int num) {
1075 if (ssl->quic_method != nullptr) {
1076 OPENSSL_PUT_ERROR(SSL, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
1077 return 0;
1078 }
1079
1080 int ret = ssl_read_impl(ssl);
1081 if (ret <= 0) {
1082 return ret;
1083 }
1084 if (num <= 0) {
1085 return num;
1086 }
1087 size_t todo =
1088 std::min(ssl->s3->pending_app_data.size(), static_cast<size_t>(num));
1089 OPENSSL_memcpy(buf, ssl->s3->pending_app_data.data(), todo);
1090 return static_cast<int>(todo);
1091 }
1092
SSL_write(SSL * ssl,const void * buf,int num)1093 int SSL_write(SSL *ssl, const void *buf, int num) {
1094 ssl_reset_error_state(ssl);
1095
1096 if (ssl->quic_method != nullptr) {
1097 OPENSSL_PUT_ERROR(SSL, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
1098 return 0;
1099 }
1100
1101 if (ssl->do_handshake == NULL) {
1102 OPENSSL_PUT_ERROR(SSL, SSL_R_UNINITIALIZED);
1103 return -1;
1104 }
1105
1106 if (ssl->s3->write_shutdown != ssl_shutdown_none) {
1107 OPENSSL_PUT_ERROR(SSL, SSL_R_PROTOCOL_IS_SHUTDOWN);
1108 return -1;
1109 }
1110
1111 int ret = 0;
1112 bool needs_handshake = false;
1113 do {
1114 // If necessary, complete the handshake implicitly.
1115 if (!ssl_can_write(ssl)) {
1116 ret = SSL_do_handshake(ssl);
1117 if (ret < 0) {
1118 return ret;
1119 }
1120 if (ret == 0) {
1121 OPENSSL_PUT_ERROR(SSL, SSL_R_SSL_HANDSHAKE_FAILURE);
1122 return -1;
1123 }
1124 }
1125
1126 ret = ssl->method->write_app_data(ssl, &needs_handshake,
1127 (const uint8_t *)buf, num);
1128 } while (needs_handshake);
1129 return ret;
1130 }
1131
SSL_key_update(SSL * ssl,int request_type)1132 int SSL_key_update(SSL *ssl, int request_type) {
1133 ssl_reset_error_state(ssl);
1134
1135 if (ssl->do_handshake == NULL) {
1136 OPENSSL_PUT_ERROR(SSL, SSL_R_UNINITIALIZED);
1137 return 0;
1138 }
1139
1140 if (ssl->ctx->quic_method != nullptr) {
1141 OPENSSL_PUT_ERROR(SSL, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
1142 return 0;
1143 }
1144
1145 if (!ssl->s3->initial_handshake_complete) {
1146 OPENSSL_PUT_ERROR(SSL, SSL_R_HANDSHAKE_NOT_COMPLETE);
1147 return 0;
1148 }
1149
1150 if (ssl_protocol_version(ssl) < TLS1_3_VERSION) {
1151 OPENSSL_PUT_ERROR(SSL, SSL_R_WRONG_SSL_VERSION);
1152 return 0;
1153 }
1154
1155 if (!ssl->s3->key_update_pending &&
1156 !tls13_add_key_update(ssl, request_type)) {
1157 return 0;
1158 }
1159
1160 return 1;
1161 }
1162
SSL_shutdown(SSL * ssl)1163 int SSL_shutdown(SSL *ssl) {
1164 ssl_reset_error_state(ssl);
1165
1166 if (ssl->do_handshake == NULL) {
1167 OPENSSL_PUT_ERROR(SSL, SSL_R_UNINITIALIZED);
1168 return -1;
1169 }
1170
1171 // If we are in the middle of a handshake, silently succeed. Consumers often
1172 // call this function before |SSL_free|, whether the handshake succeeded or
1173 // not. We assume the caller has already handled failed handshakes.
1174 if (SSL_in_init(ssl)) {
1175 return 1;
1176 }
1177
1178 if (ssl->quiet_shutdown) {
1179 // Do nothing if configured not to send a close_notify.
1180 ssl->s3->write_shutdown = ssl_shutdown_close_notify;
1181 ssl->s3->read_shutdown = ssl_shutdown_close_notify;
1182 return 1;
1183 }
1184
1185 // This function completes in two stages. It sends a close_notify and then it
1186 // waits for a close_notify to come in. Perform exactly one action and return
1187 // whether or not it succeeds.
1188
1189 if (ssl->s3->write_shutdown != ssl_shutdown_close_notify) {
1190 // Send a close_notify.
1191 if (ssl_send_alert_impl(ssl, SSL3_AL_WARNING, SSL_AD_CLOSE_NOTIFY) <= 0) {
1192 return -1;
1193 }
1194 } else if (ssl->s3->alert_dispatch) {
1195 // Finish sending the close_notify.
1196 if (ssl->method->dispatch_alert(ssl) <= 0) {
1197 return -1;
1198 }
1199 } else if (ssl->s3->read_shutdown != ssl_shutdown_close_notify) {
1200 if (SSL_is_dtls(ssl)) {
1201 // Bidirectional shutdown doesn't make sense for an unordered
1202 // transport. DTLS alerts also aren't delivered reliably, so we may even
1203 // time out because the peer never received our close_notify. Report to
1204 // the caller that the channel has fully shut down.
1205 if (ssl->s3->read_shutdown == ssl_shutdown_error) {
1206 ERR_restore_state(ssl->s3->read_error.get());
1207 return -1;
1208 }
1209 ssl->s3->read_shutdown = ssl_shutdown_close_notify;
1210 } else {
1211 // Process records until an error, close_notify, or application data.
1212 if (ssl_read_impl(ssl) > 0) {
1213 // We received some unexpected application data.
1214 OPENSSL_PUT_ERROR(SSL, SSL_R_APPLICATION_DATA_ON_SHUTDOWN);
1215 return -1;
1216 }
1217 if (ssl->s3->read_shutdown != ssl_shutdown_close_notify) {
1218 return -1;
1219 }
1220 }
1221 }
1222
1223 // Return 0 for unidirectional shutdown and 1 for bidirectional shutdown.
1224 return ssl->s3->read_shutdown == ssl_shutdown_close_notify;
1225 }
1226
SSL_send_fatal_alert(SSL * ssl,uint8_t alert)1227 int SSL_send_fatal_alert(SSL *ssl, uint8_t alert) {
1228 if (ssl->s3->alert_dispatch) {
1229 if (ssl->s3->send_alert[0] != SSL3_AL_FATAL ||
1230 ssl->s3->send_alert[1] != alert) {
1231 // We are already attempting to write a different alert.
1232 OPENSSL_PUT_ERROR(SSL, SSL_R_PROTOCOL_IS_SHUTDOWN);
1233 return -1;
1234 }
1235 return ssl->method->dispatch_alert(ssl);
1236 }
1237
1238 return ssl_send_alert_impl(ssl, SSL3_AL_FATAL, alert);
1239 }
1240
SSL_CTX_enable_pq_experiment_signal(SSL_CTX * ctx)1241 void SSL_CTX_enable_pq_experiment_signal(SSL_CTX *ctx) {
1242 ctx->pq_experiment_signal = true;
1243 }
1244
SSL_pq_experiment_signal_seen(const SSL * ssl)1245 int SSL_pq_experiment_signal_seen(const SSL *ssl) {
1246 return ssl->s3->pq_experiment_signal_seen;
1247 }
1248
SSL_set_quic_transport_params(SSL * ssl,const uint8_t * params,size_t params_len)1249 int SSL_set_quic_transport_params(SSL *ssl, const uint8_t *params,
1250 size_t params_len) {
1251 return ssl->config && ssl->config->quic_transport_params.CopyFrom(
1252 MakeConstSpan(params, params_len));
1253 }
1254
SSL_get_peer_quic_transport_params(const SSL * ssl,const uint8_t ** out_params,size_t * out_params_len)1255 void SSL_get_peer_quic_transport_params(const SSL *ssl,
1256 const uint8_t **out_params,
1257 size_t *out_params_len) {
1258 *out_params = ssl->s3->peer_quic_transport_params.data();
1259 *out_params_len = ssl->s3->peer_quic_transport_params.size();
1260 }
1261
SSL_CTX_set_early_data_enabled(SSL_CTX * ctx,int enabled)1262 void SSL_CTX_set_early_data_enabled(SSL_CTX *ctx, int enabled) {
1263 ctx->enable_early_data = !!enabled;
1264 }
1265
SSL_set_early_data_enabled(SSL * ssl,int enabled)1266 void SSL_set_early_data_enabled(SSL *ssl, int enabled) {
1267 ssl->enable_early_data = !!enabled;
1268 }
1269
SSL_in_early_data(const SSL * ssl)1270 int SSL_in_early_data(const SSL *ssl) {
1271 if (ssl->s3->hs == NULL) {
1272 return 0;
1273 }
1274 return ssl->s3->hs->in_early_data;
1275 }
1276
SSL_early_data_accepted(const SSL * ssl)1277 int SSL_early_data_accepted(const SSL *ssl) {
1278 return ssl->s3->early_data_accepted;
1279 }
1280
SSL_reset_early_data_reject(SSL * ssl)1281 void SSL_reset_early_data_reject(SSL *ssl) {
1282 SSL_HANDSHAKE *hs = ssl->s3->hs.get();
1283 if (hs == NULL ||
1284 hs->wait != ssl_hs_early_data_rejected) {
1285 abort();
1286 }
1287
1288 hs->wait = ssl_hs_ok;
1289 hs->in_early_data = false;
1290 hs->early_session.reset();
1291
1292 // Discard any unfinished writes from the perspective of |SSL_write|'s
1293 // retry. The handshake will transparently flush out the pending record
1294 // (discarded by the server) to keep the framing correct.
1295 ssl->s3->wpend_pending = false;
1296 }
1297
SSL_get_early_data_reason(const SSL * ssl)1298 enum ssl_early_data_reason_t SSL_get_early_data_reason(const SSL *ssl) {
1299 return ssl->s3->early_data_reason;
1300 }
1301
bio_retry_reason_to_error(int reason)1302 static int bio_retry_reason_to_error(int reason) {
1303 switch (reason) {
1304 case BIO_RR_CONNECT:
1305 return SSL_ERROR_WANT_CONNECT;
1306 case BIO_RR_ACCEPT:
1307 return SSL_ERROR_WANT_ACCEPT;
1308 default:
1309 return SSL_ERROR_SYSCALL;
1310 }
1311 }
1312
SSL_get_error(const SSL * ssl,int ret_code)1313 int SSL_get_error(const SSL *ssl, int ret_code) {
1314 if (ret_code > 0) {
1315 return SSL_ERROR_NONE;
1316 }
1317
1318 // Make things return SSL_ERROR_SYSCALL when doing SSL_do_handshake etc,
1319 // where we do encode the error
1320 uint32_t err = ERR_peek_error();
1321 if (err != 0) {
1322 if (ERR_GET_LIB(err) == ERR_LIB_SYS) {
1323 return SSL_ERROR_SYSCALL;
1324 }
1325 return SSL_ERROR_SSL;
1326 }
1327
1328 if (ret_code == 0) {
1329 if (ssl->s3->read_shutdown == ssl_shutdown_close_notify) {
1330 return SSL_ERROR_ZERO_RETURN;
1331 }
1332 // An EOF was observed which violates the protocol, and the underlying
1333 // transport does not participate in the error queue. Bubble up to the
1334 // caller.
1335 return SSL_ERROR_SYSCALL;
1336 }
1337
1338 switch (ssl->s3->rwstate) {
1339 case SSL_ERROR_PENDING_SESSION:
1340 case SSL_ERROR_PENDING_CERTIFICATE:
1341 case SSL_ERROR_HANDOFF:
1342 case SSL_ERROR_HANDBACK:
1343 case SSL_ERROR_WANT_X509_LOOKUP:
1344 case SSL_ERROR_WANT_CHANNEL_ID_LOOKUP:
1345 case SSL_ERROR_WANT_PRIVATE_KEY_OPERATION:
1346 case SSL_ERROR_PENDING_TICKET:
1347 case SSL_ERROR_EARLY_DATA_REJECTED:
1348 case SSL_ERROR_WANT_CERTIFICATE_VERIFY:
1349 case SSL_ERROR_WANT_RENEGOTIATE:
1350 return ssl->s3->rwstate;
1351
1352 case SSL_ERROR_WANT_READ: {
1353 if (ssl->quic_method) {
1354 return SSL_ERROR_WANT_READ;
1355 }
1356 BIO *bio = SSL_get_rbio(ssl);
1357 if (BIO_should_read(bio)) {
1358 return SSL_ERROR_WANT_READ;
1359 }
1360
1361 if (BIO_should_write(bio)) {
1362 // TODO(davidben): OpenSSL historically checked for writes on the read
1363 // BIO. Can this be removed?
1364 return SSL_ERROR_WANT_WRITE;
1365 }
1366
1367 if (BIO_should_io_special(bio)) {
1368 return bio_retry_reason_to_error(BIO_get_retry_reason(bio));
1369 }
1370
1371 break;
1372 }
1373
1374 case SSL_ERROR_WANT_WRITE: {
1375 BIO *bio = SSL_get_wbio(ssl);
1376 if (BIO_should_write(bio)) {
1377 return SSL_ERROR_WANT_WRITE;
1378 }
1379
1380 if (BIO_should_read(bio)) {
1381 // TODO(davidben): OpenSSL historically checked for reads on the write
1382 // BIO. Can this be removed?
1383 return SSL_ERROR_WANT_READ;
1384 }
1385
1386 if (BIO_should_io_special(bio)) {
1387 return bio_retry_reason_to_error(BIO_get_retry_reason(bio));
1388 }
1389
1390 break;
1391 }
1392 }
1393
1394 return SSL_ERROR_SYSCALL;
1395 }
1396
SSL_error_description(int err)1397 const char *SSL_error_description(int err) {
1398 switch (err) {
1399 case SSL_ERROR_NONE:
1400 return "NONE";
1401 case SSL_ERROR_SSL:
1402 return "SSL";
1403 case SSL_ERROR_WANT_READ:
1404 return "WANT_READ";
1405 case SSL_ERROR_WANT_WRITE:
1406 return "WANT_WRITE";
1407 case SSL_ERROR_WANT_X509_LOOKUP:
1408 return "WANT_X509_LOOKUP";
1409 case SSL_ERROR_SYSCALL:
1410 return "SYSCALL";
1411 case SSL_ERROR_ZERO_RETURN:
1412 return "ZERO_RETURN";
1413 case SSL_ERROR_WANT_CONNECT:
1414 return "WANT_CONNECT";
1415 case SSL_ERROR_WANT_ACCEPT:
1416 return "WANT_ACCEPT";
1417 case SSL_ERROR_WANT_CHANNEL_ID_LOOKUP:
1418 return "WANT_CHANNEL_ID_LOOKUP";
1419 case SSL_ERROR_PENDING_SESSION:
1420 return "PENDING_SESSION";
1421 case SSL_ERROR_PENDING_CERTIFICATE:
1422 return "PENDING_CERTIFICATE";
1423 case SSL_ERROR_WANT_PRIVATE_KEY_OPERATION:
1424 return "WANT_PRIVATE_KEY_OPERATION";
1425 case SSL_ERROR_PENDING_TICKET:
1426 return "PENDING_TICKET";
1427 case SSL_ERROR_EARLY_DATA_REJECTED:
1428 return "EARLY_DATA_REJECTED";
1429 case SSL_ERROR_WANT_CERTIFICATE_VERIFY:
1430 return "WANT_CERTIFICATE_VERIFY";
1431 case SSL_ERROR_HANDOFF:
1432 return "HANDOFF";
1433 case SSL_ERROR_HANDBACK:
1434 return "HANDBACK";
1435 default:
1436 return nullptr;
1437 }
1438 }
1439
SSL_CTX_set_options(SSL_CTX * ctx,uint32_t options)1440 uint32_t SSL_CTX_set_options(SSL_CTX *ctx, uint32_t options) {
1441 ctx->options |= options;
1442 return ctx->options;
1443 }
1444
SSL_CTX_clear_options(SSL_CTX * ctx,uint32_t options)1445 uint32_t SSL_CTX_clear_options(SSL_CTX *ctx, uint32_t options) {
1446 ctx->options &= ~options;
1447 return ctx->options;
1448 }
1449
SSL_CTX_get_options(const SSL_CTX * ctx)1450 uint32_t SSL_CTX_get_options(const SSL_CTX *ctx) { return ctx->options; }
1451
SSL_set_options(SSL * ssl,uint32_t options)1452 uint32_t SSL_set_options(SSL *ssl, uint32_t options) {
1453 ssl->options |= options;
1454 return ssl->options;
1455 }
1456
SSL_clear_options(SSL * ssl,uint32_t options)1457 uint32_t SSL_clear_options(SSL *ssl, uint32_t options) {
1458 ssl->options &= ~options;
1459 return ssl->options;
1460 }
1461
SSL_get_options(const SSL * ssl)1462 uint32_t SSL_get_options(const SSL *ssl) { return ssl->options; }
1463
SSL_CTX_set_mode(SSL_CTX * ctx,uint32_t mode)1464 uint32_t SSL_CTX_set_mode(SSL_CTX *ctx, uint32_t mode) {
1465 ctx->mode |= mode;
1466 return ctx->mode;
1467 }
1468
SSL_CTX_clear_mode(SSL_CTX * ctx,uint32_t mode)1469 uint32_t SSL_CTX_clear_mode(SSL_CTX *ctx, uint32_t mode) {
1470 ctx->mode &= ~mode;
1471 return ctx->mode;
1472 }
1473
SSL_CTX_get_mode(const SSL_CTX * ctx)1474 uint32_t SSL_CTX_get_mode(const SSL_CTX *ctx) { return ctx->mode; }
1475
SSL_set_mode(SSL * ssl,uint32_t mode)1476 uint32_t SSL_set_mode(SSL *ssl, uint32_t mode) {
1477 ssl->mode |= mode;
1478 return ssl->mode;
1479 }
1480
SSL_clear_mode(SSL * ssl,uint32_t mode)1481 uint32_t SSL_clear_mode(SSL *ssl, uint32_t mode) {
1482 ssl->mode &= ~mode;
1483 return ssl->mode;
1484 }
1485
SSL_get_mode(const SSL * ssl)1486 uint32_t SSL_get_mode(const SSL *ssl) { return ssl->mode; }
1487
SSL_CTX_set0_buffer_pool(SSL_CTX * ctx,CRYPTO_BUFFER_POOL * pool)1488 void SSL_CTX_set0_buffer_pool(SSL_CTX *ctx, CRYPTO_BUFFER_POOL *pool) {
1489 ctx->pool = pool;
1490 }
1491
SSL_get_tls_unique(const SSL * ssl,uint8_t * out,size_t * out_len,size_t max_out)1492 int SSL_get_tls_unique(const SSL *ssl, uint8_t *out, size_t *out_len,
1493 size_t max_out) {
1494 *out_len = 0;
1495 OPENSSL_memset(out, 0, max_out);
1496
1497 // tls-unique is not defined for TLS 1.3.
1498 if (!ssl->s3->initial_handshake_complete ||
1499 ssl_protocol_version(ssl) >= TLS1_3_VERSION) {
1500 return 0;
1501 }
1502
1503 // The tls-unique value is the first Finished message in the handshake, which
1504 // is the client's in a full handshake and the server's for a resumption. See
1505 // https://tools.ietf.org/html/rfc5929#section-3.1.
1506 const uint8_t *finished = ssl->s3->previous_client_finished;
1507 size_t finished_len = ssl->s3->previous_client_finished_len;
1508 if (ssl->session != NULL) {
1509 // tls-unique is broken for resumed sessions unless EMS is used.
1510 if (!ssl->session->extended_master_secret) {
1511 return 0;
1512 }
1513 finished = ssl->s3->previous_server_finished;
1514 finished_len = ssl->s3->previous_server_finished_len;
1515 }
1516
1517 *out_len = finished_len;
1518 if (finished_len > max_out) {
1519 *out_len = max_out;
1520 }
1521
1522 OPENSSL_memcpy(out, finished, *out_len);
1523 return 1;
1524 }
1525
set_session_id_context(CERT * cert,const uint8_t * sid_ctx,size_t sid_ctx_len)1526 static int set_session_id_context(CERT *cert, const uint8_t *sid_ctx,
1527 size_t sid_ctx_len) {
1528 if (sid_ctx_len > sizeof(cert->sid_ctx)) {
1529 OPENSSL_PUT_ERROR(SSL, SSL_R_SSL_SESSION_ID_CONTEXT_TOO_LONG);
1530 return 0;
1531 }
1532
1533 static_assert(sizeof(cert->sid_ctx) < 256, "sid_ctx too large");
1534 cert->sid_ctx_length = (uint8_t)sid_ctx_len;
1535 OPENSSL_memcpy(cert->sid_ctx, sid_ctx, sid_ctx_len);
1536 return 1;
1537 }
1538
SSL_CTX_set_session_id_context(SSL_CTX * ctx,const uint8_t * sid_ctx,size_t sid_ctx_len)1539 int SSL_CTX_set_session_id_context(SSL_CTX *ctx, const uint8_t *sid_ctx,
1540 size_t sid_ctx_len) {
1541 return set_session_id_context(ctx->cert.get(), sid_ctx, sid_ctx_len);
1542 }
1543
SSL_set_session_id_context(SSL * ssl,const uint8_t * sid_ctx,size_t sid_ctx_len)1544 int SSL_set_session_id_context(SSL *ssl, const uint8_t *sid_ctx,
1545 size_t sid_ctx_len) {
1546 if (!ssl->config) {
1547 return 0;
1548 }
1549 return set_session_id_context(ssl->config->cert.get(), sid_ctx, sid_ctx_len);
1550 }
1551
SSL_get0_session_id_context(const SSL * ssl,size_t * out_len)1552 const uint8_t *SSL_get0_session_id_context(const SSL *ssl, size_t *out_len) {
1553 if (!ssl->config) {
1554 assert(ssl->config);
1555 *out_len = 0;
1556 return NULL;
1557 }
1558 *out_len = ssl->config->cert->sid_ctx_length;
1559 return ssl->config->cert->sid_ctx;
1560 }
1561
SSL_certs_clear(SSL * ssl)1562 void SSL_certs_clear(SSL *ssl) {
1563 if (!ssl->config) {
1564 return;
1565 }
1566 ssl_cert_clear_certs(ssl->config->cert.get());
1567 }
1568
SSL_get_fd(const SSL * ssl)1569 int SSL_get_fd(const SSL *ssl) { return SSL_get_rfd(ssl); }
1570
SSL_get_rfd(const SSL * ssl)1571 int SSL_get_rfd(const SSL *ssl) {
1572 int ret = -1;
1573 BIO *b = BIO_find_type(SSL_get_rbio(ssl), BIO_TYPE_DESCRIPTOR);
1574 if (b != NULL) {
1575 BIO_get_fd(b, &ret);
1576 }
1577 return ret;
1578 }
1579
SSL_get_wfd(const SSL * ssl)1580 int SSL_get_wfd(const SSL *ssl) {
1581 int ret = -1;
1582 BIO *b = BIO_find_type(SSL_get_wbio(ssl), BIO_TYPE_DESCRIPTOR);
1583 if (b != NULL) {
1584 BIO_get_fd(b, &ret);
1585 }
1586 return ret;
1587 }
1588
SSL_set_fd(SSL * ssl,int fd)1589 int SSL_set_fd(SSL *ssl, int fd) {
1590 BIO *bio = BIO_new(BIO_s_socket());
1591 if (bio == NULL) {
1592 OPENSSL_PUT_ERROR(SSL, ERR_R_BUF_LIB);
1593 return 0;
1594 }
1595 BIO_set_fd(bio, fd, BIO_NOCLOSE);
1596 SSL_set_bio(ssl, bio, bio);
1597 return 1;
1598 }
1599
SSL_set_wfd(SSL * ssl,int fd)1600 int SSL_set_wfd(SSL *ssl, int fd) {
1601 BIO *rbio = SSL_get_rbio(ssl);
1602 if (rbio == NULL || BIO_method_type(rbio) != BIO_TYPE_SOCKET ||
1603 BIO_get_fd(rbio, NULL) != fd) {
1604 BIO *bio = BIO_new(BIO_s_socket());
1605 if (bio == NULL) {
1606 OPENSSL_PUT_ERROR(SSL, ERR_R_BUF_LIB);
1607 return 0;
1608 }
1609 BIO_set_fd(bio, fd, BIO_NOCLOSE);
1610 SSL_set0_wbio(ssl, bio);
1611 } else {
1612 // Copy the rbio over to the wbio.
1613 BIO_up_ref(rbio);
1614 SSL_set0_wbio(ssl, rbio);
1615 }
1616
1617 return 1;
1618 }
1619
SSL_set_rfd(SSL * ssl,int fd)1620 int SSL_set_rfd(SSL *ssl, int fd) {
1621 BIO *wbio = SSL_get_wbio(ssl);
1622 if (wbio == NULL || BIO_method_type(wbio) != BIO_TYPE_SOCKET ||
1623 BIO_get_fd(wbio, NULL) != fd) {
1624 BIO *bio = BIO_new(BIO_s_socket());
1625 if (bio == NULL) {
1626 OPENSSL_PUT_ERROR(SSL, ERR_R_BUF_LIB);
1627 return 0;
1628 }
1629 BIO_set_fd(bio, fd, BIO_NOCLOSE);
1630 SSL_set0_rbio(ssl, bio);
1631 } else {
1632 // Copy the wbio over to the rbio.
1633 BIO_up_ref(wbio);
1634 SSL_set0_rbio(ssl, wbio);
1635 }
1636 return 1;
1637 }
1638
copy_finished(void * out,size_t out_len,const uint8_t * in,size_t in_len)1639 static size_t copy_finished(void *out, size_t out_len, const uint8_t *in,
1640 size_t in_len) {
1641 if (out_len > in_len) {
1642 out_len = in_len;
1643 }
1644 OPENSSL_memcpy(out, in, out_len);
1645 return in_len;
1646 }
1647
SSL_get_finished(const SSL * ssl,void * buf,size_t count)1648 size_t SSL_get_finished(const SSL *ssl, void *buf, size_t count) {
1649 if (!ssl->s3->initial_handshake_complete ||
1650 ssl_protocol_version(ssl) >= TLS1_3_VERSION) {
1651 return 0;
1652 }
1653
1654 if (ssl->server) {
1655 return copy_finished(buf, count, ssl->s3->previous_server_finished,
1656 ssl->s3->previous_server_finished_len);
1657 }
1658
1659 return copy_finished(buf, count, ssl->s3->previous_client_finished,
1660 ssl->s3->previous_client_finished_len);
1661 }
1662
SSL_get_peer_finished(const SSL * ssl,void * buf,size_t count)1663 size_t SSL_get_peer_finished(const SSL *ssl, void *buf, size_t count) {
1664 if (!ssl->s3->initial_handshake_complete ||
1665 ssl_protocol_version(ssl) >= TLS1_3_VERSION) {
1666 return 0;
1667 }
1668
1669 if (ssl->server) {
1670 return copy_finished(buf, count, ssl->s3->previous_client_finished,
1671 ssl->s3->previous_client_finished_len);
1672 }
1673
1674 return copy_finished(buf, count, ssl->s3->previous_server_finished,
1675 ssl->s3->previous_server_finished_len);
1676 }
1677
SSL_get_verify_mode(const SSL * ssl)1678 int SSL_get_verify_mode(const SSL *ssl) {
1679 if (!ssl->config) {
1680 assert(ssl->config);
1681 return -1;
1682 }
1683 return ssl->config->verify_mode;
1684 }
1685
SSL_get_extms_support(const SSL * ssl)1686 int SSL_get_extms_support(const SSL *ssl) {
1687 // TLS 1.3 does not require extended master secret and always reports as
1688 // supporting it.
1689 if (!ssl->s3->have_version) {
1690 return 0;
1691 }
1692 if (ssl_protocol_version(ssl) >= TLS1_3_VERSION) {
1693 return 1;
1694 }
1695
1696 // If the initial handshake completed, query the established session.
1697 if (ssl->s3->established_session != NULL) {
1698 return ssl->s3->established_session->extended_master_secret;
1699 }
1700
1701 // Otherwise, query the in-progress handshake.
1702 if (ssl->s3->hs != NULL) {
1703 return ssl->s3->hs->extended_master_secret;
1704 }
1705 assert(0);
1706 return 0;
1707 }
1708
SSL_CTX_get_read_ahead(const SSL_CTX * ctx)1709 int SSL_CTX_get_read_ahead(const SSL_CTX *ctx) { return 0; }
1710
SSL_get_read_ahead(const SSL * ssl)1711 int SSL_get_read_ahead(const SSL *ssl) { return 0; }
1712
SSL_CTX_set_read_ahead(SSL_CTX * ctx,int yes)1713 int SSL_CTX_set_read_ahead(SSL_CTX *ctx, int yes) { return 1; }
1714
SSL_set_read_ahead(SSL * ssl,int yes)1715 int SSL_set_read_ahead(SSL *ssl, int yes) { return 1; }
1716
SSL_pending(const SSL * ssl)1717 int SSL_pending(const SSL *ssl) {
1718 return static_cast<int>(ssl->s3->pending_app_data.size());
1719 }
1720
SSL_CTX_check_private_key(const SSL_CTX * ctx)1721 int SSL_CTX_check_private_key(const SSL_CTX *ctx) {
1722 return ssl_cert_check_private_key(ctx->cert.get(),
1723 ctx->cert->privatekey.get());
1724 }
1725
SSL_check_private_key(const SSL * ssl)1726 int SSL_check_private_key(const SSL *ssl) {
1727 if (!ssl->config) {
1728 return 0;
1729 }
1730 return ssl_cert_check_private_key(ssl->config->cert.get(),
1731 ssl->config->cert->privatekey.get());
1732 }
1733
SSL_get_default_timeout(const SSL * ssl)1734 long SSL_get_default_timeout(const SSL *ssl) {
1735 return SSL_DEFAULT_SESSION_TIMEOUT;
1736 }
1737
SSL_renegotiate(SSL * ssl)1738 int SSL_renegotiate(SSL *ssl) {
1739 // Caller-initiated renegotiation is not supported.
1740 if (!ssl->s3->renegotiate_pending) {
1741 OPENSSL_PUT_ERROR(SSL, ERR_R_SHOULD_NOT_HAVE_BEEN_CALLED);
1742 return 0;
1743 }
1744
1745 if (!ssl_can_renegotiate(ssl)) {
1746 OPENSSL_PUT_ERROR(SSL, SSL_R_NO_RENEGOTIATION);
1747 return 0;
1748 }
1749
1750 // Renegotiation is only supported at quiescent points in the application
1751 // protocol, namely in HTTPS, just before reading the HTTP response.
1752 // Require the record-layer be idle and avoid complexities of sending a
1753 // handshake record while an application_data record is being written.
1754 if (!ssl->s3->write_buffer.empty() ||
1755 ssl->s3->write_shutdown != ssl_shutdown_none) {
1756 OPENSSL_PUT_ERROR(SSL, SSL_R_NO_RENEGOTIATION);
1757 return 0;
1758 }
1759
1760 // Begin a new handshake.
1761 if (ssl->s3->hs != nullptr) {
1762 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
1763 return 0;
1764 }
1765 ssl->s3->hs = ssl_handshake_new(ssl);
1766 if (ssl->s3->hs == nullptr) {
1767 return 0;
1768 }
1769
1770 ssl->s3->renegotiate_pending = false;
1771 ssl->s3->total_renegotiations++;
1772 return 1;
1773 }
1774
SSL_renegotiate_pending(SSL * ssl)1775 int SSL_renegotiate_pending(SSL *ssl) {
1776 return SSL_in_init(ssl) && ssl->s3->initial_handshake_complete;
1777 }
1778
SSL_total_renegotiations(const SSL * ssl)1779 int SSL_total_renegotiations(const SSL *ssl) {
1780 return ssl->s3->total_renegotiations;
1781 }
1782
SSL_CTX_get_max_cert_list(const SSL_CTX * ctx)1783 size_t SSL_CTX_get_max_cert_list(const SSL_CTX *ctx) {
1784 return ctx->max_cert_list;
1785 }
1786
SSL_CTX_set_max_cert_list(SSL_CTX * ctx,size_t max_cert_list)1787 void SSL_CTX_set_max_cert_list(SSL_CTX *ctx, size_t max_cert_list) {
1788 if (max_cert_list > kMaxHandshakeSize) {
1789 max_cert_list = kMaxHandshakeSize;
1790 }
1791 ctx->max_cert_list = (uint32_t)max_cert_list;
1792 }
1793
SSL_get_max_cert_list(const SSL * ssl)1794 size_t SSL_get_max_cert_list(const SSL *ssl) {
1795 return ssl->max_cert_list;
1796 }
1797
SSL_set_max_cert_list(SSL * ssl,size_t max_cert_list)1798 void SSL_set_max_cert_list(SSL *ssl, size_t max_cert_list) {
1799 if (max_cert_list > kMaxHandshakeSize) {
1800 max_cert_list = kMaxHandshakeSize;
1801 }
1802 ssl->max_cert_list = (uint32_t)max_cert_list;
1803 }
1804
SSL_CTX_set_max_send_fragment(SSL_CTX * ctx,size_t max_send_fragment)1805 int SSL_CTX_set_max_send_fragment(SSL_CTX *ctx, size_t max_send_fragment) {
1806 if (max_send_fragment < 512) {
1807 max_send_fragment = 512;
1808 }
1809 if (max_send_fragment > SSL3_RT_MAX_PLAIN_LENGTH) {
1810 max_send_fragment = SSL3_RT_MAX_PLAIN_LENGTH;
1811 }
1812 ctx->max_send_fragment = (uint16_t)max_send_fragment;
1813
1814 return 1;
1815 }
1816
SSL_set_max_send_fragment(SSL * ssl,size_t max_send_fragment)1817 int SSL_set_max_send_fragment(SSL *ssl, size_t max_send_fragment) {
1818 if (max_send_fragment < 512) {
1819 max_send_fragment = 512;
1820 }
1821 if (max_send_fragment > SSL3_RT_MAX_PLAIN_LENGTH) {
1822 max_send_fragment = SSL3_RT_MAX_PLAIN_LENGTH;
1823 }
1824 ssl->max_send_fragment = (uint16_t)max_send_fragment;
1825
1826 return 1;
1827 }
1828
SSL_set_mtu(SSL * ssl,unsigned mtu)1829 int SSL_set_mtu(SSL *ssl, unsigned mtu) {
1830 if (!SSL_is_dtls(ssl) || mtu < dtls1_min_mtu()) {
1831 return 0;
1832 }
1833 ssl->d1->mtu = mtu;
1834 return 1;
1835 }
1836
SSL_get_secure_renegotiation_support(const SSL * ssl)1837 int SSL_get_secure_renegotiation_support(const SSL *ssl) {
1838 if (!ssl->s3->have_version) {
1839 return 0;
1840 }
1841 return ssl_protocol_version(ssl) >= TLS1_3_VERSION ||
1842 ssl->s3->send_connection_binding;
1843 }
1844
SSL_CTX_sess_number(const SSL_CTX * ctx)1845 size_t SSL_CTX_sess_number(const SSL_CTX *ctx) {
1846 MutexReadLock lock(const_cast<CRYPTO_MUTEX *>(&ctx->lock));
1847 return lh_SSL_SESSION_num_items(ctx->sessions);
1848 }
1849
SSL_CTX_sess_set_cache_size(SSL_CTX * ctx,unsigned long size)1850 unsigned long SSL_CTX_sess_set_cache_size(SSL_CTX *ctx, unsigned long size) {
1851 unsigned long ret = ctx->session_cache_size;
1852 ctx->session_cache_size = size;
1853 return ret;
1854 }
1855
SSL_CTX_sess_get_cache_size(const SSL_CTX * ctx)1856 unsigned long SSL_CTX_sess_get_cache_size(const SSL_CTX *ctx) {
1857 return ctx->session_cache_size;
1858 }
1859
SSL_CTX_set_session_cache_mode(SSL_CTX * ctx,int mode)1860 int SSL_CTX_set_session_cache_mode(SSL_CTX *ctx, int mode) {
1861 int ret = ctx->session_cache_mode;
1862 ctx->session_cache_mode = mode;
1863 return ret;
1864 }
1865
SSL_CTX_get_session_cache_mode(const SSL_CTX * ctx)1866 int SSL_CTX_get_session_cache_mode(const SSL_CTX *ctx) {
1867 return ctx->session_cache_mode;
1868 }
1869
1870
SSL_CTX_get_tlsext_ticket_keys(SSL_CTX * ctx,void * out,size_t len)1871 int SSL_CTX_get_tlsext_ticket_keys(SSL_CTX *ctx, void *out, size_t len) {
1872 if (out == NULL) {
1873 return 48;
1874 }
1875 if (len != 48) {
1876 OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_TICKET_KEYS_LENGTH);
1877 return 0;
1878 }
1879
1880 // The default ticket keys are initialized lazily. Trigger a key
1881 // rotation to initialize them.
1882 if (!ssl_ctx_rotate_ticket_encryption_key(ctx)) {
1883 return 0;
1884 }
1885
1886 uint8_t *out_bytes = reinterpret_cast<uint8_t *>(out);
1887 MutexReadLock lock(&ctx->lock);
1888 OPENSSL_memcpy(out_bytes, ctx->ticket_key_current->name, 16);
1889 OPENSSL_memcpy(out_bytes + 16, ctx->ticket_key_current->hmac_key, 16);
1890 OPENSSL_memcpy(out_bytes + 32, ctx->ticket_key_current->aes_key, 16);
1891 return 1;
1892 }
1893
SSL_CTX_set_tlsext_ticket_keys(SSL_CTX * ctx,const void * in,size_t len)1894 int SSL_CTX_set_tlsext_ticket_keys(SSL_CTX *ctx, const void *in, size_t len) {
1895 if (in == NULL) {
1896 return 48;
1897 }
1898 if (len != 48) {
1899 OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_TICKET_KEYS_LENGTH);
1900 return 0;
1901 }
1902 auto key = MakeUnique<TicketKey>();
1903 if (!key) {
1904 return 0;
1905 }
1906 const uint8_t *in_bytes = reinterpret_cast<const uint8_t *>(in);
1907 OPENSSL_memcpy(key->name, in_bytes, 16);
1908 OPENSSL_memcpy(key->hmac_key, in_bytes + 16, 16);
1909 OPENSSL_memcpy(key->aes_key, in_bytes + 32, 16);
1910 // Disable automatic key rotation for manually-configured keys. This is now
1911 // the caller's responsibility.
1912 key->next_rotation_tv_sec = 0;
1913 ctx->ticket_key_current = std::move(key);
1914 ctx->ticket_key_prev.reset();
1915 return 1;
1916 }
1917
SSL_CTX_set_tlsext_ticket_key_cb(SSL_CTX * ctx,int (* callback)(SSL * ssl,uint8_t * key_name,uint8_t * iv,EVP_CIPHER_CTX * ctx,HMAC_CTX * hmac_ctx,int encrypt))1918 int SSL_CTX_set_tlsext_ticket_key_cb(
1919 SSL_CTX *ctx, int (*callback)(SSL *ssl, uint8_t *key_name, uint8_t *iv,
1920 EVP_CIPHER_CTX *ctx, HMAC_CTX *hmac_ctx,
1921 int encrypt)) {
1922 ctx->ticket_key_cb = callback;
1923 return 1;
1924 }
1925
SSL_CTX_set1_curves(SSL_CTX * ctx,const int * curves,size_t curves_len)1926 int SSL_CTX_set1_curves(SSL_CTX *ctx, const int *curves, size_t curves_len) {
1927 return tls1_set_curves(&ctx->supported_group_list,
1928 MakeConstSpan(curves, curves_len));
1929 }
1930
SSL_set1_curves(SSL * ssl,const int * curves,size_t curves_len)1931 int SSL_set1_curves(SSL *ssl, const int *curves, size_t curves_len) {
1932 if (!ssl->config) {
1933 return 0;
1934 }
1935 return tls1_set_curves(&ssl->config->supported_group_list,
1936 MakeConstSpan(curves, curves_len));
1937 }
1938
SSL_CTX_set1_curves_list(SSL_CTX * ctx,const char * curves)1939 int SSL_CTX_set1_curves_list(SSL_CTX *ctx, const char *curves) {
1940 return tls1_set_curves_list(&ctx->supported_group_list, curves);
1941 }
1942
SSL_set1_curves_list(SSL * ssl,const char * curves)1943 int SSL_set1_curves_list(SSL *ssl, const char *curves) {
1944 if (!ssl->config) {
1945 return 0;
1946 }
1947 return tls1_set_curves_list(&ssl->config->supported_group_list, curves);
1948 }
1949
SSL_get_curve_id(const SSL * ssl)1950 uint16_t SSL_get_curve_id(const SSL *ssl) {
1951 // TODO(davidben): This checks the wrong session if there is a renegotiation
1952 // in progress.
1953 SSL_SESSION *session = SSL_get_session(ssl);
1954 if (session == NULL) {
1955 return 0;
1956 }
1957
1958 return session->group_id;
1959 }
1960
SSL_CTX_set_tmp_dh(SSL_CTX * ctx,const DH * dh)1961 int SSL_CTX_set_tmp_dh(SSL_CTX *ctx, const DH *dh) {
1962 return 1;
1963 }
1964
SSL_set_tmp_dh(SSL * ssl,const DH * dh)1965 int SSL_set_tmp_dh(SSL *ssl, const DH *dh) {
1966 return 1;
1967 }
1968
STACK_OF(SSL_CIPHER)1969 STACK_OF(SSL_CIPHER) *SSL_CTX_get_ciphers(const SSL_CTX *ctx) {
1970 return ctx->cipher_list->ciphers.get();
1971 }
1972
SSL_CTX_cipher_in_group(const SSL_CTX * ctx,size_t i)1973 int SSL_CTX_cipher_in_group(const SSL_CTX *ctx, size_t i) {
1974 if (i >= sk_SSL_CIPHER_num(ctx->cipher_list->ciphers.get())) {
1975 return 0;
1976 }
1977 return ctx->cipher_list->in_group_flags[i];
1978 }
1979
STACK_OF(SSL_CIPHER)1980 STACK_OF(SSL_CIPHER) *SSL_get_ciphers(const SSL *ssl) {
1981 if (ssl == NULL) {
1982 return NULL;
1983 }
1984 if (ssl->config == NULL) {
1985 assert(ssl->config);
1986 return NULL;
1987 }
1988
1989 return ssl->config->cipher_list ? ssl->config->cipher_list->ciphers.get()
1990 : ssl->ctx->cipher_list->ciphers.get();
1991 }
1992
SSL_get_cipher_list(const SSL * ssl,int n)1993 const char *SSL_get_cipher_list(const SSL *ssl, int n) {
1994 if (ssl == NULL) {
1995 return NULL;
1996 }
1997
1998 STACK_OF(SSL_CIPHER) *sk = SSL_get_ciphers(ssl);
1999 if (sk == NULL || n < 0 || (size_t)n >= sk_SSL_CIPHER_num(sk)) {
2000 return NULL;
2001 }
2002
2003 const SSL_CIPHER *c = sk_SSL_CIPHER_value(sk, n);
2004 if (c == NULL) {
2005 return NULL;
2006 }
2007
2008 return c->name;
2009 }
2010
SSL_CTX_set_cipher_list(SSL_CTX * ctx,const char * str)2011 int SSL_CTX_set_cipher_list(SSL_CTX *ctx, const char *str) {
2012 return ssl_create_cipher_list(&ctx->cipher_list, str, false /* not strict */);
2013 }
2014
SSL_CTX_set_strict_cipher_list(SSL_CTX * ctx,const char * str)2015 int SSL_CTX_set_strict_cipher_list(SSL_CTX *ctx, const char *str) {
2016 return ssl_create_cipher_list(&ctx->cipher_list, str, true /* strict */);
2017 }
2018
SSL_set_cipher_list(SSL * ssl,const char * str)2019 int SSL_set_cipher_list(SSL *ssl, const char *str) {
2020 if (!ssl->config) {
2021 return 0;
2022 }
2023 return ssl_create_cipher_list(&ssl->config->cipher_list, str,
2024 false /* not strict */);
2025 }
2026
SSL_set_strict_cipher_list(SSL * ssl,const char * str)2027 int SSL_set_strict_cipher_list(SSL *ssl, const char *str) {
2028 if (!ssl->config) {
2029 return 0;
2030 }
2031 return ssl_create_cipher_list(&ssl->config->cipher_list, str,
2032 true /* strict */);
2033 }
2034
SSL_get_servername(const SSL * ssl,const int type)2035 const char *SSL_get_servername(const SSL *ssl, const int type) {
2036 if (type != TLSEXT_NAMETYPE_host_name) {
2037 return NULL;
2038 }
2039
2040 // Historically, |SSL_get_servername| was also the configuration getter
2041 // corresponding to |SSL_set_tlsext_host_name|.
2042 if (ssl->hostname != nullptr) {
2043 return ssl->hostname.get();
2044 }
2045
2046 return ssl->s3->hostname.get();
2047 }
2048
SSL_get_servername_type(const SSL * ssl)2049 int SSL_get_servername_type(const SSL *ssl) {
2050 if (SSL_get_servername(ssl, TLSEXT_NAMETYPE_host_name) == NULL) {
2051 return -1;
2052 }
2053 return TLSEXT_NAMETYPE_host_name;
2054 }
2055
SSL_CTX_set_custom_verify(SSL_CTX * ctx,int mode,enum ssl_verify_result_t (* callback)(SSL * ssl,uint8_t * out_alert))2056 void SSL_CTX_set_custom_verify(
2057 SSL_CTX *ctx, int mode,
2058 enum ssl_verify_result_t (*callback)(SSL *ssl, uint8_t *out_alert)) {
2059 ctx->verify_mode = mode;
2060 ctx->custom_verify_callback = callback;
2061 }
2062
SSL_set_custom_verify(SSL * ssl,int mode,enum ssl_verify_result_t (* callback)(SSL * ssl,uint8_t * out_alert))2063 void SSL_set_custom_verify(
2064 SSL *ssl, int mode,
2065 enum ssl_verify_result_t (*callback)(SSL *ssl, uint8_t *out_alert)) {
2066 if (!ssl->config) {
2067 return;
2068 }
2069 ssl->config->verify_mode = mode;
2070 ssl->config->custom_verify_callback = callback;
2071 }
2072
SSL_CTX_enable_signed_cert_timestamps(SSL_CTX * ctx)2073 void SSL_CTX_enable_signed_cert_timestamps(SSL_CTX *ctx) {
2074 ctx->signed_cert_timestamps_enabled = true;
2075 }
2076
SSL_enable_signed_cert_timestamps(SSL * ssl)2077 void SSL_enable_signed_cert_timestamps(SSL *ssl) {
2078 if (!ssl->config) {
2079 return;
2080 }
2081 ssl->config->signed_cert_timestamps_enabled = true;
2082 }
2083
SSL_CTX_enable_ocsp_stapling(SSL_CTX * ctx)2084 void SSL_CTX_enable_ocsp_stapling(SSL_CTX *ctx) {
2085 ctx->ocsp_stapling_enabled = true;
2086 }
2087
SSL_enable_ocsp_stapling(SSL * ssl)2088 void SSL_enable_ocsp_stapling(SSL *ssl) {
2089 if (!ssl->config) {
2090 return;
2091 }
2092 ssl->config->ocsp_stapling_enabled = true;
2093 }
2094
SSL_get0_signed_cert_timestamp_list(const SSL * ssl,const uint8_t ** out,size_t * out_len)2095 void SSL_get0_signed_cert_timestamp_list(const SSL *ssl, const uint8_t **out,
2096 size_t *out_len) {
2097 SSL_SESSION *session = SSL_get_session(ssl);
2098 if (ssl->server || !session || !session->signed_cert_timestamp_list) {
2099 *out_len = 0;
2100 *out = NULL;
2101 return;
2102 }
2103
2104 *out = CRYPTO_BUFFER_data(session->signed_cert_timestamp_list.get());
2105 *out_len = CRYPTO_BUFFER_len(session->signed_cert_timestamp_list.get());
2106 }
2107
SSL_get0_ocsp_response(const SSL * ssl,const uint8_t ** out,size_t * out_len)2108 void SSL_get0_ocsp_response(const SSL *ssl, const uint8_t **out,
2109 size_t *out_len) {
2110 SSL_SESSION *session = SSL_get_session(ssl);
2111 if (ssl->server || !session || !session->ocsp_response) {
2112 *out_len = 0;
2113 *out = NULL;
2114 return;
2115 }
2116
2117 *out = CRYPTO_BUFFER_data(session->ocsp_response.get());
2118 *out_len = CRYPTO_BUFFER_len(session->ocsp_response.get());
2119 }
2120
SSL_set_tlsext_host_name(SSL * ssl,const char * name)2121 int SSL_set_tlsext_host_name(SSL *ssl, const char *name) {
2122 ssl->hostname.reset();
2123 if (name == nullptr) {
2124 return 1;
2125 }
2126
2127 size_t len = strlen(name);
2128 if (len == 0 || len > TLSEXT_MAXLEN_host_name) {
2129 OPENSSL_PUT_ERROR(SSL, SSL_R_SSL3_EXT_INVALID_SERVERNAME);
2130 return 0;
2131 }
2132 ssl->hostname.reset(BUF_strdup(name));
2133 if (ssl->hostname == nullptr) {
2134 OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
2135 return 0;
2136 }
2137 return 1;
2138 }
2139
SSL_CTX_set_tlsext_servername_callback(SSL_CTX * ctx,int (* callback)(SSL * ssl,int * out_alert,void * arg))2140 int SSL_CTX_set_tlsext_servername_callback(
2141 SSL_CTX *ctx, int (*callback)(SSL *ssl, int *out_alert, void *arg)) {
2142 ctx->servername_callback = callback;
2143 return 1;
2144 }
2145
SSL_CTX_set_tlsext_servername_arg(SSL_CTX * ctx,void * arg)2146 int SSL_CTX_set_tlsext_servername_arg(SSL_CTX *ctx, void *arg) {
2147 ctx->servername_arg = arg;
2148 return 1;
2149 }
2150
SSL_select_next_proto(uint8_t ** out,uint8_t * out_len,const uint8_t * peer,unsigned peer_len,const uint8_t * supported,unsigned supported_len)2151 int SSL_select_next_proto(uint8_t **out, uint8_t *out_len, const uint8_t *peer,
2152 unsigned peer_len, const uint8_t *supported,
2153 unsigned supported_len) {
2154 const uint8_t *result;
2155 int status;
2156
2157 // For each protocol in peer preference order, see if we support it.
2158 for (unsigned i = 0; i < peer_len;) {
2159 for (unsigned j = 0; j < supported_len;) {
2160 if (peer[i] == supported[j] &&
2161 OPENSSL_memcmp(&peer[i + 1], &supported[j + 1], peer[i]) == 0) {
2162 // We found a match
2163 result = &peer[i];
2164 status = OPENSSL_NPN_NEGOTIATED;
2165 goto found;
2166 }
2167 j += supported[j];
2168 j++;
2169 }
2170 i += peer[i];
2171 i++;
2172 }
2173
2174 // There's no overlap between our protocols and the peer's list.
2175 result = supported;
2176 status = OPENSSL_NPN_NO_OVERLAP;
2177
2178 found:
2179 *out = (uint8_t *)result + 1;
2180 *out_len = result[0];
2181 return status;
2182 }
2183
SSL_get0_next_proto_negotiated(const SSL * ssl,const uint8_t ** out_data,unsigned * out_len)2184 void SSL_get0_next_proto_negotiated(const SSL *ssl, const uint8_t **out_data,
2185 unsigned *out_len) {
2186 *out_data = ssl->s3->next_proto_negotiated.data();
2187 *out_len = ssl->s3->next_proto_negotiated.size();
2188 }
2189
SSL_CTX_set_next_protos_advertised_cb(SSL_CTX * ctx,int (* cb)(SSL * ssl,const uint8_t ** out,unsigned * out_len,void * arg),void * arg)2190 void SSL_CTX_set_next_protos_advertised_cb(
2191 SSL_CTX *ctx,
2192 int (*cb)(SSL *ssl, const uint8_t **out, unsigned *out_len, void *arg),
2193 void *arg) {
2194 ctx->next_protos_advertised_cb = cb;
2195 ctx->next_protos_advertised_cb_arg = arg;
2196 }
2197
SSL_CTX_set_next_proto_select_cb(SSL_CTX * ctx,int (* cb)(SSL * ssl,uint8_t ** out,uint8_t * out_len,const uint8_t * in,unsigned in_len,void * arg),void * arg)2198 void SSL_CTX_set_next_proto_select_cb(
2199 SSL_CTX *ctx, int (*cb)(SSL *ssl, uint8_t **out, uint8_t *out_len,
2200 const uint8_t *in, unsigned in_len, void *arg),
2201 void *arg) {
2202 ctx->next_proto_select_cb = cb;
2203 ctx->next_proto_select_cb_arg = arg;
2204 }
2205
SSL_CTX_set_alpn_protos(SSL_CTX * ctx,const uint8_t * protos,unsigned protos_len)2206 int SSL_CTX_set_alpn_protos(SSL_CTX *ctx, const uint8_t *protos,
2207 unsigned protos_len) {
2208 // Note this function's calling convention is backwards.
2209 return ctx->alpn_client_proto_list.CopyFrom(MakeConstSpan(protos, protos_len))
2210 ? 0
2211 : 1;
2212 }
2213
SSL_set_alpn_protos(SSL * ssl,const uint8_t * protos,unsigned protos_len)2214 int SSL_set_alpn_protos(SSL *ssl, const uint8_t *protos, unsigned protos_len) {
2215 // Note this function's calling convention is backwards.
2216 if (!ssl->config) {
2217 return 1;
2218 }
2219 return ssl->config->alpn_client_proto_list.CopyFrom(
2220 MakeConstSpan(protos, protos_len))
2221 ? 0
2222 : 1;
2223 }
2224
SSL_CTX_set_alpn_select_cb(SSL_CTX * ctx,int (* cb)(SSL * ssl,const uint8_t ** out,uint8_t * out_len,const uint8_t * in,unsigned in_len,void * arg),void * arg)2225 void SSL_CTX_set_alpn_select_cb(SSL_CTX *ctx,
2226 int (*cb)(SSL *ssl, const uint8_t **out,
2227 uint8_t *out_len, const uint8_t *in,
2228 unsigned in_len, void *arg),
2229 void *arg) {
2230 ctx->alpn_select_cb = cb;
2231 ctx->alpn_select_cb_arg = arg;
2232 }
2233
SSL_get0_alpn_selected(const SSL * ssl,const uint8_t ** out_data,unsigned * out_len)2234 void SSL_get0_alpn_selected(const SSL *ssl, const uint8_t **out_data,
2235 unsigned *out_len) {
2236 if (SSL_in_early_data(ssl) && !ssl->server) {
2237 *out_data = ssl->s3->hs->early_session->early_alpn.data();
2238 *out_len = ssl->s3->hs->early_session->early_alpn.size();
2239 } else {
2240 *out_data = ssl->s3->alpn_selected.data();
2241 *out_len = ssl->s3->alpn_selected.size();
2242 }
2243 }
2244
SSL_CTX_set_allow_unknown_alpn_protos(SSL_CTX * ctx,int enabled)2245 void SSL_CTX_set_allow_unknown_alpn_protos(SSL_CTX *ctx, int enabled) {
2246 ctx->allow_unknown_alpn_protos = !!enabled;
2247 }
2248
SSL_CTX_add_cert_compression_alg(SSL_CTX * ctx,uint16_t alg_id,ssl_cert_compression_func_t compress,ssl_cert_decompression_func_t decompress)2249 int SSL_CTX_add_cert_compression_alg(SSL_CTX *ctx, uint16_t alg_id,
2250 ssl_cert_compression_func_t compress,
2251 ssl_cert_decompression_func_t decompress) {
2252 assert(compress != nullptr || decompress != nullptr);
2253
2254 for (const auto &alg : ctx->cert_compression_algs) {
2255 if (alg.alg_id == alg_id) {
2256 return 0;
2257 }
2258 }
2259
2260 CertCompressionAlg alg;
2261 alg.alg_id = alg_id;
2262 alg.compress = compress;
2263 alg.decompress = decompress;
2264 return ctx->cert_compression_algs.Push(alg);
2265 }
2266
SSL_CTX_set_tls_channel_id_enabled(SSL_CTX * ctx,int enabled)2267 void SSL_CTX_set_tls_channel_id_enabled(SSL_CTX *ctx, int enabled) {
2268 ctx->channel_id_enabled = !!enabled;
2269 }
2270
SSL_CTX_enable_tls_channel_id(SSL_CTX * ctx)2271 int SSL_CTX_enable_tls_channel_id(SSL_CTX *ctx) {
2272 SSL_CTX_set_tls_channel_id_enabled(ctx, 1);
2273 return 1;
2274 }
2275
SSL_set_tls_channel_id_enabled(SSL * ssl,int enabled)2276 void SSL_set_tls_channel_id_enabled(SSL *ssl, int enabled) {
2277 if (!ssl->config) {
2278 return;
2279 }
2280 ssl->config->channel_id_enabled = !!enabled;
2281 }
2282
SSL_enable_tls_channel_id(SSL * ssl)2283 int SSL_enable_tls_channel_id(SSL *ssl) {
2284 SSL_set_tls_channel_id_enabled(ssl, 1);
2285 return 1;
2286 }
2287
is_p256_key(EVP_PKEY * private_key)2288 static int is_p256_key(EVP_PKEY *private_key) {
2289 const EC_KEY *ec_key = EVP_PKEY_get0_EC_KEY(private_key);
2290 return ec_key != NULL &&
2291 EC_GROUP_get_curve_name(EC_KEY_get0_group(ec_key)) ==
2292 NID_X9_62_prime256v1;
2293 }
2294
SSL_CTX_set1_tls_channel_id(SSL_CTX * ctx,EVP_PKEY * private_key)2295 int SSL_CTX_set1_tls_channel_id(SSL_CTX *ctx, EVP_PKEY *private_key) {
2296 if (!is_p256_key(private_key)) {
2297 OPENSSL_PUT_ERROR(SSL, SSL_R_CHANNEL_ID_NOT_P256);
2298 return 0;
2299 }
2300
2301 ctx->channel_id_private = UpRef(private_key);
2302 ctx->channel_id_enabled = true;
2303
2304 return 1;
2305 }
2306
SSL_set1_tls_channel_id(SSL * ssl,EVP_PKEY * private_key)2307 int SSL_set1_tls_channel_id(SSL *ssl, EVP_PKEY *private_key) {
2308 if (!ssl->config) {
2309 return 0;
2310 }
2311 if (!is_p256_key(private_key)) {
2312 OPENSSL_PUT_ERROR(SSL, SSL_R_CHANNEL_ID_NOT_P256);
2313 return 0;
2314 }
2315
2316 ssl->config->channel_id_private = UpRef(private_key);
2317 ssl->config->channel_id_enabled = true;
2318
2319 return 1;
2320 }
2321
SSL_get_tls_channel_id(SSL * ssl,uint8_t * out,size_t max_out)2322 size_t SSL_get_tls_channel_id(SSL *ssl, uint8_t *out, size_t max_out) {
2323 if (!ssl->s3->channel_id_valid) {
2324 return 0;
2325 }
2326 OPENSSL_memcpy(out, ssl->s3->channel_id, (max_out < 64) ? max_out : 64);
2327 return 64;
2328 }
2329
SSL_set_token_binding_params(SSL * ssl,const uint8_t * params,size_t len)2330 int SSL_set_token_binding_params(SSL *ssl, const uint8_t *params, size_t len) {
2331 if (!ssl->config) {
2332 return 0;
2333 }
2334 if (len > 256) {
2335 OPENSSL_PUT_ERROR(SSL, ERR_R_OVERFLOW);
2336 return 0;
2337 }
2338 return ssl->config->token_binding_params.CopyFrom(MakeConstSpan(params, len));
2339 }
2340
SSL_is_token_binding_negotiated(const SSL * ssl)2341 int SSL_is_token_binding_negotiated(const SSL *ssl) {
2342 return ssl->s3->token_binding_negotiated;
2343 }
2344
SSL_get_negotiated_token_binding_param(const SSL * ssl)2345 uint8_t SSL_get_negotiated_token_binding_param(const SSL *ssl) {
2346 return ssl->s3->negotiated_token_binding_param;
2347 }
2348
SSL_get0_certificate_types(const SSL * ssl,const uint8_t ** out_types)2349 size_t SSL_get0_certificate_types(const SSL *ssl, const uint8_t **out_types) {
2350 Span<const uint8_t> types;
2351 if (!ssl->server && ssl->s3->hs != nullptr) {
2352 types = ssl->s3->hs->certificate_types;
2353 }
2354 *out_types = types.data();
2355 return types.size();
2356 }
2357
SSL_get0_peer_verify_algorithms(const SSL * ssl,const uint16_t ** out_sigalgs)2358 size_t SSL_get0_peer_verify_algorithms(const SSL *ssl,
2359 const uint16_t **out_sigalgs) {
2360 Span<const uint16_t> sigalgs;
2361 if (ssl->s3->hs != nullptr) {
2362 sigalgs = ssl->s3->hs->peer_sigalgs;
2363 }
2364 *out_sigalgs = sigalgs.data();
2365 return sigalgs.size();
2366 }
2367
SSL_get_privatekey(const SSL * ssl)2368 EVP_PKEY *SSL_get_privatekey(const SSL *ssl) {
2369 if (!ssl->config) {
2370 assert(ssl->config);
2371 return NULL;
2372 }
2373 if (ssl->config->cert != NULL) {
2374 return ssl->config->cert->privatekey.get();
2375 }
2376
2377 return NULL;
2378 }
2379
SSL_CTX_get0_privatekey(const SSL_CTX * ctx)2380 EVP_PKEY *SSL_CTX_get0_privatekey(const SSL_CTX *ctx) {
2381 if (ctx->cert != NULL) {
2382 return ctx->cert->privatekey.get();
2383 }
2384
2385 return NULL;
2386 }
2387
SSL_get_current_cipher(const SSL * ssl)2388 const SSL_CIPHER *SSL_get_current_cipher(const SSL *ssl) {
2389 const SSL_SESSION *session = SSL_get_session(ssl);
2390 return session == nullptr ? nullptr : session->cipher;
2391 }
2392
SSL_session_reused(const SSL * ssl)2393 int SSL_session_reused(const SSL *ssl) {
2394 return ssl->s3->session_reused || SSL_in_early_data(ssl);
2395 }
2396
SSL_get_current_compression(SSL * ssl)2397 const COMP_METHOD *SSL_get_current_compression(SSL *ssl) { return NULL; }
2398
SSL_get_current_expansion(SSL * ssl)2399 const COMP_METHOD *SSL_get_current_expansion(SSL *ssl) { return NULL; }
2400
SSL_get_server_tmp_key(SSL * ssl,EVP_PKEY ** out_key)2401 int SSL_get_server_tmp_key(SSL *ssl, EVP_PKEY **out_key) { return 0; }
2402
SSL_CTX_set_quiet_shutdown(SSL_CTX * ctx,int mode)2403 void SSL_CTX_set_quiet_shutdown(SSL_CTX *ctx, int mode) {
2404 ctx->quiet_shutdown = (mode != 0);
2405 }
2406
SSL_CTX_get_quiet_shutdown(const SSL_CTX * ctx)2407 int SSL_CTX_get_quiet_shutdown(const SSL_CTX *ctx) {
2408 return ctx->quiet_shutdown;
2409 }
2410
SSL_set_quiet_shutdown(SSL * ssl,int mode)2411 void SSL_set_quiet_shutdown(SSL *ssl, int mode) {
2412 ssl->quiet_shutdown = (mode != 0);
2413 }
2414
SSL_get_quiet_shutdown(const SSL * ssl)2415 int SSL_get_quiet_shutdown(const SSL *ssl) { return ssl->quiet_shutdown; }
2416
SSL_set_shutdown(SSL * ssl,int mode)2417 void SSL_set_shutdown(SSL *ssl, int mode) {
2418 // It is an error to clear any bits that have already been set. (We can't try
2419 // to get a second close_notify or send two.)
2420 assert((SSL_get_shutdown(ssl) & mode) == SSL_get_shutdown(ssl));
2421
2422 if (mode & SSL_RECEIVED_SHUTDOWN &&
2423 ssl->s3->read_shutdown == ssl_shutdown_none) {
2424 ssl->s3->read_shutdown = ssl_shutdown_close_notify;
2425 }
2426
2427 if (mode & SSL_SENT_SHUTDOWN &&
2428 ssl->s3->write_shutdown == ssl_shutdown_none) {
2429 ssl->s3->write_shutdown = ssl_shutdown_close_notify;
2430 }
2431 }
2432
SSL_get_shutdown(const SSL * ssl)2433 int SSL_get_shutdown(const SSL *ssl) {
2434 int ret = 0;
2435 if (ssl->s3->read_shutdown != ssl_shutdown_none) {
2436 // Historically, OpenSSL set |SSL_RECEIVED_SHUTDOWN| on both close_notify
2437 // and fatal alert.
2438 ret |= SSL_RECEIVED_SHUTDOWN;
2439 }
2440 if (ssl->s3->write_shutdown == ssl_shutdown_close_notify) {
2441 // Historically, OpenSSL set |SSL_SENT_SHUTDOWN| on only close_notify.
2442 ret |= SSL_SENT_SHUTDOWN;
2443 }
2444 return ret;
2445 }
2446
SSL_get_SSL_CTX(const SSL * ssl)2447 SSL_CTX *SSL_get_SSL_CTX(const SSL *ssl) { return ssl->ctx.get(); }
2448
SSL_set_SSL_CTX(SSL * ssl,SSL_CTX * ctx)2449 SSL_CTX *SSL_set_SSL_CTX(SSL *ssl, SSL_CTX *ctx) {
2450 if (!ssl->config) {
2451 return NULL;
2452 }
2453 if (ssl->ctx.get() == ctx) {
2454 return ssl->ctx.get();
2455 }
2456
2457 // One cannot change the X.509 callbacks during a connection.
2458 if (ssl->ctx->x509_method != ctx->x509_method) {
2459 assert(0);
2460 return NULL;
2461 }
2462
2463 UniquePtr<CERT> new_cert = ssl_cert_dup(ctx->cert.get());
2464 if (!new_cert) {
2465 return nullptr;
2466 }
2467
2468 ssl->config->cert = std::move(new_cert);
2469 ssl->ctx = UpRef(ctx);
2470 ssl->enable_early_data = ssl->ctx->enable_early_data;
2471
2472 return ssl->ctx.get();
2473 }
2474
SSL_set_info_callback(SSL * ssl,void (* cb)(const SSL * ssl,int type,int value))2475 void SSL_set_info_callback(SSL *ssl,
2476 void (*cb)(const SSL *ssl, int type, int value)) {
2477 ssl->info_callback = cb;
2478 }
2479
SSL_get_info_callback(const SSL * ssl)2480 void (*SSL_get_info_callback(const SSL *ssl))(const SSL *ssl, int type,
2481 int value) {
2482 return ssl->info_callback;
2483 }
2484
SSL_state(const SSL * ssl)2485 int SSL_state(const SSL *ssl) {
2486 return SSL_in_init(ssl) ? SSL_ST_INIT : SSL_ST_OK;
2487 }
2488
SSL_set_state(SSL * ssl,int state)2489 void SSL_set_state(SSL *ssl, int state) { }
2490
SSL_get_shared_ciphers(const SSL * ssl,char * buf,int len)2491 char *SSL_get_shared_ciphers(const SSL *ssl, char *buf, int len) {
2492 if (len <= 0) {
2493 return NULL;
2494 }
2495 buf[0] = '\0';
2496 return buf;
2497 }
2498
SSL_CTX_set_quic_method(SSL_CTX * ctx,const SSL_QUIC_METHOD * quic_method)2499 int SSL_CTX_set_quic_method(SSL_CTX *ctx, const SSL_QUIC_METHOD *quic_method) {
2500 if (ctx->method->is_dtls) {
2501 return 0;
2502 }
2503 ctx->quic_method = quic_method;
2504 return 1;
2505 }
2506
SSL_set_quic_method(SSL * ssl,const SSL_QUIC_METHOD * quic_method)2507 int SSL_set_quic_method(SSL *ssl, const SSL_QUIC_METHOD *quic_method) {
2508 if (ssl->method->is_dtls) {
2509 return 0;
2510 }
2511 ssl->quic_method = quic_method;
2512 return 1;
2513 }
2514
SSL_get_ex_new_index(long argl,void * argp,CRYPTO_EX_unused * unused,CRYPTO_EX_dup * dup_unused,CRYPTO_EX_free * free_func)2515 int SSL_get_ex_new_index(long argl, void *argp, CRYPTO_EX_unused *unused,
2516 CRYPTO_EX_dup *dup_unused, CRYPTO_EX_free *free_func) {
2517 int index;
2518 if (!CRYPTO_get_ex_new_index(&g_ex_data_class_ssl, &index, argl, argp,
2519 free_func)) {
2520 return -1;
2521 }
2522 return index;
2523 }
2524
SSL_set_ex_data(SSL * ssl,int idx,void * data)2525 int SSL_set_ex_data(SSL *ssl, int idx, void *data) {
2526 return CRYPTO_set_ex_data(&ssl->ex_data, idx, data);
2527 }
2528
SSL_get_ex_data(const SSL * ssl,int idx)2529 void *SSL_get_ex_data(const SSL *ssl, int idx) {
2530 return CRYPTO_get_ex_data(&ssl->ex_data, idx);
2531 }
2532
SSL_CTX_get_ex_new_index(long argl,void * argp,CRYPTO_EX_unused * unused,CRYPTO_EX_dup * dup_unused,CRYPTO_EX_free * free_func)2533 int SSL_CTX_get_ex_new_index(long argl, void *argp, CRYPTO_EX_unused *unused,
2534 CRYPTO_EX_dup *dup_unused,
2535 CRYPTO_EX_free *free_func) {
2536 int index;
2537 if (!CRYPTO_get_ex_new_index(&g_ex_data_class_ssl_ctx, &index, argl, argp,
2538 free_func)) {
2539 return -1;
2540 }
2541 return index;
2542 }
2543
SSL_CTX_set_ex_data(SSL_CTX * ctx,int idx,void * data)2544 int SSL_CTX_set_ex_data(SSL_CTX *ctx, int idx, void *data) {
2545 return CRYPTO_set_ex_data(&ctx->ex_data, idx, data);
2546 }
2547
SSL_CTX_get_ex_data(const SSL_CTX * ctx,int idx)2548 void *SSL_CTX_get_ex_data(const SSL_CTX *ctx, int idx) {
2549 return CRYPTO_get_ex_data(&ctx->ex_data, idx);
2550 }
2551
SSL_want(const SSL * ssl)2552 int SSL_want(const SSL *ssl) { return ssl->s3->rwstate; }
2553
SSL_CTX_set_tmp_rsa_callback(SSL_CTX * ctx,RSA * (* cb)(SSL * ssl,int is_export,int keylength))2554 void SSL_CTX_set_tmp_rsa_callback(SSL_CTX *ctx,
2555 RSA *(*cb)(SSL *ssl, int is_export,
2556 int keylength)) {}
2557
SSL_set_tmp_rsa_callback(SSL * ssl,RSA * (* cb)(SSL * ssl,int is_export,int keylength))2558 void SSL_set_tmp_rsa_callback(SSL *ssl, RSA *(*cb)(SSL *ssl, int is_export,
2559 int keylength)) {}
2560
SSL_CTX_set_tmp_dh_callback(SSL_CTX * ctx,DH * (* cb)(SSL * ssl,int is_export,int keylength))2561 void SSL_CTX_set_tmp_dh_callback(SSL_CTX *ctx,
2562 DH *(*cb)(SSL *ssl, int is_export,
2563 int keylength)) {}
2564
SSL_set_tmp_dh_callback(SSL * ssl,DH * (* cb)(SSL * ssl,int is_export,int keylength))2565 void SSL_set_tmp_dh_callback(SSL *ssl, DH *(*cb)(SSL *ssl, int is_export,
2566 int keylength)) {}
2567
use_psk_identity_hint(UniquePtr<char> * out,const char * identity_hint)2568 static int use_psk_identity_hint(UniquePtr<char> *out,
2569 const char *identity_hint) {
2570 if (identity_hint != NULL && strlen(identity_hint) > PSK_MAX_IDENTITY_LEN) {
2571 OPENSSL_PUT_ERROR(SSL, SSL_R_DATA_LENGTH_TOO_LONG);
2572 return 0;
2573 }
2574
2575 // Clear currently configured hint, if any.
2576 out->reset();
2577
2578 // Treat the empty hint as not supplying one. Plain PSK makes it possible to
2579 // send either no hint (omit ServerKeyExchange) or an empty hint, while
2580 // ECDHE_PSK can only spell empty hint. Having different capabilities is odd,
2581 // so we interpret empty and missing as identical.
2582 if (identity_hint != NULL && identity_hint[0] != '\0') {
2583 out->reset(BUF_strdup(identity_hint));
2584 if (*out == nullptr) {
2585 return 0;
2586 }
2587 }
2588
2589 return 1;
2590 }
2591
SSL_CTX_use_psk_identity_hint(SSL_CTX * ctx,const char * identity_hint)2592 int SSL_CTX_use_psk_identity_hint(SSL_CTX *ctx, const char *identity_hint) {
2593 return use_psk_identity_hint(&ctx->psk_identity_hint, identity_hint);
2594 }
2595
SSL_use_psk_identity_hint(SSL * ssl,const char * identity_hint)2596 int SSL_use_psk_identity_hint(SSL *ssl, const char *identity_hint) {
2597 if (!ssl->config) {
2598 return 0;
2599 }
2600 return use_psk_identity_hint(&ssl->config->psk_identity_hint, identity_hint);
2601 }
2602
SSL_get_psk_identity_hint(const SSL * ssl)2603 const char *SSL_get_psk_identity_hint(const SSL *ssl) {
2604 if (ssl == NULL) {
2605 return NULL;
2606 }
2607 if (ssl->config == NULL) {
2608 assert(ssl->config);
2609 return NULL;
2610 }
2611 return ssl->config->psk_identity_hint.get();
2612 }
2613
SSL_get_psk_identity(const SSL * ssl)2614 const char *SSL_get_psk_identity(const SSL *ssl) {
2615 if (ssl == NULL) {
2616 return NULL;
2617 }
2618 SSL_SESSION *session = SSL_get_session(ssl);
2619 if (session == NULL) {
2620 return NULL;
2621 }
2622 return session->psk_identity.get();
2623 }
2624
SSL_set_psk_client_callback(SSL * ssl,unsigned (* cb)(SSL * ssl,const char * hint,char * identity,unsigned max_identity_len,uint8_t * psk,unsigned max_psk_len))2625 void SSL_set_psk_client_callback(
2626 SSL *ssl, unsigned (*cb)(SSL *ssl, const char *hint, char *identity,
2627 unsigned max_identity_len, uint8_t *psk,
2628 unsigned max_psk_len)) {
2629 if (!ssl->config) {
2630 return;
2631 }
2632 ssl->config->psk_client_callback = cb;
2633 }
2634
SSL_CTX_set_psk_client_callback(SSL_CTX * ctx,unsigned (* cb)(SSL * ssl,const char * hint,char * identity,unsigned max_identity_len,uint8_t * psk,unsigned max_psk_len))2635 void SSL_CTX_set_psk_client_callback(
2636 SSL_CTX *ctx, unsigned (*cb)(SSL *ssl, const char *hint, char *identity,
2637 unsigned max_identity_len, uint8_t *psk,
2638 unsigned max_psk_len)) {
2639 ctx->psk_client_callback = cb;
2640 }
2641
SSL_set_psk_server_callback(SSL * ssl,unsigned (* cb)(SSL * ssl,const char * identity,uint8_t * psk,unsigned max_psk_len))2642 void SSL_set_psk_server_callback(
2643 SSL *ssl, unsigned (*cb)(SSL *ssl, const char *identity, uint8_t *psk,
2644 unsigned max_psk_len)) {
2645 if (!ssl->config) {
2646 return;
2647 }
2648 ssl->config->psk_server_callback = cb;
2649 }
2650
SSL_CTX_set_psk_server_callback(SSL_CTX * ctx,unsigned (* cb)(SSL * ssl,const char * identity,uint8_t * psk,unsigned max_psk_len))2651 void SSL_CTX_set_psk_server_callback(
2652 SSL_CTX *ctx, unsigned (*cb)(SSL *ssl, const char *identity,
2653 uint8_t *psk, unsigned max_psk_len)) {
2654 ctx->psk_server_callback = cb;
2655 }
2656
SSL_CTX_set_msg_callback(SSL_CTX * ctx,void (* cb)(int write_p,int version,int content_type,const void * buf,size_t len,SSL * ssl,void * arg))2657 void SSL_CTX_set_msg_callback(SSL_CTX *ctx,
2658 void (*cb)(int write_p, int version,
2659 int content_type, const void *buf,
2660 size_t len, SSL *ssl, void *arg)) {
2661 ctx->msg_callback = cb;
2662 }
2663
SSL_CTX_set_msg_callback_arg(SSL_CTX * ctx,void * arg)2664 void SSL_CTX_set_msg_callback_arg(SSL_CTX *ctx, void *arg) {
2665 ctx->msg_callback_arg = arg;
2666 }
2667
SSL_set_msg_callback(SSL * ssl,void (* cb)(int write_p,int version,int content_type,const void * buf,size_t len,SSL * ssl,void * arg))2668 void SSL_set_msg_callback(SSL *ssl,
2669 void (*cb)(int write_p, int version, int content_type,
2670 const void *buf, size_t len, SSL *ssl,
2671 void *arg)) {
2672 ssl->msg_callback = cb;
2673 }
2674
SSL_set_msg_callback_arg(SSL * ssl,void * arg)2675 void SSL_set_msg_callback_arg(SSL *ssl, void *arg) {
2676 ssl->msg_callback_arg = arg;
2677 }
2678
SSL_CTX_set_keylog_callback(SSL_CTX * ctx,void (* cb)(const SSL * ssl,const char * line))2679 void SSL_CTX_set_keylog_callback(SSL_CTX *ctx,
2680 void (*cb)(const SSL *ssl, const char *line)) {
2681 ctx->keylog_callback = cb;
2682 }
2683
SSL_CTX_get_keylog_callback(const SSL_CTX * ctx)2684 void (*SSL_CTX_get_keylog_callback(const SSL_CTX *ctx))(const SSL *ssl,
2685 const char *line) {
2686 return ctx->keylog_callback;
2687 }
2688
SSL_CTX_set_current_time_cb(SSL_CTX * ctx,void (* cb)(const SSL * ssl,struct timeval * out_clock))2689 void SSL_CTX_set_current_time_cb(SSL_CTX *ctx,
2690 void (*cb)(const SSL *ssl,
2691 struct timeval *out_clock)) {
2692 ctx->current_time_cb = cb;
2693 }
2694
SSL_is_init_finished(const SSL * ssl)2695 int SSL_is_init_finished(const SSL *ssl) {
2696 return !SSL_in_init(ssl);
2697 }
2698
SSL_in_init(const SSL * ssl)2699 int SSL_in_init(const SSL *ssl) {
2700 // This returns false once all the handshake state has been finalized, to
2701 // allow callbacks and getters based on SSL_in_init to return the correct
2702 // values.
2703 SSL_HANDSHAKE *hs = ssl->s3->hs.get();
2704 return hs != nullptr && !hs->handshake_finalized;
2705 }
2706
SSL_in_false_start(const SSL * ssl)2707 int SSL_in_false_start(const SSL *ssl) {
2708 if (ssl->s3->hs == NULL) {
2709 return 0;
2710 }
2711 return ssl->s3->hs->in_false_start;
2712 }
2713
SSL_cutthrough_complete(const SSL * ssl)2714 int SSL_cutthrough_complete(const SSL *ssl) {
2715 return SSL_in_false_start(ssl);
2716 }
2717
SSL_is_server(const SSL * ssl)2718 int SSL_is_server(const SSL *ssl) { return ssl->server; }
2719
SSL_is_dtls(const SSL * ssl)2720 int SSL_is_dtls(const SSL *ssl) { return ssl->method->is_dtls; }
2721
SSL_CTX_set_select_certificate_cb(SSL_CTX * ctx,enum ssl_select_cert_result_t (* cb)(const SSL_CLIENT_HELLO *))2722 void SSL_CTX_set_select_certificate_cb(
2723 SSL_CTX *ctx,
2724 enum ssl_select_cert_result_t (*cb)(const SSL_CLIENT_HELLO *)) {
2725 ctx->select_certificate_cb = cb;
2726 }
2727
SSL_CTX_set_dos_protection_cb(SSL_CTX * ctx,int (* cb)(const SSL_CLIENT_HELLO *))2728 void SSL_CTX_set_dos_protection_cb(SSL_CTX *ctx,
2729 int (*cb)(const SSL_CLIENT_HELLO *)) {
2730 ctx->dos_protection_cb = cb;
2731 }
2732
SSL_CTX_set_reverify_on_resume(SSL_CTX * ctx,int enabled)2733 void SSL_CTX_set_reverify_on_resume(SSL_CTX *ctx, int enabled) {
2734 ctx->reverify_on_resume = !!enabled;
2735 }
2736
SSL_set_enforce_rsa_key_usage(SSL * ssl,int enabled)2737 void SSL_set_enforce_rsa_key_usage(SSL *ssl, int enabled) {
2738 if (!ssl->config) {
2739 return;
2740 }
2741 ssl->config->enforce_rsa_key_usage = !!enabled;
2742 }
2743
SSL_set_renegotiate_mode(SSL * ssl,enum ssl_renegotiate_mode_t mode)2744 void SSL_set_renegotiate_mode(SSL *ssl, enum ssl_renegotiate_mode_t mode) {
2745 ssl->renegotiate_mode = mode;
2746
2747 // Check if |ssl_can_renegotiate| has changed and the configuration may now be
2748 // shed. HTTP clients may initially allow renegotiation for HTTP/1.1, and then
2749 // disable after the handshake once the ALPN protocol is known to be HTTP/2.
2750 ssl_maybe_shed_handshake_config(ssl);
2751 }
2752
SSL_get_ivs(const SSL * ssl,const uint8_t ** out_read_iv,const uint8_t ** out_write_iv,size_t * out_iv_len)2753 int SSL_get_ivs(const SSL *ssl, const uint8_t **out_read_iv,
2754 const uint8_t **out_write_iv, size_t *out_iv_len) {
2755 size_t write_iv_len;
2756 if (!ssl->s3->aead_read_ctx->GetIV(out_read_iv, out_iv_len) ||
2757 !ssl->s3->aead_write_ctx->GetIV(out_write_iv, &write_iv_len) ||
2758 *out_iv_len != write_iv_len) {
2759 return 0;
2760 }
2761
2762 return 1;
2763 }
2764
be_to_u64(const uint8_t in[8])2765 static uint64_t be_to_u64(const uint8_t in[8]) {
2766 return (((uint64_t)in[0]) << 56) | (((uint64_t)in[1]) << 48) |
2767 (((uint64_t)in[2]) << 40) | (((uint64_t)in[3]) << 32) |
2768 (((uint64_t)in[4]) << 24) | (((uint64_t)in[5]) << 16) |
2769 (((uint64_t)in[6]) << 8) | ((uint64_t)in[7]);
2770 }
2771
SSL_get_read_sequence(const SSL * ssl)2772 uint64_t SSL_get_read_sequence(const SSL *ssl) {
2773 // TODO(davidben): Internally represent sequence numbers as uint64_t.
2774 if (SSL_is_dtls(ssl)) {
2775 // max_seq_num already includes the epoch.
2776 assert(ssl->d1->r_epoch == (ssl->d1->bitmap.max_seq_num >> 48));
2777 return ssl->d1->bitmap.max_seq_num;
2778 }
2779 return be_to_u64(ssl->s3->read_sequence);
2780 }
2781
SSL_get_write_sequence(const SSL * ssl)2782 uint64_t SSL_get_write_sequence(const SSL *ssl) {
2783 uint64_t ret = be_to_u64(ssl->s3->write_sequence);
2784 if (SSL_is_dtls(ssl)) {
2785 assert((ret >> 48) == 0);
2786 ret |= ((uint64_t)ssl->d1->w_epoch) << 48;
2787 }
2788 return ret;
2789 }
2790
SSL_get_peer_signature_algorithm(const SSL * ssl)2791 uint16_t SSL_get_peer_signature_algorithm(const SSL *ssl) {
2792 // TODO(davidben): This checks the wrong session if there is a renegotiation
2793 // in progress.
2794 SSL_SESSION *session = SSL_get_session(ssl);
2795 if (session == NULL) {
2796 return 0;
2797 }
2798
2799 return session->peer_signature_algorithm;
2800 }
2801
SSL_get_client_random(const SSL * ssl,uint8_t * out,size_t max_out)2802 size_t SSL_get_client_random(const SSL *ssl, uint8_t *out, size_t max_out) {
2803 if (max_out == 0) {
2804 return sizeof(ssl->s3->client_random);
2805 }
2806 if (max_out > sizeof(ssl->s3->client_random)) {
2807 max_out = sizeof(ssl->s3->client_random);
2808 }
2809 OPENSSL_memcpy(out, ssl->s3->client_random, max_out);
2810 return max_out;
2811 }
2812
SSL_get_server_random(const SSL * ssl,uint8_t * out,size_t max_out)2813 size_t SSL_get_server_random(const SSL *ssl, uint8_t *out, size_t max_out) {
2814 if (max_out == 0) {
2815 return sizeof(ssl->s3->server_random);
2816 }
2817 if (max_out > sizeof(ssl->s3->server_random)) {
2818 max_out = sizeof(ssl->s3->server_random);
2819 }
2820 OPENSSL_memcpy(out, ssl->s3->server_random, max_out);
2821 return max_out;
2822 }
2823
SSL_get_pending_cipher(const SSL * ssl)2824 const SSL_CIPHER *SSL_get_pending_cipher(const SSL *ssl) {
2825 SSL_HANDSHAKE *hs = ssl->s3->hs.get();
2826 if (hs == NULL) {
2827 return NULL;
2828 }
2829 return hs->new_cipher;
2830 }
2831
SSL_set_retain_only_sha256_of_client_certs(SSL * ssl,int enabled)2832 void SSL_set_retain_only_sha256_of_client_certs(SSL *ssl, int enabled) {
2833 if (!ssl->config) {
2834 return;
2835 }
2836 ssl->config->retain_only_sha256_of_client_certs = !!enabled;
2837 }
2838
SSL_CTX_set_retain_only_sha256_of_client_certs(SSL_CTX * ctx,int enabled)2839 void SSL_CTX_set_retain_only_sha256_of_client_certs(SSL_CTX *ctx, int enabled) {
2840 ctx->retain_only_sha256_of_client_certs = !!enabled;
2841 }
2842
SSL_CTX_set_grease_enabled(SSL_CTX * ctx,int enabled)2843 void SSL_CTX_set_grease_enabled(SSL_CTX *ctx, int enabled) {
2844 ctx->grease_enabled = !!enabled;
2845 }
2846
SSL_get_ticket_age_skew(const SSL * ssl)2847 int32_t SSL_get_ticket_age_skew(const SSL *ssl) {
2848 return ssl->s3->ticket_age_skew;
2849 }
2850
SSL_CTX_set_false_start_allowed_without_alpn(SSL_CTX * ctx,int allowed)2851 void SSL_CTX_set_false_start_allowed_without_alpn(SSL_CTX *ctx, int allowed) {
2852 ctx->false_start_allowed_without_alpn = !!allowed;
2853 }
2854
SSL_is_tls13_downgrade(const SSL * ssl)2855 int SSL_is_tls13_downgrade(const SSL *ssl) { return ssl->s3->tls13_downgrade; }
2856
SSL_CTX_set_ignore_tls13_downgrade(SSL_CTX * ctx,int ignore)2857 void SSL_CTX_set_ignore_tls13_downgrade(SSL_CTX *ctx, int ignore) {
2858 ctx->ignore_tls13_downgrade = !!ignore;
2859 }
2860
SSL_set_ignore_tls13_downgrade(SSL * ssl,int ignore)2861 void SSL_set_ignore_tls13_downgrade(SSL *ssl, int ignore) {
2862 if (!ssl->config) {
2863 return;
2864 }
2865 ssl->config->ignore_tls13_downgrade = !!ignore;
2866 }
2867
SSL_set_shed_handshake_config(SSL * ssl,int enable)2868 void SSL_set_shed_handshake_config(SSL *ssl, int enable) {
2869 if (!ssl->config) {
2870 return;
2871 }
2872 ssl->config->shed_handshake_config = !!enable;
2873 }
2874
SSL_set_jdk11_workaround(SSL * ssl,int enable)2875 void SSL_set_jdk11_workaround(SSL *ssl, int enable) {
2876 if (!ssl->config) {
2877 return;
2878 }
2879 ssl->config->jdk11_workaround = !!enable;
2880 }
2881
SSL_clear(SSL * ssl)2882 int SSL_clear(SSL *ssl) {
2883 if (!ssl->config) {
2884 return 0; // SSL_clear may not be used after shedding config.
2885 }
2886
2887 // In OpenSSL, reusing a client |SSL| with |SSL_clear| causes the previously
2888 // established session to be offered the next time around. wpa_supplicant
2889 // depends on this behavior, so emulate it.
2890 UniquePtr<SSL_SESSION> session;
2891 if (!ssl->server && ssl->s3->established_session != NULL) {
2892 session = UpRef(ssl->s3->established_session);
2893 }
2894
2895 // The ssl->d1->mtu is simultaneously configuration (preserved across
2896 // clear) and connection-specific state (gets reset).
2897 //
2898 // TODO(davidben): Avoid this.
2899 unsigned mtu = 0;
2900 if (ssl->d1 != NULL) {
2901 mtu = ssl->d1->mtu;
2902 }
2903
2904 ssl->method->ssl_free(ssl);
2905 if (!ssl->method->ssl_new(ssl)) {
2906 return 0;
2907 }
2908
2909 if (SSL_is_dtls(ssl) && (SSL_get_options(ssl) & SSL_OP_NO_QUERY_MTU)) {
2910 ssl->d1->mtu = mtu;
2911 }
2912
2913 if (session != nullptr) {
2914 SSL_set_session(ssl, session.get());
2915 }
2916
2917 return 1;
2918 }
2919
SSL_CTX_sess_connect(const SSL_CTX * ctx)2920 int SSL_CTX_sess_connect(const SSL_CTX *ctx) { return 0; }
SSL_CTX_sess_connect_good(const SSL_CTX * ctx)2921 int SSL_CTX_sess_connect_good(const SSL_CTX *ctx) { return 0; }
SSL_CTX_sess_connect_renegotiate(const SSL_CTX * ctx)2922 int SSL_CTX_sess_connect_renegotiate(const SSL_CTX *ctx) { return 0; }
SSL_CTX_sess_accept(const SSL_CTX * ctx)2923 int SSL_CTX_sess_accept(const SSL_CTX *ctx) { return 0; }
SSL_CTX_sess_accept_renegotiate(const SSL_CTX * ctx)2924 int SSL_CTX_sess_accept_renegotiate(const SSL_CTX *ctx) { return 0; }
SSL_CTX_sess_accept_good(const SSL_CTX * ctx)2925 int SSL_CTX_sess_accept_good(const SSL_CTX *ctx) { return 0; }
SSL_CTX_sess_hits(const SSL_CTX * ctx)2926 int SSL_CTX_sess_hits(const SSL_CTX *ctx) { return 0; }
SSL_CTX_sess_cb_hits(const SSL_CTX * ctx)2927 int SSL_CTX_sess_cb_hits(const SSL_CTX *ctx) { return 0; }
SSL_CTX_sess_misses(const SSL_CTX * ctx)2928 int SSL_CTX_sess_misses(const SSL_CTX *ctx) { return 0; }
SSL_CTX_sess_timeouts(const SSL_CTX * ctx)2929 int SSL_CTX_sess_timeouts(const SSL_CTX *ctx) { return 0; }
SSL_CTX_sess_cache_full(const SSL_CTX * ctx)2930 int SSL_CTX_sess_cache_full(const SSL_CTX *ctx) { return 0; }
2931
SSL_num_renegotiations(const SSL * ssl)2932 int SSL_num_renegotiations(const SSL *ssl) {
2933 return SSL_total_renegotiations(ssl);
2934 }
2935
SSL_CTX_need_tmp_RSA(const SSL_CTX * ctx)2936 int SSL_CTX_need_tmp_RSA(const SSL_CTX *ctx) { return 0; }
SSL_need_tmp_RSA(const SSL * ssl)2937 int SSL_need_tmp_RSA(const SSL *ssl) { return 0; }
SSL_CTX_set_tmp_rsa(SSL_CTX * ctx,const RSA * rsa)2938 int SSL_CTX_set_tmp_rsa(SSL_CTX *ctx, const RSA *rsa) { return 1; }
SSL_set_tmp_rsa(SSL * ssl,const RSA * rsa)2939 int SSL_set_tmp_rsa(SSL *ssl, const RSA *rsa) { return 1; }
ERR_load_SSL_strings(void)2940 void ERR_load_SSL_strings(void) {}
SSL_load_error_strings(void)2941 void SSL_load_error_strings(void) {}
SSL_cache_hit(SSL * ssl)2942 int SSL_cache_hit(SSL *ssl) { return SSL_session_reused(ssl); }
2943
SSL_CTX_set_tmp_ecdh(SSL_CTX * ctx,const EC_KEY * ec_key)2944 int SSL_CTX_set_tmp_ecdh(SSL_CTX *ctx, const EC_KEY *ec_key) {
2945 if (ec_key == NULL || EC_KEY_get0_group(ec_key) == NULL) {
2946 OPENSSL_PUT_ERROR(SSL, ERR_R_PASSED_NULL_PARAMETER);
2947 return 0;
2948 }
2949 int nid = EC_GROUP_get_curve_name(EC_KEY_get0_group(ec_key));
2950 return SSL_CTX_set1_curves(ctx, &nid, 1);
2951 }
2952
SSL_set_tmp_ecdh(SSL * ssl,const EC_KEY * ec_key)2953 int SSL_set_tmp_ecdh(SSL *ssl, const EC_KEY *ec_key) {
2954 if (ec_key == NULL || EC_KEY_get0_group(ec_key) == NULL) {
2955 OPENSSL_PUT_ERROR(SSL, ERR_R_PASSED_NULL_PARAMETER);
2956 return 0;
2957 }
2958 int nid = EC_GROUP_get_curve_name(EC_KEY_get0_group(ec_key));
2959 return SSL_set1_curves(ssl, &nid, 1);
2960 }
2961
SSL_CTX_set_ticket_aead_method(SSL_CTX * ctx,const SSL_TICKET_AEAD_METHOD * aead_method)2962 void SSL_CTX_set_ticket_aead_method(SSL_CTX *ctx,
2963 const SSL_TICKET_AEAD_METHOD *aead_method) {
2964 ctx->ticket_aead_method = aead_method;
2965 }
2966
SSL_set_tlsext_status_type(SSL * ssl,int type)2967 int SSL_set_tlsext_status_type(SSL *ssl, int type) {
2968 if (!ssl->config) {
2969 return 0;
2970 }
2971 ssl->config->ocsp_stapling_enabled = type == TLSEXT_STATUSTYPE_ocsp;
2972 return 1;
2973 }
2974
SSL_get_tlsext_status_type(const SSL * ssl)2975 int SSL_get_tlsext_status_type(const SSL *ssl) {
2976 if (ssl->server) {
2977 SSL_HANDSHAKE *hs = ssl->s3->hs.get();
2978 return hs != nullptr && hs->ocsp_stapling_requested
2979 ? TLSEXT_STATUSTYPE_ocsp
2980 : TLSEXT_STATUSTYPE_nothing;
2981 }
2982
2983 return ssl->config != nullptr && ssl->config->ocsp_stapling_enabled
2984 ? TLSEXT_STATUSTYPE_ocsp
2985 : TLSEXT_STATUSTYPE_nothing;
2986 }
2987
SSL_set_tlsext_status_ocsp_resp(SSL * ssl,uint8_t * resp,size_t resp_len)2988 int SSL_set_tlsext_status_ocsp_resp(SSL *ssl, uint8_t *resp, size_t resp_len) {
2989 if (SSL_set_ocsp_response(ssl, resp, resp_len)) {
2990 OPENSSL_free(resp);
2991 return 1;
2992 }
2993 return 0;
2994 }
2995
SSL_get_tlsext_status_ocsp_resp(const SSL * ssl,const uint8_t ** out)2996 size_t SSL_get_tlsext_status_ocsp_resp(const SSL *ssl, const uint8_t **out) {
2997 size_t ret;
2998 SSL_get0_ocsp_response(ssl, out, &ret);
2999 return ret;
3000 }
3001
SSL_CTX_set_tlsext_status_cb(SSL_CTX * ctx,int (* callback)(SSL * ssl,void * arg))3002 int SSL_CTX_set_tlsext_status_cb(SSL_CTX *ctx,
3003 int (*callback)(SSL *ssl, void *arg)) {
3004 ctx->legacy_ocsp_callback = callback;
3005 return 1;
3006 }
3007
SSL_CTX_set_tlsext_status_arg(SSL_CTX * ctx,void * arg)3008 int SSL_CTX_set_tlsext_status_arg(SSL_CTX *ctx, void *arg) {
3009 ctx->legacy_ocsp_callback_arg = arg;
3010 return 1;
3011 }
3012