pem.c 14 KB

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