6 * This program is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
20 * Copyright 2001 hereUare Communications, Inc. <raghud@hereuare.com>
21 * Copyright 2003 Alan DeKok <aland@freeradius.org>
22 * Copyright 2006 The FreeRADIUS server project
26 USES_APPLE_DEPRECATED_API /* OpenSSL API has been deprecated by Apple */
28 #include <freeradius-devel/radiusd.h>
29 #include <freeradius-devel/process.h>
30 #include <freeradius-devel/rad_assert.h>
32 #ifdef HAVE_SYS_STAT_H
46 # ifdef HAVE_OPENSSL_RAND_H
47 # include <openssl/rand.h>
50 # ifdef HAVE_OPENSSL_OCSP_H
51 # include <openssl/ocsp.h>
54 # ifdef HAVE_OPENSSL_EVP_H
55 # include <openssl/evp.h>
57 # include <openssl/ssl.h>
59 #define LOG_PREFIX "tls"
61 #ifdef ENABLE_OPENSSL_VERSION_CHECK
62 typedef struct libssl_defect {
71 /* Record critical defects in libssl here, new versions of OpenSSL to older versions of OpenSSL. */
72 static libssl_defect_t libssl_defects[] =
75 .low = 0x01010101f, /* 1.1.0a */
76 .high = 0x01010101f, /* 1.1.0a */
77 .id = "CVE-2016-6309",
78 .name = "OCSP status request extension",
79 .comment = "For more information see https://www.openssl.org/news/secadv/20160926.txt"
82 .low = 0x01010100f, /* 1.1.0 */
83 .high = 0x01010100f, /* 1.1.0 */
84 .id = "CVE-2016-6304",
85 .name = "OCSP status request extension",
86 .comment = "For more information see https://www.openssl.org/news/secadv/20160922.txt"
89 .low = 0x01000209f, /* 1.0.2i */
90 .high = 0x01000209f, /* 1.0.2i */
91 .id = "CVE-2016-7052",
92 .name = "OCSP status request extension",
93 .comment = "For more information see https://www.openssl.org/news/secadv/20160926.txt"
96 .low = 0x01000200f, /* 1.0.2 */
97 .high = 0x01000208f, /* 1.0.2h */
98 .id = "CVE-2016-6304",
99 .name = "OCSP status request extension",
100 .comment = "For more information see https://www.openssl.org/news/secadv/20160922.txt"
103 .low = 0x01000100f, /* 1.0.1 */
104 .high = 0x01000114f, /* 1.0.1t */
105 .id = "CVE-2016-6304",
106 .name = "OCSP status request extension",
107 .comment = "For more information see https://www.openssl.org/news/secadv/20160922.txt"
110 .low = 0x010001000, /* 1.0.1 */
111 .high = 0x01000106f, /* 1.0.1f */
112 .id = "CVE-2014-0160",
113 .name = "Heartbleed",
114 .comment = "For more information see http://heartbleed.com"
117 #endif /* ENABLE_OPENSSL_VERSION_CHECK */
119 FR_NAME_NUMBER const fr_tls_status_table[] = {
120 { "invalid", FR_TLS_INVALID },
121 { "request", FR_TLS_REQUEST },
122 { "response", FR_TLS_RESPONSE },
123 { "success", FR_TLS_SUCCESS },
124 { "fail", FR_TLS_FAIL },
125 { "noop", FR_TLS_NOOP },
127 { "start", FR_TLS_START },
129 { "ack", FR_TLS_ACK },
130 { "first fragment", FR_TLS_FIRST_FRAGMENT },
131 { "more fragments", FR_TLS_MORE_FRAGMENTS },
132 { "length included", FR_TLS_LENGTH_INCLUDED },
133 { "more fragments with length", FR_TLS_MORE_FRAGMENTS_WITH_LENGTH },
134 { "handled", FR_TLS_HANDLED },
138 /* index we use to store cached session VPs
139 * needs to be dynamic so we can supply a "free" function
141 int fr_tls_ex_index_vps = -1;
142 int fr_tls_ex_index_certs = -1;
145 static void session_close(tls_session_t *ssn);
146 static void session_init(tls_session_t *ssn);
149 static void record_init(record_t *buf);
150 static void record_close(record_t *buf);
151 static unsigned int record_plus(record_t *buf, void const *ptr,
153 static unsigned int record_minus(record_t *buf, void *ptr,
156 DIAG_OFF(format-nonliteral)
157 /** Print errors in the TLS thread local error stack
159 * Drains the thread local OpenSSL error queue, and prints out errors.
161 * @param[in] request The current request (may be NULL).
162 * @param[in] msg Error message describing the operation being attempted.
163 * @param[in] ap Arguments for msg.
164 * @return the number of errors drained from the stack.
166 static int tls_verror_log(REQUEST *request, char const *msg, va_list ap)
177 * Pop the first error, so ERR_peek_error()
178 * can be used to determine if there are
181 error = ERR_get_error_line(&file, &line);
184 p = talloc_vasprintf(request, msg, ap);
187 * Single line mode (there's only one error)
189 if (error && !ERR_peek_error()) {
190 ERR_error_string_n(error, buffer, sizeof(buffer));
193 if ((request && RDEBUG_ENABLED3) || DEBUG_ENABLED3) {
194 ROPTIONAL(REDEBUG, ERROR, "%s: %s[%i]:%s", p, file, line, buffer);
196 ROPTIONAL(REDEBUG, ERROR, "%s: %s", p, buffer);
205 * Print the error we were given, irrespective
206 * of whether there were any OpenSSL errors.
208 ROPTIONAL(RERROR, ERROR, "%s", p);
213 * Stack mode (there are multiple errors)
215 if (!error) return 0;
217 ERR_error_string_n(error, buffer, sizeof(buffer));
219 if ((request && RDEBUG_ENABLED3) || DEBUG_ENABLED3) {
220 ROPTIONAL(REDEBUG, ERROR, "%s[%i]:%s", file, line, buffer);
222 ROPTIONAL(REDEBUG, ERROR, "%s", buffer);
225 } while ((error = ERR_get_error_line(&file, &line)));
229 DIAG_ON(format-nonliteral)
231 /** Print errors in the TLS thread local error stack
233 * Drains the thread local OpenSSL error queue, and prints out errors.
235 * @param[in] request The current request (may be NULL).
236 * @param[in] msg Error message describing the operation being attempted.
237 * @param[in] ... Arguments for msg.
238 * @return the number of errors drained from the stack.
240 int tls_error_log(REQUEST *request, char const *msg, ...)
246 ret = tls_verror_log(request, msg, ap);
252 /** Print errors raised by OpenSSL I/O functions
254 * Drains the thread local OpenSSL error queue, and prints out errors
255 * based on the SSL handle and the return code of the I/O function.
257 * OpenSSL lists I/O functions to be:
265 * @param request The current request (may be NULL).
266 * @param session The current tls_session.
267 * @param ret from the I/O operation.
268 * @param msg Error message describing the operation being attempted.
269 * @param ... Arguments for msg.
271 * - 0 TLS session cannot continue.
272 * - 1 TLS session may still be viable.
274 int tls_error_io_log(REQUEST *request, tls_session_t *session, int ret, char const *msg, ...)
279 if (ERR_peek_error()) {
281 tls_verror_log(request, msg, ap);
285 error = SSL_get_error(session->ssl, ret);
288 * These seem to be harmless and already "dealt
289 * with" by our non-blocking environment. NB:
290 * "ZERO_RETURN" is the clean "error"
291 * indicating a successfully closed SSL
292 * tunnel. We let this happen because our IO
293 * loop should not appear to have broken on
294 * this condition - and outside the IO loop, the
295 * "shutdown" state is checked.
297 * Don't print anything if we ignore the error.
300 case SSL_ERROR_WANT_READ:
301 case SSL_ERROR_WANT_WRITE:
302 case SSL_ERROR_WANT_X509_LOOKUP:
303 case SSL_ERROR_ZERO_RETURN:
307 * These seem to be indications of a genuine
308 * error that should result in the SSL tunnel
309 * being regarded as "dead".
311 case SSL_ERROR_SYSCALL:
312 ROPTIONAL(REDEBUG, ERROR, "System call (I/O) error (%i)", ret);
316 ROPTIONAL(REDEBUG, ERROR, "TLS protocol error (%i)", ret);
320 * For any other errors that (a) exist, and (b)
321 * crop up - we need to interpret what to do with
322 * them - so "politely inform" the caller that
323 * the code needs updating here.
326 ROPTIONAL(REDEBUG, ERROR, "TLS session error %i (%i)", error, ret);
333 #ifdef PSK_MAX_IDENTITY_LEN
334 static bool identity_is_safe(const char *identity)
338 if (!identity) return true;
340 while ((c = *(identity++)) != '\0') {
341 if (isalpha((int) c) || isdigit((int) c) || isspace((int) c) ||
342 (c == '@') || (c == '-') || (c == '_') || (c == '.')) {
353 * When a client uses TLS-PSK to talk to a server, this callback
354 * is used by the server to determine the PSK to use.
356 static unsigned int psk_server_callback(SSL *ssl, const char *identity,
358 unsigned int max_psk_len)
360 unsigned int psk_len = 0;
361 fr_tls_server_conf_t *conf;
364 conf = (fr_tls_server_conf_t *)SSL_get_ex_data(ssl,
365 FR_TLS_EX_INDEX_CONF);
368 request = (REQUEST *)SSL_get_ex_data(ssl,
369 FR_TLS_EX_INDEX_REQUEST);
370 if (request && conf->psk_query) {
373 char buffer[2 * PSK_MAX_PSK_LEN + 4]; /* allow for too-long keys */
376 * The passed identity is weird. Deny it.
378 if (!identity_is_safe(identity)) {
379 RWDEBUG("Invalid characters in PSK identity %s", identity);
383 vp = pair_make_request("TLS-PSK-Identity", identity, T_OP_SET);
386 hex_len = radius_xlat(buffer, sizeof(buffer), request, conf->psk_query,
389 RWDEBUG("PSK expansion returned an empty string.");
394 * The returned key is truncated at MORE than
395 * OpenSSL can handle. That way we can detect
396 * the truncation, and complain about it.
398 if (hex_len > (2 * max_psk_len)) {
399 RWDEBUG("Returned PSK is too long (%u > %u)",
400 (unsigned int) hex_len, 2 * max_psk_len);
405 * Leave the TLS-PSK-Identity in the request, and
406 * convert the expansion from printable string
409 return fr_hex2bin(psk, max_psk_len, buffer, hex_len);
412 if (!conf->psk_identity) {
413 DEBUG("No static PSK identity set. Rejecting the user");
418 * No REQUEST, or no dynamic query. Just look for a
421 if (strcmp(identity, conf->psk_identity) != 0) {
422 ERROR("Supplied PSK identity %s does not match configuration. Rejecting.",
427 psk_len = strlen(conf->psk_password);
428 if (psk_len > (2 * max_psk_len)) return 0;
430 return fr_hex2bin(psk, max_psk_len, conf->psk_password, psk_len);
433 static unsigned int psk_client_callback(SSL *ssl, UNUSED char const *hint,
434 char *identity, unsigned int max_identity_len,
435 unsigned char *psk, unsigned int max_psk_len)
437 unsigned int psk_len;
438 fr_tls_server_conf_t *conf;
440 conf = (fr_tls_server_conf_t *)SSL_get_ex_data(ssl,
441 FR_TLS_EX_INDEX_CONF);
444 psk_len = strlen(conf->psk_password);
445 if (psk_len > (2 * max_psk_len)) return 0;
447 strlcpy(identity, conf->psk_identity, max_identity_len);
449 return fr_hex2bin(psk, max_psk_len, conf->psk_password, psk_len);
454 #define MAX_SESSION_SIZE (256)
457 void tls_session_id(SSL_SESSION *ssn, char *buffer, size_t bufsize)
459 #if OPENSSL_VERSION_NUMBER < 0x10001000L
462 size = ssn->session_id_length;
463 if (size > bufsize) size = bufsize;
465 fr_bin2hex(buffer, ssn->session_id, size);
470 p = SSL_SESSION_get_id(ssn, &size);
471 if (size > bufsize) size = bufsize;
473 fr_bin2hex(buffer, p, size);
480 static int _tls_session_free(tls_session_t *ssn)
483 * Free any opaque TTLS or PEAP data.
485 if ((ssn->opaque) && (ssn->free_opaque)) {
486 ssn->free_opaque(ssn->opaque);
495 tls_session_t *tls_new_client_session(TALLOC_CTX *ctx, fr_tls_server_conf_t *conf, int fd)
499 tls_session_t *ssn = NULL;
502 ssn = talloc_zero(ctx, tls_session_t);
503 if (!ssn) return NULL;
505 talloc_set_destructor(ssn, _tls_session_free);
507 ssn->ctx = conf->ctx;
508 ssn->mtu = conf->fragment_size;
510 SSL_CTX_set_mode(ssn->ctx, SSL_MODE_ACCEPT_MOVING_WRITE_BUFFER | SSL_MODE_AUTO_RETRY);
512 ssn->ssl = SSL_new(ssn->ctx);
518 request = request_alloc(ssn);
519 SSL_set_ex_data(ssn->ssl, FR_TLS_EX_INDEX_REQUEST, (void *)request);
522 * Add the message callback to identify what type of
523 * message/handshake is passed
525 SSL_set_msg_callback(ssn->ssl, cbtls_msg);
526 SSL_set_msg_callback_arg(ssn->ssl, ssn);
527 SSL_set_info_callback(ssn->ssl, cbtls_info);
530 * Always verify the peer certificate.
532 DEBUG2("Requiring Server certificate");
533 verify_mode = SSL_VERIFY_PEER;
534 verify_mode |= SSL_VERIFY_FAIL_IF_NO_PEER_CERT;
535 SSL_set_verify(ssn->ssl, verify_mode, cbtls_verify);
537 SSL_set_ex_data(ssn->ssl, FR_TLS_EX_INDEX_CONF, (void *)conf);
538 SSL_set_ex_data(ssn->ssl, FR_TLS_EX_INDEX_SSN, (void *)ssn);
539 SSL_set_fd(ssn->ssl, fd);
540 ret = SSL_connect(ssn->ssl);
543 switch (SSL_get_error(ssn->ssl, ret)) {
549 case SSL_ERROR_WANT_READ:
550 case SSL_ERROR_WANT_WRITE:
551 ssn->connected = false;
557 tls_error_io_log(NULL, ssn, ret, "Failed in " STRINGIFY(__FUNCTION__) " (SSL_connect)");
563 ssn->connected = true;
567 /** Create a new TLS session
569 * Configures a new TLS session, configuring options, setting callbacks etc...
571 * @param ctx to alloc session data in. Should usually be NULL unless the lifetime of the
572 * session is tied to another talloc'd object.
573 * @param conf to use to configure the tls session.
574 * @param request The current #REQUEST.
575 * @param client_cert Whether to require a client_cert.
576 * @return a new session on success, or NULL on error.
578 tls_session_t *tls_new_session(TALLOC_CTX *ctx, fr_tls_server_conf_t *conf, REQUEST *request, bool client_cert)
580 tls_session_t *state = NULL;
585 rad_assert(request != NULL);
587 RDEBUG2("Initiating new EAP-TLS session");
590 * Manually flush the sessions every so often. If HALF
591 * of the session lifetime has passed since we last
592 * flushed, then flush it again.
594 * FIXME: Also do it every N sessions?
596 if (conf->session_cache_enable &&
597 ((conf->session_last_flushed + ((int)conf->session_timeout * 1800)) <= request->timestamp)){
598 RDEBUG2("Flushing SSL sessions (of #%ld)", SSL_CTX_sess_number(conf->ctx));
600 SSL_CTX_flush_sessions(conf->ctx, request->timestamp);
601 conf->session_last_flushed = request->timestamp;
604 new_tls = SSL_new(conf->ctx);
605 if (new_tls == NULL) {
606 tls_error_log(request, "Error creating new TLS session");
610 /* We use the SSL's "app_data" to indicate a call-back */
611 SSL_set_app_data(new_tls, NULL);
613 if ((state = talloc_zero(ctx, tls_session_t)) == NULL) {
614 RERROR("Error allocating memory for SSL state");
618 talloc_set_destructor(state, _tls_session_free);
620 state->ctx = conf->ctx;
621 state->ssl = new_tls;
624 * Initialize callbacks
626 state->record_init = record_init;
627 state->record_close = record_close;
628 state->record_plus = record_plus;
629 state->record_minus = record_minus;
632 * Create & hook the BIOs to handle the dirty side of the
633 * SSL. This is *very important* as we want to handle
634 * the transmission part. Now the only IO interface
635 * that SSL is aware of, is our defined BIO buffers.
637 * This means that all SSL IO is done to/from memory,
638 * and we can update those BIOs from the packets we've
641 state->into_ssl = BIO_new(BIO_s_mem());
642 state->from_ssl = BIO_new(BIO_s_mem());
643 SSL_set_bio(state->ssl, state->into_ssl, state->from_ssl);
646 * Add the message callback to identify what type of
647 * message/handshake is passed
649 SSL_set_msg_callback(new_tls, cbtls_msg);
650 SSL_set_msg_callback_arg(new_tls, state);
651 SSL_set_info_callback(new_tls, cbtls_info);
654 * In Server mode we only accept.
656 SSL_set_accept_state(state->ssl);
659 * Verify the peer certificate, if asked.
662 RDEBUG2("Setting verify mode to require certificate from client");
663 verify_mode = SSL_VERIFY_PEER;
664 verify_mode |= SSL_VERIFY_FAIL_IF_NO_PEER_CERT;
665 verify_mode |= SSL_VERIFY_CLIENT_ONCE;
667 SSL_set_verify(state->ssl, verify_mode, cbtls_verify);
669 SSL_set_ex_data(state->ssl, FR_TLS_EX_INDEX_CONF, (void *)conf);
670 SSL_set_ex_data(state->ssl, FR_TLS_EX_INDEX_SSN, (void *)state);
671 state->length_flag = conf->include_length;
674 * We use default fragment size, unless the Framed-MTU
675 * tells us it's too big. Note that we do NOT account
676 * for the EAP-TLS headers if conf->fragment_size is
677 * large, because that config item looks to be confusing.
679 * i.e. it should REALLY be called MTU, and the code here
680 * should figure out what that means for TLS fragment size.
681 * asking the administrator to know the internal details
682 * of EAP-TLS in order to calculate fragment sizes is
685 state->mtu = conf->fragment_size;
686 vp = fr_pair_find_by_num(request->packet->vps, PW_FRAMED_MTU, 0, TAG_ANY);
687 if (vp && (vp->vp_integer > 100) && (vp->vp_integer < state->mtu)) {
688 state->mtu = vp->vp_integer;
691 if (conf->session_cache_enable) state->allow_session_resumption = true; /* otherwise it's false */
697 * We are the server, we always get the dirty data
698 * (Handshake data is also considered as dirty data)
699 * During handshake, since SSL API handles itself,
700 * After clean-up, dirty_out will be filled with
701 * the data required for handshaking. So we check
702 * if dirty_out is empty then we simply send it back.
703 * As of now, if handshake is successful, then we keep going,
706 * Fill the Bio with the dirty data to clean it
707 * Get the cleaned data from SSL, if it is not Handshake data
709 int tls_handshake_recv(REQUEST *request, tls_session_t *ssn)
713 if (ssn->invalid_hb_used) return 0;
715 err = BIO_write(ssn->into_ssl, ssn->dirty_in.data, ssn->dirty_in.used);
716 if (err != (int) ssn->dirty_in.used) {
717 REDEBUG("Failed writing %zd bytes to SSL BIO: %d", ssn->dirty_in.used, err);
718 record_init(&ssn->dirty_in);
721 record_init(&ssn->dirty_in);
723 err = SSL_read(ssn->ssl, ssn->clean_out.data + ssn->clean_out.used,
724 sizeof(ssn->clean_out.data) - ssn->clean_out.used);
726 ssn->clean_out.used += err;
730 if (!tls_error_io_log(request, ssn, err, "Failed in " STRINGIFY(__FUNCTION__) " (SSL_read)")) return 0;
732 /* Some Extra STATE information for easy debugging */
733 if (SSL_is_init_finished(ssn->ssl)) RDEBUG2("SSL Connection Established");
734 if (SSL_in_init(ssn->ssl)) RDEBUG2("In SSL Handshake Phase");
735 if (SSL_in_before(ssn->ssl)) RDEBUG2("Before SSL Handshake Phase");
736 if (SSL_in_accept_init(ssn->ssl)) RDEBUG2("In SSL Accept mode");
737 if (SSL_in_connect_init(ssn->ssl)) RDEBUG2("In SSL Connect mode");
739 #if OPENSSL_VERSION_NUMBER >= 0x10001000L
741 * Cache the SSL_SESSION pointer.
743 if (!ssn->ssl_session && SSL_is_init_finished(ssn->ssl)) {
744 ssn->ssl_session = SSL_get_session(ssn->ssl);
745 if (!ssn->ssl_session) {
746 RDEBUG("Failed getting SSL session");
752 err = BIO_ctrl_pending(ssn->from_ssl);
754 err = BIO_read(ssn->from_ssl, ssn->dirty_out.data,
755 sizeof(ssn->dirty_out.data));
757 ssn->dirty_out.used = err;
759 } else if (BIO_should_retry(ssn->from_ssl)) {
760 record_init(&ssn->dirty_in);
761 RDEBUG2("Asking for more data in tunnel");
765 tls_error_log(NULL, NULL);
766 record_init(&ssn->dirty_in);
770 RDEBUG2("SSL Application Data");
771 /* Its clean application data, do whatever we want */
772 record_init(&ssn->clean_out);
775 /* We are done with dirty_in, reinitialize it */
776 record_init(&ssn->dirty_in);
781 * Take cleartext user data, and encrypt it into the output buffer,
782 * to send to the client at the other end of the SSL connection.
784 int tls_handshake_send(REQUEST *request, tls_session_t *ssn)
789 * If there's un-encrypted data in 'clean_in', then write
790 * that data to the SSL session, and then call the BIO function
791 * to get that encrypted data from the SSL session, into
792 * a buffer which we can then package into an EAP packet.
794 * Based on Server's logic this clean_in is expected to
795 * contain the data to send to the client.
797 if (ssn->clean_in.used > 0) {
800 written = SSL_write(ssn->ssl, ssn->clean_in.data, ssn->clean_in.used);
801 record_minus(&ssn->clean_in, NULL, written);
803 /* Get the dirty data from Bio to send it */
804 err = BIO_read(ssn->from_ssl, ssn->dirty_out.data,
805 sizeof(ssn->dirty_out.data));
807 ssn->dirty_out.used = err;
809 if (!tls_error_io_log(request, ssn, err,
810 "Failed in " STRINGIFY(__FUNCTION__) " (SSL_write)")) {
819 static void session_init(tls_session_t *ssn)
822 ssn->into_ssl = ssn->from_ssl = NULL;
823 record_init(&ssn->clean_in);
824 record_init(&ssn->clean_out);
825 record_init(&ssn->dirty_in);
826 record_init(&ssn->dirty_out);
828 memset(&ssn->info, 0, sizeof(ssn->info));
831 ssn->fragment = false;
832 ssn->tls_msg_len = 0;
833 ssn->length_flag = false;
835 ssn->free_opaque = NULL;
838 static void session_close(tls_session_t *ssn)
841 SSL_set_quiet_shutdown(ssn->ssl, 1);
842 SSL_shutdown(ssn->ssl);
848 record_close(&ssn->clean_in);
849 record_close(&ssn->clean_out);
850 record_close(&ssn->dirty_in);
851 record_close(&ssn->dirty_out);
855 static void record_init(record_t *rec)
860 static void record_close(record_t *rec)
867 * Copy data to the intermediate buffer, before we send
870 static unsigned int record_plus(record_t *rec, void const *ptr,
873 unsigned int added = MAX_RECORD_SIZE - rec->used;
879 memcpy(rec->data + rec->used, ptr, added);
885 * Take data from the buffer, and give it to the caller.
887 static unsigned int record_minus(record_t *rec, void *ptr,
890 unsigned int taken = rec->used;
897 memcpy(ptr, rec->data, taken);
901 * This is pretty bad...
903 if (rec->used > 0) memmove(rec->data, rec->data + taken, rec->used);
908 void tls_session_information(tls_session_t *tls_session)
910 char const *str_write_p, *str_version, *str_content_type = "";
911 char const *str_details1 = "", *str_details2= "";
916 * Don't print this out in the normal course of
919 if (rad_debug_lvl == 0) return;
921 str_write_p = tls_session->info.origin ? ">>> send" : "<<< recv";
923 switch (tls_session->info.version) {
925 str_version = "SSL 2.0 ";
928 str_version = "SSL 3.0 ";
931 str_version = "TLS 1.0 ";
933 #ifdef TLS1_1_VERSION
935 str_version = "TLS 1.1 ";
938 #ifdef TLS1_2_VERSION
940 str_version = "TLS 1.2 ";
945 str_version = "TLS 1.3 ";
950 sprintf(buffer, "UNKNOWN TLS VERSION ?%04X?", tls_session->info.version);
951 str_version = buffer;
955 if (tls_session->info.version == SSL3_VERSION ||
956 tls_session->info.version == TLS1_VERSION) {
957 switch (tls_session->info.content_type) {
958 case SSL3_RT_CHANGE_CIPHER_SPEC:
959 str_content_type = "ChangeCipherSpec";
963 str_content_type = "Alert";
966 case SSL3_RT_HANDSHAKE:
967 str_content_type = "Handshake";
970 case SSL3_RT_APPLICATION_DATA:
971 str_content_type = "ApplicationData";
975 str_content_type = "UnknownContentType";
979 if (tls_session->info.content_type == SSL3_RT_ALERT) {
980 str_details1 = ", ???";
982 if (tls_session->info.record_len == 2) {
984 switch (tls_session->info.alert_level) {
985 case SSL3_AL_WARNING:
986 str_details1 = ", warning";
989 str_details1 = ", fatal";
993 str_details2 = " ???";
994 switch (tls_session->info.alert_description) {
995 case SSL3_AD_CLOSE_NOTIFY:
996 str_details2 = " close_notify";
999 case SSL3_AD_UNEXPECTED_MESSAGE:
1000 str_details2 = " unexpected_message";
1003 case SSL3_AD_BAD_RECORD_MAC:
1004 str_details2 = " bad_record_mac";
1007 case TLS1_AD_DECRYPTION_FAILED:
1008 str_details2 = " decryption_failed";
1011 case TLS1_AD_RECORD_OVERFLOW:
1012 str_details2 = " record_overflow";
1015 case SSL3_AD_DECOMPRESSION_FAILURE:
1016 str_details2 = " decompression_failure";
1019 case SSL3_AD_HANDSHAKE_FAILURE:
1020 str_details2 = " handshake_failure";
1023 case SSL3_AD_BAD_CERTIFICATE:
1024 str_details2 = " bad_certificate";
1027 case SSL3_AD_UNSUPPORTED_CERTIFICATE:
1028 str_details2 = " unsupported_certificate";
1031 case SSL3_AD_CERTIFICATE_REVOKED:
1032 str_details2 = " certificate_revoked";
1035 case SSL3_AD_CERTIFICATE_EXPIRED:
1036 str_details2 = " certificate_expired";
1039 case SSL3_AD_CERTIFICATE_UNKNOWN:
1040 str_details2 = " certificate_unknown";
1043 case SSL3_AD_ILLEGAL_PARAMETER:
1044 str_details2 = " illegal_parameter";
1047 case TLS1_AD_UNKNOWN_CA:
1048 str_details2 = " unknown_ca";
1051 case TLS1_AD_ACCESS_DENIED:
1052 str_details2 = " access_denied";
1055 case TLS1_AD_DECODE_ERROR:
1056 str_details2 = " decode_error";
1059 case TLS1_AD_DECRYPT_ERROR:
1060 str_details2 = " decrypt_error";
1063 case TLS1_AD_EXPORT_RESTRICTION:
1064 str_details2 = " export_restriction";
1067 case TLS1_AD_PROTOCOL_VERSION:
1068 str_details2 = " protocol_version";
1071 case TLS1_AD_INSUFFICIENT_SECURITY:
1072 str_details2 = " insufficient_security";
1075 case TLS1_AD_INTERNAL_ERROR:
1076 str_details2 = " internal_error";
1079 case TLS1_AD_USER_CANCELLED:
1080 str_details2 = " user_canceled";
1083 case TLS1_AD_NO_RENEGOTIATION:
1084 str_details2 = " no_renegotiation";
1090 if (tls_session->info.content_type == SSL3_RT_HANDSHAKE) {
1091 str_details1 = "???";
1093 if (tls_session->info.record_len > 0) switch (tls_session->info.handshake_type) {
1094 case SSL3_MT_HELLO_REQUEST:
1095 str_details1 = ", HelloRequest";
1098 case SSL3_MT_CLIENT_HELLO:
1099 str_details1 = ", ClientHello";
1102 case SSL3_MT_SERVER_HELLO:
1103 str_details1 = ", ServerHello";
1106 case SSL3_MT_CERTIFICATE:
1107 str_details1 = ", Certificate";
1110 case SSL3_MT_SERVER_KEY_EXCHANGE:
1111 str_details1 = ", ServerKeyExchange";
1114 case SSL3_MT_CERTIFICATE_REQUEST:
1115 str_details1 = ", CertificateRequest";
1118 case SSL3_MT_SERVER_DONE:
1119 str_details1 = ", ServerHelloDone";
1122 case SSL3_MT_CERTIFICATE_VERIFY:
1123 str_details1 = ", CertificateVerify";
1126 case SSL3_MT_CLIENT_KEY_EXCHANGE:
1127 str_details1 = ", ClientKeyExchange";
1130 case SSL3_MT_FINISHED:
1131 str_details1 = ", Finished";
1137 snprintf(tls_session->info.info_description,
1138 sizeof(tls_session->info.info_description),
1139 "%s %s%s [length %04lx]%s%s\n",
1140 str_write_p, str_version, str_content_type,
1141 (unsigned long)tls_session->info.record_len,
1142 str_details1, str_details2);
1144 request = SSL_get_ex_data(tls_session->ssl, FR_TLS_EX_INDEX_REQUEST);
1145 ROPTIONAL(RDEBUG2, DEBUG2, "%s", tls_session->info.info_description);
1148 static CONF_PARSER cache_config[] = {
1149 { "enable", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, session_cache_enable), "no" },
1151 { "lifetime", FR_CONF_OFFSET(PW_TYPE_INTEGER, fr_tls_server_conf_t, session_timeout), "24" },
1152 { "name", FR_CONF_OFFSET(PW_TYPE_STRING, fr_tls_server_conf_t, session_id_name), NULL },
1154 { "max_entries", FR_CONF_OFFSET(PW_TYPE_INTEGER, fr_tls_server_conf_t, session_cache_size), "255" },
1155 { "persist_dir", FR_CONF_OFFSET(PW_TYPE_STRING, fr_tls_server_conf_t, session_cache_path), NULL },
1156 CONF_PARSER_TERMINATOR
1159 static CONF_PARSER verify_config[] = {
1160 { "skip_if_ocsp_ok", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, verify_skip_if_ocsp_ok), "no" },
1161 { "tmpdir", FR_CONF_OFFSET(PW_TYPE_STRING, fr_tls_server_conf_t, verify_tmp_dir), NULL },
1162 { "client", FR_CONF_OFFSET(PW_TYPE_STRING, fr_tls_server_conf_t, verify_client_cert_cmd), NULL },
1163 CONF_PARSER_TERMINATOR
1166 #ifdef HAVE_OPENSSL_OCSP_H
1167 static CONF_PARSER ocsp_config[] = {
1168 { "enable", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, ocsp_enable), "no" },
1169 { "override_cert_url", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, ocsp_override_url), "no" },
1170 { "url", FR_CONF_OFFSET(PW_TYPE_STRING, fr_tls_server_conf_t, ocsp_url), NULL },
1171 { "use_nonce", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, ocsp_use_nonce), "yes" },
1172 { "timeout", FR_CONF_OFFSET(PW_TYPE_INTEGER, fr_tls_server_conf_t, ocsp_timeout), "yes" },
1173 { "softfail", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, ocsp_softfail), "no" },
1174 CONF_PARSER_TERMINATOR
1178 static CONF_PARSER tls_server_config[] = {
1179 { "verify_depth", FR_CONF_OFFSET(PW_TYPE_INTEGER, fr_tls_server_conf_t, verify_depth), "0" },
1180 { "CA_path", FR_CONF_OFFSET(PW_TYPE_FILE_INPUT | PW_TYPE_DEPRECATED, fr_tls_server_conf_t, ca_path), NULL },
1181 { "ca_path", FR_CONF_OFFSET(PW_TYPE_FILE_INPUT, fr_tls_server_conf_t, ca_path), NULL },
1182 { "pem_file_type", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, file_type), "yes" },
1183 { "private_key_file", FR_CONF_OFFSET(PW_TYPE_FILE_INPUT, fr_tls_server_conf_t, private_key_file), NULL },
1184 { "certificate_file", FR_CONF_OFFSET(PW_TYPE_FILE_INPUT, fr_tls_server_conf_t, certificate_file), NULL },
1185 { "CA_file", FR_CONF_OFFSET(PW_TYPE_FILE_INPUT | PW_TYPE_DEPRECATED, fr_tls_server_conf_t, ca_file), NULL },
1186 { "ca_file", FR_CONF_OFFSET(PW_TYPE_FILE_INPUT, fr_tls_server_conf_t, ca_file), NULL },
1187 { "private_key_password", FR_CONF_OFFSET(PW_TYPE_STRING | PW_TYPE_SECRET, fr_tls_server_conf_t, private_key_password), NULL },
1188 #ifdef PSK_MAX_IDENTITY_LEN
1189 { "psk_identity", FR_CONF_OFFSET(PW_TYPE_STRING, fr_tls_server_conf_t, psk_identity), NULL },
1190 { "psk_hexphrase", FR_CONF_OFFSET(PW_TYPE_STRING | PW_TYPE_SECRET, fr_tls_server_conf_t, psk_password), NULL },
1191 { "psk_query", FR_CONF_OFFSET(PW_TYPE_STRING, fr_tls_server_conf_t, psk_query), NULL },
1193 { "dh_file", FR_CONF_OFFSET(PW_TYPE_FILE_INPUT, fr_tls_server_conf_t, dh_file), NULL },
1194 { "random_file", FR_CONF_OFFSET(PW_TYPE_FILE_EXISTS, fr_tls_server_conf_t, random_file), NULL },
1195 { "fragment_size", FR_CONF_OFFSET(PW_TYPE_INTEGER, fr_tls_server_conf_t, fragment_size), "1024" },
1196 { "include_length", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, include_length), "yes" },
1197 { "auto_chain", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, auto_chain), "yes" },
1198 { "disable_single_dh_use", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, disable_single_dh_use), NULL },
1199 { "check_crl", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, check_crl), "no" },
1200 #ifdef X509_V_FLAG_CRL_CHECK_ALL
1201 { "check_all_crl", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, check_all_crl), "no" },
1203 { "allow_expired_crl", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, allow_expired_crl), NULL },
1204 { "check_cert_cn", FR_CONF_OFFSET(PW_TYPE_STRING, fr_tls_server_conf_t, check_cert_cn), NULL },
1205 { "cipher_list", FR_CONF_OFFSET(PW_TYPE_STRING, fr_tls_server_conf_t, cipher_list), NULL },
1206 { "cipher_server_preference", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, cipher_server_preference), NULL },
1207 { "check_cert_issuer", FR_CONF_OFFSET(PW_TYPE_STRING, fr_tls_server_conf_t, check_cert_issuer), NULL },
1208 { "require_client_cert", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, require_client_cert), NULL },
1210 #if OPENSSL_VERSION_NUMBER >= 0x0090800fL
1211 #ifndef OPENSSL_NO_ECDH
1212 { "ecdh_curve", FR_CONF_OFFSET(PW_TYPE_STRING, fr_tls_server_conf_t, ecdh_curve), "prime256v1" },
1216 #ifdef SSL_OP_NO_TLSv1
1217 { "disable_tlsv1", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, disable_tlsv1), NULL },
1220 #ifdef SSL_OP_NO_TLSv1_1
1221 { "disable_tlsv1_1", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, disable_tlsv1_1), NULL },
1224 #ifdef SSL_OP_NO_TLSv1_2
1225 { "disable_tlsv1_2", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, disable_tlsv1_2), NULL },
1228 { "cache", FR_CONF_POINTER(PW_TYPE_SUBSECTION, NULL), (void const *) cache_config },
1230 { "verify", FR_CONF_POINTER(PW_TYPE_SUBSECTION, NULL), (void const *) verify_config },
1232 #ifdef HAVE_OPENSSL_OCSP_H
1233 { "ocsp", FR_CONF_POINTER(PW_TYPE_SUBSECTION, NULL), (void const *) ocsp_config },
1235 CONF_PARSER_TERMINATOR
1239 static CONF_PARSER tls_client_config[] = {
1240 { "verify_depth", FR_CONF_OFFSET(PW_TYPE_INTEGER, fr_tls_server_conf_t, verify_depth), "0" },
1241 { "ca_path", FR_CONF_OFFSET(PW_TYPE_FILE_INPUT, fr_tls_server_conf_t, ca_path), NULL },
1242 { "pem_file_type", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, file_type), "yes" },
1243 { "private_key_file", FR_CONF_OFFSET(PW_TYPE_FILE_INPUT, fr_tls_server_conf_t, private_key_file), NULL },
1244 { "certificate_file", FR_CONF_OFFSET(PW_TYPE_FILE_INPUT, fr_tls_server_conf_t, certificate_file), NULL },
1245 { "ca_file", FR_CONF_OFFSET(PW_TYPE_FILE_INPUT, fr_tls_server_conf_t, ca_file), NULL },
1246 { "private_key_password", FR_CONF_OFFSET(PW_TYPE_STRING | PW_TYPE_SECRET, fr_tls_server_conf_t, private_key_password), NULL },
1247 { "dh_file", FR_CONF_OFFSET(PW_TYPE_STRING, fr_tls_server_conf_t, dh_file), NULL },
1248 { "random_file", FR_CONF_OFFSET(PW_TYPE_STRING, fr_tls_server_conf_t, random_file), NULL },
1249 { "fragment_size", FR_CONF_OFFSET(PW_TYPE_INTEGER, fr_tls_server_conf_t, fragment_size), "1024" },
1250 { "include_length", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, include_length), "yes" },
1251 { "check_crl", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, check_crl), "no" },
1252 { "check_cert_cn", FR_CONF_OFFSET(PW_TYPE_STRING, fr_tls_server_conf_t, check_cert_cn), NULL },
1253 { "cipher_list", FR_CONF_OFFSET(PW_TYPE_STRING, fr_tls_server_conf_t, cipher_list), NULL },
1254 { "check_cert_issuer", FR_CONF_OFFSET(PW_TYPE_STRING, fr_tls_server_conf_t, check_cert_issuer), NULL },
1256 #if OPENSSL_VERSION_NUMBER >= 0x0090800fL
1257 #ifndef OPENSSL_NO_ECDH
1258 { "ecdh_curve", FR_CONF_OFFSET(PW_TYPE_STRING, fr_tls_server_conf_t, ecdh_curve), "prime256v1" },
1262 #ifdef SSL_OP_NO_TLSv1
1263 { "disable_tlsv1", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, disable_tlsv1), NULL },
1266 #ifdef SSL_OP_NO_TLSv1_1
1267 { "disable_tlsv1_1", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, disable_tlsv1_1), NULL },
1270 #ifdef SSL_OP_NO_TLSv1_2
1271 { "disable_tlsv1_2", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, disable_tlsv1_2), NULL },
1273 CONF_PARSER_TERMINATOR
1278 * TODO: Check for the type of key exchange * like conf->dh_key
1280 static int load_dh_params(SSL_CTX *ctx, char *file)
1285 if (!file) return 0;
1287 if ((bio = BIO_new_file(file, "r")) == NULL) {
1288 ERROR(LOG_PREFIX ": Unable to open DH file - %s", file);
1292 dh = PEM_read_bio_DHparams(bio, NULL, NULL, NULL);
1295 WARN(LOG_PREFIX ": Unable to set DH parameters. DH cipher suites may not work!");
1296 WARN(LOG_PREFIX ": Fix this by running the OpenSSL command listed in eap.conf");
1300 if (SSL_CTX_set_tmp_dh(ctx, dh) < 0) {
1301 ERROR(LOG_PREFIX ": Unable to set DH parameters");
1312 * Print debugging messages, and free data.
1314 static void cbtls_remove_session(SSL_CTX *ctx, SSL_SESSION *sess)
1316 char buffer[2 * MAX_SESSION_SIZE + 1];
1317 fr_tls_server_conf_t *conf;
1319 tls_session_id(sess, buffer, MAX_SESSION_SIZE);
1321 conf = (fr_tls_server_conf_t *)SSL_CTX_get_app_data(ctx);
1323 DEBUG(LOG_PREFIX ": Failed to find TLS configuration in session");
1331 DEBUG2(LOG_PREFIX ": Removing session %s from the cache", buffer);
1333 /* remove session and any cached VPs */
1334 snprintf(filename, sizeof(filename), "%s%c%s.asn1",
1335 conf->session_cache_path, FR_DIR_SEP, buffer);
1336 rv = unlink(filename);
1338 DEBUG2(LOG_PREFIX ": Could not remove persisted session file %s: %s",
1339 filename, fr_syserror(errno));
1341 /* VPs might be absent; might not have been written to disk yet */
1342 snprintf(filename, sizeof(filename), "%s%c%s.vps",
1343 conf->session_cache_path, FR_DIR_SEP, buffer);
1350 static int cbtls_new_session(SSL *ssl, SSL_SESSION *sess)
1352 char buffer[2 * MAX_SESSION_SIZE + 1];
1353 fr_tls_server_conf_t *conf;
1354 unsigned char *sess_blob = NULL;
1356 REQUEST *request = SSL_get_ex_data(ssl, FR_TLS_EX_INDEX_REQUEST);
1358 conf = (fr_tls_server_conf_t *)SSL_get_ex_data(ssl, FR_TLS_EX_INDEX_CONF);
1360 RWDEBUG("Failed to find TLS configuration in session");
1364 tls_session_id(sess, buffer, MAX_SESSION_SIZE);
1367 int fd, rv, todo, blob_len;
1371 RDEBUG2("Serialising session %s, and storing in cache", buffer);
1373 /* find out what length data we need */
1374 blob_len = i2d_SSL_SESSION(sess, NULL);
1376 /* something went wrong */
1377 if (request) RWDEBUG("Session serialisation failed, couldn't determine required buffer length");
1381 /* Do not convert to TALLOC - Thread safety */
1382 /* alloc and convert to ASN.1 */
1383 sess_blob = malloc(blob_len);
1385 RWDEBUG("Session serialisation failed, couldn't allocate buffer (%d bytes)", blob_len);
1388 /* openssl mutates &p */
1390 rv = i2d_SSL_SESSION(sess, &p);
1391 if (rv != blob_len) {
1392 if (request) RWDEBUG("Session serialisation failed");
1396 /* open output file */
1397 snprintf(filename, sizeof(filename), "%s%c%s.asn1",
1398 conf->session_cache_path, FR_DIR_SEP, buffer);
1399 fd = open(filename, O_RDWR|O_CREAT|O_EXCL, S_IWUSR);
1401 if (request) RERROR("Session serialisation failed, failed opening session file %s: %s",
1402 filename, fr_syserror(errno));
1407 * Set the filename to be temporarily write-only.
1412 vp = fr_pair_afrom_num(request->state_ctx, PW_TLS_CACHE_FILENAME, 0);
1414 fr_pair_value_strcpy(vp, filename);
1415 fr_pair_add(&request->state, vp);
1422 rv = write(fd, p, todo);
1424 if (request) RWDEBUG("Failed writing session: %s", fr_syserror(errno));
1432 if (request) RWDEBUG("Wrote session %s to %s (%d bytes)", buffer, filename, blob_len);
1441 /** Convert OpenSSL's ASN1_TIME to an epoch time
1443 * @param[out] out Where to write the time_t.
1444 * @param[in] asn1 The ASN1_TIME to convert.
1449 static int ocsp_asn1time_to_epoch(time_t *out, char const *asn1)
1452 char const *p = asn1, *end = p + strlen(p);
1454 memset(&t, 0, sizeof(t));
1456 if ((end - p) <= 12) {
1457 if ((end - p) < 2) {
1458 fr_strerror_printf("ASN1 date string too short, expected 2 additional bytes, got %zu bytes",
1463 t.tm_year = (*(p++) - '0') * 10;
1464 t.tm_year += (*(p++) - '0');
1465 if (t.tm_year < 70) t.tm_year += 100;
1467 t.tm_year = (*(p++) - '0') * 1000;
1468 t.tm_year += (*(p++) - '0') * 100;
1469 t.tm_year += (*(p++) - '0') * 10;
1470 t.tm_year += (*(p++) - '0');
1474 if ((end - p) < 10) {
1475 fr_strerror_printf("ASN1 string too short, expected 10 additional bytes, got %zu bytes",
1480 t.tm_mon = (*(p++) - '0') * 10;
1481 t.tm_mon += (*(p++) - '0') - 1; // -1 since January is 0 not 1.
1482 t.tm_mday = (*(p++) - '0') * 10;
1483 t.tm_mday += (*(p++) - '0');
1484 t.tm_hour = (*(p++) - '0') * 10;
1485 t.tm_hour += (*(p++) - '0');
1486 t.tm_min = (*(p++) - '0') * 10;
1487 t.tm_min += (*(p++) - '0');
1488 t.tm_sec = (*(p++) - '0') * 10;
1489 t.tm_sec += (*(p++) - '0');
1491 /* Apparently OpenSSL converts all timestamps to UTC? Maybe? */
1496 #if OPENSSL_VERSION_NUMBER < 0x10100000L || defined(LIBRESSL_VERSION_NUMBER)
1497 static SSL_SESSION *cbtls_get_session(SSL *ssl, unsigned char *data, int len, int *copy)
1499 static SSL_SESSION *cbtls_get_session(SSL *ssl, const unsigned char *data, int len, int *copy)
1503 char buffer[2 * MAX_SESSION_SIZE + 1];
1504 fr_tls_server_conf_t *conf;
1505 TALLOC_CTX *talloc_ctx;
1507 SSL_SESSION *sess = NULL;
1508 unsigned char *sess_data = NULL;
1509 PAIR_LIST *pairlist = NULL;
1511 REQUEST *request = SSL_get_ex_data(ssl, FR_TLS_EX_INDEX_REQUEST);
1513 rad_assert(request != NULL);
1516 if (size > MAX_SESSION_SIZE) size = MAX_SESSION_SIZE;
1518 fr_bin2hex(buffer, data, size);
1520 RDEBUG2("Peer requested cached session: %s", buffer);
1524 conf = (fr_tls_server_conf_t *)SSL_get_ex_data(ssl, FR_TLS_EX_INDEX_CONF);
1526 RWDEBUG("Failed to find TLS configuration in session");
1530 talloc_ctx = SSL_get_ex_data(ssl, FR_TLS_EX_INDEX_TALLOC);
1536 unsigned char const **o;
1541 VALUE_PAIR *vps = NULL;
1544 /* load the actual SSL session */
1545 snprintf(filename, sizeof(filename), "%s%c%s.asn1", conf->session_cache_path, FR_DIR_SEP, buffer);
1546 fd = open(filename, O_RDONLY);
1548 RWDEBUG("No persisted session file %s: %s", filename, fr_syserror(errno));
1552 rv = fstat(fd, &st);
1554 RWDEBUG("Failed stating persisted session file %s: %s", filename, fr_syserror(errno));
1559 sess_data = talloc_array(NULL, unsigned char, st.st_size);
1561 RWDEBUG("Failed allocating buffer for persisted session (%d bytes)", (int) st.st_size);
1569 rv = read(fd, q, todo);
1571 RWDEBUG("Failed reading persisted session: %s", fr_syserror(errno));
1581 * OpenSSL mutates what's passed in, so we assign sess_data to q,
1582 * so the value of q gets mutated, and not the value of sess_data.
1584 * We then need a pointer to hold &q, but it can't be const, because
1585 * clang complains about lack of consting in nested pointer types.
1587 * So we memcpy the value of that pointer, to one that
1588 * does have a const, which we then pass into d2i_SSL_SESSION *sigh*.
1592 memcpy(&o, &p, sizeof(o));
1593 sess = d2i_SSL_SESSION(NULL, o, st.st_size);
1595 RWDEBUG("Failed loading persisted session: %s", ERR_error_string(ERR_get_error(), NULL));
1599 /* read in the cached VPs from the .vps file */
1600 snprintf(filename, sizeof(filename), "%s%c%s.vps",
1601 conf->session_cache_path, FR_DIR_SEP, buffer);
1602 rv = pairlist_read(talloc_ctx, filename, &pairlist, 1);
1604 /* not safe to un-persist a session w/o VPs */
1605 RWDEBUG("Failed loading persisted VPs for session %s", buffer);
1606 SSL_SESSION_free(sess);
1611 * Enforce client certificate expiration.
1613 vp = fr_pair_find_by_num(pairlist->reply, PW_TLS_CLIENT_CERT_EXPIRATION, 0, TAG_ANY);
1617 if (ocsp_asn1time_to_epoch(&expires, vp->vp_strvalue) < 0) {
1618 RDEBUG2("Failed getting certificate expiration, removing cache entry for session %s", buffer);
1619 SSL_SESSION_free(sess);
1623 if (expires <= request->timestamp) {
1624 RDEBUG2("Certificate has expired, removing cache entry for session %s", buffer);
1625 SSL_SESSION_free(sess);
1630 * Account for Session-Timeout, if it's available.
1632 vp = fr_pair_find_by_num(request->reply->vps, PW_SESSION_TIMEOUT, 0, TAG_ANY);
1634 if ((request->timestamp + vp->vp_integer) > expires) {
1635 vp->vp_integer = expires - request->timestamp;
1636 RWDEBUG2("Updating Session-Timeout to %u, due to impending certificate expiration",
1642 /* move the cached VPs into the session */
1643 fr_pair_list_mcopy_by_num(talloc_ctx, &vps, &pairlist->reply, 0, 0, TAG_ANY);
1645 SSL_SESSION_set_ex_data(sess, fr_tls_ex_index_vps, vps);
1646 RWDEBUG("Successfully restored session %s", buffer);
1647 rdebug_pair_list(L_DBG_LVL_2, request, vps, "reply:");
1650 if (sess_data) talloc_free(sess_data);
1651 if (pairlist) pairlist_free(&pairlist);
1656 #ifdef HAVE_OPENSSL_OCSP_H
1658 /** Extract components of OCSP responser URL from a certificate
1660 * @param[in] cert to extract URL from.
1661 * @param[out] host_out Portion of the URL (must be freed with free()).
1662 * @param[out] port_out Port portion of the URL (must be freed with free()).
1663 * @param[out] path_out Path portion of the URL (must be freed with free()).
1664 * @param[out] is_https Whether the responder should be contacted using https.
1666 * - 0 if no valid URL is contained in the certificate.
1667 * - 1 if a URL was found and parsed.
1668 * - -1 if at least one URL was found, but none could be parsed.
1670 static int ocsp_parse_cert_url(X509 *cert, char **host_out, char **port_out,
1671 char **path_out, int *is_https)
1674 bool found_uri = false;
1676 AUTHORITY_INFO_ACCESS *aia;
1677 ACCESS_DESCRIPTION *ad;
1679 aia = X509_get_ext_d2i(cert, NID_info_access, NULL, NULL);
1681 for (i = 0; i < sk_ACCESS_DESCRIPTION_num(aia); i++) {
1682 ad = sk_ACCESS_DESCRIPTION_value(aia, i);
1683 if (OBJ_obj2nid(ad->method) != NID_ad_OCSP) continue;
1684 if (ad->location->type != GEN_URI) continue;
1687 if (OCSP_parse_url((char *) ad->location->d.ia5->data, host_out,
1688 port_out, path_out, is_https)) return 1;
1690 return found_uri ? -1 : 0;
1694 * This function sends a OCSP request to a defined OCSP responder
1695 * and checks the OCSP response for correctness.
1698 /* Maximum leeway in validity period: default 5 minutes */
1699 #define MAX_VALIDITY_PERIOD (5 * 60)
1702 OCSP_STATUS_FAILED = 0,
1704 OCSP_STATUS_SKIPPED = 2,
1707 static ocsp_status_t ocsp_check(REQUEST *request, X509_STORE *store, X509 *issuer_cert, X509 *client_cert,
1708 fr_tls_server_conf_t *conf)
1710 OCSP_CERTID *certid;
1712 OCSP_RESPONSE *resp = NULL;
1713 OCSP_BASICRESP *bresp = NULL;
1717 char hostheader[1024];
1719 long nsec = MAX_VALIDITY_PERIOD, maxage = -1;
1720 BIO *cbio, *bio_out;
1721 ocsp_status_t ocsp_status = OCSP_STATUS_FAILED;
1723 ASN1_GENERALIZEDTIME *rev, *thisupd, *nextupd;
1725 #if OPENSSL_VERSION_NUMBER >= 0x1000003f
1729 struct timeval when;
1734 * Create OCSP Request
1736 certid = OCSP_cert_to_id(NULL, client_cert, issuer_cert);
1737 req = OCSP_REQUEST_new();
1738 OCSP_request_add0_id(req, certid);
1739 if (conf->ocsp_use_nonce) OCSP_request_add1_nonce(req, NULL, 8);
1742 * Send OCSP Request and get OCSP Response
1745 /* Get OCSP responder URL */
1746 if (conf->ocsp_override_url) {
1750 memcpy(&url, &conf->ocsp_url, sizeof(url));
1751 /* Reading the libssl src, they do a strdup on the URL, so it could of been const *sigh* */
1752 OCSP_parse_url(url, &host, &port, &path, &use_ssl);
1753 if (!host || !port || !path) {
1754 RWDEBUG("ocsp: Host or port or path missing from configured URL \"%s\". Not doing OCSP", url);
1760 ret = ocsp_parse_cert_url(client_cert, &host, &port, &path, &use_ssl);
1763 RWDEBUG("ocsp: Invalid URL in certificate. Not doing OCSP");
1767 if (conf->ocsp_url) {
1768 RWDEBUG("ocsp: No OCSP URL in certificate, falling back to configured URL");
1771 RWDEBUG("ocsp: No OCSP URL in certificate. Not doing OCSP");
1779 RDEBUG2("ocsp: Using responder URL \"http://%s:%s%s\"", host, port, path);
1781 /* Check host and port length are sane, then create Host: HTTP header */
1782 if ((strlen(host) + strlen(port) + 2) > sizeof(hostheader)) {
1783 RWDEBUG("ocsp: Host and port too long");
1786 snprintf(hostheader, sizeof(hostheader), "%s:%s", host, port);
1788 /* Setup BIO socket to OCSP responder */
1789 cbio = BIO_new_connect(host);
1792 if (rad_debug_lvl) {
1793 if (default_log.dst == L_DST_STDOUT) {
1794 bio_out = BIO_new_fp(stdout, BIO_NOCLOSE);
1795 } else if (default_log.dst == L_DST_STDERR) {
1796 bio_out = BIO_new_fp(stderr, BIO_NOCLOSE);
1800 BIO_set_conn_port(cbio, port);
1801 #if OPENSSL_VERSION_NUMBER < 0x1000003f
1802 BIO_do_connect(cbio);
1804 /* Send OCSP request and wait for response */
1805 resp = OCSP_sendreq_bio(cbio, path, req);
1807 REDEBUG("ocsp: Couldn't get OCSP response");
1808 ocsp_status = OCSP_STATUS_SKIPPED;
1812 if (conf->ocsp_timeout)
1813 BIO_set_nbio(cbio, 1);
1815 rc = BIO_do_connect(cbio);
1816 if ((rc <= 0) && ((!conf->ocsp_timeout) || !BIO_should_retry(cbio))) {
1817 REDEBUG("ocsp: Couldn't connect to OCSP responder");
1818 ocsp_status = OCSP_STATUS_SKIPPED;
1822 ctx = OCSP_sendreq_new(cbio, path, NULL, -1);
1824 REDEBUG("ocsp: Couldn't create OCSP request");
1825 ocsp_status = OCSP_STATUS_SKIPPED;
1829 if (!OCSP_REQ_CTX_add1_header(ctx, "Host", hostheader)) {
1830 REDEBUG("ocsp: Couldn't set Host header");
1831 ocsp_status = OCSP_STATUS_SKIPPED;
1835 if (!OCSP_REQ_CTX_set1_req(ctx, req)) {
1836 REDEBUG("ocsp: Couldn't add data to OCSP request");
1837 ocsp_status = OCSP_STATUS_SKIPPED;
1841 gettimeofday(&when, NULL);
1842 when.tv_sec += conf->ocsp_timeout;
1845 rc = OCSP_sendreq_nbio(&resp, ctx);
1846 if (conf->ocsp_timeout) {
1847 gettimeofday(&now, NULL);
1848 if (!timercmp(&now, &when, <))
1851 } while ((rc == -1) && BIO_should_retry(cbio));
1853 if (conf->ocsp_timeout && (rc == -1) && BIO_should_retry(cbio)) {
1854 REDEBUG("ocsp: Response timed out");
1855 ocsp_status = OCSP_STATUS_SKIPPED;
1859 OCSP_REQ_CTX_free(ctx);
1862 REDEBUG("ocsp: Couldn't get OCSP response");
1863 ocsp_status = OCSP_STATUS_SKIPPED;
1868 /* Verify OCSP response status */
1869 status = OCSP_response_status(resp);
1870 if (status != OCSP_RESPONSE_STATUS_SUCCESSFUL) {
1871 REDEBUG("ocsp: Response status: %s", OCSP_response_status_str(status));
1874 bresp = OCSP_response_get1_basic(resp);
1875 if (conf->ocsp_use_nonce && OCSP_check_nonce(req, bresp)!=1) {
1876 REDEBUG("ocsp: Response has wrong nonce value");
1879 if (OCSP_basic_verify(bresp, NULL, store, 0)!=1){
1880 REDEBUG("ocsp: Couldn't verify OCSP basic response");
1884 /* Verify OCSP cert status */
1885 if (!OCSP_resp_find_status(bresp, certid, &status, &reason, &rev, &thisupd, &nextupd)) {
1886 REDEBUG("ocsp: No Status found");
1890 if (!OCSP_check_validity(thisupd, nextupd, nsec, maxage)) {
1892 BIO_puts(bio_out, "WARNING: Status times invalid.\n");
1893 ERR_print_errors(bio_out);
1899 BIO_puts(bio_out, "\tThis Update: ");
1900 ASN1_GENERALIZEDTIME_print(bio_out, thisupd);
1901 BIO_puts(bio_out, "\n");
1903 BIO_puts(bio_out, "\tNext Update: ");
1904 ASN1_GENERALIZEDTIME_print(bio_out, nextupd);
1905 BIO_puts(bio_out, "\n");
1910 case V_OCSP_CERTSTATUS_GOOD:
1911 RDEBUG2("ocsp: Cert status: good");
1912 vp = pair_make_request("TLS-OCSP-Cert-Valid", NULL, T_OP_SET);
1913 vp->vp_integer = 1; /* yes */
1914 ocsp_status = OCSP_STATUS_OK;
1918 /* REVOKED / UNKNOWN */
1919 REDEBUG("ocsp: Cert status: %s", OCSP_cert_status_str(status));
1920 if (reason != -1) REDEBUG("ocsp: Reason: %s", OCSP_crl_reason_str(reason));
1923 BIO_puts(bio_out, "\tRevocation Time: ");
1924 ASN1_GENERALIZEDTIME_print(bio_out, rev);
1925 BIO_puts(bio_out, "\n");
1931 /* Free OCSP Stuff */
1932 OCSP_REQUEST_free(req);
1933 OCSP_RESPONSE_free(resp);
1938 if (bio_out) BIO_free(bio_out);
1939 OCSP_BASICRESP_free(bresp);
1941 switch (ocsp_status) {
1942 case OCSP_STATUS_OK:
1943 RDEBUG2("ocsp: Certificate is valid");
1946 case OCSP_STATUS_SKIPPED:
1948 vp = pair_make_request("TLS-OCSP-Cert-Valid", NULL, T_OP_SET);
1949 vp->vp_integer = 2; /* skipped */
1950 if (conf->ocsp_softfail) {
1951 RWDEBUG("ocsp: Unable to check certificate, assuming it's valid");
1952 RWDEBUG("ocsp: This may be insecure");
1954 /* Remove OpenSSL errors from queue or handshake will fail */
1955 while (ERR_get_error());
1957 ocsp_status = OCSP_STATUS_SKIPPED;
1959 REDEBUG("ocsp: Unable to check certificate, failing");
1960 ocsp_status = OCSP_STATUS_FAILED;
1965 vp = pair_make_request("TLS-OCSP-Cert-Valid", NULL, T_OP_SET);
1966 vp->vp_integer = 0; /* no */
1967 REDEBUG("ocsp: Certificate has been expired/revoked");
1973 #endif /* HAVE_OPENSSL_OCSP_H */
1976 * For creating certificate attributes.
1978 static char const *cert_attr_names[8][2] = {
1979 { "TLS-Client-Cert-Serial", "TLS-Cert-Serial" },
1980 { "TLS-Client-Cert-Expiration", "TLS-Cert-Expiration" },
1981 { "TLS-Client-Cert-Subject", "TLS-Cert-Subject" },
1982 { "TLS-Client-Cert-Issuer", "TLS-Cert-Issuer" },
1983 { "TLS-Client-Cert-Common-Name", "TLS-Cert-Common-Name" },
1984 { "TLS-Client-Cert-Subject-Alt-Name-Email", "TLS-Cert-Subject-Alt-Name-Email" },
1985 { "TLS-Client-Cert-Subject-Alt-Name-Dns", "TLS-Cert-Subject-Alt-Name-Dns" },
1986 { "TLS-Client-Cert-Subject-Alt-Name-Upn", "TLS-Cert-Subject-Alt-Name-Upn" }
1989 #define FR_TLS_SERIAL (0)
1990 #define FR_TLS_EXPIRATION (1)
1991 #define FR_TLS_SUBJECT (2)
1992 #define FR_TLS_ISSUER (3)
1993 #define FR_TLS_CN (4)
1994 #define FR_TLS_SAN_EMAIL (5)
1995 #define FR_TLS_SAN_DNS (6)
1996 #define FR_TLS_SAN_UPN (7)
1999 * Before trusting a certificate, you must make sure that the
2000 * certificate is 'valid'. There are several steps that your
2001 * application can take in determining if a certificate is
2002 * valid. Commonly used steps are:
2004 * 1.Verifying the certificate's signature, and verifying that
2005 * the certificate has been issued by a trusted Certificate
2008 * 2.Verifying that the certificate is valid for the present date
2009 * (i.e. it is being presented within its validity dates).
2011 * 3.Verifying that the certificate has not been revoked by its
2012 * issuing Certificate Authority, by checking with respect to a
2013 * Certificate Revocation List (CRL).
2015 * 4.Verifying that the credentials presented by the certificate
2016 * fulfill additional requirements specific to the application,
2017 * such as with respect to access control lists or with respect
2018 * to OCSP (Online Certificate Status Processing).
2020 * NOTE: This callback will be called multiple times based on the
2021 * depth of the root certificate chain
2023 int cbtls_verify(int ok, X509_STORE_CTX *ctx)
2025 char subject[1024]; /* Used for the subject name */
2026 char issuer[1024]; /* Used for the issuer name */
2027 char attribute[1024];
2029 char common_name[1024];
2033 #if OPENSSL_VERSION_NUMBER >= 0x10100000L
2034 const STACK_OF(X509_EXTENSION) *ext_list;
2036 STACK_OF(X509_EXTENSION) *ext_list;
2039 int err, depth, lookup, loc;
2040 fr_tls_server_conf_t *conf;
2043 ASN1_INTEGER *sn = NULL;
2044 ASN1_TIME *asn_time = NULL;
2047 #ifdef HAVE_OPENSSL_OCSP_H
2048 X509_STORE *ocsp_store = NULL;
2050 bool do_verify = false;
2053 TALLOC_CTX *talloc_ctx;
2057 client_cert = X509_STORE_CTX_get_current_cert(ctx);
2058 err = X509_STORE_CTX_get_error(ctx);
2059 depth = X509_STORE_CTX_get_error_depth(ctx);
2064 * Log client/issuing cert. If there's an error, log
2067 if ((lookup > 1) && !my_ok) lookup = 1;
2070 * Retrieve the pointer to the SSL of the connection currently treated
2071 * and the application specific data stored into the SSL object.
2073 ssl = X509_STORE_CTX_get_ex_data(ctx, SSL_get_ex_data_X509_STORE_CTX_idx());
2074 conf = (fr_tls_server_conf_t *)SSL_get_ex_data(ssl, FR_TLS_EX_INDEX_CONF);
2075 if (!conf) return 1;
2077 request = (REQUEST *)SSL_get_ex_data(ssl, FR_TLS_EX_INDEX_REQUEST);
2078 rad_assert(request != NULL);
2079 certs = (VALUE_PAIR **)SSL_get_ex_data(ssl, fr_tls_ex_index_certs);
2081 identity = (char **)SSL_get_ex_data(ssl, FR_TLS_EX_INDEX_IDENTITY);
2082 #ifdef HAVE_OPENSSL_OCSP_H
2083 ocsp_store = conf->ocsp_store;
2086 talloc_ctx = SSL_get_ex_data(ssl, FR_TLS_EX_INDEX_TALLOC);
2089 * Get the Serial Number
2092 sn = X509_get_serialNumber(client_cert);
2094 RDEBUG2("Creating attributes from certificate OIDs");
2098 * For this next bit, we create the attributes *only* if
2099 * we're at the client or issuing certificate, AND we
2100 * have a user identity. i.e. we don't create the
2101 * attributes for RadSec connections.
2103 if (certs && identity &&
2104 (lookup <= 1) && sn && ((size_t) sn->length < (sizeof(buf) / 2))) {
2108 for (i = 0; i < sn->length; i++) {
2109 sprintf(p, "%02x", (unsigned int)sn->data[i]);
2112 vp = fr_pair_make(talloc_ctx, certs, cert_attr_names[FR_TLS_SERIAL][lookup], buf, T_OP_SET);
2113 rdebug_pair(L_DBG_LVL_2, request, vp, NULL);
2118 * Get the Expiration Date
2121 asn_time = X509_get_notAfter(client_cert);
2122 if (certs && identity && (lookup <= 1) && asn_time &&
2123 (asn_time->length < (int) sizeof(buf))) {
2124 memcpy(buf, (char*) asn_time->data, asn_time->length);
2125 buf[asn_time->length] = '\0';
2126 vp = fr_pair_make(talloc_ctx, certs, cert_attr_names[FR_TLS_EXPIRATION][lookup], buf, T_OP_SET);
2127 rdebug_pair(L_DBG_LVL_2, request, vp, NULL);
2131 * Get the Subject & Issuer
2133 subject[0] = issuer[0] = '\0';
2134 X509_NAME_oneline(X509_get_subject_name(client_cert), subject,
2136 subject[sizeof(subject) - 1] = '\0';
2137 if (certs && identity && (lookup <= 1) && subject[0]) {
2138 vp = fr_pair_make(talloc_ctx, certs, cert_attr_names[FR_TLS_SUBJECT][lookup], subject, T_OP_SET);
2139 rdebug_pair(L_DBG_LVL_2, request, vp, NULL);
2142 X509_NAME_oneline(X509_get_issuer_name(client_cert), issuer,
2144 issuer[sizeof(issuer) - 1] = '\0';
2145 if (certs && identity && (lookup <= 1) && issuer[0]) {
2146 vp = fr_pair_make(talloc_ctx, certs, cert_attr_names[FR_TLS_ISSUER][lookup], issuer, T_OP_SET);
2147 rdebug_pair(L_DBG_LVL_2, request, vp, NULL);
2151 * Get the Common Name, if there is a subject.
2153 X509_NAME_get_text_by_NID(X509_get_subject_name(client_cert),
2154 NID_commonName, common_name, sizeof(common_name));
2155 common_name[sizeof(common_name) - 1] = '\0';
2156 if (certs && identity && (lookup <= 1) && common_name[0] && subject[0]) {
2157 vp = fr_pair_make(talloc_ctx, certs, cert_attr_names[FR_TLS_CN][lookup], common_name, T_OP_SET);
2158 rdebug_pair(L_DBG_LVL_2, request, vp, NULL);
2162 * Get the RFC822 Subject Alternative Name
2164 loc = X509_get_ext_by_NID(client_cert, NID_subject_alt_name, -1);
2165 if (certs && (lookup <= 1) && (loc >= 0)) {
2166 X509_EXTENSION *ext = NULL;
2167 GENERAL_NAMES *names = NULL;
2170 if ((ext = X509_get_ext(client_cert, loc)) &&
2171 (names = X509V3_EXT_d2i(ext))) {
2172 for (i = 0; i < sk_GENERAL_NAME_num(names); i++) {
2173 GENERAL_NAME *name = sk_GENERAL_NAME_value(names, i);
2175 switch (name->type) {
2178 vp = fr_pair_make(talloc_ctx, certs, cert_attr_names[FR_TLS_SAN_EMAIL][lookup],
2179 (char const *) ASN1_STRING_get0_data(name->d.rfc822Name), T_OP_SET);
2180 rdebug_pair(L_DBG_LVL_2, request, vp, NULL);
2182 #endif /* GEN_EMAIL */
2185 vp = fr_pair_make(talloc_ctx, certs, cert_attr_names[FR_TLS_SAN_DNS][lookup],
2186 (char const *) ASN1_STRING_get0_data(name->d.dNSName), T_OP_SET);
2187 rdebug_pair(L_DBG_LVL_2, request, vp, NULL);
2189 #endif /* GEN_DNS */
2190 #ifdef GEN_OTHERNAME
2192 /* look for a MS UPN */
2193 if (NID_ms_upn == OBJ_obj2nid(name->d.otherName->type_id)) {
2194 /* we've got a UPN - Must be ASN1-encoded UTF8 string */
2195 if (name->d.otherName->value->type == V_ASN1_UTF8STRING) {
2196 vp = fr_pair_make(talloc_ctx, certs, cert_attr_names[FR_TLS_SAN_UPN][lookup],
2197 (char const *) ASN1_STRING_get0_data(name->d.otherName->value->value.utf8string), T_OP_SET);
2198 rdebug_pair(L_DBG_LVL_2, request, vp, NULL);
2201 RWARN("Invalid UPN in Subject Alt Name (should be UTF-8)");
2206 #endif /* GEN_OTHERNAME */
2208 /* XXX TODO handle other SAN types */
2214 sk_GENERAL_NAME_free(names);
2218 * If the CRL has expired, that might still be OK.
2221 (conf->allow_expired_crl) &&
2222 (err == X509_V_ERR_CRL_HAS_EXPIRED)) {
2224 X509_STORE_CTX_set_error( ctx, 0 );
2228 char const *p = X509_verify_cert_error_string(err);
2229 RERROR("SSL says error %d : %s", err, p);
2235 #if OPENSSL_VERSION_NUMBER >= 0x10100000L && !defined(LIBRESSL_VERSION_NUMBER)
2236 ext_list = X509_get0_extensions(client_cert);
2238 X509_CINF *client_inf;
2239 client_inf = client_cert->cert_info;
2240 ext_list = client_inf->extensions;
2247 * Grab the X509 extensions, and create attributes out of them.
2248 * For laziness, we re-use the OpenSSL names
2250 if (certs && (sk_X509_EXTENSION_num(ext_list) > 0)) {
2255 out = BIO_new(BIO_s_mem());
2256 strlcpy(attribute, "TLS-Client-Cert-", sizeof(attribute));
2258 for (i = 0; i < sk_X509_EXTENSION_num(ext_list); i++) {
2260 X509_EXTENSION *ext;
2262 ext = sk_X509_EXTENSION_value(ext_list, i);
2264 obj = X509_EXTENSION_get_object(ext);
2265 i2a_ASN1_OBJECT(out, obj);
2266 len = BIO_read(out, attribute + 16 , sizeof(attribute) - 16 - 1);
2267 if (len <= 0) continue;
2269 attribute[16 + len] = '\0';
2271 for (p = attribute + 16; *p != '\0'; p++) {
2272 if (*p == ' ') *p = '-';
2275 X509V3_EXT_print(out, ext, 0, 0);
2276 len = BIO_read(out, value , sizeof(value) - 1);
2277 if (len <= 0) continue;
2281 vp = fr_pair_make(talloc_ctx, certs, attribute, value, T_OP_ADD);
2283 RDEBUG3("Skipping %s += '%s'. Please check that both the "
2284 "attribute and value are defined in the dictionaries",
2288 * rdebug_pair_list indents (so pre REXDENT())
2291 rdebug_pair_list(L_DBG_LVL_2, request, vp, NULL);
2301 switch (X509_STORE_CTX_get_error(ctx)) {
2302 case X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT:
2303 RERROR("issuer=%s", issuer);
2306 case X509_V_ERR_CERT_NOT_YET_VALID:
2307 case X509_V_ERR_ERROR_IN_CERT_NOT_BEFORE_FIELD:
2308 RERROR("notBefore=");
2310 ASN1_TIME_print(bio_err, X509_get_notBefore(ctx->current_cert));
2314 case X509_V_ERR_CERT_HAS_EXPIRED:
2315 case X509_V_ERR_ERROR_IN_CERT_NOT_AFTER_FIELD:
2316 RERROR("notAfter=");
2318 ASN1_TIME_print(bio_err, X509_get_notAfter(ctx->current_cert));
2324 * If we're at the actual client cert, apply additional
2329 * If the conf tells us to, check cert issuer
2330 * against the specified value and fail
2331 * verification if they don't match.
2333 if (conf->check_cert_issuer &&
2334 (strcmp(issuer, conf->check_cert_issuer) != 0)) {
2335 AUTH(LOG_PREFIX ": Certificate issuer (%s) does not match specified value (%s)!",
2336 issuer, conf->check_cert_issuer);
2341 * If the conf tells us to, check the CN in the
2342 * cert against xlat'ed value, but only if the
2343 * previous checks passed.
2345 if (my_ok && conf->check_cert_cn) {
2346 if (radius_xlat(cn_str, sizeof(cn_str), request, conf->check_cert_cn, NULL, NULL) < 0) {
2347 /* if this fails, fail the verification */
2350 RDEBUG2("checking certificate CN (%s) with xlat'ed value (%s)", common_name, cn_str);
2351 if (strcmp(cn_str, common_name) != 0) {
2352 AUTH(LOG_PREFIX ": Certificate CN (%s) does not match specified value (%s)!",
2353 common_name, cn_str);
2357 } /* check_cert_cn */
2359 #ifdef HAVE_OPENSSL_OCSP_H
2362 * No OCSP, allow external verification.
2364 if (!conf->ocsp_enable) {
2368 RDEBUG2("Starting OCSP Request");
2369 if ((X509_STORE_CTX_get1_issuer(&issuer_cert, ctx, client_cert) != 1) ||
2372 * Allow for external verify.
2374 RERROR("Couldn't get issuer_cert for %s", common_name);
2379 * Do the full OCSP checks.
2381 * If they fail, don't run the external verify. We don't want
2382 * to allow admins to force authentication success for bad
2385 * If the OCSP checks succeed, check whether we still want to
2386 * run the external verification routine. If it's marked as
2387 * "skip verify on OK", then we don't do verify.
2389 my_ok = ocsp_check(request, ocsp_store, issuer_cert, client_cert, conf);
2390 if (my_ok != OCSP_STATUS_FAILED) {
2391 do_verify = !conf->verify_skip_if_ocsp_ok;
2398 if ((my_ok != OCSP_STATUS_FAILED)
2399 #ifdef HAVE_OPENSSL_OCSP_H
2402 ) while (conf->verify_client_cert_cmd) {
2407 snprintf(filename, sizeof(filename), "%s/%s.client.XXXXXXXX",
2408 conf->verify_tmp_dir, main_config.name);
2409 fd = mkstemp(filename);
2411 RDEBUG("Failed creating file in %s: %s",
2412 conf->verify_tmp_dir, fr_syserror(errno));
2416 fp = fdopen(fd, "w");
2419 RDEBUG("Failed opening file %s: %s",
2420 filename, fr_syserror(errno));
2424 if (!PEM_write_X509(fp, client_cert)) {
2426 RDEBUG("Failed writing certificate to file");
2431 if (!pair_make_request("TLS-Client-Cert-Filename",
2432 filename, T_OP_SET)) {
2433 RDEBUG("Failed creating TLS-Client-Cert-Filename");
2438 RDEBUG("Verifying client certificate: %s", conf->verify_client_cert_cmd);
2439 if (radius_exec_program(request, NULL, 0, NULL, request, conf->verify_client_cert_cmd,
2440 request->packet->vps,
2441 true, true, EXEC_TIMEOUT) != 0) {
2442 AUTH(LOG_PREFIX ": Certificate CN (%s) fails external verification!", common_name);
2445 } else if (request) {
2446 RDEBUG("Client certificate CN %s passed external validation", common_name);
2455 if (certs && request && !my_ok) {
2456 fr_pair_add(&request->packet->vps, fr_pair_list_copy(request->packet, *certs));
2459 if (RDEBUG_ENABLED3) {
2460 RDEBUG3("chain-depth : %d", depth);
2461 RDEBUG3("error : %d", err);
2463 if (identity) RDEBUG3("identity : %s", *identity);
2464 RDEBUG3("common name : %s", common_name);
2465 RDEBUG3("subject : %s", subject);
2466 RDEBUG3("issuer : %s", issuer);
2467 RDEBUG3("verify return : %d", my_ok);
2470 return (my_ok != 0);
2474 #ifdef HAVE_OPENSSL_OCSP_H
2476 * Create Global X509 revocation store and use it to verify
2479 * - Load the trusted CAs
2480 * - Load the trusted issuer certificates
2482 static X509_STORE *init_revocation_store(fr_tls_server_conf_t *conf)
2484 X509_STORE *store = NULL;
2486 store = X509_STORE_new();
2488 /* Load the CAs we trust */
2489 if (conf->ca_file || conf->ca_path)
2490 if (!X509_STORE_load_locations(store, conf->ca_file, conf->ca_path)) {
2491 tls_error_log(NULL, "Error reading Trusted root CA list \"%s\"", conf->ca_file);
2495 #ifdef X509_V_FLAG_CRL_CHECK
2496 if (conf->check_crl)
2497 X509_STORE_set_flags(store, X509_V_FLAG_CRL_CHECK);
2499 #ifdef X509_V_FLAG_CRL_CHECK_ALL
2500 if (conf->check_all_crl)
2501 X509_STORE_set_flags(store, X509_V_FLAG_CRL_CHECK_ALL);
2505 #endif /* HAVE_OPENSSL_OCSP_H */
2507 #if OPENSSL_VERSION_NUMBER >= 0x0090800fL
2508 #ifndef OPENSSL_NO_ECDH
2509 static int set_ecdh_curve(SSL_CTX *ctx, char const *ecdh_curve, bool disable_single_dh_use)
2514 if (!ecdh_curve || !*ecdh_curve) return 0;
2516 nid = OBJ_sn2nid(ecdh_curve);
2518 ERROR(LOG_PREFIX ": Unknown ecdh_curve \"%s\"", ecdh_curve);
2522 ecdh = EC_KEY_new_by_curve_name(nid);
2524 ERROR(LOG_PREFIX ": Unable to create new curve \"%s\"", ecdh_curve);
2528 SSL_CTX_set_tmp_ecdh(ctx, ecdh);
2530 if (!disable_single_dh_use) {
2531 SSL_CTX_set_options(ctx, SSL_OP_SINGLE_ECDH_USE);
2542 * DIE OPENSSL DIE DIE DIE
2544 * What a palaver, just to free some data attached the
2545 * session. We need to do this because the "remove" callback
2546 * is called when refcount > 0 sometimes, if another thread
2547 * is using the session
2549 static void sess_free_vps(UNUSED void *parent, void *data_ptr,
2550 UNUSED CRYPTO_EX_DATA *ad, UNUSED int idx,
2551 UNUSED long argl, UNUSED void *argp)
2553 VALUE_PAIR *vp = data_ptr;
2556 DEBUG2(LOG_PREFIX ": Freeing cached session VPs");
2558 fr_pair_list_free(&vp);
2561 static void sess_free_certs(UNUSED void *parent, void *data_ptr,
2562 UNUSED CRYPTO_EX_DATA *ad, UNUSED int idx,
2563 UNUSED long argl, UNUSED void *argp)
2565 VALUE_PAIR **certs = data_ptr;
2568 DEBUG2(LOG_PREFIX ": Freeing cached session Certificates");
2570 fr_pair_list_free(certs);
2573 /** Add all the default ciphers and message digests reate our context.
2575 * This should be called exactly once from main, before reading the main config
2576 * or initialising any modules.
2578 void tls_global_init(void)
2580 SSL_load_error_strings(); /* readable error messages (examples show call before library_init) */
2581 SSL_library_init(); /* initialize library */
2582 OpenSSL_add_all_algorithms(); /* required for SHA2 in OpenSSL < 0.9.8o and 1.0.0.a */
2583 CONF_modules_load_file(NULL, NULL, 0);
2586 * Initialize the index for the certificates.
2588 fr_tls_ex_index_certs = SSL_SESSION_get_ex_new_index(0, NULL, NULL, NULL, sess_free_certs);
2591 #ifdef ENABLE_OPENSSL_VERSION_CHECK
2592 /** Check for vulnerable versions of libssl
2594 * @param acknowledged The highest CVE number a user has confirmed is not present in the system's libssl.
2595 * @return 0 if the CVE specified by the user matches the most recent CVE we have, else -1.
2597 int tls_global_version_check(char const *acknowledged)
2603 if (strcmp(acknowledged, "yes") == 0) return 0;
2605 /* Check for bad versions */
2606 v = (uint64_t) SSLeay();
2608 for (i = 0; i < (sizeof(libssl_defects) / sizeof(*libssl_defects)); i++) {
2609 libssl_defect_t *defect = &libssl_defects[i];
2611 if ((v >= defect->low) && (v <= defect->high)) {
2613 * If the CVE is acknowledged, allow it.
2615 if (!bad && (strcmp(acknowledged, defect->id) == 0)) return 0;
2617 ERROR("Refusing to start with libssl version %s (in range %s)",
2618 ssl_version(), ssl_version_range(defect->low, defect->high));
2619 ERROR("Security advisory %s (%s)", defect->id, defect->name);
2620 ERROR("%s", defect->comment);
2623 * Only warn about the first one...
2626 INFO("Once you have verified libssl has been correctly patched, "
2627 "set security.allow_vulnerable_openssl = '%s'", defect->id);
2640 /** Free any memory alloced by libssl
2643 void tls_global_cleanup(void)
2645 #if OPENSSL_VERSION_NUMBER < 0x10000000L
2646 ERR_remove_state(0);
2647 #elif OPENSSL_VERSION_NUMBER < 0x10100000L || defined(LIBRESSL_VERSION_NUMBER)
2648 ERR_remove_thread_state(NULL);
2651 CONF_modules_unload(1);
2654 CRYPTO_cleanup_all_ex_data();
2657 /** Create SSL context
2659 * - Load the trusted CAs
2660 * - Load the Private key & the certificate
2661 * - Set the Context options & Verify options
2663 SSL_CTX *tls_init_ctx(fr_tls_server_conf_t *conf, int client)
2666 X509_STORE *certstore;
2667 int verify_mode = SSL_VERIFY_NONE;
2668 int ctx_options = 0;
2669 int ctx_tls_versions = 0;
2673 * SHA256 is in all versions of OpenSSL, but isn't
2674 * initialized by default. It's needed for WiMAX
2677 #ifdef HAVE_OPENSSL_EVP_SHA256
2678 EVP_add_digest(EVP_sha256());
2681 ctx = SSL_CTX_new(SSLv23_method()); /* which is really "all known SSL / TLS methods". Idiots. */
2683 tls_error_log(NULL, "Failed creating TLS context");
2688 * Save the config on the context so that callbacks which
2689 * only get SSL_CTX* e.g. session persistence, can get it
2691 SSL_CTX_set_app_data(ctx, conf);
2694 * Identify the type of certificates that needs to be loaded
2696 if (conf->file_type) {
2697 type = SSL_FILETYPE_PEM;
2699 type = SSL_FILETYPE_ASN1;
2703 * Set the password to load private key
2705 if (conf->private_key_password) {
2708 * We don't want to put the private key password in eap.conf, so check
2709 * for our special string which indicates we should get the password
2712 char const* special_string = "Apple:UseCertAdmin";
2713 if (strncmp(conf->private_key_password, special_string, strlen(special_string)) == 0) {
2716 long const max_password_len = 128;
2717 snprintf(cmd, sizeof(cmd) - 1, "/usr/sbin/certadmin --get-private-key-passphrase \"%s\"",
2718 conf->private_key_file);
2720 DEBUG2(LOG_PREFIX ": Getting private key passphrase using command \"%s\"", cmd);
2722 FILE* cmd_pipe = popen(cmd, "r");
2724 ERROR(LOG_PREFIX ": %s command failed: Unable to get private_key_password", cmd);
2725 ERROR(LOG_PREFIX ": Error reading private_key_file %s", conf->private_key_file);
2729 rad_const_free(conf->private_key_password);
2730 password = talloc_array(conf, char, max_password_len);
2732 ERROR(LOG_PREFIX ": Can't allocate space for private_key_password");
2733 ERROR(LOG_PREFIX ": Error reading private_key_file %s", conf->private_key_file);
2738 fgets(password, max_password_len, cmd_pipe);
2741 /* Get rid of newline at end of password. */
2742 password[strlen(password) - 1] = '\0';
2744 DEBUG3(LOG_PREFIX ": Password from command = \"%s\"", password);
2745 conf->private_key_password = password;
2752 memcpy(&password, &conf->private_key_password, sizeof(password));
2753 SSL_CTX_set_default_passwd_cb_userdata(ctx, password);
2754 SSL_CTX_set_default_passwd_cb(ctx, cbtls_password);
2758 #ifdef PSK_MAX_IDENTITY_LEN
2761 * No dynamic query exists. There MUST be a
2762 * statically configured identity and password.
2764 if (conf->psk_query && !*conf->psk_query) {
2765 ERROR(LOG_PREFIX ": Invalid PSK Configuration: psk_query cannot be empty");
2770 * Set the callback only if we can check things.
2772 if (conf->psk_identity || conf->psk_query) {
2773 SSL_CTX_set_psk_server_callback(ctx, psk_server_callback);
2776 } else if (conf->psk_query) {
2777 ERROR(LOG_PREFIX ": Invalid PSK Configuration: psk_query cannot be used for outgoing connections");
2782 * Now check that if PSK is being used, the config is valid.
2784 if ((conf->psk_identity && !conf->psk_password) ||
2785 (!conf->psk_identity && conf->psk_password) ||
2786 (conf->psk_identity && !*conf->psk_identity) ||
2787 (conf->psk_password && !*conf->psk_password)) {
2788 ERROR(LOG_PREFIX ": Invalid PSK Configuration: psk_identity or psk_password are empty");
2792 if (conf->psk_identity) {
2793 size_t psk_len, hex_len;
2794 uint8_t buffer[PSK_MAX_PSK_LEN];
2796 if (conf->certificate_file ||
2797 conf->private_key_password || conf->private_key_file ||
2798 conf->ca_file || conf->ca_path) {
2799 ERROR(LOG_PREFIX ": When PSKs are used, No certificate configuration is permitted");
2804 SSL_CTX_set_psk_client_callback(ctx,
2805 psk_client_callback);
2808 psk_len = strlen(conf->psk_password);
2809 if (strlen(conf->psk_password) > (2 * PSK_MAX_PSK_LEN)) {
2810 ERROR(LOG_PREFIX ": psk_hexphrase is too long (max %d)", PSK_MAX_PSK_LEN);
2815 * Check the password now, so that we don't have
2816 * errors at run-time.
2818 hex_len = fr_hex2bin(buffer, sizeof(buffer), conf->psk_password, psk_len);
2819 if (psk_len != (2 * hex_len)) {
2820 ERROR(LOG_PREFIX ": psk_hexphrase is not all hex");
2827 (void) client; /* -Wunused */
2831 * Load our keys and certificates
2833 * If certificates are of type PEM then we can make use
2834 * of cert chain authentication using openssl api call
2835 * SSL_CTX_use_certificate_chain_file. Please see how
2836 * the cert chain needs to be given in PEM from
2839 if (!conf->certificate_file) goto load_ca;
2841 if (type == SSL_FILETYPE_PEM) {
2842 if (!(SSL_CTX_use_certificate_chain_file(ctx, conf->certificate_file))) {
2843 tls_error_log(NULL, "Failed reading certificate file \"%s\"",
2844 conf->certificate_file);
2848 } else if (!(SSL_CTX_use_certificate_file(ctx, conf->certificate_file, type))) {
2849 tls_error_log(NULL, "Failed reading certificate file \"%s\"",
2850 conf->certificate_file);
2854 /* Load the CAs we trust */
2856 if (conf->ca_file || conf->ca_path) {
2857 if (!SSL_CTX_load_verify_locations(ctx, conf->ca_file, conf->ca_path)) {
2858 tls_error_log(NULL, "Failed reading Trusted root CA list \"%s\"",
2863 if (conf->ca_file && *conf->ca_file) SSL_CTX_set_client_CA_list(ctx, SSL_load_client_CA_file(conf->ca_file));
2865 if (conf->private_key_file) {
2866 if (!(SSL_CTX_use_PrivateKey_file(ctx, conf->private_key_file, type))) {
2867 tls_error_log(NULL, "Failed reading private key file \"%s\"",
2868 conf->private_key_file);
2873 * Check if the loaded private key is the right one
2875 if (!SSL_CTX_check_private_key(ctx)) {
2876 ERROR(LOG_PREFIX ": Private key does not match the certificate public key");
2881 #ifdef PSK_MAX_IDENTITY_LEN
2886 * We never want SSLv2 or SSLv3.
2888 ctx_options |= SSL_OP_NO_SSLv2;
2889 ctx_options |= SSL_OP_NO_SSLv3;
2892 * As of 3.0.5, we always allow TLSv1.1 and TLSv1.2.
2893 * Though they can be *globally* disabled if necessary.x
2895 #ifdef SSL_OP_NO_TLSv1
2896 if (conf->disable_tlsv1) ctx_options |= SSL_OP_NO_TLSv1;
2898 ctx_tls_versions |= SSL_OP_NO_TLSv1;
2900 #ifdef SSL_OP_NO_TLSv1_1
2901 if (conf->disable_tlsv1_1) ctx_options |= SSL_OP_NO_TLSv1_1;
2903 ctx_tls_versions |= SSL_OP_NO_TLSv1_1;
2905 #ifdef SSL_OP_NO_TLSv1_2
2907 if (conf->disable_tlsv1_2) ctx_options |= SSL_OP_NO_TLSv1_2;
2909 ctx_tls_versions |= SSL_OP_NO_TLSv1_2;
2913 if ((ctx_options & ctx_tls_versions) == ctx_tls_versions) {
2914 ERROR(LOG_PREFIX ": You have disabled all available TLS versions. EAP will not work");
2918 #ifdef SSL_OP_NO_TICKET
2919 ctx_options |= SSL_OP_NO_TICKET;
2922 if (!conf->disable_single_dh_use) {
2924 * SSL_OP_SINGLE_DH_USE must be used in order to prevent
2925 * small subgroup attacks and forward secrecy. Always
2926 * using SSL_OP_SINGLE_DH_USE has an impact on the
2927 * computer time needed during negotiation, but it is not
2930 ctx_options |= SSL_OP_SINGLE_DH_USE;
2934 * SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS to work around issues
2935 * in Windows Vista client.
2936 * http://www.openssl.org/~bodo/tls-cbc.txt
2937 * http://www.nabble.com/(RADIATOR)-Radiator-Version-3.16-released-t2600070.html
2939 ctx_options |= SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS;
2941 if (conf->cipher_server_preference) {
2943 * SSL_OP_CIPHER_SERVER_PREFERENCE to follow best practice
2944 * of nowday's TLS: do not allow poorly-selected ciphers from
2945 * client to take preference
2947 ctx_options |= SSL_OP_CIPHER_SERVER_PREFERENCE;
2950 SSL_CTX_set_options(ctx, ctx_options);
2953 * TODO: Set the RSA & DH
2954 * SSL_CTX_set_tmp_rsa_callback(ctx, cbtls_rsa);
2955 * SSL_CTX_set_tmp_dh_callback(ctx, cbtls_dh);
2959 * set the message callback to identify the type of
2960 * message. For every new session, there can be a
2961 * different callback argument.
2963 * SSL_CTX_set_msg_callback(ctx, cbtls_msg);
2967 * Set eliptical curve crypto configuration.
2969 #if OPENSSL_VERSION_NUMBER >= 0x0090800fL
2970 #ifndef OPENSSL_NO_ECDH
2971 if (set_ecdh_curve(ctx, conf->ecdh_curve, conf->disable_single_dh_use) < 0) {
2978 * OpenSSL will automatically create certificate chains,
2979 * unless we tell it to not do that. The problem is that
2980 * it sometimes gets the chains right from a certificate
2981 * signature view, but wrong from the clients view.
2983 if (!conf->auto_chain) {
2984 SSL_CTX_set_mode(ctx, SSL_MODE_NO_AUTO_CHAIN);
2987 /* Set Info callback */
2988 SSL_CTX_set_info_callback(ctx, cbtls_info);
2991 * Callbacks, etc. for session resumption.
2993 if (conf->session_cache_enable) {
2995 * Cache sessions on disk if requested.
2997 if (conf->session_cache_path) {
2998 SSL_CTX_sess_set_new_cb(ctx, cbtls_new_session);
2999 SSL_CTX_sess_set_get_cb(ctx, cbtls_get_session);
3000 SSL_CTX_sess_set_remove_cb(ctx, cbtls_remove_session);
3003 SSL_CTX_set_quiet_shutdown(ctx, 1);
3004 if (fr_tls_ex_index_vps < 0)
3005 fr_tls_ex_index_vps = SSL_SESSION_get_ex_new_index(0, NULL, NULL, NULL, sess_free_vps);
3009 * Check the certificates for revocation.
3011 #ifdef X509_V_FLAG_CRL_CHECK
3012 if (conf->check_crl) {
3013 certstore = SSL_CTX_get_cert_store(ctx);
3014 if (certstore == NULL) {
3015 tls_error_log(NULL, "Error reading Certificate Store");
3018 X509_STORE_set_flags(certstore, X509_V_FLAG_CRL_CHECK);
3020 #ifdef X509_V_FLAG_CRL_CHECK_ALL
3021 if (conf->check_all_crl)
3022 X509_STORE_set_flags(certstore, X509_V_FLAG_CRL_CHECK_ALL);
3029 * Always verify the peer certificate
3031 verify_mode |= SSL_VERIFY_PEER;
3032 verify_mode |= SSL_VERIFY_FAIL_IF_NO_PEER_CERT;
3033 verify_mode |= SSL_VERIFY_CLIENT_ONCE;
3034 SSL_CTX_set_verify(ctx, verify_mode, cbtls_verify);
3036 if (conf->verify_depth) {
3037 SSL_CTX_set_verify_depth(ctx, conf->verify_depth);
3040 /* Load randomness */
3041 if (conf->random_file) {
3042 if (!(RAND_load_file(conf->random_file, 1024*10))) {
3043 tls_error_log(NULL, "Failed loading randomness");
3049 * Set the cipher list if we were told to
3051 if (conf->cipher_list) {
3052 if (!SSL_CTX_set_cipher_list(ctx, conf->cipher_list)) {
3053 tls_error_log(NULL, "Failed setting cipher list");
3059 * Setup session caching
3061 if (conf->session_cache_enable) {
3063 * Create a unique context Id per EAP-TLS configuration.
3065 if (conf->session_id_name) {
3066 snprintf(conf->session_context_id, sizeof(conf->session_context_id),
3067 "FR eap %s", conf->session_id_name);
3069 snprintf(conf->session_context_id, sizeof(conf->session_context_id),
3074 * Cache it, DON'T auto-clear it, and disable the internal OpenSSL session cache.
3076 SSL_CTX_set_session_cache_mode(ctx, SSL_SESS_CACHE_SERVER | SSL_SESS_CACHE_NO_AUTO_CLEAR | SSL_SESS_CACHE_NO_INTERNAL);
3078 SSL_CTX_set_session_id_context(ctx,
3079 (unsigned char *) conf->session_context_id,
3080 (unsigned int) strlen(conf->session_context_id));
3083 * Our timeout is in hours, this is in seconds.
3085 SSL_CTX_set_timeout(ctx, conf->session_timeout * 3600);
3088 * Set the maximum number of entries in the
3091 SSL_CTX_sess_set_cache_size(ctx, conf->session_cache_size);
3094 SSL_CTX_set_session_cache_mode(ctx, SSL_SESS_CACHE_OFF);
3102 * Free TLS client/server config
3103 * Should not be called outside this code, as a callback is
3104 * added to automatically free the data when the CONF_SECTION
3107 static int _tls_server_conf_free(fr_tls_server_conf_t *conf)
3109 if (conf->ctx) SSL_CTX_free(conf->ctx);
3111 #ifdef HAVE_OPENSSL_OCSP_H
3112 if (conf->ocsp_store) X509_STORE_free(conf->ocsp_store);
3113 conf->ocsp_store = NULL;
3117 memset(conf, 0, sizeof(*conf));
3122 fr_tls_server_conf_t *tls_server_conf_alloc(TALLOC_CTX *ctx)
3124 fr_tls_server_conf_t *conf;
3126 conf = talloc_zero(ctx, fr_tls_server_conf_t);
3128 ERROR(LOG_PREFIX ": Out of memory");
3132 talloc_set_destructor(conf, _tls_server_conf_free);
3137 fr_tls_server_conf_t *tls_server_conf_parse(CONF_SECTION *cs)
3139 fr_tls_server_conf_t *conf;
3142 * If cs has already been parsed there should be a cached copy
3143 * of conf already stored, so just return that.
3145 conf = cf_data_find(cs, "tls-conf");
3147 DEBUG(LOG_PREFIX ": Using cached TLS configuration from previous invocation");
3151 conf = tls_server_conf_alloc(cs);
3153 if (cf_section_parse(cs, conf, tls_server_config) < 0) {
3160 * Save people from their own stupidity.
3162 if (conf->fragment_size < 100) conf->fragment_size = 100;
3165 * Only check for certificate things if we don't have a
3168 if (conf->psk_identity) {
3169 if (conf->private_key_file) {
3170 WARN(LOG_PREFIX ": Ignoring private key file due to psk_identity being used");
3173 if (conf->certificate_file) {
3174 WARN(LOG_PREFIX ": Ignoring certificate file due to psk_identity being used");
3178 if (!conf->private_key_file) {
3179 ERROR(LOG_PREFIX ": TLS Server requires a private key file");
3183 if (!conf->certificate_file) {
3184 ERROR(LOG_PREFIX ": TLS Server requires a certificate file");
3192 conf->ctx = tls_init_ctx(conf, 0);
3193 if (conf->ctx == NULL) {
3197 #ifdef HAVE_OPENSSL_OCSP_H
3199 * Initialize OCSP Revocation Store
3201 if (conf->ocsp_enable) {
3202 conf->ocsp_store = init_revocation_store(conf);
3203 if (conf->ocsp_store == NULL) goto error;
3205 #endif /*HAVE_OPENSSL_OCSP_H*/
3209 memcpy(&dh_file, &conf->dh_file, sizeof(dh_file));
3210 if (load_dh_params(conf->ctx, dh_file) < 0) {
3215 if (conf->verify_tmp_dir) {
3216 if (chmod(conf->verify_tmp_dir, S_IRWXU) < 0) {
3217 ERROR(LOG_PREFIX ": Failed changing permissions on %s: %s",
3218 conf->verify_tmp_dir, fr_syserror(errno));
3223 if (conf->verify_client_cert_cmd && !conf->verify_tmp_dir) {
3224 ERROR(LOG_PREFIX ": You MUST set the verify directory in order to use verify_client_cmd");
3228 #ifdef SSL_OP_NO_TLSv1_2
3230 * OpenSSL 1.0.1f and 1.0.1g get the MS-MPPE keys wrong.
3232 #if (OPENSSL_VERSION_NUMBER >= 0x10010060L) && (OPENSSL_VERSION_NUMBER < 0x10010060L)
3233 conf->disable_tlsv1_2 = true;
3234 WARN(LOG_PREFIX ": Disabling TLSv1.2 due to OpenSSL bugs");
3239 * Cache conf in cs in case we're asked to parse this again.
3241 cf_data_add(cs, "tls-conf", conf, NULL);
3246 fr_tls_server_conf_t *tls_client_conf_parse(CONF_SECTION *cs)
3248 fr_tls_server_conf_t *conf;
3250 conf = cf_data_find(cs, "tls-conf");
3252 DEBUG2(LOG_PREFIX ": Using cached TLS configuration from previous invocation");
3256 conf = tls_server_conf_alloc(cs);
3258 if (cf_section_parse(cs, conf, tls_client_config) < 0) {
3265 * Save people from their own stupidity.
3267 if (conf->fragment_size < 100) conf->fragment_size = 100;
3272 conf->ctx = tls_init_ctx(conf, 1);
3273 if (conf->ctx == NULL) {
3280 memcpy(&dh_file, &conf->dh_file, sizeof(dh_file));
3281 if (load_dh_params(conf->ctx, dh_file) < 0) {
3286 cf_data_add(cs, "tls-conf", conf, NULL);
3292 int tls_success(tls_session_t *ssn, REQUEST *request)
3294 VALUE_PAIR *vp, *vps = NULL;
3295 fr_tls_server_conf_t *conf;
3296 TALLOC_CTX *talloc_ctx;
3298 conf = (fr_tls_server_conf_t *)SSL_get_ex_data(ssn->ssl, FR_TLS_EX_INDEX_CONF);
3299 rad_assert(conf != NULL);
3301 talloc_ctx = SSL_get_ex_data(ssn->ssl, FR_TLS_EX_INDEX_TALLOC);
3304 * If there's no session resumption, delete the entry
3305 * from the cache. This means either it's disabled
3306 * globally for this SSL context, OR we were told to
3307 * disable it for this user.
3309 * This also means you can't turn it on just for one
3312 if ((!ssn->allow_session_resumption) ||
3313 (((vp = fr_pair_find_by_num(request->config, PW_ALLOW_SESSION_RESUMPTION, 0, TAG_ANY)) != NULL) &&
3314 (vp->vp_integer == 0))) {
3315 SSL_CTX_remove_session(ssn->ctx,
3317 ssn->allow_session_resumption = false;
3320 * If we're in a resumed session and it's
3323 if (SSL_session_reused(ssn->ssl)) {
3324 RDEBUG("Forcibly stopping session resumption as it is not allowed");
3329 * Else resumption IS allowed, so we store the
3330 * user data in the cache.
3332 } else if (!SSL_session_reused(ssn->ssl)) {
3334 char buffer[2 * MAX_SESSION_SIZE + 1];
3336 tls_session_id(ssn->ssl_session, buffer, MAX_SESSION_SIZE);
3338 vp = fr_pair_list_copy_by_num(talloc_ctx, request->reply->vps, PW_USER_NAME, 0, TAG_ANY);
3339 if (vp) fr_pair_add(&vps, vp);
3341 vp = fr_pair_list_copy_by_num(talloc_ctx, request->packet->vps, PW_STRIPPED_USER_NAME, 0, TAG_ANY);
3342 if (vp) fr_pair_add(&vps, vp);
3344 vp = fr_pair_list_copy_by_num(talloc_ctx, request->packet->vps, PW_STRIPPED_USER_DOMAIN, 0, TAG_ANY);
3345 if (vp) fr_pair_add(&vps, vp);
3347 vp = fr_pair_list_copy_by_num(talloc_ctx, request->reply->vps, PW_CHARGEABLE_USER_IDENTITY, 0, TAG_ANY);
3348 if (vp) fr_pair_add(&vps, vp);
3350 vp = fr_pair_list_copy_by_num(talloc_ctx, request->reply->vps, PW_CACHED_SESSION_POLICY, 0, TAG_ANY);
3351 if (vp) fr_pair_add(&vps, vp);
3353 certs = (VALUE_PAIR **)SSL_get_ex_data(ssn->ssl, fr_tls_ex_index_certs);
3356 * Hmm... the certs should probably be session data.
3360 * @todo: some go into reply, others into
3363 fr_pair_add(&vps, fr_pair_list_copy(talloc_ctx, *certs));
3366 * Save the certs in the packet, so that we can see them.
3368 fr_pair_add(&request->packet->vps, fr_pair_list_copy(request->packet, *certs));
3370 vp = fr_pair_find_by_num(request->packet->vps, PW_TLS_CLIENT_CERT_EXPIRATION, 0, TAG_ANY);
3374 if (ocsp_asn1time_to_epoch(&expires, vp->vp_strvalue) < 0) {
3375 RDEBUG2("Failed getting certificate expiration, removing cache entry for session %s", buffer);
3376 SSL_CTX_remove_session(ssn->ctx, ssn->ssl_session);
3380 if (expires <= request->timestamp) {
3381 RDEBUG2("Certificate has expired, removing cache entry for session %s", buffer);
3382 SSL_CTX_remove_session(ssn->ctx, ssn->ssl_session);
3387 * Account for Session-Timeout, if it's available.
3389 vp = fr_pair_find_by_num(request->reply->vps, PW_SESSION_TIMEOUT, 0, TAG_ANY);
3391 if ((request->timestamp + vp->vp_integer) > expires) {
3392 vp->vp_integer = expires - request->timestamp;
3393 RWDEBUG2("Updating Session-Timeout to %u, due to impending certificate expiration",
3401 SSL_SESSION_set_ex_data(ssn->ssl_session, fr_tls_ex_index_vps, vps);
3402 rdebug_pair_list(L_DBG_LVL_2, request, vps, " caching ");
3404 if (conf->session_cache_path) {
3405 /* write the VPs to the cache file */
3406 char filename[256], buf[1024];
3409 RDEBUG2("Saving session %s in the disk cache", buffer);
3411 snprintf(filename, sizeof(filename), "%s%c%s.vps", conf->session_cache_path,
3412 FR_DIR_SEP, buffer);
3413 vp_file = fopen(filename, "w");
3414 if (vp_file == NULL) {
3415 RWDEBUG("Could not write session VPs to persistent cache: %s",
3416 fr_syserror(errno));
3418 VALUE_PAIR *prev = NULL;
3420 /* generate a dummy user-style entry which is easy to read back */
3421 fprintf(vp_file, "# SSL cached session\n");
3422 fprintf(vp_file, "%s\n\t", buffer);
3424 for (vp = fr_cursor_init(&cursor, &vps);
3426 vp = fr_cursor_next(&cursor)) {
3428 * Terminate the previous line.
3430 if (prev) fprintf(vp_file, ",\n\t");
3435 vp_prints(buf, sizeof(buf), vp);
3436 fputs(buf, vp_file);
3441 * Terminate the final line.
3443 fprintf(vp_file, "\n");
3447 RDEBUG("Failed to find 'persist_dir' in TLS configuration. Session will not be cached on disk.");
3450 RDEBUG2("No information to cache: session caching will be disabled for session %s", buffer);
3451 SSL_CTX_remove_session(ssn->ctx, ssn->ssl_session);
3455 * Else the session WAS allowed. Copy the cached reply.
3458 char buffer[2 * MAX_SESSION_SIZE + 1];
3460 tls_session_id(ssn->ssl_session, buffer, MAX_SESSION_SIZE);
3463 * The "restore VPs from OpenSSL cache" code is
3464 * now in eaptls_process()
3467 if (conf->session_cache_path) {
3468 /* "touch" the cached session/vp file */
3471 snprintf(filename, sizeof(filename), "%s%c%s.asn1",
3472 conf->session_cache_path, FR_DIR_SEP, buffer);
3473 utime(filename, NULL);
3474 snprintf(filename, sizeof(filename), "%s%c%s.vps",
3475 conf->session_cache_path, FR_DIR_SEP, buffer);
3476 utime(filename, NULL);
3480 * Mark the request as resumed.
3482 pair_make_request("EAP-Session-Resumed", "1", T_OP_SET);
3489 void tls_fail(tls_session_t *ssn)
3492 * Force the session to NOT be cached.
3494 SSL_CTX_remove_session(ssn->ctx, ssn->ssl_session);
3497 fr_tls_status_t tls_application_data(tls_session_t *ssn, REQUEST *request)
3504 * Decrypt the complete record.
3506 err = BIO_write(ssn->into_ssl, ssn->dirty_in.data,
3507 ssn->dirty_in.used);
3508 if (err != (int) ssn->dirty_in.used) {
3509 record_init(&ssn->dirty_in);
3510 RDEBUG("Failed writing %zd bytes to SSL BIO: %d", ssn->dirty_in.used, err);
3515 * Clear the dirty buffer now that we are done with it
3516 * and init the clean_out buffer to store decrypted data
3518 record_init(&ssn->dirty_in);
3519 record_init(&ssn->clean_out);
3522 * Read (and decrypt) the tunneled data from the
3523 * SSL session, and put it into the decrypted
3526 err = SSL_read(ssn->ssl, ssn->clean_out.data, sizeof(ssn->clean_out.data));
3530 RDEBUG("SSL_read Error");
3532 code = SSL_get_error(ssn->ssl, err);
3534 case SSL_ERROR_WANT_READ:
3535 DEBUG("Error in fragmentation logic: SSL_WANT_READ");
3536 return FR_TLS_MORE_FRAGMENTS;
3538 case SSL_ERROR_WANT_WRITE:
3539 DEBUG("Error in fragmentation logic: SSL_WANT_WRITE");
3543 REDEBUG("Error in fragmentation logic");
3544 tls_error_io_log(request, ssn, err,
3545 "Failed in " STRINGIFY(__FUNCTION__) " (SSL_read)");
3551 if (err == 0) RWDEBUG("No data inside of the tunnel");
3554 * Passed all checks, successfully decrypted data
3556 ssn->clean_out.used = err;
3559 * Add the certificates to intermediate packets, so that
3560 * the inner tunnel policies can use them.
3562 certs = (VALUE_PAIR **)SSL_get_ex_data(ssn->ssl, fr_tls_ex_index_certs);
3564 if (certs) fr_pair_add(&request->packet->vps, fr_pair_list_copy(request->packet, *certs));
3571 * Acknowledge received is for one of the following messages sent earlier
3572 * 1. Handshake completed Message, so now send, EAP-Success
3573 * 2. Alert Message, now send, EAP-Failure
3574 * 3. Fragment Message, now send, next Fragment
3576 fr_tls_status_t tls_ack_handler(tls_session_t *ssn, REQUEST *request)
3579 REDEBUG("Unexpected ACK received: No ongoing SSL session");
3580 return FR_TLS_INVALID;
3582 if (!ssn->info.initialized) {
3583 RDEBUG("No SSL info available. Waiting for more SSL data");
3584 return FR_TLS_REQUEST;
3587 if ((ssn->info.content_type == handshake) && (ssn->info.origin == 0)) {
3588 REDEBUG("Unexpected ACK received: We sent no previous messages");
3589 return FR_TLS_INVALID;
3592 switch (ssn->info.content_type) {
3594 RDEBUG2("Peer ACKed our alert");
3598 if ((ssn->info.handshake_type == handshake_finished) && (ssn->dirty_out.used == 0)) {
3599 RDEBUG2("Peer ACKed our handshake fragment. handshake is finished");
3602 * From now on all the content is
3603 * application data set it here as nobody else
3606 ssn->info.content_type = application_data;
3607 return FR_TLS_SUCCESS;
3608 } /* else more data to send */
3610 RDEBUG2("Peer ACKed our handshake fragment");
3611 /* Fragmentation handler, send next fragment */
3612 return FR_TLS_REQUEST;
3614 case application_data:
3615 RDEBUG2("Peer ACKed our application data fragment");
3616 return FR_TLS_REQUEST;
3619 * For the rest of the conditions, switch over
3620 * to the default section below.
3623 REDEBUG("Invalid ACK received: %d", ssn->info.content_type);
3624 return FR_TLS_INVALID;
3627 #endif /* WITH_TLS */