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-2006 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 2005 Nokia. All rights reserved.
112 *
113 * The portions of the attached software ("Contribution") is developed by
114 * Nokia Corporation and is licensed pursuant to the OpenSSL open source
115 * license.
116 *
117 * The Contribution, originally written by Mika Kousa and Pasi Eronen of
118 * Nokia Corporation, consists of the "PSK" (Pre-Shared Key) ciphersuites
119 * support (see RFC 4279) to OpenSSL.
120 *
121 * No patent licenses or other rights except those expressly stated in
122 * the OpenSSL open source license shall be deemed granted or received
123 * expressly, by implication, estoppel, or otherwise.
124 *
125 * No assurances are provided by Nokia that the Contribution does not
126 * infringe the patent or other intellectual property rights of any third
127 * party or that the license provides you with all the necessary rights
128 * to make use of the Contribution.
129 *
130 * THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IN
131 * ADDITION TO THE DISCLAIMERS INCLUDED IN THE LICENSE, NOKIA
132 * SPECIFICALLY DISCLAIMS ANY LIABILITY FOR CLAIMS BROUGHT BY YOU OR ANY
133 * OTHER ENTITY BASED ON INFRINGEMENT OF INTELLECTUAL PROPERTY RIGHTS OR
134 * OTHERWISE. */
135
136 #include <openssl/ssl.h>
137
138 #include <assert.h>
139 #include <stdlib.h>
140 #include <string.h>
141
142 #include <utility>
143
144 #include <openssl/err.h>
145 #include <openssl/hmac.h>
146 #include <openssl/lhash.h>
147 #include <openssl/mem.h>
148 #include <openssl/rand.h>
149
150 #include "internal.h"
151 #include "../crypto/internal.h"
152
153
154 BSSL_NAMESPACE_BEGIN
155
156 // The address of this is a magic value, a pointer to which is returned by
157 // SSL_magic_pending_session_ptr(). It allows a session callback to indicate
158 // that it needs to asynchronously fetch session information.
159 static const char g_pending_session_magic = 0;
160
161 static CRYPTO_EX_DATA_CLASS g_ex_data_class =
162 CRYPTO_EX_DATA_CLASS_INIT_WITH_APP_DATA;
163
164 static void SSL_SESSION_list_remove(SSL_CTX *ctx, SSL_SESSION *session);
165 static void SSL_SESSION_list_add(SSL_CTX *ctx, SSL_SESSION *session);
166 static int remove_session_lock(SSL_CTX *ctx, SSL_SESSION *session, int lock);
167
ssl_session_new(const SSL_X509_METHOD * x509_method)168 UniquePtr<SSL_SESSION> ssl_session_new(const SSL_X509_METHOD *x509_method) {
169 return MakeUnique<SSL_SESSION>(x509_method);
170 }
171
ssl_hash_session_id(Span<const uint8_t> session_id)172 uint32_t ssl_hash_session_id(Span<const uint8_t> session_id) {
173 // Take the first four bytes of |session_id|. Session IDs are generated by the
174 // server randomly, so we can assume even using the first four bytes results
175 // in a good distribution.
176 uint8_t tmp_storage[sizeof(uint32_t)];
177 if (session_id.size() < sizeof(tmp_storage)) {
178 OPENSSL_memset(tmp_storage, 0, sizeof(tmp_storage));
179 OPENSSL_memcpy(tmp_storage, session_id.data(), session_id.size());
180 session_id = tmp_storage;
181 }
182
183 uint32_t hash =
184 ((uint32_t)session_id[0]) |
185 ((uint32_t)session_id[1] << 8) |
186 ((uint32_t)session_id[2] << 16) |
187 ((uint32_t)session_id[3] << 24);
188
189 return hash;
190 }
191
SSL_SESSION_dup(SSL_SESSION * session,int dup_flags)192 UniquePtr<SSL_SESSION> SSL_SESSION_dup(SSL_SESSION *session, int dup_flags) {
193 UniquePtr<SSL_SESSION> new_session = ssl_session_new(session->x509_method);
194 if (!new_session) {
195 return nullptr;
196 }
197
198 new_session->is_server = session->is_server;
199 new_session->ssl_version = session->ssl_version;
200 new_session->sid_ctx_length = session->sid_ctx_length;
201 OPENSSL_memcpy(new_session->sid_ctx, session->sid_ctx, session->sid_ctx_length);
202
203 // Copy the key material.
204 new_session->master_key_length = session->master_key_length;
205 OPENSSL_memcpy(new_session->master_key, session->master_key,
206 session->master_key_length);
207 new_session->cipher = session->cipher;
208
209 // Copy authentication state.
210 if (session->psk_identity != nullptr) {
211 new_session->psk_identity.reset(BUF_strdup(session->psk_identity.get()));
212 if (new_session->psk_identity == nullptr) {
213 return nullptr;
214 }
215 }
216 if (session->certs != nullptr) {
217 auto buf_up_ref = [](CRYPTO_BUFFER *buf) {
218 CRYPTO_BUFFER_up_ref(buf);
219 return buf;
220 };
221 new_session->certs.reset(sk_CRYPTO_BUFFER_deep_copy(
222 session->certs.get(), buf_up_ref, CRYPTO_BUFFER_free));
223 if (new_session->certs == nullptr) {
224 return nullptr;
225 }
226 }
227
228 if (!session->x509_method->session_dup(new_session.get(), session)) {
229 return nullptr;
230 }
231
232 new_session->verify_result = session->verify_result;
233
234 new_session->ocsp_response = UpRef(session->ocsp_response);
235 new_session->signed_cert_timestamp_list =
236 UpRef(session->signed_cert_timestamp_list);
237
238 OPENSSL_memcpy(new_session->peer_sha256, session->peer_sha256,
239 SHA256_DIGEST_LENGTH);
240 new_session->peer_sha256_valid = session->peer_sha256_valid;
241
242 new_session->peer_signature_algorithm = session->peer_signature_algorithm;
243
244 new_session->timeout = session->timeout;
245 new_session->auth_timeout = session->auth_timeout;
246 new_session->time = session->time;
247
248 // Copy non-authentication connection properties.
249 if (dup_flags & SSL_SESSION_INCLUDE_NONAUTH) {
250 new_session->session_id_length = session->session_id_length;
251 OPENSSL_memcpy(new_session->session_id, session->session_id,
252 session->session_id_length);
253
254 new_session->group_id = session->group_id;
255
256 OPENSSL_memcpy(new_session->original_handshake_hash,
257 session->original_handshake_hash,
258 session->original_handshake_hash_len);
259 new_session->original_handshake_hash_len =
260 session->original_handshake_hash_len;
261 new_session->ticket_lifetime_hint = session->ticket_lifetime_hint;
262 new_session->ticket_age_add = session->ticket_age_add;
263 new_session->ticket_max_early_data = session->ticket_max_early_data;
264 new_session->extended_master_secret = session->extended_master_secret;
265
266 if (!new_session->early_alpn.CopyFrom(session->early_alpn)) {
267 return nullptr;
268 }
269 }
270
271 // Copy the ticket.
272 if (dup_flags & SSL_SESSION_INCLUDE_TICKET &&
273 !new_session->ticket.CopyFrom(session->ticket)) {
274 return nullptr;
275 }
276
277 // The new_session does not get a copy of the ex_data.
278
279 new_session->not_resumable = true;
280 return new_session;
281 }
282
ssl_session_rebase_time(SSL * ssl,SSL_SESSION * session)283 void ssl_session_rebase_time(SSL *ssl, SSL_SESSION *session) {
284 struct OPENSSL_timeval now;
285 ssl_get_current_time(ssl, &now);
286
287 // To avoid overflows and underflows, if we've gone back in time, update the
288 // time, but mark the session expired.
289 if (session->time > now.tv_sec) {
290 session->time = now.tv_sec;
291 session->timeout = 0;
292 session->auth_timeout = 0;
293 return;
294 }
295
296 // Adjust the session time and timeouts. If the session has already expired,
297 // clamp the timeouts at zero.
298 uint64_t delta = now.tv_sec - session->time;
299 session->time = now.tv_sec;
300 if (session->timeout < delta) {
301 session->timeout = 0;
302 } else {
303 session->timeout -= delta;
304 }
305 if (session->auth_timeout < delta) {
306 session->auth_timeout = 0;
307 } else {
308 session->auth_timeout -= delta;
309 }
310 }
311
ssl_session_renew_timeout(SSL * ssl,SSL_SESSION * session,uint32_t timeout)312 void ssl_session_renew_timeout(SSL *ssl, SSL_SESSION *session,
313 uint32_t timeout) {
314 // Rebase the timestamp relative to the current time so |timeout| is measured
315 // correctly.
316 ssl_session_rebase_time(ssl, session);
317
318 if (session->timeout > timeout) {
319 return;
320 }
321
322 session->timeout = timeout;
323 if (session->timeout > session->auth_timeout) {
324 session->timeout = session->auth_timeout;
325 }
326 }
327
ssl_session_protocol_version(const SSL_SESSION * session)328 uint16_t ssl_session_protocol_version(const SSL_SESSION *session) {
329 uint16_t ret;
330 if (!ssl_protocol_version_from_wire(&ret, session->ssl_version)) {
331 // An |SSL_SESSION| will never have an invalid version. This is enforced by
332 // the parser.
333 assert(0);
334 return 0;
335 }
336
337 return ret;
338 }
339
ssl_session_get_digest(const SSL_SESSION * session)340 const EVP_MD *ssl_session_get_digest(const SSL_SESSION *session) {
341 return ssl_get_handshake_digest(ssl_session_protocol_version(session),
342 session->cipher);
343 }
344
ssl_get_new_session(SSL_HANDSHAKE * hs,int is_server)345 int ssl_get_new_session(SSL_HANDSHAKE *hs, int is_server) {
346 SSL *const ssl = hs->ssl;
347 if (ssl->mode & SSL_MODE_NO_SESSION_CREATION) {
348 OPENSSL_PUT_ERROR(SSL, SSL_R_SESSION_MAY_NOT_BE_CREATED);
349 return 0;
350 }
351
352 UniquePtr<SSL_SESSION> session = ssl_session_new(ssl->ctx->x509_method);
353 if (session == NULL) {
354 return 0;
355 }
356
357 session->is_server = is_server;
358 session->ssl_version = ssl->version;
359
360 // Fill in the time from the |SSL_CTX|'s clock.
361 struct OPENSSL_timeval now;
362 ssl_get_current_time(ssl, &now);
363 session->time = now.tv_sec;
364
365 uint16_t version = ssl_protocol_version(ssl);
366 if (version >= TLS1_3_VERSION) {
367 // TLS 1.3 uses tickets as authenticators, so we are willing to use them for
368 // longer.
369 session->timeout = ssl->session_ctx->session_psk_dhe_timeout;
370 session->auth_timeout = SSL_DEFAULT_SESSION_AUTH_TIMEOUT;
371 } else {
372 // TLS 1.2 resumption does not incorporate new key material, so we use a
373 // much shorter timeout.
374 session->timeout = ssl->session_ctx->session_timeout;
375 session->auth_timeout = ssl->session_ctx->session_timeout;
376 }
377
378 if (is_server) {
379 if (hs->ticket_expected || version >= TLS1_3_VERSION) {
380 // Don't set session IDs for sessions resumed with tickets. This will keep
381 // them out of the session cache.
382 session->session_id_length = 0;
383 } else {
384 session->session_id_length = SSL3_SSL_SESSION_ID_LENGTH;
385 if (!RAND_bytes(session->session_id, session->session_id_length)) {
386 return 0;
387 }
388 }
389 } else {
390 session->session_id_length = 0;
391 }
392
393 if (hs->config->cert->sid_ctx_length > sizeof(session->sid_ctx)) {
394 OPENSSL_PUT_ERROR(SSL, ERR_R_INTERNAL_ERROR);
395 return 0;
396 }
397 OPENSSL_memcpy(session->sid_ctx, hs->config->cert->sid_ctx,
398 hs->config->cert->sid_ctx_length);
399 session->sid_ctx_length = hs->config->cert->sid_ctx_length;
400
401 // The session is marked not resumable until it is completely filled in.
402 session->not_resumable = true;
403 session->verify_result = X509_V_ERR_INVALID_CALL;
404
405 hs->new_session = std::move(session);
406 ssl_set_session(ssl, NULL);
407 return 1;
408 }
409
ssl_ctx_rotate_ticket_encryption_key(SSL_CTX * ctx)410 int ssl_ctx_rotate_ticket_encryption_key(SSL_CTX *ctx) {
411 OPENSSL_timeval now;
412 ssl_ctx_get_current_time(ctx, &now);
413 {
414 // Avoid acquiring a write lock in the common case (i.e. a non-default key
415 // is used or the default keys have not expired yet).
416 MutexReadLock lock(&ctx->lock);
417 if (ctx->ticket_key_current &&
418 (ctx->ticket_key_current->next_rotation_tv_sec == 0 ||
419 ctx->ticket_key_current->next_rotation_tv_sec > now.tv_sec) &&
420 (!ctx->ticket_key_prev ||
421 ctx->ticket_key_prev->next_rotation_tv_sec > now.tv_sec)) {
422 return 1;
423 }
424 }
425
426 MutexWriteLock lock(&ctx->lock);
427 if (!ctx->ticket_key_current ||
428 (ctx->ticket_key_current->next_rotation_tv_sec != 0 &&
429 ctx->ticket_key_current->next_rotation_tv_sec <= now.tv_sec)) {
430 // The current key has not been initialized or it is expired.
431 auto new_key = bssl::MakeUnique<TicketKey>();
432 if (!new_key) {
433 return 0;
434 }
435 RAND_bytes(new_key->name, 16);
436 RAND_bytes(new_key->hmac_key, 16);
437 RAND_bytes(new_key->aes_key, 16);
438 new_key->next_rotation_tv_sec =
439 now.tv_sec + SSL_DEFAULT_TICKET_KEY_ROTATION_INTERVAL;
440 if (ctx->ticket_key_current) {
441 // The current key expired. Rotate it to prev and bump up its rotation
442 // timestamp. Note that even with the new rotation time it may still be
443 // expired and get dropped below.
444 ctx->ticket_key_current->next_rotation_tv_sec +=
445 SSL_DEFAULT_TICKET_KEY_ROTATION_INTERVAL;
446 ctx->ticket_key_prev = std::move(ctx->ticket_key_current);
447 }
448 ctx->ticket_key_current = std::move(new_key);
449 }
450
451 // Drop an expired prev key.
452 if (ctx->ticket_key_prev &&
453 ctx->ticket_key_prev->next_rotation_tv_sec <= now.tv_sec) {
454 ctx->ticket_key_prev.reset();
455 }
456
457 return 1;
458 }
459
ssl_encrypt_ticket_with_cipher_ctx(SSL_HANDSHAKE * hs,CBB * out,const uint8_t * session_buf,size_t session_len)460 static int ssl_encrypt_ticket_with_cipher_ctx(SSL_HANDSHAKE *hs, CBB *out,
461 const uint8_t *session_buf,
462 size_t session_len) {
463 ScopedEVP_CIPHER_CTX ctx;
464 ScopedHMAC_CTX hctx;
465
466 // If the session is too long, emit a dummy value rather than abort the
467 // connection.
468 static const size_t kMaxTicketOverhead =
469 16 + EVP_MAX_IV_LENGTH + EVP_MAX_BLOCK_LENGTH + EVP_MAX_MD_SIZE;
470 if (session_len > 0xffff - kMaxTicketOverhead) {
471 static const char kTicketPlaceholder[] = "TICKET TOO LARGE";
472 return CBB_add_bytes(out, (const uint8_t *)kTicketPlaceholder,
473 strlen(kTicketPlaceholder));
474 }
475
476 // Initialize HMAC and cipher contexts. If callback present it does all the
477 // work otherwise use generated values from parent ctx.
478 SSL_CTX *tctx = hs->ssl->session_ctx.get();
479 uint8_t iv[EVP_MAX_IV_LENGTH];
480 uint8_t key_name[16];
481 if (tctx->ticket_key_cb != NULL) {
482 if (tctx->ticket_key_cb(hs->ssl, key_name, iv, ctx.get(), hctx.get(),
483 1 /* encrypt */) < 0) {
484 return 0;
485 }
486 } else {
487 // Rotate ticket key if necessary.
488 if (!ssl_ctx_rotate_ticket_encryption_key(tctx)) {
489 return 0;
490 }
491 MutexReadLock lock(&tctx->lock);
492 if (!RAND_bytes(iv, 16) ||
493 !EVP_EncryptInit_ex(ctx.get(), EVP_aes_128_cbc(), NULL,
494 tctx->ticket_key_current->aes_key, iv) ||
495 !HMAC_Init_ex(hctx.get(), tctx->ticket_key_current->hmac_key, 16,
496 tlsext_tick_md(), NULL)) {
497 return 0;
498 }
499 OPENSSL_memcpy(key_name, tctx->ticket_key_current->name, 16);
500 }
501
502 uint8_t *ptr;
503 if (!CBB_add_bytes(out, key_name, 16) ||
504 !CBB_add_bytes(out, iv, EVP_CIPHER_CTX_iv_length(ctx.get())) ||
505 !CBB_reserve(out, &ptr, session_len + EVP_MAX_BLOCK_LENGTH)) {
506 return 0;
507 }
508
509 size_t total = 0;
510 #if defined(BORINGSSL_UNSAFE_FUZZER_MODE)
511 OPENSSL_memcpy(ptr, session_buf, session_len);
512 total = session_len;
513 #else
514 int len;
515 if (!EVP_EncryptUpdate(ctx.get(), ptr + total, &len, session_buf, session_len)) {
516 return 0;
517 }
518 total += len;
519 if (!EVP_EncryptFinal_ex(ctx.get(), ptr + total, &len)) {
520 return 0;
521 }
522 total += len;
523 #endif
524 if (!CBB_did_write(out, total)) {
525 return 0;
526 }
527
528 unsigned hlen;
529 if (!HMAC_Update(hctx.get(), CBB_data(out), CBB_len(out)) ||
530 !CBB_reserve(out, &ptr, EVP_MAX_MD_SIZE) ||
531 !HMAC_Final(hctx.get(), ptr, &hlen) ||
532 !CBB_did_write(out, hlen)) {
533 return 0;
534 }
535
536 return 1;
537 }
538
ssl_encrypt_ticket_with_method(SSL_HANDSHAKE * hs,CBB * out,const uint8_t * session_buf,size_t session_len)539 static int ssl_encrypt_ticket_with_method(SSL_HANDSHAKE *hs, CBB *out,
540 const uint8_t *session_buf,
541 size_t session_len) {
542 SSL *const ssl = hs->ssl;
543 const SSL_TICKET_AEAD_METHOD *method = ssl->session_ctx->ticket_aead_method;
544 const size_t max_overhead = method->max_overhead(ssl);
545 const size_t max_out = session_len + max_overhead;
546 if (max_out < max_overhead) {
547 OPENSSL_PUT_ERROR(SSL, ERR_R_OVERFLOW);
548 return 0;
549 }
550
551 uint8_t *ptr;
552 if (!CBB_reserve(out, &ptr, max_out)) {
553 return 0;
554 }
555
556 size_t out_len;
557 if (!method->seal(ssl, ptr, &out_len, max_out, session_buf,
558 session_len)) {
559 OPENSSL_PUT_ERROR(SSL, SSL_R_TICKET_ENCRYPTION_FAILED);
560 return 0;
561 }
562
563 if (!CBB_did_write(out, out_len)) {
564 return 0;
565 }
566
567 return 1;
568 }
569
ssl_encrypt_ticket(SSL_HANDSHAKE * hs,CBB * out,const SSL_SESSION * session)570 int ssl_encrypt_ticket(SSL_HANDSHAKE *hs, CBB *out,
571 const SSL_SESSION *session) {
572 // Serialize the SSL_SESSION to be encoded into the ticket.
573 uint8_t *session_buf = NULL;
574 size_t session_len;
575 if (!SSL_SESSION_to_bytes_for_ticket(session, &session_buf, &session_len)) {
576 return -1;
577 }
578
579 int ret = 0;
580 if (hs->ssl->session_ctx->ticket_aead_method) {
581 ret = ssl_encrypt_ticket_with_method(hs, out, session_buf, session_len);
582 } else {
583 ret = ssl_encrypt_ticket_with_cipher_ctx(hs, out, session_buf, session_len);
584 }
585
586 OPENSSL_free(session_buf);
587 return ret;
588 }
589
ssl_session_is_context_valid(const SSL_HANDSHAKE * hs,const SSL_SESSION * session)590 int ssl_session_is_context_valid(const SSL_HANDSHAKE *hs,
591 const SSL_SESSION *session) {
592 if (session == NULL) {
593 return 0;
594 }
595
596 return session->sid_ctx_length == hs->config->cert->sid_ctx_length &&
597 OPENSSL_memcmp(session->sid_ctx, hs->config->cert->sid_ctx,
598 hs->config->cert->sid_ctx_length) == 0;
599 }
600
ssl_session_is_time_valid(const SSL * ssl,const SSL_SESSION * session)601 int ssl_session_is_time_valid(const SSL *ssl, const SSL_SESSION *session) {
602 if (session == NULL) {
603 return 0;
604 }
605
606 struct OPENSSL_timeval now;
607 ssl_get_current_time(ssl, &now);
608
609 // Reject tickets from the future to avoid underflow.
610 if (now.tv_sec < session->time) {
611 return 0;
612 }
613
614 return session->timeout > now.tv_sec - session->time;
615 }
616
ssl_session_is_resumable(const SSL_HANDSHAKE * hs,const SSL_SESSION * session)617 int ssl_session_is_resumable(const SSL_HANDSHAKE *hs,
618 const SSL_SESSION *session) {
619 const SSL *const ssl = hs->ssl;
620 return ssl_session_is_context_valid(hs, session) &&
621 // The session must have been created by the same type of end point as
622 // we're now using it with.
623 ssl->server == session->is_server &&
624 // The session must not be expired.
625 ssl_session_is_time_valid(ssl, session) &&
626 /* Only resume if the session's version matches the negotiated
627 * version. */
628 ssl->version == session->ssl_version &&
629 // Only resume if the session's cipher matches the negotiated one.
630 hs->new_cipher == session->cipher &&
631 // If the session contains a client certificate (either the full
632 // certificate or just the hash) then require that the form of the
633 // certificate matches the current configuration.
634 ((sk_CRYPTO_BUFFER_num(session->certs.get()) == 0 &&
635 !session->peer_sha256_valid) ||
636 session->peer_sha256_valid ==
637 hs->config->retain_only_sha256_of_client_certs);
638 }
639
640 // ssl_lookup_session looks up |session_id| in the session cache and sets
641 // |*out_session| to an |SSL_SESSION| object if found.
ssl_lookup_session(SSL_HANDSHAKE * hs,UniquePtr<SSL_SESSION> * out_session,Span<const uint8_t> session_id)642 static enum ssl_hs_wait_t ssl_lookup_session(
643 SSL_HANDSHAKE *hs, UniquePtr<SSL_SESSION> *out_session,
644 Span<const uint8_t> session_id) {
645 SSL *const ssl = hs->ssl;
646 out_session->reset();
647
648 if (session_id.empty() || session_id.size() > SSL_MAX_SSL_SESSION_ID_LENGTH) {
649 return ssl_hs_ok;
650 }
651
652 UniquePtr<SSL_SESSION> session;
653 // Try the internal cache, if it exists.
654 if (!(ssl->session_ctx->session_cache_mode &
655 SSL_SESS_CACHE_NO_INTERNAL_LOOKUP)) {
656 uint32_t hash = ssl_hash_session_id(session_id);
657 auto cmp = [](const void *key, const SSL_SESSION *sess) -> int {
658 Span<const uint8_t> key_id =
659 *reinterpret_cast<const Span<const uint8_t> *>(key);
660 Span<const uint8_t> sess_id =
661 MakeConstSpan(sess->session_id, sess->session_id_length);
662 return key_id == sess_id ? 0 : 1;
663 };
664 MutexReadLock lock(&ssl->session_ctx->lock);
665 // |lh_SSL_SESSION_retrieve_key| returns a non-owning pointer.
666 session = UpRef(lh_SSL_SESSION_retrieve_key(ssl->session_ctx->sessions,
667 &session_id, hash, cmp));
668 // TODO(davidben): This should probably move it to the front of the list.
669 }
670
671 // Fall back to the external cache, if it exists.
672 if (!session && ssl->session_ctx->get_session_cb != nullptr) {
673 int copy = 1;
674 session.reset(ssl->session_ctx->get_session_cb(ssl, session_id.data(),
675 session_id.size(), ©));
676 if (!session) {
677 return ssl_hs_ok;
678 }
679
680 if (session.get() == SSL_magic_pending_session_ptr()) {
681 session.release(); // This pointer is not actually owned.
682 return ssl_hs_pending_session;
683 }
684
685 // Increment reference count now if the session callback asks us to do so
686 // (note that if the session structures returned by the callback are shared
687 // between threads, it must handle the reference count itself [i.e. copy ==
688 // 0], or things won't be thread-safe).
689 if (copy) {
690 SSL_SESSION_up_ref(session.get());
691 }
692
693 // Add the externally cached session to the internal cache if necessary.
694 if (!(ssl->session_ctx->session_cache_mode &
695 SSL_SESS_CACHE_NO_INTERNAL_STORE)) {
696 SSL_CTX_add_session(ssl->session_ctx.get(), session.get());
697 }
698 }
699
700 if (session && !ssl_session_is_time_valid(ssl, session.get())) {
701 // The session was from the cache, so remove it.
702 SSL_CTX_remove_session(ssl->session_ctx.get(), session.get());
703 session.reset();
704 }
705
706 *out_session = std::move(session);
707 return ssl_hs_ok;
708 }
709
ssl_get_prev_session(SSL_HANDSHAKE * hs,UniquePtr<SSL_SESSION> * out_session,bool * out_tickets_supported,bool * out_renew_ticket,const SSL_CLIENT_HELLO * client_hello)710 enum ssl_hs_wait_t ssl_get_prev_session(SSL_HANDSHAKE *hs,
711 UniquePtr<SSL_SESSION> *out_session,
712 bool *out_tickets_supported,
713 bool *out_renew_ticket,
714 const SSL_CLIENT_HELLO *client_hello) {
715 // This is used only by servers.
716 assert(hs->ssl->server);
717 UniquePtr<SSL_SESSION> session;
718 bool renew_ticket = false;
719
720 // If tickets are disabled, always behave as if no tickets are present.
721 CBS ticket;
722 const bool tickets_supported =
723 !(SSL_get_options(hs->ssl) & SSL_OP_NO_TICKET) &&
724 ssl_client_hello_get_extension(client_hello, &ticket,
725 TLSEXT_TYPE_session_ticket);
726 if (tickets_supported && CBS_len(&ticket) != 0) {
727 switch (ssl_process_ticket(hs, &session, &renew_ticket, ticket,
728 MakeConstSpan(client_hello->session_id,
729 client_hello->session_id_len))) {
730 case ssl_ticket_aead_success:
731 break;
732 case ssl_ticket_aead_ignore_ticket:
733 assert(!session);
734 break;
735 case ssl_ticket_aead_error:
736 return ssl_hs_error;
737 case ssl_ticket_aead_retry:
738 return ssl_hs_pending_ticket;
739 }
740 } else {
741 // The client didn't send a ticket, so the session ID is a real ID.
742 enum ssl_hs_wait_t lookup_ret = ssl_lookup_session(
743 hs, &session,
744 MakeConstSpan(client_hello->session_id, client_hello->session_id_len));
745 if (lookup_ret != ssl_hs_ok) {
746 return lookup_ret;
747 }
748 }
749
750 *out_session = std::move(session);
751 *out_tickets_supported = tickets_supported;
752 *out_renew_ticket = renew_ticket;
753 return ssl_hs_ok;
754 }
755
remove_session_lock(SSL_CTX * ctx,SSL_SESSION * session,int lock)756 static int remove_session_lock(SSL_CTX *ctx, SSL_SESSION *session, int lock) {
757 int ret = 0;
758
759 if (session != NULL && session->session_id_length != 0) {
760 if (lock) {
761 CRYPTO_MUTEX_lock_write(&ctx->lock);
762 }
763 SSL_SESSION *found_session = lh_SSL_SESSION_retrieve(ctx->sessions,
764 session);
765 if (found_session == session) {
766 ret = 1;
767 found_session = lh_SSL_SESSION_delete(ctx->sessions, session);
768 SSL_SESSION_list_remove(ctx, session);
769 }
770
771 if (lock) {
772 CRYPTO_MUTEX_unlock_write(&ctx->lock);
773 }
774
775 if (ret) {
776 if (ctx->remove_session_cb != NULL) {
777 ctx->remove_session_cb(ctx, found_session);
778 }
779 SSL_SESSION_free(found_session);
780 }
781 }
782
783 return ret;
784 }
785
ssl_set_session(SSL * ssl,SSL_SESSION * session)786 void ssl_set_session(SSL *ssl, SSL_SESSION *session) {
787 if (ssl->session.get() == session) {
788 return;
789 }
790
791 ssl->session = UpRef(session);
792 }
793
794 // locked by SSL_CTX in the calling function
SSL_SESSION_list_remove(SSL_CTX * ctx,SSL_SESSION * session)795 static void SSL_SESSION_list_remove(SSL_CTX *ctx, SSL_SESSION *session) {
796 if (session->next == NULL || session->prev == NULL) {
797 return;
798 }
799
800 if (session->next == (SSL_SESSION *)&ctx->session_cache_tail) {
801 // last element in list
802 if (session->prev == (SSL_SESSION *)&ctx->session_cache_head) {
803 // only one element in list
804 ctx->session_cache_head = NULL;
805 ctx->session_cache_tail = NULL;
806 } else {
807 ctx->session_cache_tail = session->prev;
808 session->prev->next = (SSL_SESSION *)&(ctx->session_cache_tail);
809 }
810 } else {
811 if (session->prev == (SSL_SESSION *)&ctx->session_cache_head) {
812 // first element in list
813 ctx->session_cache_head = session->next;
814 session->next->prev = (SSL_SESSION *)&(ctx->session_cache_head);
815 } else { // middle of list
816 session->next->prev = session->prev;
817 session->prev->next = session->next;
818 }
819 }
820 session->prev = session->next = NULL;
821 }
822
SSL_SESSION_list_add(SSL_CTX * ctx,SSL_SESSION * session)823 static void SSL_SESSION_list_add(SSL_CTX *ctx, SSL_SESSION *session) {
824 if (session->next != NULL && session->prev != NULL) {
825 SSL_SESSION_list_remove(ctx, session);
826 }
827
828 if (ctx->session_cache_head == NULL) {
829 ctx->session_cache_head = session;
830 ctx->session_cache_tail = session;
831 session->prev = (SSL_SESSION *)&(ctx->session_cache_head);
832 session->next = (SSL_SESSION *)&(ctx->session_cache_tail);
833 } else {
834 session->next = ctx->session_cache_head;
835 session->next->prev = session;
836 session->prev = (SSL_SESSION *)&(ctx->session_cache_head);
837 ctx->session_cache_head = session;
838 }
839 }
840
841 BSSL_NAMESPACE_END
842
843 using namespace bssl;
844
ssl_session_st(const SSL_X509_METHOD * method)845 ssl_session_st::ssl_session_st(const SSL_X509_METHOD *method)
846 : x509_method(method),
847 extended_master_secret(false),
848 peer_sha256_valid(false),
849 not_resumable(false),
850 ticket_age_add_valid(false),
851 is_server(false) {
852 CRYPTO_new_ex_data(&ex_data);
853 time = ::time(nullptr);
854 }
855
~ssl_session_st()856 ssl_session_st::~ssl_session_st() {
857 CRYPTO_free_ex_data(&g_ex_data_class, this, &ex_data);
858 x509_method->session_clear(this);
859 }
860
SSL_SESSION_new(const SSL_CTX * ctx)861 SSL_SESSION *SSL_SESSION_new(const SSL_CTX *ctx) {
862 return ssl_session_new(ctx->x509_method).release();
863 }
864
SSL_SESSION_up_ref(SSL_SESSION * session)865 int SSL_SESSION_up_ref(SSL_SESSION *session) {
866 CRYPTO_refcount_inc(&session->references);
867 return 1;
868 }
869
SSL_SESSION_free(SSL_SESSION * session)870 void SSL_SESSION_free(SSL_SESSION *session) {
871 if (session == NULL ||
872 !CRYPTO_refcount_dec_and_test_zero(&session->references)) {
873 return;
874 }
875
876 session->~ssl_session_st();
877 OPENSSL_free(session);
878 }
879
SSL_SESSION_get_id(const SSL_SESSION * session,unsigned * out_len)880 const uint8_t *SSL_SESSION_get_id(const SSL_SESSION *session,
881 unsigned *out_len) {
882 if (out_len != NULL) {
883 *out_len = session->session_id_length;
884 }
885 return session->session_id;
886 }
887
SSL_SESSION_set1_id(SSL_SESSION * session,const uint8_t * sid,size_t sid_len)888 int SSL_SESSION_set1_id(SSL_SESSION *session, const uint8_t *sid,
889 size_t sid_len) {
890 if (sid_len > SSL_MAX_SSL_SESSION_ID_LENGTH) {
891 OPENSSL_PUT_ERROR(SSL, SSL_R_SSL_SESSION_ID_TOO_LONG);
892 return 0;
893 }
894
895 // Use memmove in case someone passes in the output of |SSL_SESSION_get_id|.
896 OPENSSL_memmove(session->session_id, sid, sid_len);
897 session->session_id_length = sid_len;
898 return 1;
899 }
900
SSL_SESSION_get_timeout(const SSL_SESSION * session)901 uint32_t SSL_SESSION_get_timeout(const SSL_SESSION *session) {
902 return session->timeout;
903 }
904
SSL_SESSION_get_time(const SSL_SESSION * session)905 uint64_t SSL_SESSION_get_time(const SSL_SESSION *session) {
906 if (session == NULL) {
907 // NULL should crash, but silently accept it here for compatibility.
908 return 0;
909 }
910 return session->time;
911 }
912
SSL_SESSION_get0_peer(const SSL_SESSION * session)913 X509 *SSL_SESSION_get0_peer(const SSL_SESSION *session) {
914 return session->x509_peer;
915 }
916
STACK_OF(CRYPTO_BUFFER)917 const STACK_OF(CRYPTO_BUFFER) *
918 SSL_SESSION_get0_peer_certificates(const SSL_SESSION *session) {
919 return session->certs.get();
920 }
921
SSL_SESSION_get0_signed_cert_timestamp_list(const SSL_SESSION * session,const uint8_t ** out,size_t * out_len)922 void SSL_SESSION_get0_signed_cert_timestamp_list(const SSL_SESSION *session,
923 const uint8_t **out,
924 size_t *out_len) {
925 if (session->signed_cert_timestamp_list) {
926 *out = CRYPTO_BUFFER_data(session->signed_cert_timestamp_list.get());
927 *out_len = CRYPTO_BUFFER_len(session->signed_cert_timestamp_list.get());
928 } else {
929 *out = nullptr;
930 *out_len = 0;
931 }
932 }
933
SSL_SESSION_get0_ocsp_response(const SSL_SESSION * session,const uint8_t ** out,size_t * out_len)934 void SSL_SESSION_get0_ocsp_response(const SSL_SESSION *session,
935 const uint8_t **out, size_t *out_len) {
936 if (session->ocsp_response) {
937 *out = CRYPTO_BUFFER_data(session->ocsp_response.get());
938 *out_len = CRYPTO_BUFFER_len(session->ocsp_response.get());
939 } else {
940 *out = nullptr;
941 *out_len = 0;
942 }
943 }
944
SSL_SESSION_get_master_key(const SSL_SESSION * session,uint8_t * out,size_t max_out)945 size_t SSL_SESSION_get_master_key(const SSL_SESSION *session, uint8_t *out,
946 size_t max_out) {
947 // TODO(davidben): Fix master_key_length's type and remove these casts.
948 if (max_out == 0) {
949 return (size_t)session->master_key_length;
950 }
951 if (max_out > (size_t)session->master_key_length) {
952 max_out = (size_t)session->master_key_length;
953 }
954 OPENSSL_memcpy(out, session->master_key, max_out);
955 return max_out;
956 }
957
SSL_SESSION_set_time(SSL_SESSION * session,uint64_t time)958 uint64_t SSL_SESSION_set_time(SSL_SESSION *session, uint64_t time) {
959 if (session == NULL) {
960 return 0;
961 }
962
963 session->time = time;
964 return time;
965 }
966
SSL_SESSION_set_timeout(SSL_SESSION * session,uint32_t timeout)967 uint32_t SSL_SESSION_set_timeout(SSL_SESSION *session, uint32_t timeout) {
968 if (session == NULL) {
969 return 0;
970 }
971
972 session->timeout = timeout;
973 session->auth_timeout = timeout;
974 return 1;
975 }
976
SSL_SESSION_get0_id_context(const SSL_SESSION * session,unsigned * out_len)977 const uint8_t *SSL_SESSION_get0_id_context(const SSL_SESSION *session,
978 unsigned *out_len) {
979 if (out_len != NULL) {
980 *out_len = session->sid_ctx_length;
981 }
982 return session->sid_ctx;
983 }
984
SSL_SESSION_set1_id_context(SSL_SESSION * session,const uint8_t * sid_ctx,size_t sid_ctx_len)985 int SSL_SESSION_set1_id_context(SSL_SESSION *session, const uint8_t *sid_ctx,
986 size_t sid_ctx_len) {
987 if (sid_ctx_len > sizeof(session->sid_ctx)) {
988 OPENSSL_PUT_ERROR(SSL, SSL_R_SSL_SESSION_ID_CONTEXT_TOO_LONG);
989 return 0;
990 }
991
992 static_assert(sizeof(session->sid_ctx) < 256, "sid_ctx_len does not fit");
993 session->sid_ctx_length = (uint8_t)sid_ctx_len;
994 OPENSSL_memcpy(session->sid_ctx, sid_ctx, sid_ctx_len);
995
996 return 1;
997 }
998
SSL_SESSION_should_be_single_use(const SSL_SESSION * session)999 int SSL_SESSION_should_be_single_use(const SSL_SESSION *session) {
1000 return ssl_session_protocol_version(session) >= TLS1_3_VERSION;
1001 }
1002
SSL_SESSION_is_resumable(const SSL_SESSION * session)1003 int SSL_SESSION_is_resumable(const SSL_SESSION *session) {
1004 return !session->not_resumable;
1005 }
1006
SSL_SESSION_has_ticket(const SSL_SESSION * session)1007 int SSL_SESSION_has_ticket(const SSL_SESSION *session) {
1008 return !session->ticket.empty();
1009 }
1010
SSL_SESSION_get0_ticket(const SSL_SESSION * session,const uint8_t ** out_ticket,size_t * out_len)1011 void SSL_SESSION_get0_ticket(const SSL_SESSION *session,
1012 const uint8_t **out_ticket, size_t *out_len) {
1013 if (out_ticket != nullptr) {
1014 *out_ticket = session->ticket.data();
1015 }
1016 *out_len = session->ticket.size();
1017 }
1018
SSL_SESSION_set_ticket(SSL_SESSION * session,const uint8_t * ticket,size_t ticket_len)1019 int SSL_SESSION_set_ticket(SSL_SESSION *session, const uint8_t *ticket,
1020 size_t ticket_len) {
1021 return session->ticket.CopyFrom(MakeConstSpan(ticket, ticket_len));
1022 }
1023
SSL_SESSION_get_ticket_lifetime_hint(const SSL_SESSION * session)1024 uint32_t SSL_SESSION_get_ticket_lifetime_hint(const SSL_SESSION *session) {
1025 return session->ticket_lifetime_hint;
1026 }
1027
SSL_SESSION_get0_cipher(const SSL_SESSION * session)1028 const SSL_CIPHER *SSL_SESSION_get0_cipher(const SSL_SESSION *session) {
1029 return session->cipher;
1030 }
1031
SSL_SESSION_has_peer_sha256(const SSL_SESSION * session)1032 int SSL_SESSION_has_peer_sha256(const SSL_SESSION *session) {
1033 return session->peer_sha256_valid;
1034 }
1035
SSL_SESSION_get0_peer_sha256(const SSL_SESSION * session,const uint8_t ** out_ptr,size_t * out_len)1036 void SSL_SESSION_get0_peer_sha256(const SSL_SESSION *session,
1037 const uint8_t **out_ptr, size_t *out_len) {
1038 if (session->peer_sha256_valid) {
1039 *out_ptr = session->peer_sha256;
1040 *out_len = sizeof(session->peer_sha256);
1041 } else {
1042 *out_ptr = nullptr;
1043 *out_len = 0;
1044 }
1045 }
1046
SSL_magic_pending_session_ptr(void)1047 SSL_SESSION *SSL_magic_pending_session_ptr(void) {
1048 return (SSL_SESSION *)&g_pending_session_magic;
1049 }
1050
SSL_get_session(const SSL * ssl)1051 SSL_SESSION *SSL_get_session(const SSL *ssl) {
1052 // Once the handshake completes we return the established session. Otherwise
1053 // we return the intermediate session, either |session| (for resumption) or
1054 // |new_session| if doing a full handshake.
1055 if (!SSL_in_init(ssl)) {
1056 return ssl->s3->established_session.get();
1057 }
1058 SSL_HANDSHAKE *hs = ssl->s3->hs.get();
1059 if (hs->early_session) {
1060 return hs->early_session.get();
1061 }
1062 if (hs->new_session) {
1063 return hs->new_session.get();
1064 }
1065 return ssl->session.get();
1066 }
1067
SSL_get1_session(SSL * ssl)1068 SSL_SESSION *SSL_get1_session(SSL *ssl) {
1069 SSL_SESSION *ret = SSL_get_session(ssl);
1070 if (ret != NULL) {
1071 SSL_SESSION_up_ref(ret);
1072 }
1073 return ret;
1074 }
1075
SSL_SESSION_get_ex_new_index(long argl,void * argp,CRYPTO_EX_unused * unused,CRYPTO_EX_dup * dup_unused,CRYPTO_EX_free * free_func)1076 int SSL_SESSION_get_ex_new_index(long argl, void *argp,
1077 CRYPTO_EX_unused *unused,
1078 CRYPTO_EX_dup *dup_unused,
1079 CRYPTO_EX_free *free_func) {
1080 int index;
1081 if (!CRYPTO_get_ex_new_index(&g_ex_data_class, &index, argl, argp,
1082 free_func)) {
1083 return -1;
1084 }
1085 return index;
1086 }
1087
SSL_SESSION_set_ex_data(SSL_SESSION * session,int idx,void * arg)1088 int SSL_SESSION_set_ex_data(SSL_SESSION *session, int idx, void *arg) {
1089 return CRYPTO_set_ex_data(&session->ex_data, idx, arg);
1090 }
1091
SSL_SESSION_get_ex_data(const SSL_SESSION * session,int idx)1092 void *SSL_SESSION_get_ex_data(const SSL_SESSION *session, int idx) {
1093 return CRYPTO_get_ex_data(&session->ex_data, idx);
1094 }
1095
SSL_CTX_add_session(SSL_CTX * ctx,SSL_SESSION * session)1096 int SSL_CTX_add_session(SSL_CTX *ctx, SSL_SESSION *session) {
1097 // Although |session| is inserted into two structures (a doubly-linked list
1098 // and the hash table), |ctx| only takes one reference.
1099 UniquePtr<SSL_SESSION> owned_session = UpRef(session);
1100
1101 SSL_SESSION *old_session;
1102 MutexWriteLock lock(&ctx->lock);
1103 if (!lh_SSL_SESSION_insert(ctx->sessions, &old_session, session)) {
1104 return 0;
1105 }
1106 // |ctx->sessions| took ownership of |session| and gave us back a reference to
1107 // |old_session|. (|old_session| may be the same as |session|, in which case
1108 // we traded identical references with |ctx->sessions|.)
1109 owned_session.release();
1110 owned_session.reset(old_session);
1111
1112 if (old_session != NULL) {
1113 if (old_session == session) {
1114 // |session| was already in the cache. There are no linked list pointers
1115 // to update.
1116 return 0;
1117 }
1118
1119 // There was a session ID collision. |old_session| was replaced with
1120 // |session| in the hash table, so |old_session| must be removed from the
1121 // linked list to match.
1122 SSL_SESSION_list_remove(ctx, old_session);
1123 }
1124
1125 SSL_SESSION_list_add(ctx, session);
1126
1127 // Enforce any cache size limits.
1128 if (SSL_CTX_sess_get_cache_size(ctx) > 0) {
1129 while (lh_SSL_SESSION_num_items(ctx->sessions) >
1130 SSL_CTX_sess_get_cache_size(ctx)) {
1131 if (!remove_session_lock(ctx, ctx->session_cache_tail, 0)) {
1132 break;
1133 }
1134 }
1135 }
1136
1137 return 1;
1138 }
1139
SSL_CTX_remove_session(SSL_CTX * ctx,SSL_SESSION * session)1140 int SSL_CTX_remove_session(SSL_CTX *ctx, SSL_SESSION *session) {
1141 return remove_session_lock(ctx, session, 1);
1142 }
1143
SSL_set_session(SSL * ssl,SSL_SESSION * session)1144 int SSL_set_session(SSL *ssl, SSL_SESSION *session) {
1145 // SSL_set_session may only be called before the handshake has started.
1146 if (ssl->s3->initial_handshake_complete ||
1147 ssl->s3->hs == NULL ||
1148 ssl->s3->hs->state != 0) {
1149 abort();
1150 }
1151
1152 ssl_set_session(ssl, session);
1153 return 1;
1154 }
1155
SSL_CTX_set_timeout(SSL_CTX * ctx,uint32_t timeout)1156 uint32_t SSL_CTX_set_timeout(SSL_CTX *ctx, uint32_t timeout) {
1157 if (ctx == NULL) {
1158 return 0;
1159 }
1160
1161 // Historically, zero was treated as |SSL_DEFAULT_SESSION_TIMEOUT|.
1162 if (timeout == 0) {
1163 timeout = SSL_DEFAULT_SESSION_TIMEOUT;
1164 }
1165
1166 uint32_t old_timeout = ctx->session_timeout;
1167 ctx->session_timeout = timeout;
1168 return old_timeout;
1169 }
1170
SSL_CTX_get_timeout(const SSL_CTX * ctx)1171 uint32_t SSL_CTX_get_timeout(const SSL_CTX *ctx) {
1172 if (ctx == NULL) {
1173 return 0;
1174 }
1175
1176 return ctx->session_timeout;
1177 }
1178
SSL_CTX_set_session_psk_dhe_timeout(SSL_CTX * ctx,uint32_t timeout)1179 void SSL_CTX_set_session_psk_dhe_timeout(SSL_CTX *ctx, uint32_t timeout) {
1180 ctx->session_psk_dhe_timeout = timeout;
1181 }
1182
1183 typedef struct timeout_param_st {
1184 SSL_CTX *ctx;
1185 uint64_t time;
1186 LHASH_OF(SSL_SESSION) *cache;
1187 } TIMEOUT_PARAM;
1188
timeout_doall_arg(SSL_SESSION * session,void * void_param)1189 static void timeout_doall_arg(SSL_SESSION *session, void *void_param) {
1190 TIMEOUT_PARAM *param = reinterpret_cast<TIMEOUT_PARAM *>(void_param);
1191
1192 if (param->time == 0 ||
1193 session->time + session->timeout < session->time ||
1194 param->time > (session->time + session->timeout)) {
1195 // The reason we don't call SSL_CTX_remove_session() is to
1196 // save on locking overhead
1197 (void) lh_SSL_SESSION_delete(param->cache, session);
1198 SSL_SESSION_list_remove(param->ctx, session);
1199 if (param->ctx->remove_session_cb != NULL) {
1200 param->ctx->remove_session_cb(param->ctx, session);
1201 }
1202 SSL_SESSION_free(session);
1203 }
1204 }
1205
SSL_CTX_flush_sessions(SSL_CTX * ctx,uint64_t time)1206 void SSL_CTX_flush_sessions(SSL_CTX *ctx, uint64_t time) {
1207 TIMEOUT_PARAM tp;
1208
1209 tp.ctx = ctx;
1210 tp.cache = ctx->sessions;
1211 if (tp.cache == NULL) {
1212 return;
1213 }
1214 tp.time = time;
1215 MutexWriteLock lock(&ctx->lock);
1216 lh_SSL_SESSION_doall_arg(tp.cache, timeout_doall_arg, &tp);
1217 }
1218
SSL_CTX_sess_set_new_cb(SSL_CTX * ctx,int (* cb)(SSL * ssl,SSL_SESSION * session))1219 void SSL_CTX_sess_set_new_cb(SSL_CTX *ctx,
1220 int (*cb)(SSL *ssl, SSL_SESSION *session)) {
1221 ctx->new_session_cb = cb;
1222 }
1223
SSL_CTX_sess_get_new_cb(SSL_CTX * ctx)1224 int (*SSL_CTX_sess_get_new_cb(SSL_CTX *ctx))(SSL *ssl, SSL_SESSION *session) {
1225 return ctx->new_session_cb;
1226 }
1227
SSL_CTX_sess_set_remove_cb(SSL_CTX * ctx,void (* cb)(SSL_CTX * ctx,SSL_SESSION * session))1228 void SSL_CTX_sess_set_remove_cb(
1229 SSL_CTX *ctx, void (*cb)(SSL_CTX *ctx, SSL_SESSION *session)) {
1230 ctx->remove_session_cb = cb;
1231 }
1232
SSL_CTX_sess_get_remove_cb(SSL_CTX * ctx)1233 void (*SSL_CTX_sess_get_remove_cb(SSL_CTX *ctx))(SSL_CTX *ctx,
1234 SSL_SESSION *session) {
1235 return ctx->remove_session_cb;
1236 }
1237
SSL_CTX_sess_set_get_cb(SSL_CTX * ctx,SSL_SESSION * (* cb)(SSL * ssl,const uint8_t * id,int id_len,int * out_copy))1238 void SSL_CTX_sess_set_get_cb(SSL_CTX *ctx,
1239 SSL_SESSION *(*cb)(SSL *ssl, const uint8_t *id,
1240 int id_len, int *out_copy)) {
1241 ctx->get_session_cb = cb;
1242 }
1243
SSL_CTX_sess_get_get_cb(SSL_CTX * ctx)1244 SSL_SESSION *(*SSL_CTX_sess_get_get_cb(SSL_CTX *ctx))(SSL *ssl,
1245 const uint8_t *id,
1246 int id_len,
1247 int *out_copy) {
1248 return ctx->get_session_cb;
1249 }
1250
SSL_CTX_set_info_callback(SSL_CTX * ctx,void (* cb)(const SSL * ssl,int type,int value))1251 void SSL_CTX_set_info_callback(
1252 SSL_CTX *ctx, void (*cb)(const SSL *ssl, int type, int value)) {
1253 ctx->info_callback = cb;
1254 }
1255
SSL_CTX_get_info_callback(SSL_CTX * ctx)1256 void (*SSL_CTX_get_info_callback(SSL_CTX *ctx))(const SSL *ssl, int type,
1257 int value) {
1258 return ctx->info_callback;
1259 }
1260
SSL_CTX_set_channel_id_cb(SSL_CTX * ctx,void (* cb)(SSL * ssl,EVP_PKEY ** pkey))1261 void SSL_CTX_set_channel_id_cb(SSL_CTX *ctx,
1262 void (*cb)(SSL *ssl, EVP_PKEY **pkey)) {
1263 ctx->channel_id_cb = cb;
1264 }
1265
SSL_CTX_get_channel_id_cb(SSL_CTX * ctx)1266 void (*SSL_CTX_get_channel_id_cb(SSL_CTX *ctx))(SSL *ssl, EVP_PKEY **pkey) {
1267 return ctx->channel_id_cb;
1268 }
1269