1 /*
2 * Copyright 2006-2026 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 <assert.h>
11 #include <limits.h>
12 #include <openssl/cms.h>
13 #include <openssl/err.h>
14 #include <openssl/decoder.h>
15 #include "internal/sizes.h"
16 #include "crypto/asn1.h"
17 #include "crypto/evp.h"
18 #include "cms_local.h"
19
pkey_type2param(int ptype,const void * pval,OSSL_LIB_CTX * libctx,const char * propq)20 static EVP_PKEY *pkey_type2param(int ptype, const void *pval,
21 OSSL_LIB_CTX *libctx, const char *propq)
22 {
23 EVP_PKEY *pkey = NULL;
24 EVP_PKEY_CTX *pctx = NULL;
25 OSSL_DECODER_CTX *ctx = NULL;
26
27 if (ptype == V_ASN1_SEQUENCE) {
28 const ASN1_STRING *pstr = pval;
29 const unsigned char *pm = pstr->data;
30 size_t pmlen = (size_t)pstr->length;
31 int selection = OSSL_KEYMGMT_SELECT_ALL_PARAMETERS;
32
33 ctx = OSSL_DECODER_CTX_new_for_pkey(&pkey, "DER", NULL, "EC",
34 selection, libctx, propq);
35 if (ctx == NULL)
36 goto err;
37
38 if (!OSSL_DECODER_from_data(ctx, &pm, &pmlen)) {
39 ERR_raise(ERR_LIB_CMS, CMS_R_DECODE_ERROR);
40 goto err;
41 }
42 OSSL_DECODER_CTX_free(ctx);
43 return pkey;
44 } else if (ptype == V_ASN1_OBJECT) {
45 const ASN1_OBJECT *poid = pval;
46 char groupname[OSSL_MAX_NAME_SIZE];
47
48 /* type == V_ASN1_OBJECT => the parameters are given by an asn1 OID */
49 pctx = EVP_PKEY_CTX_new_from_name(libctx, "EC", propq);
50 if (pctx == NULL || EVP_PKEY_paramgen_init(pctx) <= 0)
51 goto err;
52 if (OBJ_obj2txt(groupname, sizeof(groupname), poid, 0) <= 0
53 || EVP_PKEY_CTX_set_group_name(pctx, groupname) <= 0) {
54 ERR_raise(ERR_LIB_CMS, CMS_R_DECODE_ERROR);
55 goto err;
56 }
57 if (EVP_PKEY_paramgen(pctx, &pkey) <= 0)
58 goto err;
59 EVP_PKEY_CTX_free(pctx);
60 return pkey;
61 }
62
63 ERR_raise(ERR_LIB_CMS, CMS_R_DECODE_ERROR);
64 return NULL;
65
66 err:
67 EVP_PKEY_free(pkey);
68 EVP_PKEY_CTX_free(pctx);
69 OSSL_DECODER_CTX_free(ctx);
70 return NULL;
71 }
72
ecdh_cms_set_peerkey(EVP_PKEY_CTX * pctx,X509_ALGOR * alg,ASN1_BIT_STRING * pubkey)73 static int ecdh_cms_set_peerkey(EVP_PKEY_CTX *pctx,
74 X509_ALGOR *alg, ASN1_BIT_STRING *pubkey)
75 {
76 const ASN1_OBJECT *aoid;
77 int atype;
78 const void *aval;
79 int rv = 0;
80 EVP_PKEY *pkpeer = NULL;
81 const unsigned char *p;
82 int plen;
83
84 X509_ALGOR_get0(&aoid, &atype, &aval, alg);
85 if (OBJ_obj2nid(aoid) != NID_X9_62_id_ecPublicKey)
86 goto err;
87
88 /* If absent parameters get group from main key */
89 if (atype == V_ASN1_UNDEF || atype == V_ASN1_NULL) {
90 EVP_PKEY *pk;
91
92 pk = EVP_PKEY_CTX_get0_pkey(pctx);
93 if (pk == NULL)
94 goto err;
95
96 pkpeer = EVP_PKEY_new();
97 if (pkpeer == NULL)
98 goto err;
99 if (!EVP_PKEY_copy_parameters(pkpeer, pk))
100 goto err;
101 } else {
102 pkpeer = pkey_type2param(atype, aval,
103 EVP_PKEY_CTX_get0_libctx(pctx),
104 EVP_PKEY_CTX_get0_propq(pctx));
105 if (pkpeer == NULL)
106 goto err;
107 }
108 /* We have parameters now set public key */
109 plen = ASN1_STRING_length(pubkey);
110 p = ASN1_STRING_get0_data(pubkey);
111 if (p == NULL || plen == 0)
112 goto err;
113
114 if (EVP_PKEY_set1_encoded_public_key(pkpeer, p, plen) <= 0)
115 goto err;
116
117 if (EVP_PKEY_derive_set_peer(pctx, pkpeer) > 0)
118 rv = 1;
119 err:
120 EVP_PKEY_free(pkpeer);
121 return rv;
122 }
123
124 /* Set KDF parameters based on KDF NID */
ecdh_cms_set_kdf_param(EVP_PKEY_CTX * pctx,int eckdf_nid)125 static int ecdh_cms_set_kdf_param(EVP_PKEY_CTX *pctx, int eckdf_nid)
126 {
127 int kdf_nid, kdfmd_nid, cofactor;
128 const EVP_MD *kdf_md;
129
130 if (eckdf_nid == NID_undef)
131 return 0;
132
133 /* Lookup KDF type, cofactor mode and digest */
134 if (!OBJ_find_sigid_algs(eckdf_nid, &kdfmd_nid, &kdf_nid))
135 return 0;
136
137 if (kdf_nid == NID_dh_std_kdf)
138 cofactor = 0;
139 else if (kdf_nid == NID_dh_cofactor_kdf)
140 cofactor = 1;
141 else
142 return 0;
143
144 if (EVP_PKEY_CTX_set_ecdh_cofactor_mode(pctx, cofactor) <= 0)
145 return 0;
146
147 if (EVP_PKEY_CTX_set_ecdh_kdf_type(pctx, EVP_PKEY_ECDH_KDF_X9_63) <= 0)
148 return 0;
149
150 kdf_md = EVP_get_digestbynid(kdfmd_nid);
151 if (!kdf_md)
152 return 0;
153
154 if (EVP_PKEY_CTX_set_ecdh_kdf_md(pctx, kdf_md) <= 0)
155 return 0;
156 return 1;
157 }
158
ecdh_cms_set_shared_info(EVP_PKEY_CTX * pctx,CMS_RecipientInfo * ri)159 static int ecdh_cms_set_shared_info(EVP_PKEY_CTX *pctx, CMS_RecipientInfo *ri)
160 {
161 int rv = 0;
162 X509_ALGOR *alg, *kekalg = NULL;
163 ASN1_OCTET_STRING *ukm;
164 const unsigned char *p;
165 unsigned char *der = NULL;
166 int plen, keylen;
167 EVP_CIPHER *kekcipher = NULL;
168 EVP_CIPHER_CTX *kekctx;
169 const ASN1_OBJECT *aoid = NULL;
170 int ptype = 0;
171 const void *parameter = NULL;
172
173 char name[OSSL_MAX_NAME_SIZE];
174
175 if (!CMS_RecipientInfo_kari_get0_alg(ri, &alg, &ukm))
176 return 0;
177
178 X509_ALGOR_get0(&aoid, &ptype, ¶meter, alg);
179
180 if (!ecdh_cms_set_kdf_param(pctx, OBJ_obj2nid(aoid))) {
181 ERR_raise(ERR_LIB_CMS, CMS_R_KDF_PARAMETER_ERROR);
182 return 0;
183 }
184
185 if (ptype != V_ASN1_SEQUENCE)
186 return 0;
187
188 p = ASN1_STRING_get0_data(parameter);
189 plen = ASN1_STRING_length(parameter);
190 kekalg = d2i_X509_ALGOR(NULL, &p, plen);
191 if (kekalg == NULL)
192 goto err;
193 kekctx = CMS_RecipientInfo_kari_get0_ctx(ri);
194 if (kekctx == NULL)
195 goto err;
196 OBJ_obj2txt(name, sizeof(name), kekalg->algorithm, 0);
197 kekcipher = EVP_CIPHER_fetch(pctx->libctx, name, pctx->propquery);
198 if (kekcipher == NULL || EVP_CIPHER_get_mode(kekcipher) != EVP_CIPH_WRAP_MODE)
199 goto err;
200 if (!EVP_EncryptInit_ex(kekctx, kekcipher, NULL, NULL, NULL))
201 goto err;
202 if (EVP_CIPHER_asn1_to_param(kekctx, kekalg->parameter) <= 0)
203 goto err;
204
205 keylen = EVP_CIPHER_CTX_get_key_length(kekctx);
206 if (EVP_PKEY_CTX_set_ecdh_kdf_outlen(pctx, keylen) <= 0)
207 goto err;
208
209 plen = CMS_SharedInfo_encode(&der, kekalg, ukm, keylen);
210
211 if (plen <= 0)
212 goto err;
213
214 if (EVP_PKEY_CTX_set0_ecdh_kdf_ukm(pctx, der, plen) <= 0)
215 goto err;
216 der = NULL;
217
218 rv = 1;
219 err:
220 EVP_CIPHER_free(kekcipher);
221 X509_ALGOR_free(kekalg);
222 OPENSSL_free(der);
223 return rv;
224 }
225
ecdh_cms_decrypt(CMS_RecipientInfo * ri)226 static int ecdh_cms_decrypt(CMS_RecipientInfo *ri)
227 {
228 EVP_PKEY_CTX *pctx;
229
230 pctx = CMS_RecipientInfo_get0_pkey_ctx(ri);
231 if (pctx == NULL)
232 return 0;
233 /* See if we need to set peer key */
234 if (!EVP_PKEY_CTX_get0_peerkey(pctx)) {
235 X509_ALGOR *alg;
236 ASN1_BIT_STRING *pubkey;
237
238 if (!CMS_RecipientInfo_kari_get0_orig_id(ri, &alg, &pubkey,
239 NULL, NULL, NULL))
240 return 0;
241 if (alg == NULL || pubkey == NULL)
242 return 0;
243 if (!ecdh_cms_set_peerkey(pctx, alg, pubkey)) {
244 ERR_raise(ERR_LIB_CMS, CMS_R_PEER_KEY_ERROR);
245 return 0;
246 }
247 }
248 /* Set ECDH derivation parameters and initialise unwrap context */
249 if (!ecdh_cms_set_shared_info(pctx, ri)) {
250 ERR_raise(ERR_LIB_CMS, CMS_R_SHARED_INFO_ERROR);
251 return 0;
252 }
253 return 1;
254 }
255
ecdh_cms_encrypt(CMS_RecipientInfo * ri)256 static int ecdh_cms_encrypt(CMS_RecipientInfo *ri)
257 {
258 EVP_PKEY_CTX *pctx;
259 EVP_PKEY *pkey;
260 EVP_CIPHER_CTX *ctx;
261 int keylen;
262 X509_ALGOR *talg, *wrap_alg = NULL;
263 const ASN1_OBJECT *aoid;
264 ASN1_BIT_STRING *pubkey;
265 ASN1_STRING *wrap_str;
266 ASN1_OCTET_STRING *ukm;
267 unsigned char *penc = NULL;
268 int penclen;
269 int rv = 0;
270 int ecdh_nid, kdf_type, kdf_nid, wrap_nid;
271 const EVP_MD *kdf_md;
272
273 pctx = CMS_RecipientInfo_get0_pkey_ctx(ri);
274 if (pctx == NULL)
275 return 0;
276 /* Get ephemeral key */
277 pkey = EVP_PKEY_CTX_get0_pkey(pctx);
278 if (!CMS_RecipientInfo_kari_get0_orig_id(ri, &talg, &pubkey,
279 NULL, NULL, NULL))
280 goto err;
281 X509_ALGOR_get0(&aoid, NULL, NULL, talg);
282 /* Is everything uninitialised? */
283 if (aoid == OBJ_nid2obj(NID_undef)) {
284 /* Set the key */
285 size_t enckeylen;
286
287 enckeylen = EVP_PKEY_get1_encoded_public_key(pkey, &penc);
288 if (enckeylen > INT_MAX || enckeylen == 0)
289 goto err;
290 ASN1_STRING_set0(pubkey, penc, (int)enckeylen);
291 ossl_asn1_string_set_bits_left(pubkey, 0);
292
293 penc = NULL;
294 (void)X509_ALGOR_set0(talg, OBJ_nid2obj(NID_X9_62_id_ecPublicKey),
295 V_ASN1_UNDEF, NULL); /* cannot fail */
296 }
297
298 /* See if custom parameters set */
299 kdf_type = EVP_PKEY_CTX_get_ecdh_kdf_type(pctx);
300 if (kdf_type <= 0)
301 goto err;
302 if (EVP_PKEY_CTX_get_ecdh_kdf_md(pctx, &kdf_md) <= 0)
303 goto err;
304 ecdh_nid = EVP_PKEY_CTX_get_ecdh_cofactor_mode(pctx);
305 if (ecdh_nid < 0)
306 goto err;
307 else if (ecdh_nid == 0)
308 ecdh_nid = NID_dh_std_kdf;
309 else if (ecdh_nid == 1)
310 ecdh_nid = NID_dh_cofactor_kdf;
311
312 if (kdf_type == EVP_PKEY_ECDH_KDF_NONE) {
313 kdf_type = EVP_PKEY_ECDH_KDF_X9_63;
314 if (EVP_PKEY_CTX_set_ecdh_kdf_type(pctx, kdf_type) <= 0)
315 goto err;
316 } else
317 /* Unknown KDF */
318 goto err;
319 if (kdf_md == NULL) {
320 /* Fixme later for better MD */
321 kdf_md = EVP_sha1();
322 if (EVP_PKEY_CTX_set_ecdh_kdf_md(pctx, kdf_md) <= 0)
323 goto err;
324 }
325
326 if (!CMS_RecipientInfo_kari_get0_alg(ri, &talg, &ukm))
327 goto err;
328
329 /* Lookup NID for KDF+cofactor+digest */
330
331 if (!OBJ_find_sigid_by_algs(&kdf_nid, EVP_MD_get_type(kdf_md), ecdh_nid))
332 goto err;
333 /* Get wrap NID */
334 ctx = CMS_RecipientInfo_kari_get0_ctx(ri);
335 wrap_nid = EVP_CIPHER_CTX_get_type(ctx);
336 keylen = EVP_CIPHER_CTX_get_key_length(ctx);
337
338 /* Package wrap algorithm in an AlgorithmIdentifier */
339
340 wrap_alg = X509_ALGOR_new();
341 if (wrap_alg == NULL)
342 goto err;
343 wrap_alg->algorithm = OBJ_nid2obj(wrap_nid);
344 wrap_alg->parameter = ASN1_TYPE_new();
345 if (wrap_alg->parameter == NULL)
346 goto err;
347 if (EVP_CIPHER_param_to_asn1(ctx, wrap_alg->parameter) <= 0)
348 goto err;
349 if (ASN1_TYPE_get(wrap_alg->parameter) == NID_undef) {
350 ASN1_TYPE_free(wrap_alg->parameter);
351 wrap_alg->parameter = NULL;
352 }
353
354 if (EVP_PKEY_CTX_set_ecdh_kdf_outlen(pctx, keylen) <= 0)
355 goto err;
356
357 penclen = CMS_SharedInfo_encode(&penc, wrap_alg, ukm, keylen);
358
359 if (penclen <= 0)
360 goto err;
361
362 if (EVP_PKEY_CTX_set0_ecdh_kdf_ukm(pctx, penc, penclen) <= 0)
363 goto err;
364 penc = NULL;
365
366 /*
367 * Now need to wrap encoding of wrap AlgorithmIdentifier into parameter
368 * of another AlgorithmIdentifier.
369 */
370 penclen = i2d_X509_ALGOR(wrap_alg, &penc);
371 if (penclen <= 0)
372 goto err;
373 wrap_str = ASN1_STRING_new();
374 if (wrap_str == NULL)
375 goto err;
376 ASN1_STRING_set0(wrap_str, penc, penclen);
377 penc = NULL;
378 rv = X509_ALGOR_set0(talg, OBJ_nid2obj(kdf_nid), V_ASN1_SEQUENCE, wrap_str);
379 if (!rv)
380 ASN1_STRING_free(wrap_str);
381
382 err:
383 OPENSSL_free(penc);
384 X509_ALGOR_free(wrap_alg);
385 return rv;
386 }
387
ossl_cms_ecdh_envelope(CMS_RecipientInfo * ri,int decrypt)388 int ossl_cms_ecdh_envelope(CMS_RecipientInfo *ri, int decrypt)
389 {
390 assert(decrypt == 0 || decrypt == 1);
391
392 if (decrypt == 1)
393 return ecdh_cms_decrypt(ri);
394
395 if (decrypt == 0)
396 return ecdh_cms_encrypt(ri);
397
398 ERR_raise(ERR_LIB_CMS, CMS_R_NOT_SUPPORTED_FOR_THIS_KEY_TYPE);
399 return 0;
400 }
401