OpenVPN
ssl_openssl.c
Go to the documentation of this file.
1/*
2 * OpenVPN -- An application to securely tunnel IP networks
3 * over a single TCP/UDP port, with support for SSL/TLS-based
4 * session authentication and key exchange,
5 * packet encryption, packet authentication, and
6 * packet compression.
7 *
8 * Copyright (C) 2002-2026 OpenVPN Inc <sales@openvpn.net>
9 * Copyright (C) 2010-2026 Sentyron B.V. <openvpn@sentyron.com>
10 *
11 * This program is free software; you can redistribute it and/or modify
12 * it under the terms of the GNU General Public License version 2
13 * as published by the Free Software Foundation.
14 *
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 * GNU General Public License for more details.
19 *
20 * You should have received a copy of the GNU General Public License along
21 * with this program; if not, see <https://www.gnu.org/licenses/>.
22 */
23
28
29#ifdef HAVE_CONFIG_H
30#include "config.h"
31#endif
32
33#include "syshead.h"
34
35#if defined(ENABLE_CRYPTO_OPENSSL)
36
37#include "errlevel.h"
38#include "buffer.h"
39#include "misc.h"
40#include "manage.h"
41#include "memdbg.h"
42#include "ssl_backend.h"
43#include "ssl_common.h"
44#include "base64.h"
45#include "openssl_compat.h"
46#include "xkey_common.h"
47
48#ifdef ENABLE_CRYPTOAPI
49#include "cryptoapi.h"
50#endif
51
52#include "ssl_verify_openssl.h"
53#include "ssl_util.h"
54
55#include <openssl/bn.h>
56#include <openssl/crypto.h>
57#include <openssl/dh.h>
58#include <openssl/dsa.h>
59#include <openssl/err.h>
60#include <openssl/pkcs12.h>
61#include <openssl/rsa.h>
62#include <openssl/x509.h>
63#include <openssl/ssl.h>
64#ifndef OPENSSL_NO_EC
65#include <openssl/ec.h>
66#endif
67
68#if OPENSSL_VERSION_NUMBER >= 0x30000000L
69#define HAVE_OPENSSL_STORE_API
70#include <openssl/ui.h>
71#include <openssl/store.h>
72#endif
73
74#if defined(_MSC_VER) && !defined(_M_ARM64)
75#include <openssl/applink.c>
76#endif
77
79
80static void unload_xkey_provider(void);
81
82/*
83 * Allocate space in SSL objects in which to store a struct tls_session
84 * pointer back to parent.
85 *
86 */
87
88int mydata_index; /* GLOBAL */
89
90void
92{
93 mydata_index = SSL_get_ex_new_index(0, "struct session *", NULL, NULL, NULL);
94 ASSERT(mydata_index >= 0);
95}
96
97void
99{
100}
101
102void
104{
105 ASSERT(NULL != ctx);
106
107 ctx->ctx = SSL_CTX_new_ex(tls_libctx, NULL, TLS_method());
108
109 if (ctx->ctx == NULL)
110 {
111 crypto_msg(M_FATAL, "SSL_CTX_new TLS_method");
112 }
113 if (ERR_peek_error() != 0)
114 {
115 crypto_msg(M_WARN, "Warning: TLS context initialisation "
116 "has warnings.");
117 }
118}
119
120void
122{
123 ASSERT(NULL != ctx);
124 SSL_CTX_free(ctx->ctx);
125 ctx->ctx = NULL;
126 sk_X509_CRL_pop_free(ctx->crls, X509_CRL_free);
127 ctx->crls = NULL;
128 unload_xkey_provider(); /* in case it is loaded */
129}
130
131bool
133{
134 /* either this should be NULL or should be non-null and then have a
135 * valid TLS ctx inside as well */
136 ASSERT(ctx == NULL || ctx->ctx != NULL);
137 return ctx != NULL;
138}
139
140bool
141key_state_export_keying_material(struct tls_session *session, const char *label, size_t label_size,
142 void *ekm, size_t ekm_size)
143
144{
145 SSL *ssl = session->key[KS_PRIMARY].ks_ssl.ssl;
146
147 if (SSL_export_keying_material(ssl, ekm, ekm_size, label, label_size, NULL, 0, 0) == 1)
148 {
149 return true;
150 }
151 else
152 {
153 secure_memzero(ekm, ekm_size);
154 return false;
155 }
156}
157
158/*
159 * Print debugging information on SSL/TLS session negotiation.
160 */
161
162#ifndef INFO_CALLBACK_SSL_CONST
163#define INFO_CALLBACK_SSL_CONST const
164#endif
165static void
166info_callback(INFO_CALLBACK_SSL_CONST SSL *s, int where, int ret)
167{
168 if (where & SSL_CB_LOOP)
169 {
170 dmsg(D_HANDSHAKE_VERBOSE, "SSL state (%s): %s",
171 where & SSL_ST_CONNECT ? "connect"
172 : where & SSL_ST_ACCEPT ? "accept"
173 : "undefined",
174 SSL_state_string_long(s));
175 }
176 else if (where & SSL_CB_ALERT)
177 {
178 dmsg(D_TLS_DEBUG_LOW, "%s %s SSL alert: %s", where & SSL_CB_READ ? "Received" : "Sent",
179 SSL_alert_type_string_long(ret), SSL_alert_desc_string_long(ret));
180 }
181}
182
183/*
184 * Return maximum TLS version supported by local OpenSSL library.
185 * We only support OpenSSL versions that support TLS 1.3.
186 */
187int
189{
190 return TLS_VER_1_3;
191}
192
194static uint16_t
195openssl_tls_version(unsigned int ver)
196{
197 if (ver == TLS_VER_1_0)
198 {
199 return TLS1_VERSION;
200 }
201 else if (ver == TLS_VER_1_1)
202 {
203 return TLS1_1_VERSION;
204 }
205 else if (ver == TLS_VER_1_2)
206 {
207 return TLS1_2_VERSION;
208 }
209 else if (ver == TLS_VER_1_3)
210 {
211 return TLS1_3_VERSION;
212 }
213 return 0;
214}
215
216static bool
217tls_ctx_set_tls_versions(struct tls_root_ctx *ctx, unsigned int ssl_flags)
218{
219 uint16_t tls_ver_min =
221 uint16_t tls_ver_max =
223
224 if (!tls_ver_min)
225 {
226 /* Enforce at least TLS 1.0 */
227 uint16_t cur_min = (uint16_t)SSL_CTX_get_min_proto_version(ctx->ctx);
228 tls_ver_min = cur_min < TLS1_VERSION ? TLS1_VERSION : cur_min;
229 }
230
231 if (!SSL_CTX_set_min_proto_version(ctx->ctx, tls_ver_min))
232 {
233 msg(D_TLS_ERRORS, "%s: failed to set minimum TLS version", __func__);
234 return false;
235 }
236
237 if (tls_ver_max && !SSL_CTX_set_max_proto_version(ctx->ctx, tls_ver_max))
238 {
239 msg(D_TLS_ERRORS, "%s: failed to set maximum TLS version", __func__);
240 return false;
241 }
242
243 return true;
244}
245
246static int
247cert_verify_callback(X509_STORE_CTX *ctx, void *arg)
248{
249 struct tls_session *session;
250 SSL *ssl;
251
252 ssl = X509_STORE_CTX_get_ex_data(ctx, SSL_get_ex_data_X509_STORE_CTX_idx());
253 ASSERT(ssl);
254 session = SSL_get_ex_data(ssl, mydata_index);
256
257 /* Configure CRLs. */
258 X509_STORE_CTX_set0_crls(ctx, session->opt->ssl_ctx->crls);
259 return X509_verify_cert(ctx);
260}
261
262bool
263tls_ctx_set_options(struct tls_root_ctx *ctx, unsigned int ssl_flags)
264{
265 ASSERT(NULL != ctx);
266
267 /* process SSL options */
268 openssl_opt_t sslopt = SSL_OP_SINGLE_DH_USE | SSL_OP_NO_TICKET;
269#ifdef SSL_OP_CIPHER_SERVER_PREFERENCE
270 sslopt |= SSL_OP_CIPHER_SERVER_PREFERENCE;
271#endif
272 sslopt |= SSL_OP_NO_COMPRESSION;
273 /* Disable TLS renegotiations. OpenVPN's renegotiation creates new SSL
274 * session and does not depend on this feature. And TLS renegotiations have
275 * been problematic in the past */
276#ifdef SSL_OP_NO_RENEGOTIATION
277 sslopt |= SSL_OP_NO_RENEGOTIATION;
278#endif
279
280 SSL_CTX_set_options(ctx->ctx, sslopt);
281
282 if (!tls_ctx_set_tls_versions(ctx, ssl_flags))
283 {
284 return false;
285 }
286
287#ifdef SSL_MODE_RELEASE_BUFFERS
288 SSL_CTX_set_mode(ctx->ctx, SSL_MODE_RELEASE_BUFFERS);
289#endif
290 SSL_CTX_set_session_cache_mode(ctx->ctx, SSL_SESS_CACHE_OFF);
291 SSL_CTX_set_default_passwd_cb(ctx->ctx, pem_password_callback);
292
293 /* Require peer certificate verification */
294 int verify_flags = SSL_VERIFY_PEER | SSL_VERIFY_FAIL_IF_NO_PEER_CERT;
295 if (ssl_flags & SSLF_CLIENT_CERT_NOT_REQUIRED)
296 {
297 verify_flags = 0;
298 }
299 else if (ssl_flags & SSLF_CLIENT_CERT_OPTIONAL)
300 {
301 verify_flags = SSL_VERIFY_PEER;
302 }
303 SSL_CTX_set_verify(ctx->ctx, verify_flags, verify_callback);
304 SSL_CTX_set_cert_verify_callback(ctx->ctx, cert_verify_callback, NULL);
305
306 SSL_CTX_set_info_callback(ctx->ctx, info_callback);
307
308 return true;
309}
310
311static void
312convert_tls_list_to_openssl(char *openssl_ciphers, size_t len, const char *ciphers)
313{
314 /* Parse supplied cipher list and pass on to OpenSSL */
315 size_t begin_of_cipher, end_of_cipher;
316
317 const char *current_cipher;
318 size_t current_cipher_len;
319
320 const tls_cipher_name_pair *cipher_pair;
321
322 size_t openssl_ciphers_len = 0;
323 openssl_ciphers[0] = '\0';
324
325 /* Translate IANA cipher suite names to OpenSSL names */
326 begin_of_cipher = end_of_cipher = 0;
327 for (; begin_of_cipher < strlen(ciphers); begin_of_cipher = end_of_cipher)
328 {
329 end_of_cipher += strcspn(&ciphers[begin_of_cipher], ":");
330 cipher_pair =
331 tls_get_cipher_name_pair(&ciphers[begin_of_cipher], end_of_cipher - begin_of_cipher);
332
333 if (NULL == cipher_pair)
334 {
335 /* No translation found, use original */
336 current_cipher = &ciphers[begin_of_cipher];
337 current_cipher_len = end_of_cipher - begin_of_cipher;
338
339 /* Issue warning on missing translation */
340 /* %.*s format specifier expects length of type int, so guarantee */
341 /* that length is small enough and cast to int. */
342 msg(D_LOW, "No valid translation found for TLS cipher '%.*s'",
343 constrain_int((int)current_cipher_len, 0, 256), current_cipher);
344 }
345 else
346 {
347 /* Use OpenSSL name */
348 current_cipher = cipher_pair->openssl_name;
349 current_cipher_len = strlen(current_cipher);
350
351 if (end_of_cipher - begin_of_cipher == current_cipher_len
352 && 0
353 != memcmp(&ciphers[begin_of_cipher], cipher_pair->iana_name,
354 end_of_cipher - begin_of_cipher))
355 {
356 /* Non-IANA name used, show warning */
357 msg(M_WARN, "Deprecated TLS cipher name '%s', please use IANA name '%s'",
358 cipher_pair->openssl_name, cipher_pair->iana_name);
359 }
360 }
361
362 /* Make sure new cipher name fits in cipher string */
363 if ((SIZE_MAX - openssl_ciphers_len) < current_cipher_len
364 || (len - 1) < (openssl_ciphers_len + current_cipher_len))
365 {
366 msg(M_FATAL, "Failed to set restricted TLS cipher list, too long (>%d).",
367 (int)(len - 1));
368 }
369
370 /* Concatenate cipher name to OpenSSL cipher string */
371 memcpy(&openssl_ciphers[openssl_ciphers_len], current_cipher, current_cipher_len);
372 openssl_ciphers_len += current_cipher_len;
373 openssl_ciphers[openssl_ciphers_len] = ':';
374 openssl_ciphers_len++;
375
376 end_of_cipher++;
377 }
378
379 if (openssl_ciphers_len > 0)
380 {
381 openssl_ciphers[openssl_ciphers_len - 1] = '\0';
382 }
383}
384
385void
386tls_ctx_restrict_ciphers(struct tls_root_ctx *ctx, const char *ciphers)
387{
388 if (ciphers == NULL)
389 {
390 /* Use sane default TLS cipher list */
391 if (!SSL_CTX_set_cipher_list(
392 ctx->ctx,
393 /* Use openssl's default list as a basis */
394 "DEFAULT"
395 /* Disable export ciphers and openssl's 'low' and 'medium' ciphers */
396 ":!EXP:!LOW:!MEDIUM"
397 /* Disable static (EC)DH keys (no forward secrecy) */
398 ":!kDH:!kECDH"
399 /* Disable DSA private keys */
400 ":!DSS"
401 /* Disable unsupported TLS modes */
402 ":!PSK:!SRP:!kRSA"))
403 {
404 crypto_msg(M_FATAL, "Failed to set default TLS cipher list.");
405 }
406 return;
407 }
408
409 char openssl_ciphers[4096];
410 convert_tls_list_to_openssl(openssl_ciphers, sizeof(openssl_ciphers), ciphers);
411
412 ASSERT(NULL != ctx);
413
414 /* Set OpenSSL cipher list */
415 if (!SSL_CTX_set_cipher_list(ctx->ctx, openssl_ciphers))
416 {
417 crypto_msg(M_FATAL, "Failed to set restricted TLS cipher list: %s", openssl_ciphers);
418 }
419}
420
421#ifdef TLS1_3_VERSION
422static void
423convert_tls13_list_to_openssl(char *openssl_ciphers, size_t len, const char *ciphers)
424{
425 /*
426 * OpenSSL (and official IANA) cipher names have _ in them. We
427 * historically used names with - in them. Silently convert names
428 * with - to names with _ to support both
429 */
430 size_t ciphers_len = strlcpy(openssl_ciphers, ciphers, len);
431 if (ciphers_len >= len)
432 {
433 msg(M_FATAL, "Failed to set restricted TLS 1.3 cipher list, too long (>%zu).",
434 len - 1);
435 }
436
437 for (size_t i = 0; i < ciphers_len; i++)
438 {
439 if (openssl_ciphers[i] == '-')
440 {
441 openssl_ciphers[i] = '_';
442 }
443 }
444}
445#endif
446
447void
448tls_ctx_restrict_ciphers_tls13(struct tls_root_ctx *ctx, const char *ciphers)
449{
450 if (ciphers == NULL)
451 {
452 /* default cipher list of OpenSSL is sane, do not set own
453 * default as we do with tls-cipher */
454 return;
455 }
456
457 ASSERT(NULL != ctx);
458
459 char openssl_ciphers[4096];
460 convert_tls13_list_to_openssl(openssl_ciphers, sizeof(openssl_ciphers), ciphers);
461
462 if (!SSL_CTX_set_ciphersuites(ctx->ctx, openssl_ciphers))
463 {
464 crypto_msg(M_FATAL, "Failed to set restricted TLS 1.3 cipher list: %s", openssl_ciphers);
465 }
466}
467
468void
469tls_ctx_set_cert_profile(struct tls_root_ctx *ctx, const char *profile)
470{
471#if (!defined(LIBRESSL_VERSION_NUMBER) || LIBRESSL_VERSION_NUMBER > 0x3060000fL) \
472 && !defined(OPENSSL_IS_AWSLC)
473 /* OpenSSL does not have certificate profiles, but a complex set of
474 * callbacks that we could try to implement to achieve something similar.
475 * For now, use OpenSSL's security levels to achieve similar (but not equal)
476 * behaviour. */
477 if (!profile || 0 == strcmp(profile, "legacy"))
478 {
479 SSL_CTX_set_security_level(ctx->ctx, 1);
480 }
481 else if (0 == strcmp(profile, "insecure"))
482 {
483 SSL_CTX_set_security_level(ctx->ctx, 0);
484 }
485 else if (0 == strcmp(profile, "preferred"))
486 {
487 SSL_CTX_set_security_level(ctx->ctx, 2);
488 }
489 else if (0 == strcmp(profile, "suiteb"))
490 {
491 SSL_CTX_set_security_level(ctx->ctx, 3);
492 SSL_CTX_set_cipher_list(ctx->ctx, "SUITEB128");
493 }
494 else
495 {
496 msg(M_FATAL, "ERROR: Invalid cert profile: %s", profile);
497 }
498#else
499 if (profile)
500 {
501 msg(M_WARN,
502 "WARNING: OpenSSL 1.1.0, AWS-LC and LibreSSL < 3.6.0 do not "
503 "support --tls-cert-profile, ignoring user-set profile: '%s'",
504 profile);
505 }
506#endif
507}
508
509void
510tls_ctx_set_tls_groups(struct tls_root_ctx *ctx, const char *groups)
511{
512 ASSERT(ctx);
513#if OPENSSL_VERSION_NUMBER < 0x30000000L && !defined(ENABLE_CRYPTO_WOLFSSL)
514 struct gc_arena gc = gc_new();
515 /* This method could be as easy as
516 * SSL_CTX_set1_groups_list(ctx->ctx, groups)
517 * but OpenSSL (< 3.0) does not like the name secp256r1 for prime256v1
518 * This is one of the important curves.
519 * To support the same name for OpenSSL and mbedTLS, we do
520 * this dance.
521 * Also note that the code is wrong in the presence of OpenSSL3 providers.
522 */
523
524 int groups_count = get_num_elements(groups, ':');
525
526 int *glist;
527 /* Allocate an array for them */
528 ALLOC_ARRAY_CLEAR_GC(glist, int, groups_count, &gc);
529
530 /* Parse allowed ciphers, getting IDs */
531 int glistlen = 0;
532 char *tmp_groups = string_alloc(groups, &gc);
533
534 const char *token;
535 while ((token = strsep(&tmp_groups, ":")))
536 {
537 if (streq(token, "secp256r1"))
538 {
539 token = "prime256v1";
540 }
541 int nid = OBJ_sn2nid(token);
542
543 if (nid == 0)
544 {
545 msg(M_WARN, "Warning unknown curve/group specified: %s", token);
546 }
547 else
548 {
549 glist[glistlen] = nid;
550 glistlen++;
551 }
552 }
553
554 if (!SSL_CTX_set1_groups(ctx->ctx, glist, glistlen))
555 {
556 crypto_msg(M_FATAL, "Failed to set allowed TLS group list: %s", groups);
557 }
558 gc_free(&gc);
559#else /* if OPENSSL_VERSION_NUMBER < 0x30000000L */
560 if (!SSL_CTX_set1_groups_list(ctx->ctx, groups))
561 {
562 crypto_msg(M_FATAL, "Failed to set allowed TLS group list: %s", groups);
563 }
564#endif /* if OPENSSL_VERSION_NUMBER < 0x30000000L */
565}
566
567#if OPENSSL_VERSION_NUMBER < 0x40000000L
568void
570{
571 int ret;
572 const X509 *cert;
573
574 ASSERT(ctx);
575
576 cert = SSL_CTX_get0_certificate(ctx->ctx);
577
578 if (cert == NULL)
579 {
580 return; /* Nothing to check if there is no certificate */
581 }
582
583 ret = X509_cmp_time(X509_get0_notBefore(cert), NULL);
584 if (ret == 0)
585 {
586 msg(D_TLS_DEBUG_MED, "Failed to read certificate notBefore field.");
587 }
588 if (ret > 0)
589 {
590 msg(M_WARN, "WARNING: Your certificate is not yet valid!");
591 }
592
593 ret = X509_cmp_time(X509_get0_notAfter(cert), NULL);
594 if (ret == 0)
595 {
596 msg(D_TLS_DEBUG_MED, "Failed to read certificate notAfter field.");
597 }
598 if (ret < 0)
599 {
600 msg(M_WARN, "WARNING: Your certificate has expired!");
601 }
602}
603#else
604void
605tls_ctx_check_cert_time(const struct tls_root_ctx *ctx)
606{
607 const X509 *cert;
608 ASSERT(ctx);
609
610 cert = SSL_CTX_get0_certificate(ctx->ctx);
611
612 if (cert == NULL)
613 {
614 return; /* Nothing to check if there is no certificate */
615 }
616
617 X509_VERIFY_PARAM *vpm = X509_VERIFY_PARAM_new();
618
619 if (vpm == NULL)
620 {
621 msg(D_TLS_DEBUG_MED, "Failed to initialise certificate verification parameters.");
622 return;
623 }
624
625 X509_VERIFY_PARAM_set_flags(vpm, X509_V_FLAG_USE_CHECK_TIME);
626 X509_VERIFY_PARAM_set_time(vpm, now);
627
628 int error = 0;
629 int ret = X509_check_certificate_times(vpm, cert, &error);
630 X509_VERIFY_PARAM_free(vpm);
631
632 if (ret == 1)
633 {
634 return;
635 }
636
637 switch (error)
638 {
639 case X509_V_ERR_ERROR_IN_CERT_NOT_BEFORE_FIELD:
640 msg(D_TLS_DEBUG_MED, "Failed to read certificate notBefore field.");
641 break;
642
643 case X509_V_ERR_CERT_NOT_YET_VALID:
644 msg(M_WARN, "WARNING: Your certificate is not yet valid!");
645 break;
646
647 case X509_V_ERR_ERROR_IN_CERT_NOT_AFTER_FIELD:
648 msg(D_TLS_DEBUG_MED, "Failed to read certificate notAfter field.");
649 break;
650
651 case X509_V_ERR_CERT_HAS_EXPIRED:
652 msg(M_WARN, "WARNING: Your certificate has expired!");
653 break;
654 }
655}
656#endif
657
658void
659tls_ctx_load_dh_params(struct tls_root_ctx *ctx, const char *dh_file, bool dh_file_inline)
660{
661 BIO *bio;
662
663 ASSERT(NULL != ctx);
664
665 if (dh_file_inline)
666 {
667 if (!(bio = BIO_new_mem_buf((char *)dh_file, -1)))
668 {
669 crypto_msg(M_FATAL, "Cannot open memory BIO for inline DH parameters");
670 }
671 }
672 else
673 {
674 /* Get Diffie Hellman Parameters */
675 if (!(bio = BIO_new_file(dh_file, "r")))
676 {
677 crypto_msg(M_FATAL, "Cannot open %s for DH parameters", dh_file);
678 }
679 }
680
681#if OPENSSL_VERSION_NUMBER >= 0x30000000L
682 EVP_PKEY *dh = PEM_read_bio_Parameters(bio, NULL);
683 BIO_free(bio);
684
685 if (!dh)
686 {
687 crypto_msg(M_FATAL, "Cannot load DH parameters from %s",
688 print_key_filename(dh_file, dh_file_inline));
689 }
690 if (!SSL_CTX_set0_tmp_dh_pkey(ctx->ctx, dh))
691 {
692 crypto_msg(M_FATAL, "SSL_CTX_set0_tmp_dh_pkey");
693 }
694
695 msg(D_TLS_DEBUG_LOW, "Diffie-Hellman initialized with %d bit key", 8 * EVP_PKEY_get_size(dh));
696#else /* if OPENSSL_VERSION_NUMBER >= 0x30000000L */
697 DH *dh = PEM_read_bio_DHparams(bio, NULL, NULL, NULL);
698 BIO_free(bio);
699
700 if (!dh)
701 {
702 crypto_msg(M_FATAL, "Cannot load DH parameters from %s",
703 print_key_filename(dh_file, dh_file_inline));
704 }
705 if (!SSL_CTX_set_tmp_dh(ctx->ctx, dh))
706 {
707 crypto_msg(M_FATAL, "SSL_CTX_set_tmp_dh");
708 }
709
710 msg(D_TLS_DEBUG_LOW, "Diffie-Hellman initialized with %d bit key", 8 * DH_size(dh));
711
712 DH_free(dh);
713#endif /* if OPENSSL_VERSION_NUMBER >= 0x30000000L */
714}
715
716void
717tls_ctx_load_ecdh_params(struct tls_root_ctx *ctx, const char *curve_name)
718{
719#if OPENSSL_VERSION_NUMBER >= 0x30000000L
720 if (curve_name != NULL)
721 {
722 msg(M_WARN, "WARNING: OpenSSL 3.0+ builds do not support specifying an "
723 "ECDH curve with --ecdh-curve, using default curves. Use "
724 "--tls-groups to specify groups.");
725 }
726#elif !defined(OPENSSL_NO_EC)
727 int nid = NID_undef;
728 EC_KEY *ecdh = NULL;
729 const char *sname = NULL;
730
731 /* Generate a new ECDH key for each SSL session (for non-ephemeral ECDH) */
732 SSL_CTX_set_options(ctx->ctx, SSL_OP_SINGLE_ECDH_USE);
733
734 if (curve_name != NULL)
735 {
736 /* Use user supplied curve if given */
737 msg(D_TLS_DEBUG, "Using user specified ECDH curve (%s)", curve_name);
738 nid = OBJ_sn2nid(curve_name);
739 }
740 else
741 {
742 return;
743 }
744
745 /* Translate NID back to name , just for kicks */
746 sname = OBJ_nid2sn(nid);
747 if (sname == NULL)
748 {
749 sname = "(Unknown)";
750 }
751
752 /* Create new EC key and set as ECDH key */
753 if (NID_undef == nid || NULL == (ecdh = EC_KEY_new_by_curve_name(nid)))
754 {
755 /* Creating key failed, fall back on sane default */
756 ecdh = EC_KEY_new_by_curve_name(NID_secp384r1);
757 const char *source =
758 (NULL == curve_name) ? "extract curve from certificate" : "use supplied curve";
759 msg(D_TLS_DEBUG_LOW, "Failed to %s (%s), using secp384r1 instead.", source, sname);
760 sname = OBJ_nid2sn(NID_secp384r1);
761 }
762
763 if (!SSL_CTX_set_tmp_ecdh(ctx->ctx, ecdh))
764 {
765 crypto_msg(M_FATAL, "SSL_CTX_set_tmp_ecdh: cannot add curve");
766 }
767
768 msg(D_TLS_DEBUG_LOW, "ECDH curve %s added", sname);
769
770 EC_KEY_free(ecdh);
771#else /* ifndef OPENSSL_NO_EC */
772 msg(D_LOW, "Your OpenSSL library was built without elliptic curve support."
773 " Skipping ECDH parameter loading.");
774#endif /* OPENSSL_NO_EC */
775}
776
777#if defined(HAVE_OPENSSL_STORE_API)
783static int
784ui_reader(UI *ui, UI_STRING *uis)
785{
786 SSL_CTX *ctx = UI_get0_user_data(ui);
787
788 if (UI_get_string_type(uis) == UIT_PROMPT)
789 {
790 const char *prompt = UI_get0_output_string(uis);
791
792 /* If pkcs#11 Use custom prompt similar to pkcs11-helper */
793 if (strstr(prompt, "PKCS#11"))
794 {
795 struct user_pass up;
796 CLEAR(up);
797 get_user_pass(&up, NULL, "PKCS#11 token",
799 UI_set_result(ui, uis, up.password);
800 purge_user_pass(&up, true);
801 }
802 else /* use our generic 'Private Key' passphrase callback */
803 {
805 pem_password_cb *cb = SSL_CTX_get_default_passwd_cb(ctx);
806 void *d = SSL_CTX_get_default_passwd_cb_userdata(ctx);
807
808 cb(password, sizeof(password), 0, d);
809 UI_set_result(ui, uis, password);
811 }
812
813 return 1;
814 }
815 return 0;
816}
817
818static void
819clear_ossl_store_error(OSSL_STORE_CTX *store_ctx)
820{
821 if (OSSL_STORE_error(store_ctx))
822 {
823 ERR_clear_error();
824 }
825}
826#endif /* defined(HAVE_OPENSSL_STORE_API) */
827
836static void *
837load_pkey_from_uri(const char *uri, SSL_CTX *ssl_ctx)
838{
839 EVP_PKEY *pkey = NULL;
840
841#if !defined(HAVE_OPENSSL_STORE_API)
842
843 /* Treat the uri as file name */
844 BIO *in = BIO_new_file(uri, "r");
845 if (!in)
846 {
847 return NULL;
848 }
849 pkey = PEM_read_bio_PrivateKey(in, NULL, SSL_CTX_get_default_passwd_cb(ssl_ctx),
850 SSL_CTX_get_default_passwd_cb_userdata(ssl_ctx));
851 BIO_free(in);
852
853#else /* defined(HAVE_OPENSSL_STORE_API) */
854
855 OSSL_STORE_CTX *store_ctx = NULL;
856 OSSL_STORE_INFO *info = NULL;
857
858 UI_METHOD *ui_method = UI_create_method("openvpn");
859 if (!ui_method)
860 {
861 msg(M_WARN, "OpenSSL UI creation failed");
862 return NULL;
863 }
864 UI_method_set_reader(ui_method, ui_reader);
865
866 store_ctx = OSSL_STORE_open_ex(uri, tls_libctx, NULL, ui_method, ssl_ctx, NULL, NULL, NULL);
867 if (!store_ctx)
868 {
869 goto end;
870 }
871 if (OSSL_STORE_expect(store_ctx, OSSL_STORE_INFO_PKEY) != 1)
872 {
873 goto end;
874 }
875 while (1)
876 {
877 info = OSSL_STORE_load(store_ctx);
878 if (info || OSSL_STORE_eof(store_ctx))
879 {
880 break;
881 }
882 /* OPENSSL_STORE_load can return error and still have usable objects to follow.
883 * ref: man OPENSSL_STORE_open
884 * Clear error and recurse through the file if info = NULL and eof not reached
885 */
886 clear_ossl_store_error(store_ctx);
887 }
888 if (!info)
889 {
890 goto end;
891 }
892 pkey = OSSL_STORE_INFO_get1_PKEY(info);
893 OSSL_STORE_INFO_free(info);
894 msg(D_TLS_DEBUG_MED, "Found pkey in store using URI: %s", uri);
895
896end:
897 OSSL_STORE_close(store_ctx);
898 UI_destroy_method(ui_method);
899
900#endif /* defined(HAVE_OPENSSL_STORE_API) */
901
902 return pkey;
903}
904
905int
906tls_ctx_load_pkcs12(struct tls_root_ctx *ctx, const char *pkcs12_file, bool pkcs12_file_inline,
907 bool load_ca_file)
908{
909 FILE *fp;
910 EVP_PKEY *pkey;
911 X509 *cert;
912 STACK_OF(X509) *ca = NULL;
913 PKCS12 *p12;
914 char password[256];
915
916 ASSERT(NULL != ctx);
917
918 if (pkcs12_file_inline)
919 {
920 BIO *b64 = BIO_new(BIO_f_base64());
921 BIO *bio = BIO_new_mem_buf((void *)pkcs12_file, (int)strlen(pkcs12_file));
922 ASSERT(b64 && bio);
923 BIO_push(b64, bio);
924 p12 = d2i_PKCS12_bio(b64, NULL);
925 if (!p12)
926 {
927 crypto_msg(M_FATAL, "Error reading inline PKCS#12 file");
928 }
929 BIO_free(b64);
930 BIO_free(bio);
931 }
932 else
933 {
934 /* Load the PKCS #12 file */
935 if (!(fp = platform_fopen(pkcs12_file, "rb")))
936 {
937 crypto_msg(M_FATAL, "Error opening file %s", pkcs12_file);
938 }
939 p12 = d2i_PKCS12_fp(fp, NULL);
940 fclose(fp);
941 if (!p12)
942 {
943 crypto_msg(M_FATAL, "Error reading PKCS#12 file %s", pkcs12_file);
944 }
945 }
946
947 /* Parse the PKCS #12 file */
948 if (!PKCS12_parse(p12, "", &pkey, &cert, &ca))
949 {
950 pem_password_callback(password, sizeof(password) - 1, 0, NULL);
951 /* Reparse the PKCS #12 file with password */
952 ca = NULL;
953 if (!PKCS12_parse(p12, password, &pkey, &cert, &ca))
954 {
955 crypto_msg(M_WARN, "Decoding PKCS12 failed. Probably wrong password "
956 "or unsupported/legacy encryption");
957#ifdef ENABLE_MANAGEMENT
958 if (management && (ERR_GET_REASON(ERR_peek_error()) == PKCS12_R_MAC_VERIFY_FAILURE))
959 {
961 }
962#endif
963 PKCS12_free(p12);
964 return 1;
965 }
966 }
967 PKCS12_free(p12);
968
969 /* Load Certificate */
970 if (!SSL_CTX_use_certificate(ctx->ctx, cert))
971 {
973 crypto_msg(M_FATAL, "Cannot use certificate");
974 }
975
976 /* Load Private Key */
977 if (!SSL_CTX_use_PrivateKey(ctx->ctx, pkey))
978 {
979 crypto_msg(M_FATAL, "Cannot use private key");
980 }
981
982 /* Check Private Key */
983 if (!SSL_CTX_check_private_key(ctx->ctx))
984 {
985 crypto_msg(M_FATAL, "Private key does not match the certificate");
986 }
987
988 /* Set Certificate Verification chain */
989 if (load_ca_file)
990 {
991 /* Add CAs from PKCS12 to the cert store and mark them as trusted.
992 * They're also used to fill in the chain of intermediate certs as
993 * necessary.
994 */
995 if (ca && sk_X509_num(ca))
996 {
997 for (openssl_stack_size_t i = 0; i < sk_X509_num(ca); i++)
998 {
999 X509_STORE *cert_store = SSL_CTX_get_cert_store(ctx->ctx);
1000 if (!X509_STORE_add_cert(cert_store, sk_X509_value(ca, i)))
1001 {
1003 "Cannot add certificate to certificate chain (X509_STORE_add_cert)");
1004 }
1005 if (!SSL_CTX_add_client_CA(ctx->ctx, sk_X509_value(ca, i)))
1006 {
1008 "Cannot add certificate to client CA list (SSL_CTX_add_client_CA)");
1009 }
1010 }
1011 }
1012 }
1013 else
1014 {
1015 /* If trusted CA certs were loaded from a PEM file, and we ignore the
1016 * ones in PKCS12, do load PKCS12-provided certs to the client extra
1017 * certs chain just in case they include intermediate CAs needed to
1018 * prove my identity to the other end. This does not make them trusted.
1019 */
1020 if (ca && sk_X509_num(ca))
1021 {
1022 for (openssl_stack_size_t i = 0; i < sk_X509_num(ca); i++)
1023 {
1024 if (!SSL_CTX_add_extra_chain_cert(ctx->ctx, sk_X509_value(ca, i)))
1025 {
1026 crypto_msg(
1027 M_FATAL,
1028 "Cannot add extra certificate to chain (SSL_CTX_add_extra_chain_cert)");
1029 }
1030 }
1031 }
1032 }
1033 return 0;
1034}
1035
1036#ifdef ENABLE_CRYPTOAPI
1037void
1038tls_ctx_load_cryptoapi(struct tls_root_ctx *ctx, const char *cryptoapi_cert)
1039{
1040 ASSERT(NULL != ctx);
1041
1042 /* Load Certificate and Private Key */
1043 if (!SSL_CTX_use_CryptoAPI_certificate(ctx->ctx, cryptoapi_cert))
1044 {
1045 crypto_msg(M_FATAL, "Cannot load certificate \"%s\" from Microsoft Certificate Store",
1046 cryptoapi_cert);
1047 }
1048}
1049#endif /* ENABLE_CRYPTOAPI */
1050
1051static void
1052tls_ctx_add_extra_certs(struct tls_root_ctx *ctx, BIO *bio, bool optional)
1053{
1054 X509 *cert;
1055 while (true)
1056 {
1057 cert = NULL;
1058 if (!PEM_read_bio_X509(bio, &cert, NULL, NULL))
1059 {
1060 /* a PEM_R_NO_START_LINE "Error" indicates that no certificate
1061 * is found in the buffer. If loading more certificates is
1062 * optional, break without raising an error
1063 */
1064 if (optional && ERR_GET_REASON(ERR_peek_error()) == PEM_R_NO_START_LINE)
1065 {
1066 /* remove that error from error stack */
1067 (void)ERR_get_error();
1068 break;
1069 }
1070
1071 /* Otherwise, bail out with error */
1072 crypto_msg(M_FATAL, "Error reading extra certificate");
1073 }
1074 /* takes ownership of cert like a set1 method */
1075 if (SSL_CTX_add_extra_chain_cert(ctx->ctx, cert) != 1)
1076 {
1077 crypto_msg(M_FATAL, "Error adding extra certificate");
1078 }
1079 /* We loaded at least one certificate, so loading more is optional */
1080 optional = true;
1081 }
1082}
1083
1084static bool
1086{
1087#if defined(HAVE_OPENSSL_STORE_API)
1088 return 1;
1089#else
1090 return 0;
1091#endif
1092}
1093
1094static void
1095tls_ctx_load_cert_uri(struct tls_root_ctx *tls_ctx, const char *uri)
1096{
1097#if defined(HAVE_OPENSSL_STORE_API)
1098 X509 *x = NULL;
1099 int ret = 0;
1100 OSSL_STORE_CTX *store_ctx = NULL;
1101 OSSL_STORE_INFO *info = NULL;
1102
1103 ASSERT(NULL != tls_ctx);
1104
1105 UI_METHOD *ui_method = UI_create_method("openvpn");
1106 if (!ui_method)
1107 {
1108 msg(M_WARN, "OpenSSL UI method creation failed");
1109 goto end;
1110 }
1111 UI_method_set_reader(ui_method, ui_reader);
1112
1113 store_ctx =
1114 OSSL_STORE_open_ex(uri, tls_libctx, NULL, ui_method, tls_ctx->ctx, NULL, NULL, NULL);
1115 if (!store_ctx)
1116 {
1117 goto end;
1118 }
1119 if (OSSL_STORE_expect(store_ctx, OSSL_STORE_INFO_CERT) != 1)
1120 {
1121 goto end;
1122 }
1123
1124 while (1)
1125 {
1126 info = OSSL_STORE_load(store_ctx);
1127 if (info || OSSL_STORE_eof(store_ctx))
1128 {
1129 break;
1130 }
1131 /* OPENSSL_STORE_load can return error and still have usable objects to follow.
1132 * ref: man OPENSSL_STORE_open
1133 * Clear error and recurse through the file if info = NULL and eof not reached.
1134 */
1135 clear_ossl_store_error(store_ctx);
1136 }
1137 if (!info)
1138 {
1139 goto end;
1140 }
1141
1142 x = OSSL_STORE_INFO_get0_CERT(info);
1143 if (x == NULL)
1144 {
1145 goto end;
1146 }
1147 msg(D_TLS_DEBUG_MED, "Found cert in store using URI: %s", uri);
1148
1149 ret = SSL_CTX_use_certificate(tls_ctx->ctx, x);
1150 if (!ret)
1151 {
1152 goto end;
1153 }
1154 OSSL_STORE_INFO_free(info);
1155 info = NULL;
1156
1157 /* iterate through the store and add extra certificates if any to the chain */
1158 while (!OSSL_STORE_eof(store_ctx))
1159 {
1160 info = OSSL_STORE_load(store_ctx);
1161 if (!info)
1162 {
1163 clear_ossl_store_error(store_ctx);
1164 continue;
1165 }
1166 x = OSSL_STORE_INFO_get1_CERT(info);
1167 if (x && SSL_CTX_add_extra_chain_cert(tls_ctx->ctx, x) != 1)
1168 {
1169 X509_free(x);
1170 crypto_msg(M_FATAL, "Error adding extra certificate");
1171 break;
1172 }
1173 OSSL_STORE_INFO_free(info);
1174 info = NULL;
1175 }
1176
1177end:
1178 if (!ret)
1179 {
1181 crypto_msg(M_FATAL, "Cannot load certificate from URI <%s>", uri);
1182 }
1183 else
1184 {
1186 }
1187
1188 UI_destroy_method(ui_method);
1189 OSSL_STORE_INFO_free(info);
1190 OSSL_STORE_close(store_ctx);
1191#else /* defined(HAVE_OPENSSL_STORE_API */
1192 ASSERT(0);
1193#endif /* defined(HAVE_OPENSSL_STORE_API */
1194}
1195
1196static void
1197tls_ctx_load_cert_pem_file(struct tls_root_ctx *ctx, const char *cert_file, bool cert_file_inline)
1198{
1199 BIO *in = NULL;
1200 X509 *x = NULL;
1201 int ret = 0;
1202
1203 ASSERT(NULL != ctx);
1204
1205 if (cert_file_inline)
1206 {
1207 in = BIO_new_mem_buf((char *)cert_file, -1);
1208 }
1209 else
1210 {
1211 in = BIO_new_file((char *)cert_file, "r");
1212 }
1213
1214 if (in == NULL)
1215 {
1216 SSLerr(SSL_F_SSL_CTX_USE_CERTIFICATE_FILE, ERR_R_SYS_LIB);
1217 goto end;
1218 }
1219
1220 x = PEM_read_bio_X509(in, NULL, SSL_CTX_get_default_passwd_cb(ctx->ctx),
1221 SSL_CTX_get_default_passwd_cb_userdata(ctx->ctx));
1222 if (x == NULL)
1223 {
1224 SSLerr(SSL_F_SSL_CTX_USE_CERTIFICATE_FILE, ERR_R_PEM_LIB);
1225 goto end;
1226 }
1227
1228 ret = SSL_CTX_use_certificate(ctx->ctx, x);
1229 if (ret)
1230 {
1231 tls_ctx_add_extra_certs(ctx, in, true);
1232 }
1233
1234end:
1235 if (!ret)
1236 {
1238 if (cert_file_inline)
1239 {
1240 crypto_msg(M_FATAL, "Cannot load inline certificate file");
1241 }
1242 else
1243 {
1244 crypto_msg(M_FATAL, "Cannot load certificate file %s", cert_file);
1245 }
1246 }
1247 else
1248 {
1250 }
1251
1252 BIO_free(in);
1253 X509_free(x);
1254}
1255
1256void
1257tls_ctx_load_cert_file(struct tls_root_ctx *ctx, const char *cert_file, bool cert_file_inline)
1258{
1259 if (cert_uri_supported() && !cert_file_inline)
1260 {
1261 tls_ctx_load_cert_uri(ctx, cert_file);
1262 }
1263 else
1264 {
1265 tls_ctx_load_cert_pem_file(ctx, cert_file, cert_file_inline);
1266 }
1267}
1268
1269int
1270tls_ctx_load_priv_file(struct tls_root_ctx *ctx, const char *priv_key_file,
1271 bool priv_key_file_inline)
1272{
1273 SSL_CTX *ssl_ctx = NULL;
1274 BIO *in = NULL;
1275 EVP_PKEY *pkey = NULL;
1276 int ret = 1;
1277
1278 ASSERT(NULL != ctx);
1279
1280 ssl_ctx = ctx->ctx;
1281
1282 if (priv_key_file_inline)
1283 {
1284 in = BIO_new_mem_buf((char *)priv_key_file, -1);
1285 if (in == NULL)
1286 {
1287 goto end;
1288 }
1289 pkey = PEM_read_bio_PrivateKey(in, NULL, SSL_CTX_get_default_passwd_cb(ctx->ctx),
1290 SSL_CTX_get_default_passwd_cb_userdata(ctx->ctx));
1291 }
1292 else
1293 {
1294 pkey = load_pkey_from_uri(priv_key_file, ssl_ctx);
1295 }
1296
1297 if (!pkey || !SSL_CTX_use_PrivateKey(ssl_ctx, pkey))
1298 {
1299#ifdef ENABLE_MANAGEMENT
1300 if (management && (ERR_GET_REASON(ERR_peek_error()) == EVP_R_BAD_DECRYPT))
1301 {
1303 }
1304#endif
1305 crypto_msg(M_WARN, "Cannot load private key file %s",
1306 print_key_filename(priv_key_file, priv_key_file_inline));
1307 goto end;
1308 }
1309
1310 /* Check Private Key */
1311 if (!SSL_CTX_check_private_key(ssl_ctx))
1312 {
1313 crypto_msg(M_FATAL, "Private key does not match the certificate");
1314 }
1315 ret = 0;
1316
1317end:
1318 EVP_PKEY_free(pkey);
1319 BIO_free(in);
1320 return ret;
1321}
1322
1323void
1324backend_tls_ctx_reload_crl(struct tls_root_ctx *ssl_ctx, const char *crl_file, bool crl_inline)
1325{
1326 BIO *in = NULL;
1327 STACK_OF(X509_CRL) *crls = NULL;
1328
1329 X509_STORE *store = SSL_CTX_get_cert_store(ssl_ctx->ctx);
1330 if (!store)
1331 {
1332 crypto_msg(M_FATAL, "Cannot get certificate store");
1333 }
1334
1335 sk_X509_CRL_pop_free(ssl_ctx->crls, X509_CRL_free);
1336 ssl_ctx->crls = NULL;
1337
1338 X509_STORE_set_flags(store, X509_V_FLAG_CRL_CHECK | X509_V_FLAG_CRL_CHECK_ALL);
1339
1340 if (crl_inline)
1341 {
1342 in = BIO_new_mem_buf((char *)crl_file, -1);
1343 }
1344 else
1345 {
1346 in = BIO_new_file(crl_file, "r");
1347 }
1348
1349 if (in == NULL)
1350 {
1351 msg(M_WARN, "CRL: cannot read: %s", print_key_filename(crl_file, crl_inline));
1352 return;
1353 }
1354
1355 crls = sk_X509_CRL_new_null();
1356 if (crls == NULL)
1357 {
1358 crypto_msg(M_FATAL, "CRL: cannot create CRL list");
1359 }
1360
1361 int num_crls_loaded = 0;
1362 /*
1363 * The EOF test below must only see errors raised by
1364 * PEM_read_bio_X509_CRL(). Anything already queued was left by an
1365 * earlier operation in this thread and would otherwise be what
1366 * ERR_peek_error() returns, turning a clean EOF into "cannot read CRL".
1367 * Report it, since that is a bug elsewhere, then start from an empty
1368 * queue (crypto_msg() drains the queue while printing it).
1369 */
1370 if (ERR_peek_error() != 0)
1371 {
1372 crypto_msg(D_LOW, "CRL: OpenSSL error queue not empty on CRL load");
1373 }
1374 ERR_clear_error();
1375 while (true)
1376 {
1377 X509_CRL *crl = PEM_read_bio_X509_CRL(in, NULL, NULL, NULL);
1378 if (crl == NULL)
1379 {
1380 /*
1381 * PEM_R_NO_START_LINE can be considered equivalent to EOF.
1382 * ERR_peek_last_error() is the error PEM_read_bio_X509_CRL()
1383 * raised last; ERR_peek_error() would be the oldest queued one.
1384 */
1385 bool eof = ERR_GET_REASON(ERR_peek_last_error()) == PEM_R_NO_START_LINE;
1386 /* but warn if no CRLs have been loaded */
1387 if (num_crls_loaded > 0 && eof)
1388 {
1389 /* remove that error from error stack */
1390 ERR_clear_error();
1391 break;
1392 }
1393
1394 crypto_msg(M_WARN, "CRL: cannot read CRL from file %s",
1395 print_key_filename(crl_file, crl_inline));
1396 break;
1397 }
1398
1399 if (!sk_X509_CRL_push(crls, crl))
1400 {
1401 crypto_msg(M_FATAL, "CRL: cannot add CRL to list");
1402 }
1403 num_crls_loaded++;
1404 }
1405 msg(M_INFO, "CRL: loaded %d CRLs from file %s", num_crls_loaded, crl_file);
1406 ssl_ctx->crls = crls;
1407 BIO_free(in);
1408}
1409
1410
1411#if defined(ENABLE_MANAGEMENT) && !defined(HAVE_XKEY_PROVIDER)
1412
1413/* encrypt */
1414static int
1415rsa_pub_enc(int flen, const unsigned char *from, unsigned char *to, RSA *rsa, int padding)
1416{
1417 ASSERT(0);
1418 return -1;
1419}
1420
1421/* verify arbitrary data */
1422static int
1423rsa_pub_dec(int flen, const unsigned char *from, unsigned char *to, RSA *rsa, int padding)
1424{
1425 ASSERT(0);
1426 return -1;
1427}
1428
1429/* decrypt */
1430static int
1431rsa_priv_dec(int flen, const unsigned char *from, unsigned char *to, RSA *rsa, int padding)
1432{
1433 ASSERT(0);
1434 return -1;
1435}
1436
1437/* called at RSA_free */
1438static int
1440{
1441 /* meth was allocated in tls_ctx_use_management_external_key() ; since
1442 * this function is called when the parent RSA object is destroyed,
1443 * it is no longer used after this point so kill it. */
1444 const RSA_METHOD *meth = RSA_get_method(rsa);
1445 RSA_meth_free((RSA_METHOD *)meth);
1446 return 1;
1447}
1448
1449/*
1450 * Convert OpenSSL's constant to the strings used in the management
1451 * interface query
1452 */
1453const char *
1454get_rsa_padding_name(const int padding)
1455{
1456 switch (padding)
1457 {
1458 case RSA_PKCS1_PADDING:
1459 return "RSA_PKCS1_PADDING";
1460
1461 case RSA_NO_PADDING:
1462 return "RSA_NO_PADDING";
1463
1464 default:
1465 return "UNKNOWN";
1466 }
1467}
1468
1480static int
1481get_sig_from_man(const unsigned char *dgst, unsigned int dgstlen, unsigned char *sig,
1482 unsigned int siglen, const char *algorithm)
1483{
1484 char *in_b64 = NULL;
1485 char *out_b64 = NULL;
1486 int len = -1;
1487
1488 int bencret = openvpn_base64_encode(dgst, dgstlen, &in_b64);
1489
1490 if (management && bencret > 0)
1491 {
1492 out_b64 = management_query_pk_sig(management, in_b64, algorithm);
1493 }
1494 if (out_b64)
1495 {
1496 len = openvpn_base64_decode(out_b64, sig, siglen);
1497 }
1498
1499 free(in_b64);
1500 free(out_b64);
1501 return len;
1502}
1503
1504/* sign arbitrary data */
1505static int
1506rsa_priv_enc(int flen, const unsigned char *from, unsigned char *to, RSA *rsa, int padding)
1507{
1508 int len = RSA_size(rsa);
1509
1510 if (padding != RSA_PKCS1_PADDING && padding != RSA_NO_PADDING)
1511 {
1512 RSAerr(RSA_F_RSA_OSSL_PRIVATE_ENCRYPT, RSA_R_UNKNOWN_PADDING_TYPE);
1513 return -1;
1514 }
1515
1516 int ret = get_sig_from_man(from, flen, to, len, get_rsa_padding_name(padding));
1517
1518 return (ret == len) ? ret : -1;
1519}
1520
1521static int
1522tls_ctx_use_external_rsa_key(struct tls_root_ctx *ctx, EVP_PKEY *pkey)
1523{
1524 RSA *rsa = NULL;
1525 RSA_METHOD *rsa_meth;
1526
1527 ASSERT(NULL != ctx);
1528
1529 const RSA *pub_rsa = EVP_PKEY_get0_RSA(pkey);
1530 ASSERT(NULL != pub_rsa);
1531
1532 /* allocate custom RSA method object */
1533 rsa_meth = RSA_meth_new("OpenVPN external private key RSA Method", RSA_METHOD_FLAG_NO_CHECK);
1534 check_malloc_return(rsa_meth);
1535 RSA_meth_set_pub_enc(rsa_meth, rsa_pub_enc);
1536 RSA_meth_set_pub_dec(rsa_meth, rsa_pub_dec);
1537 RSA_meth_set_priv_enc(rsa_meth, rsa_priv_enc);
1538 RSA_meth_set_priv_dec(rsa_meth, rsa_priv_dec);
1539 RSA_meth_set_init(rsa_meth, NULL);
1540 RSA_meth_set_finish(rsa_meth, openvpn_extkey_rsa_finish);
1541 RSA_meth_set0_app_data(rsa_meth, NULL);
1542
1543 /* allocate RSA object */
1544 rsa = RSA_new();
1545 if (rsa == NULL)
1546 {
1547 SSLerr(SSL_F_SSL_USE_PRIVATEKEY, ERR_R_MALLOC_FAILURE);
1548 goto err;
1549 }
1550
1551 /* initialize RSA object */
1552 const BIGNUM *n = NULL;
1553 const BIGNUM *e = NULL;
1554 RSA_get0_key(pub_rsa, &n, &e, NULL);
1555 RSA_set0_key(rsa, BN_dup(n), BN_dup(e), NULL);
1556 RSA_set_flags(rsa, RSA_flags(rsa) | RSA_FLAG_EXT_PKEY);
1557 if (!RSA_set_method(rsa, rsa_meth))
1558 {
1559 RSA_meth_free(rsa_meth);
1560 goto err;
1561 }
1562 /* from this point rsa_meth will get freed with rsa */
1563
1564 /* bind our custom RSA object to ssl_ctx */
1565 if (!SSL_CTX_use_RSAPrivateKey(ctx->ctx, rsa))
1566 {
1567 goto err;
1568 }
1569
1570 RSA_free(rsa); /* doesn't necessarily free, just decrements refcount */
1571 return 1;
1572
1573err:
1574 if (rsa)
1575 {
1576 RSA_free(rsa);
1577 }
1578 else if (rsa_meth)
1579 {
1580 RSA_meth_free(rsa_meth);
1581 }
1582 return 0;
1583}
1584
1585#if !defined(OPENSSL_NO_EC)
1586
1587/* called when EC_KEY is destroyed */
1588static void
1590{
1591 /* release the method structure */
1592 const EC_KEY_METHOD *ec_meth = EC_KEY_get_method(ec);
1593 EC_KEY_METHOD_free((EC_KEY_METHOD *)ec_meth);
1594}
1595
1596/* EC_KEY_METHOD callback: sign().
1597 * Sign the hash using EC key and return DER encoded signature in sig,
1598 * its length in siglen. Return value is 1 on success, 0 on error.
1599 */
1600static int
1601ecdsa_sign(int type, const unsigned char *dgst, int dgstlen, unsigned char *sig,
1602 unsigned int *siglen, const BIGNUM *kinv, const BIGNUM *r, EC_KEY *ec)
1603{
1604 int capacity = (int)ECDSA_size(ec);
1605 /*
1606 * ECDSA does not seem to have proper constants for paddings since
1607 * there are only signatures without padding at the moment, use
1608 * a generic ECDSA for the moment
1609 */
1610 int len = get_sig_from_man(dgst, dgstlen, sig, capacity, "ECDSA");
1611
1612 if (len > 0)
1613 {
1614 *siglen = len;
1615 return 1;
1616 }
1617 return 0;
1618}
1619
1620#ifndef OPENSSL_IS_AWSLC
1621/* EC_KEY_METHOD callback: sign_setup(). We do no precomputations */
1622static int
1623ecdsa_sign_setup(EC_KEY *ec, BN_CTX *ctx_in, BIGNUM **kinvp, BIGNUM **rp)
1624{
1625 return 1;
1626}
1627#endif
1628
1629/* EC_KEY_METHOD callback: sign_sig().
1630 * Sign the hash and return the result as a newly allocated ECDS_SIG
1631 * struct or NULL on error.
1632 */
1633static ECDSA_SIG *
1634ecdsa_sign_sig(const unsigned char *dgst, int dgstlen, const BIGNUM *in_kinv, const BIGNUM *in_r,
1635 EC_KEY *ec)
1636{
1637 ECDSA_SIG *ecsig = NULL;
1638 unsigned int len = (unsigned int)ECDSA_size(ec);
1639 struct gc_arena gc = gc_new();
1640
1641 unsigned char *buf = gc_malloc(len, false, &gc);
1642 if (ecdsa_sign(0, dgst, dgstlen, buf, &len, NULL, NULL, ec) != 1)
1643 {
1644 goto out;
1645 }
1646 /* const char ** should be avoided: not up to us, so we cast our way through */
1647 ecsig = d2i_ECDSA_SIG(NULL, (const unsigned char **)&buf, len);
1648
1649out:
1650 gc_free(&gc);
1651 return ecsig;
1652}
1653
1654static int
1655tls_ctx_use_external_ec_key(struct tls_root_ctx *ctx, EVP_PKEY *pkey)
1656{
1657 EC_KEY *ec = NULL;
1658 EVP_PKEY *privkey = NULL;
1659 EC_KEY_METHOD *ec_method;
1660
1661 ASSERT(ctx);
1662
1663 ec_method = EC_KEY_METHOD_new(EC_KEY_OpenSSL());
1664 if (!ec_method)
1665 {
1666 goto err;
1667 }
1668
1669 /* Among init methods, we only need the finish method */
1670 EC_KEY_METHOD_set_init(ec_method, NULL, openvpn_extkey_ec_finish, NULL, NULL, NULL, NULL);
1671#ifdef OPENSSL_IS_AWSLC
1672 EC_KEY_METHOD_set_sign(ec_method, ecdsa_sign, NULL, ecdsa_sign_sig);
1673#else
1674 EC_KEY_METHOD_set_sign(ec_method, ecdsa_sign, ecdsa_sign_setup, ecdsa_sign_sig);
1675#endif
1676
1677 ec = EC_KEY_dup(EVP_PKEY_get0_EC_KEY(pkey));
1678 if (!ec)
1679 {
1680 EC_KEY_METHOD_free(ec_method);
1681 goto err;
1682 }
1683 if (!EC_KEY_set_method(ec, ec_method))
1684 {
1685 EC_KEY_METHOD_free(ec_method);
1686 goto err;
1687 }
1688 /* from this point ec_method will get freed when ec is freed */
1689
1690 privkey = EVP_PKEY_new();
1691 if (!EVP_PKEY_assign_EC_KEY(privkey, ec))
1692 {
1693 goto err;
1694 }
1695 /* from this point ec will get freed when privkey is freed */
1696
1697 if (!SSL_CTX_use_PrivateKey(ctx->ctx, privkey))
1698 {
1699 ec = NULL; /* avoid double freeing it below */
1700 goto err;
1701 }
1702
1703 EVP_PKEY_free(privkey); /* this will down ref privkey and ec */
1704 return 1;
1705
1706err:
1707 /* Reach here only when ec and privkey can be independenly freed */
1708 EVP_PKEY_free(privkey);
1709 EC_KEY_free(ec);
1710 return 0;
1711}
1712#endif /* !defined(OPENSSL_NO_EC) */
1713#endif /* ENABLE_MANAGEMENT && !HAVE_XKEY_PROVIDER */
1714
1715#ifdef ENABLE_MANAGEMENT
1716int
1718{
1719 int ret = 1;
1720
1721 ASSERT(NULL != ctx);
1722
1723 X509 *cert = SSL_CTX_get0_certificate(ctx->ctx);
1724
1725 ASSERT(NULL != cert);
1726
1727 /* get the public key */
1728 EVP_PKEY *pkey = X509_get0_pubkey(cert);
1729 ASSERT(pkey); /* NULL before SSL_CTX_use_certificate() is called */
1730
1731#ifdef HAVE_XKEY_PROVIDER
1732 EVP_PKEY *privkey = xkey_load_management_key(tls_libctx, pkey);
1733 if (!privkey || !SSL_CTX_use_PrivateKey(ctx->ctx, privkey))
1734 {
1735 EVP_PKEY_free(privkey);
1736 goto cleanup;
1737 }
1738 EVP_PKEY_free(privkey);
1739#else /* ifdef HAVE_XKEY_PROVIDER */
1740#if OPENSSL_VERSION_NUMBER < 0x30000000L
1741 if (EVP_PKEY_id(pkey) == EVP_PKEY_RSA)
1742#else /* OPENSSL_VERSION_NUMBER < 0x30000000L */
1743 if (EVP_PKEY_is_a(pkey, "RSA"))
1744#endif /* OPENSSL_VERSION_NUMBER < 0x30000000L */
1745 {
1746 if (!tls_ctx_use_external_rsa_key(ctx, pkey))
1747 {
1748 goto cleanup;
1749 }
1750 }
1751#if !defined(OPENSSL_NO_EC)
1752#if OPENSSL_VERSION_NUMBER < 0x30000000L
1753 else if (EVP_PKEY_id(pkey) == EVP_PKEY_EC)
1754#else /* OPENSSL_VERSION_NUMBER < 0x30000000L */
1755 else if (EVP_PKEY_is_a(pkey, "EC"))
1756#endif /* OPENSSL_VERSION_NUMBER < 0x30000000L */
1757 {
1758 if (!tls_ctx_use_external_ec_key(ctx, pkey))
1759 {
1760 goto cleanup;
1761 }
1762 }
1763 else
1764 {
1765 crypto_msg(M_WARN, "management-external-key requires an RSA or EC certificate");
1766 goto cleanup;
1767 }
1768#else /* !defined(OPENSSL_NO_EC) */
1769 else
1770 {
1771 crypto_msg(M_WARN, "management-external-key requires an RSA certificate");
1772 goto cleanup;
1773 }
1774#endif /* !defined(OPENSSL_NO_EC) */
1775
1776#endif /* HAVE_XKEY_PROVIDER */
1777
1778 ret = 0;
1779cleanup:
1780 if (ret)
1781 {
1782 crypto_msg(M_FATAL, "Cannot enable SSL external private key capability");
1783 }
1784 return ret;
1785}
1786
1787#endif /* ifdef ENABLE_MANAGEMENT */
1788
1789static int
1790sk_x509_name_cmp(const X509_NAME *const *a, const X509_NAME *const *b)
1791{
1792 return X509_NAME_cmp(*a, *b);
1793}
1794
1795void
1796tls_ctx_load_ca(struct tls_root_ctx *ctx, const char *ca_file, bool ca_file_inline,
1797 const char *ca_path, bool tls_server)
1798{
1799 STACK_OF(X509_INFO) *info_stack = NULL;
1800 STACK_OF(X509_NAME) *cert_names = NULL;
1801 X509_STORE *store = NULL;
1802
1803 ASSERT(NULL != ctx);
1804
1805 store = SSL_CTX_get_cert_store(ctx->ctx);
1806 if (!store)
1807 {
1808 crypto_msg(M_FATAL, "Cannot get certificate store");
1809 }
1810
1811 /* Try to add certificates and CRLs from ca_file */
1812 if (ca_file)
1813 {
1814 openssl_stack_size_t added = 0;
1815 BIO *in = NULL;
1816
1817 if (ca_file_inline)
1818 {
1819 in = BIO_new_mem_buf((char *)ca_file, -1);
1820 }
1821 else
1822 {
1823 in = BIO_new_file(ca_file, "r");
1824 }
1825
1826 if (in)
1827 {
1828 info_stack = PEM_X509_INFO_read_bio(in, NULL, NULL, NULL);
1829 }
1830
1831 if (info_stack)
1832 {
1833 openssl_stack_size_t prev = 0;
1834
1835 for (openssl_stack_size_t i = 0; i < sk_X509_INFO_num(info_stack); i++)
1836 {
1837 X509_INFO *info = sk_X509_INFO_value(info_stack, i);
1838 if (info->crl)
1839 {
1840 X509_STORE_add_crl(store, info->crl);
1841 }
1842
1843 if (tls_server && !info->x509)
1844 {
1845 crypto_msg(M_FATAL, "X509 name was missing in TLS mode");
1846 }
1847
1848 if (info->x509)
1849 {
1850 X509_STORE_add_cert(store, info->x509);
1851 added++;
1852
1853 if (!tls_server)
1854 {
1855 continue;
1856 }
1857
1858 /* Use names of CAs as a client CA list */
1859 if (cert_names == NULL)
1860 {
1861 cert_names = sk_X509_NAME_new(sk_x509_name_cmp);
1862 if (!cert_names)
1863 {
1864 continue;
1865 }
1866 }
1867
1868 /* OpenSSL 4.0 has made X509_get_subject_name return const
1869 * but not adjusted the other functions to take const
1870 * arguments, and other libraries do not have const
1871 * arguments, so just ignore const here */
1872 X509_NAME *xn = (X509_NAME *)X509_get_subject_name(info->x509);
1873 if (!xn)
1874 {
1875 continue;
1876 }
1877
1878
1879 /* Don't add duplicate CA names */
1880 if (sk_X509_NAME_find(cert_names, (X509_NAME *)xn) == -1)
1881 {
1882 X509_NAME *xn_dup = X509_NAME_dup(xn);
1883 if (!xn_dup)
1884 {
1885 continue;
1886 }
1887 sk_X509_NAME_push(cert_names, xn_dup);
1888 }
1889 }
1890
1891 if (tls_server)
1892 {
1893 openssl_stack_size_t cnum = sk_X509_NAME_num(cert_names);
1894 if (cnum != (prev + 1))
1895 {
1897 "Cannot load CA certificate file %s (entry %" PRI_OPENSSL_STACK " did not validate)",
1898 print_key_filename(ca_file, ca_file_inline), added);
1899 }
1900 prev = cnum;
1901 }
1902 }
1903 sk_X509_INFO_pop_free(info_stack, X509_INFO_free);
1904 }
1906 if (tls_server)
1907 {
1908 cnum = sk_X509_NAME_num(cert_names);
1909 SSL_CTX_set_client_CA_list(ctx->ctx, cert_names);
1910 }
1911
1912 if (!added)
1913 {
1914 crypto_msg(M_FATAL, "Cannot load CA certificate file %s (no entries were read)",
1915 print_key_filename(ca_file, ca_file_inline));
1916 }
1917
1918 if (tls_server)
1919 {
1920 if (cnum != added)
1921 {
1923 "Cannot load CA certificate file %s (only %" PRI_OPENSSL_STACK
1924 "of %" PRI_OPENSSL_STACK "entries were valid X509 names)",
1925 print_key_filename(ca_file, ca_file_inline), cnum, added);
1926 }
1927 }
1928
1929 BIO_free(in);
1930 }
1931
1932 /* Set a store for certs (CA & CRL) with a lookup on the "capath" hash directory */
1933 if (ca_path)
1934 {
1935 X509_LOOKUP *lookup = X509_STORE_add_lookup(store, X509_LOOKUP_hash_dir());
1936 if (lookup && X509_LOOKUP_add_dir(lookup, ca_path, X509_FILETYPE_PEM))
1937 {
1938 msg(M_WARN, "WARNING: experimental option --capath %s", ca_path);
1939 }
1940 else
1941 {
1942 crypto_msg(M_FATAL, "Cannot add lookup at --capath %s", ca_path);
1943 }
1944 X509_STORE_set_flags(store, X509_V_FLAG_CRL_CHECK | X509_V_FLAG_CRL_CHECK_ALL);
1945 }
1946}
1947
1948void
1949tls_ctx_load_extra_certs(struct tls_root_ctx *ctx, const char *extra_certs_file,
1950 bool extra_certs_file_inline)
1951{
1952 BIO *in;
1953 if (extra_certs_file_inline)
1954 {
1955 in = BIO_new_mem_buf((char *)extra_certs_file, -1);
1956 }
1957 else
1958 {
1959 in = BIO_new_file(extra_certs_file, "r");
1960 }
1961
1962 if (in == NULL)
1963 {
1964 crypto_msg(M_FATAL, "Cannot load extra-certs file: %s",
1965 print_key_filename(extra_certs_file, extra_certs_file_inline));
1966 }
1967 else
1968 {
1969 tls_ctx_add_extra_certs(ctx, in, false);
1970 }
1971
1972 BIO_free(in);
1973}
1974
1975/* **************************************
1976 *
1977 * Key-state specific functions
1978 *
1979 ***************************************/
1980/*
1981 *
1982 * BIO functions
1983 *
1984 */
1985
1986#ifdef BIO_DEBUG
1987
1988#warning BIO_DEBUG defined
1989
1990static FILE *biofp; /* GLOBAL */
1991static bool biofp_toggle; /* GLOBAL */
1992static time_t biofp_last_open; /* GLOBAL */
1993static const int biofp_reopen_interval = 600; /* GLOBAL */
1994
1995static void
1996close_biofp(void)
1997{
1998 if (biofp)
1999 {
2000 ASSERT(!fclose(biofp));
2001 biofp = NULL;
2002 }
2003}
2004
2005static void
2006open_biofp(void)
2007{
2008 const time_t current = time(NULL);
2009 const pid_t pid = getpid();
2010
2011 if (biofp_last_open + biofp_reopen_interval < current)
2012 {
2013 close_biofp();
2014 }
2015 if (!biofp)
2016 {
2017 char fn[256];
2018 snprintf(fn, sizeof(fn), "bio/%d-%d.log", pid, biofp_toggle);
2019 biofp = fopen(fn, "w");
2020 ASSERT(biofp);
2021 biofp_last_open = time(NULL);
2022 biofp_toggle ^= 1;
2023 }
2024}
2025
2026static void
2027bio_debug_data(const char *mode, const BIO *bio, const uint8_t *buf, int len, const char *desc)
2028{
2029 struct gc_arena gc = gc_new();
2030 if (len > 0)
2031 {
2032 open_biofp();
2033 fprintf(biofp, "BIO_%s %s time=%" PRIi64 " bio=" ptr_format " len=%d data=%s\n", mode, desc,
2034 (int64_t)time(NULL), (ptr_type)bio, len, format_hex(buf, len, 0, &gc));
2035 fflush(biofp);
2036 }
2037 gc_free(&gc);
2038}
2039
2040static void
2041bio_debug_oc(const char *mode, const BIO *bio)
2042{
2043 open_biofp();
2044 fprintf(biofp, "BIO %s time=%" PRIi64 " bio=" ptr_format "\n", mode, (int64_t)time(NULL),
2045 (ptr_type)bio);
2046 fflush(biofp);
2047}
2048
2049#endif /* ifdef BIO_DEBUG */
2050
2051/*
2052 * Write to an OpenSSL BIO in non-blocking mode.
2053 */
2054static int
2055bio_write(BIO *bio, const uint8_t *data, int size, const char *desc)
2056{
2057 int i;
2058 int ret = 0;
2059 ASSERT(size >= 0);
2060 if (size)
2061 {
2062 /*
2063 * Free the L_TLS lock prior to calling BIO routines
2064 * so that foreground thread can still call
2065 * tls_pre_decrypt or tls_pre_encrypt,
2066 * allowing tunnel packet forwarding to continue.
2067 */
2068#ifdef BIO_DEBUG
2069 bio_debug_data("write", bio, data, size, desc);
2070#endif
2071 i = BIO_write(bio, data, size);
2072
2073 if (i < 0)
2074 {
2075 if (!BIO_should_retry(bio))
2076 {
2077 crypto_msg(D_TLS_ERRORS, "TLS ERROR: BIO write %s error", desc);
2078 ret = -1;
2079 ERR_clear_error();
2080 }
2081 }
2082 else if (i != size)
2083 {
2084 crypto_msg(D_TLS_ERRORS, "TLS ERROR: BIO write %s incomplete %d/%d", desc, i, size);
2085 ret = -1;
2086 ERR_clear_error();
2087 }
2088 else
2089 { /* successful write */
2090 dmsg(D_HANDSHAKE_VERBOSE, "BIO write %s %d bytes", desc, i);
2091 ret = 1;
2092 }
2093 }
2094 return ret;
2095}
2096
2097/*
2098 * Inline functions for reading from and writing
2099 * to BIOs.
2100 */
2101
2102static void
2103bio_write_post(const int status, struct buffer *buf)
2104{
2105 /* success status return from bio_write? */
2106 if (status == 1)
2107 {
2108 memset(BPTR(buf), 0, BLENZ(buf)); /* erase data just written */
2109 buf->len = 0;
2110 }
2111}
2112
2113/*
2114 * Read from an OpenSSL BIO in non-blocking mode.
2115 */
2116static int
2117bio_read(BIO *bio, struct buffer *buf, const char *desc)
2118{
2119 ASSERT(buf->len >= 0);
2120 if (buf->len)
2121 {
2122 /* we only want to write empty buffers, ignore read request
2123 * if the buffer is not empty */
2124 return 0;
2125 }
2126 int len = buf_forward_capacity(buf);
2127
2128 /*
2129 * BIO_read brackets most of the serious RSA
2130 * key negotiation number crunching.
2131 */
2132 int i = BIO_read(bio, BPTR(buf), len);
2133
2134 VALGRIND_MAKE_READABLE((void *)&i, sizeof(i));
2135
2136#ifdef BIO_DEBUG
2137 bio_debug_data("read", bio, BPTR(buf), i, desc);
2138#endif
2139
2140 int ret = 0;
2141 if (i < 0)
2142 {
2143 if (!BIO_should_retry(bio))
2144 {
2145 crypto_msg(D_TLS_ERRORS, "TLS_ERROR: BIO read %s error", desc);
2146 buf->len = 0;
2147 ret = -1;
2148 ERR_clear_error();
2149 }
2150 }
2151 else if (!i)
2152 {
2153 buf->len = 0;
2154 }
2155 else
2156 { /* successful read */
2157 dmsg(D_HANDSHAKE_VERBOSE, "BIO read %s %d bytes", desc, i);
2158 buf->len = i;
2159 ret = 1;
2160 VALGRIND_MAKE_READABLE((void *)BPTR(buf), BLEN(buf));
2161 }
2162 return ret;
2163}
2164
2165void
2166key_state_ssl_init(struct key_state_ssl *ks_ssl, const struct tls_root_ctx *ssl_ctx, bool is_server,
2167 struct tls_session *session)
2168{
2169 ASSERT(NULL != ssl_ctx);
2170 ASSERT(ks_ssl);
2171 CLEAR(*ks_ssl);
2172
2173 ks_ssl->ssl = SSL_new(ssl_ctx->ctx);
2174 if (!ks_ssl->ssl)
2175 {
2176 crypto_msg(M_FATAL, "SSL_new failed");
2177 }
2178
2179 /* put session * in ssl object so we can access it
2180 * from verify callback*/
2181 SSL_set_ex_data(ks_ssl->ssl, mydata_index, session);
2182
2183 ASSERT((ks_ssl->ssl_bio = BIO_new(BIO_f_ssl())));
2184 ASSERT((ks_ssl->ct_in = BIO_new(BIO_s_mem())));
2185 ASSERT((ks_ssl->ct_out = BIO_new(BIO_s_mem())));
2186
2187#ifdef BIO_DEBUG
2188 bio_debug_oc("open ssl_bio", ks_ssl->ssl_bio);
2189 bio_debug_oc("open ct_in", ks_ssl->ct_in);
2190 bio_debug_oc("open ct_out", ks_ssl->ct_out);
2191#endif
2192
2193 if (is_server)
2194 {
2195 SSL_set_accept_state(ks_ssl->ssl);
2196 }
2197 else
2198 {
2199 SSL_set_connect_state(ks_ssl->ssl);
2200 }
2201
2202 SSL_set_bio(ks_ssl->ssl, ks_ssl->ct_in, ks_ssl->ct_out);
2203 BIO_set_ssl(ks_ssl->ssl_bio, ks_ssl->ssl, BIO_NOCLOSE);
2204}
2205
2206void
2208{
2209 SSL_set_shutdown(ks_ssl->ssl, SSL_SENT_SHUTDOWN | SSL_RECEIVED_SHUTDOWN);
2210}
2211
2212void
2214{
2215 if (ks_ssl->ssl)
2216 {
2217#ifdef BIO_DEBUG
2218 bio_debug_oc("close ssl_bio", ks_ssl->ssl_bio);
2219 bio_debug_oc("close ct_in", ks_ssl->ct_in);
2220 bio_debug_oc("close ct_out", ks_ssl->ct_out);
2221#endif
2222 BIO_free_all(ks_ssl->ssl_bio);
2223 SSL_free(ks_ssl->ssl);
2224 }
2225}
2226
2227int
2229{
2230 int ret = 0;
2231
2232 ASSERT(NULL != ks_ssl);
2233
2234 ret = bio_write(ks_ssl->ssl_bio, BPTR(buf), BLEN(buf), "tls_write_plaintext");
2235 bio_write_post(ret, buf);
2236
2237 return ret;
2238}
2239
2240int
2241key_state_write_plaintext_const(struct key_state_ssl *ks_ssl, const uint8_t *data, int len)
2242{
2243 int ret = 0;
2244
2245 ASSERT(NULL != ks_ssl);
2246
2247 ret = bio_write(ks_ssl->ssl_bio, data, len, "tls_write_plaintext_const");
2248
2249 return ret;
2250}
2251
2252int
2254{
2255 int ret = 0;
2256
2257 ASSERT(NULL != ks_ssl);
2258
2259 ret = bio_read(ks_ssl->ct_out, buf, "tls_read_ciphertext");
2260
2261 return ret;
2262}
2263
2264int
2266{
2267 int ret = 0;
2268
2269 ASSERT(NULL != ks_ssl);
2270
2271 ret = bio_write(ks_ssl->ct_in, BPTR(buf), BLEN(buf), "tls_write_ciphertext");
2272 bio_write_post(ret, buf);
2273
2274 return ret;
2275}
2276
2277int
2279{
2280 int ret = 0;
2281
2282 ASSERT(NULL != ks_ssl);
2283
2284 ret = bio_read(ks_ssl->ssl_bio, buf, "tls_read_plaintext");
2285
2286 return ret;
2287}
2288
2289static void
2290print_pkey_details(EVP_PKEY *pkey, char *buf, size_t buflen)
2291{
2292 const char *curve = "";
2293 const char *type = "(error getting type)";
2294
2295 if (pkey == NULL)
2296 {
2297 buf[0] = 0;
2298 return;
2299 }
2300
2301 int typeid = EVP_PKEY_id(pkey);
2302
2303#ifndef OPENSSL_NO_EC
2304#if OPENSSL_VERSION_NUMBER < 0x30000000L
2305 bool is_ec = typeid == EVP_PKEY_EC;
2306#else
2307 bool is_ec = EVP_PKEY_is_a(pkey, "EC");
2308#endif
2309 char groupname[64];
2310 if (is_ec)
2311 {
2312 size_t len;
2313 if (EVP_PKEY_get_group_name(pkey, groupname, sizeof(groupname), &len))
2314 {
2315 curve = groupname;
2316 }
2317 else
2318 {
2319 curve = "(error getting curve name)";
2320 }
2321 }
2322#endif
2323 if (typeid != 0)
2324 {
2325#if OPENSSL_VERSION_NUMBER < 0x30000000L
2326 type = OBJ_nid2sn(typeid);
2327
2328 /* OpenSSL reports rsaEncryption, dsaEncryption and
2329 * id-ecPublicKey, map these values to nicer ones */
2330 if (typeid == EVP_PKEY_RSA)
2331 {
2332 type = "RSA";
2333 }
2334 else if (typeid == EVP_PKEY_DSA)
2335 {
2336 type = "DSA";
2337 }
2338 else if (typeid == EVP_PKEY_EC)
2339 {
2340 /* EC gets the curve appended after the type */
2341 type = "EC, curve ";
2342 }
2343 else if (type == NULL)
2344 {
2345 type = "unknown type";
2346 }
2347#else /* OpenSSL >= 3 */
2348 type = EVP_PKEY_get0_type_name(pkey);
2349 if (type == NULL)
2350 {
2351 type = "(error getting public key type)";
2352 }
2353#endif /* if OPENSSL_VERSION_NUMBER < 0x30000000L */
2354 }
2355
2356 snprintf(buf, buflen, "%d bits %s%s", EVP_PKEY_bits(pkey), type, curve);
2357}
2358
2365static void
2366print_cert_details(X509 *cert, char *buf, size_t buflen)
2367{
2368 EVP_PKEY *pkey = X509_get_pubkey(cert);
2369 char pkeybuf[64] = { 0 };
2370 print_pkey_details(pkey, pkeybuf, sizeof(pkeybuf));
2371
2372 char sig[128] = { 0 };
2373 int signature_nid = X509_get_signature_nid(cert);
2374 if (signature_nid != 0)
2375 {
2376 snprintf(sig, sizeof(sig), ", signature: %s", OBJ_nid2sn(signature_nid));
2377 }
2378
2379 snprintf(buf, buflen, ", peer certificate: %s%s", pkeybuf, sig);
2380
2381 EVP_PKEY_free(pkey);
2382}
2383
2384static void
2385print_server_tempkey(SSL *ssl, char *buf, size_t buflen)
2386{
2387 EVP_PKEY *pkey = NULL;
2388 SSL_get_peer_tmp_key(ssl, &pkey);
2389 if (!pkey)
2390 {
2391 return;
2392 }
2393
2394 char pkeybuf[128] = { 0 };
2395 print_pkey_details(pkey, pkeybuf, sizeof(pkeybuf));
2396
2397 snprintf(buf, buflen, ", peer temporary key: %s", pkeybuf);
2398
2399 EVP_PKEY_free(pkey);
2400}
2401
2402#if !defined(LIBRESSL_VERSION_NUMBER) \
2403 || (defined(LIBRESSL_VERSION_NUMBER) && LIBRESSL_VERSION_NUMBER >= 0x3090000fL)
2409static const char *
2411{
2412 /* Fix a few OpenSSL names to be better understandable */
2413 switch (nid)
2414 {
2415 case EVP_PKEY_RSA:
2416 /* will otherwise say rsaEncryption */
2417 return "RSA";
2418
2419 case EVP_PKEY_DSA:
2420 /* dsaEncryption otherwise */
2421 return "DSA";
2422
2423 case EVP_PKEY_EC:
2424 /* will say id-ecPublicKey */
2425 return "ECDSA";
2426
2427 case -1:
2428 return "(error getting name)";
2429
2430 default:
2431 {
2432 const char *type = OBJ_nid2sn(nid);
2433 if (!type)
2434 {
2435 /* This is unlikely to ever happen as OpenSSL is unlikely to
2436 * return an NID it cannot resolve itself but we silence
2437 * linter/code checkers here */
2438 type = "(error getting name, OBJ_nid2sn failed)";
2439 }
2440 return type;
2441 }
2442 }
2443}
2444#endif /* ifndef LIBRESSL_VERSION_NUMBER */
2445
2450static void
2451print_peer_signature(SSL *ssl, char *buf, size_t buflen)
2452{
2453 int peer_sig_type_nid = NID_undef;
2454 const char *peer_sig_unknown = "unknown";
2455 const char *peer_sig = peer_sig_unknown;
2456 const char *peer_sig_type = "unknown type";
2457
2458 const char *signame = NULL;
2460 if (signame)
2461 {
2462 peer_sig = signame;
2463 }
2464
2465#if !defined(LIBRESSL_VERSION_NUMBER) \
2466 || (defined(LIBRESSL_VERSION_NUMBER) && LIBRESSL_VERSION_NUMBER >= 0x3090000fL)
2467 /* LibreSSL 3.7.x and 3.8.x implement this function but do not export it
2468 * and fail linking with an unresolved symbol */
2469 if (SSL_get_peer_signature_type_nid(ssl, &peer_sig_type_nid) && peer_sig_type_nid != NID_undef)
2470 {
2471 peer_sig_type = get_sigtype(peer_sig_type_nid);
2472 }
2473#endif
2474
2475 if (peer_sig == peer_sig_unknown && peer_sig_type_nid == NID_undef)
2476 {
2477 return;
2478 }
2479
2480 snprintf(buf, buflen, ", peer signing digest/type: %s %s", peer_sig, peer_sig_type);
2481}
2482
2483#if OPENSSL_VERSION_NUMBER >= 0x30000000L
2484void
2485print_tls_key_agreement_group(SSL *ssl, char *buf, size_t buflen)
2486{
2487 const char *groupname = SSL_get0_group_name(ssl);
2488 if (!groupname)
2489 {
2490 snprintf(buf, buflen, ", key agreement: (error fetching group)");
2491 }
2492 else
2493 {
2494 snprintf(buf, buflen, ", key agreement: %s", groupname);
2495 }
2496}
2497#endif
2498
2499/* **************************************
2500 *
2501 * Information functions
2502 *
2503 * Print information for the end user.
2504 *
2505 ***************************************/
2506void
2507print_details(struct key_state_ssl *ks_ssl, const char *prefix)
2508{
2509 const SSL_CIPHER *ciph;
2510 char s1[256];
2511 char s2[256];
2512 char s3[256];
2513 char s4[256];
2514 char s5[256];
2515
2516 s1[0] = s2[0] = s3[0] = s4[0] = s5[0] = 0;
2517 ciph = SSL_get_current_cipher(ks_ssl->ssl);
2518 snprintf(s1, sizeof(s1), "%s %s, cipher %s %s", prefix, SSL_get_version(ks_ssl->ssl),
2519 SSL_CIPHER_get_version(ciph), SSL_CIPHER_get_name(ciph));
2520 X509 *cert = SSL_get_peer_certificate(ks_ssl->ssl);
2521
2522 if (cert)
2523 {
2524 print_cert_details(cert, s2, sizeof(s2));
2525 X509_free(cert);
2526 }
2527 print_server_tempkey(ks_ssl->ssl, s3, sizeof(s3));
2528 print_peer_signature(ks_ssl->ssl, s4, sizeof(s4));
2529#if OPENSSL_VERSION_NUMBER >= 0x30000000L
2530 print_tls_key_agreement_group(ks_ssl->ssl, s5, sizeof(s5));
2531#endif
2532
2533 msg(D_HANDSHAKE, "%s%s%s%s%s", s1, s2, s3, s4, s5);
2534}
2535
2536void
2537show_available_tls_ciphers_list(const char *cipher_list, const char *tls_cert_profile, bool tls13)
2538{
2539 struct tls_root_ctx tls_ctx;
2540
2541 tls_ctx.ctx = SSL_CTX_new(SSLv23_method());
2542 if (!tls_ctx.ctx)
2543 {
2544 crypto_msg(M_FATAL, "Cannot create SSL_CTX object");
2545 }
2546
2547 if (tls13)
2548 {
2549 SSL_CTX_set_min_proto_version(tls_ctx.ctx, TLS1_3_VERSION);
2550 tls_ctx_restrict_ciphers_tls13(&tls_ctx, cipher_list);
2551 }
2552 else
2553 {
2554 SSL_CTX_set_max_proto_version(tls_ctx.ctx, TLS1_2_VERSION);
2555 tls_ctx_restrict_ciphers(&tls_ctx, cipher_list);
2556 }
2557
2558 tls_ctx_set_cert_profile(&tls_ctx, tls_cert_profile);
2559
2560 SSL *ssl = SSL_new(tls_ctx.ctx);
2561 if (!ssl)
2562 {
2563 crypto_msg(M_FATAL, "Cannot create SSL object");
2564 }
2565
2566#if defined(OPENSSL_IS_AWSLC) || defined(ENABLE_CRYPTO_WOLFSSL)
2567 STACK_OF(SSL_CIPHER) *sk = SSL_get_ciphers(ssl);
2568#else
2569 STACK_OF(SSL_CIPHER) *sk = SSL_get1_supported_ciphers(ssl);
2570#endif
2571 for (openssl_stack_size_t i = 0; i < sk_SSL_CIPHER_num(sk); i++)
2572 {
2573 const SSL_CIPHER *c = sk_SSL_CIPHER_value(sk, i);
2574
2575 const char *cipher_name = SSL_CIPHER_get_name(c);
2576
2577 const tls_cipher_name_pair *pair =
2578 tls_get_cipher_name_pair(cipher_name, strlen(cipher_name));
2579
2580 if (tls13)
2581 {
2582 printf("%s\n", cipher_name);
2583 }
2584 else if (NULL == pair)
2585 {
2586 /* No translation found, print warning */
2587 printf("%s (No IANA name known to OpenVPN, use OpenSSL name.)\n", cipher_name);
2588 }
2589 else
2590 {
2591 printf("%s\n", pair->iana_name);
2592 }
2593 }
2594 sk_SSL_CIPHER_free(sk);
2595 SSL_free(ssl);
2596 SSL_CTX_free(tls_ctx.ctx);
2597}
2598
2599/*
2600 * Show the Elliptic curves that are available for us to use
2601 * in the OpenSSL library.
2602 */
2603void
2605{
2606 printf("Consider using 'openssl ecparam -list_curves' as alternative to running\n"
2607 "this command.\n"
2608 "Note this output does only list curves/groups that OpenSSL considers as\n"
2609 "builtin EC curves. It does not list additional curves nor X448 or X25519\n");
2610#ifndef OPENSSL_NO_EC
2611 EC_builtin_curve *curves = NULL;
2612
2613 size_t crv_len = EC_get_builtin_curves(NULL, 0);
2614 ALLOC_ARRAY(curves, EC_builtin_curve, crv_len);
2615 if (EC_get_builtin_curves(curves, crv_len))
2616 {
2617 printf("\nAvailable Elliptic curves/groups:\n");
2618 for (size_t n = 0; n < crv_len; n++)
2619 {
2620 const char *sname;
2621 sname = OBJ_nid2sn(curves[n].nid);
2622 if (sname == NULL)
2623 {
2624 sname = "";
2625 }
2626
2627 printf("%s\n", sname);
2628 }
2629 }
2630 else
2631 {
2632 crypto_msg(M_FATAL, "Cannot get list of builtin curves");
2633 }
2634 free(curves);
2635#else /* ifndef OPENSSL_NO_EC */
2636 msg(M_WARN, "Your OpenSSL library was built without elliptic curve support. "
2637 "No curves available.");
2638#endif /* ifndef OPENSSL_NO_EC */
2639}
2640
2641const char *
2643{
2644 return OpenSSL_version(OPENSSL_VERSION);
2645}
2646
2647
2649#ifdef HAVE_XKEY_PROVIDER
2650static int
2651provider_load(OSSL_PROVIDER *prov, void *dest_libctx)
2652{
2653 const char *name = OSSL_PROVIDER_get0_name(prov);
2654 OSSL_PROVIDER_load(dest_libctx, name);
2655 return 1;
2656}
2657
2658static int
2659provider_unload(OSSL_PROVIDER *prov, void *unused)
2660{
2661 (void)unused;
2662 OSSL_PROVIDER_unload(prov);
2663 return 1;
2664}
2665#endif /* HAVE_XKEY_PROVIDER */
2666
2674void
2676{
2677#ifdef HAVE_XKEY_PROVIDER
2678
2679 /* Make a new library context for use in TLS context */
2680 if (!tls_libctx)
2681 {
2682 tls_libctx = OSSL_LIB_CTX_new();
2684
2685 /* Load all providers in default LIBCTX into this libctx.
2686 * OpenSSL has a child libctx functionality to automate this,
2687 * but currently that is usable only from within providers.
2688 * So we do something close to it manually here.
2689 */
2690 OSSL_PROVIDER_do_all(NULL, provider_load, tls_libctx);
2691 }
2692
2693 if (!OSSL_PROVIDER_available(tls_libctx, "ovpn.xkey"))
2694 {
2695 OSSL_PROVIDER_add_builtin(tls_libctx, "ovpn.xkey", xkey_provider_init);
2696 if (!OSSL_PROVIDER_load(tls_libctx, "ovpn.xkey"))
2697 {
2698 msg(M_NONFATAL, "ERROR: failed loading external key provider: "
2699 "Signing with external keys will not work.");
2700 }
2701 }
2702
2703 /* We only implement minimal functionality in ovpn.xkey, so we do not want
2704 * methods in xkey to be picked unless absolutely required (i.e, when the key
2705 * is external). Ensure this by setting a default propquery for the custom
2706 * libctx that unprefers, but does not forbid, ovpn.xkey. See also man page
2707 * of "property" in OpenSSL 3.0.
2708 */
2709 EVP_set_default_properties(tls_libctx, "?provider!=ovpn.xkey");
2710
2711#endif /* HAVE_XKEY_PROVIDER */
2712}
2713
2717static void
2719{
2720#ifdef HAVE_XKEY_PROVIDER
2721 if (tls_libctx)
2722 {
2723 OSSL_PROVIDER_do_all(tls_libctx, provider_unload, NULL);
2724 OSSL_LIB_CTX_free(tls_libctx);
2725 }
2726#endif /* HAVE_XKEY_PROVIDER */
2727 tls_libctx = NULL;
2728}
2729
2730#endif /* defined(ENABLE_CRYPTO_OPENSSL) */
void * gc_malloc(size_t size, bool clear, struct gc_arena *a)
Allocate memory and, optionally, zero it.
Definition buffer.c:313
char * string_alloc(const char *str, struct gc_arena *gc)
Duplicate a string, allocating memory under garbage collection.
Definition buffer.c:601
Buffer management functions and garbage collection.
#define BPTR(buf)
Return a pointer to the start of the buffer content.
Definition buffer.h:139
#define streq(x, y)
helper to work around the semantics of the strcmp() return value
Definition buffer.h:1813
#define ALLOC_ARRAY_CLEAR_GC(dptr, type, n, gc)
Allocate and zero-initialise a garbage-collected array of n elements.
Definition buffer.h:2082
static int buf_forward_capacity(const struct buffer *buf)
Return the number of bytes that can still be appended to the buffer.
Definition buffer.h:1038
static void secure_memzero(void *data, size_t len)
Securely zeroise memory.
Definition buffer.h:748
#define BLEN(buf)
Return the length of the buffer content in bytes.
Definition buffer.h:151
static char * format_hex(const uint8_t *data, size_t size, size_t maxoutput, struct gc_arena *gc)
Format a binary buffer as a hex string with spaces every 4 bytes.
Definition buffer.h:960
#define BLENZ(buf)
Return the length of the buffer content as a size_t.
Definition buffer.h:153
static void check_malloc_return(void *p)
Abort if a memory allocation returned NULL.
Definition buffer.h:2135
static void gc_free(struct gc_arena *a)
Free all allocations in a garbage collection arena.
Definition buffer.h:1965
#define ALLOC_ARRAY(dptr, type, n)
Allocate memory for an array of n elements of the given type.
Definition buffer.h:2043
static struct gc_arena gc_new(void)
Allocate and return a new, empty garbage collection arena.
Definition buffer.h:1949
unsigned long ptr_type
Definition common.h:59
#define ptr_format
Definition common.h:50
size_t strlcpy(char *dest, const char *src, size_t maxlen)
char * strsep(char **stringp, const char *delim)
const char * print_key_filename(const char *str, bool is_inline)
To be used when printing a string that may contain inline data.
Definition crypto.c:1243
void crypto_print_openssl_errors(const unsigned int flags)
Retrieve any occurred OpenSSL errors and print those errors.
#define crypto_msg(flags,...)
Retrieve any OpenSSL errors, then print the supplied error message.
int SSL_CTX_use_CryptoAPI_certificate(SSL_CTX *ssl_ctx, const char *cert_prop)
Definition cryptoapi.c:59
#define D_TLS_DEBUG_LOW
Definition errlevel.h:76
#define D_TLS_DEBUG_MED
Definition errlevel.h:156
#define D_HANDSHAKE_VERBOSE
Definition errlevel.h:155
#define D_HANDSHAKE
Definition errlevel.h:71
#define D_TLS_ERRORS
Definition errlevel.h:58
#define D_LOW
Definition errlevel.h:96
#define M_INFO
Definition errlevel.h:54
#define D_TLS_DEBUG
Definition errlevel.h:164
#define KS_PRIMARY
Primary key state index.
Definition ssl_common.h:472
int key_state_read_plaintext(struct key_state_ssl *ks_ssl, struct buffer *buf)
Extract plaintext data from the TLS module.
int key_state_write_ciphertext(struct key_state_ssl *ks_ssl, struct buffer *buf)
Insert a ciphertext buffer into the TLS module.
int key_state_read_ciphertext(struct key_state_ssl *ks_ssl, struct buffer *buf)
Extract ciphertext data from the TLS module.
int key_state_write_plaintext_const(struct key_state_ssl *ks_ssl, const uint8_t *data, int len)
Insert plaintext data into the TLS module.
int key_state_write_plaintext(struct key_state_ssl *ks_ssl, struct buffer *buf)
Insert a plaintext buffer into the TLS module.
int verify_callback(void *session_obj, mbedtls_x509_crt *cert, int cert_depth, uint32_t *flags)
Verify that the remote OpenVPN peer's certificate allows setting up a VPN tunnel.
static int constrain_int(int x, int min, int max)
Definition integer.h:118
static SERVICE_STATUS status
Definition interactive.c:52
void management_auth_failure(const struct management *man, const char *type, const char *reason)
Definition manage.c:3274
char * management_query_pk_sig(struct management *man, const char *b64_data, const char *algorithm)
Definition manage.c:3966
#define VALGRIND_MAKE_READABLE(addr, len)
Definition memdbg.h:49
void purge_user_pass(struct user_pass *up, const bool force)
Definition misc.c:468
#define USER_PASS_LEN
Definition misc.h:67
#define GET_USER_PASS_MANAGEMENT
Definition misc.h:113
#define GET_USER_PASS_PASSWORD_ONLY
Definition misc.h:115
static bool get_user_pass(struct user_pass *up, const char *auth_file, const char *prefix, const unsigned int flags)
Retrieves the user credentials from various sources depending on the flags.
Definition misc.h:155
OpenSSL compatibility stub.
void OSSL_PROVIDER
static int SSL_get0_peer_signature_name(SSL *ssl, const char **sigalg)
int openssl_stack_size_t
void OSSL_LIB_CTX
static int EVP_PKEY_get_group_name(EVP_PKEY *pkey, char *gname, size_t gname_sz, size_t *gname_len)
#define PRI_OPENSSL_STACK
#define SSL_CTX_new_ex(libctx, propq, method)
Reduce SSL_CTX_new_ex() to SSL_CTX_new() for OpenSSL < 3.
uint64_t openssl_opt_t
#define CLEAR(x)
Definition basic.h:32
#define M_FATAL
Definition error.h:90
#define M_NONFATAL
Definition error.h:91
#define dmsg(flags,...)
Definition error.h:164
#define msg(flags,...)
Definition error.h:152
#define ASSERT(x)
Definition error.h:221
#define M_DEBUG
Definition error.h:93
#define M_WARN
Definition error.h:92
time_t now
Definition otime.c:33
FILE * platform_fopen(const char *path, const char *mode)
Definition platform.c:500
int openvpn_base64_decode(const char *str, void *data, int size)
Definition base64.c:160
int openvpn_base64_encode(const void *data, int size, char **str)
Definition base64.c:51
int pem_password_callback(char *buf, int size, int rwflag, void *u)
Callback to retrieve the user's password.
Definition ssl.c:274
Control Channel SSL library backend module.
#define TLS_VER_1_0
#define TLS_VER_1_2
#define TLS_VER_1_3
#define TLS_VER_1_1
Control Channel Common Data Structures.
#define SSLF_TLS_VERSION_MAX_SHIFT
Definition ssl_common.h:436
#define UP_TYPE_PRIVATE_KEY
Definition ssl_common.h:42
#define SSLF_CLIENT_CERT_OPTIONAL
Definition ssl_common.h:429
#define SSLF_CLIENT_CERT_NOT_REQUIRED
Definition ssl_common.h:428
#define SSLF_TLS_VERSION_MAX_MASK
Definition ssl_common.h:437
#define SSLF_TLS_VERSION_MIN_SHIFT
Definition ssl_common.h:434
#define SSLF_TLS_VERSION_MIN_MASK
Definition ssl_common.h:435
void tls_ctx_set_tls_groups(struct tls_root_ctx *ctx, const char *groups)
Set the (elliptic curve) group allowed for signatures and key exchange.
void tls_ctx_free(struct tls_root_ctx *ctx)
Frees the library-specific TLSv1 context.
static int bio_read(BIO *bio, struct buffer *buf, const char *desc)
const char * get_ssl_library_version(void)
return a pointer to a static memory area containing the name and version number of the SSL library in...
static void openvpn_extkey_ec_finish(EC_KEY *ec)
static bool tls_ctx_set_tls_versions(struct tls_root_ctx *ctx, unsigned int ssl_flags)
static int bio_write(BIO *bio, const uint8_t *data, int size, const char *desc)
static int openvpn_extkey_rsa_finish(RSA *rsa)
static int tls_ctx_use_external_ec_key(struct tls_root_ctx *ctx, EVP_PKEY *pkey)
bool key_state_export_keying_material(struct tls_session *session, const char *label, size_t label_size, void *ekm, size_t ekm_size)
Keying Material Exporters [RFC 5705] allows additional keying material to be derived from existing TL...
void load_xkey_provider(void)
Some helper routines for provider load/unload.
static void print_pkey_details(EVP_PKEY *pkey, char *buf, size_t buflen)
static void print_server_tempkey(SSL *ssl, char *buf, size_t buflen)
static int rsa_pub_enc(int flen, const unsigned char *from, unsigned char *to, RSA *rsa, int padding)
static void tls_ctx_add_extra_certs(struct tls_root_ctx *ctx, BIO *bio, bool optional)
void show_available_tls_ciphers_list(const char *cipher_list, const char *tls_cert_profile, bool tls13)
Show the TLS ciphers that are available for us to use in the library depending on the TLS version.
static void * load_pkey_from_uri(const char *uri, SSL_CTX *ssl_ctx)
Load private key from OSSL_STORE URI or file uri : URI of object or filename ssl_ctx : SSL_CTX for UI...
void show_available_curves(void)
Show the available elliptic curves in the crypto library.
static uint16_t openssl_tls_version(unsigned int ver)
Convert internal version number to openssl version number.
void key_state_ssl_free(struct key_state_ssl *ks_ssl)
Free the SSL channel part of the given key state.
static int ecdsa_sign(int type, const unsigned char *dgst, int dgstlen, unsigned char *sig, unsigned int *siglen, const BIGNUM *kinv, const BIGNUM *r, EC_KEY *ec)
int tls_ctx_load_priv_file(struct tls_root_ctx *ctx, const char *priv_key_file, bool priv_key_file_inline)
Load private key file into the given TLS context.
static int cert_verify_callback(X509_STORE_CTX *ctx, void *arg)
void key_state_ssl_shutdown(struct key_state_ssl *ks_ssl)
Sets a TLS session to be shutdown state, so the TLS library will generate a shutdown alert.
void tls_ctx_load_extra_certs(struct tls_root_ctx *ctx, const char *extra_certs_file, bool extra_certs_file_inline)
Load extra certificate authority certificates from the given file or path.
static void print_peer_signature(SSL *ssl, char *buf, size_t buflen)
Get the type of the signature that is used by the peer during the TLS handshake.
OSSL_LIB_CTX * tls_libctx
Definition ssl_openssl.c:78
static const char * get_sigtype(int nid)
Translate an OpenSSL NID into a more human readable name.
int mydata_index
Allocate space in SSL objects in which to store a struct tls_session pointer back to parent.
Definition ssl_openssl.c:88
static void print_cert_details(X509 *cert, char *buf, size_t buflen)
Print human readable information about the certificate into buf.
static int ecdsa_sign_setup(EC_KEY *ec, BN_CTX *ctx_in, BIGNUM **kinvp, BIGNUM **rp)
void tls_ctx_check_cert_time(const struct tls_root_ctx *ctx)
Check our certificate notBefore and notAfter fields, and warn if the cert is either not yet valid or ...
void tls_ctx_restrict_ciphers_tls13(struct tls_root_ctx *ctx, const char *ciphers)
Restrict the list of ciphers that can be used within the TLS context for TLS 1.3 and higher.
static bool cert_uri_supported(void)
static int rsa_priv_dec(int flen, const unsigned char *from, unsigned char *to, RSA *rsa, int padding)
#define INFO_CALLBACK_SSL_CONST
static int rsa_pub_dec(int flen, const unsigned char *from, unsigned char *to, RSA *rsa, int padding)
static void bio_write_post(const int status, struct buffer *buf)
int tls_ctx_load_pkcs12(struct tls_root_ctx *ctx, const char *pkcs12_file, bool pkcs12_file_inline, bool load_ca_file)
Load PKCS #12 file for key, cert and (optionally) CA certs, and add to library-specific TLS context.
void key_state_ssl_init(struct key_state_ssl *ks_ssl, const struct tls_root_ctx *ssl_ctx, bool is_server, struct tls_session *session)
Initialise the SSL channel part of the given key state.
void tls_free_lib(void)
Free any global SSL library-specific data structures.
Definition ssl_openssl.c:98
static void unload_xkey_provider(void)
Undo steps in load_xkey_provider.
const char * get_rsa_padding_name(const int padding)
void tls_ctx_load_ecdh_params(struct tls_root_ctx *ctx, const char *curve_name)
Load Elliptic Curve Parameters, and load them into the library-specific TLS context.
static int get_sig_from_man(const unsigned char *dgst, unsigned int dgstlen, unsigned char *sig, unsigned int siglen, const char *algorithm)
Pass the input hash in 'dgst' to management and get the signature back.
static void tls_ctx_load_cert_uri(struct tls_root_ctx *tls_ctx, const char *uri)
static int rsa_priv_enc(int flen, const unsigned char *from, unsigned char *to, RSA *rsa, int padding)
static void convert_tls_list_to_openssl(char *openssl_ciphers, size_t len, const char *ciphers)
static void tls_ctx_load_cert_pem_file(struct tls_root_ctx *ctx, const char *cert_file, bool cert_file_inline)
void tls_init_lib(void)
Perform any static initialisation necessary by the library.
Definition ssl_openssl.c:91
void print_details(struct key_state_ssl *ks_ssl, const char *prefix)
Print a one line summary of SSL/TLS session handshake.
static void info_callback(INFO_CALLBACK_SSL_CONST SSL *s, int where, int ret)
int tls_version_max(void)
Return the maximum TLS version (as a TLS_VER_x constant) supported by current SSL implementation.
void backend_tls_ctx_reload_crl(struct tls_root_ctx *ssl_ctx, const char *crl_file, bool crl_inline)
Reload the Certificate Revocation List for the SSL channel.
void tls_ctx_restrict_ciphers(struct tls_root_ctx *ctx, const char *ciphers)
Restrict the list of ciphers that can be used within the TLS context for TLS 1.2 and below.
void tls_ctx_load_ca(struct tls_root_ctx *ctx, const char *ca_file, bool ca_file_inline, const char *ca_path, bool tls_server)
Load certificate authority certificates from the given file or path.
void tls_ctx_set_cert_profile(struct tls_root_ctx *ctx, const char *profile)
Set the TLS certificate profile.
int tls_ctx_use_management_external_key(struct tls_root_ctx *ctx)
Tell the management interface to load the given certificate and the external private key matching the...
static int tls_ctx_use_external_rsa_key(struct tls_root_ctx *ctx, EVP_PKEY *pkey)
static ECDSA_SIG * ecdsa_sign_sig(const unsigned char *dgst, int dgstlen, const BIGNUM *in_kinv, const BIGNUM *in_r, EC_KEY *ec)
void tls_ctx_load_cryptoapi(struct tls_root_ctx *ctx, const char *cryptoapi_cert)
Use Windows cryptoapi for key and cert, and add to library-specific TLS context.
bool tls_ctx_initialised(const struct tls_root_ctx *ctx)
Checks whether the given TLS context is initialised.
bool tls_ctx_set_options(struct tls_root_ctx *ctx, unsigned int ssl_flags)
Set any library specific options.
void tls_ctx_load_dh_params(struct tls_root_ctx *ctx, const char *dh_file, bool dh_file_inline)
Load Diffie Hellman Parameters, and load them into the library-specific TLS context.
void tls_ctx_new(struct tls_root_ctx *ctx)
Initialise a library-specific TLS context.
static int sk_x509_name_cmp(const X509_NAME *const *a, const X509_NAME *const *b)
void tls_ctx_load_cert_file(struct tls_root_ctx *ctx, const char *cert_file, bool cert_file_inline)
Load certificate file into the given TLS context.
int get_num_elements(const char *string, char delimiter)
Returns the occurrences of 'delimiter' in a string +1 This is typically used to find out the number e...
Definition ssl_util.c:355
const tls_cipher_name_pair * tls_get_cipher_name_pair(const char *cipher_name, size_t len)
Definition ssl_util.c:336
SSL utility functions.
Control Channel Verification Module OpenSSL backend.
Wrapper structure for dynamically allocated memory.
Definition buffer.h:71
int len
Length in bytes of the actual content within the allocated memory.
Definition buffer.h:76
Garbage collection arena used to keep track of dynamically allocated memory.
Definition buffer.h:127
Definition sig.c:47
Get a tls_cipher_name_pair containing OpenSSL and IANA names for supplied TLS cipher name.
Definition ssl_util.h:111
const char * iana_name
Definition ssl_util.h:113
const char * openssl_name
Definition ssl_util.h:112
Structure that wraps the TLS context.
Definition ssl_mbedtls.h:86
STACK_OF(X509_CRL) *crls
SSL_CTX * ctx
Definition ssl_openssl.h:41
Security parameter state of a single session within a VPN tunnel.
Definition ssl_common.h:497
char password[USER_PASS_LEN]
Definition misc.h:71
static int cleanup(void **state)
struct gc_arena gc
Definition test_ssl.c:138