evp_pbe.c 10.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314
  1. /*
  2. * Copyright 1999-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. #include <stdio.h>
  10. #include "internal/cryptlib.h"
  11. #include <openssl/evp.h>
  12. #include <openssl/core.h>
  13. #include <openssl/core_names.h>
  14. #include <openssl/pkcs12.h>
  15. #include <openssl/x509.h>
  16. #include "crypto/evp.h"
  17. #include "evp_local.h"
  18. /* Password based encryption (PBE) functions */
  19. /* Setup a cipher context from a PBE algorithm */
  20. struct evp_pbe_st {
  21. int pbe_type;
  22. int pbe_nid;
  23. int cipher_nid;
  24. int md_nid;
  25. EVP_PBE_KEYGEN *keygen;
  26. EVP_PBE_KEYGEN_EX *keygen_ex;
  27. };
  28. static STACK_OF(EVP_PBE_CTL) *pbe_algs;
  29. static const EVP_PBE_CTL builtin_pbe[] = {
  30. {EVP_PBE_TYPE_OUTER, NID_pbeWithMD2AndDES_CBC,
  31. NID_des_cbc, NID_md2, PKCS5_PBE_keyivgen, PKCS5_PBE_keyivgen_ex},
  32. {EVP_PBE_TYPE_OUTER, NID_pbeWithMD5AndDES_CBC,
  33. NID_des_cbc, NID_md5, PKCS5_PBE_keyivgen, PKCS5_PBE_keyivgen_ex},
  34. {EVP_PBE_TYPE_OUTER, NID_pbeWithSHA1AndRC2_CBC,
  35. NID_rc2_64_cbc, NID_sha1, PKCS5_PBE_keyivgen, PKCS5_PBE_keyivgen_ex},
  36. {EVP_PBE_TYPE_OUTER, NID_id_pbkdf2, -1, -1, PKCS5_v2_PBKDF2_keyivgen,
  37. PKCS5_v2_PBKDF2_keyivgen_ex},
  38. {EVP_PBE_TYPE_OUTER, NID_pbe_WithSHA1And128BitRC4,
  39. NID_rc4, NID_sha1, PKCS12_PBE_keyivgen, &PKCS12_PBE_keyivgen_ex},
  40. {EVP_PBE_TYPE_OUTER, NID_pbe_WithSHA1And40BitRC4,
  41. NID_rc4_40, NID_sha1, PKCS12_PBE_keyivgen, &PKCS12_PBE_keyivgen_ex},
  42. {EVP_PBE_TYPE_OUTER, NID_pbe_WithSHA1And3_Key_TripleDES_CBC,
  43. NID_des_ede3_cbc, NID_sha1, PKCS12_PBE_keyivgen, &PKCS12_PBE_keyivgen_ex},
  44. {EVP_PBE_TYPE_OUTER, NID_pbe_WithSHA1And2_Key_TripleDES_CBC,
  45. NID_des_ede_cbc, NID_sha1, PKCS12_PBE_keyivgen, &PKCS12_PBE_keyivgen_ex},
  46. {EVP_PBE_TYPE_OUTER, NID_pbe_WithSHA1And128BitRC2_CBC,
  47. NID_rc2_cbc, NID_sha1, PKCS12_PBE_keyivgen, &PKCS12_PBE_keyivgen_ex},
  48. {EVP_PBE_TYPE_OUTER, NID_pbe_WithSHA1And40BitRC2_CBC,
  49. NID_rc2_40_cbc, NID_sha1, PKCS12_PBE_keyivgen, &PKCS12_PBE_keyivgen_ex},
  50. {EVP_PBE_TYPE_OUTER, NID_pbes2, -1, -1, PKCS5_v2_PBE_keyivgen, &PKCS5_v2_PBE_keyivgen_ex},
  51. {EVP_PBE_TYPE_OUTER, NID_pbeWithMD2AndRC2_CBC,
  52. NID_rc2_64_cbc, NID_md2, PKCS5_PBE_keyivgen, PKCS5_PBE_keyivgen_ex},
  53. {EVP_PBE_TYPE_OUTER, NID_pbeWithMD5AndRC2_CBC,
  54. NID_rc2_64_cbc, NID_md5, PKCS5_PBE_keyivgen, PKCS5_PBE_keyivgen_ex},
  55. {EVP_PBE_TYPE_OUTER, NID_pbeWithSHA1AndDES_CBC,
  56. NID_des_cbc, NID_sha1, PKCS5_PBE_keyivgen, PKCS5_PBE_keyivgen_ex},
  57. {EVP_PBE_TYPE_PRF, NID_hmacWithSHA1, -1, NID_sha1, 0},
  58. {EVP_PBE_TYPE_PRF, NID_hmac_md5, -1, NID_md5, 0},
  59. {EVP_PBE_TYPE_PRF, NID_hmac_sha1, -1, NID_sha1, 0},
  60. {EVP_PBE_TYPE_PRF, NID_hmacWithMD5, -1, NID_md5, 0},
  61. {EVP_PBE_TYPE_PRF, NID_hmacWithSHA224, -1, NID_sha224, 0},
  62. {EVP_PBE_TYPE_PRF, NID_hmacWithSHA256, -1, NID_sha256, 0},
  63. {EVP_PBE_TYPE_PRF, NID_hmacWithSHA384, -1, NID_sha384, 0},
  64. {EVP_PBE_TYPE_PRF, NID_hmacWithSHA512, -1, NID_sha512, 0},
  65. {EVP_PBE_TYPE_PRF, NID_id_HMACGostR3411_94, -1, NID_id_GostR3411_94, 0},
  66. {EVP_PBE_TYPE_PRF, NID_id_tc26_hmac_gost_3411_2012_256, -1,
  67. NID_id_GostR3411_2012_256, 0},
  68. {EVP_PBE_TYPE_PRF, NID_id_tc26_hmac_gost_3411_2012_512, -1,
  69. NID_id_GostR3411_2012_512, 0},
  70. {EVP_PBE_TYPE_PRF, NID_hmac_sha3_224, -1, NID_sha3_224, 0},
  71. {EVP_PBE_TYPE_PRF, NID_hmac_sha3_256, -1, NID_sha3_256, 0},
  72. {EVP_PBE_TYPE_PRF, NID_hmac_sha3_384, -1, NID_sha3_384, 0},
  73. {EVP_PBE_TYPE_PRF, NID_hmac_sha3_512, -1, NID_sha3_512, 0},
  74. {EVP_PBE_TYPE_PRF, NID_hmacWithSHA512_224, -1, NID_sha512_224, 0},
  75. {EVP_PBE_TYPE_PRF, NID_hmacWithSHA512_256, -1, NID_sha512_256, 0},
  76. #ifndef OPENSSL_NO_SM3
  77. {EVP_PBE_TYPE_PRF, NID_hmacWithSM3, -1, NID_sm3, 0},
  78. #endif
  79. {EVP_PBE_TYPE_KDF, NID_id_pbkdf2, -1, -1, PKCS5_v2_PBKDF2_keyivgen, &PKCS5_v2_PBKDF2_keyivgen_ex},
  80. #ifndef OPENSSL_NO_SCRYPT
  81. {EVP_PBE_TYPE_KDF, NID_id_scrypt, -1, -1, PKCS5_v2_scrypt_keyivgen, &PKCS5_v2_scrypt_keyivgen_ex}
  82. #endif
  83. };
  84. int EVP_PBE_CipherInit_ex(ASN1_OBJECT *pbe_obj, const char *pass, int passlen,
  85. ASN1_TYPE *param, EVP_CIPHER_CTX *ctx, int en_de,
  86. OSSL_LIB_CTX *libctx, const char *propq)
  87. {
  88. const EVP_CIPHER *cipher = NULL;
  89. EVP_CIPHER *cipher_fetch = NULL;
  90. const EVP_MD *md = NULL;
  91. EVP_MD *md_fetch = NULL;
  92. int ret = 0, cipher_nid, md_nid;
  93. EVP_PBE_KEYGEN_EX *keygen_ex;
  94. EVP_PBE_KEYGEN *keygen;
  95. if (!EVP_PBE_find_ex(EVP_PBE_TYPE_OUTER, OBJ_obj2nid(pbe_obj),
  96. &cipher_nid, &md_nid, &keygen, &keygen_ex)) {
  97. char obj_tmp[80];
  98. if (pbe_obj == NULL)
  99. OPENSSL_strlcpy(obj_tmp, "NULL", sizeof(obj_tmp));
  100. else
  101. i2t_ASN1_OBJECT(obj_tmp, sizeof(obj_tmp), pbe_obj);
  102. ERR_raise_data(ERR_LIB_EVP, EVP_R_UNKNOWN_PBE_ALGORITHM,
  103. "TYPE=%s", obj_tmp);
  104. goto err;
  105. }
  106. if (pass == NULL)
  107. passlen = 0;
  108. else if (passlen == -1)
  109. passlen = strlen(pass);
  110. if (cipher_nid != -1) {
  111. (void)ERR_set_mark();
  112. cipher = cipher_fetch = EVP_CIPHER_fetch(libctx, OBJ_nid2sn(cipher_nid), propq);
  113. /* Fallback to legacy method */
  114. if (cipher == NULL)
  115. cipher = EVP_get_cipherbynid(cipher_nid);
  116. if (cipher == NULL) {
  117. (void)ERR_clear_last_mark();
  118. ERR_raise_data(ERR_LIB_EVP, EVP_R_UNKNOWN_CIPHER,
  119. OBJ_nid2sn(cipher_nid));
  120. goto err;
  121. }
  122. (void)ERR_pop_to_mark();
  123. }
  124. if (md_nid != -1) {
  125. (void)ERR_set_mark();
  126. md = md_fetch = EVP_MD_fetch(libctx, OBJ_nid2sn(md_nid), propq);
  127. /* Fallback to legacy method */
  128. if (md == NULL)
  129. md = EVP_get_digestbynid(md_nid);
  130. if (md == NULL) {
  131. (void)ERR_clear_last_mark();
  132. ERR_raise(ERR_LIB_EVP, EVP_R_UNKNOWN_DIGEST);
  133. goto err;
  134. }
  135. (void)ERR_pop_to_mark();
  136. }
  137. /* Try extended keygen with libctx/propq first, fall back to legacy keygen */
  138. if (keygen_ex != NULL)
  139. ret = keygen_ex(ctx, pass, passlen, param, cipher, md, en_de, libctx, propq);
  140. else
  141. ret = keygen(ctx, pass, passlen, param, cipher, md, en_de);
  142. err:
  143. EVP_CIPHER_free(cipher_fetch);
  144. EVP_MD_free(md_fetch);
  145. return ret;
  146. }
  147. int EVP_PBE_CipherInit(ASN1_OBJECT *pbe_obj, const char *pass, int passlen,
  148. ASN1_TYPE *param, EVP_CIPHER_CTX *ctx, int en_de)
  149. {
  150. return EVP_PBE_CipherInit_ex(pbe_obj, pass, passlen, param, ctx, en_de, NULL, NULL);
  151. }
  152. DECLARE_OBJ_BSEARCH_CMP_FN(EVP_PBE_CTL, EVP_PBE_CTL, pbe2);
  153. static int pbe2_cmp(const EVP_PBE_CTL *pbe1, const EVP_PBE_CTL *pbe2)
  154. {
  155. int ret = pbe1->pbe_type - pbe2->pbe_type;
  156. if (ret)
  157. return ret;
  158. else
  159. return pbe1->pbe_nid - pbe2->pbe_nid;
  160. }
  161. IMPLEMENT_OBJ_BSEARCH_CMP_FN(EVP_PBE_CTL, EVP_PBE_CTL, pbe2);
  162. static int pbe_cmp(const EVP_PBE_CTL *const *a, const EVP_PBE_CTL *const *b)
  163. {
  164. int ret = (*a)->pbe_type - (*b)->pbe_type;
  165. if (ret)
  166. return ret;
  167. else
  168. return (*a)->pbe_nid - (*b)->pbe_nid;
  169. }
  170. /* Add a PBE algorithm */
  171. int EVP_PBE_alg_add_type(int pbe_type, int pbe_nid, int cipher_nid,
  172. int md_nid, EVP_PBE_KEYGEN *keygen)
  173. {
  174. EVP_PBE_CTL *pbe_tmp = NULL;
  175. if (pbe_algs == NULL) {
  176. pbe_algs = sk_EVP_PBE_CTL_new(pbe_cmp);
  177. if (pbe_algs == NULL) {
  178. ERR_raise(ERR_LIB_EVP, ERR_R_CRYPTO_LIB);
  179. goto err;
  180. }
  181. }
  182. if ((pbe_tmp = OPENSSL_zalloc(sizeof(*pbe_tmp))) == NULL)
  183. goto err;
  184. pbe_tmp->pbe_type = pbe_type;
  185. pbe_tmp->pbe_nid = pbe_nid;
  186. pbe_tmp->cipher_nid = cipher_nid;
  187. pbe_tmp->md_nid = md_nid;
  188. pbe_tmp->keygen = keygen;
  189. if (!sk_EVP_PBE_CTL_push(pbe_algs, pbe_tmp)) {
  190. ERR_raise(ERR_LIB_EVP, ERR_R_CRYPTO_LIB);
  191. goto err;
  192. }
  193. return 1;
  194. err:
  195. OPENSSL_free(pbe_tmp);
  196. return 0;
  197. }
  198. int EVP_PBE_alg_add(int nid, const EVP_CIPHER *cipher, const EVP_MD *md,
  199. EVP_PBE_KEYGEN *keygen)
  200. {
  201. int cipher_nid, md_nid;
  202. if (cipher)
  203. cipher_nid = EVP_CIPHER_get_nid(cipher);
  204. else
  205. cipher_nid = -1;
  206. if (md)
  207. md_nid = EVP_MD_get_type(md);
  208. else
  209. md_nid = -1;
  210. return EVP_PBE_alg_add_type(EVP_PBE_TYPE_OUTER, nid,
  211. cipher_nid, md_nid, keygen);
  212. }
  213. int EVP_PBE_find_ex(int type, int pbe_nid, int *pcnid, int *pmnid,
  214. EVP_PBE_KEYGEN **pkeygen, EVP_PBE_KEYGEN_EX **pkeygen_ex)
  215. {
  216. EVP_PBE_CTL *pbetmp = NULL, pbelu;
  217. int i;
  218. if (pbe_nid == NID_undef)
  219. return 0;
  220. pbelu.pbe_type = type;
  221. pbelu.pbe_nid = pbe_nid;
  222. if (pbe_algs != NULL) {
  223. /* Ideally, this would be done under lock */
  224. sk_EVP_PBE_CTL_sort(pbe_algs);
  225. i = sk_EVP_PBE_CTL_find(pbe_algs, &pbelu);
  226. pbetmp = sk_EVP_PBE_CTL_value(pbe_algs, i);
  227. }
  228. if (pbetmp == NULL) {
  229. pbetmp = OBJ_bsearch_pbe2(&pbelu, builtin_pbe, OSSL_NELEM(builtin_pbe));
  230. }
  231. if (pbetmp == NULL)
  232. return 0;
  233. if (pcnid != NULL)
  234. *pcnid = pbetmp->cipher_nid;
  235. if (pmnid != NULL)
  236. *pmnid = pbetmp->md_nid;
  237. if (pkeygen != NULL)
  238. *pkeygen = pbetmp->keygen;
  239. if (pkeygen_ex != NULL)
  240. *pkeygen_ex = pbetmp->keygen_ex;
  241. return 1;
  242. }
  243. int EVP_PBE_find(int type, int pbe_nid,
  244. int *pcnid, int *pmnid, EVP_PBE_KEYGEN **pkeygen)
  245. {
  246. return EVP_PBE_find_ex(type, pbe_nid, pcnid, pmnid, pkeygen, NULL);
  247. }
  248. static void free_evp_pbe_ctl(EVP_PBE_CTL *pbe)
  249. {
  250. OPENSSL_free(pbe);
  251. }
  252. void EVP_PBE_cleanup(void)
  253. {
  254. sk_EVP_PBE_CTL_pop_free(pbe_algs, free_evp_pbe_ctl);
  255. pbe_algs = NULL;
  256. }
  257. int EVP_PBE_get(int *ptype, int *ppbe_nid, size_t num)
  258. {
  259. const EVP_PBE_CTL *tpbe;
  260. if (num >= OSSL_NELEM(builtin_pbe))
  261. return 0;
  262. tpbe = builtin_pbe + num;
  263. if (ptype)
  264. *ptype = tpbe->pbe_type;
  265. if (ppbe_nid)
  266. *ppbe_nid = tpbe->pbe_nid;
  267. return 1;
  268. }