pkcs12.h 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281
  1. /* $OpenBSD: pkcs12.h,v 1.28 2024/03/02 10:15:16 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. const PKCS8_PRIV_KEY_INFO *PKCS12_SAFEBAG_get0_p8inf(const PKCS12_SAFEBAG *bag);
  132. const X509_SIG *PKCS12_SAFEBAG_get0_pkcs8(const PKCS12_SAFEBAG *bag);
  133. const STACK_OF(PKCS12_SAFEBAG) *
  134. PKCS12_SAFEBAG_get0_safes(const PKCS12_SAFEBAG *bag);
  135. const ASN1_OBJECT *PKCS12_SAFEBAG_get0_type(const PKCS12_SAFEBAG *bag);
  136. PKCS8_PRIV_KEY_INFO *PKCS8_decrypt(const X509_SIG *p8, const char *pass,
  137. int passlen);
  138. PKCS8_PRIV_KEY_INFO *PKCS12_decrypt_skey(const PKCS12_SAFEBAG *bag,
  139. const char *pass, int passlen);
  140. X509_SIG *PKCS8_encrypt(int pbe_nid, const EVP_CIPHER *cipher,
  141. const char *pass, int passlen, unsigned char *salt, int saltlen, int iter,
  142. PKCS8_PRIV_KEY_INFO *p8);
  143. STACK_OF(PKCS12_SAFEBAG) *PKCS12_unpack_p7data(PKCS7 *p7);
  144. STACK_OF(PKCS12_SAFEBAG) *PKCS12_unpack_p7encdata(PKCS7 *p7, const char *pass,
  145. int passlen);
  146. STACK_OF(PKCS7) *PKCS12_unpack_authsafes(const PKCS12 *p12);
  147. int PKCS8_add_keyusage(PKCS8_PRIV_KEY_INFO *p8, int usage);
  148. char *PKCS12_get_friendlyname(PKCS12_SAFEBAG *bag);
  149. int PKCS12_verify_mac(PKCS12 *p12, const char *pass, int passlen);
  150. int PKCS12_set_mac(PKCS12 *p12, const char *pass, int passlen,
  151. unsigned char *salt, int saltlen, int iter,
  152. const EVP_MD *md_type);
  153. unsigned char *OPENSSL_asc2uni(const char *asc, int asclen,
  154. unsigned char **uni, int *unilen);
  155. char *OPENSSL_uni2asc(const unsigned char *uni, int unilen);
  156. PKCS12 *PKCS12_new(void);
  157. void PKCS12_free(PKCS12 *a);
  158. PKCS12 *d2i_PKCS12(PKCS12 **a, const unsigned char **in, long len);
  159. int i2d_PKCS12(PKCS12 *a, unsigned char **out);
  160. extern const ASN1_ITEM PKCS12_it;
  161. PKCS12_SAFEBAG *PKCS12_SAFEBAG_new(void);
  162. void PKCS12_SAFEBAG_free(PKCS12_SAFEBAG *a);
  163. PKCS12_SAFEBAG *d2i_PKCS12_SAFEBAG(PKCS12_SAFEBAG **a, const unsigned char **in, long len);
  164. int i2d_PKCS12_SAFEBAG(PKCS12_SAFEBAG *a, unsigned char **out);
  165. extern const ASN1_ITEM PKCS12_SAFEBAG_it;
  166. void PKCS12_PBE_add(void);
  167. int PKCS12_parse(PKCS12 *p12, const char *pass, EVP_PKEY **pkey, X509 **cert,
  168. STACK_OF(X509) **ca);
  169. PKCS12 *PKCS12_create(const char *pass, const char *name, EVP_PKEY *pkey,
  170. X509 *cert, STACK_OF(X509) *ca, int nid_key, int nid_cert, int iter,
  171. int mac_iter, int keytype);
  172. int i2d_PKCS12_bio(BIO *bp, PKCS12 *p12);
  173. int i2d_PKCS12_fp(FILE *fp, PKCS12 *p12);
  174. PKCS12 *d2i_PKCS12_bio(BIO *bp, PKCS12 **p12);
  175. PKCS12 *d2i_PKCS12_fp(FILE *fp, PKCS12 **p12);
  176. int PKCS12_newpass(PKCS12 *p12, const char *oldpass, const char *newpass);
  177. void ERR_load_PKCS12_strings(void);
  178. /* Error codes for the PKCS12 functions. */
  179. /* Function codes. */
  180. #define PKCS12_F_PARSE_BAG 129
  181. #define PKCS12_F_PARSE_BAGS 103
  182. #define PKCS12_F_PKCS12_ADD_FRIENDLYNAME 100
  183. #define PKCS12_F_PKCS12_ADD_FRIENDLYNAME_ASC 127
  184. #define PKCS12_F_PKCS12_ADD_FRIENDLYNAME_UNI 102
  185. #define PKCS12_F_PKCS12_ADD_LOCALKEYID 104
  186. #define PKCS12_F_PKCS12_CREATE 105
  187. #define PKCS12_F_PKCS12_GEN_MAC 107
  188. #define PKCS12_F_PKCS12_INIT 109
  189. #define PKCS12_F_PKCS12_ITEM_DECRYPT_D2I 106
  190. #define PKCS12_F_PKCS12_ITEM_I2D_ENCRYPT 108
  191. #define PKCS12_F_PKCS12_ITEM_PACK_SAFEBAG 117
  192. #define PKCS12_F_PKCS12_KEY_GEN_ASC 110
  193. #define PKCS12_F_PKCS12_KEY_GEN_UNI 111
  194. #define PKCS12_F_PKCS12_MAKE_KEYBAG 112
  195. #define PKCS12_F_PKCS12_MAKE_SHKEYBAG 113
  196. #define PKCS12_F_PKCS12_NEWPASS 128
  197. #define PKCS12_F_PKCS12_PACK_P7DATA 114
  198. #define PKCS12_F_PKCS12_PACK_P7ENCDATA 115
  199. #define PKCS12_F_PKCS12_PARSE 118
  200. #define PKCS12_F_PKCS12_PBE_CRYPT 119
  201. #define PKCS12_F_PKCS12_PBE_KEYIVGEN 120
  202. #define PKCS12_F_PKCS12_SETUP_MAC 122
  203. #define PKCS12_F_PKCS12_SET_MAC 123
  204. #define PKCS12_F_PKCS12_UNPACK_AUTHSAFES 130
  205. #define PKCS12_F_PKCS12_UNPACK_P7DATA 131
  206. #define PKCS12_F_PKCS12_VERIFY_MAC 126
  207. #define PKCS12_F_PKCS8_ADD_KEYUSAGE 124
  208. #define PKCS12_F_PKCS8_ENCRYPT 125
  209. /* Reason codes. */
  210. #define PKCS12_R_CANT_PACK_STRUCTURE 100
  211. #define PKCS12_R_CONTENT_TYPE_NOT_DATA 121
  212. #define PKCS12_R_DECODE_ERROR 101
  213. #define PKCS12_R_ENCODE_ERROR 102
  214. #define PKCS12_R_ENCRYPT_ERROR 103
  215. #define PKCS12_R_ERROR_SETTING_ENCRYPTED_DATA_TYPE 120
  216. #define PKCS12_R_INVALID_NULL_ARGUMENT 104
  217. #define PKCS12_R_INVALID_NULL_PKCS12_POINTER 105
  218. #define PKCS12_R_IV_GEN_ERROR 106
  219. #define PKCS12_R_KEY_GEN_ERROR 107
  220. #define PKCS12_R_MAC_ABSENT 108
  221. #define PKCS12_R_MAC_GENERATION_ERROR 109
  222. #define PKCS12_R_MAC_SETUP_ERROR 110
  223. #define PKCS12_R_MAC_STRING_SET_ERROR 111
  224. #define PKCS12_R_MAC_VERIFY_ERROR 112
  225. #define PKCS12_R_MAC_VERIFY_FAILURE 113
  226. #define PKCS12_R_PARSE_ERROR 114
  227. #define PKCS12_R_PKCS12_ALGOR_CIPHERINIT_ERROR 115
  228. #define PKCS12_R_PKCS12_CIPHERFINAL_ERROR 116
  229. #define PKCS12_R_PKCS12_PBE_CRYPT_ERROR 117
  230. #define PKCS12_R_UNKNOWN_DIGEST_ALGORITHM 118
  231. #define PKCS12_R_UNSUPPORTED_PKCS12_MODE 119
  232. #ifdef __cplusplus
  233. }
  234. #endif
  235. #endif