xref: /freebsd/crypto/openssl/crypto/ts/ts_conf.c (revision e7be843b4a162e68651d3911f0357ed464915629)
1 /*
2  * Copyright 2006-2025 The OpenSSL Project Authors. All Rights Reserved.
3  *
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
8  */
9 
10 /* We need to use some engine deprecated APIs */
11 #define OPENSSL_SUPPRESS_DEPRECATED
12 
13 #include <string.h>
14 
15 #include <openssl/crypto.h>
16 #include "internal/cryptlib.h"
17 #include <openssl/pem.h>
18 #include <openssl/engine.h>
19 #include <openssl/ts.h>
20 #include <openssl/conf_api.h>
21 
22 /* Macro definitions for the configuration file. */
23 #define BASE_SECTION                    "tsa"
24 #define ENV_DEFAULT_TSA                 "default_tsa"
25 #define ENV_SERIAL                      "serial"
26 #define ENV_CRYPTO_DEVICE               "crypto_device"
27 #define ENV_SIGNER_CERT                 "signer_cert"
28 #define ENV_CERTS                       "certs"
29 #define ENV_SIGNER_KEY                  "signer_key"
30 #define ENV_SIGNER_DIGEST               "signer_digest"
31 #define ENV_DEFAULT_POLICY              "default_policy"
32 #define ENV_OTHER_POLICIES              "other_policies"
33 #define ENV_DIGESTS                     "digests"
34 #define ENV_ACCURACY                    "accuracy"
35 #define ENV_ORDERING                    "ordering"
36 #define ENV_TSA_NAME                    "tsa_name"
37 #define ENV_ESS_CERT_ID_CHAIN           "ess_cert_id_chain"
38 #define ENV_VALUE_SECS                  "secs"
39 #define ENV_VALUE_MILLISECS             "millisecs"
40 #define ENV_VALUE_MICROSECS             "microsecs"
41 #define ENV_CLOCK_PRECISION_DIGITS      "clock_precision_digits"
42 #define ENV_VALUE_YES                   "yes"
43 #define ENV_VALUE_NO                    "no"
44 #define ENV_ESS_CERT_ID_ALG             "ess_cert_id_alg"
45 
46 /* Function definitions for certificate and key loading. */
47 
TS_CONF_load_cert(const char * file)48 X509 *TS_CONF_load_cert(const char *file)
49 {
50     BIO *cert = NULL;
51     X509 *x = NULL;
52 
53 #if defined(OPENSSL_SYS_WINDOWS)
54     if ((cert = BIO_new_file(file, "rb")) == NULL)
55 #else
56     if ((cert = BIO_new_file(file, "r")) == NULL)
57 #endif
58         goto end;
59     x = PEM_read_bio_X509_AUX(cert, NULL, NULL, NULL);
60  end:
61     if (x == NULL)
62         ERR_raise(ERR_LIB_TS, TS_R_CANNOT_LOAD_CERT);
63     BIO_free(cert);
64     return x;
65 }
66 
STACK_OF(X509)67 STACK_OF(X509) *TS_CONF_load_certs(const char *file)
68 {
69     BIO *certs = NULL;
70     STACK_OF(X509) *othercerts = NULL;
71     STACK_OF(X509_INFO) *allcerts = NULL;
72     int i;
73 
74 #if defined(OPENSSL_SYS_WINDOWS)
75     if ((certs = BIO_new_file(file, "rb")) == NULL)
76 #else
77     if ((certs = BIO_new_file(file, "r")) == NULL)
78 #endif
79         goto end;
80     if ((othercerts = sk_X509_new_null()) == NULL)
81         goto end;
82 
83     allcerts = PEM_X509_INFO_read_bio(certs, NULL, NULL, NULL);
84     for (i = 0; i < sk_X509_INFO_num(allcerts); i++) {
85         X509_INFO *xi = sk_X509_INFO_value(allcerts, i);
86 
87         if (xi->x509 != NULL) {
88             if (!X509_add_cert(othercerts, xi->x509, X509_ADD_FLAG_DEFAULT)) {
89                 OSSL_STACK_OF_X509_free(othercerts);
90                 othercerts = NULL;
91                 goto end;
92             }
93             xi->x509 = NULL;
94         }
95     }
96  end:
97     if (othercerts == NULL)
98         ERR_raise(ERR_LIB_TS, TS_R_CANNOT_LOAD_CERT);
99     sk_X509_INFO_pop_free(allcerts, X509_INFO_free);
100     BIO_free(certs);
101     return othercerts;
102 }
103 
TS_CONF_load_key(const char * file,const char * pass)104 EVP_PKEY *TS_CONF_load_key(const char *file, const char *pass)
105 {
106     BIO *key = NULL;
107     EVP_PKEY *pkey = NULL;
108 
109 #if defined(OPENSSL_SYS_WINDOWS)
110     if ((key = BIO_new_file(file, "rb")) == NULL)
111 #else
112     if ((key = BIO_new_file(file, "r")) == NULL)
113 #endif
114         goto end;
115     pkey = PEM_read_bio_PrivateKey(key, NULL, NULL, (char *)pass);
116  end:
117     if (pkey == NULL)
118         ERR_raise(ERR_LIB_TS, TS_R_CANNOT_LOAD_KEY);
119     BIO_free(key);
120     return pkey;
121 }
122 
123 /* Function definitions for handling configuration options. */
124 
ts_CONF_lookup_fail(const char * name,const char * tag)125 static void ts_CONF_lookup_fail(const char *name, const char *tag)
126 {
127     ERR_raise_data(ERR_LIB_TS, TS_R_VAR_LOOKUP_FAILURE, "%s::%s", name, tag);
128 }
129 
ts_CONF_invalid(const char * name,const char * tag)130 static void ts_CONF_invalid(const char *name, const char *tag)
131 {
132     ERR_raise_data(ERR_LIB_TS, TS_R_VAR_BAD_VALUE, "%s::%s", name, tag);
133 }
134 
TS_CONF_get_tsa_section(CONF * conf,const char * section)135 const char *TS_CONF_get_tsa_section(CONF *conf, const char *section)
136 {
137     if (!section) {
138         section = NCONF_get_string(conf, BASE_SECTION, ENV_DEFAULT_TSA);
139         if (!section)
140             ts_CONF_lookup_fail(BASE_SECTION, ENV_DEFAULT_TSA);
141     }
142     return section;
143 }
144 
TS_CONF_set_serial(CONF * conf,const char * section,TS_serial_cb cb,TS_RESP_CTX * ctx)145 int TS_CONF_set_serial(CONF *conf, const char *section, TS_serial_cb cb,
146                        TS_RESP_CTX *ctx)
147 {
148     int ret = 0;
149     char *serial = NCONF_get_string(conf, section, ENV_SERIAL);
150     if (!serial) {
151         ts_CONF_lookup_fail(section, ENV_SERIAL);
152         goto err;
153     }
154     TS_RESP_CTX_set_serial_cb(ctx, cb, serial);
155 
156     ret = 1;
157  err:
158     return ret;
159 }
160 
161 #ifndef OPENSSL_NO_ENGINE
162 
TS_CONF_set_crypto_device(CONF * conf,const char * section,const char * device)163 int TS_CONF_set_crypto_device(CONF *conf, const char *section,
164                               const char *device)
165 {
166     int ret = 0;
167 
168     if (device == NULL)
169         device = NCONF_get_string(conf, section, ENV_CRYPTO_DEVICE);
170 
171     if (device && !TS_CONF_set_default_engine(device)) {
172         ts_CONF_invalid(section, ENV_CRYPTO_DEVICE);
173         goto err;
174     }
175     ret = 1;
176  err:
177     return ret;
178 }
179 
TS_CONF_set_default_engine(const char * name)180 int TS_CONF_set_default_engine(const char *name)
181 {
182     ENGINE *e = NULL;
183     int ret = 0;
184 
185     if (strcmp(name, "builtin") == 0)
186         return 1;
187 
188     if ((e = ENGINE_by_id(name)) == NULL)
189         goto err;
190     if (strcmp(name, "chil") == 0)
191         ENGINE_ctrl(e, ENGINE_CTRL_CHIL_SET_FORKCHECK, 1, 0, 0);
192     if (!ENGINE_set_default(e, ENGINE_METHOD_ALL))
193         goto err;
194     ret = 1;
195 
196  err:
197     if (!ret)
198         ERR_raise_data(ERR_LIB_TS, TS_R_COULD_NOT_SET_ENGINE,
199                        "engine:%s", name);
200     ENGINE_free(e);
201     return ret;
202 }
203 
204 #endif
205 
TS_CONF_set_signer_cert(CONF * conf,const char * section,const char * cert,TS_RESP_CTX * ctx)206 int TS_CONF_set_signer_cert(CONF *conf, const char *section,
207                             const char *cert, TS_RESP_CTX *ctx)
208 {
209     int ret = 0;
210     X509 *cert_obj = NULL;
211 
212     if (cert == NULL) {
213         cert = NCONF_get_string(conf, section, ENV_SIGNER_CERT);
214         if (cert == NULL) {
215             ts_CONF_lookup_fail(section, ENV_SIGNER_CERT);
216             goto err;
217         }
218     }
219     if ((cert_obj = TS_CONF_load_cert(cert)) == NULL)
220         goto err;
221     if (!TS_RESP_CTX_set_signer_cert(ctx, cert_obj))
222         goto err;
223 
224     ret = 1;
225  err:
226     X509_free(cert_obj);
227     return ret;
228 }
229 
TS_CONF_set_certs(CONF * conf,const char * section,const char * certs,TS_RESP_CTX * ctx)230 int TS_CONF_set_certs(CONF *conf, const char *section, const char *certs,
231                       TS_RESP_CTX *ctx)
232 {
233     int ret = 0;
234     STACK_OF(X509) *certs_obj = NULL;
235 
236     if (certs == NULL) {
237         /* Certificate chain is optional. */
238         if ((certs = NCONF_get_string(conf, section, ENV_CERTS)) == NULL)
239             goto end;
240     }
241     if ((certs_obj = TS_CONF_load_certs(certs)) == NULL)
242         goto err;
243     if (!TS_RESP_CTX_set_certs(ctx, certs_obj))
244         goto err;
245  end:
246     ret = 1;
247  err:
248     OSSL_STACK_OF_X509_free(certs_obj);
249     return ret;
250 }
251 
TS_CONF_set_signer_key(CONF * conf,const char * section,const char * key,const char * pass,TS_RESP_CTX * ctx)252 int TS_CONF_set_signer_key(CONF *conf, const char *section,
253                            const char *key, const char *pass,
254                            TS_RESP_CTX *ctx)
255 {
256     int ret = 0;
257     EVP_PKEY *key_obj = NULL;
258     if (!key)
259         key = NCONF_get_string(conf, section, ENV_SIGNER_KEY);
260     if (!key) {
261         ts_CONF_lookup_fail(section, ENV_SIGNER_KEY);
262         goto err;
263     }
264     if ((key_obj = TS_CONF_load_key(key, pass)) == NULL)
265         goto err;
266     if (!TS_RESP_CTX_set_signer_key(ctx, key_obj))
267         goto err;
268 
269     ret = 1;
270  err:
271     EVP_PKEY_free(key_obj);
272     return ret;
273 }
274 
TS_CONF_set_signer_digest(CONF * conf,const char * section,const char * md,TS_RESP_CTX * ctx)275 int TS_CONF_set_signer_digest(CONF *conf, const char *section,
276                               const char *md, TS_RESP_CTX *ctx)
277 {
278     int ret = 0;
279     const EVP_MD *sign_md = NULL;
280     if (md == NULL)
281         md = NCONF_get_string(conf, section, ENV_SIGNER_DIGEST);
282     if (md == NULL) {
283         ts_CONF_lookup_fail(section, ENV_SIGNER_DIGEST);
284         goto err;
285     }
286     sign_md = EVP_get_digestbyname(md);
287     if (sign_md == NULL) {
288         ts_CONF_invalid(section, ENV_SIGNER_DIGEST);
289         goto err;
290     }
291     if (!TS_RESP_CTX_set_signer_digest(ctx, sign_md))
292         goto err;
293 
294     ret = 1;
295  err:
296     return ret;
297 }
298 
TS_CONF_set_def_policy(CONF * conf,const char * section,const char * policy,TS_RESP_CTX * ctx)299 int TS_CONF_set_def_policy(CONF *conf, const char *section,
300                            const char *policy, TS_RESP_CTX *ctx)
301 {
302     int ret = 0;
303     ASN1_OBJECT *policy_obj = NULL;
304 
305     if (policy == NULL)
306         policy = NCONF_get_string(conf, section, ENV_DEFAULT_POLICY);
307     if (policy == NULL) {
308         ts_CONF_lookup_fail(section, ENV_DEFAULT_POLICY);
309         goto err;
310     }
311     if ((policy_obj = OBJ_txt2obj(policy, 0)) == NULL) {
312         ts_CONF_invalid(section, ENV_DEFAULT_POLICY);
313         goto err;
314     }
315     if (!TS_RESP_CTX_set_def_policy(ctx, policy_obj))
316         goto err;
317 
318     ret = 1;
319  err:
320     ASN1_OBJECT_free(policy_obj);
321     return ret;
322 }
323 
TS_CONF_set_policies(CONF * conf,const char * section,TS_RESP_CTX * ctx)324 int TS_CONF_set_policies(CONF *conf, const char *section, TS_RESP_CTX *ctx)
325 {
326     int ret = 0;
327     int i;
328     STACK_OF(CONF_VALUE) *list = NULL;
329     char *policies = NCONF_get_string(conf, section, ENV_OTHER_POLICIES);
330 
331     /* If no other policy is specified, that's fine. */
332     if (policies && (list = X509V3_parse_list(policies)) == NULL) {
333         ts_CONF_invalid(section, ENV_OTHER_POLICIES);
334         goto err;
335     }
336     for (i = 0; i < sk_CONF_VALUE_num(list); ++i) {
337         CONF_VALUE *val = sk_CONF_VALUE_value(list, i);
338         const char *extval = val->value ? val->value : val->name;
339         ASN1_OBJECT *objtmp;
340 
341         if ((objtmp = OBJ_txt2obj(extval, 0)) == NULL) {
342             ts_CONF_invalid(section, ENV_OTHER_POLICIES);
343             goto err;
344         }
345         if (!TS_RESP_CTX_add_policy(ctx, objtmp))
346             goto err;
347         ASN1_OBJECT_free(objtmp);
348     }
349 
350     ret = 1;
351  err:
352     sk_CONF_VALUE_pop_free(list, X509V3_conf_free);
353     return ret;
354 }
355 
TS_CONF_set_digests(CONF * conf,const char * section,TS_RESP_CTX * ctx)356 int TS_CONF_set_digests(CONF *conf, const char *section, TS_RESP_CTX *ctx)
357 {
358     int ret = 0;
359     int i;
360     STACK_OF(CONF_VALUE) *list = NULL;
361     char *digests = NCONF_get_string(conf, section, ENV_DIGESTS);
362 
363     if (digests == NULL) {
364         ts_CONF_lookup_fail(section, ENV_DIGESTS);
365         goto err;
366     }
367     if ((list = X509V3_parse_list(digests)) == NULL) {
368         ts_CONF_invalid(section, ENV_DIGESTS);
369         goto err;
370     }
371     if (sk_CONF_VALUE_num(list) == 0) {
372         ts_CONF_invalid(section, ENV_DIGESTS);
373         goto err;
374     }
375     for (i = 0; i < sk_CONF_VALUE_num(list); ++i) {
376         CONF_VALUE *val = sk_CONF_VALUE_value(list, i);
377         const char *extval = val->value ? val->value : val->name;
378         const EVP_MD *md;
379 
380         if ((md = EVP_get_digestbyname(extval)) == NULL) {
381             ts_CONF_invalid(section, ENV_DIGESTS);
382             goto err;
383         }
384         if (!TS_RESP_CTX_add_md(ctx, md))
385             goto err;
386     }
387 
388     ret = 1;
389  err:
390     sk_CONF_VALUE_pop_free(list, X509V3_conf_free);
391     return ret;
392 }
393 
TS_CONF_set_accuracy(CONF * conf,const char * section,TS_RESP_CTX * ctx)394 int TS_CONF_set_accuracy(CONF *conf, const char *section, TS_RESP_CTX *ctx)
395 {
396     int ret = 0;
397     int i;
398     int secs = 0, millis = 0, micros = 0;
399     STACK_OF(CONF_VALUE) *list = NULL;
400     char *accuracy = NCONF_get_string(conf, section, ENV_ACCURACY);
401 
402     if (accuracy && (list = X509V3_parse_list(accuracy)) == NULL) {
403         ts_CONF_invalid(section, ENV_ACCURACY);
404         goto err;
405     }
406     for (i = 0; i < sk_CONF_VALUE_num(list); ++i) {
407         CONF_VALUE *val = sk_CONF_VALUE_value(list, i);
408         if (strcmp(val->name, ENV_VALUE_SECS) == 0) {
409             if (val->value)
410                 secs = atoi(val->value);
411         } else if (strcmp(val->name, ENV_VALUE_MILLISECS) == 0) {
412             if (val->value)
413                 millis = atoi(val->value);
414         } else if (strcmp(val->name, ENV_VALUE_MICROSECS) == 0) {
415             if (val->value)
416                 micros = atoi(val->value);
417         } else {
418             ts_CONF_invalid(section, ENV_ACCURACY);
419             goto err;
420         }
421     }
422     if (!TS_RESP_CTX_set_accuracy(ctx, secs, millis, micros))
423         goto err;
424 
425     ret = 1;
426  err:
427     sk_CONF_VALUE_pop_free(list, X509V3_conf_free);
428     return ret;
429 }
430 
TS_CONF_set_clock_precision_digits(const CONF * conf,const char * section,TS_RESP_CTX * ctx)431 int TS_CONF_set_clock_precision_digits(const CONF *conf, const char *section,
432                                        TS_RESP_CTX *ctx)
433 {
434     int ret = 0;
435     long digits = 0;
436 
437     /*
438      * If not specified, set the default value to 0, i.e. sec precision
439      */
440     digits = _CONF_get_number(conf, section, ENV_CLOCK_PRECISION_DIGITS);
441     if (digits < 0 || digits > TS_MAX_CLOCK_PRECISION_DIGITS) {
442         ts_CONF_invalid(section, ENV_CLOCK_PRECISION_DIGITS);
443         goto err;
444     }
445 
446     if (!TS_RESP_CTX_set_clock_precision_digits(ctx, digits))
447         goto err;
448 
449     return 1;
450  err:
451     return ret;
452 }
453 
ts_CONF_add_flag(CONF * conf,const char * section,const char * field,int flag,TS_RESP_CTX * ctx)454 static int ts_CONF_add_flag(CONF *conf, const char *section,
455                             const char *field, int flag, TS_RESP_CTX *ctx)
456 {
457     const char *value = NCONF_get_string(conf, section, field);
458 
459     if (value) {
460         if (strcmp(value, ENV_VALUE_YES) == 0)
461             TS_RESP_CTX_add_flags(ctx, flag);
462         else if (strcmp(value, ENV_VALUE_NO) != 0) {
463             ts_CONF_invalid(section, field);
464             return 0;
465         }
466     }
467 
468     return 1;
469 }
470 
TS_CONF_set_ordering(CONF * conf,const char * section,TS_RESP_CTX * ctx)471 int TS_CONF_set_ordering(CONF *conf, const char *section, TS_RESP_CTX *ctx)
472 {
473     return ts_CONF_add_flag(conf, section, ENV_ORDERING, TS_ORDERING, ctx);
474 }
475 
TS_CONF_set_tsa_name(CONF * conf,const char * section,TS_RESP_CTX * ctx)476 int TS_CONF_set_tsa_name(CONF *conf, const char *section, TS_RESP_CTX *ctx)
477 {
478     return ts_CONF_add_flag(conf, section, ENV_TSA_NAME, TS_TSA_NAME, ctx);
479 }
480 
TS_CONF_set_ess_cert_id_chain(CONF * conf,const char * section,TS_RESP_CTX * ctx)481 int TS_CONF_set_ess_cert_id_chain(CONF *conf, const char *section,
482                                   TS_RESP_CTX *ctx)
483 {
484     return ts_CONF_add_flag(conf, section, ENV_ESS_CERT_ID_CHAIN,
485                             TS_ESS_CERT_ID_CHAIN, ctx);
486 }
487 
TS_CONF_set_ess_cert_id_digest(CONF * conf,const char * section,TS_RESP_CTX * ctx)488 int TS_CONF_set_ess_cert_id_digest(CONF *conf, const char *section,
489                                    TS_RESP_CTX *ctx)
490 {
491     int ret = 0;
492     const EVP_MD *cert_md = NULL;
493     const char *md = NCONF_get_string(conf, section, ENV_ESS_CERT_ID_ALG);
494 
495     if (md == NULL)
496         md = "sha256";
497 
498     cert_md = EVP_get_digestbyname(md);
499     if (cert_md == NULL) {
500         ts_CONF_invalid(section, ENV_ESS_CERT_ID_ALG);
501         goto err;
502     }
503 
504     if (!TS_RESP_CTX_set_ess_cert_id_digest(ctx, cert_md))
505         goto err;
506 
507     ret = 1;
508 err:
509     return ret;
510 }
511