pkcs12.h 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344
  1. /* $OpenBSD: pkcs12.h,v 1.27 2022/09/11 17:30:13 tb Exp $ */
  2. /* Written by Dr Stephen N Henson ([email protected]) for the OpenSSL
  3. * project 1999.
  4. */
  5. /* ====================================================================
  6. * Copyright (c) 1999 The OpenSSL Project. All rights reserved.
  7. *
  8. * Redistribution and use in source and binary forms, with or without
  9. * modification, are permitted provided that the following conditions
  10. * are met:
  11. *
  12. * 1. Redistributions of source code must retain the above copyright
  13. * notice, this list of conditions and the following disclaimer.
  14. *
  15. * 2. Redistributions in binary form must reproduce the above copyright
  16. * notice, this list of conditions and the following disclaimer in
  17. * the documentation and/or other materials provided with the
  18. * distribution.
  19. *
  20. * 3. All advertising materials mentioning features or use of this
  21. * software must display the following acknowledgment:
  22. * "This product includes software developed by the OpenSSL Project
  23. * for use in the OpenSSL Toolkit. (http://www.OpenSSL.org/)"
  24. *
  25. * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
  26. * endorse or promote products derived from this software without
  27. * prior written permission. For written permission, please contact
  28. * [email protected].
  29. *
  30. * 5. Products derived from this software may not be called "OpenSSL"
  31. * nor may "OpenSSL" appear in their names without prior written
  32. * permission of the OpenSSL Project.
  33. *
  34. * 6. Redistributions of any form whatsoever must retain the following
  35. * acknowledgment:
  36. * "This product includes software developed by the OpenSSL Project
  37. * for use in the OpenSSL Toolkit (http://www.OpenSSL.org/)"
  38. *
  39. * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
  40. * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  41. * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  42. * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
  43. * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  44. * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  45. * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
  46. * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  47. * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
  48. * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  49. * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
  50. * OF THE POSSIBILITY OF SUCH DAMAGE.
  51. * ====================================================================
  52. *
  53. * This product includes cryptographic software written by Eric Young
  54. * ([email protected]). This product includes software written by Tim
  55. * Hudson ([email protected]).
  56. *
  57. */
  58. #ifndef HEADER_PKCS12_H
  59. #define HEADER_PKCS12_H
  60. #include <openssl/bio.h>
  61. #include <openssl/x509.h>
  62. #ifdef __cplusplus
  63. extern "C" {
  64. #endif
  65. #define PKCS12_KEY_ID 1
  66. #define PKCS12_IV_ID 2
  67. #define PKCS12_MAC_ID 3
  68. /* Default iteration count */
  69. #ifndef PKCS12_DEFAULT_ITER
  70. #define PKCS12_DEFAULT_ITER PKCS5_DEFAULT_ITER
  71. #endif
  72. #define PKCS12_MAC_KEY_LENGTH 20
  73. #define PKCS12_SALT_LEN 8
  74. /* Uncomment out next line for unicode password and names, otherwise ASCII */
  75. /*#define PBE_UNICODE*/
  76. #ifdef PBE_UNICODE
  77. #define PKCS12_key_gen PKCS12_key_gen_uni
  78. #define PKCS12_add_friendlyname PKCS12_add_friendlyname_uni
  79. #else
  80. #define PKCS12_key_gen PKCS12_key_gen_asc
  81. #define PKCS12_add_friendlyname PKCS12_add_friendlyname_asc
  82. #endif
  83. /* MS key usage constants */
  84. #define KEY_EX 0x10
  85. #define KEY_SIG 0x80
  86. typedef struct PKCS12_MAC_DATA_st PKCS12_MAC_DATA;
  87. typedef struct PKCS12_st PKCS12;
  88. typedef struct PKCS12_SAFEBAG_st PKCS12_SAFEBAG;
  89. DECLARE_STACK_OF(PKCS12_SAFEBAG)
  90. DECLARE_PKCS12_STACK_OF(PKCS12_SAFEBAG)
  91. typedef struct pkcs12_bag_st PKCS12_BAGS;
  92. #define PKCS12_ERROR 0
  93. #define PKCS12_OK 1
  94. #ifndef LIBRESSL_INTERNAL
  95. /* Compatibility macros */
  96. #define M_PKCS12_x5092certbag PKCS12_x5092certbag
  97. #define M_PKCS12_x509crl2certbag PKCS12_x509crl2certbag
  98. #define M_PKCS12_certbag2x509 PKCS12_certbag2x509
  99. #define M_PKCS12_certbag2x509crl PKCS12_certbag2x509crl
  100. #define M_PKCS12_unpack_p7data PKCS12_unpack_p7data
  101. #define M_PKCS12_pack_authsafes PKCS12_pack_authsafes
  102. #define M_PKCS12_unpack_authsafes PKCS12_unpack_authsafes
  103. #define M_PKCS12_unpack_p7encdata PKCS12_unpack_p7encdata
  104. #define M_PKCS12_decrypt_skey PKCS12_decrypt_skey
  105. #define M_PKCS8_decrypt PKCS8_decrypt
  106. #endif /* !LIBRESSL_INTERNAL */
  107. #define M_PKCS12_bag_type PKCS12_bag_type
  108. #define M_PKCS12_cert_bag_type PKCS12_cert_bag_type
  109. #define M_PKCS12_crl_bag_type PKCS12_cert_bag_type
  110. #define PKCS12_bag_type PKCS12_SAFEBAG_get_nid
  111. #define PKCS12_cert_bag_type PKCS12_SAFEBAG_get_bag_nid
  112. #define PKCS12_certbag2x509 PKCS12_SAFEBAG_get1_cert
  113. #define PKCS12_certbag2x509crl PKCS12_SAFEBAG_get1_crl
  114. #define PKCS12_x5092certbag PKCS12_SAFEBAG_create_cert
  115. #define PKCS12_x509crl2certbag PKCS12_SAFEBAG_create_crl
  116. #define PKCS12_MAKE_KEYBAG PKCS12_SAFEBAG_create0_p8inf
  117. #define PKCS12_MAKE_SHKEYBAG PKCS12_SAFEBAG_create_pkcs8_encrypt
  118. const ASN1_TYPE *PKCS12_SAFEBAG_get0_attr(const PKCS12_SAFEBAG *bag,
  119. int attr_nid);
  120. const STACK_OF(X509_ATTRIBUTE) *
  121. PKCS12_SAFEBAG_get0_attrs(const PKCS12_SAFEBAG *bag);
  122. int PKCS12_SAFEBAG_get_nid(const PKCS12_SAFEBAG *bag);
  123. int PKCS12_SAFEBAG_get_bag_nid(const PKCS12_SAFEBAG *bag);
  124. X509 *PKCS12_SAFEBAG_get1_cert(const PKCS12_SAFEBAG *bag);
  125. X509_CRL *PKCS12_SAFEBAG_get1_crl(const PKCS12_SAFEBAG *bag);
  126. ASN1_TYPE *PKCS8_get_attr(PKCS8_PRIV_KEY_INFO *p8, int attr_nid);
  127. int PKCS12_mac_present(const PKCS12 *p12);
  128. void PKCS12_get0_mac(const ASN1_OCTET_STRING **pmac, const X509_ALGOR **pmacalg,
  129. const ASN1_OCTET_STRING **psalt, const ASN1_INTEGER **piter,
  130. const PKCS12 *p12);
  131. PKCS12_SAFEBAG *PKCS12_SAFEBAG_create_cert(X509 *x509);
  132. PKCS12_SAFEBAG *PKCS12_SAFEBAG_create_crl(X509_CRL *crl);
  133. PKCS12_SAFEBAG *PKCS12_SAFEBAG_create0_p8inf(PKCS8_PRIV_KEY_INFO *p8);
  134. PKCS12_SAFEBAG *PKCS12_SAFEBAG_create0_pkcs8(X509_SIG *p8);
  135. PKCS12_SAFEBAG *PKCS12_SAFEBAG_create_pkcs8_encrypt(int pbe_nid,
  136. const char *pass, int passlen, unsigned char *salt, int saltlen, int iter,
  137. PKCS8_PRIV_KEY_INFO *p8);
  138. const PKCS8_PRIV_KEY_INFO *PKCS12_SAFEBAG_get0_p8inf(const PKCS12_SAFEBAG *bag);
  139. const X509_SIG *PKCS12_SAFEBAG_get0_pkcs8(const PKCS12_SAFEBAG *bag);
  140. const STACK_OF(PKCS12_SAFEBAG) *
  141. PKCS12_SAFEBAG_get0_safes(const PKCS12_SAFEBAG *bag);
  142. const ASN1_OBJECT *PKCS12_SAFEBAG_get0_type(const PKCS12_SAFEBAG *bag);
  143. PKCS12_SAFEBAG *PKCS12_item_pack_safebag(void *obj, const ASN1_ITEM *it,
  144. int nid1, int nid2);
  145. PKCS8_PRIV_KEY_INFO *PKCS8_decrypt(const X509_SIG *p8, const char *pass,
  146. int passlen);
  147. PKCS8_PRIV_KEY_INFO *PKCS12_decrypt_skey(const PKCS12_SAFEBAG *bag,
  148. const char *pass, int passlen);
  149. X509_SIG *PKCS8_encrypt(int pbe_nid, const EVP_CIPHER *cipher,
  150. const char *pass, int passlen, unsigned char *salt, int saltlen, int iter,
  151. PKCS8_PRIV_KEY_INFO *p8);
  152. PKCS7 *PKCS12_pack_p7data(STACK_OF(PKCS12_SAFEBAG) *sk);
  153. STACK_OF(PKCS12_SAFEBAG) *PKCS12_unpack_p7data(PKCS7 *p7);
  154. PKCS7 *PKCS12_pack_p7encdata(int pbe_nid, const char *pass, int passlen,
  155. unsigned char *salt, int saltlen, int iter, STACK_OF(PKCS12_SAFEBAG) *bags);
  156. STACK_OF(PKCS12_SAFEBAG) *PKCS12_unpack_p7encdata(PKCS7 *p7, const char *pass,
  157. int passlen);
  158. int PKCS12_pack_authsafes(PKCS12 *p12, STACK_OF(PKCS7) *safes);
  159. STACK_OF(PKCS7) *PKCS12_unpack_authsafes(const PKCS12 *p12);
  160. int PKCS12_add_localkeyid(PKCS12_SAFEBAG *bag, unsigned char *name,
  161. int namelen);
  162. int PKCS12_add_friendlyname_asc(PKCS12_SAFEBAG *bag, const char *name,
  163. int namelen);
  164. int PKCS12_add_CSPName_asc(PKCS12_SAFEBAG *bag, const char *name,
  165. int namelen);
  166. int PKCS12_add_friendlyname_uni(PKCS12_SAFEBAG *bag, const unsigned char *name,
  167. int namelen);
  168. int PKCS8_add_keyusage(PKCS8_PRIV_KEY_INFO *p8, int usage);
  169. ASN1_TYPE *PKCS12_get_attr_gen(const STACK_OF(X509_ATTRIBUTE) *attrs,
  170. int attr_nid);
  171. char *PKCS12_get_friendlyname(PKCS12_SAFEBAG *bag);
  172. unsigned char *PKCS12_pbe_crypt(const X509_ALGOR *algor, const char *pass,
  173. int passlen, const unsigned char *in, int inlen, unsigned char **data,
  174. int *datalen, int en_de);
  175. void *PKCS12_item_decrypt_d2i(const X509_ALGOR *algor, const ASN1_ITEM *it,
  176. const char *pass, int passlen, const ASN1_OCTET_STRING *oct, int zbuf);
  177. ASN1_OCTET_STRING *PKCS12_item_i2d_encrypt(X509_ALGOR *algor,
  178. const ASN1_ITEM *it, const char *pass, int passlen, void *obj, int zbuf);
  179. PKCS12 *PKCS12_init(int mode);
  180. int PKCS12_key_gen_asc(const char *pass, int passlen, unsigned char *salt,
  181. int saltlen, int id, int iter, int n, unsigned char *out,
  182. const EVP_MD *md_type);
  183. int PKCS12_key_gen_uni(unsigned char *pass, int passlen, unsigned char *salt,
  184. int saltlen, int id, int iter, int n, unsigned char *out,
  185. const EVP_MD *md_type);
  186. int PKCS12_PBE_keyivgen(EVP_CIPHER_CTX *ctx, const char *pass, int passlen,
  187. ASN1_TYPE *param, const EVP_CIPHER *cipher, const EVP_MD *md_type,
  188. int en_de);
  189. int PKCS12_gen_mac(PKCS12 *p12, const char *pass, int passlen,
  190. unsigned char *mac, unsigned int *maclen);
  191. int PKCS12_verify_mac(PKCS12 *p12, const char *pass, int passlen);
  192. int PKCS12_set_mac(PKCS12 *p12, const char *pass, int passlen,
  193. unsigned char *salt, int saltlen, int iter,
  194. const EVP_MD *md_type);
  195. int PKCS12_setup_mac(PKCS12 *p12, int iter, unsigned char *salt,
  196. int saltlen, const EVP_MD *md_type);
  197. unsigned char *OPENSSL_asc2uni(const char *asc, int asclen,
  198. unsigned char **uni, int *unilen);
  199. char *OPENSSL_uni2asc(const unsigned char *uni, int unilen);
  200. PKCS12 *PKCS12_new(void);
  201. void PKCS12_free(PKCS12 *a);
  202. PKCS12 *d2i_PKCS12(PKCS12 **a, const unsigned char **in, long len);
  203. int i2d_PKCS12(PKCS12 *a, unsigned char **out);
  204. extern const ASN1_ITEM PKCS12_it;
  205. PKCS12_MAC_DATA *PKCS12_MAC_DATA_new(void);
  206. void PKCS12_MAC_DATA_free(PKCS12_MAC_DATA *a);
  207. PKCS12_MAC_DATA *d2i_PKCS12_MAC_DATA(PKCS12_MAC_DATA **a, const unsigned char **in, long len);
  208. int i2d_PKCS12_MAC_DATA(PKCS12_MAC_DATA *a, unsigned char **out);
  209. extern const ASN1_ITEM PKCS12_MAC_DATA_it;
  210. PKCS12_SAFEBAG *PKCS12_SAFEBAG_new(void);
  211. void PKCS12_SAFEBAG_free(PKCS12_SAFEBAG *a);
  212. PKCS12_SAFEBAG *d2i_PKCS12_SAFEBAG(PKCS12_SAFEBAG **a, const unsigned char **in, long len);
  213. int i2d_PKCS12_SAFEBAG(PKCS12_SAFEBAG *a, unsigned char **out);
  214. extern const ASN1_ITEM PKCS12_SAFEBAG_it;
  215. PKCS12_BAGS *PKCS12_BAGS_new(void);
  216. void PKCS12_BAGS_free(PKCS12_BAGS *a);
  217. PKCS12_BAGS *d2i_PKCS12_BAGS(PKCS12_BAGS **a, const unsigned char **in, long len);
  218. int i2d_PKCS12_BAGS(PKCS12_BAGS *a, unsigned char **out);
  219. extern const ASN1_ITEM PKCS12_BAGS_it;
  220. extern const ASN1_ITEM PKCS12_SAFEBAGS_it;
  221. extern const ASN1_ITEM PKCS12_AUTHSAFES_it;
  222. void PKCS12_PBE_add(void);
  223. int PKCS12_parse(PKCS12 *p12, const char *pass, EVP_PKEY **pkey, X509 **cert,
  224. STACK_OF(X509) **ca);
  225. PKCS12 *PKCS12_create(const char *pass, const char *name, EVP_PKEY *pkey,
  226. X509 *cert, STACK_OF(X509) *ca, int nid_key, int nid_cert, int iter,
  227. int mac_iter, int keytype);
  228. PKCS12_SAFEBAG *PKCS12_add_cert(STACK_OF(PKCS12_SAFEBAG) **pbags, X509 *cert);
  229. PKCS12_SAFEBAG *PKCS12_add_key(STACK_OF(PKCS12_SAFEBAG) **pbags, EVP_PKEY *key,
  230. int key_usage, int iter, int key_nid, const char *pass);
  231. int PKCS12_add_safe(STACK_OF(PKCS7) **psafes, STACK_OF(PKCS12_SAFEBAG) *bags,
  232. int safe_nid, int iter, const char *pass);
  233. PKCS12 *PKCS12_add_safes(STACK_OF(PKCS7) *safes, int p7_nid);
  234. int i2d_PKCS12_bio(BIO *bp, PKCS12 *p12);
  235. int i2d_PKCS12_fp(FILE *fp, PKCS12 *p12);
  236. PKCS12 *d2i_PKCS12_bio(BIO *bp, PKCS12 **p12);
  237. PKCS12 *d2i_PKCS12_fp(FILE *fp, PKCS12 **p12);
  238. int PKCS12_newpass(PKCS12 *p12, const char *oldpass, const char *newpass);
  239. void ERR_load_PKCS12_strings(void);
  240. /* Error codes for the PKCS12 functions. */
  241. /* Function codes. */
  242. #define PKCS12_F_PARSE_BAG 129
  243. #define PKCS12_F_PARSE_BAGS 103
  244. #define PKCS12_F_PKCS12_ADD_FRIENDLYNAME 100
  245. #define PKCS12_F_PKCS12_ADD_FRIENDLYNAME_ASC 127
  246. #define PKCS12_F_PKCS12_ADD_FRIENDLYNAME_UNI 102
  247. #define PKCS12_F_PKCS12_ADD_LOCALKEYID 104
  248. #define PKCS12_F_PKCS12_CREATE 105
  249. #define PKCS12_F_PKCS12_GEN_MAC 107
  250. #define PKCS12_F_PKCS12_INIT 109
  251. #define PKCS12_F_PKCS12_ITEM_DECRYPT_D2I 106
  252. #define PKCS12_F_PKCS12_ITEM_I2D_ENCRYPT 108
  253. #define PKCS12_F_PKCS12_ITEM_PACK_SAFEBAG 117
  254. #define PKCS12_F_PKCS12_KEY_GEN_ASC 110
  255. #define PKCS12_F_PKCS12_KEY_GEN_UNI 111
  256. #define PKCS12_F_PKCS12_MAKE_KEYBAG 112
  257. #define PKCS12_F_PKCS12_MAKE_SHKEYBAG 113
  258. #define PKCS12_F_PKCS12_NEWPASS 128
  259. #define PKCS12_F_PKCS12_PACK_P7DATA 114
  260. #define PKCS12_F_PKCS12_PACK_P7ENCDATA 115
  261. #define PKCS12_F_PKCS12_PARSE 118
  262. #define PKCS12_F_PKCS12_PBE_CRYPT 119
  263. #define PKCS12_F_PKCS12_PBE_KEYIVGEN 120
  264. #define PKCS12_F_PKCS12_SETUP_MAC 122
  265. #define PKCS12_F_PKCS12_SET_MAC 123
  266. #define PKCS12_F_PKCS12_UNPACK_AUTHSAFES 130
  267. #define PKCS12_F_PKCS12_UNPACK_P7DATA 131
  268. #define PKCS12_F_PKCS12_VERIFY_MAC 126
  269. #define PKCS12_F_PKCS8_ADD_KEYUSAGE 124
  270. #define PKCS12_F_PKCS8_ENCRYPT 125
  271. /* Reason codes. */
  272. #define PKCS12_R_CANT_PACK_STRUCTURE 100
  273. #define PKCS12_R_CONTENT_TYPE_NOT_DATA 121
  274. #define PKCS12_R_DECODE_ERROR 101
  275. #define PKCS12_R_ENCODE_ERROR 102
  276. #define PKCS12_R_ENCRYPT_ERROR 103
  277. #define PKCS12_R_ERROR_SETTING_ENCRYPTED_DATA_TYPE 120
  278. #define PKCS12_R_INVALID_NULL_ARGUMENT 104
  279. #define PKCS12_R_INVALID_NULL_PKCS12_POINTER 105
  280. #define PKCS12_R_IV_GEN_ERROR 106
  281. #define PKCS12_R_KEY_GEN_ERROR 107
  282. #define PKCS12_R_MAC_ABSENT 108
  283. #define PKCS12_R_MAC_GENERATION_ERROR 109
  284. #define PKCS12_R_MAC_SETUP_ERROR 110
  285. #define PKCS12_R_MAC_STRING_SET_ERROR 111
  286. #define PKCS12_R_MAC_VERIFY_ERROR 112
  287. #define PKCS12_R_MAC_VERIFY_FAILURE 113
  288. #define PKCS12_R_PARSE_ERROR 114
  289. #define PKCS12_R_PKCS12_ALGOR_CIPHERINIT_ERROR 115
  290. #define PKCS12_R_PKCS12_CIPHERFINAL_ERROR 116
  291. #define PKCS12_R_PKCS12_PBE_CRYPT_ERROR 117
  292. #define PKCS12_R_UNKNOWN_DIGEST_ALGORITHM 118
  293. #define PKCS12_R_UNSUPPORTED_PKCS12_MODE 119
  294. #ifdef __cplusplus
  295. }
  296. #endif
  297. #endif