Home | History | Annotate | Line # | Download | only in providers
      1 /*
      2  * Copyright 2020-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 #include <string.h>
     11 #include <stdio.h>
     12 #include <openssl/opensslconf.h>
     13 #include <openssl/core.h>
     14 #include <openssl/core_dispatch.h>
     15 #include <openssl/core_names.h>
     16 #include <openssl/params.h>
     17 #include "prov/bio.h"
     18 #include "prov/provider_ctx.h"
     19 #include "prov/providercommon.h"
     20 #include "prov/implementations.h"
     21 #include "prov/provider_util.h"
     22 #include "prov/names.h"
     23 
     24 /*
     25  * Forward declarations to ensure that interface functions are correctly
     26  * defined.
     27  */
     28 static OSSL_FUNC_provider_gettable_params_fn base_gettable_params;
     29 static OSSL_FUNC_provider_get_params_fn base_get_params;
     30 static OSSL_FUNC_provider_query_operation_fn base_query;
     31 
     32 /* Functions provided by the core */
     33 static OSSL_FUNC_core_gettable_params_fn *c_gettable_params = NULL;
     34 static OSSL_FUNC_core_get_params_fn *c_get_params = NULL;
     35 
     36 /* Parameters we provide to the core */
     37 static const OSSL_PARAM base_param_types[] = {
     38     OSSL_PARAM_DEFN(OSSL_PROV_PARAM_NAME, OSSL_PARAM_UTF8_PTR, NULL, 0),
     39     OSSL_PARAM_DEFN(OSSL_PROV_PARAM_VERSION, OSSL_PARAM_UTF8_PTR, NULL, 0),
     40     OSSL_PARAM_DEFN(OSSL_PROV_PARAM_BUILDINFO, OSSL_PARAM_UTF8_PTR, NULL, 0),
     41     OSSL_PARAM_DEFN(OSSL_PROV_PARAM_STATUS, OSSL_PARAM_INTEGER, NULL, 0),
     42     OSSL_PARAM_END
     43 };
     44 
     45 static const OSSL_PARAM *base_gettable_params(void *provctx)
     46 {
     47     return base_param_types;
     48 }
     49 
     50 static int base_get_params(void *provctx, OSSL_PARAM params[])
     51 {
     52     OSSL_PARAM *p;
     53 
     54     p = OSSL_PARAM_locate(params, OSSL_PROV_PARAM_NAME);
     55     if (p != NULL
     56         && !OSSL_PARAM_set_utf8_ptr(p, "OpenSSL Base Provider"))
     57         return 0;
     58     p = OSSL_PARAM_locate(params, OSSL_PROV_PARAM_VERSION);
     59     if (p != NULL && !OSSL_PARAM_set_utf8_ptr(p, OPENSSL_VERSION_STR))
     60         return 0;
     61     p = OSSL_PARAM_locate(params, OSSL_PROV_PARAM_BUILDINFO);
     62     if (p != NULL && !OSSL_PARAM_set_utf8_ptr(p, OPENSSL_FULL_VERSION_STR))
     63         return 0;
     64     p = OSSL_PARAM_locate(params, OSSL_PROV_PARAM_STATUS);
     65     if (p != NULL && !OSSL_PARAM_set_int(p, ossl_prov_is_running()))
     66         return 0;
     67 
     68     return 1;
     69 }
     70 
     71 static const OSSL_ALGORITHM base_encoder[] = {
     72 #define ENCODER_PROVIDER "base"
     73 #include "encoders.inc"
     74     { NULL, NULL, NULL }
     75 #undef ENCODER_PROVIDER
     76 };
     77 
     78 static const OSSL_ALGORITHM base_decoder[] = {
     79 #define DECODER_PROVIDER "base"
     80 #include "decoders.inc"
     81     { NULL, NULL, NULL }
     82 #undef DECODER_PROVIDER
     83 };
     84 
     85 static const OSSL_ALGORITHM base_store[] = {
     86 #define STORE(name, _fips, func_table) \
     87     { name, "provider=base,fips=" _fips, (func_table) },
     88 
     89 #include "stores.inc"
     90     { NULL, NULL, NULL }
     91 #undef STORE
     92 };
     93 
     94 static const OSSL_ALGORITHM base_rands[] = {
     95     { PROV_NAMES_SEED_SRC, "provider=base", ossl_seed_src_functions },
     96 #ifndef OPENSSL_NO_JITTER
     97     { PROV_NAMES_JITTER, "provider=base", ossl_jitter_functions },
     98 #endif
     99     { NULL, NULL, NULL }
    100 };
    101 
    102 static const OSSL_ALGORITHM *base_query(void *provctx, int operation_id,
    103     int *no_cache)
    104 {
    105     *no_cache = 0;
    106     switch (operation_id) {
    107     case OSSL_OP_ENCODER:
    108         return base_encoder;
    109     case OSSL_OP_DECODER:
    110         return base_decoder;
    111     case OSSL_OP_STORE:
    112         return base_store;
    113     case OSSL_OP_RAND:
    114         return base_rands;
    115     }
    116     return NULL;
    117 }
    118 
    119 static void base_teardown(void *provctx)
    120 {
    121     BIO_meth_free(ossl_prov_ctx_get0_core_bio_method(provctx));
    122     ossl_prov_ctx_free(provctx);
    123 }
    124 
    125 /* Functions we provide to the core */
    126 static const OSSL_DISPATCH base_dispatch_table[] = {
    127     { OSSL_FUNC_PROVIDER_TEARDOWN, (void (*)(void))base_teardown },
    128     { OSSL_FUNC_PROVIDER_GETTABLE_PARAMS,
    129         (void (*)(void))base_gettable_params },
    130     { OSSL_FUNC_PROVIDER_GET_PARAMS, (void (*)(void))base_get_params },
    131     { OSSL_FUNC_PROVIDER_QUERY_OPERATION, (void (*)(void))base_query },
    132     OSSL_DISPATCH_END
    133 };
    134 
    135 OSSL_provider_init_fn ossl_base_provider_init;
    136 
    137 int ossl_base_provider_init(const OSSL_CORE_HANDLE *handle,
    138     const OSSL_DISPATCH *in, const OSSL_DISPATCH **out,
    139     void **provctx)
    140 {
    141     OSSL_FUNC_core_get_libctx_fn *c_get_libctx = NULL;
    142     BIO_METHOD *corebiometh;
    143 
    144     if (!ossl_prov_bio_from_dispatch(in))
    145         return 0;
    146     for (; in->function_id != 0; in++) {
    147         switch (in->function_id) {
    148         case OSSL_FUNC_CORE_GETTABLE_PARAMS:
    149             c_gettable_params = OSSL_FUNC_core_gettable_params(in);
    150             break;
    151         case OSSL_FUNC_CORE_GET_PARAMS:
    152             c_get_params = OSSL_FUNC_core_get_params(in);
    153             break;
    154         case OSSL_FUNC_CORE_GET_LIBCTX:
    155             c_get_libctx = OSSL_FUNC_core_get_libctx(in);
    156             break;
    157         default:
    158             /* Just ignore anything we don't understand */
    159             break;
    160         }
    161     }
    162 
    163     if (c_get_libctx == NULL)
    164         return 0;
    165 
    166     /*
    167      * We want to make sure that all calls from this provider that requires
    168      * a library context use the same context as the one used to call our
    169      * functions.  We do that by passing it along in the provider context.
    170      *
    171      * This only works for built-in providers.  Most providers should
    172      * create their own library context.
    173      */
    174     if ((*provctx = ossl_prov_ctx_new()) == NULL
    175         || (corebiometh = ossl_bio_prov_init_bio_method()) == NULL) {
    176         ossl_prov_ctx_free(*provctx);
    177         *provctx = NULL;
    178         return 0;
    179     }
    180     ossl_prov_ctx_set0_libctx(*provctx,
    181         (OSSL_LIB_CTX *)c_get_libctx(handle));
    182     ossl_prov_ctx_set0_handle(*provctx, handle);
    183     ossl_prov_ctx_set0_core_bio_method(*provctx, corebiometh);
    184     ossl_prov_ctx_set0_core_get_params(*provctx, c_get_params);
    185 
    186     *out = base_dispatch_table;
    187 
    188     return 1;
    189 }
    190