xref: /openssl/apps/genpkey.c (revision b6461792)
1 /*
2  * Copyright 2006-2024 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 #include <stdio.h>
11 #include <string.h>
12 #include "apps.h"
13 #include "progs.h"
14 #include <openssl/pem.h>
15 #include <openssl/err.h>
16 #include <openssl/evp.h>
17 
18 static int verbose = 1;
19 
20 static int init_keygen_file(EVP_PKEY_CTX **pctx, const char *file, ENGINE *e,
21                             OSSL_LIB_CTX *libctx, const char *propq);
22 typedef enum OPTION_choice {
23     OPT_COMMON,
24     OPT_ENGINE, OPT_OUTFORM, OPT_OUT, OPT_PASS, OPT_PARAMFILE,
25     OPT_ALGORITHM, OPT_PKEYOPT, OPT_GENPARAM, OPT_TEXT, OPT_CIPHER,
26     OPT_VERBOSE, OPT_QUIET, OPT_CONFIG, OPT_OUTPUBKEY,
27     OPT_PROV_ENUM, OPT_R_ENUM
28 } OPTION_CHOICE;
29 
30 const OPTIONS genpkey_options[] = {
31     OPT_SECTION("General"),
32     {"help", OPT_HELP, '-', "Display this summary"},
33 #ifndef OPENSSL_NO_ENGINE
34     {"engine", OPT_ENGINE, 's', "Use engine, possibly a hardware device"},
35 #endif
36     {"paramfile", OPT_PARAMFILE, '<', "Parameters file"},
37     {"algorithm", OPT_ALGORITHM, 's', "The public key algorithm"},
38     {"verbose", OPT_VERBOSE, '-', "Output status while generating keys"},
39     {"quiet", OPT_QUIET, '-', "Do not output status while generating keys"},
40     {"pkeyopt", OPT_PKEYOPT, 's',
41      "Set the public key algorithm option as opt:value"},
42      OPT_CONFIG_OPTION,
43 
44     OPT_SECTION("Output"),
45     {"out", OPT_OUT, '>', "Output (private key) file"},
46     {"outpubkey", OPT_OUTPUBKEY, '>', "Output public key file"},
47     {"outform", OPT_OUTFORM, 'F', "output format (DER or PEM)"},
48     {"pass", OPT_PASS, 's', "Output file pass phrase source"},
49     {"genparam", OPT_GENPARAM, '-', "Generate parameters, not key"},
50     {"text", OPT_TEXT, '-', "Print the private key in text"},
51     {"", OPT_CIPHER, '-', "Cipher to use to encrypt the key"},
52 
53     OPT_PROV_OPTIONS,
54     OPT_R_OPTIONS,
55 
56     /* This is deliberately last. */
57     {OPT_HELP_STR, 1, 1,
58      "Order of options may be important!  See the documentation.\n"},
59     {NULL}
60 };
61 
param_datatype_2name(unsigned int type,int * ishex)62 static const char *param_datatype_2name(unsigned int type, int *ishex)
63 {
64     *ishex = 0;
65 
66     switch (type) {
67     case OSSL_PARAM_INTEGER: return "int";
68     case OSSL_PARAM_UNSIGNED_INTEGER: return "uint";
69     case OSSL_PARAM_REAL: return "float";
70     case OSSL_PARAM_OCTET_STRING: *ishex = 1; return "string";
71     case OSSL_PARAM_UTF8_STRING: return "string";
72     default:
73         return NULL;
74     }
75 }
76 
show_gen_pkeyopt(const char * algname,OSSL_LIB_CTX * libctx,const char * propq)77 static void show_gen_pkeyopt(const char *algname, OSSL_LIB_CTX *libctx, const char *propq)
78 {
79     EVP_PKEY_CTX *ctx = NULL;
80     const OSSL_PARAM *params;
81     int i, ishex = 0;
82 
83     if (algname == NULL)
84         return;
85     ctx = EVP_PKEY_CTX_new_from_name(libctx, algname, propq);
86     if (ctx == NULL)
87         return;
88 
89     if (EVP_PKEY_keygen_init(ctx) <= 0)
90         goto cleanup;
91     params = EVP_PKEY_CTX_settable_params(ctx);
92     if (params == NULL)
93         goto cleanup;
94 
95     BIO_printf(bio_err, "\nThe possible -pkeyopt arguments are:\n");
96     for (i = 0; params[i].key != NULL; ++i) {
97         const char *name = param_datatype_2name(params[i].data_type, &ishex);
98 
99         if (name != NULL)
100             BIO_printf(bio_err, "    %s%s:%s\n", ishex ? "hex" : "", params[i].key, name);
101     }
102 cleanup:
103     EVP_PKEY_CTX_free(ctx);
104 }
105 
genpkey_main(int argc,char ** argv)106 int genpkey_main(int argc, char **argv)
107 {
108     CONF *conf = NULL;
109     BIO *in = NULL, *out = NULL, *outpubkey = NULL;
110     ENGINE *e = NULL;
111     EVP_PKEY *pkey = NULL;
112     EVP_PKEY_CTX *ctx = NULL;
113     char *outfile = NULL, *passarg = NULL, *pass = NULL, *prog, *p;
114     char *outpubkeyfile = NULL;
115     const char *ciphername = NULL, *paramfile = NULL, *algname = NULL;
116     EVP_CIPHER *cipher = NULL;
117     OPTION_CHOICE o;
118     int outformat = FORMAT_PEM, text = 0, ret = 1, rv, do_param = 0;
119     int private = 0, i;
120     OSSL_LIB_CTX *libctx = app_get0_libctx();
121     STACK_OF(OPENSSL_STRING) *keyopt = NULL;
122 
123     opt_set_unknown_name("cipher");
124     prog = opt_init(argc, argv, genpkey_options);
125     keyopt = sk_OPENSSL_STRING_new_null();
126     if (keyopt == NULL)
127         goto end;
128     while ((o = opt_next()) != OPT_EOF) {
129         switch (o) {
130         case OPT_EOF:
131         case OPT_ERR:
132  opthelp:
133             BIO_printf(bio_err, "%s: Use -help for summary.\n", prog);
134             goto end;
135         case OPT_HELP:
136             ret = 0;
137             opt_help(genpkey_options);
138             show_gen_pkeyopt(algname, libctx, app_get0_propq());
139             goto end;
140         case OPT_OUTFORM:
141             if (!opt_format(opt_arg(), OPT_FMT_PEMDER, &outformat))
142                 goto opthelp;
143             break;
144         case OPT_OUT:
145             outfile = opt_arg();
146             break;
147         case OPT_OUTPUBKEY:
148             outpubkeyfile = opt_arg();
149             break;
150         case OPT_PASS:
151             passarg = opt_arg();
152             break;
153         case OPT_ENGINE:
154             e = setup_engine(opt_arg(), 0);
155             break;
156         case OPT_PARAMFILE:
157             if (do_param == 1)
158                 goto opthelp;
159             paramfile = opt_arg();
160             break;
161         case OPT_ALGORITHM:
162             algname = opt_arg();
163             break;
164         case OPT_PKEYOPT:
165             if (!sk_OPENSSL_STRING_push(keyopt, opt_arg()))
166                 goto end;
167             break;
168         case OPT_QUIET:
169             verbose = 0;
170             break;
171         case OPT_VERBOSE:
172             verbose = 1;
173             break;
174         case OPT_GENPARAM:
175             do_param = 1;
176             break;
177         case OPT_TEXT:
178             text = 1;
179             break;
180         case OPT_CIPHER:
181             ciphername = opt_unknown();
182             break;
183         case OPT_CONFIG:
184             conf = app_load_config_modules(opt_arg());
185             if (conf == NULL)
186                 goto end;
187             break;
188         case OPT_PROV_CASES:
189             if (!opt_provider(o))
190                 goto end;
191             break;
192         case OPT_R_CASES:
193             if (!opt_rand(o))
194                 goto end;
195             break;
196         }
197     }
198 
199     /* No extra arguments. */
200     if (!opt_check_rest_arg(NULL))
201         goto opthelp;
202 
203     if (!app_RAND_load())
204         goto end;
205 
206     /* Fetch cipher, etc. */
207     if (paramfile != NULL) {
208         if (!init_keygen_file(&ctx, paramfile, e, libctx, app_get0_propq()))
209             goto end;
210     }
211     if (algname != NULL) {
212         if (!init_gen_str(&ctx, algname, e, do_param, libctx, app_get0_propq()))
213             goto end;
214     }
215     if (ctx == NULL)
216         goto opthelp;
217 
218     for (i = 0; i < sk_OPENSSL_STRING_num(keyopt); i++) {
219         p = sk_OPENSSL_STRING_value(keyopt, i);
220         if (pkey_ctrl_string(ctx, p) <= 0) {
221             BIO_printf(bio_err, "%s: Error setting %s parameter:\n", prog, p);
222             ERR_print_errors(bio_err);
223             goto end;
224         }
225     }
226     if (!opt_cipher(ciphername, &cipher))
227         goto opthelp;
228     if (ciphername != NULL && do_param == 1) {
229         BIO_printf(bio_err, "Cannot use cipher with -genparam option\n");
230         goto opthelp;
231     }
232 
233     private = do_param ? 0 : 1;
234 
235     if (!app_passwd(passarg, NULL, &pass, NULL)) {
236         BIO_puts(bio_err, "Error getting password\n");
237         goto end;
238     }
239 
240     out = bio_open_owner(outfile, outformat, private);
241     if (out == NULL)
242         goto end;
243 
244     if (outpubkeyfile != NULL) {
245         outpubkey = bio_open_owner(outpubkeyfile, outformat, private);
246         if (outpubkey == NULL)
247             goto end;
248     }
249 
250     if (verbose)
251         EVP_PKEY_CTX_set_cb(ctx, progress_cb);
252     EVP_PKEY_CTX_set_app_data(ctx, bio_err);
253 
254     pkey = do_param ? app_paramgen(ctx, algname)
255                     : app_keygen(ctx, algname, 0, 0 /* not verbose */);
256     if (pkey == NULL)
257         goto end;
258 
259     if (do_param) {
260         rv = PEM_write_bio_Parameters(out, pkey);
261     } else if (outformat == FORMAT_PEM) {
262         assert(private);
263         rv = PEM_write_bio_PrivateKey(out, pkey, cipher, NULL, 0, NULL, pass);
264         if (rv > 0 && outpubkey != NULL)
265            rv = PEM_write_bio_PUBKEY(outpubkey, pkey);
266     } else if (outformat == FORMAT_ASN1) {
267         assert(private);
268         rv = i2d_PrivateKey_bio(out, pkey);
269         if (rv > 0 && outpubkey != NULL)
270            rv = i2d_PUBKEY_bio(outpubkey, pkey);
271     } else {
272         BIO_printf(bio_err, "Bad format specified for key\n");
273         goto end;
274     }
275 
276     ret = 0;
277 
278     if (rv <= 0) {
279         BIO_puts(bio_err, "Error writing key(s)\n");
280         ret = 1;
281     }
282 
283     if (text) {
284         if (do_param)
285             rv = EVP_PKEY_print_params(out, pkey, 0, NULL);
286         else
287             rv = EVP_PKEY_print_private(out, pkey, 0, NULL);
288 
289         if (rv <= 0) {
290             BIO_puts(bio_err, "Error printing key\n");
291             ret = 1;
292         }
293     }
294 
295  end:
296     sk_OPENSSL_STRING_free(keyopt);
297     if (ret != 0)
298         ERR_print_errors(bio_err);
299     EVP_PKEY_free(pkey);
300     EVP_PKEY_CTX_free(ctx);
301     EVP_CIPHER_free(cipher);
302     BIO_free_all(out);
303     BIO_free_all(outpubkey);
304     BIO_free(in);
305     release_engine(e);
306     OPENSSL_free(pass);
307     NCONF_free(conf);
308     return ret;
309 }
310 
init_keygen_file(EVP_PKEY_CTX ** pctx,const char * file,ENGINE * e,OSSL_LIB_CTX * libctx,const char * propq)311 static int init_keygen_file(EVP_PKEY_CTX **pctx, const char *file, ENGINE *e,
312                             OSSL_LIB_CTX *libctx, const char *propq)
313 {
314     BIO *pbio;
315     EVP_PKEY *pkey = NULL;
316     EVP_PKEY_CTX *ctx = NULL;
317     if (*pctx) {
318         BIO_puts(bio_err, "Parameters already set!\n");
319         return 0;
320     }
321 
322     pbio = BIO_new_file(file, "r");
323     if (pbio == NULL) {
324         BIO_printf(bio_err, "Can't open parameter file %s\n", file);
325         return 0;
326     }
327 
328     pkey = PEM_read_bio_Parameters_ex(pbio, NULL, libctx, propq);
329     BIO_free(pbio);
330 
331     if (pkey == NULL) {
332         BIO_printf(bio_err, "Error reading parameter file %s\n", file);
333         return 0;
334     }
335 
336     if (e != NULL)
337         ctx = EVP_PKEY_CTX_new(pkey, e);
338     else
339         ctx = EVP_PKEY_CTX_new_from_pkey(libctx, pkey, propq);
340     if (ctx == NULL)
341         goto err;
342     if (EVP_PKEY_keygen_init(ctx) <= 0)
343         goto err;
344     EVP_PKEY_free(pkey);
345     *pctx = ctx;
346     return 1;
347 
348  err:
349     BIO_puts(bio_err, "Error initializing context\n");
350     ERR_print_errors(bio_err);
351     EVP_PKEY_CTX_free(ctx);
352     EVP_PKEY_free(pkey);
353     return 0;
354 
355 }
356 
init_gen_str(EVP_PKEY_CTX ** pctx,const char * algname,ENGINE * e,int do_param,OSSL_LIB_CTX * libctx,const char * propq)357 int init_gen_str(EVP_PKEY_CTX **pctx,
358                  const char *algname, ENGINE *e, int do_param,
359                  OSSL_LIB_CTX *libctx, const char *propq)
360 {
361     EVP_PKEY_CTX *ctx = NULL;
362     int pkey_id;
363 
364     if (*pctx) {
365         BIO_puts(bio_err, "Algorithm already set!\n");
366         return 0;
367     }
368 
369     pkey_id = get_legacy_pkey_id(libctx, algname, e);
370     if (pkey_id != NID_undef)
371         ctx = EVP_PKEY_CTX_new_id(pkey_id, e);
372     else
373         ctx = EVP_PKEY_CTX_new_from_name(libctx, algname, propq);
374 
375     if (ctx == NULL)
376         goto err;
377     if (do_param) {
378         if (EVP_PKEY_paramgen_init(ctx) <= 0)
379             goto err;
380     } else {
381         if (EVP_PKEY_keygen_init(ctx) <= 0)
382             goto err;
383     }
384 
385     *pctx = ctx;
386     return 1;
387 
388  err:
389     BIO_printf(bio_err, "Error initializing %s context\n", algname);
390     ERR_print_errors(bio_err);
391     EVP_PKEY_CTX_free(ctx);
392     return 0;
393 
394 }
395 
396