pem.c 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552
  1. /*
  2. * Privacy Enhanced Mail (PEM) decoding
  3. *
  4. * Copyright The Mbed TLS Contributors
  5. * SPDX-License-Identifier: Apache-2.0 OR GPL-2.0-or-later
  6. */
  7. #include "common.h"
  8. #if defined(MBEDTLS_PEM_PARSE_C) || defined(MBEDTLS_PEM_WRITE_C)
  9. #include "mbedtls/pem.h"
  10. #include "mbedtls/base64.h"
  11. #include "mbedtls/des.h"
  12. #include "mbedtls/aes.h"
  13. #include "mbedtls/md.h"
  14. #include "mbedtls/cipher.h"
  15. #include "mbedtls/platform_util.h"
  16. #include "mbedtls/error.h"
  17. #include <string.h>
  18. #include "mbedtls/platform.h"
  19. #if defined(MBEDTLS_USE_PSA_CRYPTO)
  20. #include "psa/crypto.h"
  21. #endif
  22. #if defined(MBEDTLS_MD_CAN_MD5) && \
  23. defined(MBEDTLS_CIPHER_MODE_CBC) && \
  24. (defined(MBEDTLS_DES_C) || defined(MBEDTLS_AES_C))
  25. #define PEM_RFC1421
  26. #endif /* MBEDTLS_MD_CAN_MD5 &&
  27. MBEDTLS_CIPHER_MODE_CBC &&
  28. ( MBEDTLS_AES_C || MBEDTLS_DES_C ) */
  29. #if defined(MBEDTLS_PEM_PARSE_C)
  30. void mbedtls_pem_init(mbedtls_pem_context *ctx)
  31. {
  32. memset(ctx, 0, sizeof(mbedtls_pem_context));
  33. }
  34. #if defined(PEM_RFC1421)
  35. /*
  36. * Read a 16-byte hex string and convert it to binary
  37. */
  38. static int pem_get_iv(const unsigned char *s, unsigned char *iv,
  39. size_t iv_len)
  40. {
  41. size_t i, j, k;
  42. memset(iv, 0, iv_len);
  43. for (i = 0; i < iv_len * 2; i++, s++) {
  44. if (*s >= '0' && *s <= '9') {
  45. j = *s - '0';
  46. } else
  47. if (*s >= 'A' && *s <= 'F') {
  48. j = *s - '7';
  49. } else
  50. if (*s >= 'a' && *s <= 'f') {
  51. j = *s - 'W';
  52. } else {
  53. return MBEDTLS_ERR_PEM_INVALID_ENC_IV;
  54. }
  55. k = ((i & 1) != 0) ? j : j << 4;
  56. iv[i >> 1] = (unsigned char) (iv[i >> 1] | k);
  57. }
  58. return 0;
  59. }
  60. static int pem_pbkdf1(unsigned char *key, size_t keylen,
  61. unsigned char *iv,
  62. const unsigned char *pwd, size_t pwdlen)
  63. {
  64. mbedtls_md_context_t md5_ctx;
  65. const mbedtls_md_info_t *md5_info;
  66. unsigned char md5sum[16];
  67. size_t use_len;
  68. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  69. mbedtls_md_init(&md5_ctx);
  70. /* Prepare the context. (setup() errors gracefully on NULL info.) */
  71. md5_info = mbedtls_md_info_from_type(MBEDTLS_MD_MD5);
  72. if ((ret = mbedtls_md_setup(&md5_ctx, md5_info, 0)) != 0) {
  73. goto exit;
  74. }
  75. /*
  76. * key[ 0..15] = MD5(pwd || IV)
  77. */
  78. if ((ret = mbedtls_md_starts(&md5_ctx)) != 0) {
  79. goto exit;
  80. }
  81. if ((ret = mbedtls_md_update(&md5_ctx, pwd, pwdlen)) != 0) {
  82. goto exit;
  83. }
  84. if ((ret = mbedtls_md_update(&md5_ctx, iv, 8)) != 0) {
  85. goto exit;
  86. }
  87. if ((ret = mbedtls_md_finish(&md5_ctx, md5sum)) != 0) {
  88. goto exit;
  89. }
  90. if (keylen <= 16) {
  91. memcpy(key, md5sum, keylen);
  92. goto exit;
  93. }
  94. memcpy(key, md5sum, 16);
  95. /*
  96. * key[16..23] = MD5(key[ 0..15] || pwd || IV])
  97. */
  98. if ((ret = mbedtls_md_starts(&md5_ctx)) != 0) {
  99. goto exit;
  100. }
  101. if ((ret = mbedtls_md_update(&md5_ctx, md5sum, 16)) != 0) {
  102. goto exit;
  103. }
  104. if ((ret = mbedtls_md_update(&md5_ctx, pwd, pwdlen)) != 0) {
  105. goto exit;
  106. }
  107. if ((ret = mbedtls_md_update(&md5_ctx, iv, 8)) != 0) {
  108. goto exit;
  109. }
  110. if ((ret = mbedtls_md_finish(&md5_ctx, md5sum)) != 0) {
  111. goto exit;
  112. }
  113. use_len = 16;
  114. if (keylen < 32) {
  115. use_len = keylen - 16;
  116. }
  117. memcpy(key + 16, md5sum, use_len);
  118. exit:
  119. mbedtls_md_free(&md5_ctx);
  120. mbedtls_platform_zeroize(md5sum, 16);
  121. return ret;
  122. }
  123. #if defined(MBEDTLS_DES_C)
  124. /*
  125. * Decrypt with DES-CBC, using PBKDF1 for key derivation
  126. */
  127. static int pem_des_decrypt(unsigned char des_iv[8],
  128. unsigned char *buf, size_t buflen,
  129. const unsigned char *pwd, size_t pwdlen)
  130. {
  131. mbedtls_des_context des_ctx;
  132. unsigned char des_key[8];
  133. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  134. mbedtls_des_init(&des_ctx);
  135. if ((ret = pem_pbkdf1(des_key, 8, des_iv, pwd, pwdlen)) != 0) {
  136. goto exit;
  137. }
  138. if ((ret = mbedtls_des_setkey_dec(&des_ctx, des_key)) != 0) {
  139. goto exit;
  140. }
  141. ret = mbedtls_des_crypt_cbc(&des_ctx, MBEDTLS_DES_DECRYPT, buflen,
  142. des_iv, buf, buf);
  143. exit:
  144. mbedtls_des_free(&des_ctx);
  145. mbedtls_platform_zeroize(des_key, 8);
  146. return ret;
  147. }
  148. /*
  149. * Decrypt with 3DES-CBC, using PBKDF1 for key derivation
  150. */
  151. static int pem_des3_decrypt(unsigned char des3_iv[8],
  152. unsigned char *buf, size_t buflen,
  153. const unsigned char *pwd, size_t pwdlen)
  154. {
  155. mbedtls_des3_context des3_ctx;
  156. unsigned char des3_key[24];
  157. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  158. mbedtls_des3_init(&des3_ctx);
  159. if ((ret = pem_pbkdf1(des3_key, 24, des3_iv, pwd, pwdlen)) != 0) {
  160. goto exit;
  161. }
  162. if ((ret = mbedtls_des3_set3key_dec(&des3_ctx, des3_key)) != 0) {
  163. goto exit;
  164. }
  165. ret = mbedtls_des3_crypt_cbc(&des3_ctx, MBEDTLS_DES_DECRYPT, buflen,
  166. des3_iv, buf, buf);
  167. exit:
  168. mbedtls_des3_free(&des3_ctx);
  169. mbedtls_platform_zeroize(des3_key, 24);
  170. return ret;
  171. }
  172. #endif /* MBEDTLS_DES_C */
  173. #if defined(MBEDTLS_AES_C)
  174. /*
  175. * Decrypt with AES-XXX-CBC, using PBKDF1 for key derivation
  176. */
  177. static int pem_aes_decrypt(unsigned char aes_iv[16], unsigned int keylen,
  178. unsigned char *buf, size_t buflen,
  179. const unsigned char *pwd, size_t pwdlen)
  180. {
  181. mbedtls_aes_context aes_ctx;
  182. unsigned char aes_key[32];
  183. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  184. mbedtls_aes_init(&aes_ctx);
  185. if ((ret = pem_pbkdf1(aes_key, keylen, aes_iv, pwd, pwdlen)) != 0) {
  186. goto exit;
  187. }
  188. if ((ret = mbedtls_aes_setkey_dec(&aes_ctx, aes_key, keylen * 8)) != 0) {
  189. goto exit;
  190. }
  191. ret = mbedtls_aes_crypt_cbc(&aes_ctx, MBEDTLS_AES_DECRYPT, buflen,
  192. aes_iv, buf, buf);
  193. exit:
  194. mbedtls_aes_free(&aes_ctx);
  195. mbedtls_platform_zeroize(aes_key, keylen);
  196. return ret;
  197. }
  198. #endif /* MBEDTLS_AES_C */
  199. #if defined(MBEDTLS_DES_C) || defined(MBEDTLS_AES_C)
  200. static int pem_check_pkcs_padding(unsigned char *input, size_t input_len, size_t *data_len)
  201. {
  202. /* input_len > 0 is guaranteed by mbedtls_pem_read_buffer(). */
  203. size_t pad_len = input[input_len - 1];
  204. size_t i;
  205. if (pad_len > input_len) {
  206. return MBEDTLS_ERR_PEM_PASSWORD_MISMATCH;
  207. }
  208. *data_len = input_len - pad_len;
  209. for (i = *data_len; i < input_len; i++) {
  210. if (input[i] != pad_len) {
  211. return MBEDTLS_ERR_PEM_PASSWORD_MISMATCH;
  212. }
  213. }
  214. return 0;
  215. }
  216. #endif /* MBEDTLS_DES_C || MBEDTLS_AES_C */
  217. #endif /* PEM_RFC1421 */
  218. int mbedtls_pem_read_buffer(mbedtls_pem_context *ctx, const char *header, const char *footer,
  219. const unsigned char *data, const unsigned char *pwd,
  220. size_t pwdlen, size_t *use_len)
  221. {
  222. int ret, enc;
  223. size_t len;
  224. unsigned char *buf;
  225. const unsigned char *s1, *s2, *end;
  226. #if defined(PEM_RFC1421)
  227. unsigned char pem_iv[16];
  228. mbedtls_cipher_type_t enc_alg = MBEDTLS_CIPHER_NONE;
  229. #else
  230. ((void) pwd);
  231. ((void) pwdlen);
  232. #endif /* PEM_RFC1421 */
  233. if (ctx == NULL) {
  234. return MBEDTLS_ERR_PEM_BAD_INPUT_DATA;
  235. }
  236. s1 = (unsigned char *) strstr((const char *) data, header);
  237. if (s1 == NULL) {
  238. return MBEDTLS_ERR_PEM_NO_HEADER_FOOTER_PRESENT;
  239. }
  240. s2 = (unsigned char *) strstr((const char *) data, footer);
  241. if (s2 == NULL || s2 <= s1) {
  242. return MBEDTLS_ERR_PEM_NO_HEADER_FOOTER_PRESENT;
  243. }
  244. s1 += strlen(header);
  245. if (*s1 == ' ') {
  246. s1++;
  247. }
  248. if (*s1 == '\r') {
  249. s1++;
  250. }
  251. if (*s1 == '\n') {
  252. s1++;
  253. } else {
  254. return MBEDTLS_ERR_PEM_NO_HEADER_FOOTER_PRESENT;
  255. }
  256. end = s2;
  257. end += strlen(footer);
  258. if (*end == ' ') {
  259. end++;
  260. }
  261. if (*end == '\r') {
  262. end++;
  263. }
  264. if (*end == '\n') {
  265. end++;
  266. }
  267. *use_len = (size_t) (end - data);
  268. enc = 0;
  269. if (s2 - s1 >= 22 && memcmp(s1, "Proc-Type: 4,ENCRYPTED", 22) == 0) {
  270. #if defined(PEM_RFC1421)
  271. enc++;
  272. s1 += 22;
  273. if (*s1 == '\r') {
  274. s1++;
  275. }
  276. if (*s1 == '\n') {
  277. s1++;
  278. } else {
  279. return MBEDTLS_ERR_PEM_INVALID_DATA;
  280. }
  281. #if defined(MBEDTLS_DES_C)
  282. if (s2 - s1 >= 23 && memcmp(s1, "DEK-Info: DES-EDE3-CBC,", 23) == 0) {
  283. enc_alg = MBEDTLS_CIPHER_DES_EDE3_CBC;
  284. s1 += 23;
  285. if (s2 - s1 < 16 || pem_get_iv(s1, pem_iv, 8) != 0) {
  286. return MBEDTLS_ERR_PEM_INVALID_ENC_IV;
  287. }
  288. s1 += 16;
  289. } else if (s2 - s1 >= 18 && memcmp(s1, "DEK-Info: DES-CBC,", 18) == 0) {
  290. enc_alg = MBEDTLS_CIPHER_DES_CBC;
  291. s1 += 18;
  292. if (s2 - s1 < 16 || pem_get_iv(s1, pem_iv, 8) != 0) {
  293. return MBEDTLS_ERR_PEM_INVALID_ENC_IV;
  294. }
  295. s1 += 16;
  296. }
  297. #endif /* MBEDTLS_DES_C */
  298. #if defined(MBEDTLS_AES_C)
  299. if (s2 - s1 >= 14 && memcmp(s1, "DEK-Info: AES-", 14) == 0) {
  300. if (s2 - s1 < 22) {
  301. return MBEDTLS_ERR_PEM_UNKNOWN_ENC_ALG;
  302. } else if (memcmp(s1, "DEK-Info: AES-128-CBC,", 22) == 0) {
  303. enc_alg = MBEDTLS_CIPHER_AES_128_CBC;
  304. } else if (memcmp(s1, "DEK-Info: AES-192-CBC,", 22) == 0) {
  305. enc_alg = MBEDTLS_CIPHER_AES_192_CBC;
  306. } else if (memcmp(s1, "DEK-Info: AES-256-CBC,", 22) == 0) {
  307. enc_alg = MBEDTLS_CIPHER_AES_256_CBC;
  308. } else {
  309. return MBEDTLS_ERR_PEM_UNKNOWN_ENC_ALG;
  310. }
  311. s1 += 22;
  312. if (s2 - s1 < 32 || pem_get_iv(s1, pem_iv, 16) != 0) {
  313. return MBEDTLS_ERR_PEM_INVALID_ENC_IV;
  314. }
  315. s1 += 32;
  316. }
  317. #endif /* MBEDTLS_AES_C */
  318. if (enc_alg == MBEDTLS_CIPHER_NONE) {
  319. return MBEDTLS_ERR_PEM_UNKNOWN_ENC_ALG;
  320. }
  321. if (*s1 == '\r') {
  322. s1++;
  323. }
  324. if (*s1 == '\n') {
  325. s1++;
  326. } else {
  327. return MBEDTLS_ERR_PEM_INVALID_DATA;
  328. }
  329. #else
  330. return MBEDTLS_ERR_PEM_FEATURE_UNAVAILABLE;
  331. #endif /* PEM_RFC1421 */
  332. }
  333. if (s1 >= s2) {
  334. return MBEDTLS_ERR_PEM_INVALID_DATA;
  335. }
  336. ret = mbedtls_base64_decode(NULL, 0, &len, s1, (size_t) (s2 - s1));
  337. if (ret == MBEDTLS_ERR_BASE64_INVALID_CHARACTER) {
  338. return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_PEM_INVALID_DATA, ret);
  339. }
  340. if (len == 0) {
  341. return MBEDTLS_ERR_PEM_BAD_INPUT_DATA;
  342. }
  343. if ((buf = mbedtls_calloc(1, len)) == NULL) {
  344. return MBEDTLS_ERR_PEM_ALLOC_FAILED;
  345. }
  346. if ((ret = mbedtls_base64_decode(buf, len, &len, s1, (size_t) (s2 - s1))) != 0) {
  347. mbedtls_zeroize_and_free(buf, len);
  348. return MBEDTLS_ERROR_ADD(MBEDTLS_ERR_PEM_INVALID_DATA, ret);
  349. }
  350. if (enc != 0) {
  351. #if defined(PEM_RFC1421)
  352. if (pwd == NULL) {
  353. mbedtls_zeroize_and_free(buf, len);
  354. return MBEDTLS_ERR_PEM_PASSWORD_REQUIRED;
  355. }
  356. ret = 0;
  357. #if defined(MBEDTLS_DES_C)
  358. if (enc_alg == MBEDTLS_CIPHER_DES_EDE3_CBC) {
  359. ret = pem_des3_decrypt(pem_iv, buf, len, pwd, pwdlen);
  360. } else if (enc_alg == MBEDTLS_CIPHER_DES_CBC) {
  361. ret = pem_des_decrypt(pem_iv, buf, len, pwd, pwdlen);
  362. }
  363. #endif /* MBEDTLS_DES_C */
  364. #if defined(MBEDTLS_AES_C)
  365. if (enc_alg == MBEDTLS_CIPHER_AES_128_CBC) {
  366. ret = pem_aes_decrypt(pem_iv, 16, buf, len, pwd, pwdlen);
  367. } else if (enc_alg == MBEDTLS_CIPHER_AES_192_CBC) {
  368. ret = pem_aes_decrypt(pem_iv, 24, buf, len, pwd, pwdlen);
  369. } else if (enc_alg == MBEDTLS_CIPHER_AES_256_CBC) {
  370. ret = pem_aes_decrypt(pem_iv, 32, buf, len, pwd, pwdlen);
  371. }
  372. #endif /* MBEDTLS_AES_C */
  373. if (ret != 0) {
  374. mbedtls_zeroize_and_free(buf, len);
  375. return ret;
  376. }
  377. /* Check PKCS padding and update data length based on padding info.
  378. * This can be used to detect invalid padding data and password
  379. * mismatches. */
  380. size_t unpadded_len;
  381. ret = pem_check_pkcs_padding(buf, len, &unpadded_len);
  382. if (ret != 0) {
  383. mbedtls_zeroize_and_free(buf, len);
  384. return ret;
  385. }
  386. len = unpadded_len;
  387. #else
  388. mbedtls_zeroize_and_free(buf, len);
  389. return MBEDTLS_ERR_PEM_FEATURE_UNAVAILABLE;
  390. #endif /* PEM_RFC1421 */
  391. }
  392. ctx->buf = buf;
  393. ctx->buflen = len;
  394. return 0;
  395. }
  396. void mbedtls_pem_free(mbedtls_pem_context *ctx)
  397. {
  398. if (ctx == NULL) {
  399. return;
  400. }
  401. if (ctx->buf != NULL) {
  402. mbedtls_zeroize_and_free(ctx->buf, ctx->buflen);
  403. }
  404. mbedtls_free(ctx->info);
  405. mbedtls_platform_zeroize(ctx, sizeof(mbedtls_pem_context));
  406. }
  407. #endif /* MBEDTLS_PEM_PARSE_C */
  408. #if defined(MBEDTLS_PEM_WRITE_C)
  409. int mbedtls_pem_write_buffer(const char *header, const char *footer,
  410. const unsigned char *der_data, size_t der_len,
  411. unsigned char *buf, size_t buf_len, size_t *olen)
  412. {
  413. int ret = MBEDTLS_ERR_ERROR_CORRUPTION_DETECTED;
  414. unsigned char *encode_buf = NULL, *c, *p = buf;
  415. size_t len = 0, use_len, add_len = 0;
  416. mbedtls_base64_encode(NULL, 0, &use_len, der_data, der_len);
  417. add_len = strlen(header) + strlen(footer) + (((use_len > 2) ? (use_len - 2) : 0) / 64) + 1;
  418. if (use_len + add_len > buf_len) {
  419. *olen = use_len + add_len;
  420. return MBEDTLS_ERR_BASE64_BUFFER_TOO_SMALL;
  421. }
  422. if (use_len != 0 &&
  423. ((encode_buf = mbedtls_calloc(1, use_len)) == NULL)) {
  424. return MBEDTLS_ERR_PEM_ALLOC_FAILED;
  425. }
  426. if ((ret = mbedtls_base64_encode(encode_buf, use_len, &use_len, der_data,
  427. der_len)) != 0) {
  428. mbedtls_free(encode_buf);
  429. return ret;
  430. }
  431. memcpy(p, header, strlen(header));
  432. p += strlen(header);
  433. c = encode_buf;
  434. while (use_len) {
  435. len = (use_len > 64) ? 64 : use_len;
  436. memcpy(p, c, len);
  437. use_len -= len;
  438. p += len;
  439. c += len;
  440. *p++ = '\n';
  441. }
  442. memcpy(p, footer, strlen(footer));
  443. p += strlen(footer);
  444. *p++ = '\0';
  445. *olen = (size_t) (p - buf);
  446. /* Clean any remaining data previously written to the buffer */
  447. memset(buf + *olen, 0, buf_len - *olen);
  448. mbedtls_free(encode_buf);
  449. return 0;
  450. }
  451. #endif /* MBEDTLS_PEM_WRITE_C */
  452. #endif /* MBEDTLS_PEM_PARSE_C || MBEDTLS_PEM_WRITE_C */