1 /*
2 * Copyright 2020-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 <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
base_gettable_params(void * provctx)45 static const OSSL_PARAM *base_gettable_params(void *provctx)
46 {
47 return base_param_types;
48 }
49
base_get_params(void * provctx,OSSL_PARAM params[])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
base_query(void * provctx,int operation_id,int * no_cache)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
base_teardown(void * provctx)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
ossl_base_provider_init(const OSSL_CORE_HANDLE * handle,const OSSL_DISPATCH * in,const OSSL_DISPATCH ** out,void ** provctx)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
185 *out = base_dispatch_table;
186
187 return 1;
188 }
189