x509_vfy.h 29 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652
  1. /* crypto/x509/x509_vfy.h */
  2. /* Copyright (C) 1995-1998 Eric Young ([email protected])
  3. * All rights reserved.
  4. *
  5. * This package is an SSL implementation written
  6. * by Eric Young ([email protected]).
  7. * The implementation was written so as to conform with Netscapes SSL.
  8. *
  9. * This library is free for commercial and non-commercial use as long as
  10. * the following conditions are aheared to. The following conditions
  11. * apply to all code found in this distribution, be it the RC4, RSA,
  12. * lhash, DES, etc., code; not just the SSL code. The SSL documentation
  13. * included with this distribution is covered by the same copyright terms
  14. * except that the holder is Tim Hudson ([email protected]).
  15. *
  16. * Copyright remains Eric Young's, and as such any Copyright notices in
  17. * the code are not to be removed.
  18. * If this package is used in a product, Eric Young should be given attribution
  19. * as the author of the parts of the library used.
  20. * This can be in the form of a textual message at program startup or
  21. * in documentation (online or textual) provided with the package.
  22. *
  23. * Redistribution and use in source and binary forms, with or without
  24. * modification, are permitted provided that the following conditions
  25. * are met:
  26. * 1. Redistributions of source code must retain the copyright
  27. * notice, this list of conditions and the following disclaimer.
  28. * 2. Redistributions in binary form must reproduce the above copyright
  29. * notice, this list of conditions and the following disclaimer in the
  30. * documentation and/or other materials provided with the distribution.
  31. * 3. All advertising materials mentioning features or use of this software
  32. * must display the following acknowledgement:
  33. * "This product includes cryptographic software written by
  34. * Eric Young ([email protected])"
  35. * The word 'cryptographic' can be left out if the rouines from the library
  36. * being used are not cryptographic related :-).
  37. * 4. If you include any Windows specific code (or a derivative thereof) from
  38. * the apps directory (application code) you must include an acknowledgement:
  39. * "This product includes software written by Tim Hudson ([email protected])"
  40. *
  41. * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND
  42. * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  43. * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  44. * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  45. * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  46. * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  47. * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  48. * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  49. * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  50. * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  51. * SUCH DAMAGE.
  52. *
  53. * The licence and distribution terms for any publically available version or
  54. * derivative of this code cannot be changed. i.e. this code cannot simply be
  55. * copied and put under another distribution licence
  56. * [including the GNU Public Licence.]
  57. */
  58. #ifndef HEADER_X509_H
  59. # include <openssl/x509.h>
  60. /*
  61. * openssl/x509.h ends up #include-ing this file at about the only
  62. * appropriate moment.
  63. */
  64. #endif
  65. #ifndef HEADER_X509_VFY_H
  66. # define HEADER_X509_VFY_H
  67. # include <openssl/opensslconf.h>
  68. # ifndef OPENSSL_NO_LHASH
  69. # include <openssl/lhash.h>
  70. # endif
  71. # include <openssl/bio.h>
  72. # include <openssl/crypto.h>
  73. # include <openssl/symhacks.h>
  74. #ifdef __cplusplus
  75. extern "C" {
  76. #endif
  77. # if 0
  78. /* Outer object */
  79. typedef struct x509_hash_dir_st {
  80. int num_dirs;
  81. char **dirs;
  82. int *dirs_type;
  83. int num_dirs_alloced;
  84. } X509_HASH_DIR_CTX;
  85. # endif
  86. typedef struct x509_file_st {
  87. int num_paths; /* number of paths to files or directories */
  88. int num_alloced;
  89. char **paths; /* the list of paths or directories */
  90. int *path_type;
  91. } X509_CERT_FILE_CTX;
  92. /*******************************/
  93. /*-
  94. SSL_CTX -> X509_STORE
  95. -> X509_LOOKUP
  96. ->X509_LOOKUP_METHOD
  97. -> X509_LOOKUP
  98. ->X509_LOOKUP_METHOD
  99. SSL -> X509_STORE_CTX
  100. ->X509_STORE
  101. The X509_STORE holds the tables etc for verification stuff.
  102. A X509_STORE_CTX is used while validating a single certificate.
  103. The X509_STORE has X509_LOOKUPs for looking up certs.
  104. The X509_STORE then calls a function to actually verify the
  105. certificate chain.
  106. */
  107. # define X509_LU_RETRY -1
  108. # define X509_LU_FAIL 0
  109. # define X509_LU_X509 1
  110. # define X509_LU_CRL 2
  111. # define X509_LU_PKEY 3
  112. typedef struct x509_object_st {
  113. /* one of the above types */
  114. int type;
  115. union {
  116. char *ptr;
  117. X509 *x509;
  118. X509_CRL *crl;
  119. EVP_PKEY *pkey;
  120. } data;
  121. } X509_OBJECT;
  122. typedef struct x509_lookup_st X509_LOOKUP;
  123. DECLARE_STACK_OF(X509_LOOKUP)
  124. DECLARE_STACK_OF(X509_OBJECT)
  125. /* This is a static that defines the function interface */
  126. typedef struct x509_lookup_method_st {
  127. const char *name;
  128. int (*new_item) (X509_LOOKUP *ctx);
  129. void (*free) (X509_LOOKUP *ctx);
  130. int (*init) (X509_LOOKUP *ctx);
  131. int (*shutdown) (X509_LOOKUP *ctx);
  132. int (*ctrl) (X509_LOOKUP *ctx, int cmd, const char *argc, long argl,
  133. char **ret);
  134. int (*get_by_subject) (X509_LOOKUP *ctx, int type, X509_NAME *name,
  135. X509_OBJECT *ret);
  136. int (*get_by_issuer_serial) (X509_LOOKUP *ctx, int type, X509_NAME *name,
  137. ASN1_INTEGER *serial, X509_OBJECT *ret);
  138. int (*get_by_fingerprint) (X509_LOOKUP *ctx, int type,
  139. unsigned char *bytes, int len,
  140. X509_OBJECT *ret);
  141. int (*get_by_alias) (X509_LOOKUP *ctx, int type, char *str, int len,
  142. X509_OBJECT *ret);
  143. } X509_LOOKUP_METHOD;
  144. typedef struct X509_VERIFY_PARAM_ID_st X509_VERIFY_PARAM_ID;
  145. /*
  146. * This structure hold all parameters associated with a verify operation by
  147. * including an X509_VERIFY_PARAM structure in related structures the
  148. * parameters used can be customized
  149. */
  150. typedef struct X509_VERIFY_PARAM_st {
  151. char *name;
  152. time_t check_time; /* Time to use */
  153. unsigned long inh_flags; /* Inheritance flags */
  154. unsigned long flags; /* Various verify flags */
  155. int purpose; /* purpose to check untrusted certificates */
  156. int trust; /* trust setting to check */
  157. int depth; /* Verify depth */
  158. STACK_OF(ASN1_OBJECT) *policies; /* Permissible policies */
  159. X509_VERIFY_PARAM_ID *id; /* opaque ID data */
  160. } X509_VERIFY_PARAM;
  161. DECLARE_STACK_OF(X509_VERIFY_PARAM)
  162. /*
  163. * This is used to hold everything. It is used for all certificate
  164. * validation. Once we have a certificate chain, the 'verify' function is
  165. * then called to actually check the cert chain.
  166. */
  167. struct x509_store_st {
  168. /* The following is a cache of trusted certs */
  169. int cache; /* if true, stash any hits */
  170. STACK_OF(X509_OBJECT) *objs; /* Cache of all objects */
  171. /* These are external lookup methods */
  172. STACK_OF(X509_LOOKUP) *get_cert_methods;
  173. X509_VERIFY_PARAM *param;
  174. /* Callbacks for various operations */
  175. /* called to verify a certificate */
  176. int (*verify) (X509_STORE_CTX *ctx);
  177. /* error callback */
  178. int (*verify_cb) (int ok, X509_STORE_CTX *ctx);
  179. /* get issuers cert from ctx */
  180. int (*get_issuer) (X509 **issuer, X509_STORE_CTX *ctx, X509 *x);
  181. /* check issued */
  182. int (*check_issued) (X509_STORE_CTX *ctx, X509 *x, X509 *issuer);
  183. /* Check revocation status of chain */
  184. int (*check_revocation) (X509_STORE_CTX *ctx);
  185. /* retrieve CRL */
  186. int (*get_crl) (X509_STORE_CTX *ctx, X509_CRL **crl, X509 *x);
  187. /* Check CRL validity */
  188. int (*check_crl) (X509_STORE_CTX *ctx, X509_CRL *crl);
  189. /* Check certificate against CRL */
  190. int (*cert_crl) (X509_STORE_CTX *ctx, X509_CRL *crl, X509 *x);
  191. STACK_OF(X509) *(*lookup_certs) (X509_STORE_CTX *ctx, X509_NAME *nm);
  192. STACK_OF(X509_CRL) *(*lookup_crls) (X509_STORE_CTX *ctx, X509_NAME *nm);
  193. int (*cleanup) (X509_STORE_CTX *ctx);
  194. CRYPTO_EX_DATA ex_data;
  195. int references;
  196. } /* X509_STORE */ ;
  197. int X509_STORE_set_depth(X509_STORE *store, int depth);
  198. # define X509_STORE_set_verify_cb_func(ctx,func) ((ctx)->verify_cb=(func))
  199. # define X509_STORE_set_verify_func(ctx,func) ((ctx)->verify=(func))
  200. /* This is the functions plus an instance of the local variables. */
  201. struct x509_lookup_st {
  202. int init; /* have we been started */
  203. int skip; /* don't use us. */
  204. X509_LOOKUP_METHOD *method; /* the functions */
  205. char *method_data; /* method data */
  206. X509_STORE *store_ctx; /* who owns us */
  207. } /* X509_LOOKUP */ ;
  208. /*
  209. * This is a used when verifying cert chains. Since the gathering of the
  210. * cert chain can take some time (and have to be 'retried', this needs to be
  211. * kept and passed around.
  212. */
  213. struct x509_store_ctx_st { /* X509_STORE_CTX */
  214. X509_STORE *ctx;
  215. /* used when looking up certs */
  216. int current_method;
  217. /* The following are set by the caller */
  218. /* The cert to check */
  219. X509 *cert;
  220. /* chain of X509s - untrusted - passed in */
  221. STACK_OF(X509) *untrusted;
  222. /* set of CRLs passed in */
  223. STACK_OF(X509_CRL) *crls;
  224. X509_VERIFY_PARAM *param;
  225. /* Other info for use with get_issuer() */
  226. void *other_ctx;
  227. /* Callbacks for various operations */
  228. /* called to verify a certificate */
  229. int (*verify) (X509_STORE_CTX *ctx);
  230. /* error callback */
  231. int (*verify_cb) (int ok, X509_STORE_CTX *ctx);
  232. /* get issuers cert from ctx */
  233. int (*get_issuer) (X509 **issuer, X509_STORE_CTX *ctx, X509 *x);
  234. /* check issued */
  235. int (*check_issued) (X509_STORE_CTX *ctx, X509 *x, X509 *issuer);
  236. /* Check revocation status of chain */
  237. int (*check_revocation) (X509_STORE_CTX *ctx);
  238. /* retrieve CRL */
  239. int (*get_crl) (X509_STORE_CTX *ctx, X509_CRL **crl, X509 *x);
  240. /* Check CRL validity */
  241. int (*check_crl) (X509_STORE_CTX *ctx, X509_CRL *crl);
  242. /* Check certificate against CRL */
  243. int (*cert_crl) (X509_STORE_CTX *ctx, X509_CRL *crl, X509 *x);
  244. int (*check_policy) (X509_STORE_CTX *ctx);
  245. STACK_OF(X509) *(*lookup_certs) (X509_STORE_CTX *ctx, X509_NAME *nm);
  246. STACK_OF(X509_CRL) *(*lookup_crls) (X509_STORE_CTX *ctx, X509_NAME *nm);
  247. int (*cleanup) (X509_STORE_CTX *ctx);
  248. /* The following is built up */
  249. /* if 0, rebuild chain */
  250. int valid;
  251. /* index of last untrusted cert */
  252. int last_untrusted;
  253. /* chain of X509s - built up and trusted */
  254. STACK_OF(X509) *chain;
  255. /* Valid policy tree */
  256. X509_POLICY_TREE *tree;
  257. /* Require explicit policy value */
  258. int explicit_policy;
  259. /* When something goes wrong, this is why */
  260. int error_depth;
  261. int error;
  262. X509 *current_cert;
  263. /* cert currently being tested as valid issuer */
  264. X509 *current_issuer;
  265. /* current CRL */
  266. X509_CRL *current_crl;
  267. /* score of current CRL */
  268. int current_crl_score;
  269. /* Reason mask */
  270. unsigned int current_reasons;
  271. /* For CRL path validation: parent context */
  272. X509_STORE_CTX *parent;
  273. CRYPTO_EX_DATA ex_data;
  274. } /* X509_STORE_CTX */ ;
  275. void X509_STORE_CTX_set_depth(X509_STORE_CTX *ctx, int depth);
  276. # define X509_STORE_CTX_set_app_data(ctx,data) \
  277. X509_STORE_CTX_set_ex_data(ctx,0,data)
  278. # define X509_STORE_CTX_get_app_data(ctx) \
  279. X509_STORE_CTX_get_ex_data(ctx,0)
  280. # define X509_L_FILE_LOAD 1
  281. # define X509_L_ADD_DIR 2
  282. # define X509_LOOKUP_load_file(x,name,type) \
  283. X509_LOOKUP_ctrl((x),X509_L_FILE_LOAD,(name),(long)(type),NULL)
  284. # define X509_LOOKUP_add_dir(x,name,type) \
  285. X509_LOOKUP_ctrl((x),X509_L_ADD_DIR,(name),(long)(type),NULL)
  286. # define X509_V_OK 0
  287. # define X509_V_ERR_UNSPECIFIED 1
  288. # define X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT 2
  289. # define X509_V_ERR_UNABLE_TO_GET_CRL 3
  290. # define X509_V_ERR_UNABLE_TO_DECRYPT_CERT_SIGNATURE 4
  291. # define X509_V_ERR_UNABLE_TO_DECRYPT_CRL_SIGNATURE 5
  292. # define X509_V_ERR_UNABLE_TO_DECODE_ISSUER_PUBLIC_KEY 6
  293. # define X509_V_ERR_CERT_SIGNATURE_FAILURE 7
  294. # define X509_V_ERR_CRL_SIGNATURE_FAILURE 8
  295. # define X509_V_ERR_CERT_NOT_YET_VALID 9
  296. # define X509_V_ERR_CERT_HAS_EXPIRED 10
  297. # define X509_V_ERR_CRL_NOT_YET_VALID 11
  298. # define X509_V_ERR_CRL_HAS_EXPIRED 12
  299. # define X509_V_ERR_ERROR_IN_CERT_NOT_BEFORE_FIELD 13
  300. # define X509_V_ERR_ERROR_IN_CERT_NOT_AFTER_FIELD 14
  301. # define X509_V_ERR_ERROR_IN_CRL_LAST_UPDATE_FIELD 15
  302. # define X509_V_ERR_ERROR_IN_CRL_NEXT_UPDATE_FIELD 16
  303. # define X509_V_ERR_OUT_OF_MEM 17
  304. # define X509_V_ERR_DEPTH_ZERO_SELF_SIGNED_CERT 18
  305. # define X509_V_ERR_SELF_SIGNED_CERT_IN_CHAIN 19
  306. # define X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT_LOCALLY 20
  307. # define X509_V_ERR_UNABLE_TO_VERIFY_LEAF_SIGNATURE 21
  308. # define X509_V_ERR_CERT_CHAIN_TOO_LONG 22
  309. # define X509_V_ERR_CERT_REVOKED 23
  310. # define X509_V_ERR_INVALID_CA 24
  311. # define X509_V_ERR_PATH_LENGTH_EXCEEDED 25
  312. # define X509_V_ERR_INVALID_PURPOSE 26
  313. # define X509_V_ERR_CERT_UNTRUSTED 27
  314. # define X509_V_ERR_CERT_REJECTED 28
  315. /* These are 'informational' when looking for issuer cert */
  316. # define X509_V_ERR_SUBJECT_ISSUER_MISMATCH 29
  317. # define X509_V_ERR_AKID_SKID_MISMATCH 30
  318. # define X509_V_ERR_AKID_ISSUER_SERIAL_MISMATCH 31
  319. # define X509_V_ERR_KEYUSAGE_NO_CERTSIGN 32
  320. # define X509_V_ERR_UNABLE_TO_GET_CRL_ISSUER 33
  321. # define X509_V_ERR_UNHANDLED_CRITICAL_EXTENSION 34
  322. # define X509_V_ERR_KEYUSAGE_NO_CRL_SIGN 35
  323. # define X509_V_ERR_UNHANDLED_CRITICAL_CRL_EXTENSION 36
  324. # define X509_V_ERR_INVALID_NON_CA 37
  325. # define X509_V_ERR_PROXY_PATH_LENGTH_EXCEEDED 38
  326. # define X509_V_ERR_KEYUSAGE_NO_DIGITAL_SIGNATURE 39
  327. # define X509_V_ERR_PROXY_CERTIFICATES_NOT_ALLOWED 40
  328. # define X509_V_ERR_INVALID_EXTENSION 41
  329. # define X509_V_ERR_INVALID_POLICY_EXTENSION 42
  330. # define X509_V_ERR_NO_EXPLICIT_POLICY 43
  331. # define X509_V_ERR_DIFFERENT_CRL_SCOPE 44
  332. # define X509_V_ERR_UNSUPPORTED_EXTENSION_FEATURE 45
  333. # define X509_V_ERR_UNNESTED_RESOURCE 46
  334. # define X509_V_ERR_PERMITTED_VIOLATION 47
  335. # define X509_V_ERR_EXCLUDED_VIOLATION 48
  336. # define X509_V_ERR_SUBTREE_MINMAX 49
  337. # define X509_V_ERR_APPLICATION_VERIFICATION 50
  338. # define X509_V_ERR_UNSUPPORTED_CONSTRAINT_TYPE 51
  339. # define X509_V_ERR_UNSUPPORTED_CONSTRAINT_SYNTAX 52
  340. # define X509_V_ERR_UNSUPPORTED_NAME_SYNTAX 53
  341. # define X509_V_ERR_CRL_PATH_VALIDATION_ERROR 54
  342. /* Suite B mode algorithm violation */
  343. # define X509_V_ERR_SUITE_B_INVALID_VERSION 56
  344. # define X509_V_ERR_SUITE_B_INVALID_ALGORITHM 57
  345. # define X509_V_ERR_SUITE_B_INVALID_CURVE 58
  346. # define X509_V_ERR_SUITE_B_INVALID_SIGNATURE_ALGORITHM 59
  347. # define X509_V_ERR_SUITE_B_LOS_NOT_ALLOWED 60
  348. # define X509_V_ERR_SUITE_B_CANNOT_SIGN_P_384_WITH_P_256 61
  349. /* Host, email and IP check errors */
  350. # define X509_V_ERR_HOSTNAME_MISMATCH 62
  351. # define X509_V_ERR_EMAIL_MISMATCH 63
  352. # define X509_V_ERR_IP_ADDRESS_MISMATCH 64
  353. /* Caller error */
  354. # define X509_V_ERR_INVALID_CALL 65
  355. /* Issuer lookup error */
  356. # define X509_V_ERR_STORE_LOOKUP 66
  357. # define X509_V_ERR_PROXY_SUBJECT_NAME_VIOLATION 67
  358. /* Certificate verify flags */
  359. /* Send issuer+subject checks to verify_cb */
  360. # define X509_V_FLAG_CB_ISSUER_CHECK 0x1
  361. /* Use check time instead of current time */
  362. # define X509_V_FLAG_USE_CHECK_TIME 0x2
  363. /* Lookup CRLs */
  364. # define X509_V_FLAG_CRL_CHECK 0x4
  365. /* Lookup CRLs for whole chain */
  366. # define X509_V_FLAG_CRL_CHECK_ALL 0x8
  367. /* Ignore unhandled critical extensions */
  368. # define X509_V_FLAG_IGNORE_CRITICAL 0x10
  369. /* Disable workarounds for broken certificates */
  370. # define X509_V_FLAG_X509_STRICT 0x20
  371. /* Enable proxy certificate validation */
  372. # define X509_V_FLAG_ALLOW_PROXY_CERTS 0x40
  373. /* Enable policy checking */
  374. # define X509_V_FLAG_POLICY_CHECK 0x80
  375. /* Policy variable require-explicit-policy */
  376. # define X509_V_FLAG_EXPLICIT_POLICY 0x100
  377. /* Policy variable inhibit-any-policy */
  378. # define X509_V_FLAG_INHIBIT_ANY 0x200
  379. /* Policy variable inhibit-policy-mapping */
  380. # define X509_V_FLAG_INHIBIT_MAP 0x400
  381. /* Notify callback that policy is OK */
  382. # define X509_V_FLAG_NOTIFY_POLICY 0x800
  383. /* Extended CRL features such as indirect CRLs, alternate CRL signing keys */
  384. # define X509_V_FLAG_EXTENDED_CRL_SUPPORT 0x1000
  385. /* Delta CRL support */
  386. # define X509_V_FLAG_USE_DELTAS 0x2000
  387. /* Check selfsigned CA signature */
  388. # define X509_V_FLAG_CHECK_SS_SIGNATURE 0x4000
  389. /* Use trusted store first */
  390. # define X509_V_FLAG_TRUSTED_FIRST 0x8000
  391. /* Suite B 128 bit only mode: not normally used */
  392. # define X509_V_FLAG_SUITEB_128_LOS_ONLY 0x10000
  393. /* Suite B 192 bit only mode */
  394. # define X509_V_FLAG_SUITEB_192_LOS 0x20000
  395. /* Suite B 128 bit mode allowing 192 bit algorithms */
  396. # define X509_V_FLAG_SUITEB_128_LOS 0x30000
  397. /* Allow partial chains if at least one certificate is in trusted store */
  398. # define X509_V_FLAG_PARTIAL_CHAIN 0x80000
  399. /*
  400. * If the initial chain is not trusted, do not attempt to build an alternative
  401. * chain. Alternate chain checking was introduced in 1.0.2b. Setting this flag
  402. * will force the behaviour to match that of previous versions.
  403. */
  404. # define X509_V_FLAG_NO_ALT_CHAINS 0x100000
  405. # define X509_VP_FLAG_DEFAULT 0x1
  406. # define X509_VP_FLAG_OVERWRITE 0x2
  407. # define X509_VP_FLAG_RESET_FLAGS 0x4
  408. # define X509_VP_FLAG_LOCKED 0x8
  409. # define X509_VP_FLAG_ONCE 0x10
  410. /* Internal use: mask of policy related options */
  411. # define X509_V_FLAG_POLICY_MASK (X509_V_FLAG_POLICY_CHECK \
  412. | X509_V_FLAG_EXPLICIT_POLICY \
  413. | X509_V_FLAG_INHIBIT_ANY \
  414. | X509_V_FLAG_INHIBIT_MAP)
  415. int X509_OBJECT_idx_by_subject(STACK_OF(X509_OBJECT) *h, int type,
  416. X509_NAME *name);
  417. X509_OBJECT *X509_OBJECT_retrieve_by_subject(STACK_OF(X509_OBJECT) *h,
  418. int type, X509_NAME *name);
  419. X509_OBJECT *X509_OBJECT_retrieve_match(STACK_OF(X509_OBJECT) *h,
  420. X509_OBJECT *x);
  421. void X509_OBJECT_up_ref_count(X509_OBJECT *a);
  422. void X509_OBJECT_free_contents(X509_OBJECT *a);
  423. X509_STORE *X509_STORE_new(void);
  424. void X509_STORE_free(X509_STORE *v);
  425. STACK_OF(X509) *X509_STORE_get1_certs(X509_STORE_CTX *st, X509_NAME *nm);
  426. STACK_OF(X509_CRL) *X509_STORE_get1_crls(X509_STORE_CTX *st, X509_NAME *nm);
  427. int X509_STORE_set_flags(X509_STORE *ctx, unsigned long flags);
  428. int X509_STORE_set_purpose(X509_STORE *ctx, int purpose);
  429. int X509_STORE_set_trust(X509_STORE *ctx, int trust);
  430. int X509_STORE_set1_param(X509_STORE *ctx, X509_VERIFY_PARAM *pm);
  431. void X509_STORE_set_verify_cb(X509_STORE *ctx,
  432. int (*verify_cb) (int, X509_STORE_CTX *));
  433. void X509_STORE_set_lookup_crls_cb(X509_STORE *ctx,
  434. STACK_OF(X509_CRL) *(*cb) (X509_STORE_CTX
  435. *ctx,
  436. X509_NAME *nm));
  437. X509_STORE_CTX *X509_STORE_CTX_new(void);
  438. int X509_STORE_CTX_get1_issuer(X509 **issuer, X509_STORE_CTX *ctx, X509 *x);
  439. void X509_STORE_CTX_free(X509_STORE_CTX *ctx);
  440. int X509_STORE_CTX_init(X509_STORE_CTX *ctx, X509_STORE *store,
  441. X509 *x509, STACK_OF(X509) *chain);
  442. void X509_STORE_CTX_trusted_stack(X509_STORE_CTX *ctx, STACK_OF(X509) *sk);
  443. void X509_STORE_CTX_cleanup(X509_STORE_CTX *ctx);
  444. X509_STORE *X509_STORE_CTX_get0_store(X509_STORE_CTX *ctx);
  445. X509_LOOKUP *X509_STORE_add_lookup(X509_STORE *v, X509_LOOKUP_METHOD *m);
  446. X509_LOOKUP_METHOD *X509_LOOKUP_hash_dir(void);
  447. X509_LOOKUP_METHOD *X509_LOOKUP_file(void);
  448. int X509_STORE_add_cert(X509_STORE *ctx, X509 *x);
  449. int X509_STORE_add_crl(X509_STORE *ctx, X509_CRL *x);
  450. int X509_STORE_get_by_subject(X509_STORE_CTX *vs, int type, X509_NAME *name,
  451. X509_OBJECT *ret);
  452. int X509_LOOKUP_ctrl(X509_LOOKUP *ctx, int cmd, const char *argc,
  453. long argl, char **ret);
  454. # ifndef OPENSSL_NO_STDIO
  455. int X509_load_cert_file(X509_LOOKUP *ctx, const char *file, int type);
  456. int X509_load_crl_file(X509_LOOKUP *ctx, const char *file, int type);
  457. int X509_load_cert_crl_file(X509_LOOKUP *ctx, const char *file, int type);
  458. # endif
  459. X509_LOOKUP *X509_LOOKUP_new(X509_LOOKUP_METHOD *method);
  460. void X509_LOOKUP_free(X509_LOOKUP *ctx);
  461. int X509_LOOKUP_init(X509_LOOKUP *ctx);
  462. int X509_LOOKUP_by_subject(X509_LOOKUP *ctx, int type, X509_NAME *name,
  463. X509_OBJECT *ret);
  464. int X509_LOOKUP_by_issuer_serial(X509_LOOKUP *ctx, int type, X509_NAME *name,
  465. ASN1_INTEGER *serial, X509_OBJECT *ret);
  466. int X509_LOOKUP_by_fingerprint(X509_LOOKUP *ctx, int type,
  467. unsigned char *bytes, int len,
  468. X509_OBJECT *ret);
  469. int X509_LOOKUP_by_alias(X509_LOOKUP *ctx, int type, char *str, int len,
  470. X509_OBJECT *ret);
  471. int X509_LOOKUP_shutdown(X509_LOOKUP *ctx);
  472. # ifndef OPENSSL_NO_STDIO
  473. int X509_STORE_load_locations(X509_STORE *ctx,
  474. const char *file, const char *dir);
  475. int X509_STORE_set_default_paths(X509_STORE *ctx);
  476. # endif
  477. int X509_STORE_CTX_get_ex_new_index(long argl, void *argp,
  478. CRYPTO_EX_new *new_func,
  479. CRYPTO_EX_dup *dup_func,
  480. CRYPTO_EX_free *free_func);
  481. int X509_STORE_CTX_set_ex_data(X509_STORE_CTX *ctx, int idx, void *data);
  482. void *X509_STORE_CTX_get_ex_data(X509_STORE_CTX *ctx, int idx);
  483. int X509_STORE_CTX_get_error(X509_STORE_CTX *ctx);
  484. void X509_STORE_CTX_set_error(X509_STORE_CTX *ctx, int s);
  485. int X509_STORE_CTX_get_error_depth(X509_STORE_CTX *ctx);
  486. X509 *X509_STORE_CTX_get_current_cert(X509_STORE_CTX *ctx);
  487. X509 *X509_STORE_CTX_get0_current_issuer(X509_STORE_CTX *ctx);
  488. X509_CRL *X509_STORE_CTX_get0_current_crl(X509_STORE_CTX *ctx);
  489. X509_STORE_CTX *X509_STORE_CTX_get0_parent_ctx(X509_STORE_CTX *ctx);
  490. STACK_OF(X509) *X509_STORE_CTX_get_chain(X509_STORE_CTX *ctx);
  491. STACK_OF(X509) *X509_STORE_CTX_get1_chain(X509_STORE_CTX *ctx);
  492. void X509_STORE_CTX_set_cert(X509_STORE_CTX *c, X509 *x);
  493. void X509_STORE_CTX_set_chain(X509_STORE_CTX *c, STACK_OF(X509) *sk);
  494. void X509_STORE_CTX_set0_crls(X509_STORE_CTX *c, STACK_OF(X509_CRL) *sk);
  495. int X509_STORE_CTX_set_purpose(X509_STORE_CTX *ctx, int purpose);
  496. int X509_STORE_CTX_set_trust(X509_STORE_CTX *ctx, int trust);
  497. int X509_STORE_CTX_purpose_inherit(X509_STORE_CTX *ctx, int def_purpose,
  498. int purpose, int trust);
  499. void X509_STORE_CTX_set_flags(X509_STORE_CTX *ctx, unsigned long flags);
  500. void X509_STORE_CTX_set_time(X509_STORE_CTX *ctx, unsigned long flags,
  501. time_t t);
  502. void X509_STORE_CTX_set_verify_cb(X509_STORE_CTX *ctx,
  503. int (*verify_cb) (int, X509_STORE_CTX *));
  504. X509_POLICY_TREE *X509_STORE_CTX_get0_policy_tree(X509_STORE_CTX *ctx);
  505. int X509_STORE_CTX_get_explicit_policy(X509_STORE_CTX *ctx);
  506. X509_VERIFY_PARAM *X509_STORE_CTX_get0_param(X509_STORE_CTX *ctx);
  507. void X509_STORE_CTX_set0_param(X509_STORE_CTX *ctx, X509_VERIFY_PARAM *param);
  508. int X509_STORE_CTX_set_default(X509_STORE_CTX *ctx, const char *name);
  509. /* X509_VERIFY_PARAM functions */
  510. X509_VERIFY_PARAM *X509_VERIFY_PARAM_new(void);
  511. void X509_VERIFY_PARAM_free(X509_VERIFY_PARAM *param);
  512. int X509_VERIFY_PARAM_inherit(X509_VERIFY_PARAM *to,
  513. const X509_VERIFY_PARAM *from);
  514. int X509_VERIFY_PARAM_set1(X509_VERIFY_PARAM *to,
  515. const X509_VERIFY_PARAM *from);
  516. int X509_VERIFY_PARAM_set1_name(X509_VERIFY_PARAM *param, const char *name);
  517. int X509_VERIFY_PARAM_set_flags(X509_VERIFY_PARAM *param,
  518. unsigned long flags);
  519. int X509_VERIFY_PARAM_clear_flags(X509_VERIFY_PARAM *param,
  520. unsigned long flags);
  521. unsigned long X509_VERIFY_PARAM_get_flags(X509_VERIFY_PARAM *param);
  522. int X509_VERIFY_PARAM_set_purpose(X509_VERIFY_PARAM *param, int purpose);
  523. int X509_VERIFY_PARAM_set_trust(X509_VERIFY_PARAM *param, int trust);
  524. void X509_VERIFY_PARAM_set_depth(X509_VERIFY_PARAM *param, int depth);
  525. void X509_VERIFY_PARAM_set_time(X509_VERIFY_PARAM *param, time_t t);
  526. int X509_VERIFY_PARAM_add0_policy(X509_VERIFY_PARAM *param,
  527. ASN1_OBJECT *policy);
  528. int X509_VERIFY_PARAM_set1_policies(X509_VERIFY_PARAM *param,
  529. STACK_OF(ASN1_OBJECT) *policies);
  530. int X509_VERIFY_PARAM_set1_host(X509_VERIFY_PARAM *param,
  531. const char *name, size_t namelen);
  532. int X509_VERIFY_PARAM_add1_host(X509_VERIFY_PARAM *param,
  533. const char *name, size_t namelen);
  534. void X509_VERIFY_PARAM_set_hostflags(X509_VERIFY_PARAM *param,
  535. unsigned int flags);
  536. char *X509_VERIFY_PARAM_get0_peername(X509_VERIFY_PARAM *);
  537. int X509_VERIFY_PARAM_set1_email(X509_VERIFY_PARAM *param,
  538. const char *email, size_t emaillen);
  539. int X509_VERIFY_PARAM_set1_ip(X509_VERIFY_PARAM *param,
  540. const unsigned char *ip, size_t iplen);
  541. int X509_VERIFY_PARAM_set1_ip_asc(X509_VERIFY_PARAM *param,
  542. const char *ipasc);
  543. int X509_VERIFY_PARAM_get_depth(const X509_VERIFY_PARAM *param);
  544. const char *X509_VERIFY_PARAM_get0_name(const X509_VERIFY_PARAM *param);
  545. int X509_VERIFY_PARAM_add0_table(X509_VERIFY_PARAM *param);
  546. int X509_VERIFY_PARAM_get_count(void);
  547. const X509_VERIFY_PARAM *X509_VERIFY_PARAM_get0(int id);
  548. const X509_VERIFY_PARAM *X509_VERIFY_PARAM_lookup(const char *name);
  549. void X509_VERIFY_PARAM_table_cleanup(void);
  550. int X509_policy_check(X509_POLICY_TREE **ptree, int *pexplicit_policy,
  551. STACK_OF(X509) *certs,
  552. STACK_OF(ASN1_OBJECT) *policy_oids, unsigned int flags);
  553. void X509_policy_tree_free(X509_POLICY_TREE *tree);
  554. int X509_policy_tree_level_count(const X509_POLICY_TREE *tree);
  555. X509_POLICY_LEVEL *X509_policy_tree_get0_level(const X509_POLICY_TREE *tree,
  556. int i);
  557. STACK_OF(X509_POLICY_NODE) *X509_policy_tree_get0_policies(const
  558. X509_POLICY_TREE
  559. *tree);
  560. STACK_OF(X509_POLICY_NODE) *X509_policy_tree_get0_user_policies(const
  561. X509_POLICY_TREE
  562. *tree);
  563. int X509_policy_level_node_count(X509_POLICY_LEVEL *level);
  564. X509_POLICY_NODE *X509_policy_level_get0_node(X509_POLICY_LEVEL *level,
  565. int i);
  566. const ASN1_OBJECT *X509_policy_node_get0_policy(const X509_POLICY_NODE *node);
  567. STACK_OF(POLICYQUALINFO) *X509_policy_node_get0_qualifiers(const
  568. X509_POLICY_NODE
  569. *node);
  570. const X509_POLICY_NODE *X509_policy_node_get0_parent(const X509_POLICY_NODE
  571. *node);
  572. #ifdef __cplusplus
  573. }
  574. #endif
  575. #endif