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;
568 /** Create a new TLS session
570 * Configures a new TLS session, configuring options, setting callbacks etc...
572 * @param ctx to alloc session data in. Should usually be NULL unless the lifetime of the
573 * session is tied to another talloc'd object.
574 * @param conf to use to configure the tls session.
575 * @param request The current #REQUEST.
576 * @param client_cert Whether to require a client_cert.
577 * @return a new session on success, or NULL on error.
579 tls_session_t *tls_new_session(TALLOC_CTX *ctx, fr_tls_server_conf_t *conf, REQUEST *request, bool client_cert)
581 tls_session_t *state = NULL;
586 rad_assert(request != NULL);
588 RDEBUG2("Initiating new EAP-TLS session");
591 * Manually flush the sessions every so often. If HALF
592 * of the session lifetime has passed since we last
593 * flushed, then flush it again.
595 * FIXME: Also do it every N sessions?
597 if (conf->session_cache_enable &&
598 ((conf->session_last_flushed + ((int)conf->session_timeout * 1800)) <= request->timestamp)){
599 RDEBUG2("Flushing SSL sessions (of #%ld)", SSL_CTX_sess_number(conf->ctx));
601 SSL_CTX_flush_sessions(conf->ctx, request->timestamp);
602 conf->session_last_flushed = request->timestamp;
605 new_tls = SSL_new(conf->ctx);
606 if (new_tls == NULL) {
607 tls_error_log(request, "Error creating new TLS session");
611 /* We use the SSL's "app_data" to indicate a call-back */
612 SSL_set_app_data(new_tls, NULL);
614 if ((state = talloc_zero(ctx, tls_session_t)) == NULL) {
615 RERROR("Error allocating memory for SSL state");
619 talloc_set_destructor(state, _tls_session_free);
621 state->ctx = conf->ctx;
622 state->ssl = new_tls;
625 * Initialize callbacks
627 state->record_init = record_init;
628 state->record_close = record_close;
629 state->record_plus = record_plus;
630 state->record_minus = record_minus;
633 * Create & hook the BIOs to handle the dirty side of the
634 * SSL. This is *very important* as we want to handle
635 * the transmission part. Now the only IO interface
636 * that SSL is aware of, is our defined BIO buffers.
638 * This means that all SSL IO is done to/from memory,
639 * and we can update those BIOs from the packets we've
642 state->into_ssl = BIO_new(BIO_s_mem());
643 state->from_ssl = BIO_new(BIO_s_mem());
644 SSL_set_bio(state->ssl, state->into_ssl, state->from_ssl);
647 * Add the message callback to identify what type of
648 * message/handshake is passed
650 SSL_set_msg_callback(new_tls, cbtls_msg);
651 SSL_set_msg_callback_arg(new_tls, state);
652 SSL_set_info_callback(new_tls, cbtls_info);
655 * In Server mode we only accept.
657 SSL_set_accept_state(state->ssl);
660 * Verify the peer certificate, if asked.
663 RDEBUG2("Setting verify mode to require certificate from client");
664 verify_mode = SSL_VERIFY_PEER;
665 verify_mode |= SSL_VERIFY_FAIL_IF_NO_PEER_CERT;
666 verify_mode |= SSL_VERIFY_CLIENT_ONCE;
668 SSL_set_verify(state->ssl, verify_mode, cbtls_verify);
670 SSL_set_ex_data(state->ssl, FR_TLS_EX_INDEX_CONF, (void *)conf);
671 SSL_set_ex_data(state->ssl, FR_TLS_EX_INDEX_SSN, (void *)state);
672 state->length_flag = conf->include_length;
675 * We use default fragment size, unless the Framed-MTU
676 * tells us it's too big. Note that we do NOT account
677 * for the EAP-TLS headers if conf->fragment_size is
678 * large, because that config item looks to be confusing.
680 * i.e. it should REALLY be called MTU, and the code here
681 * should figure out what that means for TLS fragment size.
682 * asking the administrator to know the internal details
683 * of EAP-TLS in order to calculate fragment sizes is
686 state->mtu = conf->fragment_size;
687 vp = fr_pair_find_by_num(request->packet->vps, PW_FRAMED_MTU, 0, TAG_ANY);
688 if (vp && (vp->vp_integer > 100) && (vp->vp_integer < state->mtu)) {
689 state->mtu = vp->vp_integer;
692 if (conf->session_cache_enable) state->allow_session_resumption = true; /* otherwise it's false */
698 * We are the server, we always get the dirty data
699 * (Handshake data is also considered as dirty data)
700 * During handshake, since SSL API handles itself,
701 * After clean-up, dirty_out will be filled with
702 * the data required for handshaking. So we check
703 * if dirty_out is empty then we simply send it back.
704 * As of now, if handshake is successful, then we keep going,
707 * Fill the Bio with the dirty data to clean it
708 * Get the cleaned data from SSL, if it is not Handshake data
710 int tls_handshake_recv(REQUEST *request, tls_session_t *ssn)
714 if (ssn->invalid_hb_used) return 0;
716 err = BIO_write(ssn->into_ssl, ssn->dirty_in.data, ssn->dirty_in.used);
717 if (err != (int) ssn->dirty_in.used) {
718 REDEBUG("Failed writing %zd bytes to SSL BIO: %d", ssn->dirty_in.used, err);
719 record_init(&ssn->dirty_in);
722 record_init(&ssn->dirty_in);
724 err = SSL_read(ssn->ssl, ssn->clean_out.data + ssn->clean_out.used,
725 sizeof(ssn->clean_out.data) - ssn->clean_out.used);
727 ssn->clean_out.used += err;
731 if (!tls_error_io_log(request, ssn, err, "Failed in " STRINGIFY(__FUNCTION__) " (SSL_read)")) return 0;
733 /* Some Extra STATE information for easy debugging */
734 if (SSL_is_init_finished(ssn->ssl)) RDEBUG2("SSL Connection Established");
735 if (SSL_in_init(ssn->ssl)) RDEBUG2("In SSL Handshake Phase");
736 if (SSL_in_before(ssn->ssl)) RDEBUG2("Before SSL Handshake Phase");
737 if (SSL_in_accept_init(ssn->ssl)) RDEBUG2("In SSL Accept mode");
738 if (SSL_in_connect_init(ssn->ssl)) RDEBUG2("In SSL Connect mode");
740 #if OPENSSL_VERSION_NUMBER >= 0x10001000L
742 * Cache the SSL_SESSION pointer.
744 if (!ssn->ssl_session && SSL_is_init_finished(ssn->ssl)) {
745 ssn->ssl_session = SSL_get_session(ssn->ssl);
746 if (!ssn->ssl_session) {
747 RDEBUG("Failed getting SSL session");
753 err = BIO_ctrl_pending(ssn->from_ssl);
755 err = BIO_read(ssn->from_ssl, ssn->dirty_out.data,
756 sizeof(ssn->dirty_out.data));
758 ssn->dirty_out.used = err;
760 } else if (BIO_should_retry(ssn->from_ssl)) {
761 record_init(&ssn->dirty_in);
762 RDEBUG2("Asking for more data in tunnel");
766 tls_error_log(NULL, NULL);
767 record_init(&ssn->dirty_in);
771 RDEBUG2("SSL Application Data");
772 /* Its clean application data, do whatever we want */
773 record_init(&ssn->clean_out);
776 /* We are done with dirty_in, reinitialize it */
777 record_init(&ssn->dirty_in);
782 * Take cleartext user data, and encrypt it into the output buffer,
783 * to send to the client at the other end of the SSL connection.
785 int tls_handshake_send(REQUEST *request, tls_session_t *ssn)
790 * If there's un-encrypted data in 'clean_in', then write
791 * that data to the SSL session, and then call the BIO function
792 * to get that encrypted data from the SSL session, into
793 * a buffer which we can then package into an EAP packet.
795 * Based on Server's logic this clean_in is expected to
796 * contain the data to send to the client.
798 if (ssn->clean_in.used > 0) {
801 written = SSL_write(ssn->ssl, ssn->clean_in.data, ssn->clean_in.used);
802 record_minus(&ssn->clean_in, NULL, written);
804 /* Get the dirty data from Bio to send it */
805 err = BIO_read(ssn->from_ssl, ssn->dirty_out.data,
806 sizeof(ssn->dirty_out.data));
808 ssn->dirty_out.used = err;
810 if (!tls_error_io_log(request, ssn, err,
811 "Failed in " STRINGIFY(__FUNCTION__) " (SSL_write)")) {
820 static void session_init(tls_session_t *ssn)
823 ssn->into_ssl = ssn->from_ssl = NULL;
824 record_init(&ssn->clean_in);
825 record_init(&ssn->clean_out);
826 record_init(&ssn->dirty_in);
827 record_init(&ssn->dirty_out);
829 memset(&ssn->info, 0, sizeof(ssn->info));
832 ssn->fragment = false;
833 ssn->tls_msg_len = 0;
834 ssn->length_flag = false;
836 ssn->free_opaque = NULL;
839 static void session_close(tls_session_t *ssn)
842 SSL_set_quiet_shutdown(ssn->ssl, 1);
843 SSL_shutdown(ssn->ssl);
849 record_close(&ssn->clean_in);
850 record_close(&ssn->clean_out);
851 record_close(&ssn->dirty_in);
852 record_close(&ssn->dirty_out);
856 static void record_init(record_t *rec)
861 static void record_close(record_t *rec)
868 * Copy data to the intermediate buffer, before we send
871 static unsigned int record_plus(record_t *rec, void const *ptr,
874 unsigned int added = MAX_RECORD_SIZE - rec->used;
880 memcpy(rec->data + rec->used, ptr, added);
886 * Take data from the buffer, and give it to the caller.
888 static unsigned int record_minus(record_t *rec, void *ptr,
891 unsigned int taken = rec->used;
898 memcpy(ptr, rec->data, taken);
902 * This is pretty bad...
904 if (rec->used > 0) memmove(rec->data, rec->data + taken, rec->used);
909 void tls_session_information(tls_session_t *tls_session)
911 char const *str_write_p, *str_version, *str_content_type = "";
912 char const *str_details1 = "", *str_details2= "";
917 * Don't print this out in the normal course of
920 if (rad_debug_lvl == 0) return;
922 str_write_p = tls_session->info.origin ? ">>> send" : "<<< recv";
924 switch (tls_session->info.version) {
926 str_version = "SSL 2.0 ";
929 str_version = "SSL 3.0 ";
932 str_version = "TLS 1.0 ";
934 #ifdef TLS1_1_VERSION
936 str_version = "TLS 1.1 ";
939 #ifdef TLS1_2_VERSION
941 str_version = "TLS 1.2 ";
946 str_version = "TLS 1.3 ";
951 sprintf(buffer, "UNKNOWN TLS VERSION ?%04X?", tls_session->info.version);
952 str_version = buffer;
956 if (tls_session->info.version == SSL3_VERSION ||
957 tls_session->info.version == TLS1_VERSION) {
958 switch (tls_session->info.content_type) {
959 case SSL3_RT_CHANGE_CIPHER_SPEC:
960 str_content_type = "ChangeCipherSpec";
964 str_content_type = "Alert";
967 case SSL3_RT_HANDSHAKE:
968 str_content_type = "Handshake";
971 case SSL3_RT_APPLICATION_DATA:
972 str_content_type = "ApplicationData";
976 str_content_type = "UnknownContentType";
980 if (tls_session->info.content_type == SSL3_RT_ALERT) {
981 str_details1 = ", ???";
983 if (tls_session->info.record_len == 2) {
985 switch (tls_session->info.alert_level) {
986 case SSL3_AL_WARNING:
987 str_details1 = ", warning";
990 str_details1 = ", fatal";
994 str_details2 = " ???";
995 switch (tls_session->info.alert_description) {
996 case SSL3_AD_CLOSE_NOTIFY:
997 str_details2 = " close_notify";
1000 case SSL3_AD_UNEXPECTED_MESSAGE:
1001 str_details2 = " unexpected_message";
1004 case SSL3_AD_BAD_RECORD_MAC:
1005 str_details2 = " bad_record_mac";
1008 case TLS1_AD_DECRYPTION_FAILED:
1009 str_details2 = " decryption_failed";
1012 case TLS1_AD_RECORD_OVERFLOW:
1013 str_details2 = " record_overflow";
1016 case SSL3_AD_DECOMPRESSION_FAILURE:
1017 str_details2 = " decompression_failure";
1020 case SSL3_AD_HANDSHAKE_FAILURE:
1021 str_details2 = " handshake_failure";
1024 case SSL3_AD_BAD_CERTIFICATE:
1025 str_details2 = " bad_certificate";
1028 case SSL3_AD_UNSUPPORTED_CERTIFICATE:
1029 str_details2 = " unsupported_certificate";
1032 case SSL3_AD_CERTIFICATE_REVOKED:
1033 str_details2 = " certificate_revoked";
1036 case SSL3_AD_CERTIFICATE_EXPIRED:
1037 str_details2 = " certificate_expired";
1040 case SSL3_AD_CERTIFICATE_UNKNOWN:
1041 str_details2 = " certificate_unknown";
1044 case SSL3_AD_ILLEGAL_PARAMETER:
1045 str_details2 = " illegal_parameter";
1048 case TLS1_AD_UNKNOWN_CA:
1049 str_details2 = " unknown_ca";
1052 case TLS1_AD_ACCESS_DENIED:
1053 str_details2 = " access_denied";
1056 case TLS1_AD_DECODE_ERROR:
1057 str_details2 = " decode_error";
1060 case TLS1_AD_DECRYPT_ERROR:
1061 str_details2 = " decrypt_error";
1064 case TLS1_AD_EXPORT_RESTRICTION:
1065 str_details2 = " export_restriction";
1068 case TLS1_AD_PROTOCOL_VERSION:
1069 str_details2 = " protocol_version";
1072 case TLS1_AD_INSUFFICIENT_SECURITY:
1073 str_details2 = " insufficient_security";
1076 case TLS1_AD_INTERNAL_ERROR:
1077 str_details2 = " internal_error";
1080 case TLS1_AD_USER_CANCELLED:
1081 str_details2 = " user_canceled";
1084 case TLS1_AD_NO_RENEGOTIATION:
1085 str_details2 = " no_renegotiation";
1091 if (tls_session->info.content_type == SSL3_RT_HANDSHAKE) {
1092 str_details1 = "???";
1094 if (tls_session->info.record_len > 0) switch (tls_session->info.handshake_type) {
1095 case SSL3_MT_HELLO_REQUEST:
1096 str_details1 = ", HelloRequest";
1099 case SSL3_MT_CLIENT_HELLO:
1100 str_details1 = ", ClientHello";
1103 case SSL3_MT_SERVER_HELLO:
1104 str_details1 = ", ServerHello";
1107 case SSL3_MT_CERTIFICATE:
1108 str_details1 = ", Certificate";
1111 case SSL3_MT_SERVER_KEY_EXCHANGE:
1112 str_details1 = ", ServerKeyExchange";
1115 case SSL3_MT_CERTIFICATE_REQUEST:
1116 str_details1 = ", CertificateRequest";
1119 case SSL3_MT_SERVER_DONE:
1120 str_details1 = ", ServerHelloDone";
1123 case SSL3_MT_CERTIFICATE_VERIFY:
1124 str_details1 = ", CertificateVerify";
1127 case SSL3_MT_CLIENT_KEY_EXCHANGE:
1128 str_details1 = ", ClientKeyExchange";
1131 case SSL3_MT_FINISHED:
1132 str_details1 = ", Finished";
1138 snprintf(tls_session->info.info_description,
1139 sizeof(tls_session->info.info_description),
1140 "%s %s%s [length %04lx]%s%s\n",
1141 str_write_p, str_version, str_content_type,
1142 (unsigned long)tls_session->info.record_len,
1143 str_details1, str_details2);
1145 request = SSL_get_ex_data(tls_session->ssl, FR_TLS_EX_INDEX_REQUEST);
1146 ROPTIONAL(RDEBUG2, DEBUG2, "%s", tls_session->info.info_description);
1149 static CONF_PARSER cache_config[] = {
1150 { "enable", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, session_cache_enable), "no" },
1152 { "lifetime", FR_CONF_OFFSET(PW_TYPE_INTEGER, fr_tls_server_conf_t, session_timeout), "24" },
1153 { "name", FR_CONF_OFFSET(PW_TYPE_STRING, fr_tls_server_conf_t, session_id_name), NULL },
1155 { "max_entries", FR_CONF_OFFSET(PW_TYPE_INTEGER, fr_tls_server_conf_t, session_cache_size), "255" },
1156 { "persist_dir", FR_CONF_OFFSET(PW_TYPE_STRING, fr_tls_server_conf_t, session_cache_path), NULL },
1157 CONF_PARSER_TERMINATOR
1160 static CONF_PARSER verify_config[] = {
1161 { "skip_if_ocsp_ok", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, verify_skip_if_ocsp_ok), "no" },
1162 { "tmpdir", FR_CONF_OFFSET(PW_TYPE_STRING, fr_tls_server_conf_t, verify_tmp_dir), NULL },
1163 { "client", FR_CONF_OFFSET(PW_TYPE_STRING, fr_tls_server_conf_t, verify_client_cert_cmd), NULL },
1164 CONF_PARSER_TERMINATOR
1167 #ifdef HAVE_OPENSSL_OCSP_H
1168 static CONF_PARSER ocsp_config[] = {
1169 { "enable", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, ocsp_enable), "no" },
1170 { "override_cert_url", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, ocsp_override_url), "no" },
1171 { "url", FR_CONF_OFFSET(PW_TYPE_STRING, fr_tls_server_conf_t, ocsp_url), NULL },
1172 { "use_nonce", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, ocsp_use_nonce), "yes" },
1173 { "timeout", FR_CONF_OFFSET(PW_TYPE_INTEGER, fr_tls_server_conf_t, ocsp_timeout), "yes" },
1174 { "softfail", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, ocsp_softfail), "no" },
1175 CONF_PARSER_TERMINATOR
1179 static CONF_PARSER tls_server_config[] = {
1180 { "verify_depth", FR_CONF_OFFSET(PW_TYPE_INTEGER, fr_tls_server_conf_t, verify_depth), "0" },
1181 { "CA_path", FR_CONF_OFFSET(PW_TYPE_FILE_INPUT | PW_TYPE_DEPRECATED, fr_tls_server_conf_t, ca_path), NULL },
1182 { "ca_path", FR_CONF_OFFSET(PW_TYPE_FILE_INPUT, fr_tls_server_conf_t, ca_path), NULL },
1183 { "pem_file_type", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, file_type), "yes" },
1184 { "private_key_file", FR_CONF_OFFSET(PW_TYPE_FILE_INPUT, fr_tls_server_conf_t, private_key_file), NULL },
1185 { "certificate_file", FR_CONF_OFFSET(PW_TYPE_FILE_INPUT, fr_tls_server_conf_t, certificate_file), NULL },
1186 { "CA_file", FR_CONF_OFFSET(PW_TYPE_FILE_INPUT | PW_TYPE_DEPRECATED, fr_tls_server_conf_t, ca_file), NULL },
1187 { "ca_file", FR_CONF_OFFSET(PW_TYPE_FILE_INPUT, fr_tls_server_conf_t, ca_file), NULL },
1188 { "private_key_password", FR_CONF_OFFSET(PW_TYPE_STRING | PW_TYPE_SECRET, fr_tls_server_conf_t, private_key_password), NULL },
1189 #ifdef PSK_MAX_IDENTITY_LEN
1190 { "psk_identity", FR_CONF_OFFSET(PW_TYPE_STRING, fr_tls_server_conf_t, psk_identity), NULL },
1191 { "psk_hexphrase", FR_CONF_OFFSET(PW_TYPE_STRING | PW_TYPE_SECRET, fr_tls_server_conf_t, psk_password), NULL },
1192 { "psk_query", FR_CONF_OFFSET(PW_TYPE_STRING, fr_tls_server_conf_t, psk_query), NULL },
1194 { "dh_file", FR_CONF_OFFSET(PW_TYPE_FILE_INPUT, fr_tls_server_conf_t, dh_file), NULL },
1195 { "random_file", FR_CONF_OFFSET(PW_TYPE_FILE_EXISTS, fr_tls_server_conf_t, random_file), NULL },
1196 { "fragment_size", FR_CONF_OFFSET(PW_TYPE_INTEGER, fr_tls_server_conf_t, fragment_size), "1024" },
1197 { "include_length", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, include_length), "yes" },
1198 { "auto_chain", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, auto_chain), "yes" },
1199 { "disable_single_dh_use", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, disable_single_dh_use), NULL },
1200 { "check_crl", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, check_crl), "no" },
1201 #ifdef X509_V_FLAG_CRL_CHECK_ALL
1202 { "check_all_crl", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, check_all_crl), "no" },
1204 { "allow_expired_crl", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, allow_expired_crl), NULL },
1205 { "check_cert_cn", FR_CONF_OFFSET(PW_TYPE_STRING, fr_tls_server_conf_t, check_cert_cn), NULL },
1206 { "cipher_list", FR_CONF_OFFSET(PW_TYPE_STRING, fr_tls_server_conf_t, cipher_list), NULL },
1207 { "cipher_server_preference", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, cipher_server_preference), NULL },
1208 { "check_cert_issuer", FR_CONF_OFFSET(PW_TYPE_STRING, fr_tls_server_conf_t, check_cert_issuer), NULL },
1209 { "require_client_cert", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, require_client_cert), NULL },
1211 #if OPENSSL_VERSION_NUMBER >= 0x0090800fL
1212 #ifndef OPENSSL_NO_ECDH
1213 { "ecdh_curve", FR_CONF_OFFSET(PW_TYPE_STRING, fr_tls_server_conf_t, ecdh_curve), "prime256v1" },
1217 #ifdef SSL_OP_NO_TLSv1
1218 { "disable_tlsv1", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, disable_tlsv1), NULL },
1221 #ifdef SSL_OP_NO_TLSv1_1
1222 { "disable_tlsv1_1", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, disable_tlsv1_1), NULL },
1225 #ifdef SSL_OP_NO_TLSv1_2
1226 { "disable_tlsv1_2", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, disable_tlsv1_2), NULL },
1229 { "cache", FR_CONF_POINTER(PW_TYPE_SUBSECTION, NULL), (void const *) cache_config },
1231 { "verify", FR_CONF_POINTER(PW_TYPE_SUBSECTION, NULL), (void const *) verify_config },
1233 #ifdef HAVE_OPENSSL_OCSP_H
1234 { "ocsp", FR_CONF_POINTER(PW_TYPE_SUBSECTION, NULL), (void const *) ocsp_config },
1236 CONF_PARSER_TERMINATOR
1240 static CONF_PARSER tls_client_config[] = {
1241 { "verify_depth", FR_CONF_OFFSET(PW_TYPE_INTEGER, fr_tls_server_conf_t, verify_depth), "0" },
1242 { "ca_path", FR_CONF_OFFSET(PW_TYPE_FILE_INPUT, fr_tls_server_conf_t, ca_path), NULL },
1243 { "pem_file_type", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, file_type), "yes" },
1244 { "private_key_file", FR_CONF_OFFSET(PW_TYPE_FILE_INPUT, fr_tls_server_conf_t, private_key_file), NULL },
1245 { "certificate_file", FR_CONF_OFFSET(PW_TYPE_FILE_INPUT, fr_tls_server_conf_t, certificate_file), NULL },
1246 { "ca_file", FR_CONF_OFFSET(PW_TYPE_FILE_INPUT, fr_tls_server_conf_t, ca_file), NULL },
1247 { "private_key_password", FR_CONF_OFFSET(PW_TYPE_STRING | PW_TYPE_SECRET, fr_tls_server_conf_t, private_key_password), NULL },
1248 { "dh_file", FR_CONF_OFFSET(PW_TYPE_STRING, fr_tls_server_conf_t, dh_file), NULL },
1249 { "random_file", FR_CONF_OFFSET(PW_TYPE_STRING, fr_tls_server_conf_t, random_file), NULL },
1250 { "fragment_size", FR_CONF_OFFSET(PW_TYPE_INTEGER, fr_tls_server_conf_t, fragment_size), "1024" },
1251 { "include_length", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, include_length), "yes" },
1252 { "check_crl", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, check_crl), "no" },
1253 { "check_cert_cn", FR_CONF_OFFSET(PW_TYPE_STRING, fr_tls_server_conf_t, check_cert_cn), NULL },
1254 { "cipher_list", FR_CONF_OFFSET(PW_TYPE_STRING, fr_tls_server_conf_t, cipher_list), NULL },
1255 { "check_cert_issuer", FR_CONF_OFFSET(PW_TYPE_STRING, fr_tls_server_conf_t, check_cert_issuer), NULL },
1257 #if OPENSSL_VERSION_NUMBER >= 0x0090800fL
1258 #ifndef OPENSSL_NO_ECDH
1259 { "ecdh_curve", FR_CONF_OFFSET(PW_TYPE_STRING, fr_tls_server_conf_t, ecdh_curve), "prime256v1" },
1263 #ifdef SSL_OP_NO_TLSv1
1264 { "disable_tlsv1", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, disable_tlsv1), NULL },
1267 #ifdef SSL_OP_NO_TLSv1_1
1268 { "disable_tlsv1_1", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, disable_tlsv1_1), NULL },
1271 #ifdef SSL_OP_NO_TLSv1_2
1272 { "disable_tlsv1_2", FR_CONF_OFFSET(PW_TYPE_BOOLEAN, fr_tls_server_conf_t, disable_tlsv1_2), NULL },
1274 CONF_PARSER_TERMINATOR
1279 * TODO: Check for the type of key exchange * like conf->dh_key
1281 static int load_dh_params(SSL_CTX *ctx, char *file)
1286 if (!file) return 0;
1288 if ((bio = BIO_new_file(file, "r")) == NULL) {
1289 ERROR(LOG_PREFIX ": Unable to open DH file - %s", file);
1293 dh = PEM_read_bio_DHparams(bio, NULL, NULL, NULL);
1296 WARN(LOG_PREFIX ": Unable to set DH parameters. DH cipher suites may not work!");
1297 WARN(LOG_PREFIX ": Fix this by running the OpenSSL command listed in eap.conf");
1301 if (SSL_CTX_set_tmp_dh(ctx, dh) < 0) {
1302 ERROR(LOG_PREFIX ": Unable to set DH parameters");
1313 * Print debugging messages, and free data.
1315 static void cbtls_remove_session(SSL_CTX *ctx, SSL_SESSION *sess)
1317 char buffer[2 * MAX_SESSION_SIZE + 1];
1318 fr_tls_server_conf_t *conf;
1320 tls_session_id(sess, buffer, MAX_SESSION_SIZE);
1322 conf = (fr_tls_server_conf_t *)SSL_CTX_get_app_data(ctx);
1324 DEBUG(LOG_PREFIX ": Failed to find TLS configuration in session");
1332 DEBUG2(LOG_PREFIX ": Removing session %s from the cache", buffer);
1334 /* remove session and any cached VPs */
1335 snprintf(filename, sizeof(filename), "%s%c%s.asn1",
1336 conf->session_cache_path, FR_DIR_SEP, buffer);
1337 rv = unlink(filename);
1339 DEBUG2(LOG_PREFIX ": Could not remove persisted session file %s: %s",
1340 filename, fr_syserror(errno));
1342 /* VPs might be absent; might not have been written to disk yet */
1343 snprintf(filename, sizeof(filename), "%s%c%s.vps",
1344 conf->session_cache_path, FR_DIR_SEP, buffer);
1351 static int cbtls_new_session(SSL *ssl, SSL_SESSION *sess)
1353 char buffer[2 * MAX_SESSION_SIZE + 1];
1354 fr_tls_server_conf_t *conf;
1355 unsigned char *sess_blob = NULL;
1357 REQUEST *request = SSL_get_ex_data(ssl, FR_TLS_EX_INDEX_REQUEST);
1359 conf = (fr_tls_server_conf_t *)SSL_get_ex_data(ssl, FR_TLS_EX_INDEX_CONF);
1361 RWDEBUG("Failed to find TLS configuration in session");
1365 tls_session_id(sess, buffer, MAX_SESSION_SIZE);
1368 int fd, rv, todo, blob_len;
1372 RDEBUG2("Serialising session %s, and storing in cache", buffer);
1374 /* find out what length data we need */
1375 blob_len = i2d_SSL_SESSION(sess, NULL);
1377 /* something went wrong */
1378 if (request) RWDEBUG("Session serialisation failed, couldn't determine required buffer length");
1382 /* Do not convert to TALLOC - Thread safety */
1383 /* alloc and convert to ASN.1 */
1384 sess_blob = malloc(blob_len);
1386 RWDEBUG("Session serialisation failed, couldn't allocate buffer (%d bytes)", blob_len);
1389 /* openssl mutates &p */
1391 rv = i2d_SSL_SESSION(sess, &p);
1392 if (rv != blob_len) {
1393 if (request) RWDEBUG("Session serialisation failed");
1397 /* open output file */
1398 snprintf(filename, sizeof(filename), "%s%c%s.asn1",
1399 conf->session_cache_path, FR_DIR_SEP, buffer);
1400 fd = open(filename, O_RDWR|O_CREAT|O_EXCL, S_IWUSR);
1402 if (request) RERROR("Session serialisation failed, failed opening session file %s: %s",
1403 filename, fr_syserror(errno));
1408 * Set the filename to be temporarily write-only.
1413 vp = fr_pair_afrom_num(request->state_ctx, PW_TLS_CACHE_FILENAME, 0);
1415 fr_pair_value_strcpy(vp, filename);
1416 fr_pair_add(&request->state, vp);
1423 rv = write(fd, p, todo);
1425 if (request) RWDEBUG("Failed writing session: %s", fr_syserror(errno));
1433 if (request) RWDEBUG("Wrote session %s to %s (%d bytes)", buffer, filename, blob_len);
1442 /** Convert OpenSSL's ASN1_TIME to an epoch time
1444 * @param[out] out Where to write the time_t.
1445 * @param[in] asn1 The ASN1_TIME to convert.
1450 static int ocsp_asn1time_to_epoch(time_t *out, char const *asn1)
1453 char const *p = asn1, *end = p + strlen(p);
1455 memset(&t, 0, sizeof(t));
1457 if ((end - p) <= 12) {
1458 if ((end - p) < 2) {
1459 fr_strerror_printf("ASN1 date string too short, expected 2 additional bytes, got %zu bytes",
1464 t.tm_year = (*(p++) - '0') * 10;
1465 t.tm_year += (*(p++) - '0');
1466 if (t.tm_year < 70) t.tm_year += 100;
1468 t.tm_year = (*(p++) - '0') * 1000;
1469 t.tm_year += (*(p++) - '0') * 100;
1470 t.tm_year += (*(p++) - '0') * 10;
1471 t.tm_year += (*(p++) - '0');
1475 if ((end - p) < 4) {
1476 fr_strerror_printf("ASN1 string too short, expected 10 additional bytes, got %zu bytes",
1481 t.tm_mon = (*(p++) - '0') * 10;
1482 t.tm_mon += (*(p++) - '0') - 1; // -1 since January is 0 not 1.
1483 t.tm_mday = (*(p++) - '0') * 10;
1484 t.tm_mday += (*(p++) - '0');
1486 if ((end - p) < 2) goto done;
1487 t.tm_hour = (*(p++) - '0') * 10;
1488 t.tm_hour += (*(p++) - '0');
1490 if ((end - p) < 2) goto done;
1491 t.tm_min = (*(p++) - '0') * 10;
1492 t.tm_min += (*(p++) - '0');
1494 if ((end - p) < 2) goto done;
1495 t.tm_sec = (*(p++) - '0') * 10;
1496 t.tm_sec += (*(p++) - '0');
1498 /* Apparently OpenSSL converts all timestamps to UTC? Maybe? */
1504 #if OPENSSL_VERSION_NUMBER < 0x10100000L || defined(LIBRESSL_VERSION_NUMBER)
1505 static SSL_SESSION *cbtls_get_session(SSL *ssl, unsigned char *data, int len, int *copy)
1507 static SSL_SESSION *cbtls_get_session(SSL *ssl, const unsigned char *data, int len, int *copy)
1511 char buffer[2 * MAX_SESSION_SIZE + 1];
1512 fr_tls_server_conf_t *conf;
1513 TALLOC_CTX *talloc_ctx;
1515 SSL_SESSION *sess = NULL;
1516 unsigned char *sess_data = NULL;
1517 PAIR_LIST *pairlist = NULL;
1519 REQUEST *request = SSL_get_ex_data(ssl, FR_TLS_EX_INDEX_REQUEST);
1521 rad_assert(request != NULL);
1524 if (size > MAX_SESSION_SIZE) size = MAX_SESSION_SIZE;
1526 fr_bin2hex(buffer, data, size);
1528 RDEBUG2("Peer requested cached session: %s", buffer);
1532 conf = (fr_tls_server_conf_t *)SSL_get_ex_data(ssl, FR_TLS_EX_INDEX_CONF);
1534 RWDEBUG("Failed to find TLS configuration in session");
1538 talloc_ctx = SSL_get_ex_data(ssl, FR_TLS_EX_INDEX_TALLOC);
1544 unsigned char const **o;
1549 VALUE_PAIR *vps = NULL;
1552 /* load the actual SSL session */
1553 snprintf(filename, sizeof(filename), "%s%c%s.asn1", conf->session_cache_path, FR_DIR_SEP, buffer);
1554 fd = open(filename, O_RDONLY);
1556 RWDEBUG("No persisted session file %s: %s", filename, fr_syserror(errno));
1560 rv = fstat(fd, &st);
1562 RWDEBUG("Failed stating persisted session file %s: %s", filename, fr_syserror(errno));
1567 sess_data = talloc_array(NULL, unsigned char, st.st_size);
1569 RWDEBUG("Failed allocating buffer for persisted session (%d bytes)", (int) st.st_size);
1577 rv = read(fd, q, todo);
1579 RWDEBUG("Failed reading persisted session: %s", fr_syserror(errno));
1589 * OpenSSL mutates what's passed in, so we assign sess_data to q,
1590 * so the value of q gets mutated, and not the value of sess_data.
1592 * We then need a pointer to hold &q, but it can't be const, because
1593 * clang complains about lack of consting in nested pointer types.
1595 * So we memcpy the value of that pointer, to one that
1596 * does have a const, which we then pass into d2i_SSL_SESSION *sigh*.
1600 memcpy(&o, &p, sizeof(o));
1601 sess = d2i_SSL_SESSION(NULL, o, st.st_size);
1603 RWDEBUG("Failed loading persisted session: %s", ERR_error_string(ERR_get_error(), NULL));
1607 /* read in the cached VPs from the .vps file */
1608 snprintf(filename, sizeof(filename), "%s%c%s.vps",
1609 conf->session_cache_path, FR_DIR_SEP, buffer);
1610 rv = pairlist_read(talloc_ctx, filename, &pairlist, 1);
1612 /* not safe to un-persist a session w/o VPs */
1613 RWDEBUG("Failed loading persisted VPs for session %s", buffer);
1614 SSL_SESSION_free(sess);
1620 * Enforce client certificate expiration.
1622 vp = fr_pair_find_by_num(pairlist->reply, PW_TLS_CLIENT_CERT_EXPIRATION, 0, TAG_ANY);
1626 if (ocsp_asn1time_to_epoch(&expires, vp->vp_strvalue) < 0) {
1627 RDEBUG2("Failed getting certificate expiration, removing cache entry for session %s - %s", buffer, fr_strerror());
1628 SSL_SESSION_free(sess);
1633 if (expires <= request->timestamp) {
1634 RDEBUG2("Certificate has expired, removing cache entry for session %s", buffer);
1635 SSL_SESSION_free(sess);
1641 * Account for Session-Timeout, if it's available.
1643 vp = fr_pair_find_by_num(request->reply->vps, PW_SESSION_TIMEOUT, 0, TAG_ANY);
1645 if ((request->timestamp + vp->vp_integer) > expires) {
1646 vp->vp_integer = expires - request->timestamp;
1647 RWDEBUG2("Updating Session-Timeout to %u, due to impending certificate expiration",
1653 /* move the cached VPs into the session */
1654 fr_pair_list_mcopy_by_num(talloc_ctx, &vps, &pairlist->reply, 0, 0, TAG_ANY);
1656 SSL_SESSION_set_ex_data(sess, fr_tls_ex_index_vps, vps);
1657 RWDEBUG("Successfully restored session %s", buffer);
1658 rdebug_pair_list(L_DBG_LVL_2, request, vps, "reply:");
1661 if (sess_data) talloc_free(sess_data);
1662 if (pairlist) pairlist_free(&pairlist);
1667 #ifdef HAVE_OPENSSL_OCSP_H
1669 /** Extract components of OCSP responser URL from a certificate
1671 * @param[in] cert to extract URL from.
1672 * @param[out] host_out Portion of the URL (must be freed with free()).
1673 * @param[out] port_out Port portion of the URL (must be freed with free()).
1674 * @param[out] path_out Path portion of the URL (must be freed with free()).
1675 * @param[out] is_https Whether the responder should be contacted using https.
1677 * - 0 if no valid URL is contained in the certificate.
1678 * - 1 if a URL was found and parsed.
1679 * - -1 if at least one URL was found, but none could be parsed.
1681 static int ocsp_parse_cert_url(X509 *cert, char **host_out, char **port_out,
1682 char **path_out, int *is_https)
1685 bool found_uri = false;
1687 AUTHORITY_INFO_ACCESS *aia;
1688 ACCESS_DESCRIPTION *ad;
1690 aia = X509_get_ext_d2i(cert, NID_info_access, NULL, NULL);
1692 for (i = 0; i < sk_ACCESS_DESCRIPTION_num(aia); i++) {
1693 ad = sk_ACCESS_DESCRIPTION_value(aia, i);
1694 if (OBJ_obj2nid(ad->method) != NID_ad_OCSP) continue;
1695 if (ad->location->type != GEN_URI) continue;
1698 if (OCSP_parse_url((char *) ad->location->d.ia5->data, host_out,
1699 port_out, path_out, is_https)) return 1;
1701 return found_uri ? -1 : 0;
1705 * This function sends a OCSP request to a defined OCSP responder
1706 * and checks the OCSP response for correctness.
1709 /* Maximum leeway in validity period: default 5 minutes */
1710 #define MAX_VALIDITY_PERIOD (5 * 60)
1713 OCSP_STATUS_FAILED = 0,
1715 OCSP_STATUS_SKIPPED = 2,
1718 static ocsp_status_t ocsp_check(REQUEST *request, X509_STORE *store, X509 *issuer_cert, X509 *client_cert,
1719 fr_tls_server_conf_t *conf)
1721 OCSP_CERTID *certid;
1723 OCSP_RESPONSE *resp = NULL;
1724 OCSP_BASICRESP *bresp = NULL;
1728 char hostheader[1024];
1730 long nsec = MAX_VALIDITY_PERIOD, maxage = -1;
1731 BIO *cbio, *bio_out;
1732 ocsp_status_t ocsp_status = OCSP_STATUS_FAILED;
1734 ASN1_GENERALIZEDTIME *rev, *thisupd, *nextupd;
1736 #if OPENSSL_VERSION_NUMBER >= 0x1000003f
1740 struct timeval when;
1745 * Create OCSP Request
1747 certid = OCSP_cert_to_id(NULL, client_cert, issuer_cert);
1748 req = OCSP_REQUEST_new();
1749 OCSP_request_add0_id(req, certid);
1750 if (conf->ocsp_use_nonce) OCSP_request_add1_nonce(req, NULL, 8);
1753 * Send OCSP Request and get OCSP Response
1756 /* Get OCSP responder URL */
1757 if (conf->ocsp_override_url) {
1761 memcpy(&url, &conf->ocsp_url, sizeof(url));
1762 /* Reading the libssl src, they do a strdup on the URL, so it could of been const *sigh* */
1763 OCSP_parse_url(url, &host, &port, &path, &use_ssl);
1764 if (!host || !port || !path) {
1765 RWDEBUG("ocsp: Host or port or path missing from configured URL \"%s\". Not doing OCSP", url);
1771 ret = ocsp_parse_cert_url(client_cert, &host, &port, &path, &use_ssl);
1774 RWDEBUG("ocsp: Invalid URL in certificate. Not doing OCSP");
1778 if (conf->ocsp_url) {
1779 RWDEBUG("ocsp: No OCSP URL in certificate, falling back to configured URL");
1782 RWDEBUG("ocsp: No OCSP URL in certificate. Not doing OCSP");
1790 RDEBUG2("ocsp: Using responder URL \"http://%s:%s%s\"", host, port, path);
1792 /* Check host and port length are sane, then create Host: HTTP header */
1793 if ((strlen(host) + strlen(port) + 2) > sizeof(hostheader)) {
1794 RWDEBUG("ocsp: Host and port too long");
1797 snprintf(hostheader, sizeof(hostheader), "%s:%s", host, port);
1799 /* Setup BIO socket to OCSP responder */
1800 cbio = BIO_new_connect(host);
1803 if (rad_debug_lvl) {
1804 if (default_log.dst == L_DST_STDOUT) {
1805 bio_out = BIO_new_fp(stdout, BIO_NOCLOSE);
1806 } else if (default_log.dst == L_DST_STDERR) {
1807 bio_out = BIO_new_fp(stderr, BIO_NOCLOSE);
1811 BIO_set_conn_port(cbio, port);
1812 #if OPENSSL_VERSION_NUMBER < 0x1000003f
1813 BIO_do_connect(cbio);
1815 /* Send OCSP request and wait for response */
1816 resp = OCSP_sendreq_bio(cbio, path, req);
1818 REDEBUG("ocsp: Couldn't get OCSP response");
1819 ocsp_status = OCSP_STATUS_SKIPPED;
1823 if (conf->ocsp_timeout)
1824 BIO_set_nbio(cbio, 1);
1826 rc = BIO_do_connect(cbio);
1827 if ((rc <= 0) && ((!conf->ocsp_timeout) || !BIO_should_retry(cbio))) {
1828 REDEBUG("ocsp: Couldn't connect to OCSP responder");
1829 ocsp_status = OCSP_STATUS_SKIPPED;
1833 ctx = OCSP_sendreq_new(cbio, path, NULL, -1);
1835 REDEBUG("ocsp: Couldn't create OCSP request");
1836 ocsp_status = OCSP_STATUS_SKIPPED;
1840 if (!OCSP_REQ_CTX_add1_header(ctx, "Host", hostheader)) {
1841 REDEBUG("ocsp: Couldn't set Host header");
1842 ocsp_status = OCSP_STATUS_SKIPPED;
1846 if (!OCSP_REQ_CTX_set1_req(ctx, req)) {
1847 REDEBUG("ocsp: Couldn't add data to OCSP request");
1848 ocsp_status = OCSP_STATUS_SKIPPED;
1852 gettimeofday(&when, NULL);
1853 when.tv_sec += conf->ocsp_timeout;
1856 rc = OCSP_sendreq_nbio(&resp, ctx);
1857 if (conf->ocsp_timeout) {
1858 gettimeofday(&now, NULL);
1859 if (!timercmp(&now, &when, <))
1862 } while ((rc == -1) && BIO_should_retry(cbio));
1864 if (conf->ocsp_timeout && (rc == -1) && BIO_should_retry(cbio)) {
1865 REDEBUG("ocsp: Response timed out");
1866 ocsp_status = OCSP_STATUS_SKIPPED;
1870 OCSP_REQ_CTX_free(ctx);
1873 REDEBUG("ocsp: Couldn't get OCSP response");
1874 ocsp_status = OCSP_STATUS_SKIPPED;
1879 /* Verify OCSP response status */
1880 status = OCSP_response_status(resp);
1881 if (status != OCSP_RESPONSE_STATUS_SUCCESSFUL) {
1882 REDEBUG("ocsp: Response status: %s", OCSP_response_status_str(status));
1885 bresp = OCSP_response_get1_basic(resp);
1886 if (conf->ocsp_use_nonce && OCSP_check_nonce(req, bresp)!=1) {
1887 REDEBUG("ocsp: Response has wrong nonce value");
1890 if (OCSP_basic_verify(bresp, NULL, store, 0)!=1){
1891 REDEBUG("ocsp: Couldn't verify OCSP basic response");
1895 /* Verify OCSP cert status */
1896 if (!OCSP_resp_find_status(bresp, certid, &status, &reason, &rev, &thisupd, &nextupd)) {
1897 REDEBUG("ocsp: No Status found");
1901 if (!OCSP_check_validity(thisupd, nextupd, nsec, maxage)) {
1903 BIO_puts(bio_out, "WARNING: Status times invalid.\n");
1904 ERR_print_errors(bio_out);
1910 BIO_puts(bio_out, "\tThis Update: ");
1911 ASN1_GENERALIZEDTIME_print(bio_out, thisupd);
1912 BIO_puts(bio_out, "\n");
1914 BIO_puts(bio_out, "\tNext Update: ");
1915 ASN1_GENERALIZEDTIME_print(bio_out, nextupd);
1916 BIO_puts(bio_out, "\n");
1921 case V_OCSP_CERTSTATUS_GOOD:
1922 RDEBUG2("ocsp: Cert status: good");
1923 vp = pair_make_request("TLS-OCSP-Cert-Valid", NULL, T_OP_SET);
1924 vp->vp_integer = 1; /* yes */
1925 ocsp_status = OCSP_STATUS_OK;
1929 /* REVOKED / UNKNOWN */
1930 REDEBUG("ocsp: Cert status: %s", OCSP_cert_status_str(status));
1931 if (reason != -1) REDEBUG("ocsp: Reason: %s", OCSP_crl_reason_str(reason));
1934 BIO_puts(bio_out, "\tRevocation Time: ");
1935 ASN1_GENERALIZEDTIME_print(bio_out, rev);
1936 BIO_puts(bio_out, "\n");
1942 /* Free OCSP Stuff */
1943 OCSP_REQUEST_free(req);
1944 OCSP_RESPONSE_free(resp);
1949 if (bio_out) BIO_free(bio_out);
1950 OCSP_BASICRESP_free(bresp);
1952 switch (ocsp_status) {
1953 case OCSP_STATUS_OK:
1954 RDEBUG2("ocsp: Certificate is valid");
1957 case OCSP_STATUS_SKIPPED:
1959 vp = pair_make_request("TLS-OCSP-Cert-Valid", NULL, T_OP_SET);
1960 vp->vp_integer = 2; /* skipped */
1961 if (conf->ocsp_softfail) {
1962 RWDEBUG("ocsp: Unable to check certificate, assuming it's valid");
1963 RWDEBUG("ocsp: This may be insecure");
1965 /* Remove OpenSSL errors from queue or handshake will fail */
1966 while (ERR_get_error());
1968 ocsp_status = OCSP_STATUS_SKIPPED;
1970 REDEBUG("ocsp: Unable to check certificate, failing");
1971 ocsp_status = OCSP_STATUS_FAILED;
1976 vp = pair_make_request("TLS-OCSP-Cert-Valid", NULL, T_OP_SET);
1977 vp->vp_integer = 0; /* no */
1978 REDEBUG("ocsp: Certificate has been expired/revoked");
1984 #endif /* HAVE_OPENSSL_OCSP_H */
1987 * For creating certificate attributes.
1989 static char const *cert_attr_names[8][2] = {
1990 { "TLS-Client-Cert-Serial", "TLS-Cert-Serial" },
1991 { "TLS-Client-Cert-Expiration", "TLS-Cert-Expiration" },
1992 { "TLS-Client-Cert-Subject", "TLS-Cert-Subject" },
1993 { "TLS-Client-Cert-Issuer", "TLS-Cert-Issuer" },
1994 { "TLS-Client-Cert-Common-Name", "TLS-Cert-Common-Name" },
1995 { "TLS-Client-Cert-Subject-Alt-Name-Email", "TLS-Cert-Subject-Alt-Name-Email" },
1996 { "TLS-Client-Cert-Subject-Alt-Name-Dns", "TLS-Cert-Subject-Alt-Name-Dns" },
1997 { "TLS-Client-Cert-Subject-Alt-Name-Upn", "TLS-Cert-Subject-Alt-Name-Upn" }
2000 #define FR_TLS_SERIAL (0)
2001 #define FR_TLS_EXPIRATION (1)
2002 #define FR_TLS_SUBJECT (2)
2003 #define FR_TLS_ISSUER (3)
2004 #define FR_TLS_CN (4)
2005 #define FR_TLS_SAN_EMAIL (5)
2006 #define FR_TLS_SAN_DNS (6)
2007 #define FR_TLS_SAN_UPN (7)
2010 * Before trusting a certificate, you must make sure that the
2011 * certificate is 'valid'. There are several steps that your
2012 * application can take in determining if a certificate is
2013 * valid. Commonly used steps are:
2015 * 1.Verifying the certificate's signature, and verifying that
2016 * the certificate has been issued by a trusted Certificate
2019 * 2.Verifying that the certificate is valid for the present date
2020 * (i.e. it is being presented within its validity dates).
2022 * 3.Verifying that the certificate has not been revoked by its
2023 * issuing Certificate Authority, by checking with respect to a
2024 * Certificate Revocation List (CRL).
2026 * 4.Verifying that the credentials presented by the certificate
2027 * fulfill additional requirements specific to the application,
2028 * such as with respect to access control lists or with respect
2029 * to OCSP (Online Certificate Status Processing).
2031 * NOTE: This callback will be called multiple times based on the
2032 * depth of the root certificate chain
2034 int cbtls_verify(int ok, X509_STORE_CTX *ctx)
2036 char subject[1024]; /* Used for the subject name */
2037 char issuer[1024]; /* Used for the issuer name */
2038 char attribute[1024];
2040 char common_name[1024];
2044 #if OPENSSL_VERSION_NUMBER >= 0x10100000L && !defined(LIBRESSL_VERSION_NUMBER)
2045 const STACK_OF(X509_EXTENSION) *ext_list;
2047 STACK_OF(X509_EXTENSION) *ext_list;
2050 int err, depth, lookup, loc;
2051 fr_tls_server_conf_t *conf;
2054 ASN1_INTEGER *sn = NULL;
2055 ASN1_TIME *asn_time = NULL;
2058 #ifdef HAVE_OPENSSL_OCSP_H
2059 X509_STORE *ocsp_store = NULL;
2061 bool do_verify = false;
2064 TALLOC_CTX *talloc_ctx;
2068 client_cert = X509_STORE_CTX_get_current_cert(ctx);
2069 err = X509_STORE_CTX_get_error(ctx);
2070 depth = X509_STORE_CTX_get_error_depth(ctx);
2075 * Log client/issuing cert. If there's an error, log
2078 if ((lookup > 1) && !my_ok) lookup = 1;
2081 * Retrieve the pointer to the SSL of the connection currently treated
2082 * and the application specific data stored into the SSL object.
2084 ssl = X509_STORE_CTX_get_ex_data(ctx, SSL_get_ex_data_X509_STORE_CTX_idx());
2085 conf = (fr_tls_server_conf_t *)SSL_get_ex_data(ssl, FR_TLS_EX_INDEX_CONF);
2086 if (!conf) return 1;
2088 request = (REQUEST *)SSL_get_ex_data(ssl, FR_TLS_EX_INDEX_REQUEST);
2089 rad_assert(request != NULL);
2090 certs = (VALUE_PAIR **)SSL_get_ex_data(ssl, fr_tls_ex_index_certs);
2092 identity = (char **)SSL_get_ex_data(ssl, FR_TLS_EX_INDEX_IDENTITY);
2093 #ifdef HAVE_OPENSSL_OCSP_H
2094 ocsp_store = conf->ocsp_store;
2097 talloc_ctx = SSL_get_ex_data(ssl, FR_TLS_EX_INDEX_TALLOC);
2100 * Get the Serial Number
2103 sn = X509_get_serialNumber(client_cert);
2105 RDEBUG2("Creating attributes from certificate OIDs");
2109 * For this next bit, we create the attributes *only* if
2110 * we're at the client or issuing certificate, AND we
2111 * have a user identity. i.e. we don't create the
2112 * attributes for RadSec connections.
2114 if (certs && identity &&
2115 (lookup <= 1) && sn && ((size_t) sn->length < (sizeof(buf) / 2))) {
2119 for (i = 0; i < sn->length; i++) {
2120 sprintf(p, "%02x", (unsigned int)sn->data[i]);
2123 vp = fr_pair_make(talloc_ctx, certs, cert_attr_names[FR_TLS_SERIAL][lookup], buf, T_OP_SET);
2124 rdebug_pair(L_DBG_LVL_2, request, vp, NULL);
2129 * Get the Expiration Date
2132 asn_time = X509_get_notAfter(client_cert);
2133 if (certs && identity && (lookup <= 1) && asn_time &&
2134 (asn_time->length < (int) sizeof(buf))) {
2135 memcpy(buf, (char*) asn_time->data, asn_time->length);
2136 buf[asn_time->length] = '\0';
2137 vp = fr_pair_make(talloc_ctx, certs, cert_attr_names[FR_TLS_EXPIRATION][lookup], buf, T_OP_SET);
2138 rdebug_pair(L_DBG_LVL_2, request, vp, NULL);
2142 * Get the Subject & Issuer
2144 subject[0] = issuer[0] = '\0';
2145 X509_NAME_oneline(X509_get_subject_name(client_cert), subject,
2147 subject[sizeof(subject) - 1] = '\0';
2148 if (certs && identity && (lookup <= 1) && subject[0]) {
2149 vp = fr_pair_make(talloc_ctx, certs, cert_attr_names[FR_TLS_SUBJECT][lookup], subject, T_OP_SET);
2150 rdebug_pair(L_DBG_LVL_2, request, vp, NULL);
2153 X509_NAME_oneline(X509_get_issuer_name(client_cert), issuer,
2155 issuer[sizeof(issuer) - 1] = '\0';
2156 if (certs && identity && (lookup <= 1) && issuer[0]) {
2157 vp = fr_pair_make(talloc_ctx, certs, cert_attr_names[FR_TLS_ISSUER][lookup], issuer, T_OP_SET);
2158 rdebug_pair(L_DBG_LVL_2, request, vp, NULL);
2162 * Get the Common Name, if there is a subject.
2164 X509_NAME_get_text_by_NID(X509_get_subject_name(client_cert),
2165 NID_commonName, common_name, sizeof(common_name));
2166 common_name[sizeof(common_name) - 1] = '\0';
2167 if (certs && identity && (lookup <= 1) && common_name[0] && subject[0]) {
2168 vp = fr_pair_make(talloc_ctx, certs, cert_attr_names[FR_TLS_CN][lookup], common_name, T_OP_SET);
2169 rdebug_pair(L_DBG_LVL_2, request, vp, NULL);
2173 * Get the RFC822 Subject Alternative Name
2175 loc = X509_get_ext_by_NID(client_cert, NID_subject_alt_name, -1);
2176 if (certs && (lookup <= 1) && (loc >= 0)) {
2177 X509_EXTENSION *ext = NULL;
2178 GENERAL_NAMES *names = NULL;
2181 if ((ext = X509_get_ext(client_cert, loc)) &&
2182 (names = X509V3_EXT_d2i(ext))) {
2183 for (i = 0; i < sk_GENERAL_NAME_num(names); i++) {
2184 GENERAL_NAME *name = sk_GENERAL_NAME_value(names, i);
2186 switch (name->type) {
2189 vp = fr_pair_make(talloc_ctx, certs, cert_attr_names[FR_TLS_SAN_EMAIL][lookup],
2190 (char const *) ASN1_STRING_get0_data(name->d.rfc822Name), T_OP_SET);
2191 rdebug_pair(L_DBG_LVL_2, request, vp, NULL);
2193 #endif /* GEN_EMAIL */
2196 vp = fr_pair_make(talloc_ctx, certs, cert_attr_names[FR_TLS_SAN_DNS][lookup],
2197 (char const *) ASN1_STRING_get0_data(name->d.dNSName), T_OP_SET);
2198 rdebug_pair(L_DBG_LVL_2, request, vp, NULL);
2200 #endif /* GEN_DNS */
2201 #ifdef GEN_OTHERNAME
2203 /* look for a MS UPN */
2204 if (NID_ms_upn == OBJ_obj2nid(name->d.otherName->type_id)) {
2205 /* we've got a UPN - Must be ASN1-encoded UTF8 string */
2206 if (name->d.otherName->value->type == V_ASN1_UTF8STRING) {
2207 vp = fr_pair_make(talloc_ctx, certs, cert_attr_names[FR_TLS_SAN_UPN][lookup],
2208 (char const *) ASN1_STRING_get0_data(name->d.otherName->value->value.utf8string), T_OP_SET);
2209 rdebug_pair(L_DBG_LVL_2, request, vp, NULL);
2212 RWARN("Invalid UPN in Subject Alt Name (should be UTF-8)");
2217 #endif /* GEN_OTHERNAME */
2219 /* XXX TODO handle other SAN types */
2225 GENERAL_NAMES_free(names);
2229 * If the CRL has expired, that might still be OK.
2232 (conf->allow_expired_crl) &&
2233 (err == X509_V_ERR_CRL_HAS_EXPIRED)) {
2235 X509_STORE_CTX_set_error( ctx, 0 );
2239 char const *p = X509_verify_cert_error_string(err);
2240 RERROR("SSL says error %d : %s", err, p);
2246 #if OPENSSL_VERSION_NUMBER >= 0x10100000L && !defined(LIBRESSL_VERSION_NUMBER)
2247 ext_list = X509_get0_extensions(client_cert);
2249 X509_CINF *client_inf;
2250 client_inf = client_cert->cert_info;
2251 ext_list = client_inf->extensions;
2258 * Grab the X509 extensions, and create attributes out of them.
2259 * For laziness, we re-use the OpenSSL names
2261 if (certs && (sk_X509_EXTENSION_num(ext_list) > 0)) {
2266 out = BIO_new(BIO_s_mem());
2267 strlcpy(attribute, "TLS-Client-Cert-", sizeof(attribute));
2269 for (i = 0; i < sk_X509_EXTENSION_num(ext_list); i++) {
2271 X509_EXTENSION *ext;
2273 ext = sk_X509_EXTENSION_value(ext_list, i);
2275 obj = X509_EXTENSION_get_object(ext);
2276 i2a_ASN1_OBJECT(out, obj);
2277 len = BIO_read(out, attribute + 16 , sizeof(attribute) - 16 - 1);
2278 if (len <= 0) continue;
2280 attribute[16 + len] = '\0';
2282 for (p = attribute + 16; *p != '\0'; p++) {
2283 if (*p == ' ') *p = '-';
2286 X509V3_EXT_print(out, ext, 0, 0);
2287 len = BIO_read(out, value , sizeof(value) - 1);
2288 if (len <= 0) continue;
2292 vp = fr_pair_make(talloc_ctx, certs, attribute, value, T_OP_ADD);
2294 RDEBUG3("Skipping %s += '%s'. Please check that both the "
2295 "attribute and value are defined in the dictionaries",
2299 * rdebug_pair_list indents (so pre REXDENT())
2302 rdebug_pair_list(L_DBG_LVL_2, request, vp, NULL);
2312 switch (X509_STORE_CTX_get_error(ctx)) {
2313 case X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT:
2314 RERROR("issuer=%s", issuer);
2317 case X509_V_ERR_CERT_NOT_YET_VALID:
2318 case X509_V_ERR_ERROR_IN_CERT_NOT_BEFORE_FIELD:
2319 RERROR("notBefore=");
2321 ASN1_TIME_print(bio_err, X509_get_notBefore(ctx->current_cert));
2325 case X509_V_ERR_CERT_HAS_EXPIRED:
2326 case X509_V_ERR_ERROR_IN_CERT_NOT_AFTER_FIELD:
2327 RERROR("notAfter=");
2329 ASN1_TIME_print(bio_err, X509_get_notAfter(ctx->current_cert));
2335 * If we're at the actual client cert, apply additional
2340 * If the conf tells us to, check cert issuer
2341 * against the specified value and fail
2342 * verification if they don't match.
2344 if (conf->check_cert_issuer &&
2345 (strcmp(issuer, conf->check_cert_issuer) != 0)) {
2346 AUTH(LOG_PREFIX ": Certificate issuer (%s) does not match specified value (%s)!",
2347 issuer, conf->check_cert_issuer);
2352 * If the conf tells us to, check the CN in the
2353 * cert against xlat'ed value, but only if the
2354 * previous checks passed.
2356 if (my_ok && conf->check_cert_cn) {
2357 if (radius_xlat(cn_str, sizeof(cn_str), request, conf->check_cert_cn, NULL, NULL) < 0) {
2358 /* if this fails, fail the verification */
2361 RDEBUG2("checking certificate CN (%s) with xlat'ed value (%s)", common_name, cn_str);
2362 if (strcmp(cn_str, common_name) != 0) {
2363 AUTH(LOG_PREFIX ": Certificate CN (%s) does not match specified value (%s)!",
2364 common_name, cn_str);
2368 } /* check_cert_cn */
2370 #ifdef HAVE_OPENSSL_OCSP_H
2373 * No OCSP, allow external verification.
2375 if (!conf->ocsp_enable) {
2379 RDEBUG2("Starting OCSP Request");
2380 if ((X509_STORE_CTX_get1_issuer(&issuer_cert, ctx, client_cert) != 1) ||
2383 * Allow for external verify.
2385 RERROR("Couldn't get issuer_cert for %s", common_name);
2390 * Do the full OCSP checks.
2392 * If they fail, don't run the external verify. We don't want
2393 * to allow admins to force authentication success for bad
2396 * If the OCSP checks succeed, check whether we still want to
2397 * run the external verification routine. If it's marked as
2398 * "skip verify on OK", then we don't do verify.
2400 my_ok = ocsp_check(request, ocsp_store, issuer_cert, client_cert, conf);
2401 if (my_ok != OCSP_STATUS_FAILED) {
2402 do_verify = !conf->verify_skip_if_ocsp_ok;
2409 if ((my_ok != OCSP_STATUS_FAILED)
2410 #ifdef HAVE_OPENSSL_OCSP_H
2413 ) while (conf->verify_client_cert_cmd) {
2418 snprintf(filename, sizeof(filename), "%s/%s.client.XXXXXXXX",
2419 conf->verify_tmp_dir, main_config.name);
2420 fd = mkstemp(filename);
2422 RDEBUG("Failed creating file in %s: %s",
2423 conf->verify_tmp_dir, fr_syserror(errno));
2427 fp = fdopen(fd, "w");
2430 RDEBUG("Failed opening file %s: %s",
2431 filename, fr_syserror(errno));
2435 if (!PEM_write_X509(fp, client_cert)) {
2437 RDEBUG("Failed writing certificate to file");
2442 if (!pair_make_request("TLS-Client-Cert-Filename",
2443 filename, T_OP_SET)) {
2444 RDEBUG("Failed creating TLS-Client-Cert-Filename");
2449 RDEBUG("Verifying client certificate: %s", conf->verify_client_cert_cmd);
2450 if (radius_exec_program(request, NULL, 0, NULL, request, conf->verify_client_cert_cmd,
2451 request->packet->vps,
2452 true, true, EXEC_TIMEOUT) != 0) {
2453 AUTH(LOG_PREFIX ": Certificate CN (%s) fails external verification!", common_name);
2456 } else if (request) {
2457 RDEBUG("Client certificate CN %s passed external validation", common_name);
2466 if (certs && request && !my_ok) {
2467 fr_pair_add(&request->packet->vps, fr_pair_list_copy(request->packet, *certs));
2470 if (RDEBUG_ENABLED3) {
2471 RDEBUG3("chain-depth : %d", depth);
2472 RDEBUG3("error : %d", err);
2474 if (identity) RDEBUG3("identity : %s", *identity);
2475 RDEBUG3("common name : %s", common_name);
2476 RDEBUG3("subject : %s", subject);
2477 RDEBUG3("issuer : %s", issuer);
2478 RDEBUG3("verify return : %d", my_ok);
2481 return (my_ok != 0);
2485 #ifdef HAVE_OPENSSL_OCSP_H
2487 * Create Global X509 revocation store and use it to verify
2490 * - Load the trusted CAs
2491 * - Load the trusted issuer certificates
2493 static X509_STORE *init_revocation_store(fr_tls_server_conf_t *conf)
2495 X509_STORE *store = NULL;
2497 store = X509_STORE_new();
2499 /* Load the CAs we trust */
2500 if (conf->ca_file || conf->ca_path)
2501 if (!X509_STORE_load_locations(store, conf->ca_file, conf->ca_path)) {
2502 tls_error_log(NULL, "Error reading Trusted root CA list \"%s\"", conf->ca_file);
2506 #ifdef X509_V_FLAG_CRL_CHECK
2507 if (conf->check_crl)
2508 X509_STORE_set_flags(store, X509_V_FLAG_CRL_CHECK);
2510 #ifdef X509_V_FLAG_CRL_CHECK_ALL
2511 if (conf->check_all_crl)
2512 X509_STORE_set_flags(store, X509_V_FLAG_CRL_CHECK_ALL);
2516 #endif /* HAVE_OPENSSL_OCSP_H */
2518 #if OPENSSL_VERSION_NUMBER >= 0x0090800fL
2519 #ifndef OPENSSL_NO_ECDH
2520 static int set_ecdh_curve(SSL_CTX *ctx, char const *ecdh_curve, bool disable_single_dh_use)
2525 if (!ecdh_curve || !*ecdh_curve) return 0;
2527 nid = OBJ_sn2nid(ecdh_curve);
2529 ERROR(LOG_PREFIX ": Unknown ecdh_curve \"%s\"", ecdh_curve);
2533 ecdh = EC_KEY_new_by_curve_name(nid);
2535 ERROR(LOG_PREFIX ": Unable to create new curve \"%s\"", ecdh_curve);
2539 SSL_CTX_set_tmp_ecdh(ctx, ecdh);
2541 if (!disable_single_dh_use) {
2542 SSL_CTX_set_options(ctx, SSL_OP_SINGLE_ECDH_USE);
2553 * DIE OPENSSL DIE DIE DIE
2555 * What a palaver, just to free some data attached the
2556 * session. We need to do this because the "remove" callback
2557 * is called when refcount > 0 sometimes, if another thread
2558 * is using the session
2560 static void sess_free_vps(UNUSED void *parent, void *data_ptr,
2561 UNUSED CRYPTO_EX_DATA *ad, UNUSED int idx,
2562 UNUSED long argl, UNUSED void *argp)
2564 VALUE_PAIR *vp = data_ptr;
2567 DEBUG2(LOG_PREFIX ": Freeing cached session VPs");
2569 fr_pair_list_free(&vp);
2572 static void sess_free_certs(UNUSED void *parent, void *data_ptr,
2573 UNUSED CRYPTO_EX_DATA *ad, UNUSED int idx,
2574 UNUSED long argl, UNUSED void *argp)
2576 VALUE_PAIR **certs = data_ptr;
2579 DEBUG2(LOG_PREFIX ": Freeing cached session Certificates");
2581 fr_pair_list_free(certs);
2584 /** Add all the default ciphers and message digests reate our context.
2586 * This should be called exactly once from main, before reading the main config
2587 * or initialising any modules.
2589 void tls_global_init(void)
2591 SSL_load_error_strings(); /* readable error messages (examples show call before library_init) */
2592 SSL_library_init(); /* initialize library */
2593 OpenSSL_add_all_algorithms(); /* required for SHA2 in OpenSSL < 0.9.8o and 1.0.0.a */
2594 CONF_modules_load_file(NULL, NULL, 0);
2597 * Initialize the index for the certificates.
2599 fr_tls_ex_index_certs = SSL_SESSION_get_ex_new_index(0, NULL, NULL, NULL, sess_free_certs);
2602 #ifdef ENABLE_OPENSSL_VERSION_CHECK
2603 /** Check for vulnerable versions of libssl
2605 * @param acknowledged The highest CVE number a user has confirmed is not present in the system's libssl.
2606 * @return 0 if the CVE specified by the user matches the most recent CVE we have, else -1.
2608 int tls_global_version_check(char const *acknowledged)
2614 if (strcmp(acknowledged, "yes") == 0) return 0;
2616 /* Check for bad versions */
2617 v = (uint64_t) SSLeay();
2619 for (i = 0; i < (sizeof(libssl_defects) / sizeof(*libssl_defects)); i++) {
2620 libssl_defect_t *defect = &libssl_defects[i];
2622 if ((v >= defect->low) && (v <= defect->high)) {
2624 * If the CVE is acknowledged, allow it.
2626 if (!bad && (strcmp(acknowledged, defect->id) == 0)) return 0;
2628 ERROR("Refusing to start with libssl version %s (in range %s)",
2629 ssl_version(), ssl_version_range(defect->low, defect->high));
2630 ERROR("Security advisory %s (%s)", defect->id, defect->name);
2631 ERROR("%s", defect->comment);
2634 * Only warn about the first one...
2637 INFO("Once you have verified libssl has been correctly patched, "
2638 "set security.allow_vulnerable_openssl = '%s'", defect->id);
2651 /** Free any memory alloced by libssl
2654 void tls_global_cleanup(void)
2656 #if OPENSSL_VERSION_NUMBER < 0x10000000L
2657 ERR_remove_state(0);
2658 #elif OPENSSL_VERSION_NUMBER < 0x10100000L || defined(LIBRESSL_VERSION_NUMBER)
2659 ERR_remove_thread_state(NULL);
2662 CONF_modules_unload(1);
2665 CRYPTO_cleanup_all_ex_data();
2668 /** Create SSL context
2670 * - Load the trusted CAs
2671 * - Load the Private key & the certificate
2672 * - Set the Context options & Verify options
2674 SSL_CTX *tls_init_ctx(fr_tls_server_conf_t *conf, int client)
2677 X509_STORE *certstore;
2678 int verify_mode = SSL_VERIFY_NONE;
2679 int ctx_options = 0;
2680 int ctx_tls_versions = 0;
2684 * SHA256 is in all versions of OpenSSL, but isn't
2685 * initialized by default. It's needed for WiMAX
2688 #ifdef HAVE_OPENSSL_EVP_SHA256
2689 EVP_add_digest(EVP_sha256());
2692 ctx = SSL_CTX_new(SSLv23_method()); /* which is really "all known SSL / TLS methods". Idiots. */
2694 tls_error_log(NULL, "Failed creating TLS context");
2699 * Save the config on the context so that callbacks which
2700 * only get SSL_CTX* e.g. session persistence, can get it
2702 SSL_CTX_set_app_data(ctx, conf);
2705 * Identify the type of certificates that needs to be loaded
2707 if (conf->file_type) {
2708 type = SSL_FILETYPE_PEM;
2710 type = SSL_FILETYPE_ASN1;
2714 * Set the password to load private key
2716 if (conf->private_key_password) {
2719 * We don't want to put the private key password in eap.conf, so check
2720 * for our special string which indicates we should get the password
2723 char const* special_string = "Apple:UseCertAdmin";
2724 if (strncmp(conf->private_key_password, special_string, strlen(special_string)) == 0) {
2727 long const max_password_len = 128;
2728 snprintf(cmd, sizeof(cmd) - 1, "/usr/sbin/certadmin --get-private-key-passphrase \"%s\"",
2729 conf->private_key_file);
2731 DEBUG2(LOG_PREFIX ": Getting private key passphrase using command \"%s\"", cmd);
2733 FILE* cmd_pipe = popen(cmd, "r");
2735 ERROR(LOG_PREFIX ": %s command failed: Unable to get private_key_password", cmd);
2736 ERROR(LOG_PREFIX ": Error reading private_key_file %s", conf->private_key_file);
2740 rad_const_free(conf->private_key_password);
2741 password = talloc_array(conf, char, max_password_len);
2743 ERROR(LOG_PREFIX ": Can't allocate space for private_key_password");
2744 ERROR(LOG_PREFIX ": Error reading private_key_file %s", conf->private_key_file);
2749 fgets(password, max_password_len, cmd_pipe);
2752 /* Get rid of newline at end of password. */
2753 password[strlen(password) - 1] = '\0';
2755 DEBUG3(LOG_PREFIX ": Password from command = \"%s\"", password);
2756 conf->private_key_password = password;
2763 memcpy(&password, &conf->private_key_password, sizeof(password));
2764 SSL_CTX_set_default_passwd_cb_userdata(ctx, password);
2765 SSL_CTX_set_default_passwd_cb(ctx, cbtls_password);
2769 #ifdef PSK_MAX_IDENTITY_LEN
2772 * No dynamic query exists. There MUST be a
2773 * statically configured identity and password.
2775 if (conf->psk_query && !*conf->psk_query) {
2776 ERROR(LOG_PREFIX ": Invalid PSK Configuration: psk_query cannot be empty");
2781 * Set the callback only if we can check things.
2783 if (conf->psk_identity || conf->psk_query) {
2784 SSL_CTX_set_psk_server_callback(ctx, psk_server_callback);
2787 } else if (conf->psk_query) {
2788 ERROR(LOG_PREFIX ": Invalid PSK Configuration: psk_query cannot be used for outgoing connections");
2793 * Now check that if PSK is being used, the config is valid.
2795 if ((conf->psk_identity && !conf->psk_password) ||
2796 (!conf->psk_identity && conf->psk_password) ||
2797 (conf->psk_identity && !*conf->psk_identity) ||
2798 (conf->psk_password && !*conf->psk_password)) {
2799 ERROR(LOG_PREFIX ": Invalid PSK Configuration: psk_identity or psk_password are empty");
2803 if (conf->psk_identity) {
2804 size_t psk_len, hex_len;
2805 uint8_t buffer[PSK_MAX_PSK_LEN];
2807 if (conf->certificate_file ||
2808 conf->private_key_password || conf->private_key_file ||
2809 conf->ca_file || conf->ca_path) {
2810 ERROR(LOG_PREFIX ": When PSKs are used, No certificate configuration is permitted");
2815 SSL_CTX_set_psk_client_callback(ctx,
2816 psk_client_callback);
2819 psk_len = strlen(conf->psk_password);
2820 if (strlen(conf->psk_password) > (2 * PSK_MAX_PSK_LEN)) {
2821 ERROR(LOG_PREFIX ": psk_hexphrase is too long (max %d)", PSK_MAX_PSK_LEN);
2826 * Check the password now, so that we don't have
2827 * errors at run-time.
2829 hex_len = fr_hex2bin(buffer, sizeof(buffer), conf->psk_password, psk_len);
2830 if (psk_len != (2 * hex_len)) {
2831 ERROR(LOG_PREFIX ": psk_hexphrase is not all hex");
2838 (void) client; /* -Wunused */
2842 * Load our keys and certificates
2844 * If certificates are of type PEM then we can make use
2845 * of cert chain authentication using openssl api call
2846 * SSL_CTX_use_certificate_chain_file. Please see how
2847 * the cert chain needs to be given in PEM from
2850 if (!conf->certificate_file) goto load_ca;
2852 if (type == SSL_FILETYPE_PEM) {
2853 if (!(SSL_CTX_use_certificate_chain_file(ctx, conf->certificate_file))) {
2854 tls_error_log(NULL, "Failed reading certificate file \"%s\"",
2855 conf->certificate_file);
2859 } else if (!(SSL_CTX_use_certificate_file(ctx, conf->certificate_file, type))) {
2860 tls_error_log(NULL, "Failed reading certificate file \"%s\"",
2861 conf->certificate_file);
2865 /* Load the CAs we trust */
2867 if (conf->ca_file || conf->ca_path) {
2868 if (!SSL_CTX_load_verify_locations(ctx, conf->ca_file, conf->ca_path)) {
2869 tls_error_log(NULL, "Failed reading Trusted root CA list \"%s\"",
2874 if (conf->ca_file && *conf->ca_file) SSL_CTX_set_client_CA_list(ctx, SSL_load_client_CA_file(conf->ca_file));
2876 if (conf->private_key_file) {
2877 if (!(SSL_CTX_use_PrivateKey_file(ctx, conf->private_key_file, type))) {
2878 tls_error_log(NULL, "Failed reading private key file \"%s\"",
2879 conf->private_key_file);
2884 * Check if the loaded private key is the right one
2886 if (!SSL_CTX_check_private_key(ctx)) {
2887 ERROR(LOG_PREFIX ": Private key does not match the certificate public key");
2892 #ifdef PSK_MAX_IDENTITY_LEN
2897 * We never want SSLv2 or SSLv3.
2899 ctx_options |= SSL_OP_NO_SSLv2;
2900 ctx_options |= SSL_OP_NO_SSLv3;
2903 * As of 3.0.5, we always allow TLSv1.1 and TLSv1.2.
2904 * Though they can be *globally* disabled if necessary.x
2906 #ifdef SSL_OP_NO_TLSv1
2907 if (conf->disable_tlsv1) ctx_options |= SSL_OP_NO_TLSv1;
2909 ctx_tls_versions |= SSL_OP_NO_TLSv1;
2911 #ifdef SSL_OP_NO_TLSv1_1
2912 if (conf->disable_tlsv1_1) ctx_options |= SSL_OP_NO_TLSv1_1;
2914 ctx_tls_versions |= SSL_OP_NO_TLSv1_1;
2916 #ifdef SSL_OP_NO_TLSv1_2
2918 if (conf->disable_tlsv1_2) ctx_options |= SSL_OP_NO_TLSv1_2;
2920 ctx_tls_versions |= SSL_OP_NO_TLSv1_2;
2924 if ((ctx_options & ctx_tls_versions) == ctx_tls_versions) {
2925 ERROR(LOG_PREFIX ": You have disabled all available TLS versions. EAP will not work");
2929 #ifdef SSL_OP_NO_TICKET
2930 ctx_options |= SSL_OP_NO_TICKET;
2933 if (!conf->disable_single_dh_use) {
2935 * SSL_OP_SINGLE_DH_USE must be used in order to prevent
2936 * small subgroup attacks and forward secrecy. Always
2937 * using SSL_OP_SINGLE_DH_USE has an impact on the
2938 * computer time needed during negotiation, but it is not
2941 ctx_options |= SSL_OP_SINGLE_DH_USE;
2945 * SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS to work around issues
2946 * in Windows Vista client.
2947 * http://www.openssl.org/~bodo/tls-cbc.txt
2948 * http://www.nabble.com/(RADIATOR)-Radiator-Version-3.16-released-t2600070.html
2950 ctx_options |= SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS;
2952 if (conf->cipher_server_preference) {
2954 * SSL_OP_CIPHER_SERVER_PREFERENCE to follow best practice
2955 * of nowday's TLS: do not allow poorly-selected ciphers from
2956 * client to take preference
2958 ctx_options |= SSL_OP_CIPHER_SERVER_PREFERENCE;
2961 SSL_CTX_set_options(ctx, ctx_options);
2964 * TODO: Set the RSA & DH
2965 * SSL_CTX_set_tmp_rsa_callback(ctx, cbtls_rsa);
2966 * SSL_CTX_set_tmp_dh_callback(ctx, cbtls_dh);
2970 * set the message callback to identify the type of
2971 * message. For every new session, there can be a
2972 * different callback argument.
2974 * SSL_CTX_set_msg_callback(ctx, cbtls_msg);
2978 * Set eliptical curve crypto configuration.
2980 #if OPENSSL_VERSION_NUMBER >= 0x0090800fL
2981 #ifndef OPENSSL_NO_ECDH
2982 if (set_ecdh_curve(ctx, conf->ecdh_curve, conf->disable_single_dh_use) < 0) {
2989 * OpenSSL will automatically create certificate chains,
2990 * unless we tell it to not do that. The problem is that
2991 * it sometimes gets the chains right from a certificate
2992 * signature view, but wrong from the clients view.
2994 if (!conf->auto_chain) {
2995 SSL_CTX_set_mode(ctx, SSL_MODE_NO_AUTO_CHAIN);
2998 /* Set Info callback */
2999 SSL_CTX_set_info_callback(ctx, cbtls_info);
3002 * Callbacks, etc. for session resumption.
3004 if (conf->session_cache_enable) {
3006 * Cache sessions on disk if requested.
3008 if (conf->session_cache_path) {
3009 SSL_CTX_sess_set_new_cb(ctx, cbtls_new_session);
3010 SSL_CTX_sess_set_get_cb(ctx, cbtls_get_session);
3011 SSL_CTX_sess_set_remove_cb(ctx, cbtls_remove_session);
3014 SSL_CTX_set_quiet_shutdown(ctx, 1);
3015 if (fr_tls_ex_index_vps < 0)
3016 fr_tls_ex_index_vps = SSL_SESSION_get_ex_new_index(0, NULL, NULL, NULL, sess_free_vps);
3020 * Check the certificates for revocation.
3022 #ifdef X509_V_FLAG_CRL_CHECK
3023 if (conf->check_crl) {
3024 certstore = SSL_CTX_get_cert_store(ctx);
3025 if (certstore == NULL) {
3026 tls_error_log(NULL, "Error reading Certificate Store");
3029 X509_STORE_set_flags(certstore, X509_V_FLAG_CRL_CHECK);
3031 #ifdef X509_V_FLAG_CRL_CHECK_ALL
3032 if (conf->check_all_crl)
3033 X509_STORE_set_flags(certstore, X509_V_FLAG_CRL_CHECK_ALL);
3040 * Always verify the peer certificate
3042 verify_mode |= SSL_VERIFY_PEER;
3043 verify_mode |= SSL_VERIFY_FAIL_IF_NO_PEER_CERT;
3044 verify_mode |= SSL_VERIFY_CLIENT_ONCE;
3045 SSL_CTX_set_verify(ctx, verify_mode, cbtls_verify);
3047 if (conf->verify_depth) {
3048 SSL_CTX_set_verify_depth(ctx, conf->verify_depth);
3051 #ifndef LIBRESSL_VERSION_NUMBER
3052 /* Load randomness */
3053 if (conf->random_file) {
3054 if (!(RAND_load_file(conf->random_file, 1024*10))) {
3055 tls_error_log(NULL, "Failed loading randomness");
3062 * Set the cipher list if we were told to
3064 if (conf->cipher_list) {
3065 if (!SSL_CTX_set_cipher_list(ctx, conf->cipher_list)) {
3066 tls_error_log(NULL, "Failed setting cipher list");
3072 * Setup session caching
3074 if (conf->session_cache_enable) {
3076 * Create a unique context Id per EAP-TLS configuration.
3078 if (conf->session_id_name) {
3079 snprintf(conf->session_context_id, sizeof(conf->session_context_id),
3080 "FR eap %s", conf->session_id_name);
3082 snprintf(conf->session_context_id, sizeof(conf->session_context_id),
3087 * Cache it, DON'T auto-clear it, and disable the internal OpenSSL session cache.
3089 SSL_CTX_set_session_cache_mode(ctx, SSL_SESS_CACHE_SERVER | SSL_SESS_CACHE_NO_AUTO_CLEAR | SSL_SESS_CACHE_NO_INTERNAL);
3091 SSL_CTX_set_session_id_context(ctx,
3092 (unsigned char *) conf->session_context_id,
3093 (unsigned int) strlen(conf->session_context_id));
3096 * Our timeout is in hours, this is in seconds.
3098 SSL_CTX_set_timeout(ctx, conf->session_timeout * 3600);
3101 * Set the maximum number of entries in the
3104 SSL_CTX_sess_set_cache_size(ctx, conf->session_cache_size);
3107 SSL_CTX_set_session_cache_mode(ctx, SSL_SESS_CACHE_OFF);
3115 * Free TLS client/server config
3116 * Should not be called outside this code, as a callback is
3117 * added to automatically free the data when the CONF_SECTION
3120 static int _tls_server_conf_free(fr_tls_server_conf_t *conf)
3122 if (conf->ctx) SSL_CTX_free(conf->ctx);
3124 #ifdef HAVE_OPENSSL_OCSP_H
3125 if (conf->ocsp_store) X509_STORE_free(conf->ocsp_store);
3126 conf->ocsp_store = NULL;
3130 memset(conf, 0, sizeof(*conf));
3135 fr_tls_server_conf_t *tls_server_conf_alloc(TALLOC_CTX *ctx)
3137 fr_tls_server_conf_t *conf;
3139 conf = talloc_zero(ctx, fr_tls_server_conf_t);
3141 ERROR(LOG_PREFIX ": Out of memory");
3145 talloc_set_destructor(conf, _tls_server_conf_free);
3150 fr_tls_server_conf_t *tls_server_conf_parse(CONF_SECTION *cs)
3152 fr_tls_server_conf_t *conf;
3155 * If cs has already been parsed there should be a cached copy
3156 * of conf already stored, so just return that.
3158 conf = cf_data_find(cs, "tls-conf");
3160 DEBUG(LOG_PREFIX ": Using cached TLS configuration from previous invocation");
3164 conf = tls_server_conf_alloc(cs);
3166 if (cf_section_parse(cs, conf, tls_server_config) < 0) {
3173 * Save people from their own stupidity.
3175 if (conf->fragment_size < 100) conf->fragment_size = 100;
3178 * Only check for certificate things if we don't have a
3181 #ifdef PSK_MAX_IDENTITY_LEN
3182 if (conf->psk_identity) {
3183 if (conf->private_key_file) {
3184 WARN(LOG_PREFIX ": Ignoring private key file due to psk_identity being used");
3187 if (conf->certificate_file) {
3188 WARN(LOG_PREFIX ": Ignoring certificate file due to psk_identity being used");
3194 if (!conf->private_key_file) {
3195 ERROR(LOG_PREFIX ": TLS Server requires a private key file");
3199 if (!conf->certificate_file) {
3200 ERROR(LOG_PREFIX ": TLS Server requires a certificate file");
3208 conf->ctx = tls_init_ctx(conf, 0);
3209 if (conf->ctx == NULL) {
3213 #ifdef HAVE_OPENSSL_OCSP_H
3215 * Initialize OCSP Revocation Store
3217 if (conf->ocsp_enable) {
3218 conf->ocsp_store = init_revocation_store(conf);
3219 if (conf->ocsp_store == NULL) goto error;
3221 #endif /*HAVE_OPENSSL_OCSP_H*/
3225 memcpy(&dh_file, &conf->dh_file, sizeof(dh_file));
3226 if (load_dh_params(conf->ctx, dh_file) < 0) {
3231 if (conf->verify_tmp_dir) {
3232 if (chmod(conf->verify_tmp_dir, S_IRWXU) < 0) {
3233 ERROR(LOG_PREFIX ": Failed changing permissions on %s: %s",
3234 conf->verify_tmp_dir, fr_syserror(errno));
3239 if (conf->verify_client_cert_cmd && !conf->verify_tmp_dir) {
3240 ERROR(LOG_PREFIX ": You MUST set the verify directory in order to use verify_client_cmd");
3244 #ifdef SSL_OP_NO_TLSv1_2
3246 * OpenSSL 1.0.1f and 1.0.1g get the MS-MPPE keys wrong.
3248 #if (OPENSSL_VERSION_NUMBER >= 0x10010060L) && (OPENSSL_VERSION_NUMBER < 0x10010060L)
3249 conf->disable_tlsv1_2 = true;
3250 WARN(LOG_PREFIX ": Disabling TLSv1.2 due to OpenSSL bugs");
3255 * Cache conf in cs in case we're asked to parse this again.
3257 cf_data_add(cs, "tls-conf", conf, NULL);
3262 fr_tls_server_conf_t *tls_client_conf_parse(CONF_SECTION *cs)
3264 fr_tls_server_conf_t *conf;
3266 conf = cf_data_find(cs, "tls-conf");
3268 DEBUG2(LOG_PREFIX ": Using cached TLS configuration from previous invocation");
3272 conf = tls_server_conf_alloc(cs);
3274 if (cf_section_parse(cs, conf, tls_client_config) < 0) {
3281 * Save people from their own stupidity.
3283 if (conf->fragment_size < 100) conf->fragment_size = 100;
3288 conf->ctx = tls_init_ctx(conf, 1);
3289 if (conf->ctx == NULL) {
3296 memcpy(&dh_file, &conf->dh_file, sizeof(dh_file));
3297 if (load_dh_params(conf->ctx, dh_file) < 0) {
3302 cf_data_add(cs, "tls-conf", conf, NULL);
3308 int tls_success(tls_session_t *ssn, REQUEST *request)
3310 VALUE_PAIR *vp, *vps = NULL;
3311 fr_tls_server_conf_t *conf;
3312 TALLOC_CTX *talloc_ctx;
3314 conf = (fr_tls_server_conf_t *)SSL_get_ex_data(ssn->ssl, FR_TLS_EX_INDEX_CONF);
3315 rad_assert(conf != NULL);
3317 talloc_ctx = SSL_get_ex_data(ssn->ssl, FR_TLS_EX_INDEX_TALLOC);
3320 * If there's no session resumption, delete the entry
3321 * from the cache. This means either it's disabled
3322 * globally for this SSL context, OR we were told to
3323 * disable it for this user.
3325 * This also means you can't turn it on just for one
3328 if ((!ssn->allow_session_resumption) ||
3329 (((vp = fr_pair_find_by_num(request->config, PW_ALLOW_SESSION_RESUMPTION, 0, TAG_ANY)) != NULL) &&
3330 (vp->vp_integer == 0))) {
3331 SSL_CTX_remove_session(ssn->ctx,
3333 ssn->allow_session_resumption = false;
3336 * If we're in a resumed session and it's
3339 if (SSL_session_reused(ssn->ssl)) {
3340 RDEBUG("Forcibly stopping session resumption as it is not allowed");
3345 * Else resumption IS allowed, so we store the
3346 * user data in the cache.
3348 } else if (!SSL_session_reused(ssn->ssl)) {
3350 char buffer[2 * MAX_SESSION_SIZE + 1];
3352 tls_session_id(ssn->ssl_session, buffer, MAX_SESSION_SIZE);
3354 vp = fr_pair_list_copy_by_num(talloc_ctx, request->reply->vps, PW_USER_NAME, 0, TAG_ANY);
3355 if (vp) fr_pair_add(&vps, vp);
3357 vp = fr_pair_list_copy_by_num(talloc_ctx, request->packet->vps, PW_STRIPPED_USER_NAME, 0, TAG_ANY);
3358 if (vp) fr_pair_add(&vps, vp);
3360 vp = fr_pair_list_copy_by_num(talloc_ctx, request->packet->vps, PW_STRIPPED_USER_DOMAIN, 0, TAG_ANY);
3361 if (vp) fr_pair_add(&vps, vp);
3363 vp = fr_pair_list_copy_by_num(talloc_ctx, request->reply->vps, PW_CHARGEABLE_USER_IDENTITY, 0, TAG_ANY);
3364 if (vp) fr_pair_add(&vps, vp);
3366 vp = fr_pair_list_copy_by_num(talloc_ctx, request->reply->vps, PW_CACHED_SESSION_POLICY, 0, TAG_ANY);
3367 if (vp) fr_pair_add(&vps, vp);
3369 certs = (VALUE_PAIR **)SSL_get_ex_data(ssn->ssl, fr_tls_ex_index_certs);
3372 * Hmm... the certs should probably be session data.
3376 * @todo: some go into reply, others into
3379 fr_pair_add(&vps, fr_pair_list_copy(talloc_ctx, *certs));
3382 * Save the certs in the packet, so that we can see them.
3384 fr_pair_add(&request->packet->vps, fr_pair_list_copy(request->packet, *certs));
3386 vp = fr_pair_find_by_num(request->packet->vps, PW_TLS_CLIENT_CERT_EXPIRATION, 0, TAG_ANY);
3390 if (ocsp_asn1time_to_epoch(&expires, vp->vp_strvalue) < 0) {
3391 RDEBUG2("Failed getting certificate expiration, removing cache entry for session %s", buffer);
3392 SSL_CTX_remove_session(ssn->ctx, ssn->ssl_session);
3396 if (expires <= request->timestamp) {
3397 RDEBUG2("Certificate has expired, removing cache entry for session %s", buffer);
3398 SSL_CTX_remove_session(ssn->ctx, ssn->ssl_session);
3403 * Account for Session-Timeout, if it's available.
3405 vp = fr_pair_find_by_num(request->reply->vps, PW_SESSION_TIMEOUT, 0, TAG_ANY);
3407 if ((request->timestamp + vp->vp_integer) > expires) {
3408 vp->vp_integer = expires - request->timestamp;
3409 RWDEBUG2("Updating Session-Timeout to %u, due to impending certificate expiration",
3417 SSL_SESSION_set_ex_data(ssn->ssl_session, fr_tls_ex_index_vps, vps);
3418 rdebug_pair_list(L_DBG_LVL_2, request, vps, " caching ");
3420 if (conf->session_cache_path) {
3421 /* write the VPs to the cache file */
3422 char filename[256], buf[1024];
3425 RDEBUG2("Saving session %s in the disk cache", buffer);
3427 snprintf(filename, sizeof(filename), "%s%c%s.vps", conf->session_cache_path,
3428 FR_DIR_SEP, buffer);
3429 vp_file = fopen(filename, "w");
3430 if (vp_file == NULL) {
3431 RWDEBUG("Could not write session VPs to persistent cache: %s",
3432 fr_syserror(errno));
3434 VALUE_PAIR *prev = NULL;
3436 /* generate a dummy user-style entry which is easy to read back */
3437 fprintf(vp_file, "# SSL cached session\n");
3438 fprintf(vp_file, "%s\n\t", buffer);
3440 for (vp = fr_cursor_init(&cursor, &vps);
3442 vp = fr_cursor_next(&cursor)) {
3444 * Terminate the previous line.
3446 if (prev) fprintf(vp_file, ",\n\t");
3451 vp_prints(buf, sizeof(buf), vp);
3452 fputs(buf, vp_file);
3457 * Terminate the final line.
3459 fprintf(vp_file, "\n");
3463 RDEBUG("Failed to find 'persist_dir' in TLS configuration. Session will not be cached on disk.");
3466 RDEBUG2("No information to cache: session caching will be disabled for session %s", buffer);
3467 SSL_CTX_remove_session(ssn->ctx, ssn->ssl_session);
3471 * Else the session WAS allowed. Copy the cached reply.
3474 char buffer[2 * MAX_SESSION_SIZE + 1];
3476 tls_session_id(ssn->ssl_session, buffer, MAX_SESSION_SIZE);
3479 * The "restore VPs from OpenSSL cache" code is
3480 * now in eaptls_process()
3483 if (conf->session_cache_path) {
3484 /* "touch" the cached session/vp file */
3487 snprintf(filename, sizeof(filename), "%s%c%s.asn1",
3488 conf->session_cache_path, FR_DIR_SEP, buffer);
3489 utime(filename, NULL);
3490 snprintf(filename, sizeof(filename), "%s%c%s.vps",
3491 conf->session_cache_path, FR_DIR_SEP, buffer);
3492 utime(filename, NULL);
3496 * Mark the request as resumed.
3498 pair_make_request("EAP-Session-Resumed", "1", T_OP_SET);
3505 void tls_fail(tls_session_t *ssn)
3508 * Force the session to NOT be cached.
3510 SSL_CTX_remove_session(ssn->ctx, ssn->ssl_session);
3513 fr_tls_status_t tls_application_data(tls_session_t *ssn, REQUEST *request)
3520 * Decrypt the complete record.
3522 err = BIO_write(ssn->into_ssl, ssn->dirty_in.data,
3523 ssn->dirty_in.used);
3524 if (err != (int) ssn->dirty_in.used) {
3525 record_init(&ssn->dirty_in);
3526 RDEBUG("Failed writing %zd bytes to SSL BIO: %d", ssn->dirty_in.used, err);
3531 * Clear the dirty buffer now that we are done with it
3532 * and init the clean_out buffer to store decrypted data
3534 record_init(&ssn->dirty_in);
3535 record_init(&ssn->clean_out);
3538 * Read (and decrypt) the tunneled data from the
3539 * SSL session, and put it into the decrypted
3542 err = SSL_read(ssn->ssl, ssn->clean_out.data, sizeof(ssn->clean_out.data));
3546 RDEBUG("SSL_read Error");
3548 code = SSL_get_error(ssn->ssl, err);
3550 case SSL_ERROR_WANT_READ:
3551 DEBUG("Error in fragmentation logic: SSL_WANT_READ");
3552 return FR_TLS_MORE_FRAGMENTS;
3554 case SSL_ERROR_WANT_WRITE:
3555 DEBUG("Error in fragmentation logic: SSL_WANT_WRITE");
3559 REDEBUG("Error in fragmentation logic");
3560 tls_error_io_log(request, ssn, err,
3561 "Failed in " STRINGIFY(__FUNCTION__) " (SSL_read)");
3567 if (err == 0) RWDEBUG("No data inside of the tunnel");
3570 * Passed all checks, successfully decrypted data
3572 ssn->clean_out.used = err;
3575 * Add the certificates to intermediate packets, so that
3576 * the inner tunnel policies can use them.
3578 certs = (VALUE_PAIR **)SSL_get_ex_data(ssn->ssl, fr_tls_ex_index_certs);
3580 if (certs) fr_pair_add(&request->packet->vps, fr_pair_list_copy(request->packet, *certs));
3587 * Acknowledge received is for one of the following messages sent earlier
3588 * 1. Handshake completed Message, so now send, EAP-Success
3589 * 2. Alert Message, now send, EAP-Failure
3590 * 3. Fragment Message, now send, next Fragment
3592 fr_tls_status_t tls_ack_handler(tls_session_t *ssn, REQUEST *request)
3595 REDEBUG("Unexpected ACK received: No ongoing SSL session");
3596 return FR_TLS_INVALID;
3598 if (!ssn->info.initialized) {
3599 RDEBUG("No SSL info available. Waiting for more SSL data");
3600 return FR_TLS_REQUEST;
3603 if ((ssn->info.content_type == handshake) && (ssn->info.origin == 0)) {
3604 REDEBUG("Unexpected ACK received: We sent no previous messages");
3605 return FR_TLS_INVALID;
3608 switch (ssn->info.content_type) {
3610 RDEBUG2("Peer ACKed our alert");
3614 if ((ssn->info.handshake_type == handshake_finished) && (ssn->dirty_out.used == 0)) {
3615 RDEBUG2("Peer ACKed our handshake fragment. handshake is finished");
3618 * From now on all the content is
3619 * application data set it here as nobody else
3622 ssn->info.content_type = application_data;
3623 return FR_TLS_SUCCESS;
3624 } /* else more data to send */
3626 RDEBUG2("Peer ACKed our handshake fragment");
3627 /* Fragmentation handler, send next fragment */
3628 return FR_TLS_REQUEST;
3630 case application_data:
3631 RDEBUG2("Peer ACKed our application data fragment");
3632 return FR_TLS_REQUEST;
3635 * For the rest of the conditions, switch over
3636 * to the default section below.
3639 REDEBUG("Invalid ACK received: %d", ssn->info.content_type);
3640 return FR_TLS_INVALID;
3643 #endif /* WITH_TLS */