2 * SSL session cache implementation
\r
4 * Copyright (C) 2006-2015, ARM Limited, All Rights Reserved
\r
5 * SPDX-License-Identifier: Apache-2.0
\r
7 * Licensed under the Apache License, Version 2.0 (the "License"); you may
\r
8 * not use this file except in compliance with the License.
\r
9 * You may obtain a copy of the License at
\r
11 * http://www.apache.org/licenses/LICENSE-2.0
\r
13 * Unless required by applicable law or agreed to in writing, software
\r
14 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
\r
15 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
\r
16 * See the License for the specific language governing permissions and
\r
17 * limitations under the License.
\r
19 * This file is part of mbed TLS (https://tls.mbed.org)
\r
22 * These session callbacks use a simple chained list
\r
23 * to store and retrieve the session information.
\r
26 #if !defined(MBEDTLS_CONFIG_FILE)
\r
27 #include "mbedtls/config.h"
\r
29 #include MBEDTLS_CONFIG_FILE
\r
32 #if defined(MBEDTLS_SSL_CACHE_C)
\r
34 #if defined(MBEDTLS_PLATFORM_C)
\r
35 #include "mbedtls/platform.h"
\r
38 #define mbedtls_calloc calloc
\r
39 #define mbedtls_free free
\r
42 #include "mbedtls/ssl_cache.h"
\r
43 #include "mbedtls/ssl_internal.h"
\r
47 void mbedtls_ssl_cache_init( mbedtls_ssl_cache_context *cache )
\r
49 memset( cache, 0, sizeof( mbedtls_ssl_cache_context ) );
\r
51 cache->timeout = MBEDTLS_SSL_CACHE_DEFAULT_TIMEOUT;
\r
52 cache->max_entries = MBEDTLS_SSL_CACHE_DEFAULT_MAX_ENTRIES;
\r
54 #if defined(MBEDTLS_THREADING_C)
\r
55 mbedtls_mutex_init( &cache->mutex );
\r
59 int mbedtls_ssl_cache_get( void *data, mbedtls_ssl_session *session )
\r
62 #if defined(MBEDTLS_HAVE_TIME)
\r
63 mbedtls_time_t t = mbedtls_time( NULL );
\r
65 mbedtls_ssl_cache_context *cache = (mbedtls_ssl_cache_context *) data;
\r
66 mbedtls_ssl_cache_entry *cur, *entry;
\r
68 #if defined(MBEDTLS_THREADING_C)
\r
69 if( mbedtls_mutex_lock( &cache->mutex ) != 0 )
\r
76 while( cur != NULL )
\r
81 #if defined(MBEDTLS_HAVE_TIME)
\r
82 if( cache->timeout != 0 &&
\r
83 (int) ( t - entry->timestamp ) > cache->timeout )
\r
87 if( session->ciphersuite != entry->session.ciphersuite ||
\r
88 session->compression != entry->session.compression ||
\r
89 session->id_len != entry->session.id_len )
\r
92 if( memcmp( session->id, entry->session.id,
\r
93 entry->session.id_len ) != 0 )
\r
96 ret = mbedtls_ssl_session_copy( session, &entry->session );
\r
103 #if defined(MBEDTLS_X509_CRT_PARSE_C) && \
\r
104 defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
\r
106 * Restore peer certificate (without rest of the original chain)
\r
108 if( entry->peer_cert.p != NULL )
\r
110 /* `session->peer_cert` is NULL after the call to
\r
111 * mbedtls_ssl_session_copy(), because cache entries
\r
112 * have the `peer_cert` field set to NULL. */
\r
114 if( ( session->peer_cert = mbedtls_calloc( 1,
\r
115 sizeof(mbedtls_x509_crt) ) ) == NULL )
\r
121 mbedtls_x509_crt_init( session->peer_cert );
\r
122 if( mbedtls_x509_crt_parse( session->peer_cert, entry->peer_cert.p,
\r
123 entry->peer_cert.len ) != 0 )
\r
125 mbedtls_free( session->peer_cert );
\r
126 session->peer_cert = NULL;
\r
131 #endif /* MBEDTLS_X509_CRT_PARSE_C && MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
\r
138 #if defined(MBEDTLS_THREADING_C)
\r
139 if( mbedtls_mutex_unlock( &cache->mutex ) != 0 )
\r
146 int mbedtls_ssl_cache_set( void *data, const mbedtls_ssl_session *session )
\r
149 #if defined(MBEDTLS_HAVE_TIME)
\r
150 mbedtls_time_t t = mbedtls_time( NULL ), oldest = 0;
\r
151 mbedtls_ssl_cache_entry *old = NULL;
\r
153 mbedtls_ssl_cache_context *cache = (mbedtls_ssl_cache_context *) data;
\r
154 mbedtls_ssl_cache_entry *cur, *prv;
\r
157 #if defined(MBEDTLS_THREADING_C)
\r
158 if( ( ret = mbedtls_mutex_lock( &cache->mutex ) ) != 0 )
\r
162 cur = cache->chain;
\r
165 while( cur != NULL )
\r
169 #if defined(MBEDTLS_HAVE_TIME)
\r
170 if( cache->timeout != 0 &&
\r
171 (int) ( t - cur->timestamp ) > cache->timeout )
\r
173 cur->timestamp = t;
\r
174 break; /* expired, reuse this slot, update timestamp */
\r
178 if( memcmp( session->id, cur->session.id, cur->session.id_len ) == 0 )
\r
179 break; /* client reconnected, keep timestamp for session id */
\r
181 #if defined(MBEDTLS_HAVE_TIME)
\r
182 if( oldest == 0 || cur->timestamp < oldest )
\r
184 oldest = cur->timestamp;
\r
195 #if defined(MBEDTLS_HAVE_TIME)
\r
197 * Reuse oldest entry if max_entries reached
\r
199 if( count >= cache->max_entries )
\r
209 #else /* MBEDTLS_HAVE_TIME */
\r
211 * Reuse first entry in chain if max_entries reached,
\r
212 * but move to last place
\r
214 if( count >= cache->max_entries )
\r
216 if( cache->chain == NULL )
\r
222 cur = cache->chain;
\r
223 cache->chain = cur->next;
\r
227 #endif /* MBEDTLS_HAVE_TIME */
\r
231 * max_entries not reached, create new entry
\r
233 cur = mbedtls_calloc( 1, sizeof(mbedtls_ssl_cache_entry) );
\r
241 cache->chain = cur;
\r
246 #if defined(MBEDTLS_HAVE_TIME)
\r
247 cur->timestamp = t;
\r
251 #if defined(MBEDTLS_X509_CRT_PARSE_C) && \
\r
252 defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
\r
254 * If we're reusing an entry, free its certificate first
\r
256 if( cur->peer_cert.p != NULL )
\r
258 mbedtls_free( cur->peer_cert.p );
\r
259 memset( &cur->peer_cert, 0, sizeof(mbedtls_x509_buf) );
\r
261 #endif /* MBEDTLS_X509_CRT_PARSE_C && MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
\r
263 /* Copy the entire session; this temporarily makes a copy of the
\r
264 * X.509 CRT structure even though we only want to store the raw CRT.
\r
265 * This inefficiency will go away as soon as we implement on-demand
\r
266 * parsing of CRTs, in which case there's no need for the `peer_cert`
\r
267 * field anymore in the first place, and we're done after this call. */
\r
268 ret = mbedtls_ssl_session_copy( &cur->session, session );
\r
275 #if defined(MBEDTLS_X509_CRT_PARSE_C) && \
\r
276 defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
\r
277 /* If present, free the X.509 structure and only store the raw CRT data. */
\r
278 if( cur->session.peer_cert != NULL )
\r
281 mbedtls_calloc( 1, cur->session.peer_cert->raw.len );
\r
282 if( cur->peer_cert.p == NULL )
\r
288 memcpy( cur->peer_cert.p,
\r
289 cur->session.peer_cert->raw.p,
\r
290 cur->session.peer_cert->raw.len );
\r
291 cur->peer_cert.len = session->peer_cert->raw.len;
\r
293 mbedtls_x509_crt_free( cur->session.peer_cert );
\r
294 mbedtls_free( cur->session.peer_cert );
\r
295 cur->session.peer_cert = NULL;
\r
297 #endif /* MBEDTLS_X509_CRT_PARSE_C && MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
\r
302 #if defined(MBEDTLS_THREADING_C)
\r
303 if( mbedtls_mutex_unlock( &cache->mutex ) != 0 )
\r
310 #if defined(MBEDTLS_HAVE_TIME)
\r
311 void mbedtls_ssl_cache_set_timeout( mbedtls_ssl_cache_context *cache, int timeout )
\r
313 if( timeout < 0 ) timeout = 0;
\r
315 cache->timeout = timeout;
\r
317 #endif /* MBEDTLS_HAVE_TIME */
\r
319 void mbedtls_ssl_cache_set_max_entries( mbedtls_ssl_cache_context *cache, int max )
\r
321 if( max < 0 ) max = 0;
\r
323 cache->max_entries = max;
\r
326 void mbedtls_ssl_cache_free( mbedtls_ssl_cache_context *cache )
\r
328 mbedtls_ssl_cache_entry *cur, *prv;
\r
330 cur = cache->chain;
\r
332 while( cur != NULL )
\r
337 mbedtls_ssl_session_free( &prv->session );
\r
339 #if defined(MBEDTLS_X509_CRT_PARSE_C) && \
\r
340 defined(MBEDTLS_SSL_KEEP_PEER_CERTIFICATE)
\r
341 mbedtls_free( prv->peer_cert.p );
\r
342 #endif /* MBEDTLS_X509_CRT_PARSE_C && MBEDTLS_SSL_KEEP_PEER_CERTIFICATE */
\r
344 mbedtls_free( prv );
\r
347 #if defined(MBEDTLS_THREADING_C)
\r
348 mbedtls_mutex_free( &cache->mutex );
\r
350 cache->chain = NULL;
\r
353 #endif /* MBEDTLS_SSL_CACHE_C */
\r