• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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 2005 Nokia. All rights reserved.
59  *
60  * The portions of the attached software ("Contribution") is developed by
61  * Nokia Corporation and is licensed pursuant to the OpenSSL open source
62  * license.
63  *
64  * The Contribution, originally written by Mika Kousa and Pasi Eronen of
65  * Nokia Corporation, consists of the "PSK" (Pre-Shared Key) ciphersuites
66  * support (see RFC 4279) to OpenSSL.
67  *
68  * No patent licenses or other rights except those expressly stated in
69  * the OpenSSL open source license shall be deemed granted or received
70  * expressly, by implication, estoppel, or otherwise.
71  *
72  * No assurances are provided by Nokia that the Contribution does not
73  * infringe the patent or other intellectual property rights of any third
74  * party or that the license provides you with all the necessary rights
75  * to make use of the Contribution.
76  *
77  * THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IN
78  * ADDITION TO THE DISCLAIMERS INCLUDED IN THE LICENSE, NOKIA
79  * SPECIFICALLY DISCLAIMS ANY LIABILITY FOR CLAIMS BROUGHT BY YOU OR ANY
80  * OTHER ENTITY BASED ON INFRINGEMENT OF INTELLECTUAL PROPERTY RIGHTS OR
81  * OTHERWISE. */
82 
83 // Per C99, various stdint.h macros are unavailable in C++ unless some macros
84 // are defined. C++11 overruled this decision, but older Android NDKs still
85 // require it.
86 #if !defined(__STDC_LIMIT_MACROS)
87 #define __STDC_LIMIT_MACROS
88 #endif
89 
90 #include <openssl/ssl.h>
91 
92 #include <limits.h>
93 #include <string.h>
94 
95 #include <utility>
96 
97 #include <openssl/buf.h>
98 #include <openssl/bytestring.h>
99 #include <openssl/err.h>
100 #include <openssl/mem.h>
101 #include <openssl/x509.h>
102 
103 #include "../crypto/internal.h"
104 #include "internal.h"
105 
106 
107 namespace bssl {
108 
109 // An SSL_SESSION is serialized as the following ASN.1 structure:
110 //
111 // SSLSession ::= SEQUENCE {
112 //     version                     INTEGER (1),  -- session structure version
113 //     sslVersion                  INTEGER,      -- protocol version number
114 //     cipher                      OCTET STRING, -- two bytes long
115 //     sessionID                   OCTET STRING,
116 //     masterKey                   OCTET STRING,
117 //     time                    [1] INTEGER, -- seconds since UNIX epoch
118 //     timeout                 [2] INTEGER, -- in seconds
119 //     peer                    [3] Certificate OPTIONAL,
120 //     sessionIDContext        [4] OCTET STRING OPTIONAL,
121 //     verifyResult            [5] INTEGER OPTIONAL,  -- one of X509_V_* codes
122 //     pskIdentity             [8] OCTET STRING OPTIONAL,
123 //     ticketLifetimeHint      [9] INTEGER OPTIONAL,       -- client-only
124 //     ticket                  [10] OCTET STRING OPTIONAL, -- client-only
125 //     peerSHA256              [13] OCTET STRING OPTIONAL,
126 //     originalHandshakeHash   [14] OCTET STRING OPTIONAL,
127 //     signedCertTimestampList [15] OCTET STRING OPTIONAL,
128 //                                  -- contents of SCT extension
129 //     ocspResponse            [16] OCTET STRING OPTIONAL,
130 //                                  -- stapled OCSP response from the server
131 //     extendedMasterSecret    [17] BOOLEAN OPTIONAL,
132 //     groupID                 [18] INTEGER OPTIONAL,
133 //     certChain               [19] SEQUENCE OF Certificate OPTIONAL,
134 //     ticketAgeAdd            [21] OCTET STRING OPTIONAL,
135 //     isServer                [22] BOOLEAN DEFAULT TRUE,
136 //     peerSignatureAlgorithm  [23] INTEGER OPTIONAL,
137 //     ticketMaxEarlyData      [24] INTEGER OPTIONAL,
138 //     authTimeout             [25] INTEGER OPTIONAL, -- defaults to timeout
139 //     earlyALPN               [26] OCTET STRING OPTIONAL,
140 // }
141 //
142 // Note: historically this serialization has included other optional
143 // fields. Their presence is currently treated as a parse error, except for
144 // hostName, which is ignored.
145 //
146 //     keyArg                  [0] IMPLICIT OCTET STRING OPTIONAL,
147 //     hostName                [6] OCTET STRING OPTIONAL,
148 //     pskIdentityHint         [7] OCTET STRING OPTIONAL,
149 //     compressionMethod       [11] OCTET STRING OPTIONAL,
150 //     srpUsername             [12] OCTET STRING OPTIONAL,
151 //     ticketFlags             [20] INTEGER OPTIONAL,
152 
153 static const unsigned kVersion = 1;
154 
155 static const unsigned kTimeTag =
156     CBS_ASN1_CONSTRUCTED | CBS_ASN1_CONTEXT_SPECIFIC | 1;
157 static const unsigned kTimeoutTag =
158     CBS_ASN1_CONSTRUCTED | CBS_ASN1_CONTEXT_SPECIFIC | 2;
159 static const unsigned kPeerTag =
160     CBS_ASN1_CONSTRUCTED | CBS_ASN1_CONTEXT_SPECIFIC | 3;
161 static const unsigned kSessionIDContextTag =
162     CBS_ASN1_CONSTRUCTED | CBS_ASN1_CONTEXT_SPECIFIC | 4;
163 static const unsigned kVerifyResultTag =
164     CBS_ASN1_CONSTRUCTED | CBS_ASN1_CONTEXT_SPECIFIC | 5;
165 static const unsigned kHostNameTag =
166     CBS_ASN1_CONSTRUCTED | CBS_ASN1_CONTEXT_SPECIFIC | 6;
167 static const unsigned kPSKIdentityTag =
168     CBS_ASN1_CONSTRUCTED | CBS_ASN1_CONTEXT_SPECIFIC | 8;
169 static const unsigned kTicketLifetimeHintTag =
170     CBS_ASN1_CONSTRUCTED | CBS_ASN1_CONTEXT_SPECIFIC | 9;
171 static const unsigned kTicketTag =
172     CBS_ASN1_CONSTRUCTED | CBS_ASN1_CONTEXT_SPECIFIC | 10;
173 static const unsigned kPeerSHA256Tag =
174     CBS_ASN1_CONSTRUCTED | CBS_ASN1_CONTEXT_SPECIFIC | 13;
175 static const unsigned kOriginalHandshakeHashTag =
176     CBS_ASN1_CONSTRUCTED | CBS_ASN1_CONTEXT_SPECIFIC | 14;
177 static const unsigned kSignedCertTimestampListTag =
178     CBS_ASN1_CONSTRUCTED | CBS_ASN1_CONTEXT_SPECIFIC | 15;
179 static const unsigned kOCSPResponseTag =
180     CBS_ASN1_CONSTRUCTED | CBS_ASN1_CONTEXT_SPECIFIC | 16;
181 static const unsigned kExtendedMasterSecretTag =
182     CBS_ASN1_CONSTRUCTED | CBS_ASN1_CONTEXT_SPECIFIC | 17;
183 static const unsigned kGroupIDTag =
184     CBS_ASN1_CONSTRUCTED | CBS_ASN1_CONTEXT_SPECIFIC | 18;
185 static const unsigned kCertChainTag =
186     CBS_ASN1_CONSTRUCTED | CBS_ASN1_CONTEXT_SPECIFIC | 19;
187 static const unsigned kTicketAgeAddTag =
188     CBS_ASN1_CONSTRUCTED | CBS_ASN1_CONTEXT_SPECIFIC | 21;
189 static const unsigned kIsServerTag =
190     CBS_ASN1_CONSTRUCTED | CBS_ASN1_CONTEXT_SPECIFIC | 22;
191 static const unsigned kPeerSignatureAlgorithmTag =
192     CBS_ASN1_CONSTRUCTED | CBS_ASN1_CONTEXT_SPECIFIC | 23;
193 static const unsigned kTicketMaxEarlyDataTag =
194     CBS_ASN1_CONSTRUCTED | CBS_ASN1_CONTEXT_SPECIFIC | 24;
195 static const unsigned kAuthTimeoutTag =
196     CBS_ASN1_CONSTRUCTED | CBS_ASN1_CONTEXT_SPECIFIC | 25;
197 static const unsigned kEarlyALPNTag =
198     CBS_ASN1_CONSTRUCTED | CBS_ASN1_CONTEXT_SPECIFIC | 26;
199 
SSL_SESSION_to_bytes_full(const SSL_SESSION * in,CBB * cbb,int for_ticket)200 static int SSL_SESSION_to_bytes_full(const SSL_SESSION *in, CBB *cbb,
201                                      int for_ticket) {
202   if (in == NULL || in->cipher == NULL) {
203     return 0;
204   }
205 
206   CBB session, child, child2;
207   if (!CBB_add_asn1(cbb, &session, CBS_ASN1_SEQUENCE) ||
208       !CBB_add_asn1_uint64(&session, kVersion) ||
209       !CBB_add_asn1_uint64(&session, in->ssl_version) ||
210       !CBB_add_asn1(&session, &child, CBS_ASN1_OCTETSTRING) ||
211       !CBB_add_u16(&child, (uint16_t)(in->cipher->id & 0xffff)) ||
212       // The session ID is irrelevant for a session ticket.
213       !CBB_add_asn1_octet_string(&session, in->session_id,
214                                  for_ticket ? 0 : in->session_id_length) ||
215       !CBB_add_asn1_octet_string(&session, in->master_key,
216                                  in->master_key_length) ||
217       !CBB_add_asn1(&session, &child, kTimeTag) ||
218       !CBB_add_asn1_uint64(&child, in->time) ||
219       !CBB_add_asn1(&session, &child, kTimeoutTag) ||
220       !CBB_add_asn1_uint64(&child, in->timeout)) {
221     OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
222     return 0;
223   }
224 
225   // The peer certificate is only serialized if the SHA-256 isn't
226   // serialized instead.
227   if (sk_CRYPTO_BUFFER_num(in->certs) > 0 && !in->peer_sha256_valid) {
228     const CRYPTO_BUFFER *buffer = sk_CRYPTO_BUFFER_value(in->certs, 0);
229     if (!CBB_add_asn1(&session, &child, kPeerTag) ||
230         !CBB_add_bytes(&child, CRYPTO_BUFFER_data(buffer),
231                        CRYPTO_BUFFER_len(buffer))) {
232       OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
233       return 0;
234     }
235   }
236 
237   // Although it is OPTIONAL and usually empty, OpenSSL has
238   // historically always encoded the sid_ctx.
239   if (!CBB_add_asn1(&session, &child, kSessionIDContextTag) ||
240       !CBB_add_asn1_octet_string(&child, in->sid_ctx, in->sid_ctx_length)) {
241     OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
242     return 0;
243   }
244 
245   if (in->verify_result != X509_V_OK) {
246     if (!CBB_add_asn1(&session, &child, kVerifyResultTag) ||
247         !CBB_add_asn1_uint64(&child, in->verify_result)) {
248       OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
249       return 0;
250     }
251   }
252 
253   if (in->psk_identity) {
254     if (!CBB_add_asn1(&session, &child, kPSKIdentityTag) ||
255         !CBB_add_asn1_octet_string(&child, (const uint8_t *)in->psk_identity,
256                                    strlen(in->psk_identity))) {
257       OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
258       return 0;
259     }
260   }
261 
262   if (in->tlsext_tick_lifetime_hint > 0) {
263     if (!CBB_add_asn1(&session, &child, kTicketLifetimeHintTag) ||
264         !CBB_add_asn1_uint64(&child, in->tlsext_tick_lifetime_hint)) {
265       OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
266       return 0;
267     }
268   }
269 
270   if (in->tlsext_tick && !for_ticket) {
271     if (!CBB_add_asn1(&session, &child, kTicketTag) ||
272         !CBB_add_asn1_octet_string(&child, in->tlsext_tick,
273                                    in->tlsext_ticklen)) {
274       OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
275       return 0;
276     }
277   }
278 
279   if (in->peer_sha256_valid) {
280     if (!CBB_add_asn1(&session, &child, kPeerSHA256Tag) ||
281         !CBB_add_asn1_octet_string(&child, in->peer_sha256,
282                                    sizeof(in->peer_sha256))) {
283       OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
284       return 0;
285     }
286   }
287 
288   if (in->original_handshake_hash_len > 0) {
289     if (!CBB_add_asn1(&session, &child, kOriginalHandshakeHashTag) ||
290         !CBB_add_asn1_octet_string(&child, in->original_handshake_hash,
291                                    in->original_handshake_hash_len)) {
292       OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
293       return 0;
294     }
295   }
296 
297   if (in->signed_cert_timestamp_list != nullptr) {
298     if (!CBB_add_asn1(&session, &child, kSignedCertTimestampListTag) ||
299         !CBB_add_asn1_octet_string(
300             &child, CRYPTO_BUFFER_data(in->signed_cert_timestamp_list),
301             CRYPTO_BUFFER_len(in->signed_cert_timestamp_list))) {
302       OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
303       return 0;
304     }
305   }
306 
307   if (in->ocsp_response != nullptr) {
308     if (!CBB_add_asn1(&session, &child, kOCSPResponseTag) ||
309         !CBB_add_asn1_octet_string(&child,
310                                    CRYPTO_BUFFER_data(in->ocsp_response),
311                                    CRYPTO_BUFFER_len(in->ocsp_response))) {
312       OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
313       return 0;
314     }
315   }
316 
317   if (in->extended_master_secret) {
318     if (!CBB_add_asn1(&session, &child, kExtendedMasterSecretTag) ||
319         !CBB_add_asn1_bool(&child, true)) {
320       OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
321       return 0;
322     }
323   }
324 
325   if (in->group_id > 0 &&
326       (!CBB_add_asn1(&session, &child, kGroupIDTag) ||
327        !CBB_add_asn1_uint64(&child, in->group_id))) {
328     OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
329     return 0;
330   }
331 
332   // The certificate chain is only serialized if the leaf's SHA-256 isn't
333   // serialized instead.
334   if (in->certs != NULL &&
335       !in->peer_sha256_valid &&
336       sk_CRYPTO_BUFFER_num(in->certs) >= 2) {
337     if (!CBB_add_asn1(&session, &child, kCertChainTag)) {
338       OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
339       return 0;
340     }
341     for (size_t i = 1; i < sk_CRYPTO_BUFFER_num(in->certs); i++) {
342       const CRYPTO_BUFFER *buffer = sk_CRYPTO_BUFFER_value(in->certs, i);
343       if (!CBB_add_bytes(&child, CRYPTO_BUFFER_data(buffer),
344                          CRYPTO_BUFFER_len(buffer))) {
345         OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
346         return 0;
347       }
348     }
349   }
350 
351   if (in->ticket_age_add_valid) {
352     if (!CBB_add_asn1(&session, &child, kTicketAgeAddTag) ||
353         !CBB_add_asn1(&child, &child2, CBS_ASN1_OCTETSTRING) ||
354         !CBB_add_u32(&child2, in->ticket_age_add)) {
355       OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
356       return 0;
357     }
358   }
359 
360   if (!in->is_server) {
361     if (!CBB_add_asn1(&session, &child, kIsServerTag) ||
362         !CBB_add_asn1_bool(&child, false)) {
363       OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
364       return 0;
365     }
366   }
367 
368   if (in->peer_signature_algorithm != 0 &&
369       (!CBB_add_asn1(&session, &child, kPeerSignatureAlgorithmTag) ||
370        !CBB_add_asn1_uint64(&child, in->peer_signature_algorithm))) {
371     OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
372     return 0;
373   }
374 
375   if (in->ticket_max_early_data != 0 &&
376       (!CBB_add_asn1(&session, &child, kTicketMaxEarlyDataTag) ||
377        !CBB_add_asn1_uint64(&child, in->ticket_max_early_data))) {
378     OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
379     return 0;
380   }
381 
382   if (in->timeout != in->auth_timeout &&
383       (!CBB_add_asn1(&session, &child, kAuthTimeoutTag) ||
384        !CBB_add_asn1_uint64(&child, in->auth_timeout))) {
385     OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
386     return 0;
387   }
388 
389   if (in->early_alpn) {
390     if (!CBB_add_asn1(&session, &child, kEarlyALPNTag) ||
391         !CBB_add_asn1_octet_string(&child, (const uint8_t *)in->early_alpn,
392                                    in->early_alpn_len)) {
393       OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
394       return 0;
395     }
396   }
397 
398   return CBB_flush(cbb);
399 }
400 
401 // SSL_SESSION_parse_string gets an optional ASN.1 OCTET STRING
402 // explicitly tagged with |tag| from |cbs| and saves it in |*out|. On
403 // entry, if |*out| is not NULL, it frees the existing contents. If
404 // the element was not found, it sets |*out| to NULL. It returns one
405 // on success, whether or not the element was found, and zero on
406 // decode error.
SSL_SESSION_parse_string(CBS * cbs,char ** out,unsigned tag)407 static int SSL_SESSION_parse_string(CBS *cbs, char **out, unsigned tag) {
408   CBS value;
409   int present;
410   if (!CBS_get_optional_asn1_octet_string(cbs, &value, &present, tag)) {
411     OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_SSL_SESSION);
412     return 0;
413   }
414   if (present) {
415     if (CBS_contains_zero_byte(&value)) {
416       OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_SSL_SESSION);
417       return 0;
418     }
419     if (!CBS_strdup(&value, out)) {
420       OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
421       return 0;
422     }
423   } else {
424     OPENSSL_free(*out);
425     *out = NULL;
426   }
427   return 1;
428 }
429 
430 // SSL_SESSION_parse_string gets an optional ASN.1 OCTET STRING
431 // explicitly tagged with |tag| from |cbs| and stows it in |*out_ptr|
432 // and |*out_len|. If |*out_ptr| is not NULL, it frees the existing
433 // contents. On entry, if the element was not found, it sets
434 // |*out_ptr| to NULL. It returns one on success, whether or not the
435 // element was found, and zero on decode error.
SSL_SESSION_parse_octet_string(CBS * cbs,uint8_t ** out_ptr,size_t * out_len,unsigned tag)436 static int SSL_SESSION_parse_octet_string(CBS *cbs, uint8_t **out_ptr,
437                                           size_t *out_len, unsigned tag) {
438   CBS value;
439   if (!CBS_get_optional_asn1_octet_string(cbs, &value, NULL, tag)) {
440     OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_SSL_SESSION);
441     return 0;
442   }
443   if (!CBS_stow(&value, out_ptr, out_len)) {
444     OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
445     return 0;
446   }
447   return 1;
448 }
449 
SSL_SESSION_parse_crypto_buffer(CBS * cbs,CRYPTO_BUFFER ** out,unsigned tag,CRYPTO_BUFFER_POOL * pool)450 static int SSL_SESSION_parse_crypto_buffer(CBS *cbs, CRYPTO_BUFFER **out,
451                                            unsigned tag,
452                                            CRYPTO_BUFFER_POOL *pool) {
453   if (!CBS_peek_asn1_tag(cbs, tag)) {
454     return 1;
455   }
456 
457   CBS child, value;
458   if (!CBS_get_asn1(cbs, &child, tag) ||
459       !CBS_get_asn1(&child, &value, CBS_ASN1_OCTETSTRING) ||
460       CBS_len(&child) != 0) {
461     OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_SSL_SESSION);
462     return 0;
463   }
464   CRYPTO_BUFFER_free(*out);
465   *out = CRYPTO_BUFFER_new_from_CBS(&value, pool);
466   if (*out == nullptr) {
467     OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
468     return 0;
469   }
470   return 1;
471 }
472 
473 // SSL_SESSION_parse_bounded_octet_string parses an optional ASN.1 OCTET STRING
474 // explicitly tagged with |tag| of size at most |max_out|.
SSL_SESSION_parse_bounded_octet_string(CBS * cbs,uint8_t * out,uint8_t * out_len,uint8_t max_out,unsigned tag)475 static int SSL_SESSION_parse_bounded_octet_string(
476     CBS *cbs, uint8_t *out, uint8_t *out_len, uint8_t max_out, unsigned tag) {
477   CBS value;
478   if (!CBS_get_optional_asn1_octet_string(cbs, &value, NULL, tag) ||
479       CBS_len(&value) > max_out) {
480     OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_SSL_SESSION);
481     return 0;
482   }
483   OPENSSL_memcpy(out, CBS_data(&value), CBS_len(&value));
484   *out_len = (uint8_t)CBS_len(&value);
485   return 1;
486 }
487 
SSL_SESSION_parse_long(CBS * cbs,long * out,unsigned tag,long default_value)488 static int SSL_SESSION_parse_long(CBS *cbs, long *out, unsigned tag,
489                                   long default_value) {
490   uint64_t value;
491   if (!CBS_get_optional_asn1_uint64(cbs, &value, tag,
492                                     (uint64_t)default_value) ||
493       value > LONG_MAX) {
494     OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_SSL_SESSION);
495     return 0;
496   }
497   *out = (long)value;
498   return 1;
499 }
500 
SSL_SESSION_parse_u32(CBS * cbs,uint32_t * out,unsigned tag,uint32_t default_value)501 static int SSL_SESSION_parse_u32(CBS *cbs, uint32_t *out, unsigned tag,
502                                  uint32_t default_value) {
503   uint64_t value;
504   if (!CBS_get_optional_asn1_uint64(cbs, &value, tag,
505                                     (uint64_t)default_value) ||
506       value > 0xffffffff) {
507     OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_SSL_SESSION);
508     return 0;
509   }
510   *out = (uint32_t)value;
511   return 1;
512 }
513 
SSL_SESSION_parse_u16(CBS * cbs,uint16_t * out,unsigned tag,uint16_t default_value)514 static int SSL_SESSION_parse_u16(CBS *cbs, uint16_t *out, unsigned tag,
515                                  uint16_t default_value) {
516   uint64_t value;
517   if (!CBS_get_optional_asn1_uint64(cbs, &value, tag,
518                                     (uint64_t)default_value) ||
519       value > 0xffff) {
520     OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_SSL_SESSION);
521     return 0;
522   }
523   *out = (uint16_t)value;
524   return 1;
525 }
526 
SSL_SESSION_parse(CBS * cbs,const SSL_X509_METHOD * x509_method,CRYPTO_BUFFER_POOL * pool)527 UniquePtr<SSL_SESSION> SSL_SESSION_parse(CBS *cbs,
528                                          const SSL_X509_METHOD *x509_method,
529                                          CRYPTO_BUFFER_POOL *pool) {
530   UniquePtr<SSL_SESSION> ret = ssl_session_new(x509_method);
531   if (!ret) {
532     return nullptr;
533   }
534 
535   CBS session;
536   uint64_t version, ssl_version;
537   uint16_t unused;
538   if (!CBS_get_asn1(cbs, &session, CBS_ASN1_SEQUENCE) ||
539       !CBS_get_asn1_uint64(&session, &version) ||
540       version != kVersion ||
541       !CBS_get_asn1_uint64(&session, &ssl_version) ||
542       // Require sessions have versions valid in either TLS or DTLS. The session
543       // will not be used by the handshake if not applicable, but, for
544       // simplicity, never parse a session that does not pass
545       // |ssl_protocol_version_from_wire|.
546       ssl_version > UINT16_MAX ||
547       !ssl_protocol_version_from_wire(&unused, ssl_version)) {
548     OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_SSL_SESSION);
549     return nullptr;
550   }
551   ret->ssl_version = ssl_version;
552 
553   CBS cipher;
554   uint16_t cipher_value;
555   if (!CBS_get_asn1(&session, &cipher, CBS_ASN1_OCTETSTRING) ||
556       !CBS_get_u16(&cipher, &cipher_value) ||
557       CBS_len(&cipher) != 0) {
558     OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_SSL_SESSION);
559     return nullptr;
560   }
561   ret->cipher = SSL_get_cipher_by_value(cipher_value);
562   if (ret->cipher == NULL) {
563     OPENSSL_PUT_ERROR(SSL, SSL_R_UNSUPPORTED_CIPHER);
564     return nullptr;
565   }
566 
567   CBS session_id, master_key;
568   if (!CBS_get_asn1(&session, &session_id, CBS_ASN1_OCTETSTRING) ||
569       CBS_len(&session_id) > SSL3_MAX_SSL_SESSION_ID_LENGTH ||
570       !CBS_get_asn1(&session, &master_key, CBS_ASN1_OCTETSTRING) ||
571       CBS_len(&master_key) > SSL_MAX_MASTER_KEY_LENGTH) {
572     OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_SSL_SESSION);
573     return nullptr;
574   }
575   OPENSSL_memcpy(ret->session_id, CBS_data(&session_id), CBS_len(&session_id));
576   ret->session_id_length = CBS_len(&session_id);
577   OPENSSL_memcpy(ret->master_key, CBS_data(&master_key), CBS_len(&master_key));
578   ret->master_key_length = CBS_len(&master_key);
579 
580   CBS child;
581   uint64_t timeout;
582   if (!CBS_get_asn1(&session, &child, kTimeTag) ||
583       !CBS_get_asn1_uint64(&child, &ret->time) ||
584       !CBS_get_asn1(&session, &child, kTimeoutTag) ||
585       !CBS_get_asn1_uint64(&child, &timeout) ||
586       timeout > UINT32_MAX) {
587     OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_SSL_SESSION);
588     return nullptr;
589   }
590 
591   ret->timeout = (uint32_t)timeout;
592 
593   CBS peer;
594   int has_peer;
595   if (!CBS_get_optional_asn1(&session, &peer, &has_peer, kPeerTag) ||
596       (has_peer && CBS_len(&peer) == 0)) {
597     OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_SSL_SESSION);
598     return nullptr;
599   }
600   // |peer| is processed with the certificate chain.
601 
602   if (!SSL_SESSION_parse_bounded_octet_string(
603           &session, ret->sid_ctx, &ret->sid_ctx_length, sizeof(ret->sid_ctx),
604           kSessionIDContextTag) ||
605       !SSL_SESSION_parse_long(&session, &ret->verify_result, kVerifyResultTag,
606                               X509_V_OK)) {
607     return nullptr;
608   }
609 
610   // Skip the historical hostName field.
611   CBS unused_hostname;
612   if (!CBS_get_optional_asn1(&session, &unused_hostname, nullptr,
613                              kHostNameTag)) {
614     OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_SSL_SESSION);
615     return nullptr;
616   }
617 
618   if (!SSL_SESSION_parse_string(&session, &ret->psk_identity,
619                                 kPSKIdentityTag) ||
620       !SSL_SESSION_parse_u32(&session, &ret->tlsext_tick_lifetime_hint,
621                              kTicketLifetimeHintTag, 0) ||
622       !SSL_SESSION_parse_octet_string(&session, &ret->tlsext_tick,
623                                       &ret->tlsext_ticklen, kTicketTag)) {
624     return nullptr;
625   }
626 
627   if (CBS_peek_asn1_tag(&session, kPeerSHA256Tag)) {
628     CBS peer_sha256;
629     if (!CBS_get_asn1(&session, &child, kPeerSHA256Tag) ||
630         !CBS_get_asn1(&child, &peer_sha256, CBS_ASN1_OCTETSTRING) ||
631         CBS_len(&peer_sha256) != sizeof(ret->peer_sha256) ||
632         CBS_len(&child) != 0) {
633       OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_SSL_SESSION);
634       return nullptr;
635     }
636     OPENSSL_memcpy(ret->peer_sha256, CBS_data(&peer_sha256),
637                    sizeof(ret->peer_sha256));
638     ret->peer_sha256_valid = 1;
639   } else {
640     ret->peer_sha256_valid = 0;
641   }
642 
643   if (!SSL_SESSION_parse_bounded_octet_string(
644           &session, ret->original_handshake_hash,
645           &ret->original_handshake_hash_len,
646           sizeof(ret->original_handshake_hash), kOriginalHandshakeHashTag) ||
647       !SSL_SESSION_parse_crypto_buffer(&session,
648                                        &ret->signed_cert_timestamp_list,
649                                        kSignedCertTimestampListTag, pool) ||
650       !SSL_SESSION_parse_crypto_buffer(&session, &ret->ocsp_response,
651                                        kOCSPResponseTag, pool)) {
652     return nullptr;
653   }
654 
655   int extended_master_secret;
656   if (!CBS_get_optional_asn1_bool(&session, &extended_master_secret,
657                                   kExtendedMasterSecretTag,
658                                   0 /* default to false */)) {
659     OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_SSL_SESSION);
660     return nullptr;
661   }
662   ret->extended_master_secret = !!extended_master_secret;
663 
664   if (!SSL_SESSION_parse_u16(&session, &ret->group_id, kGroupIDTag, 0)) {
665     OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_SSL_SESSION);
666     return nullptr;
667   }
668 
669   CBS cert_chain;
670   CBS_init(&cert_chain, NULL, 0);
671   int has_cert_chain;
672   if (!CBS_get_optional_asn1(&session, &cert_chain, &has_cert_chain,
673                              kCertChainTag) ||
674       (has_cert_chain && CBS_len(&cert_chain) == 0)) {
675     OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_SSL_SESSION);
676     return nullptr;
677   }
678   if (has_cert_chain && !has_peer) {
679     OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_SSL_SESSION);
680     return nullptr;
681   }
682   if (has_peer || has_cert_chain) {
683     ret->certs = sk_CRYPTO_BUFFER_new_null();
684     if (ret->certs == NULL) {
685       OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
686       return nullptr;
687     }
688 
689     if (has_peer) {
690       UniquePtr<CRYPTO_BUFFER> buffer(CRYPTO_BUFFER_new_from_CBS(&peer, pool));
691       if (!buffer ||
692           !PushToStack(ret->certs, std::move(buffer))) {
693         OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
694         return nullptr;
695       }
696     }
697 
698     while (CBS_len(&cert_chain) > 0) {
699       CBS cert;
700       if (!CBS_get_any_asn1_element(&cert_chain, &cert, NULL, NULL) ||
701           CBS_len(&cert) == 0) {
702         OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_SSL_SESSION);
703         return nullptr;
704       }
705 
706       CRYPTO_BUFFER *buffer = CRYPTO_BUFFER_new_from_CBS(&cert, pool);
707       if (buffer == NULL ||
708           !sk_CRYPTO_BUFFER_push(ret->certs, buffer)) {
709         CRYPTO_BUFFER_free(buffer);
710         OPENSSL_PUT_ERROR(SSL, ERR_R_MALLOC_FAILURE);
711         return nullptr;
712       }
713     }
714   }
715 
716   if (!x509_method->session_cache_objects(ret.get())) {
717     OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_SSL_SESSION);
718     return nullptr;
719   }
720 
721   CBS age_add;
722   int age_add_present;
723   if (!CBS_get_optional_asn1_octet_string(&session, &age_add, &age_add_present,
724                                           kTicketAgeAddTag) ||
725       (age_add_present &&
726        !CBS_get_u32(&age_add, &ret->ticket_age_add)) ||
727       CBS_len(&age_add) != 0) {
728     return nullptr;
729   }
730   ret->ticket_age_add_valid = age_add_present;
731 
732   int is_server;
733   if (!CBS_get_optional_asn1_bool(&session, &is_server, kIsServerTag,
734                                   1 /* default to true */)) {
735     OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_SSL_SESSION);
736     return nullptr;
737   }
738   /* TODO: in time we can include |is_server| for servers too, then we can
739      enforce that client and server sessions are never mixed up. */
740 
741   ret->is_server = is_server;
742 
743   if (!SSL_SESSION_parse_u16(&session, &ret->peer_signature_algorithm,
744                              kPeerSignatureAlgorithmTag, 0) ||
745       !SSL_SESSION_parse_u32(&session, &ret->ticket_max_early_data,
746                              kTicketMaxEarlyDataTag, 0) ||
747       !SSL_SESSION_parse_u32(&session, &ret->auth_timeout, kAuthTimeoutTag,
748                              ret->timeout) ||
749       !SSL_SESSION_parse_octet_string(&session, &ret->early_alpn,
750                                       &ret->early_alpn_len, kEarlyALPNTag) ||
751       CBS_len(&session) != 0) {
752     OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_SSL_SESSION);
753     return nullptr;
754   }
755 
756   return ret;
757 }
758 
ssl_session_serialize(const SSL_SESSION * in,CBB * cbb)759 int ssl_session_serialize(const SSL_SESSION *in, CBB *cbb) {
760   return SSL_SESSION_to_bytes_full(in, cbb, 0);
761 }
762 
763 }  // namespace bssl
764 
765 using namespace bssl;
766 
SSL_SESSION_to_bytes(const SSL_SESSION * in,uint8_t ** out_data,size_t * out_len)767 int SSL_SESSION_to_bytes(const SSL_SESSION *in, uint8_t **out_data,
768                          size_t *out_len) {
769   if (in->not_resumable) {
770     // If the caller has an unresumable session, e.g. if |SSL_get_session| were
771     // called on a TLS 1.3 or False Started connection, serialize with a
772     // placeholder value so it is not accidentally deserialized into a resumable
773     // one.
774     static const char kNotResumableSession[] = "NOT RESUMABLE";
775 
776     *out_len = strlen(kNotResumableSession);
777     *out_data = (uint8_t *)BUF_memdup(kNotResumableSession, *out_len);
778     if (*out_data == NULL) {
779       return 0;
780     }
781 
782     return 1;
783   }
784 
785   ScopedCBB cbb;
786   if (!CBB_init(cbb.get(), 256) ||
787       !SSL_SESSION_to_bytes_full(in, cbb.get(), 0) ||
788       !CBB_finish(cbb.get(), out_data, out_len)) {
789     return 0;
790   }
791 
792   return 1;
793 }
794 
SSL_SESSION_to_bytes_for_ticket(const SSL_SESSION * in,uint8_t ** out_data,size_t * out_len)795 int SSL_SESSION_to_bytes_for_ticket(const SSL_SESSION *in, uint8_t **out_data,
796                                     size_t *out_len) {
797   ScopedCBB cbb;
798   if (!CBB_init(cbb.get(), 256) ||
799       !SSL_SESSION_to_bytes_full(in, cbb.get(), 1) ||
800       !CBB_finish(cbb.get(), out_data, out_len)) {
801     return 0;
802   }
803 
804   return 1;
805 }
806 
i2d_SSL_SESSION(SSL_SESSION * in,uint8_t ** pp)807 int i2d_SSL_SESSION(SSL_SESSION *in, uint8_t **pp) {
808   uint8_t *out;
809   size_t len;
810 
811   if (!SSL_SESSION_to_bytes(in, &out, &len)) {
812     return -1;
813   }
814 
815   if (len > INT_MAX) {
816     OPENSSL_free(out);
817     OPENSSL_PUT_ERROR(SSL, ERR_R_OVERFLOW);
818     return -1;
819   }
820 
821   if (pp) {
822     OPENSSL_memcpy(*pp, out, len);
823     *pp += len;
824   }
825   OPENSSL_free(out);
826 
827   return len;
828 }
829 
SSL_SESSION_from_bytes(const uint8_t * in,size_t in_len,const SSL_CTX * ctx)830 SSL_SESSION *SSL_SESSION_from_bytes(const uint8_t *in, size_t in_len,
831                                     const SSL_CTX *ctx) {
832   CBS cbs;
833   CBS_init(&cbs, in, in_len);
834   UniquePtr<SSL_SESSION> ret =
835       SSL_SESSION_parse(&cbs, ctx->x509_method, ctx->pool);
836   if (!ret) {
837     return NULL;
838   }
839   if (CBS_len(&cbs) != 0) {
840     OPENSSL_PUT_ERROR(SSL, SSL_R_INVALID_SSL_SESSION);
841     return NULL;
842   }
843   return ret.release();
844 }
845