Refine and re-wrap Min/Max protocol docs
[openssl.git] / ssl / ssl_conf.c
1 /*
2  * ! \file ssl/ssl_conf.c \brief SSL configuration functions
3  */
4 /* ====================================================================
5  * Copyright (c) 2012 The OpenSSL Project.  All rights reserved.
6  *
7  * Redistribution and use in source and binary forms, with or without
8  * modification, are permitted provided that the following conditions
9  * are met:
10  *
11  * 1. Redistributions of source code must retain the above copyright
12  *    notice, this list of conditions and the following disclaimer.
13  *
14  * 2. Redistributions in binary form must reproduce the above copyright
15  *    notice, this list of conditions and the following disclaimer in
16  *    the documentation and/or other materials provided with the
17  *    distribution.
18  *
19  * 3. All advertising materials mentioning features or use of this
20  *    software must display the following acknowledgment:
21  *    "This product includes software developed by the OpenSSL Project
22  *    for use in the OpenSSL Toolkit. (http://www.openssl.org/)"
23  *
24  * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
25  *    endorse or promote products derived from this software without
26  *    prior written permission. For written permission, please contact
27  *    openssl-core@openssl.org.
28  *
29  * 5. Products derived from this software may not be called "OpenSSL"
30  *    nor may "OpenSSL" appear in their names without prior written
31  *    permission of the OpenSSL Project.
32  *
33  * 6. Redistributions of any form whatsoever must retain the following
34  *    acknowledgment:
35  *    "This product includes software developed by the OpenSSL Project
36  *    for use in the OpenSSL Toolkit (http://www.openssl.org/)"
37  *
38  * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
39  * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
40  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
41  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE OpenSSL PROJECT OR
42  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
43  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
44  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
45  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
46  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
47  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
48  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
49  * OF THE POSSIBILITY OF SUCH DAMAGE.
50  * ====================================================================
51  *
52  * This product includes cryptographic software written by Eric Young
53  * (eay@cryptsoft.com).  This product includes software written by Tim
54  * Hudson (tjh@cryptsoft.com).
55  *
56  */
57
58 #ifdef REF_CHECK
59 # include <assert.h>
60 #endif
61 #include <stdio.h>
62 #include "ssl_locl.h"
63 #include <openssl/conf.h>
64 #include <openssl/objects.h>
65 #ifndef OPENSSL_NO_DH
66 # include <openssl/dh.h>
67 #endif
68
69 /*
70  * structure holding name tables. This is used for pemitted elements in lists
71  * such as TLSv1.
72  */
73
74 typedef struct {
75     const char *name;
76     int namelen;
77     unsigned int name_flags;
78     unsigned long option_value;
79 } ssl_flag_tbl;
80
81 /* Switch table: use for single command line switches like no_tls2 */
82 typedef struct {
83     unsigned long option_value;
84     unsigned int name_flags;
85 } ssl_switch_tbl;
86
87 /* Sense of name is inverted e.g. "TLSv1" will clear SSL_OP_NO_TLSv1 */
88 #define SSL_TFLAG_INV   0x1
89 /* Mask for type of flag referred to */
90 #define SSL_TFLAG_TYPE_MASK 0xf00
91 /* Flag is for options */
92 #define SSL_TFLAG_OPTION    0x000
93 /* Flag is for cert_flags */
94 #define SSL_TFLAG_CERT      0x100
95 /* Flag is for verify mode */
96 #define SSL_TFLAG_VFY       0x200
97 /* Option can only be used for clients */
98 #define SSL_TFLAG_CLIENT SSL_CONF_FLAG_CLIENT
99 /* Option can only be used for servers */
100 #define SSL_TFLAG_SERVER SSL_CONF_FLAG_SERVER
101 #define SSL_TFLAG_BOTH (SSL_TFLAG_CLIENT|SSL_TFLAG_SERVER)
102
103 #define SSL_FLAG_TBL(str, flag) \
104         {str, (int)(sizeof(str) - 1), SSL_TFLAG_BOTH, flag}
105 #define SSL_FLAG_TBL_SRV(str, flag) \
106         {str, (int)(sizeof(str) - 1), SSL_TFLAG_SERVER, flag}
107 #define SSL_FLAG_TBL_CLI(str, flag) \
108         {str, (int)(sizeof(str) - 1), SSL_TFLAG_CLIENT, flag}
109 #define SSL_FLAG_TBL_INV(str, flag) \
110         {str, (int)(sizeof(str) - 1), SSL_TFLAG_INV|SSL_TFLAG_BOTH, flag}
111 #define SSL_FLAG_TBL_SRV_INV(str, flag) \
112         {str, (int)(sizeof(str) - 1), SSL_TFLAG_INV|SSL_TFLAG_SERVER, flag}
113 #define SSL_FLAG_TBL_CERT(str, flag) \
114         {str, (int)(sizeof(str) - 1), SSL_TFLAG_CERT|SSL_TFLAG_BOTH, flag}
115
116 #define SSL_FLAG_VFY_CLI(str, flag) \
117         {str, (int)(sizeof(str) - 1), SSL_TFLAG_VFY | SSL_TFLAG_CLIENT, flag}
118 #define SSL_FLAG_VFY_SRV(str, flag) \
119         {str, (int)(sizeof(str) - 1), SSL_TFLAG_VFY | SSL_TFLAG_SERVER, flag}
120
121 /*
122  * Opaque structure containing SSL configuration context.
123  */
124
125 struct ssl_conf_ctx_st {
126     /*
127      * Various flags indicating (among other things) which options we will
128      * recognise.
129      */
130     unsigned int flags;
131     /* Prefix and length of commands */
132     char *prefix;
133     size_t prefixlen;
134     /* SSL_CTX or SSL structure to perform operations on */
135     SSL_CTX *ctx;
136     SSL *ssl;
137     /* Pointer to SSL or SSL_CTX options field or NULL if none */
138     uint32_t *poptions;
139     /* Certificate filenames for each type */
140     char *cert_filename[SSL_PKEY_NUM];
141     /* Pointer to SSL or SSL_CTX cert_flags or NULL if none */
142     uint32_t *pcert_flags;
143     /* Pointer to SSL or SSL_CTX verify_mode or NULL if none */
144     uint32_t *pvfy_flags;
145     /* Pointer to SSL or SSL_CTX min_version field or NULL if none */
146     int *min_version;
147     /* Pointer to SSL or SSL_CTX max_version field or NULL if none */
148     int *max_version;
149     /* Current flag table being worked on */
150     const ssl_flag_tbl *tbl;
151     /* Size of table */
152     size_t ntbl;
153     /* Client CA names */
154     STACK_OF(X509_NAME) *canames;
155 };
156
157 static void ssl_set_option(SSL_CONF_CTX *cctx, unsigned int name_flags,
158                            unsigned long option_value, int onoff)
159 {
160     uint32_t *pflags;
161     if (cctx->poptions == NULL)
162         return;
163     if (name_flags & SSL_TFLAG_INV)
164         onoff ^= 1;
165     switch (name_flags & SSL_TFLAG_TYPE_MASK) {
166
167     case SSL_TFLAG_CERT:
168         pflags = cctx->pcert_flags;
169         break;
170
171     case SSL_TFLAG_VFY:
172         pflags =  cctx->pvfy_flags;
173         break;
174
175     case SSL_TFLAG_OPTION:
176         pflags = cctx->poptions;
177         break;
178
179     default:
180         return;
181
182     }
183     if (onoff)
184         *pflags |= option_value;
185     else
186         *pflags &= ~option_value;
187 }
188
189 static int ssl_match_option(SSL_CONF_CTX *cctx, const ssl_flag_tbl *tbl,
190                             const char *name, int namelen, int onoff)
191 {
192     /* If name not relevant for context skip */
193     if (!(cctx->flags & tbl->name_flags & SSL_TFLAG_BOTH))
194         return 0;
195     if (namelen == -1) {
196         if (strcmp(tbl->name, name))
197             return 0;
198     } else if (tbl->namelen != namelen
199                || strncasecmp(tbl->name, name, namelen))
200         return 0;
201     ssl_set_option(cctx, tbl->name_flags, tbl->option_value, onoff);
202     return 1;
203 }
204
205 static int ssl_set_option_list(const char *elem, int len, void *usr)
206 {
207     SSL_CONF_CTX *cctx = usr;
208     size_t i;
209     const ssl_flag_tbl *tbl;
210     int onoff = 1;
211     /*
212      * len == -1 indicates not being called in list context, just for single
213      * command line switches, so don't allow +, -.
214      */
215     if (elem == NULL)
216         return 0;
217     if (len != -1) {
218         if (*elem == '+') {
219             elem++;
220             len--;
221             onoff = 1;
222         } else if (*elem == '-') {
223             elem++;
224             len--;
225             onoff = 0;
226         }
227     }
228     for (i = 0, tbl = cctx->tbl; i < cctx->ntbl; i++, tbl++) {
229         if (ssl_match_option(cctx, tbl, elem, len, onoff))
230             return 1;
231     }
232     return 0;
233 }
234
235 /* Set supported signature algorithms */
236 static int cmd_SignatureAlgorithms(SSL_CONF_CTX *cctx, const char *value)
237 {
238     int rv;
239     if (cctx->ssl)
240         rv = SSL_set1_sigalgs_list(cctx->ssl, value);
241     /* NB: ctx == NULL performs syntax checking only */
242     else
243         rv = SSL_CTX_set1_sigalgs_list(cctx->ctx, value);
244     return rv > 0;
245 }
246
247 /* Set supported client signature algorithms */
248 static int cmd_ClientSignatureAlgorithms(SSL_CONF_CTX *cctx,
249                                          const char *value)
250 {
251     int rv;
252     if (cctx->ssl)
253         rv = SSL_set1_client_sigalgs_list(cctx->ssl, value);
254     /* NB: ctx == NULL performs syntax checking only */
255     else
256         rv = SSL_CTX_set1_client_sigalgs_list(cctx->ctx, value);
257     return rv > 0;
258 }
259
260 static int cmd_Curves(SSL_CONF_CTX *cctx, const char *value)
261 {
262     int rv;
263     if (cctx->ssl)
264         rv = SSL_set1_curves_list(cctx->ssl, value);
265     /* NB: ctx == NULL performs syntax checking only */
266     else
267         rv = SSL_CTX_set1_curves_list(cctx->ctx, value);
268     return rv > 0;
269 }
270
271 #ifndef OPENSSL_NO_EC
272 /* ECDH temporary parameters */
273 static int cmd_ECDHParameters(SSL_CONF_CTX *cctx, const char *value)
274 {
275     int rv = 1;
276     EC_KEY *ecdh;
277     int nid;
278
279     nid = EC_curve_nist2nid(value);
280     if (nid == NID_undef)
281         nid = OBJ_sn2nid(value);
282     if (nid == 0)
283         return 0;
284     ecdh = EC_KEY_new_by_curve_name(nid);
285     if (!ecdh)
286         return 0;
287     if (cctx->ctx)
288         rv = SSL_CTX_set_tmp_ecdh(cctx->ctx, ecdh);
289     else if (cctx->ssl)
290         rv = SSL_set_tmp_ecdh(cctx->ssl, ecdh);
291     EC_KEY_free(ecdh);
292
293     return rv > 0;
294 }
295 #endif
296 static int cmd_CipherString(SSL_CONF_CTX *cctx, const char *value)
297 {
298     int rv = 1;
299     if (cctx->ctx)
300         rv = SSL_CTX_set_cipher_list(cctx->ctx, value);
301     if (cctx->ssl)
302         rv = SSL_set_cipher_list(cctx->ssl, value);
303     return rv > 0;
304 }
305
306 static int cmd_Protocol(SSL_CONF_CTX *cctx, const char *value)
307 {
308     static const ssl_flag_tbl ssl_protocol_list[] = {
309         SSL_FLAG_TBL_INV("ALL", SSL_OP_NO_SSL_MASK),
310         SSL_FLAG_TBL_INV("SSLv2", SSL_OP_NO_SSLv2),
311         SSL_FLAG_TBL_INV("SSLv3", SSL_OP_NO_SSLv3),
312         SSL_FLAG_TBL_INV("TLSv1", SSL_OP_NO_TLSv1),
313         SSL_FLAG_TBL_INV("TLSv1.1", SSL_OP_NO_TLSv1_1),
314         SSL_FLAG_TBL_INV("TLSv1.2", SSL_OP_NO_TLSv1_2),
315         SSL_FLAG_TBL_INV("DTLSv1", SSL_OP_NO_DTLSv1),
316         SSL_FLAG_TBL_INV("DTLSv1.2", SSL_OP_NO_DTLSv1_2)
317     };
318     cctx->tbl = ssl_protocol_list;
319     cctx->ntbl = OSSL_NELEM(ssl_protocol_list);
320     return CONF_parse_list(value, ',', 1, ssl_set_option_list, cctx);
321 }
322
323 /*
324  * protocol_from_string - converts a protocol version string to a number
325  *
326  * Returns -1 on failure or the version on success
327  */
328 static int protocol_from_string(const char *value)
329 {
330     struct protocol_versions {
331         const char *name;
332         int version;
333     };
334     static const struct protocol_versions versions[] = {
335         {"SSLv3", SSL3_VERSION},
336         {"TLSv1", TLS1_VERSION},
337         {"TLSv1.1", TLS1_1_VERSION},
338         {"TLSv1.2", TLS1_2_VERSION},
339         {"DTLSv1", DTLS1_VERSION},
340         {"DTLSv1.2", DTLS1_2_VERSION}};
341     size_t i;
342     size_t n = OSSL_NELEM(versions);
343
344     for (i = 0; i < n; i++)
345         if (strcmp(versions[i].name, value) == 0)
346             return versions[i].version;
347     return -1;
348 }
349
350 /*
351  * cmd_MinProtocol - Set min protocol version
352  * @cctx: config structure to save settings in
353  * @value: The min protocol version in string form
354  *
355  * Returns 1 on success and 0 on failure.
356  */
357 static int cmd_MinProtocol(SSL_CONF_CTX *cctx, const char *value)
358 {
359     int version = protocol_from_string(value);
360
361     if (version < 0)
362         return 0;
363
364     *(cctx->min_version) = version;
365     return 1;
366 }
367
368 /*
369  * cmd_MaxProtocol - Set max protocol version
370  * @cctx: config structure to save settings in
371  * @value: The max protocol version in string form
372  *
373  * Returns 1 on success and 0 on failure.
374  */
375 static int cmd_MaxProtocol(SSL_CONF_CTX *cctx, const char *value)
376 {
377     int version = protocol_from_string(value);
378
379     if (version < 0)
380         return 0;
381
382     *(cctx->max_version) = version;
383     return 1;
384 }
385
386 static int cmd_Options(SSL_CONF_CTX *cctx, const char *value)
387 {
388     static const ssl_flag_tbl ssl_option_list[] = {
389         SSL_FLAG_TBL_INV("SessionTicket", SSL_OP_NO_TICKET),
390         SSL_FLAG_TBL_INV("EmptyFragments",
391                          SSL_OP_DONT_INSERT_EMPTY_FRAGMENTS),
392         SSL_FLAG_TBL("Bugs", SSL_OP_ALL),
393         SSL_FLAG_TBL_INV("Compression", SSL_OP_NO_COMPRESSION),
394         SSL_FLAG_TBL_SRV("ServerPreference", SSL_OP_CIPHER_SERVER_PREFERENCE),
395         SSL_FLAG_TBL_SRV("NoResumptionOnRenegotiation",
396                          SSL_OP_NO_SESSION_RESUMPTION_ON_RENEGOTIATION),
397         SSL_FLAG_TBL_SRV("DHSingle", SSL_OP_SINGLE_DH_USE),
398         SSL_FLAG_TBL_SRV("ECDHSingle", SSL_OP_SINGLE_ECDH_USE),
399         SSL_FLAG_TBL("UnsafeLegacyRenegotiation",
400                      SSL_OP_ALLOW_UNSAFE_LEGACY_RENEGOTIATION),
401     };
402     if (value == NULL)
403         return -3;
404     cctx->tbl = ssl_option_list;
405     cctx->ntbl = OSSL_NELEM(ssl_option_list);
406     return CONF_parse_list(value, ',', 1, ssl_set_option_list, cctx);
407 }
408
409 static int cmd_VerifyMode(SSL_CONF_CTX *cctx, const char *value)
410 {
411     static const ssl_flag_tbl ssl_vfy_list[] = {
412         SSL_FLAG_VFY_CLI("Peer", SSL_VERIFY_PEER),
413         SSL_FLAG_VFY_SRV("Request", SSL_VERIFY_PEER),
414         SSL_FLAG_VFY_SRV("Require",
415                          SSL_VERIFY_PEER | SSL_VERIFY_FAIL_IF_NO_PEER_CERT),
416         SSL_FLAG_VFY_SRV("Once", SSL_VERIFY_PEER | SSL_VERIFY_CLIENT_ONCE)
417     };
418     if (value == NULL)
419         return -3;
420     cctx->tbl = ssl_vfy_list;
421     cctx->ntbl = OSSL_NELEM(ssl_vfy_list);
422     return CONF_parse_list(value, ',', 1, ssl_set_option_list, cctx);
423 }
424
425 static int cmd_Certificate(SSL_CONF_CTX *cctx, const char *value)
426 {
427     int rv = 1;
428     CERT *c = NULL;
429     if (cctx->ctx) {
430         rv = SSL_CTX_use_certificate_chain_file(cctx->ctx, value);
431         c = cctx->ctx->cert;
432     }
433     if (cctx->ssl) {
434         rv = SSL_use_certificate_chain_file(cctx->ssl, value);
435         c = cctx->ssl->cert;
436     }
437     if (rv > 0 && c && cctx->flags & SSL_CONF_FLAG_REQUIRE_PRIVATE) {
438         char **pfilename = &cctx->cert_filename[c->key - c->pkeys];
439         OPENSSL_free(*pfilename);
440         *pfilename = OPENSSL_strdup(value);
441         if (!*pfilename)
442             rv = 0;
443     }
444
445     return rv > 0;
446 }
447
448 static int cmd_PrivateKey(SSL_CONF_CTX *cctx, const char *value)
449 {
450     int rv = 1;
451     if (!(cctx->flags & SSL_CONF_FLAG_CERTIFICATE))
452         return -2;
453     if (cctx->ctx)
454         rv = SSL_CTX_use_PrivateKey_file(cctx->ctx, value, SSL_FILETYPE_PEM);
455     if (cctx->ssl)
456         rv = SSL_use_PrivateKey_file(cctx->ssl, value, SSL_FILETYPE_PEM);
457     return rv > 0;
458 }
459
460 static int cmd_ServerInfoFile(SSL_CONF_CTX *cctx, const char *value)
461 {
462     int rv = 1;
463     if (cctx->ctx)
464         rv = SSL_CTX_use_serverinfo_file(cctx->ctx, value);
465     return rv > 0;
466 }
467
468 static int do_store(SSL_CONF_CTX *cctx,
469                     const char *CAfile, const char *CApath, int verify_store)
470 {
471     CERT *cert;
472     X509_STORE **st;
473     if (cctx->ctx)
474         cert = cctx->ctx->cert;
475     else if (cctx->ssl)
476         cert = cctx->ssl->cert;
477     else
478         return 1;
479     st = verify_store ? &cert->verify_store : &cert->chain_store;
480     if (*st == NULL) {
481         *st = X509_STORE_new();
482         if (*st == NULL)
483             return 0;
484     }
485     return X509_STORE_load_locations(*st, CAfile, CApath) > 0;
486 }
487
488 static int cmd_ChainCAPath(SSL_CONF_CTX *cctx, const char *value)
489 {
490     return do_store(cctx, NULL, value, 0);
491 }
492
493 static int cmd_ChainCAFile(SSL_CONF_CTX *cctx, const char *value)
494 {
495     return do_store(cctx, value, NULL, 0);
496 }
497
498 static int cmd_VerifyCAPath(SSL_CONF_CTX *cctx, const char *value)
499 {
500     return do_store(cctx, NULL, value, 1);
501 }
502
503 static int cmd_VerifyCAFile(SSL_CONF_CTX *cctx, const char *value)
504 {
505     return do_store(cctx, value, NULL, 1);
506 }
507
508 static int cmd_ClientCAFile(SSL_CONF_CTX *cctx, const char *value)
509 {
510     if (cctx->canames == NULL)
511         cctx->canames = sk_X509_NAME_new_null();
512     if (cctx->canames == NULL)
513         return 0;
514     return SSL_add_file_cert_subjects_to_stack(cctx->canames, value);
515 }
516
517 static int cmd_ClientCAPath(SSL_CONF_CTX *cctx, const char *value)
518 {
519     if (cctx->canames == NULL)
520         cctx->canames = sk_X509_NAME_new_null();
521     if (cctx->canames == NULL)
522         return 0;
523     return SSL_add_dir_cert_subjects_to_stack(cctx->canames, value);
524 }
525
526 #ifndef OPENSSL_NO_DH
527 static int cmd_DHParameters(SSL_CONF_CTX *cctx, const char *value)
528 {
529     int rv = 0;
530     DH *dh = NULL;
531     BIO *in = NULL;
532     if (cctx->ctx || cctx->ssl) {
533         in = BIO_new(BIO_s_file());
534         if (in == NULL)
535             goto end;
536         if (BIO_read_filename(in, value) <= 0)
537             goto end;
538         dh = PEM_read_bio_DHparams(in, NULL, NULL, NULL);
539         if (dh == NULL)
540             goto end;
541     } else
542         return 1;
543     if (cctx->ctx)
544         rv = SSL_CTX_set_tmp_dh(cctx->ctx, dh);
545     if (cctx->ssl)
546         rv = SSL_set_tmp_dh(cctx->ssl, dh);
547  end:
548     DH_free(dh);
549     BIO_free(in);
550     return rv > 0;
551 }
552 #endif
553 typedef struct {
554     int (*cmd) (SSL_CONF_CTX *cctx, const char *value);
555     const char *str_file;
556     const char *str_cmdline;
557     unsigned short flags;
558     unsigned short value_type;
559 } ssl_conf_cmd_tbl;
560
561 /* Table of supported parameters */
562
563 #define SSL_CONF_CMD(name, cmdopt, flags, type) \
564         {cmd_##name, #name, cmdopt, flags, type}
565
566 #define SSL_CONF_CMD_STRING(name, cmdopt, flags) \
567         SSL_CONF_CMD(name, cmdopt, flags, SSL_CONF_TYPE_STRING)
568
569 #define SSL_CONF_CMD_SWITCH(name, flags) \
570         {0, NULL, name, flags, SSL_CONF_TYPE_NONE}
571
572 /* See apps/apps.h if you change this table. */
573 static const ssl_conf_cmd_tbl ssl_conf_cmds[] = {
574     SSL_CONF_CMD_SWITCH("no_ssl3", 0),
575     SSL_CONF_CMD_SWITCH("no_tls1", 0),
576     SSL_CONF_CMD_SWITCH("no_tls1_1", 0),
577     SSL_CONF_CMD_SWITCH("no_tls1_2", 0),
578     SSL_CONF_CMD_SWITCH("bugs", 0),
579     SSL_CONF_CMD_SWITCH("no_comp", 0),
580     SSL_CONF_CMD_SWITCH("ecdh_single", SSL_CONF_FLAG_SERVER),
581     SSL_CONF_CMD_SWITCH("no_ticket", 0),
582     SSL_CONF_CMD_SWITCH("serverpref", SSL_CONF_FLAG_SERVER),
583     SSL_CONF_CMD_SWITCH("legacy_renegotiation", 0),
584     SSL_CONF_CMD_SWITCH("legacy_server_connect", SSL_CONF_FLAG_SERVER),
585     SSL_CONF_CMD_SWITCH("no_resumption_on_reneg", SSL_CONF_FLAG_SERVER),
586     SSL_CONF_CMD_SWITCH("no_legacy_server_connect", SSL_CONF_FLAG_SERVER),
587     SSL_CONF_CMD_SWITCH("strict", 0),
588 #ifdef OPENSSL_SSL_DEBUG_BROKEN_PROTOCOL
589     SSL_CONF_CMD_SWITCH("debug_broken_protocol", 0),
590 #endif
591     SSL_CONF_CMD_STRING(SignatureAlgorithms, "sigalgs", 0),
592     SSL_CONF_CMD_STRING(ClientSignatureAlgorithms, "client_sigalgs", 0),
593     SSL_CONF_CMD_STRING(Curves, "curves", 0),
594 #ifndef OPENSSL_NO_EC
595     SSL_CONF_CMD_STRING(ECDHParameters, "named_curve", SSL_CONF_FLAG_SERVER),
596 #endif
597     SSL_CONF_CMD_STRING(CipherString, "cipher", 0),
598     SSL_CONF_CMD_STRING(Protocol, NULL, 0),
599     SSL_CONF_CMD_STRING(MinProtocol, "min_protocol", SSL_CONF_FLAG_SERVER | SSL_CONF_FLAG_CLIENT),
600     SSL_CONF_CMD_STRING(MaxProtocol, "max_protocol", SSL_CONF_FLAG_SERVER | SSL_CONF_FLAG_CLIENT),
601     SSL_CONF_CMD_STRING(Options, NULL, 0),
602     SSL_CONF_CMD_STRING(VerifyMode, NULL, 0),
603     SSL_CONF_CMD(Certificate, "cert", SSL_CONF_FLAG_CERTIFICATE,
604                  SSL_CONF_TYPE_FILE),
605     SSL_CONF_CMD(PrivateKey, "key", SSL_CONF_FLAG_CERTIFICATE,
606                  SSL_CONF_TYPE_FILE),
607     SSL_CONF_CMD(ServerInfoFile, NULL,
608                  SSL_CONF_FLAG_SERVER | SSL_CONF_FLAG_CERTIFICATE,
609                  SSL_CONF_TYPE_FILE),
610     SSL_CONF_CMD(ChainCAPath, "chainCApath", SSL_CONF_FLAG_CERTIFICATE,
611                  SSL_CONF_TYPE_DIR),
612     SSL_CONF_CMD(ChainCAFile, "chainCAfile", SSL_CONF_FLAG_CERTIFICATE,
613                  SSL_CONF_TYPE_FILE),
614     SSL_CONF_CMD(VerifyCAPath, "verifyCApath", SSL_CONF_FLAG_CERTIFICATE,
615                  SSL_CONF_TYPE_DIR),
616     SSL_CONF_CMD(VerifyCAFile, "verifyCAfile", SSL_CONF_FLAG_CERTIFICATE,
617                  SSL_CONF_TYPE_FILE),
618     SSL_CONF_CMD(ClientCAFile, NULL,
619                  SSL_CONF_FLAG_SERVER | SSL_CONF_FLAG_CERTIFICATE,
620                  SSL_CONF_TYPE_FILE),
621     SSL_CONF_CMD(ClientCAPath, NULL,
622                  SSL_CONF_FLAG_SERVER | SSL_CONF_FLAG_CERTIFICATE,
623                  SSL_CONF_TYPE_DIR),
624 #ifndef OPENSSL_NO_DH
625     SSL_CONF_CMD(DHParameters, "dhparam",
626                  SSL_CONF_FLAG_SERVER | SSL_CONF_FLAG_CERTIFICATE,
627                  SSL_CONF_TYPE_FILE)
628 #endif
629 };
630
631 /* Supported switches: must match order of switches in ssl_conf_cmds */
632 static const ssl_switch_tbl ssl_cmd_switches[] = {
633     {SSL_OP_NO_SSLv3, 0},       /* no_ssl3 */
634     {SSL_OP_NO_TLSv1, 0},       /* no_tls1 */
635     {SSL_OP_NO_TLSv1_1, 0},     /* no_tls1_1 */
636     {SSL_OP_NO_TLSv1_2, 0},     /* no_tls1_2 */
637     {SSL_OP_ALL, 0},            /* bugs */
638     {SSL_OP_NO_COMPRESSION, 0}, /* no_comp */
639     {SSL_OP_SINGLE_ECDH_USE, 0}, /* ecdh_single */
640     {SSL_OP_NO_TICKET, 0},      /* no_ticket */
641     {SSL_OP_CIPHER_SERVER_PREFERENCE, 0}, /* serverpref */
642     /* legacy_renegotiation */
643     {SSL_OP_ALLOW_UNSAFE_LEGACY_RENEGOTIATION, 0},
644     /* legacy_server_connect */
645     {SSL_OP_LEGACY_SERVER_CONNECT, 0},
646     /* no_resumption_on_reneg */
647     {SSL_OP_NO_SESSION_RESUMPTION_ON_RENEGOTIATION, 0},
648     /* no_legacy_server_connect */
649     {SSL_OP_LEGACY_SERVER_CONNECT, SSL_TFLAG_INV},
650     {SSL_CERT_FLAG_TLS_STRICT, SSL_TFLAG_CERT}, /* strict */
651 #ifdef OPENSSL_SSL_DEBUG_BROKEN_PROTOCOL
652     {SSL_CERT_FLAG_BROKEN_PROTOCOL, SSL_TFLAG_CERT} /* debug_broken_protocol */
653 #endif
654 };
655
656 static int ssl_conf_cmd_skip_prefix(SSL_CONF_CTX *cctx, const char **pcmd)
657 {
658     if (!pcmd || !*pcmd)
659         return 0;
660     /* If a prefix is set, check and skip */
661     if (cctx->prefix) {
662         if (strlen(*pcmd) <= cctx->prefixlen)
663             return 0;
664         if (cctx->flags & SSL_CONF_FLAG_CMDLINE &&
665             strncmp(*pcmd, cctx->prefix, cctx->prefixlen))
666             return 0;
667         if (cctx->flags & SSL_CONF_FLAG_FILE &&
668             strncasecmp(*pcmd, cctx->prefix, cctx->prefixlen))
669             return 0;
670         *pcmd += cctx->prefixlen;
671     } else if (cctx->flags & SSL_CONF_FLAG_CMDLINE) {
672         if (**pcmd != '-' || !(*pcmd)[1])
673             return 0;
674         *pcmd += 1;
675     }
676     return 1;
677 }
678
679 /* Determine if a command is allowed according to cctx flags */
680 static int ssl_conf_cmd_allowed(SSL_CONF_CTX *cctx,
681                                 const ssl_conf_cmd_tbl * t)
682 {
683     unsigned int tfl = t->flags;
684     unsigned int cfl = cctx->flags;
685     if ((tfl & SSL_CONF_FLAG_SERVER) && !(cfl & SSL_CONF_FLAG_SERVER))
686         return 0;
687     if ((tfl & SSL_CONF_FLAG_CLIENT) && !(cfl & SSL_CONF_FLAG_CLIENT))
688         return 0;
689     if ((tfl & SSL_CONF_FLAG_CERTIFICATE)
690         && !(cfl & SSL_CONF_FLAG_CERTIFICATE))
691         return 0;
692     return 1;
693 }
694
695 static const ssl_conf_cmd_tbl *ssl_conf_cmd_lookup(SSL_CONF_CTX *cctx,
696                                                    const char *cmd)
697 {
698     const ssl_conf_cmd_tbl *t;
699     size_t i;
700     if (cmd == NULL)
701         return NULL;
702
703     /* Look for matching parameter name in table */
704     for (i = 0, t = ssl_conf_cmds; i < OSSL_NELEM(ssl_conf_cmds); i++, t++) {
705         if (ssl_conf_cmd_allowed(cctx, t)) {
706             if (cctx->flags & SSL_CONF_FLAG_CMDLINE) {
707                 if (t->str_cmdline && strcmp(t->str_cmdline, cmd) == 0)
708                     return t;
709             }
710             if (cctx->flags & SSL_CONF_FLAG_FILE) {
711                 if (t->str_file && strcasecmp(t->str_file, cmd) == 0)
712                     return t;
713             }
714         }
715     }
716     return NULL;
717 }
718
719 static int ctrl_switch_option(SSL_CONF_CTX *cctx,
720                               const ssl_conf_cmd_tbl * cmd)
721 {
722     /* Find index of command in table */
723     size_t idx = cmd - ssl_conf_cmds;
724     const ssl_switch_tbl *scmd;
725     /* Sanity check index */
726     if (idx >= OSSL_NELEM(ssl_cmd_switches))
727         return 0;
728     /* Obtain switches entry with same index */
729     scmd = ssl_cmd_switches + idx;
730     ssl_set_option(cctx, scmd->name_flags, scmd->option_value, 1);
731     return 1;
732 }
733
734 int SSL_CONF_cmd(SSL_CONF_CTX *cctx, const char *cmd, const char *value)
735 {
736     const ssl_conf_cmd_tbl *runcmd;
737     if (cmd == NULL) {
738         SSLerr(SSL_F_SSL_CONF_CMD, SSL_R_INVALID_NULL_CMD_NAME);
739         return 0;
740     }
741
742     if (!ssl_conf_cmd_skip_prefix(cctx, &cmd))
743         return -2;
744
745     runcmd = ssl_conf_cmd_lookup(cctx, cmd);
746
747     if (runcmd) {
748         int rv;
749         if (runcmd->value_type == SSL_CONF_TYPE_NONE) {
750             return ctrl_switch_option(cctx, runcmd);
751         }
752         if (value == NULL)
753             return -3;
754         rv = runcmd->cmd(cctx, value);
755         if (rv > 0)
756             return 2;
757         if (rv == -2)
758             return -2;
759         if (cctx->flags & SSL_CONF_FLAG_SHOW_ERRORS) {
760             SSLerr(SSL_F_SSL_CONF_CMD, SSL_R_BAD_VALUE);
761             ERR_add_error_data(4, "cmd=", cmd, ", value=", value);
762         }
763         return 0;
764     }
765
766     if (cctx->flags & SSL_CONF_FLAG_SHOW_ERRORS) {
767         SSLerr(SSL_F_SSL_CONF_CMD, SSL_R_UNKNOWN_CMD_NAME);
768         ERR_add_error_data(2, "cmd=", cmd);
769     }
770
771     return -2;
772 }
773
774 int SSL_CONF_cmd_argv(SSL_CONF_CTX *cctx, int *pargc, char ***pargv)
775 {
776     int rv;
777     const char *arg = NULL, *argn;
778     if (pargc && *pargc == 0)
779         return 0;
780     if (!pargc || *pargc > 0)
781         arg = **pargv;
782     if (arg == NULL)
783         return 0;
784     if (!pargc || *pargc > 1)
785         argn = (*pargv)[1];
786     else
787         argn = NULL;
788     cctx->flags &= ~SSL_CONF_FLAG_FILE;
789     cctx->flags |= SSL_CONF_FLAG_CMDLINE;
790     rv = SSL_CONF_cmd(cctx, arg, argn);
791     if (rv > 0) {
792         /* Success: update pargc, pargv */
793         (*pargv) += rv;
794         if (pargc)
795             (*pargc) -= rv;
796         return rv;
797     }
798     /* Unknown switch: indicate no arguments processed */
799     if (rv == -2)
800         return 0;
801     /* Some error occurred processing command, return fatal error */
802     if (rv == 0)
803         return -1;
804     return rv;
805 }
806
807 int SSL_CONF_cmd_value_type(SSL_CONF_CTX *cctx, const char *cmd)
808 {
809     if (ssl_conf_cmd_skip_prefix(cctx, &cmd)) {
810         const ssl_conf_cmd_tbl *runcmd;
811         runcmd = ssl_conf_cmd_lookup(cctx, cmd);
812         if (runcmd)
813             return runcmd->value_type;
814     }
815     return SSL_CONF_TYPE_UNKNOWN;
816 }
817
818 SSL_CONF_CTX *SSL_CONF_CTX_new(void)
819 {
820     SSL_CONF_CTX *ret = OPENSSL_zalloc(sizeof(*ret));
821
822     return ret;
823 }
824
825 int SSL_CONF_CTX_finish(SSL_CONF_CTX *cctx)
826 {
827     /* See if any certificates are missing private keys */
828     size_t i;
829     CERT *c = NULL;
830     if (cctx->ctx)
831         c = cctx->ctx->cert;
832     else if (cctx->ssl)
833         c = cctx->ssl->cert;
834     if (c && cctx->flags & SSL_CONF_FLAG_REQUIRE_PRIVATE) {
835         for (i = 0; i < SSL_PKEY_NUM; i++) {
836             const char *p = cctx->cert_filename[i];
837             /*
838              * If missing private key try to load one from certificate file
839              */
840             if (p && !c->pkeys[i].privatekey) {
841                 if (!cmd_PrivateKey(cctx, p))
842                     return 0;
843             }
844         }
845     }
846     if (cctx->canames) {
847         if (cctx->ssl)
848             SSL_set_client_CA_list(cctx->ssl, cctx->canames);
849         else if (cctx->ctx)
850             SSL_CTX_set_client_CA_list(cctx->ctx, cctx->canames);
851         else
852             sk_X509_NAME_pop_free(cctx->canames, X509_NAME_free);
853         cctx->canames = NULL;
854     }
855     return 1;
856 }
857
858 void SSL_CONF_CTX_free(SSL_CONF_CTX *cctx)
859 {
860     if (cctx) {
861         size_t i;
862         for (i = 0; i < SSL_PKEY_NUM; i++)
863             OPENSSL_free(cctx->cert_filename[i]);
864         OPENSSL_free(cctx->prefix);
865         sk_X509_NAME_pop_free(cctx->canames, X509_NAME_free);
866         OPENSSL_free(cctx);
867     }
868 }
869
870 unsigned int SSL_CONF_CTX_set_flags(SSL_CONF_CTX *cctx, unsigned int flags)
871 {
872     cctx->flags |= flags;
873     return cctx->flags;
874 }
875
876 unsigned int SSL_CONF_CTX_clear_flags(SSL_CONF_CTX *cctx, unsigned int flags)
877 {
878     cctx->flags &= ~flags;
879     return cctx->flags;
880 }
881
882 int SSL_CONF_CTX_set1_prefix(SSL_CONF_CTX *cctx, const char *pre)
883 {
884     char *tmp = NULL;
885     if (pre) {
886         tmp = OPENSSL_strdup(pre);
887         if (tmp == NULL)
888             return 0;
889     }
890     OPENSSL_free(cctx->prefix);
891     cctx->prefix = tmp;
892     if (tmp)
893         cctx->prefixlen = strlen(tmp);
894     else
895         cctx->prefixlen = 0;
896     return 1;
897 }
898
899 void SSL_CONF_CTX_set_ssl(SSL_CONF_CTX *cctx, SSL *ssl)
900 {
901     cctx->ssl = ssl;
902     cctx->ctx = NULL;
903     if (ssl) {
904         cctx->poptions = &ssl->options;
905         cctx->min_version = &ssl->min_proto_version;
906         cctx->max_version = &ssl->max_proto_version;
907         cctx->pcert_flags = &ssl->cert->cert_flags;
908         cctx->pvfy_flags = &ssl->verify_mode;
909     } else {
910         cctx->poptions = NULL;
911         cctx->min_version = NULL;
912         cctx->max_version = NULL;
913         cctx->pcert_flags = NULL;
914         cctx->pvfy_flags = NULL;
915     }
916 }
917
918 void SSL_CONF_CTX_set_ssl_ctx(SSL_CONF_CTX *cctx, SSL_CTX *ctx)
919 {
920     cctx->ctx = ctx;
921     cctx->ssl = NULL;
922     if (ctx) {
923         cctx->poptions = &ctx->options;
924         cctx->min_version = &ctx->min_proto_version;
925         cctx->max_version = &ctx->max_proto_version;
926         cctx->pcert_flags = &ctx->cert->cert_flags;
927         cctx->pvfy_flags = &ctx->verify_mode;
928     } else {
929         cctx->poptions = NULL;
930         cctx->min_version = NULL;
931         cctx->max_version = NULL;
932         cctx->pcert_flags = NULL;
933         cctx->pvfy_flags = NULL;
934     }
935 }