2 * Copyright 2012-2024 The OpenSSL Project Authors. All Rights Reserved.
4 * Licensed under the Apache License 2.0 (the "License"). You may not use
5 * this file except in compliance with the License. You can obtain a copy
6 * in the file LICENSE in the source distribution or at
7 * https://www.openssl.org/source/license.html
11 #include "ssl_local.h"
12 #include <openssl/conf.h>
13 #include <openssl/objects.h>
14 #include <openssl/decoder.h>
15 #include <openssl/core_dispatch.h>
16 #include "internal/nelem.h"
19 * structure holding name tables. This is used for permitted elements in lists
26 unsigned int name_flags;
27 uint64_t option_value;
30 /* Switch table: use for single command line switches like no_tls2 */
32 uint64_t option_value;
33 unsigned int name_flags;
36 /* Sense of name is inverted e.g. "TLSv1" will clear SSL_OP_NO_TLSv1 */
37 #define SSL_TFLAG_INV 0x1
38 /* Mask for type of flag referred to */
39 #define SSL_TFLAG_TYPE_MASK 0xf00
40 /* Flag is for options */
41 #define SSL_TFLAG_OPTION 0x000
42 /* Flag is for cert_flags */
43 #define SSL_TFLAG_CERT 0x100
44 /* Flag is for verify mode */
45 #define SSL_TFLAG_VFY 0x200
46 /* Option can only be used for clients */
47 #define SSL_TFLAG_CLIENT SSL_CONF_FLAG_CLIENT
48 /* Option can only be used for servers */
49 #define SSL_TFLAG_SERVER SSL_CONF_FLAG_SERVER
50 #define SSL_TFLAG_BOTH (SSL_TFLAG_CLIENT|SSL_TFLAG_SERVER)
52 #define SSL_FLAG_TBL(str, flag) \
53 {str, (int)(sizeof(str) - 1), SSL_TFLAG_BOTH, flag}
54 #define SSL_FLAG_TBL_SRV(str, flag) \
55 {str, (int)(sizeof(str) - 1), SSL_TFLAG_SERVER, flag}
56 #define SSL_FLAG_TBL_CLI(str, flag) \
57 {str, (int)(sizeof(str) - 1), SSL_TFLAG_CLIENT, flag}
58 #define SSL_FLAG_TBL_INV(str, flag) \
59 {str, (int)(sizeof(str) - 1), SSL_TFLAG_INV|SSL_TFLAG_BOTH, flag}
60 #define SSL_FLAG_TBL_SRV_INV(str, flag) \
61 {str, (int)(sizeof(str) - 1), SSL_TFLAG_INV|SSL_TFLAG_SERVER, flag}
62 #define SSL_FLAG_TBL_CERT(str, flag) \
63 {str, (int)(sizeof(str) - 1), SSL_TFLAG_CERT|SSL_TFLAG_BOTH, flag}
65 #define SSL_FLAG_VFY_CLI(str, flag) \
66 {str, (int)(sizeof(str) - 1), SSL_TFLAG_VFY | SSL_TFLAG_CLIENT, flag}
67 #define SSL_FLAG_VFY_SRV(str, flag) \
68 {str, (int)(sizeof(str) - 1), SSL_TFLAG_VFY | SSL_TFLAG_SERVER, flag}
71 * Opaque structure containing SSL configuration context.
74 struct ssl_conf_ctx_st {
76 * Various flags indicating (among other things) which options we will
80 /* Prefix and length of commands */
83 /* SSL_CTX or SSL structure to perform operations on */
86 /* Pointer to SSL or SSL_CTX options field or NULL if none */
88 /* Certificate filenames for each type */
89 char *cert_filename[SSL_PKEY_NUM];
90 /* Pointer to SSL or SSL_CTX cert_flags or NULL if none */
91 uint32_t *pcert_flags;
92 /* Pointer to SSL or SSL_CTX verify_mode or NULL if none */
94 /* Pointer to SSL or SSL_CTX min_version field or NULL if none */
96 /* Pointer to SSL or SSL_CTX max_version field or NULL if none */
98 /* Current flag table being worked on */
99 const ssl_flag_tbl *tbl;
102 /* Client CA names */
103 STACK_OF(X509_NAME) *canames;
106 static void ssl_set_option(SSL_CONF_CTX *cctx, unsigned int name_flags,
107 uint64_t option_value, int onoff)
111 if (cctx->poptions == NULL)
113 if (name_flags & SSL_TFLAG_INV)
115 switch (name_flags & SSL_TFLAG_TYPE_MASK) {
118 pflags = cctx->pcert_flags;
122 pflags = cctx->pvfy_flags;
125 case SSL_TFLAG_OPTION:
127 *cctx->poptions |= option_value;
129 *cctx->poptions &= ~option_value;
137 *pflags |= option_value;
139 *pflags &= ~option_value;
142 static int ssl_match_option(SSL_CONF_CTX *cctx, const ssl_flag_tbl *tbl,
143 const char *name, int namelen, int onoff)
145 /* If name not relevant for context skip */
146 if (!(cctx->flags & tbl->name_flags & SSL_TFLAG_BOTH))
149 if (strcmp(tbl->name, name))
151 } else if (tbl->namelen != namelen
152 || OPENSSL_strncasecmp(tbl->name, name, namelen))
154 ssl_set_option(cctx, tbl->name_flags, tbl->option_value, onoff);
158 static int ssl_set_option_list(const char *elem, int len, void *usr)
160 SSL_CONF_CTX *cctx = usr;
162 const ssl_flag_tbl *tbl;
165 * len == -1 indicates not being called in list context, just for single
166 * command line switches, so don't allow +, -.
175 } else if (*elem == '-') {
181 for (i = 0, tbl = cctx->tbl; i < cctx->ntbl; i++, tbl++) {
182 if (ssl_match_option(cctx, tbl, elem, len, onoff))
188 /* Set supported signature algorithms */
189 static int cmd_SignatureAlgorithms(SSL_CONF_CTX *cctx, const char *value)
193 rv = SSL_set1_sigalgs_list(cctx->ssl, value);
194 /* NB: ctx == NULL performs syntax checking only */
196 rv = SSL_CTX_set1_sigalgs_list(cctx->ctx, value);
200 /* Set supported client signature algorithms */
201 static int cmd_ClientSignatureAlgorithms(SSL_CONF_CTX *cctx, const char *value)
205 rv = SSL_set1_client_sigalgs_list(cctx->ssl, value);
206 /* NB: ctx == NULL performs syntax checking only */
208 rv = SSL_CTX_set1_client_sigalgs_list(cctx->ctx, value);
212 static int cmd_Groups(SSL_CONF_CTX *cctx, const char *value)
216 rv = SSL_set1_groups_list(cctx->ssl, value);
217 /* NB: ctx == NULL performs syntax checking only */
219 rv = SSL_CTX_set1_groups_list(cctx->ctx, value);
223 /* This is the old name for cmd_Groups - retained for backwards compatibility */
224 static int cmd_Curves(SSL_CONF_CTX *cctx, const char *value)
226 return cmd_Groups(cctx, value);
229 /* ECDH temporary parameters */
230 static int cmd_ECDHParameters(SSL_CONF_CTX *cctx, const char *value)
234 /* Ignore values supported by 1.0.2 for the automatic selection */
235 if ((cctx->flags & SSL_CONF_FLAG_FILE)
236 && (OPENSSL_strcasecmp(value, "+automatic") == 0
237 || OPENSSL_strcasecmp(value, "automatic") == 0))
239 if ((cctx->flags & SSL_CONF_FLAG_CMDLINE) &&
240 strcmp(value, "auto") == 0)
243 /* ECDHParameters accepts a single group name */
244 if (strchr(value, ':') != NULL)
248 rv = SSL_CTX_set1_groups_list(cctx->ctx, value);
250 rv = SSL_set1_groups_list(cctx->ssl, value);
255 static int cmd_CipherString(SSL_CONF_CTX *cctx, const char *value)
260 rv = SSL_CTX_set_cipher_list(cctx->ctx, value);
262 rv = SSL_set_cipher_list(cctx->ssl, value);
266 static int cmd_Ciphersuites(SSL_CONF_CTX *cctx, const char *value)
271 rv = SSL_CTX_set_ciphersuites(cctx->ctx, value);
273 rv = SSL_set_ciphersuites(cctx->ssl, value);
277 static int cmd_Protocol(SSL_CONF_CTX *cctx, const char *value)
279 static const ssl_flag_tbl ssl_protocol_list[] = {
280 SSL_FLAG_TBL_INV("ALL", SSL_OP_NO_SSL_MASK),
281 SSL_FLAG_TBL_INV("SSLv2", SSL_OP_NO_SSLv2),
282 SSL_FLAG_TBL_INV("SSLv3", SSL_OP_NO_SSLv3),
283 SSL_FLAG_TBL_INV("TLSv1", SSL_OP_NO_TLSv1),
284 SSL_FLAG_TBL_INV("TLSv1.1", SSL_OP_NO_TLSv1_1),
285 SSL_FLAG_TBL_INV("TLSv1.2", SSL_OP_NO_TLSv1_2),
286 SSL_FLAG_TBL_INV("TLSv1.3", SSL_OP_NO_TLSv1_3),
287 SSL_FLAG_TBL_INV("DTLSv1", SSL_OP_NO_DTLSv1),
288 SSL_FLAG_TBL_INV("DTLSv1.2", SSL_OP_NO_DTLSv1_2)
290 cctx->tbl = ssl_protocol_list;
291 cctx->ntbl = OSSL_NELEM(ssl_protocol_list);
292 return CONF_parse_list(value, ',', 1, ssl_set_option_list, cctx);
296 * protocol_from_string - converts a protocol version string to a number
298 * Returns -1 on failure or the version on success
300 static int protocol_from_string(const char *value)
302 struct protocol_versions {
307 * Note: To avoid breaking previously valid configurations, we must retain
308 * legacy entries in this table even if the underlying protocol is no
309 * longer supported. This also means that the constants SSL3_VERSION, ...
310 * need to be retained indefinitely. This table can only grow, never
313 static const struct protocol_versions versions[] = {
315 {"SSLv3", SSL3_VERSION},
316 {"TLSv1", TLS1_VERSION},
317 {"TLSv1.1", TLS1_1_VERSION},
318 {"TLSv1.2", TLS1_2_VERSION},
319 {"TLSv1.3", TLS1_3_VERSION},
320 {"DTLSv1", DTLS1_VERSION},
321 {"DTLSv1.2", DTLS1_2_VERSION}
324 size_t n = OSSL_NELEM(versions);
326 for (i = 0; i < n; i++)
327 if (strcmp(versions[i].name, value) == 0)
328 return versions[i].version;
332 static int min_max_proto(SSL_CONF_CTX *cctx, const char *value, int *bound)
337 if (cctx->ctx != NULL)
338 method_version = cctx->ctx->method->version;
339 else if (cctx->ssl != NULL)
340 method_version = cctx->ssl->defltmeth->version;
343 if ((new_version = protocol_from_string(value)) < 0)
345 return ssl_set_version_bound(method_version, new_version, bound);
349 * cmd_MinProtocol - Set min protocol version
350 * @cctx: config structure to save settings in
351 * @value: The min protocol version in string form
353 * Returns 1 on success and 0 on failure.
355 static int cmd_MinProtocol(SSL_CONF_CTX *cctx, const char *value)
357 return min_max_proto(cctx, value, cctx->min_version);
361 * cmd_MaxProtocol - Set max protocol version
362 * @cctx: config structure to save settings in
363 * @value: The max protocol version in string form
365 * Returns 1 on success and 0 on failure.
367 static int cmd_MaxProtocol(SSL_CONF_CTX *cctx, const char *value)
369 return min_max_proto(cctx, value, cctx->max_version);
372 static int cmd_Options(SSL_CONF_CTX *cctx, const char *value)
374 static const ssl_flag_tbl ssl_option_list[] = {
375 SSL_FLAG_TBL_INV("SessionTicket", SSL_OP_NO_TICKET),
376 SSL_FLAG_TBL_INV("EmptyFragments",
377 SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS),
378 SSL_FLAG_TBL("Bugs", SSL_OP_ALL),
379 SSL_FLAG_TBL_INV("Compression", SSL_OP_NO_COMPRESSION),
380 SSL_FLAG_TBL_SRV("ServerPreference", SSL_OP_CIPHER_SERVER_PREFERENCE),
381 SSL_FLAG_TBL_SRV("NoResumptionOnRenegotiation",
382 SSL_OP_NO_SESSION_RESUMPTION_ON_RENEGOTIATION),
383 SSL_FLAG_TBL_SRV("DHSingle", SSL_OP_SINGLE_DH_USE),
384 SSL_FLAG_TBL_SRV("ECDHSingle", SSL_OP_SINGLE_ECDH_USE),
385 SSL_FLAG_TBL("UnsafeLegacyRenegotiation",
386 SSL_OP_ALLOW_UNSAFE_LEGACY_RENEGOTIATION),
387 SSL_FLAG_TBL("UnsafeLegacyServerConnect",
388 SSL_OP_LEGACY_SERVER_CONNECT),
389 SSL_FLAG_TBL("ClientRenegotiation",
390 SSL_OP_ALLOW_CLIENT_RENEGOTIATION),
391 SSL_FLAG_TBL_INV("EncryptThenMac", SSL_OP_NO_ENCRYPT_THEN_MAC),
392 SSL_FLAG_TBL("NoRenegotiation", SSL_OP_NO_RENEGOTIATION),
393 SSL_FLAG_TBL("AllowNoDHEKEX", SSL_OP_ALLOW_NO_DHE_KEX),
394 SSL_FLAG_TBL("PreferNoDHEKEX", SSL_OP_PREFER_NO_DHE_KEX),
395 SSL_FLAG_TBL("PrioritizeChaCha", SSL_OP_PRIORITIZE_CHACHA),
396 SSL_FLAG_TBL("MiddleboxCompat", SSL_OP_ENABLE_MIDDLEBOX_COMPAT),
397 SSL_FLAG_TBL_INV("AntiReplay", SSL_OP_NO_ANTI_REPLAY),
398 SSL_FLAG_TBL_INV("ExtendedMasterSecret", SSL_OP_NO_EXTENDED_MASTER_SECRET),
399 SSL_FLAG_TBL_INV("CANames", SSL_OP_DISABLE_TLSEXT_CA_NAMES),
400 SSL_FLAG_TBL("KTLS", SSL_OP_ENABLE_KTLS),
401 SSL_FLAG_TBL_CERT("StrictCertCheck", SSL_CERT_FLAG_TLS_STRICT),
402 SSL_FLAG_TBL_INV("TxCertificateCompression", SSL_OP_NO_TX_CERTIFICATE_COMPRESSION),
403 SSL_FLAG_TBL_INV("RxCertificateCompression", SSL_OP_NO_RX_CERTIFICATE_COMPRESSION),
404 SSL_FLAG_TBL("KTLSTxZerocopySendfile", SSL_OP_ENABLE_KTLS_TX_ZEROCOPY_SENDFILE),
405 SSL_FLAG_TBL("IgnoreUnexpectedEOF", SSL_OP_IGNORE_UNEXPECTED_EOF),
409 cctx->tbl = ssl_option_list;
410 cctx->ntbl = OSSL_NELEM(ssl_option_list);
411 return CONF_parse_list(value, ',', 1, ssl_set_option_list, cctx);
414 static int cmd_VerifyMode(SSL_CONF_CTX *cctx, const char *value)
416 static const ssl_flag_tbl ssl_vfy_list[] = {
417 SSL_FLAG_VFY_CLI("Peer", SSL_VERIFY_PEER),
418 SSL_FLAG_VFY_SRV("Request", SSL_VERIFY_PEER),
419 SSL_FLAG_VFY_SRV("Require",
420 SSL_VERIFY_PEER | SSL_VERIFY_FAIL_IF_NO_PEER_CERT),
421 SSL_FLAG_VFY_SRV("Once", SSL_VERIFY_PEER | SSL_VERIFY_CLIENT_ONCE),
422 SSL_FLAG_VFY_SRV("RequestPostHandshake",
423 SSL_VERIFY_PEER | SSL_VERIFY_POST_HANDSHAKE),
424 SSL_FLAG_VFY_SRV("RequirePostHandshake",
425 SSL_VERIFY_PEER | SSL_VERIFY_POST_HANDSHAKE |
426 SSL_VERIFY_FAIL_IF_NO_PEER_CERT),
430 cctx->tbl = ssl_vfy_list;
431 cctx->ntbl = OSSL_NELEM(ssl_vfy_list);
432 return CONF_parse_list(value, ',', 1, ssl_set_option_list, cctx);
435 static int cmd_Certificate(SSL_CONF_CTX *cctx, const char *value)
439 if (cctx->ctx != NULL) {
440 rv = SSL_CTX_use_certificate_chain_file(cctx->ctx, value);
443 if (cctx->ssl != NULL) {
444 SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(cctx->ssl);
447 rv = SSL_use_certificate_chain_file(cctx->ssl, value);
453 if (rv > 0 && c != NULL && cctx->flags & SSL_CONF_FLAG_REQUIRE_PRIVATE) {
454 char **pfilename = &cctx->cert_filename[c->key - c->pkeys];
456 OPENSSL_free(*pfilename);
457 *pfilename = OPENSSL_strdup(value);
458 if (*pfilename == NULL)
465 static int cmd_PrivateKey(SSL_CONF_CTX *cctx, const char *value)
468 if (!(cctx->flags & SSL_CONF_FLAG_CERTIFICATE))
471 rv = SSL_CTX_use_PrivateKey_file(cctx->ctx, value, SSL_FILETYPE_PEM);
473 rv = SSL_use_PrivateKey_file(cctx->ssl, value, SSL_FILETYPE_PEM);
477 static int cmd_ServerInfoFile(SSL_CONF_CTX *cctx, const char *value)
481 rv = SSL_CTX_use_serverinfo_file(cctx->ctx, value);
485 static int do_store(SSL_CONF_CTX *cctx,
486 const char *CAfile, const char *CApath, const char *CAstore,
492 OSSL_LIB_CTX *libctx = NULL;
493 const char *propq = NULL;
495 if (cctx->ctx != NULL) {
496 cert = cctx->ctx->cert;
498 } else if (cctx->ssl != NULL) {
499 SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(cctx->ssl);
505 ctx = cctx->ssl->ctx;
510 libctx = ctx->libctx;
513 st = verify_store ? &cert->verify_store : &cert->chain_store;
515 *st = X509_STORE_new();
520 if (CAfile != NULL && !X509_STORE_load_file_ex(*st, CAfile, libctx, propq))
522 if (CApath != NULL && !X509_STORE_load_path(*st, CApath))
524 if (CAstore != NULL && !X509_STORE_load_store_ex(*st, CAstore, libctx,
530 static int cmd_ChainCAPath(SSL_CONF_CTX *cctx, const char *value)
532 return do_store(cctx, NULL, value, NULL, 0);
535 static int cmd_ChainCAFile(SSL_CONF_CTX *cctx, const char *value)
537 return do_store(cctx, value, NULL, NULL, 0);
540 static int cmd_ChainCAStore(SSL_CONF_CTX *cctx, const char *value)
542 return do_store(cctx, NULL, NULL, value, 0);
545 static int cmd_VerifyCAPath(SSL_CONF_CTX *cctx, const char *value)
547 return do_store(cctx, NULL, value, NULL, 1);
550 static int cmd_VerifyCAFile(SSL_CONF_CTX *cctx, const char *value)
552 return do_store(cctx, value, NULL, NULL, 1);
555 static int cmd_VerifyCAStore(SSL_CONF_CTX *cctx, const char *value)
557 return do_store(cctx, NULL, NULL, value, 1);
560 static int cmd_RequestCAFile(SSL_CONF_CTX *cctx, const char *value)
562 if (cctx->canames == NULL)
563 cctx->canames = sk_X509_NAME_new_null();
564 if (cctx->canames == NULL)
566 return SSL_add_file_cert_subjects_to_stack(cctx->canames, value);
569 static int cmd_ClientCAFile(SSL_CONF_CTX *cctx, const char *value)
571 return cmd_RequestCAFile(cctx, value);
574 static int cmd_RequestCAPath(SSL_CONF_CTX *cctx, const char *value)
576 if (cctx->canames == NULL)
577 cctx->canames = sk_X509_NAME_new_null();
578 if (cctx->canames == NULL)
580 return SSL_add_dir_cert_subjects_to_stack(cctx->canames, value);
583 static int cmd_ClientCAPath(SSL_CONF_CTX *cctx, const char *value)
585 return cmd_RequestCAPath(cctx, value);
588 static int cmd_RequestCAStore(SSL_CONF_CTX *cctx, const char *value)
590 if (cctx->canames == NULL)
591 cctx->canames = sk_X509_NAME_new_null();
592 if (cctx->canames == NULL)
594 return SSL_add_store_cert_subjects_to_stack(cctx->canames, value);
597 static int cmd_ClientCAStore(SSL_CONF_CTX *cctx, const char *value)
599 return cmd_RequestCAStore(cctx, value);
602 static int cmd_DHParameters(SSL_CONF_CTX *cctx, const char *value)
605 EVP_PKEY *dhpkey = NULL;
607 SSL_CTX *sslctx = (cctx->ssl != NULL) ? cctx->ssl->ctx : cctx->ctx;
608 OSSL_DECODER_CTX *decoderctx = NULL;
610 if (cctx->ctx != NULL || cctx->ssl != NULL) {
611 in = BIO_new(BIO_s_file());
614 if (BIO_read_filename(in, value) <= 0)
618 = OSSL_DECODER_CTX_new_for_pkey(&dhpkey, "PEM", NULL, "DH",
619 OSSL_KEYMGMT_SELECT_DOMAIN_PARAMETERS,
620 sslctx->libctx, sslctx->propq);
621 if (decoderctx == NULL)
624 while (!OSSL_DECODER_from_bio(decoderctx, in)
627 OSSL_DECODER_CTX_free(decoderctx);
629 if (dhpkey == NULL) {
630 ERR_clear_last_mark();
638 if (cctx->ctx != NULL) {
639 if ((rv = SSL_CTX_set0_tmp_dh_pkey(cctx->ctx, dhpkey)) > 0)
642 if (cctx->ssl != NULL) {
643 if ((rv = SSL_set0_tmp_dh_pkey(cctx->ssl, dhpkey)) > 0)
647 EVP_PKEY_free(dhpkey);
652 static int cmd_RecordPadding(SSL_CONF_CTX *cctx, const char *value)
655 int block_size = atoi(value);
658 * All we care about is a non-negative value,
659 * the setters check the range
661 if (block_size >= 0) {
663 rv = SSL_CTX_set_block_padding(cctx->ctx, block_size);
665 rv = SSL_set_block_padding(cctx->ssl, block_size);
671 static int cmd_NumTickets(SSL_CONF_CTX *cctx, const char *value)
674 int num_tickets = atoi(value);
676 if (num_tickets >= 0) {
678 rv = SSL_CTX_set_num_tickets(cctx->ctx, num_tickets);
680 rv = SSL_set_num_tickets(cctx->ssl, num_tickets);
686 int (*cmd) (SSL_CONF_CTX *cctx, const char *value);
687 const char *str_file;
688 const char *str_cmdline;
689 unsigned short flags;
690 unsigned short value_type;
693 /* Table of supported parameters */
695 #define SSL_CONF_CMD(name, cmdopt, flags, type) \
696 {cmd_##name, #name, cmdopt, flags, type}
698 #define SSL_CONF_CMD_STRING(name, cmdopt, flags) \
699 SSL_CONF_CMD(name, cmdopt, flags, SSL_CONF_TYPE_STRING)
701 #define SSL_CONF_CMD_SWITCH(name, flags) \
702 {0, NULL, name, flags, SSL_CONF_TYPE_NONE}
704 /* See apps/include/opt.h if you change this table. */
705 /* The SSL_CONF_CMD_SWITCH should be the same order as ssl_cmd_switches */
706 static const ssl_conf_cmd_tbl ssl_conf_cmds[] = {
707 SSL_CONF_CMD_SWITCH("no_ssl3", 0),
708 SSL_CONF_CMD_SWITCH("no_tls1", 0),
709 SSL_CONF_CMD_SWITCH("no_tls1_1", 0),
710 SSL_CONF_CMD_SWITCH("no_tls1_2", 0),
711 SSL_CONF_CMD_SWITCH("no_tls1_3", 0),
712 SSL_CONF_CMD_SWITCH("bugs", 0),
713 SSL_CONF_CMD_SWITCH("no_comp", 0),
714 SSL_CONF_CMD_SWITCH("comp", 0),
715 SSL_CONF_CMD_SWITCH("no_tx_cert_comp", 0),
716 SSL_CONF_CMD_SWITCH("tx_cert_comp", 0),
717 SSL_CONF_CMD_SWITCH("no_rx_cert_comp", 0),
718 SSL_CONF_CMD_SWITCH("rx_cert_comp", 0),
719 SSL_CONF_CMD_SWITCH("ecdh_single", SSL_CONF_FLAG_SERVER),
720 SSL_CONF_CMD_SWITCH("no_ticket", 0),
721 SSL_CONF_CMD_SWITCH("serverpref", SSL_CONF_FLAG_SERVER),
722 SSL_CONF_CMD_SWITCH("legacy_renegotiation", 0),
723 SSL_CONF_CMD_SWITCH("client_renegotiation", SSL_CONF_FLAG_SERVER),
724 SSL_CONF_CMD_SWITCH("legacy_server_connect", SSL_CONF_FLAG_CLIENT),
725 SSL_CONF_CMD_SWITCH("no_renegotiation", 0),
726 SSL_CONF_CMD_SWITCH("no_resumption_on_reneg", SSL_CONF_FLAG_SERVER),
727 SSL_CONF_CMD_SWITCH("no_legacy_server_connect", SSL_CONF_FLAG_CLIENT),
728 SSL_CONF_CMD_SWITCH("allow_no_dhe_kex", 0),
729 SSL_CONF_CMD_SWITCH("prefer_no_dhe_kex", 0),
730 SSL_CONF_CMD_SWITCH("prioritize_chacha", SSL_CONF_FLAG_SERVER),
731 SSL_CONF_CMD_SWITCH("strict", 0),
732 SSL_CONF_CMD_SWITCH("no_middlebox", 0),
733 SSL_CONF_CMD_SWITCH("anti_replay", SSL_CONF_FLAG_SERVER),
734 SSL_CONF_CMD_SWITCH("no_anti_replay", SSL_CONF_FLAG_SERVER),
735 SSL_CONF_CMD_SWITCH("no_etm", 0),
736 SSL_CONF_CMD_SWITCH("no_ems", 0),
737 SSL_CONF_CMD_STRING(SignatureAlgorithms, "sigalgs", 0),
738 SSL_CONF_CMD_STRING(ClientSignatureAlgorithms, "client_sigalgs", 0),
739 SSL_CONF_CMD_STRING(Curves, "curves", 0),
740 SSL_CONF_CMD_STRING(Groups, "groups", 0),
741 SSL_CONF_CMD_STRING(ECDHParameters, "named_curve", SSL_CONF_FLAG_SERVER),
742 SSL_CONF_CMD_STRING(CipherString, "cipher", 0),
743 SSL_CONF_CMD_STRING(Ciphersuites, "ciphersuites", 0),
744 SSL_CONF_CMD_STRING(Protocol, NULL, 0),
745 SSL_CONF_CMD_STRING(MinProtocol, "min_protocol", 0),
746 SSL_CONF_CMD_STRING(MaxProtocol, "max_protocol", 0),
747 SSL_CONF_CMD_STRING(Options, NULL, 0),
748 SSL_CONF_CMD_STRING(VerifyMode, NULL, 0),
749 SSL_CONF_CMD(Certificate, "cert", SSL_CONF_FLAG_CERTIFICATE,
751 SSL_CONF_CMD(PrivateKey, "key", SSL_CONF_FLAG_CERTIFICATE,
753 SSL_CONF_CMD(ServerInfoFile, NULL,
754 SSL_CONF_FLAG_SERVER | SSL_CONF_FLAG_CERTIFICATE,
756 SSL_CONF_CMD(ChainCAPath, "chainCApath", SSL_CONF_FLAG_CERTIFICATE,
758 SSL_CONF_CMD(ChainCAFile, "chainCAfile", SSL_CONF_FLAG_CERTIFICATE,
760 SSL_CONF_CMD(ChainCAStore, "chainCAstore", SSL_CONF_FLAG_CERTIFICATE,
761 SSL_CONF_TYPE_STORE),
762 SSL_CONF_CMD(VerifyCAPath, "verifyCApath", SSL_CONF_FLAG_CERTIFICATE,
764 SSL_CONF_CMD(VerifyCAFile, "verifyCAfile", SSL_CONF_FLAG_CERTIFICATE,
766 SSL_CONF_CMD(VerifyCAStore, "verifyCAstore", SSL_CONF_FLAG_CERTIFICATE,
767 SSL_CONF_TYPE_STORE),
768 SSL_CONF_CMD(RequestCAFile, "requestCAFile", SSL_CONF_FLAG_CERTIFICATE,
770 SSL_CONF_CMD(ClientCAFile, NULL,
771 SSL_CONF_FLAG_SERVER | SSL_CONF_FLAG_CERTIFICATE,
773 SSL_CONF_CMD(RequestCAPath, NULL, SSL_CONF_FLAG_CERTIFICATE,
775 SSL_CONF_CMD(ClientCAPath, NULL,
776 SSL_CONF_FLAG_SERVER | SSL_CONF_FLAG_CERTIFICATE,
778 SSL_CONF_CMD(RequestCAStore, "requestCAStore", SSL_CONF_FLAG_CERTIFICATE,
779 SSL_CONF_TYPE_STORE),
780 SSL_CONF_CMD(ClientCAStore, NULL,
781 SSL_CONF_FLAG_SERVER | SSL_CONF_FLAG_CERTIFICATE,
782 SSL_CONF_TYPE_STORE),
783 SSL_CONF_CMD(DHParameters, "dhparam",
784 SSL_CONF_FLAG_SERVER | SSL_CONF_FLAG_CERTIFICATE,
786 SSL_CONF_CMD_STRING(RecordPadding, "record_padding", 0),
787 SSL_CONF_CMD_STRING(NumTickets, "num_tickets", SSL_CONF_FLAG_SERVER),
790 /* Supported switches: must match order of switches in ssl_conf_cmds */
791 static const ssl_switch_tbl ssl_cmd_switches[] = {
792 {SSL_OP_NO_SSLv3, 0}, /* no_ssl3 */
793 {SSL_OP_NO_TLSv1, 0}, /* no_tls1 */
794 {SSL_OP_NO_TLSv1_1, 0}, /* no_tls1_1 */
795 {SSL_OP_NO_TLSv1_2, 0}, /* no_tls1_2 */
796 {SSL_OP_NO_TLSv1_3, 0}, /* no_tls1_3 */
797 {SSL_OP_ALL, 0}, /* bugs */
798 {SSL_OP_NO_COMPRESSION, 0}, /* no_comp */
799 {SSL_OP_NO_COMPRESSION, SSL_TFLAG_INV}, /* comp */
800 {SSL_OP_NO_TX_CERTIFICATE_COMPRESSION, 0}, /* no_tx_cert_comp */
801 {SSL_OP_NO_TX_CERTIFICATE_COMPRESSION, SSL_TFLAG_INV}, /* tx_cert_comp */
802 {SSL_OP_NO_RX_CERTIFICATE_COMPRESSION, 0}, /* no_rx_cert_comp */
803 {SSL_OP_NO_RX_CERTIFICATE_COMPRESSION, SSL_TFLAG_INV}, /* rx_cert_comp */
804 {SSL_OP_SINGLE_ECDH_USE, 0}, /* ecdh_single */
805 {SSL_OP_NO_TICKET, 0}, /* no_ticket */
806 {SSL_OP_CIPHER_SERVER_PREFERENCE, 0}, /* serverpref */
807 /* legacy_renegotiation */
808 {SSL_OP_ALLOW_UNSAFE_LEGACY_RENEGOTIATION, 0},
809 /* Allow client renegotiation */
810 {SSL_OP_ALLOW_CLIENT_RENEGOTIATION, 0},
811 /* legacy_server_connect */
812 {SSL_OP_LEGACY_SERVER_CONNECT, 0},
813 /* no_renegotiation */
814 {SSL_OP_NO_RENEGOTIATION, 0},
815 /* no_resumption_on_reneg */
816 {SSL_OP_NO_SESSION_RESUMPTION_ON_RENEGOTIATION, 0},
817 /* no_legacy_server_connect */
818 {SSL_OP_LEGACY_SERVER_CONNECT, SSL_TFLAG_INV},
819 /* allow_no_dhe_kex */
820 {SSL_OP_ALLOW_NO_DHE_KEX, 0},
821 /* prefer_no_dhe_kex */
822 {SSL_OP_PREFER_NO_DHE_KEX, 0},
823 /* chacha reprioritization */
824 {SSL_OP_PRIORITIZE_CHACHA, 0},
825 {SSL_CERT_FLAG_TLS_STRICT, SSL_TFLAG_CERT}, /* strict */
827 {SSL_OP_ENABLE_MIDDLEBOX_COMPAT, SSL_TFLAG_INV},
829 {SSL_OP_NO_ANTI_REPLAY, SSL_TFLAG_INV},
831 {SSL_OP_NO_ANTI_REPLAY, 0},
832 /* no Encrypt-then-Mac */
833 {SSL_OP_NO_ENCRYPT_THEN_MAC, 0},
834 /* no Extended master secret */
835 {SSL_OP_NO_EXTENDED_MASTER_SECRET, 0},
838 static int ssl_conf_cmd_skip_prefix(SSL_CONF_CTX *cctx, const char **pcmd)
840 if (pcmd == NULL || *pcmd == NULL)
842 /* If a prefix is set, check and skip */
844 if (strlen(*pcmd) <= cctx->prefixlen)
846 if (cctx->flags & SSL_CONF_FLAG_CMDLINE &&
847 strncmp(*pcmd, cctx->prefix, cctx->prefixlen))
849 if (cctx->flags & SSL_CONF_FLAG_FILE &&
850 OPENSSL_strncasecmp(*pcmd, cctx->prefix, cctx->prefixlen))
852 *pcmd += cctx->prefixlen;
853 } else if (cctx->flags & SSL_CONF_FLAG_CMDLINE) {
854 if (**pcmd != '-' || !(*pcmd)[1])
861 /* Determine if a command is allowed according to cctx flags */
862 static int ssl_conf_cmd_allowed(SSL_CONF_CTX *cctx, const ssl_conf_cmd_tbl *t)
864 unsigned int tfl = t->flags;
865 unsigned int cfl = cctx->flags;
866 if ((tfl & SSL_CONF_FLAG_SERVER) && !(cfl & SSL_CONF_FLAG_SERVER))
868 if ((tfl & SSL_CONF_FLAG_CLIENT) && !(cfl & SSL_CONF_FLAG_CLIENT))
870 if ((tfl & SSL_CONF_FLAG_CERTIFICATE)
871 && !(cfl & SSL_CONF_FLAG_CERTIFICATE))
876 static const ssl_conf_cmd_tbl *ssl_conf_cmd_lookup(SSL_CONF_CTX *cctx,
879 const ssl_conf_cmd_tbl *t;
884 /* Look for matching parameter name in table */
885 for (i = 0, t = ssl_conf_cmds; i < OSSL_NELEM(ssl_conf_cmds); i++, t++) {
886 if (ssl_conf_cmd_allowed(cctx, t)) {
887 if (cctx->flags & SSL_CONF_FLAG_CMDLINE) {
888 if (t->str_cmdline && strcmp(t->str_cmdline, cmd) == 0)
891 if (cctx->flags & SSL_CONF_FLAG_FILE) {
892 if (t->str_file && OPENSSL_strcasecmp(t->str_file, cmd) == 0)
900 static int ctrl_switch_option(SSL_CONF_CTX *cctx, const ssl_conf_cmd_tbl *cmd)
902 /* Find index of command in table */
903 size_t idx = cmd - ssl_conf_cmds;
904 const ssl_switch_tbl *scmd;
906 /* Sanity check index */
907 if (idx >= OSSL_NELEM(ssl_cmd_switches)) {
908 ERR_raise(ERR_LIB_SSL, ERR_R_INTERNAL_ERROR);
911 /* Obtain switches entry with same index */
912 scmd = ssl_cmd_switches + idx;
913 ssl_set_option(cctx, scmd->name_flags, scmd->option_value, 1);
917 int SSL_CONF_cmd(SSL_CONF_CTX *cctx, const char *cmd, const char *value)
919 const ssl_conf_cmd_tbl *runcmd;
921 ERR_raise(ERR_LIB_SSL, SSL_R_INVALID_NULL_CMD_NAME);
925 if (!ssl_conf_cmd_skip_prefix(cctx, &cmd))
928 runcmd = ssl_conf_cmd_lookup(cctx, cmd);
933 if (runcmd->value_type == SSL_CONF_TYPE_NONE) {
934 return ctrl_switch_option(cctx, runcmd);
938 rv = runcmd->cmd(cctx, value);
945 if (cctx->flags & SSL_CONF_FLAG_SHOW_ERRORS)
946 ERR_raise_data(ERR_LIB_SSL, SSL_R_BAD_VALUE,
947 "cmd=%s, value=%s", cmd,
948 value != NULL ? value : "<EMPTY>");
953 if (cctx->flags & SSL_CONF_FLAG_SHOW_ERRORS)
954 ERR_raise_data(ERR_LIB_SSL, SSL_R_UNKNOWN_CMD_NAME, "cmd=%s", cmd);
959 int SSL_CONF_cmd_argv(SSL_CONF_CTX *cctx, int *pargc, char ***pargv)
962 const char *arg = NULL, *argn;
964 if (pargc != NULL && *pargc == 0)
966 if (pargc == NULL || *pargc > 0)
970 if (pargc == NULL || *pargc > 1)
974 cctx->flags &= ~SSL_CONF_FLAG_FILE;
975 cctx->flags |= SSL_CONF_FLAG_CMDLINE;
976 rv = SSL_CONF_cmd(cctx, arg, argn);
978 /* Success: update pargc, pargv */
984 /* Unknown switch: indicate no arguments processed */
987 /* Some error occurred processing command, return fatal error */
993 int SSL_CONF_cmd_value_type(SSL_CONF_CTX *cctx, const char *cmd)
995 if (ssl_conf_cmd_skip_prefix(cctx, &cmd)) {
996 const ssl_conf_cmd_tbl *runcmd;
997 runcmd = ssl_conf_cmd_lookup(cctx, cmd);
999 return runcmd->value_type;
1001 return SSL_CONF_TYPE_UNKNOWN;
1004 SSL_CONF_CTX *SSL_CONF_CTX_new(void)
1006 SSL_CONF_CTX *ret = OPENSSL_zalloc(sizeof(*ret));
1011 int SSL_CONF_CTX_finish(SSL_CONF_CTX *cctx)
1013 /* See if any certificates are missing private keys */
1017 if (cctx->ctx != NULL) {
1018 c = cctx->ctx->cert;
1019 } else if (cctx->ssl != NULL) {
1020 SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(cctx->ssl);
1025 if (c != NULL && cctx->flags & SSL_CONF_FLAG_REQUIRE_PRIVATE) {
1026 for (i = 0; i < SSL_PKEY_NUM; i++) {
1027 const char *p = cctx->cert_filename[i];
1029 * If missing private key try to load one from certificate file
1031 if (p && !c->pkeys[i].privatekey) {
1032 if (!cmd_PrivateKey(cctx, p))
1037 if (cctx->canames) {
1039 SSL_set0_CA_list(cctx->ssl, cctx->canames);
1041 SSL_CTX_set0_CA_list(cctx->ctx, cctx->canames);
1043 sk_X509_NAME_pop_free(cctx->canames, X509_NAME_free);
1044 cctx->canames = NULL;
1049 void SSL_CONF_CTX_free(SSL_CONF_CTX *cctx)
1053 for (i = 0; i < SSL_PKEY_NUM; i++)
1054 OPENSSL_free(cctx->cert_filename[i]);
1055 OPENSSL_free(cctx->prefix);
1056 sk_X509_NAME_pop_free(cctx->canames, X509_NAME_free);
1061 unsigned int SSL_CONF_CTX_set_flags(SSL_CONF_CTX *cctx, unsigned int flags)
1063 cctx->flags |= flags;
1067 unsigned int SSL_CONF_CTX_clear_flags(SSL_CONF_CTX *cctx, unsigned int flags)
1069 cctx->flags &= ~flags;
1073 int SSL_CONF_CTX_set1_prefix(SSL_CONF_CTX *cctx, const char *pre)
1077 tmp = OPENSSL_strdup(pre);
1081 OPENSSL_free(cctx->prefix);
1084 cctx->prefixlen = strlen(tmp);
1086 cctx->prefixlen = 0;
1090 void SSL_CONF_CTX_set_ssl(SSL_CONF_CTX *cctx, SSL *ssl)
1095 SSL_CONNECTION *sc = SSL_CONNECTION_FROM_SSL(ssl);
1099 cctx->poptions = &sc->options;
1100 cctx->min_version = &sc->min_proto_version;
1101 cctx->max_version = &sc->max_proto_version;
1102 cctx->pcert_flags = &sc->cert->cert_flags;
1103 cctx->pvfy_flags = &sc->verify_mode;
1105 cctx->poptions = NULL;
1106 cctx->min_version = NULL;
1107 cctx->max_version = NULL;
1108 cctx->pcert_flags = NULL;
1109 cctx->pvfy_flags = NULL;
1113 void SSL_CONF_CTX_set_ssl_ctx(SSL_CONF_CTX *cctx, SSL_CTX *ctx)
1118 cctx->poptions = &ctx->options;
1119 cctx->min_version = &ctx->min_proto_version;
1120 cctx->max_version = &ctx->max_proto_version;
1121 cctx->pcert_flags = &ctx->cert->cert_flags;
1122 cctx->pvfy_flags = &ctx->verify_mode;
1124 cctx->poptions = NULL;
1125 cctx->min_version = NULL;
1126 cctx->max_version = NULL;
1127 cctx->pcert_flags = NULL;
1128 cctx->pvfy_flags = NULL;