providers/fips/fipsprov.c

   1 /*
   2  * Copyright 2019 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 <string.h>
  11 #include <stdio.h>
  12 #include <openssl/core.h>
  13 #include <openssl/core_numbers.h>
  14 #include <openssl/core_names.h>
  15 #include <openssl/params.h>
  16 #include <openssl/err.h>
  17 #include <openssl/evp.h>
  18
  19 /* TODO(3.0): Needed for dummy_evp_call(). To be removed */
  20 #include <openssl/sha.h>
  21 #include <openssl/rand_drbg.h>
  22 #include <openssl/ec.h>
  23
  24 #include "internal/cryptlib.h"
  25 #include "internal/property.h"
  26 #include "internal/evp_int.h"
  27 #include "internal/provider_algs.h"
  28 #include "internal/provider_ctx.h"
  29 #include "internal/providercommon.h"
  30
  31 extern OSSL_core_thread_start_fn *c_thread_start;
  32
  33 /*
  34  * TODO(3.0): Should these be stored in the provider side provctx? Could they
  35  * ever be different from one init to the next? Unfortunately we can't do this
  36  * at the moment because c_put_error/c_add_error_vdata do not provide
  37  * us with the OPENSSL_CTX as a parameter.
  38  */
  39 /* Functions provided by the core */
  40 static OSSL_core_gettable_params_fn *c_gettable_params;
  41 static OSSL_core_get_params_fn *c_get_params;
  42 OSSL_core_thread_start_fn *c_thread_start;
  43 static OSSL_core_new_error_fn *c_new_error;
  44 static OSSL_core_set_error_debug_fn *c_set_error_debug;
  45 static OSSL_core_vset_error_fn *c_vset_error;
  46 static OSSL_CRYPTO_malloc_fn *c_CRYPTO_malloc;
  47 static OSSL_CRYPTO_zalloc_fn *c_CRYPTO_zalloc;
  48 static OSSL_CRYPTO_free_fn *c_CRYPTO_free;
  49 static OSSL_CRYPTO_clear_free_fn *c_CRYPTO_clear_free;
  50 static OSSL_CRYPTO_realloc_fn *c_CRYPTO_realloc;
  51 static OSSL_CRYPTO_clear_realloc_fn *c_CRYPTO_clear_realloc;
  52 static OSSL_CRYPTO_secure_malloc_fn *c_CRYPTO_secure_malloc;
  53 static OSSL_CRYPTO_secure_zalloc_fn *c_CRYPTO_secure_zalloc;
  54 static OSSL_CRYPTO_secure_free_fn *c_CRYPTO_secure_free;
  55 static OSSL_CRYPTO_secure_clear_free_fn *c_CRYPTO_secure_clear_free;
  56 static OSSL_CRYPTO_secure_allocated_fn *c_CRYPTO_secure_allocated;
  57
  58 typedef struct fips_global_st {
  59     const OSSL_PROVIDER *prov;
  60 } FIPS_GLOBAL;
  61
  62 static void *fips_prov_ossl_ctx_new(OPENSSL_CTX *libctx)
  63 {
  64     FIPS_GLOBAL *fgbl = OPENSSL_zalloc(sizeof(*fgbl));
  65
  66     return fgbl;
  67 }
  68
  69 static void fips_prov_ossl_ctx_free(void *fgbl)
  70 {
  71     OPENSSL_free(fgbl);
  72 }
  73
  74 static const OPENSSL_CTX_METHOD fips_prov_ossl_ctx_method = {
  75     fips_prov_ossl_ctx_new,
  76     fips_prov_ossl_ctx_free,
  77 };
  78
  79
  80 /* Parameters we provide to the core */
  81 static const OSSL_PARAM fips_param_types[] = {
  82     OSSL_PARAM_DEFN(OSSL_PROV_PARAM_NAME, OSSL_PARAM_UTF8_PTR, NULL, 0),
  83     OSSL_PARAM_DEFN(OSSL_PROV_PARAM_VERSION, OSSL_PARAM_UTF8_PTR, NULL, 0),
  84     OSSL_PARAM_DEFN(OSSL_PROV_PARAM_BUILDINFO, OSSL_PARAM_UTF8_PTR, NULL, 0),
  85     OSSL_PARAM_END
  86 };
  87
  88 /* TODO(3.0): To be removed */
  89 static int dummy_evp_call(void *provctx)
  90 {
  91     OPENSSL_CTX *libctx = PROV_LIBRARY_CONTEXT_OF(provctx);
  92     EVP_MD_CTX *ctx = EVP_MD_CTX_new();
  93     EVP_MD *sha256 = EVP_MD_fetch(libctx, "SHA256", NULL);
  94     char msg[] = "Hello World!";
  95     const unsigned char exptd[] = {
  96         0x7f, 0x83, 0xb1, 0x65, 0x7f, 0xf1, 0xfc, 0x53, 0xb9, 0x2d, 0xc1, 0x81,
  97         0x48, 0xa1, 0xd6, 0x5d, 0xfc, 0x2d, 0x4b, 0x1f, 0xa3, 0xd6, 0x77, 0x28,
  98         0x4a, 0xdd, 0xd2, 0x00, 0x12, 0x6d, 0x90, 0x69
  99     };
 100     unsigned int dgstlen = 0;
 101     unsigned char dgst[SHA256_DIGEST_LENGTH];
 102     int ret = 0;
 103     BN_CTX *bnctx = NULL;
 104     BIGNUM *a = NULL, *b = NULL;
 105     unsigned char randbuf[128];
 106     RAND_DRBG *drbg = OPENSSL_CTX_get0_public_drbg(libctx);
 107 #ifndef OPENSSL_NO_EC
 108     EC_KEY *key = NULL;
 109 #endif
 110
 111     if (ctx == NULL || sha256 == NULL || drbg == NULL)
 112         goto err;
 113
 114     if (!EVP_DigestInit_ex(ctx, sha256, NULL))
 115         goto err;
 116     if (!EVP_DigestUpdate(ctx, msg, sizeof(msg) - 1))
 117         goto err;
 118     if (!EVP_DigestFinal(ctx, dgst, &dgstlen))
 119         goto err;
 120     if (dgstlen != sizeof(exptd) || memcmp(dgst, exptd, sizeof(exptd)) != 0)
 121         goto err;
 122
 123     bnctx = BN_CTX_new_ex(libctx);
 124     if (bnctx == NULL)
 125         goto err;
 126     BN_CTX_start(bnctx);
 127     a = BN_CTX_get(bnctx);
 128     b = BN_CTX_get(bnctx);
 129     if (b == NULL)
 130         goto err;
 131     BN_zero(a);
 132     if (!BN_one(b)
 133         || !BN_add(a, a, b)
 134         || BN_cmp(a, b) != 0)
 135         goto err;
 136
 137     if (RAND_DRBG_bytes(drbg, randbuf, sizeof(randbuf)) <= 0)
 138         goto err;
 139
 140     if (!BN_rand_ex(a, 256, BN_RAND_TOP_ANY, BN_RAND_BOTTOM_ANY, bnctx))
 141         goto err;
 142
 143 #ifndef OPENSSL_NO_EC
 144     /* Do some dummy EC calls */
 145     key = EC_KEY_new_by_curve_name_ex(libctx, NID_X9_62_prime256v1);
 146     if (key == NULL)
 147         goto err;
 148
 149     if (!EC_KEY_generate_key(key))
 150         goto err;
 151 #endif
 152
 153     ret = 1;
 154  err:
 155     BN_CTX_end(bnctx);
 156     BN_CTX_free(bnctx);
 157
 158     EVP_MD_CTX_free(ctx);
 159     EVP_MD_meth_free(sha256);
 160
 161 #ifndef OPENSSL_NO_EC
 162     EC_KEY_free(key);
 163 #endif
 164     return ret;
 165 }
 166
 167 static const OSSL_PARAM *fips_gettable_params(const OSSL_PROVIDER *prov)
 168 {
 169     return fips_param_types;
 170 }
 171
 172 static int fips_get_params(const OSSL_PROVIDER *prov, OSSL_PARAM params[])
 173 {
 174     OSSL_PARAM *p;
 175
 176     p = OSSL_PARAM_locate(params, OSSL_PROV_PARAM_NAME);
 177     if (p != NULL && !OSSL_PARAM_set_utf8_ptr(p, "OpenSSL FIPS Provider"))
 178         return 0;
 179     p = OSSL_PARAM_locate(params, OSSL_PROV_PARAM_VERSION);
 180     if (p != NULL && !OSSL_PARAM_set_utf8_ptr(p, OPENSSL_VERSION_STR))
 181         return 0;
 182     p = OSSL_PARAM_locate(params, OSSL_PROV_PARAM_BUILDINFO);
 183     if (p != NULL && !OSSL_PARAM_set_utf8_ptr(p, OPENSSL_FULL_VERSION_STR))
 184         return 0;
 185
 186     return 1;
 187 }
 188
 189 /* FIPS specific version of the function of the same name in provlib.c */
 190 const char *ossl_prov_util_nid_to_name(int nid)
 191 {
 192     /* We don't have OBJ_nid2n() in FIPS_MODE so we have an explicit list */
 193
 194     switch (nid) {
 195     /* Digests */
 196     case NID_sha1:
 197         return "SHA224";
 198     case NID_sha224:
 199         return "SHA224";
 200     case NID_sha256:
 201         return "SHA256";
 202     case NID_sha384:
 203         return "SHA384";
 204     case NID_sha512:
 205         return "SHA512";
 206     case NID_sha512_224:
 207         return "SHA512-224";
 208     case NID_sha512_256:
 209         return "SHA512-256";
 210     case NID_sha3_224:
 211         return "SHA3-224";
 212     case NID_sha3_256:
 213         return "SHA3-256";
 214     case NID_sha3_384:
 215         return "SHA3-384";
 216     case NID_sha3_512:
 217         return "SHA3-512";
 218
 219     /* Ciphers */
 220     case NID_aes_256_ecb:
 221         return "AES-256-ECB";
 222     case NID_aes_192_ecb:
 223         return "AES-192-ECB";
 224     case NID_aes_128_ecb:
 225         return "AES-128-ECB";
 226     case NID_aes_256_cbc:
 227         return "AES-256-CBC";
 228     case NID_aes_192_cbc:
 229         return "AES-192-CBC";
 230     case NID_aes_128_cbc:
 231         return "AES-128-CBC";
 232     case NID_aes_256_ctr:
 233         return "AES-256-CTR";
 234     case NID_aes_192_ctr:
 235         return "AES-192-CTR";
 236     case NID_aes_128_ctr:
 237         return "AES-128-CTR";
 238     }
 239
 240     return NULL;
 241 }
 242
 243 static const OSSL_ALGORITHM fips_digests[] = {
 244     { "SHA1", "fips=yes", sha1_functions },
 245     { "SHA224", "fips=yes", sha224_functions },
 246     { "SHA256", "fips=yes", sha256_functions },
 247     { "SHA384", "fips=yes", sha384_functions },
 248     { "SHA512", "fips=yes", sha512_functions },
 249     { "SHA512-224", "fips=yes", sha512_224_functions },
 250     { "SHA512-256", "fips=yes", sha512_256_functions },
 251     { "SHA3-224", "fips=yes", sha3_224_functions },
 252     { "SHA3-256", "fips=yes", sha3_256_functions },
 253     { "SHA3-384", "fips=yes", sha3_384_functions },
 254     { "SHA3-512", "fips=yes", sha3_512_functions },
 255     /*
 256      * KMAC128 and KMAC256 as hashes are mostly useful for the MACs with the
 257      * same names
 258      */
 259     { "KMAC128", "fips=yes", keccak_kmac_128_functions },
 260     { "KMAC256", "fips=yes", keccak_kmac_256_functions },
 261
 262     { NULL, NULL, NULL }
 263 };
 264
 265 static const OSSL_ALGORITHM fips_ciphers[] = {
 266     { "AES-256-ECB", "fips=yes", aes256ecb_functions },
 267     { "AES-192-ECB", "fips=yes", aes192ecb_functions },
 268     { "AES-128-ECB", "fips=yes", aes128ecb_functions },
 269     { "AES-256-CBC", "fips=yes", aes256cbc_functions },
 270     { "AES-192-CBC", "fips=yes", aes192cbc_functions },
 271     { "AES-128-CBC", "fips=yes", aes128cbc_functions },
 272     { "AES-256-CTR", "fips=yes", aes256ctr_functions },
 273     { "AES-192-CTR", "fips=yes", aes192ctr_functions },
 274     { "AES-128-CTR", "fips=yes", aes128ctr_functions },
 275     { "id-aes256-GCM", "fips=yes", aes256gcm_functions },
 276     { "id-aes192-GCM", "fips=yes", aes192gcm_functions },
 277     { "id-aes128-GCM", "fips=yes", aes128gcm_functions },
 278     { NULL, NULL, NULL }
 279 };
 280
 281 static const OSSL_ALGORITHM fips_macs[] = {
 282     { "CMAC", "fips=yes", cmac_functions },
 283     { "GMAC", "fips=yes", gmac_functions },
 284     { "HMAC", "fips=yes", hmac_functions },
 285     { "KMAC128", "fips=yes", kmac128_functions },
 286     { "KMAC256", "fips=yes", kmac256_functions },
 287     { NULL, NULL, NULL }
 288 };
 289
 290 static const OSSL_ALGORITHM *fips_query(OSSL_PROVIDER *prov,
 291                                          int operation_id,
 292                                          int *no_cache)
 293 {
 294     *no_cache = 0;
 295     switch (operation_id) {
 296     case OSSL_OP_DIGEST:
 297         return fips_digests;
 298     case OSSL_OP_CIPHER:
 299         return fips_ciphers;
 300     case OSSL_OP_MAC:
 301         return fips_macs;
 302     }
 303     return NULL;
 304 }
 305
 306 /* Functions we provide to the core */
 307 static const OSSL_DISPATCH fips_dispatch_table[] = {
 308     /*
 309      * To release our resources we just need to free the OPENSSL_CTX so we just
 310      * use OPENSSL_CTX_free directly as our teardown function
 311      */
 312     { OSSL_FUNC_PROVIDER_TEARDOWN, (void (*)(void))OPENSSL_CTX_free },
 313     { OSSL_FUNC_PROVIDER_GETTABLE_PARAMS, (void (*)(void))fips_gettable_params },
 314     { OSSL_FUNC_PROVIDER_GET_PARAMS, (void (*)(void))fips_get_params },
 315     { OSSL_FUNC_PROVIDER_QUERY_OPERATION, (void (*)(void))fips_query },
 316     { 0, NULL }
 317 };
 318
 319 /* Functions we provide to ourself */
 320 static const OSSL_DISPATCH intern_dispatch_table[] = {
 321     { OSSL_FUNC_PROVIDER_QUERY_OPERATION, (void (*)(void))fips_query },
 322     { 0, NULL }
 323 };
 324
 325
 326 int OSSL_provider_init(const OSSL_PROVIDER *provider,
 327                        const OSSL_DISPATCH *in,
 328                        const OSSL_DISPATCH **out,
 329                        void **provctx)
 330 {
 331     FIPS_GLOBAL *fgbl;
 332     OPENSSL_CTX *ctx;
 333
 334     for (; in->function_id != 0; in++) {
 335         switch (in->function_id) {
 336         case OSSL_FUNC_CORE_GETTABLE_PARAMS:
 337             c_gettable_params = OSSL_get_core_gettable_params(in);
 338             break;
 339         case OSSL_FUNC_CORE_GET_PARAMS:
 340             c_get_params = OSSL_get_core_get_params(in);
 341             break;
 342         case OSSL_FUNC_CORE_THREAD_START:
 343             c_thread_start = OSSL_get_core_thread_start(in);
 344             break;
 345         case OSSL_FUNC_CORE_NEW_ERROR:
 346             c_new_error = OSSL_get_core_new_error(in);
 347             break;
 348         case OSSL_FUNC_CORE_SET_ERROR_DEBUG:
 349             c_set_error_debug = OSSL_get_core_set_error_debug(in);
 350             break;
 351         case OSSL_FUNC_CORE_VSET_ERROR:
 352             c_vset_error = OSSL_get_core_vset_error(in);
 353             break;
 354         case OSSL_FUNC_CRYPTO_MALLOC:
 355             c_CRYPTO_malloc = OSSL_get_CRYPTO_malloc(in);
 356             break;
 357         case OSSL_FUNC_CRYPTO_ZALLOC:
 358             c_CRYPTO_zalloc = OSSL_get_CRYPTO_zalloc(in);
 359             break;
 360         case OSSL_FUNC_CRYPTO_FREE:
 361             c_CRYPTO_free = OSSL_get_CRYPTO_free(in);
 362             break;
 363         case OSSL_FUNC_CRYPTO_CLEAR_FREE:
 364             c_CRYPTO_clear_free = OSSL_get_CRYPTO_clear_free(in);
 365             break;
 366         case OSSL_FUNC_CRYPTO_REALLOC:
 367             c_CRYPTO_realloc = OSSL_get_CRYPTO_realloc(in);
 368             break;
 369         case OSSL_FUNC_CRYPTO_CLEAR_REALLOC:
 370             c_CRYPTO_clear_realloc = OSSL_get_CRYPTO_clear_realloc(in);
 371             break;
 372         case OSSL_FUNC_CRYPTO_SECURE_MALLOC:
 373             c_CRYPTO_secure_malloc = OSSL_get_CRYPTO_secure_malloc(in);
 374             break;
 375         case OSSL_FUNC_CRYPTO_SECURE_ZALLOC:
 376             c_CRYPTO_secure_zalloc = OSSL_get_CRYPTO_secure_zalloc(in);
 377             break;
 378         case OSSL_FUNC_CRYPTO_SECURE_FREE:
 379             c_CRYPTO_secure_free = OSSL_get_CRYPTO_secure_free(in);
 380             break;
 381         case OSSL_FUNC_CRYPTO_SECURE_CLEAR_FREE:
 382             c_CRYPTO_secure_clear_free = OSSL_get_CRYPTO_secure_clear_free(in);
 383             break;
 384         case OSSL_FUNC_CRYPTO_SECURE_ALLOCATED:
 385             c_CRYPTO_secure_allocated = OSSL_get_CRYPTO_secure_allocated(in);
 386             break;
 387         default:
 388             /* Just ignore anything we don't understand */
 389             break;
 390         }
 391     }
 392
 393     /*  Create a context. */
 394     if ((ctx = OPENSSL_CTX_new()) == NULL)
 395         return 0;
 396     if ((fgbl = openssl_ctx_get_data(ctx, OPENSSL_CTX_FIPS_PROV_INDEX,
 397                                      &fips_prov_ossl_ctx_method)) == NULL) {
 398         OPENSSL_CTX_free(ctx);
 399         return 0;
 400     }
 401     fgbl->prov = provider;
 402     *out = fips_dispatch_table;
 403     *provctx = ctx;
 404
 405     /*
 406      * TODO(3.0): Remove me. This is just a dummy call to demonstrate making
 407      * EVP calls from within the FIPS module.
 408      */
 409     if (!dummy_evp_call(*provctx)) {
 410         OPENSSL_CTX_free(*provctx);
 411         *provctx = NULL;
 412         return 0;
 413     }
 414
 415     return 1;
 416 }
 417
 418 /*
 419  * The internal init function used when the FIPS module uses EVP to call
 420  * another algorithm also in the FIPS module. This is a recursive call that has
 421  * been made from within the FIPS module itself. To make this work, we populate
 422  * the provider context of this inner instance with the same library context
 423  * that was used in the EVP call that initiated this recursive call.
 424  */
 425 OSSL_provider_init_fn fips_intern_provider_init;
 426 int fips_intern_provider_init(const OSSL_PROVIDER *provider,
 427                               const OSSL_DISPATCH *in,
 428                               const OSSL_DISPATCH **out,
 429                               void **provctx)
 430 {
 431     OSSL_core_get_library_context_fn *c_get_libctx = NULL;
 432
 433     for (; in->function_id != 0; in++) {
 434         switch (in->function_id) {
 435         case OSSL_FUNC_CORE_GET_LIBRARY_CONTEXT:
 436             c_get_libctx = OSSL_get_core_get_library_context(in);
 437             break;
 438         default:
 439             break;
 440         }
 441     }
 442
 443     if (c_get_libctx == NULL)
 444         return 0;
 445
 446     *provctx = c_get_libctx(provider);
 447
 448     /*
 449      * Safety measure...  we should get the library context that was
 450      * created up in OSSL_provider_init().
 451      */
 452     if (*provctx == NULL)
 453         return 0;
 454
 455     *out = intern_dispatch_table;
 456     return 1;
 457 }
 458
 459 void ERR_new(void)
 460 {
 461     c_new_error(NULL);
 462 }
 463
 464 void ERR_set_debug(const char *file, int line, const char *func)
 465 {
 466     c_set_error_debug(NULL, file, line, func);
 467 }
 468
 469 void ERR_set_error(int lib, int reason, const char *fmt, ...)
 470 {
 471     va_list args;
 472
 473     va_start(args, fmt);
 474     c_vset_error(NULL, ERR_PACK(lib, 0, reason), fmt, args);
 475     va_end(args);
 476 }
 477
 478 void ERR_vset_error(int lib, int reason, const char *fmt, va_list args)
 479 {
 480     c_vset_error(NULL, ERR_PACK(lib, 0, reason), fmt, args);
 481 }
 482
 483 const OSSL_PROVIDER *FIPS_get_provider(OPENSSL_CTX *ctx)
 484 {
 485     FIPS_GLOBAL *fgbl = openssl_ctx_get_data(ctx, OPENSSL_CTX_FIPS_PROV_INDEX,
 486                                              &fips_prov_ossl_ctx_method);
 487
 488     if (fgbl == NULL)
 489         return NULL;
 490
 491     return fgbl->prov;
 492 }
 493
 494 void *CRYPTO_malloc(size_t num, const char *file, int line)
 495 {
 496     return c_CRYPTO_malloc(num, file, line);
 497 }
 498
 499 void *CRYPTO_zalloc(size_t num, const char *file, int line)
 500 {
 501     return c_CRYPTO_zalloc(num, file, line);
 502 }
 503
 504 void CRYPTO_free(void *ptr, const char *file, int line)
 505 {
 506     c_CRYPTO_free(ptr, file, line);
 507 }
 508
 509 void CRYPTO_clear_free(void *ptr, size_t num, const char *file, int line)
 510 {
 511     c_CRYPTO_clear_free(ptr, num, file, line);
 512 }
 513
 514 void *CRYPTO_realloc(void *addr, size_t num, const char *file, int line)
 515 {
 516     return c_CRYPTO_realloc(addr, num, file, line);
 517 }
 518
 519 void *CRYPTO_clear_realloc(void *addr, size_t old_num, size_t num,
 520                            const char *file, int line)
 521 {
 522     return c_CRYPTO_clear_realloc(addr, old_num, num, file, line);
 523 }
 524
 525 void *CRYPTO_secure_malloc(size_t num, const char *file, int line)
 526 {
 527     return c_CRYPTO_secure_malloc(num, file, line);
 528 }
 529
 530 void *CRYPTO_secure_zalloc(size_t num, const char *file, int line)
 531 {
 532     return c_CRYPTO_secure_zalloc(num, file, line);
 533 }
 534
 535 void CRYPTO_secure_free(void *ptr, const char *file, int line)
 536 {
 537     c_CRYPTO_secure_free(ptr, file, line);
 538 }
 539
 540 void CRYPTO_secure_clear_free(void *ptr, size_t num, const char *file, int line)
 541 {
 542     c_CRYPTO_secure_clear_free(ptr, num, file, line);
 543 }
 544
 545 int CRYPTO_secure_allocated(const void *ptr)
 546 {
 547     return c_CRYPTO_secure_allocated(ptr);
 548 }