Add EC key generation paragraph in doc/HOWTO/keys.txt
[openssl.git] / apps / verify.c
1 /*
2  * Copyright 1995-2017 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 <stdlib.h>
12 #include <string.h>
13 #include "apps.h"
14 #include <openssl/bio.h>
15 #include <openssl/err.h>
16 #include <openssl/x509.h>
17 #include <openssl/x509v3.h>
18 #include <openssl/pem.h>
19
20 static int cb(int ok, X509_STORE_CTX *ctx);
21 static int check(X509_STORE *ctx, const char *file,
22                  STACK_OF(X509) *uchain, STACK_OF(X509) *tchain,
23                  STACK_OF(X509_CRL) *crls, int show_chain);
24 static int v_verbose = 0, vflags = 0;
25
26 typedef enum OPTION_choice {
27     OPT_ERR = -1, OPT_EOF = 0, OPT_HELP,
28     OPT_ENGINE, OPT_CAPATH, OPT_CAFILE, OPT_NOCAPATH, OPT_NOCAFILE,
29     OPT_UNTRUSTED, OPT_TRUSTED, OPT_CRLFILE, OPT_CRL_DOWNLOAD, OPT_SHOW_CHAIN,
30     OPT_V_ENUM, OPT_NAMEOPT,
31     OPT_VERBOSE
32 } OPTION_CHOICE;
33
34 const OPTIONS verify_options[] = {
35     {OPT_HELP_STR, 1, '-', "Usage: %s [options] cert.pem...\n"},
36     {OPT_HELP_STR, 1, '-', "Valid options are:\n"},
37     {"help", OPT_HELP, '-', "Display this summary"},
38     {"verbose", OPT_VERBOSE, '-',
39         "Print extra information about the operations being performed."},
40     {"CApath", OPT_CAPATH, '/', "A directory of trusted certificates"},
41     {"CAfile", OPT_CAFILE, '<', "A file of trusted certificates"},
42     {"no-CAfile", OPT_NOCAFILE, '-',
43      "Do not load the default certificates file"},
44     {"no-CApath", OPT_NOCAPATH, '-',
45      "Do not load certificates from the default certificates directory"},
46     {"untrusted", OPT_UNTRUSTED, '<', "A file of untrusted certificates"},
47     {"trusted", OPT_TRUSTED, '<', "A file of trusted certificates"},
48     {"CRLfile", OPT_CRLFILE, '<',
49         "File containing one or more CRL's (in PEM format) to load"},
50     {"crl_download", OPT_CRL_DOWNLOAD, '-',
51         "Attempt to download CRL information for this certificate"},
52     {"show_chain", OPT_SHOW_CHAIN, '-',
53         "Display information about the certificate chain"},
54     {"nameopt", OPT_NAMEOPT, 's', "Various certificate name options"},
55     OPT_V_OPTIONS,
56 #ifndef OPENSSL_NO_ENGINE
57     {"engine", OPT_ENGINE, 's', "Use engine, possibly a hardware device"},
58 #endif
59     {NULL}
60 };
61
62 int verify_main(int argc, char **argv)
63 {
64     ENGINE *e = NULL;
65     STACK_OF(X509) *untrusted = NULL, *trusted = NULL;
66     STACK_OF(X509_CRL) *crls = NULL;
67     X509_STORE *store = NULL;
68     X509_VERIFY_PARAM *vpm = NULL;
69     const char *prog, *CApath = NULL, *CAfile = NULL;
70     int noCApath = 0, noCAfile = 0;
71     int vpmtouched = 0, crl_download = 0, show_chain = 0, i = 0, ret = 1;
72     OPTION_CHOICE o;
73
74     if ((vpm = X509_VERIFY_PARAM_new()) == NULL)
75         goto end;
76
77     prog = opt_init(argc, argv, verify_options);
78     while ((o = opt_next()) != OPT_EOF) {
79         switch (o) {
80         case OPT_EOF:
81         case OPT_ERR:
82             BIO_printf(bio_err, "%s: Use -help for summary.\n", prog);
83             goto end;
84         case OPT_HELP:
85             opt_help(verify_options);
86             BIO_printf(bio_err, "Recognized usages:\n");
87             for (i = 0; i < X509_PURPOSE_get_count(); i++) {
88                 X509_PURPOSE *ptmp;
89                 ptmp = X509_PURPOSE_get0(i);
90                 BIO_printf(bio_err, "\t%-10s\t%s\n",
91                         X509_PURPOSE_get0_sname(ptmp),
92                         X509_PURPOSE_get0_name(ptmp));
93             }
94
95             BIO_printf(bio_err, "Recognized verify names:\n");
96             for (i = 0; i < X509_VERIFY_PARAM_get_count(); i++) {
97                 const X509_VERIFY_PARAM *vptmp;
98                 vptmp = X509_VERIFY_PARAM_get0(i);
99                 BIO_printf(bio_err, "\t%-10s\n",
100                         X509_VERIFY_PARAM_get0_name(vptmp));
101             }
102             ret = 0;
103             goto end;
104         case OPT_V_CASES:
105             if (!opt_verify(o, vpm))
106                 goto end;
107             vpmtouched++;
108             break;
109         case OPT_CAPATH:
110             CApath = opt_arg();
111             break;
112         case OPT_CAFILE:
113             CAfile = opt_arg();
114             break;
115         case OPT_NOCAPATH:
116             noCApath = 1;
117             break;
118         case OPT_NOCAFILE:
119             noCAfile = 1;
120             break;
121         case OPT_UNTRUSTED:
122             /* Zero or more times */
123             if (!load_certs(opt_arg(), &untrusted, FORMAT_PEM, NULL,
124                             "untrusted certificates"))
125                 goto end;
126             break;
127         case OPT_TRUSTED:
128             /* Zero or more times */
129             noCAfile = 1;
130             noCApath = 1;
131             if (!load_certs(opt_arg(), &trusted, FORMAT_PEM, NULL,
132                             "trusted certificates"))
133                 goto end;
134             break;
135         case OPT_CRLFILE:
136             /* Zero or more times */
137             if (!load_crls(opt_arg(), &crls, FORMAT_PEM, NULL,
138                            "other CRLs"))
139                 goto end;
140             break;
141         case OPT_CRL_DOWNLOAD:
142             crl_download = 1;
143             break;
144         case OPT_ENGINE:
145             if ((e = setup_engine(opt_arg(), 0)) == NULL) {
146                 /* Failure message already displayed */
147                 goto end;
148             }
149             break;
150         case OPT_SHOW_CHAIN:
151             show_chain = 1;
152             break;
153         case OPT_NAMEOPT:
154             if (!set_nameopt(opt_arg()))
155                 goto end;
156             break;
157         case OPT_VERBOSE:
158             v_verbose = 1;
159             break;
160         }
161     }
162     argc = opt_num_rest();
163     argv = opt_rest();
164     if (trusted != NULL && (CAfile || CApath)) {
165         BIO_printf(bio_err,
166                    "%s: Cannot use -trusted with -CAfile or -CApath\n",
167                    prog);
168         goto end;
169     }
170
171     if ((store = setup_verify(CAfile, CApath, noCAfile, noCApath)) == NULL)
172         goto end;
173     X509_STORE_set_verify_cb(store, cb);
174
175     if (vpmtouched)
176         X509_STORE_set1_param(store, vpm);
177
178     ERR_clear_error();
179
180     if (crl_download)
181         store_setup_crl_download(store);
182
183     ret = 0;
184     if (argc < 1) {
185         if (check(store, NULL, untrusted, trusted, crls, show_chain) != 1)
186             ret = -1;
187     } else {
188         for (i = 0; i < argc; i++)
189             if (check(store, argv[i], untrusted, trusted, crls,
190                       show_chain) != 1)
191                 ret = -1;
192     }
193
194  end:
195     X509_VERIFY_PARAM_free(vpm);
196     X509_STORE_free(store);
197     sk_X509_pop_free(untrusted, X509_free);
198     sk_X509_pop_free(trusted, X509_free);
199     sk_X509_CRL_pop_free(crls, X509_CRL_free);
200     release_engine(e);
201     return (ret < 0 ? 2 : ret);
202 }
203
204 static int check(X509_STORE *ctx, const char *file,
205                  STACK_OF(X509) *uchain, STACK_OF(X509) *tchain,
206                  STACK_OF(X509_CRL) *crls, int show_chain)
207 {
208     X509 *x = NULL;
209     int i = 0, ret = 0;
210     X509_STORE_CTX *csc;
211     STACK_OF(X509) *chain = NULL;
212     int num_untrusted;
213
214     x = load_cert(file, FORMAT_PEM, "certificate file");
215     if (x == NULL)
216         goto end;
217
218     csc = X509_STORE_CTX_new();
219     if (csc == NULL) {
220         printf("error %s: X.509 store context allocation failed\n",
221                (file == NULL) ? "stdin" : file);
222         goto end;
223     }
224
225     X509_STORE_set_flags(ctx, vflags);
226     if (!X509_STORE_CTX_init(csc, ctx, x, uchain)) {
227         printf("error %s: X.509 store context initialization failed\n",
228                (file == NULL) ? "stdin" : file);
229         goto end;
230     }
231     if (tchain != NULL)
232         X509_STORE_CTX_set0_trusted_stack(csc, tchain);
233     if (crls != NULL)
234         X509_STORE_CTX_set0_crls(csc, crls);
235     i = X509_verify_cert(csc);
236     if (i > 0 && X509_STORE_CTX_get_error(csc) == X509_V_OK) {
237         printf("%s: OK\n", (file == NULL) ? "stdin" : file);
238         ret = 1;
239         if (show_chain) {
240             int j;
241
242             chain = X509_STORE_CTX_get1_chain(csc);
243             num_untrusted = X509_STORE_CTX_get_num_untrusted(csc);
244             printf("Chain:\n");
245             for (j = 0; j < sk_X509_num(chain); j++) {
246                 X509 *cert = sk_X509_value(chain, j);
247                 printf("depth=%d: ", j);
248                 X509_NAME_print_ex_fp(stdout,
249                                       X509_get_subject_name(cert),
250                                       0, get_nameopt());
251                 if (j < num_untrusted)
252                     printf(" (untrusted)");
253                 printf("\n");
254             }
255             sk_X509_pop_free(chain, X509_free);
256         }
257     } else {
258         printf("error %s: verification failed\n", (file == NULL) ? "stdin" : file);
259     }
260     X509_STORE_CTX_free(csc);
261
262  end:
263     if (i <= 0)
264         ERR_print_errors(bio_err);
265     X509_free(x);
266
267     return ret;
268 }
269
270 static int cb(int ok, X509_STORE_CTX *ctx)
271 {
272     int cert_error = X509_STORE_CTX_get_error(ctx);
273     X509 *current_cert = X509_STORE_CTX_get_current_cert(ctx);
274
275     if (!ok) {
276         if (current_cert != NULL) {
277             X509_NAME_print_ex(bio_err,
278                             X509_get_subject_name(current_cert),
279                             0, get_nameopt());
280             BIO_printf(bio_err, "\n");
281         }
282         BIO_printf(bio_err, "%serror %d at %d depth lookup: %s\n",
283                X509_STORE_CTX_get0_parent_ctx(ctx) ? "[CRL path] " : "",
284                cert_error,
285                X509_STORE_CTX_get_error_depth(ctx),
286                X509_verify_cert_error_string(cert_error));
287         switch (cert_error) {
288         case X509_V_ERR_NO_EXPLICIT_POLICY:
289             policies_print(ctx);
290             /* fall thru */
291         case X509_V_ERR_CERT_HAS_EXPIRED:
292
293             /*
294              * since we are just checking the certificates, it is ok if they
295              * are self signed. But we should still warn the user.
296              */
297         case X509_V_ERR_DEPTH_ZERO_SELF_SIGNED_CERT:
298             /* Continue after extension errors too */
299         case X509_V_ERR_INVALID_CA:
300         case X509_V_ERR_INVALID_NON_CA:
301         case X509_V_ERR_PATH_LENGTH_EXCEEDED:
302         case X509_V_ERR_INVALID_PURPOSE:
303         case X509_V_ERR_CRL_HAS_EXPIRED:
304         case X509_V_ERR_CRL_NOT_YET_VALID:
305         case X509_V_ERR_UNHANDLED_CRITICAL_EXTENSION:
306             ok = 1;
307         }
308
309         return ok;
310
311     }
312     if (cert_error == X509_V_OK && ok == 2)
313         policies_print(ctx);
314     if (!v_verbose)
315         ERR_clear_error();
316     return (ok);
317 }