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