1 /* 2 * Copyright 1995-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 <stdlib.h> 13 #include "apps.h" 14 #include "progs.h" 15 #include <openssl/bio.h> 16 #include <openssl/err.h> 17 #include <openssl/evp.h> 18 #include <openssl/objects.h> 19 #include <openssl/x509.h> 20 #include <openssl/pem.h> 21 #include <openssl/hmac.h> 22 #include <ctype.h> 23 24 #undef BUFSIZE 25 #define BUFSIZE 1024*8 26 27 int do_fp(BIO *out, unsigned char *buf, BIO *bp, int sep, int binout, int xoflen, 28 EVP_PKEY *key, unsigned char *sigin, int siglen, 29 const char *sig_name, const char *md_name, 30 const char *file); 31 static void show_digests(const OBJ_NAME *name, void *bio_); 32 33 struct doall_dgst_digests { 34 BIO *bio; 35 int n; 36 }; 37 38 typedef enum OPTION_choice { 39 OPT_COMMON, 40 OPT_LIST, 41 OPT_C, OPT_R, OPT_OUT, OPT_SIGN, OPT_PASSIN, OPT_VERIFY, 42 OPT_PRVERIFY, OPT_SIGNATURE, OPT_KEYFORM, OPT_ENGINE, OPT_ENGINE_IMPL, 43 OPT_HEX, OPT_BINARY, OPT_DEBUG, OPT_FIPS_FINGERPRINT, 44 OPT_HMAC, OPT_MAC, OPT_SIGOPT, OPT_MACOPT, OPT_XOFLEN, 45 OPT_DIGEST, 46 OPT_R_ENUM, OPT_PROV_ENUM 47 } OPTION_CHOICE; 48 49 const OPTIONS dgst_options[] = { 50 {OPT_HELP_STR, 1, '-', "Usage: %s [options] [file...]\n"}, 51 52 OPT_SECTION("General"), 53 {"help", OPT_HELP, '-', "Display this summary"}, 54 {"list", OPT_LIST, '-', "List digests"}, 55 #ifndef OPENSSL_NO_ENGINE 56 {"engine", OPT_ENGINE, 's', "Use engine e, possibly a hardware device"}, 57 {"engine_impl", OPT_ENGINE_IMPL, '-', 58 "Also use engine given by -engine for digest operations"}, 59 #endif 60 {"passin", OPT_PASSIN, 's', "Input file pass phrase source"}, 61 62 OPT_SECTION("Output"), 63 {"c", OPT_C, '-', "Print the digest with separating colons"}, 64 {"r", OPT_R, '-', "Print the digest in coreutils format"}, 65 {"out", OPT_OUT, '>', "Output to filename rather than stdout"}, 66 {"keyform", OPT_KEYFORM, 'f', "Key file format (ENGINE, other values ignored)"}, 67 {"hex", OPT_HEX, '-', "Print as hex dump"}, 68 {"binary", OPT_BINARY, '-', "Print in binary form"}, 69 {"xoflen", OPT_XOFLEN, 'p', "Output length for XOF algorithms. To obtain the maximum security strength set this to 32 (or greater) for SHAKE128, and 64 (or greater) for SHAKE256"}, 70 {"d", OPT_DEBUG, '-', "Print debug info"}, 71 {"debug", OPT_DEBUG, '-', "Print debug info"}, 72 73 OPT_SECTION("Signing"), 74 {"sign", OPT_SIGN, 's', "Sign digest using private key"}, 75 {"verify", OPT_VERIFY, 's', "Verify a signature using public key"}, 76 {"prverify", OPT_PRVERIFY, 's', "Verify a signature using private key"}, 77 {"sigopt", OPT_SIGOPT, 's', "Signature parameter in n:v form"}, 78 {"signature", OPT_SIGNATURE, '<', "File with signature to verify"}, 79 {"hmac", OPT_HMAC, 's', "Create hashed MAC with key"}, 80 {"mac", OPT_MAC, 's', "Create MAC (not necessarily HMAC)"}, 81 {"macopt", OPT_MACOPT, 's', "MAC algorithm parameters in n:v form or key"}, 82 {"", OPT_DIGEST, '-', "Any supported digest"}, 83 {"fips-fingerprint", OPT_FIPS_FINGERPRINT, '-', 84 "Compute HMAC with the key used in OpenSSL-FIPS fingerprint"}, 85 86 OPT_R_OPTIONS, 87 OPT_PROV_OPTIONS, 88 89 OPT_PARAMETERS(), 90 {"file", 0, 0, "Files to digest (optional; default is stdin)"}, 91 {NULL} 92 }; 93 94 int dgst_main(int argc, char **argv) 95 { 96 BIO *in = NULL, *inp, *bmd = NULL, *out = NULL; 97 ENGINE *e = NULL, *impl = NULL; 98 EVP_PKEY *sigkey = NULL; 99 STACK_OF(OPENSSL_STRING) *sigopts = NULL, *macopts = NULL; 100 char *hmac_key = NULL; 101 char *mac_name = NULL, *digestname = NULL; 102 char *passinarg = NULL, *passin = NULL; 103 EVP_MD *md = NULL; 104 const char *outfile = NULL, *keyfile = NULL, *prog = NULL; 105 const char *sigfile = NULL; 106 const char *md_name = NULL; 107 OPTION_CHOICE o; 108 int separator = 0, debug = 0, keyform = FORMAT_UNDEF, siglen = 0; 109 int i, ret = EXIT_FAILURE, out_bin = -1, want_pub = 0, do_verify = 0; 110 int xoflen = 0; 111 unsigned char *buf = NULL, *sigbuf = NULL; 112 int engine_impl = 0; 113 struct doall_dgst_digests dec; 114 115 buf = app_malloc(BUFSIZE, "I/O buffer"); 116 md = (EVP_MD *)EVP_get_digestbyname(argv[0]); 117 if (md != NULL) 118 digestname = argv[0]; 119 120 prog = opt_init(argc, argv, dgst_options); 121 while ((o = opt_next()) != OPT_EOF) { 122 switch (o) { 123 case OPT_EOF: 124 case OPT_ERR: 125 opthelp: 126 BIO_printf(bio_err, "%s: Use -help for summary.\n", prog); 127 goto end; 128 case OPT_HELP: 129 opt_help(dgst_options); 130 ret = EXIT_SUCCESS; 131 goto end; 132 case OPT_LIST: 133 BIO_printf(bio_out, "Supported digests:\n"); 134 dec.bio = bio_out; 135 dec.n = 0; 136 OBJ_NAME_do_all_sorted(OBJ_NAME_TYPE_MD_METH, 137 show_digests, &dec); 138 BIO_printf(bio_out, "\n"); 139 ret = EXIT_SUCCESS; 140 goto end; 141 case OPT_C: 142 separator = 1; 143 break; 144 case OPT_R: 145 separator = 2; 146 break; 147 case OPT_R_CASES: 148 if (!opt_rand(o)) 149 goto end; 150 break; 151 case OPT_OUT: 152 outfile = opt_arg(); 153 break; 154 case OPT_SIGN: 155 keyfile = opt_arg(); 156 break; 157 case OPT_PASSIN: 158 passinarg = opt_arg(); 159 break; 160 case OPT_VERIFY: 161 keyfile = opt_arg(); 162 want_pub = do_verify = 1; 163 break; 164 case OPT_PRVERIFY: 165 keyfile = opt_arg(); 166 do_verify = 1; 167 break; 168 case OPT_SIGNATURE: 169 sigfile = opt_arg(); 170 break; 171 case OPT_KEYFORM: 172 if (!opt_format(opt_arg(), OPT_FMT_ANY, &keyform)) 173 goto opthelp; 174 break; 175 case OPT_ENGINE: 176 e = setup_engine(opt_arg(), 0); 177 break; 178 case OPT_ENGINE_IMPL: 179 engine_impl = 1; 180 break; 181 case OPT_HEX: 182 out_bin = 0; 183 break; 184 case OPT_BINARY: 185 out_bin = 1; 186 break; 187 case OPT_XOFLEN: 188 xoflen = atoi(opt_arg()); 189 break; 190 case OPT_DEBUG: 191 debug = 1; 192 break; 193 case OPT_FIPS_FINGERPRINT: 194 hmac_key = "etaonrishdlcupfm"; 195 break; 196 case OPT_HMAC: 197 hmac_key = opt_arg(); 198 break; 199 case OPT_MAC: 200 mac_name = opt_arg(); 201 break; 202 case OPT_SIGOPT: 203 if (!sigopts) 204 sigopts = sk_OPENSSL_STRING_new_null(); 205 if (!sigopts || !sk_OPENSSL_STRING_push(sigopts, opt_arg())) 206 goto opthelp; 207 break; 208 case OPT_MACOPT: 209 if (!macopts) 210 macopts = sk_OPENSSL_STRING_new_null(); 211 if (!macopts || !sk_OPENSSL_STRING_push(macopts, opt_arg())) 212 goto opthelp; 213 break; 214 case OPT_DIGEST: 215 digestname = opt_unknown(); 216 break; 217 case OPT_PROV_CASES: 218 if (!opt_provider(o)) 219 goto end; 220 break; 221 } 222 } 223 224 /* Remaining args are files to digest. */ 225 argc = opt_num_rest(); 226 argv = opt_rest(); 227 if (keyfile != NULL && argc > 1) { 228 BIO_printf(bio_err, "%s: Can only sign or verify one file.\n", prog); 229 goto end; 230 } 231 if (!app_RAND_load()) 232 goto end; 233 234 if (digestname != NULL) { 235 if (!opt_md(digestname, &md)) 236 goto opthelp; 237 } 238 239 if (do_verify && sigfile == NULL) { 240 BIO_printf(bio_err, 241 "No signature to verify: use the -signature option\n"); 242 goto end; 243 } 244 if (engine_impl) 245 impl = e; 246 247 in = BIO_new(BIO_s_file()); 248 bmd = BIO_new(BIO_f_md()); 249 if (in == NULL || bmd == NULL) 250 goto end; 251 252 if (debug) { 253 BIO_set_callback_ex(in, BIO_debug_callback_ex); 254 /* needed for windows 3.1 */ 255 BIO_set_callback_arg(in, (char *)bio_err); 256 } 257 258 if (!app_passwd(passinarg, NULL, &passin, NULL)) { 259 BIO_printf(bio_err, "Error getting password\n"); 260 goto end; 261 } 262 263 if (out_bin == -1) { 264 if (keyfile != NULL) 265 out_bin = 1; 266 else 267 out_bin = 0; 268 } 269 270 out = bio_open_default(outfile, 'w', out_bin ? FORMAT_BINARY : FORMAT_TEXT); 271 if (out == NULL) 272 goto end; 273 274 if ((!(mac_name == NULL) + !(keyfile == NULL) + !(hmac_key == NULL)) > 1) { 275 BIO_printf(bio_err, "MAC and signing key cannot both be specified\n"); 276 goto end; 277 } 278 279 if (keyfile != NULL) { 280 int type; 281 282 if (want_pub) 283 sigkey = load_pubkey(keyfile, keyform, 0, NULL, e, "public key"); 284 else 285 sigkey = load_key(keyfile, keyform, 0, passin, e, "private key"); 286 if (sigkey == NULL) { 287 /* 288 * load_[pub]key() has already printed an appropriate message 289 */ 290 goto end; 291 } 292 type = EVP_PKEY_get_id(sigkey); 293 if (type == EVP_PKEY_ED25519 || type == EVP_PKEY_ED448) { 294 /* 295 * We implement PureEdDSA for these which doesn't have a separate 296 * digest, and only supports one shot. 297 */ 298 BIO_printf(bio_err, "Key type not supported for this operation\n"); 299 goto end; 300 } 301 } 302 303 if (mac_name != NULL) { 304 EVP_PKEY_CTX *mac_ctx = NULL; 305 306 if (!init_gen_str(&mac_ctx, mac_name, impl, 0, NULL, NULL)) 307 goto end; 308 if (macopts != NULL) { 309 for (i = 0; i < sk_OPENSSL_STRING_num(macopts); i++) { 310 char *macopt = sk_OPENSSL_STRING_value(macopts, i); 311 312 if (pkey_ctrl_string(mac_ctx, macopt) <= 0) { 313 EVP_PKEY_CTX_free(mac_ctx); 314 BIO_printf(bio_err, "MAC parameter error \"%s\"\n", macopt); 315 goto end; 316 } 317 } 318 } 319 320 sigkey = app_keygen(mac_ctx, mac_name, 0, 0 /* not verbose */); 321 /* Verbose output would make external-tests gost-engine fail */ 322 EVP_PKEY_CTX_free(mac_ctx); 323 if (sigkey == NULL) 324 goto end; 325 } 326 327 if (hmac_key != NULL) { 328 if (md == NULL) { 329 md = (EVP_MD *)EVP_sha256(); 330 digestname = SN_sha256; 331 } 332 sigkey = EVP_PKEY_new_raw_private_key(EVP_PKEY_HMAC, impl, 333 (unsigned char *)hmac_key, 334 strlen(hmac_key)); 335 if (sigkey == NULL) 336 goto end; 337 } 338 339 if (sigkey != NULL) { 340 EVP_MD_CTX *mctx = NULL; 341 EVP_PKEY_CTX *pctx = NULL; 342 int res; 343 344 if (BIO_get_md_ctx(bmd, &mctx) <= 0) { 345 BIO_printf(bio_err, "Error getting context\n"); 346 goto end; 347 } 348 if (do_verify) 349 if (impl == NULL) 350 res = EVP_DigestVerifyInit_ex(mctx, &pctx, digestname, 351 app_get0_libctx(), 352 app_get0_propq(), sigkey, NULL); 353 else 354 res = EVP_DigestVerifyInit(mctx, &pctx, md, impl, sigkey); 355 else 356 if (impl == NULL) 357 res = EVP_DigestSignInit_ex(mctx, &pctx, digestname, 358 app_get0_libctx(), 359 app_get0_propq(), sigkey, NULL); 360 else 361 res = EVP_DigestSignInit(mctx, &pctx, md, impl, sigkey); 362 if (res == 0) { 363 BIO_printf(bio_err, "Error setting context\n"); 364 goto end; 365 } 366 if (sigopts != NULL) { 367 for (i = 0; i < sk_OPENSSL_STRING_num(sigopts); i++) { 368 char *sigopt = sk_OPENSSL_STRING_value(sigopts, i); 369 370 if (pkey_ctrl_string(pctx, sigopt) <= 0) { 371 BIO_printf(bio_err, "Signature parameter error \"%s\"\n", 372 sigopt); 373 goto end; 374 } 375 } 376 } 377 } 378 /* we use md as a filter, reading from 'in' */ 379 else { 380 EVP_MD_CTX *mctx = NULL; 381 if (BIO_get_md_ctx(bmd, &mctx) <= 0) { 382 BIO_printf(bio_err, "Error getting context\n"); 383 goto end; 384 } 385 if (md == NULL) 386 md = (EVP_MD *)EVP_sha256(); 387 if (!EVP_DigestInit_ex(mctx, md, impl)) { 388 BIO_printf(bio_err, "Error setting digest\n"); 389 goto end; 390 } 391 } 392 393 if (sigfile != NULL && sigkey != NULL) { 394 BIO *sigbio = BIO_new_file(sigfile, "rb"); 395 396 if (sigbio == NULL) { 397 BIO_printf(bio_err, "Error opening signature file %s\n", sigfile); 398 goto end; 399 } 400 siglen = EVP_PKEY_get_size(sigkey); 401 sigbuf = app_malloc(siglen, "signature buffer"); 402 siglen = BIO_read(sigbio, sigbuf, siglen); 403 BIO_free(sigbio); 404 if (siglen <= 0) { 405 BIO_printf(bio_err, "Error reading signature file %s\n", sigfile); 406 goto end; 407 } 408 } 409 inp = BIO_push(bmd, in); 410 411 if (md == NULL) { 412 EVP_MD_CTX *tctx; 413 414 BIO_get_md_ctx(bmd, &tctx); 415 md = EVP_MD_CTX_get1_md(tctx); 416 } 417 if (md != NULL) 418 md_name = EVP_MD_get0_name(md); 419 420 if (xoflen > 0) { 421 if (!(EVP_MD_get_flags(md) & EVP_MD_FLAG_XOF)) { 422 BIO_printf(bio_err, "Length can only be specified for XOF\n"); 423 goto end; 424 } 425 /* 426 * Signing using XOF is not supported by any algorithms currently since 427 * each algorithm only calls EVP_DigestFinal_ex() in their sign_final 428 * and verify_final methods. 429 */ 430 if (sigkey != NULL) { 431 BIO_printf(bio_err, "Signing key cannot be specified for XOF\n"); 432 goto end; 433 } 434 } 435 436 if (argc == 0) { 437 BIO_set_fp(in, stdin, BIO_NOCLOSE); 438 ret = do_fp(out, buf, inp, separator, out_bin, xoflen, sigkey, sigbuf, 439 siglen, NULL, md_name, "stdin"); 440 } else { 441 const char *sig_name = NULL; 442 443 if (out_bin == 0) { 444 if (sigkey != NULL) 445 sig_name = EVP_PKEY_get0_type_name(sigkey); 446 } 447 ret = EXIT_SUCCESS; 448 for (i = 0; i < argc; i++) { 449 if (BIO_read_filename(in, argv[i]) <= 0) { 450 perror(argv[i]); 451 ret = EXIT_FAILURE; 452 continue; 453 } else { 454 if (do_fp(out, buf, inp, separator, out_bin, xoflen, 455 sigkey, sigbuf, siglen, sig_name, md_name, argv[i])) 456 ret = EXIT_FAILURE; 457 } 458 (void)BIO_reset(bmd); 459 } 460 } 461 end: 462 if (ret != EXIT_SUCCESS) 463 ERR_print_errors(bio_err); 464 OPENSSL_clear_free(buf, BUFSIZE); 465 BIO_free(in); 466 OPENSSL_free(passin); 467 BIO_free_all(out); 468 EVP_MD_free(md); 469 EVP_PKEY_free(sigkey); 470 sk_OPENSSL_STRING_free(sigopts); 471 sk_OPENSSL_STRING_free(macopts); 472 OPENSSL_free(sigbuf); 473 BIO_free(bmd); 474 release_engine(e); 475 return ret; 476 } 477 478 static void show_digests(const OBJ_NAME *name, void *arg) 479 { 480 struct doall_dgst_digests *dec = (struct doall_dgst_digests *)arg; 481 EVP_MD *md = NULL; 482 483 /* Filter out signed digests (a.k.a signature algorithms) */ 484 if (strstr(name->name, "rsa") != NULL || strstr(name->name, "RSA") != NULL) 485 return; 486 487 if (!islower((unsigned char)*name->name)) 488 return; 489 490 /* Filter out message digests that we cannot use */ 491 md = EVP_MD_fetch(app_get0_libctx(), name->name, app_get0_propq()); 492 if (md == NULL) { 493 if (EVP_get_digestbyname(name->name) == NULL) 494 return; 495 } 496 497 BIO_printf(dec->bio, "-%-25s", name->name); 498 if (++dec->n == 3) { 499 BIO_printf(dec->bio, "\n"); 500 dec->n = 0; 501 } else { 502 BIO_printf(dec->bio, " "); 503 } 504 505 EVP_MD_free(md); 506 } 507 508 /* 509 * The newline_escape_filename function performs newline escaping for any 510 * filename that contains a newline. This function also takes a pointer 511 * to backslash. The backslash pointer is a flag to indicating whether a newline 512 * is present in the filename. If a newline is present, the backslash flag is 513 * set and the output format will contain a backslash at the beginning of the 514 * digest output. This output format is to replicate the output format found 515 * in the '*sum' checksum programs. This aims to preserve backward 516 * compatibility. 517 */ 518 static const char *newline_escape_filename(const char *file, int * backslash) 519 { 520 size_t i, e = 0, length = strlen(file), newline_count = 0, mem_len = 0; 521 char *file_cpy = NULL; 522 523 for (i = 0; i < length; i++) 524 if (file[i] == '\n') 525 newline_count++; 526 527 mem_len = length + newline_count + 1; 528 file_cpy = app_malloc(mem_len, file); 529 i = 0; 530 531 while(e < length) { 532 const char c = file[e]; 533 if (c == '\n') { 534 file_cpy[i++] = '\\'; 535 file_cpy[i++] = 'n'; 536 *backslash = 1; 537 } else { 538 file_cpy[i++] = c; 539 } 540 e++; 541 } 542 file_cpy[i] = '\0'; 543 return (const char*)file_cpy; 544 } 545 546 547 int do_fp(BIO *out, unsigned char *buf, BIO *bp, int sep, int binout, int xoflen, 548 EVP_PKEY *key, unsigned char *sigin, int siglen, 549 const char *sig_name, const char *md_name, 550 const char *file) 551 { 552 size_t len = BUFSIZE; 553 int i, backslash = 0, ret = EXIT_FAILURE; 554 unsigned char *allocated_buf = NULL; 555 556 while (BIO_pending(bp) || !BIO_eof(bp)) { 557 i = BIO_read(bp, (char *)buf, BUFSIZE); 558 if (i < 0) { 559 BIO_printf(bio_err, "Read error in %s\n", file); 560 goto end; 561 } 562 if (i == 0) 563 break; 564 } 565 if (sigin != NULL) { 566 EVP_MD_CTX *ctx; 567 BIO_get_md_ctx(bp, &ctx); 568 i = EVP_DigestVerifyFinal(ctx, sigin, (unsigned int)siglen); 569 if (i > 0) { 570 BIO_printf(out, "Verified OK\n"); 571 } else if (i == 0) { 572 BIO_printf(out, "Verification failure\n"); 573 goto end; 574 } else { 575 BIO_printf(bio_err, "Error verifying data\n"); 576 goto end; 577 } 578 ret = EXIT_SUCCESS; 579 goto end; 580 } 581 if (key != NULL) { 582 EVP_MD_CTX *ctx; 583 size_t tmplen; 584 585 BIO_get_md_ctx(bp, &ctx); 586 if (!EVP_DigestSignFinal(ctx, NULL, &tmplen)) { 587 BIO_printf(bio_err, "Error getting maximum length of signed data\n"); 588 goto end; 589 } 590 if (tmplen > BUFSIZE) { 591 len = tmplen; 592 allocated_buf = app_malloc(len, "Signature buffer"); 593 buf = allocated_buf; 594 } 595 if (!EVP_DigestSignFinal(ctx, buf, &len)) { 596 BIO_printf(bio_err, "Error signing data\n"); 597 goto end; 598 } 599 } else if (xoflen > 0) { 600 EVP_MD_CTX *ctx; 601 602 len = xoflen; 603 if (len > BUFSIZE) { 604 allocated_buf = app_malloc(len, "Digest buffer"); 605 buf = allocated_buf; 606 } 607 608 BIO_get_md_ctx(bp, &ctx); 609 610 if (!EVP_DigestFinalXOF(ctx, buf, len)) { 611 BIO_printf(bio_err, "Error Digesting Data\n"); 612 goto end; 613 } 614 } else { 615 len = BIO_gets(bp, (char *)buf, BUFSIZE); 616 if ((int)len < 0) 617 goto end; 618 } 619 620 if (binout) { 621 BIO_write(out, buf, len); 622 } else if (sep == 2) { 623 file = newline_escape_filename(file, &backslash); 624 625 if (backslash == 1) 626 BIO_puts(out, "\\"); 627 628 for (i = 0; i < (int)len; i++) 629 BIO_printf(out, "%02x", buf[i]); 630 631 BIO_printf(out, " *%s\n", file); 632 OPENSSL_free((char *)file); 633 } else { 634 if (sig_name != NULL) { 635 BIO_puts(out, sig_name); 636 if (md_name != NULL) 637 BIO_printf(out, "-%s", md_name); 638 BIO_printf(out, "(%s)= ", file); 639 } else if (md_name != NULL) { 640 BIO_printf(out, "%s(%s)= ", md_name, file); 641 } else { 642 BIO_printf(out, "(%s)= ", file); 643 } 644 for (i = 0; i < (int)len; i++) { 645 if (sep && (i != 0)) 646 BIO_printf(out, ":"); 647 BIO_printf(out, "%02x", buf[i]); 648 } 649 BIO_printf(out, "\n"); 650 } 651 652 ret = EXIT_SUCCESS; 653 end: 654 if (allocated_buf != NULL) 655 OPENSSL_clear_free(allocated_buf, len); 656 657 return ret; 658 } 659
Indexes created Mon Mar 02 05:31:46 UTC 2026