x509_vfy.h 32 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632
  1. /*
  2. * Copyright 1995-2020 The OpenSSL Project Authors. All Rights Reserved.
  3. *
  4. * Licensed under the OpenSSL license (the "License"). You may not use
  5. * this file except in compliance with the License. You can obtain a copy
  6. * in the file LICENSE in the source distribution or at
  7. * https://www.openssl.org/source/license.html
  8. */
  9. #ifndef HEADER_X509_VFY_H
  10. # define HEADER_X509_VFY_H
  11. /*
  12. * Protect against recursion, x509.h and x509_vfy.h each include the other.
  13. */
  14. # ifndef HEADER_X509_H
  15. # include <openssl/x509.h>
  16. # endif
  17. # include <openssl/opensslconf.h>
  18. # include <openssl/lhash.h>
  19. # include <openssl/bio.h>
  20. # include <openssl/crypto.h>
  21. # include <openssl/symhacks.h>
  22. #ifdef __cplusplus
  23. extern "C" {
  24. #endif
  25. /*-
  26. SSL_CTX -> X509_STORE
  27. -> X509_LOOKUP
  28. ->X509_LOOKUP_METHOD
  29. -> X509_LOOKUP
  30. ->X509_LOOKUP_METHOD
  31. SSL -> X509_STORE_CTX
  32. ->X509_STORE
  33. The X509_STORE holds the tables etc for verification stuff.
  34. A X509_STORE_CTX is used while validating a single certificate.
  35. The X509_STORE has X509_LOOKUPs for looking up certs.
  36. The X509_STORE then calls a function to actually verify the
  37. certificate chain.
  38. */
  39. typedef enum {
  40. X509_LU_NONE = 0,
  41. X509_LU_X509, X509_LU_CRL
  42. } X509_LOOKUP_TYPE;
  43. #if OPENSSL_API_COMPAT < 0x10100000L
  44. #define X509_LU_RETRY -1
  45. #define X509_LU_FAIL 0
  46. #endif
  47. DEFINE_STACK_OF(X509_LOOKUP)
  48. DEFINE_STACK_OF(X509_OBJECT)
  49. DEFINE_STACK_OF(X509_VERIFY_PARAM)
  50. int X509_STORE_set_depth(X509_STORE *store, int depth);
  51. typedef int (*X509_STORE_CTX_verify_cb)(int, X509_STORE_CTX *);
  52. typedef int (*X509_STORE_CTX_verify_fn)(X509_STORE_CTX *);
  53. typedef int (*X509_STORE_CTX_get_issuer_fn)(X509 **issuer,
  54. X509_STORE_CTX *ctx, X509 *x);
  55. typedef int (*X509_STORE_CTX_check_issued_fn)(X509_STORE_CTX *ctx,
  56. X509 *x, X509 *issuer);
  57. typedef int (*X509_STORE_CTX_check_revocation_fn)(X509_STORE_CTX *ctx);
  58. typedef int (*X509_STORE_CTX_get_crl_fn)(X509_STORE_CTX *ctx,
  59. X509_CRL **crl, X509 *x);
  60. typedef int (*X509_STORE_CTX_check_crl_fn)(X509_STORE_CTX *ctx, X509_CRL *crl);
  61. typedef int (*X509_STORE_CTX_cert_crl_fn)(X509_STORE_CTX *ctx,
  62. X509_CRL *crl, X509 *x);
  63. typedef int (*X509_STORE_CTX_check_policy_fn)(X509_STORE_CTX *ctx);
  64. typedef STACK_OF(X509) *(*X509_STORE_CTX_lookup_certs_fn)(X509_STORE_CTX *ctx,
  65. X509_NAME *nm);
  66. typedef STACK_OF(X509_CRL) *(*X509_STORE_CTX_lookup_crls_fn)(X509_STORE_CTX *ctx,
  67. X509_NAME *nm);
  68. typedef int (*X509_STORE_CTX_cleanup_fn)(X509_STORE_CTX *ctx);
  69. void X509_STORE_CTX_set_depth(X509_STORE_CTX *ctx, int depth);
  70. # define X509_STORE_CTX_set_app_data(ctx,data) \
  71. X509_STORE_CTX_set_ex_data(ctx,0,data)
  72. # define X509_STORE_CTX_get_app_data(ctx) \
  73. X509_STORE_CTX_get_ex_data(ctx,0)
  74. # define X509_L_FILE_LOAD 1
  75. # define X509_L_ADD_DIR 2
  76. # define X509_LOOKUP_load_file(x,name,type) \
  77. X509_LOOKUP_ctrl((x),X509_L_FILE_LOAD,(name),(long)(type),NULL)
  78. # define X509_LOOKUP_add_dir(x,name,type) \
  79. X509_LOOKUP_ctrl((x),X509_L_ADD_DIR,(name),(long)(type),NULL)
  80. # define X509_V_OK 0
  81. # define X509_V_ERR_UNSPECIFIED 1
  82. # define X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT 2
  83. # define X509_V_ERR_UNABLE_TO_GET_CRL 3
  84. # define X509_V_ERR_UNABLE_TO_DECRYPT_CERT_SIGNATURE 4
  85. # define X509_V_ERR_UNABLE_TO_DECRYPT_CRL_SIGNATURE 5
  86. # define X509_V_ERR_UNABLE_TO_DECODE_ISSUER_PUBLIC_KEY 6
  87. # define X509_V_ERR_CERT_SIGNATURE_FAILURE 7
  88. # define X509_V_ERR_CRL_SIGNATURE_FAILURE 8
  89. # define X509_V_ERR_CERT_NOT_YET_VALID 9
  90. # define X509_V_ERR_CERT_HAS_EXPIRED 10
  91. # define X509_V_ERR_CRL_NOT_YET_VALID 11
  92. # define X509_V_ERR_CRL_HAS_EXPIRED 12
  93. # define X509_V_ERR_ERROR_IN_CERT_NOT_BEFORE_FIELD 13
  94. # define X509_V_ERR_ERROR_IN_CERT_NOT_AFTER_FIELD 14
  95. # define X509_V_ERR_ERROR_IN_CRL_LAST_UPDATE_FIELD 15
  96. # define X509_V_ERR_ERROR_IN_CRL_NEXT_UPDATE_FIELD 16
  97. # define X509_V_ERR_OUT_OF_MEM 17
  98. # define X509_V_ERR_DEPTH_ZERO_SELF_SIGNED_CERT 18
  99. # define X509_V_ERR_SELF_SIGNED_CERT_IN_CHAIN 19
  100. # define X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT_LOCALLY 20
  101. # define X509_V_ERR_UNABLE_TO_VERIFY_LEAF_SIGNATURE 21
  102. # define X509_V_ERR_CERT_CHAIN_TOO_LONG 22
  103. # define X509_V_ERR_CERT_REVOKED 23
  104. # define X509_V_ERR_INVALID_CA 24
  105. # define X509_V_ERR_PATH_LENGTH_EXCEEDED 25
  106. # define X509_V_ERR_INVALID_PURPOSE 26
  107. # define X509_V_ERR_CERT_UNTRUSTED 27
  108. # define X509_V_ERR_CERT_REJECTED 28
  109. /* These are 'informational' when looking for issuer cert */
  110. # define X509_V_ERR_SUBJECT_ISSUER_MISMATCH 29
  111. # define X509_V_ERR_AKID_SKID_MISMATCH 30
  112. # define X509_V_ERR_AKID_ISSUER_SERIAL_MISMATCH 31
  113. # define X509_V_ERR_KEYUSAGE_NO_CERTSIGN 32
  114. # define X509_V_ERR_UNABLE_TO_GET_CRL_ISSUER 33
  115. # define X509_V_ERR_UNHANDLED_CRITICAL_EXTENSION 34
  116. # define X509_V_ERR_KEYUSAGE_NO_CRL_SIGN 35
  117. # define X509_V_ERR_UNHANDLED_CRITICAL_CRL_EXTENSION 36
  118. # define X509_V_ERR_INVALID_NON_CA 37
  119. # define X509_V_ERR_PROXY_PATH_LENGTH_EXCEEDED 38
  120. # define X509_V_ERR_KEYUSAGE_NO_DIGITAL_SIGNATURE 39
  121. # define X509_V_ERR_PROXY_CERTIFICATES_NOT_ALLOWED 40
  122. # define X509_V_ERR_INVALID_EXTENSION 41
  123. # define X509_V_ERR_INVALID_POLICY_EXTENSION 42
  124. # define X509_V_ERR_NO_EXPLICIT_POLICY 43
  125. # define X509_V_ERR_DIFFERENT_CRL_SCOPE 44
  126. # define X509_V_ERR_UNSUPPORTED_EXTENSION_FEATURE 45
  127. # define X509_V_ERR_UNNESTED_RESOURCE 46
  128. # define X509_V_ERR_PERMITTED_VIOLATION 47
  129. # define X509_V_ERR_EXCLUDED_VIOLATION 48
  130. # define X509_V_ERR_SUBTREE_MINMAX 49
  131. /* The application is not happy */
  132. # define X509_V_ERR_APPLICATION_VERIFICATION 50
  133. # define X509_V_ERR_UNSUPPORTED_CONSTRAINT_TYPE 51
  134. # define X509_V_ERR_UNSUPPORTED_CONSTRAINT_SYNTAX 52
  135. # define X509_V_ERR_UNSUPPORTED_NAME_SYNTAX 53
  136. # define X509_V_ERR_CRL_PATH_VALIDATION_ERROR 54
  137. /* Another issuer check debug option */
  138. # define X509_V_ERR_PATH_LOOP 55
  139. /* Suite B mode algorithm violation */
  140. # define X509_V_ERR_SUITE_B_INVALID_VERSION 56
  141. # define X509_V_ERR_SUITE_B_INVALID_ALGORITHM 57
  142. # define X509_V_ERR_SUITE_B_INVALID_CURVE 58
  143. # define X509_V_ERR_SUITE_B_INVALID_SIGNATURE_ALGORITHM 59
  144. # define X509_V_ERR_SUITE_B_LOS_NOT_ALLOWED 60
  145. # define X509_V_ERR_SUITE_B_CANNOT_SIGN_P_384_WITH_P_256 61
  146. /* Host, email and IP check errors */
  147. # define X509_V_ERR_HOSTNAME_MISMATCH 62
  148. # define X509_V_ERR_EMAIL_MISMATCH 63
  149. # define X509_V_ERR_IP_ADDRESS_MISMATCH 64
  150. /* DANE TLSA errors */
  151. # define X509_V_ERR_DANE_NO_MATCH 65
  152. /* security level errors */
  153. # define X509_V_ERR_EE_KEY_TOO_SMALL 66
  154. # define X509_V_ERR_CA_KEY_TOO_SMALL 67
  155. # define X509_V_ERR_CA_MD_TOO_WEAK 68
  156. /* Caller error */
  157. # define X509_V_ERR_INVALID_CALL 69
  158. /* Issuer lookup error */
  159. # define X509_V_ERR_STORE_LOOKUP 70
  160. /* Certificate transparency */
  161. # define X509_V_ERR_NO_VALID_SCTS 71
  162. # define X509_V_ERR_PROXY_SUBJECT_NAME_VIOLATION 72
  163. /* OCSP status errors */
  164. # define X509_V_ERR_OCSP_VERIFY_NEEDED 73 /* Need OCSP verification */
  165. # define X509_V_ERR_OCSP_VERIFY_FAILED 74 /* Couldn't verify cert through OCSP */
  166. # define X509_V_ERR_OCSP_CERT_UNKNOWN 75 /* Certificate wasn't recognized by the OCSP responder */
  167. # define X509_V_ERR_SIGNATURE_ALGORITHM_MISMATCH 76
  168. # define X509_V_ERR_NO_ISSUER_PUBLIC_KEY 77
  169. # define X509_V_ERR_UNSUPPORTED_SIGNATURE_ALGORITHM 78
  170. # define X509_V_ERR_EC_KEY_EXPLICIT_PARAMS 79
  171. /* Certificate verify flags */
  172. # if OPENSSL_API_COMPAT < 0x10100000L
  173. # define X509_V_FLAG_CB_ISSUER_CHECK 0x0 /* Deprecated */
  174. # endif
  175. /* Use check time instead of current time */
  176. # define X509_V_FLAG_USE_CHECK_TIME 0x2
  177. /* Lookup CRLs */
  178. # define X509_V_FLAG_CRL_CHECK 0x4
  179. /* Lookup CRLs for whole chain */
  180. # define X509_V_FLAG_CRL_CHECK_ALL 0x8
  181. /* Ignore unhandled critical extensions */
  182. # define X509_V_FLAG_IGNORE_CRITICAL 0x10
  183. /* Disable workarounds for broken certificates */
  184. # define X509_V_FLAG_X509_STRICT 0x20
  185. /* Enable proxy certificate validation */
  186. # define X509_V_FLAG_ALLOW_PROXY_CERTS 0x40
  187. /* Enable policy checking */
  188. # define X509_V_FLAG_POLICY_CHECK 0x80
  189. /* Policy variable require-explicit-policy */
  190. # define X509_V_FLAG_EXPLICIT_POLICY 0x100
  191. /* Policy variable inhibit-any-policy */
  192. # define X509_V_FLAG_INHIBIT_ANY 0x200
  193. /* Policy variable inhibit-policy-mapping */
  194. # define X509_V_FLAG_INHIBIT_MAP 0x400
  195. /* Notify callback that policy is OK */
  196. # define X509_V_FLAG_NOTIFY_POLICY 0x800
  197. /* Extended CRL features such as indirect CRLs, alternate CRL signing keys */
  198. # define X509_V_FLAG_EXTENDED_CRL_SUPPORT 0x1000
  199. /* Delta CRL support */
  200. # define X509_V_FLAG_USE_DELTAS 0x2000
  201. /* Check self-signed CA signature */
  202. # define X509_V_FLAG_CHECK_SS_SIGNATURE 0x4000
  203. /* Use trusted store first */
  204. # define X509_V_FLAG_TRUSTED_FIRST 0x8000
  205. /* Suite B 128 bit only mode: not normally used */
  206. # define X509_V_FLAG_SUITEB_128_LOS_ONLY 0x10000
  207. /* Suite B 192 bit only mode */
  208. # define X509_V_FLAG_SUITEB_192_LOS 0x20000
  209. /* Suite B 128 bit mode allowing 192 bit algorithms */
  210. # define X509_V_FLAG_SUITEB_128_LOS 0x30000
  211. /* Allow partial chains if at least one certificate is in trusted store */
  212. # define X509_V_FLAG_PARTIAL_CHAIN 0x80000
  213. /*
  214. * If the initial chain is not trusted, do not attempt to build an alternative
  215. * chain. Alternate chain checking was introduced in 1.1.0. Setting this flag
  216. * will force the behaviour to match that of previous versions.
  217. */
  218. # define X509_V_FLAG_NO_ALT_CHAINS 0x100000
  219. /* Do not check certificate/CRL validity against current time */
  220. # define X509_V_FLAG_NO_CHECK_TIME 0x200000
  221. # define X509_VP_FLAG_DEFAULT 0x1
  222. # define X509_VP_FLAG_OVERWRITE 0x2
  223. # define X509_VP_FLAG_RESET_FLAGS 0x4
  224. # define X509_VP_FLAG_LOCKED 0x8
  225. # define X509_VP_FLAG_ONCE 0x10
  226. /* Internal use: mask of policy related options */
  227. # define X509_V_FLAG_POLICY_MASK (X509_V_FLAG_POLICY_CHECK \
  228. | X509_V_FLAG_EXPLICIT_POLICY \
  229. | X509_V_FLAG_INHIBIT_ANY \
  230. | X509_V_FLAG_INHIBIT_MAP)
  231. int X509_OBJECT_idx_by_subject(STACK_OF(X509_OBJECT) *h, X509_LOOKUP_TYPE type,
  232. X509_NAME *name);
  233. X509_OBJECT *X509_OBJECT_retrieve_by_subject(STACK_OF(X509_OBJECT) *h,
  234. X509_LOOKUP_TYPE type,
  235. X509_NAME *name);
  236. X509_OBJECT *X509_OBJECT_retrieve_match(STACK_OF(X509_OBJECT) *h,
  237. X509_OBJECT *x);
  238. int X509_OBJECT_up_ref_count(X509_OBJECT *a);
  239. X509_OBJECT *X509_OBJECT_new(void);
  240. void X509_OBJECT_free(X509_OBJECT *a);
  241. X509_LOOKUP_TYPE X509_OBJECT_get_type(const X509_OBJECT *a);
  242. X509 *X509_OBJECT_get0_X509(const X509_OBJECT *a);
  243. int X509_OBJECT_set1_X509(X509_OBJECT *a, X509 *obj);
  244. X509_CRL *X509_OBJECT_get0_X509_CRL(X509_OBJECT *a);
  245. int X509_OBJECT_set1_X509_CRL(X509_OBJECT *a, X509_CRL *obj);
  246. X509_STORE *X509_STORE_new(void);
  247. void X509_STORE_free(X509_STORE *v);
  248. int X509_STORE_lock(X509_STORE *ctx);
  249. int X509_STORE_unlock(X509_STORE *ctx);
  250. int X509_STORE_up_ref(X509_STORE *v);
  251. STACK_OF(X509_OBJECT) *X509_STORE_get0_objects(X509_STORE *v);
  252. STACK_OF(X509) *X509_STORE_CTX_get1_certs(X509_STORE_CTX *st, X509_NAME *nm);
  253. STACK_OF(X509_CRL) *X509_STORE_CTX_get1_crls(X509_STORE_CTX *st, X509_NAME *nm);
  254. int X509_STORE_set_flags(X509_STORE *ctx, unsigned long flags);
  255. int X509_STORE_set_purpose(X509_STORE *ctx, int purpose);
  256. int X509_STORE_set_trust(X509_STORE *ctx, int trust);
  257. int X509_STORE_set1_param(X509_STORE *ctx, X509_VERIFY_PARAM *pm);
  258. X509_VERIFY_PARAM *X509_STORE_get0_param(X509_STORE *ctx);
  259. void X509_STORE_set_verify(X509_STORE *ctx, X509_STORE_CTX_verify_fn verify);
  260. #define X509_STORE_set_verify_func(ctx, func) \
  261. X509_STORE_set_verify((ctx),(func))
  262. void X509_STORE_CTX_set_verify(X509_STORE_CTX *ctx,
  263. X509_STORE_CTX_verify_fn verify);
  264. X509_STORE_CTX_verify_fn X509_STORE_get_verify(X509_STORE *ctx);
  265. void X509_STORE_set_verify_cb(X509_STORE *ctx,
  266. X509_STORE_CTX_verify_cb verify_cb);
  267. # define X509_STORE_set_verify_cb_func(ctx,func) \
  268. X509_STORE_set_verify_cb((ctx),(func))
  269. X509_STORE_CTX_verify_cb X509_STORE_get_verify_cb(X509_STORE *ctx);
  270. void X509_STORE_set_get_issuer(X509_STORE *ctx,
  271. X509_STORE_CTX_get_issuer_fn get_issuer);
  272. X509_STORE_CTX_get_issuer_fn X509_STORE_get_get_issuer(X509_STORE *ctx);
  273. void X509_STORE_set_check_issued(X509_STORE *ctx,
  274. X509_STORE_CTX_check_issued_fn check_issued);
  275. X509_STORE_CTX_check_issued_fn X509_STORE_get_check_issued(X509_STORE *ctx);
  276. void X509_STORE_set_check_revocation(X509_STORE *ctx,
  277. X509_STORE_CTX_check_revocation_fn check_revocation);
  278. X509_STORE_CTX_check_revocation_fn X509_STORE_get_check_revocation(X509_STORE *ctx);
  279. void X509_STORE_set_get_crl(X509_STORE *ctx,
  280. X509_STORE_CTX_get_crl_fn get_crl);
  281. X509_STORE_CTX_get_crl_fn X509_STORE_get_get_crl(X509_STORE *ctx);
  282. void X509_STORE_set_check_crl(X509_STORE *ctx,
  283. X509_STORE_CTX_check_crl_fn check_crl);
  284. X509_STORE_CTX_check_crl_fn X509_STORE_get_check_crl(X509_STORE *ctx);
  285. void X509_STORE_set_cert_crl(X509_STORE *ctx,
  286. X509_STORE_CTX_cert_crl_fn cert_crl);
  287. X509_STORE_CTX_cert_crl_fn X509_STORE_get_cert_crl(X509_STORE *ctx);
  288. void X509_STORE_set_check_policy(X509_STORE *ctx,
  289. X509_STORE_CTX_check_policy_fn check_policy);
  290. X509_STORE_CTX_check_policy_fn X509_STORE_get_check_policy(X509_STORE *ctx);
  291. void X509_STORE_set_lookup_certs(X509_STORE *ctx,
  292. X509_STORE_CTX_lookup_certs_fn lookup_certs);
  293. X509_STORE_CTX_lookup_certs_fn X509_STORE_get_lookup_certs(X509_STORE *ctx);
  294. void X509_STORE_set_lookup_crls(X509_STORE *ctx,
  295. X509_STORE_CTX_lookup_crls_fn lookup_crls);
  296. #define X509_STORE_set_lookup_crls_cb(ctx, func) \
  297. X509_STORE_set_lookup_crls((ctx), (func))
  298. X509_STORE_CTX_lookup_crls_fn X509_STORE_get_lookup_crls(X509_STORE *ctx);
  299. void X509_STORE_set_cleanup(X509_STORE *ctx,
  300. X509_STORE_CTX_cleanup_fn cleanup);
  301. X509_STORE_CTX_cleanup_fn X509_STORE_get_cleanup(X509_STORE *ctx);
  302. #define X509_STORE_get_ex_new_index(l, p, newf, dupf, freef) \
  303. CRYPTO_get_ex_new_index(CRYPTO_EX_INDEX_X509_STORE, l, p, newf, dupf, freef)
  304. int X509_STORE_set_ex_data(X509_STORE *ctx, int idx, void *data);
  305. void *X509_STORE_get_ex_data(X509_STORE *ctx, int idx);
  306. X509_STORE_CTX *X509_STORE_CTX_new(void);
  307. int X509_STORE_CTX_get1_issuer(X509 **issuer, X509_STORE_CTX *ctx, X509 *x);
  308. void X509_STORE_CTX_free(X509_STORE_CTX *ctx);
  309. int X509_STORE_CTX_init(X509_STORE_CTX *ctx, X509_STORE *store,
  310. X509 *x509, STACK_OF(X509) *chain);
  311. void X509_STORE_CTX_set0_trusted_stack(X509_STORE_CTX *ctx, STACK_OF(X509) *sk);
  312. void X509_STORE_CTX_cleanup(X509_STORE_CTX *ctx);
  313. X509_STORE *X509_STORE_CTX_get0_store(X509_STORE_CTX *ctx);
  314. X509 *X509_STORE_CTX_get0_cert(X509_STORE_CTX *ctx);
  315. STACK_OF(X509)* X509_STORE_CTX_get0_untrusted(X509_STORE_CTX *ctx);
  316. void X509_STORE_CTX_set0_untrusted(X509_STORE_CTX *ctx, STACK_OF(X509) *sk);
  317. void X509_STORE_CTX_set_verify_cb(X509_STORE_CTX *ctx,
  318. X509_STORE_CTX_verify_cb verify);
  319. X509_STORE_CTX_verify_cb X509_STORE_CTX_get_verify_cb(X509_STORE_CTX *ctx);
  320. X509_STORE_CTX_verify_fn X509_STORE_CTX_get_verify(X509_STORE_CTX *ctx);
  321. X509_STORE_CTX_get_issuer_fn X509_STORE_CTX_get_get_issuer(X509_STORE_CTX *ctx);
  322. X509_STORE_CTX_check_issued_fn X509_STORE_CTX_get_check_issued(X509_STORE_CTX *ctx);
  323. X509_STORE_CTX_check_revocation_fn X509_STORE_CTX_get_check_revocation(X509_STORE_CTX *ctx);
  324. X509_STORE_CTX_get_crl_fn X509_STORE_CTX_get_get_crl(X509_STORE_CTX *ctx);
  325. X509_STORE_CTX_check_crl_fn X509_STORE_CTX_get_check_crl(X509_STORE_CTX *ctx);
  326. X509_STORE_CTX_cert_crl_fn X509_STORE_CTX_get_cert_crl(X509_STORE_CTX *ctx);
  327. X509_STORE_CTX_check_policy_fn X509_STORE_CTX_get_check_policy(X509_STORE_CTX *ctx);
  328. X509_STORE_CTX_lookup_certs_fn X509_STORE_CTX_get_lookup_certs(X509_STORE_CTX *ctx);
  329. X509_STORE_CTX_lookup_crls_fn X509_STORE_CTX_get_lookup_crls(X509_STORE_CTX *ctx);
  330. X509_STORE_CTX_cleanup_fn X509_STORE_CTX_get_cleanup(X509_STORE_CTX *ctx);
  331. #if OPENSSL_API_COMPAT < 0x10100000L
  332. # define X509_STORE_CTX_get_chain X509_STORE_CTX_get0_chain
  333. # define X509_STORE_CTX_set_chain X509_STORE_CTX_set0_untrusted
  334. # define X509_STORE_CTX_trusted_stack X509_STORE_CTX_set0_trusted_stack
  335. # define X509_STORE_get_by_subject X509_STORE_CTX_get_by_subject
  336. # define X509_STORE_get1_certs X509_STORE_CTX_get1_certs
  337. # define X509_STORE_get1_crls X509_STORE_CTX_get1_crls
  338. /* the following macro is misspelled; use X509_STORE_get1_certs instead */
  339. # define X509_STORE_get1_cert X509_STORE_CTX_get1_certs
  340. /* the following macro is misspelled; use X509_STORE_get1_crls instead */
  341. # define X509_STORE_get1_crl X509_STORE_CTX_get1_crls
  342. #endif
  343. X509_LOOKUP *X509_STORE_add_lookup(X509_STORE *v, X509_LOOKUP_METHOD *m);
  344. X509_LOOKUP_METHOD *X509_LOOKUP_hash_dir(void);
  345. X509_LOOKUP_METHOD *X509_LOOKUP_file(void);
  346. typedef int (*X509_LOOKUP_ctrl_fn)(X509_LOOKUP *ctx, int cmd, const char *argc,
  347. long argl, char **ret);
  348. typedef int (*X509_LOOKUP_get_by_subject_fn)(X509_LOOKUP *ctx,
  349. X509_LOOKUP_TYPE type,
  350. X509_NAME *name,
  351. X509_OBJECT *ret);
  352. typedef int (*X509_LOOKUP_get_by_issuer_serial_fn)(X509_LOOKUP *ctx,
  353. X509_LOOKUP_TYPE type,
  354. X509_NAME *name,
  355. ASN1_INTEGER *serial,
  356. X509_OBJECT *ret);
  357. typedef int (*X509_LOOKUP_get_by_fingerprint_fn)(X509_LOOKUP *ctx,
  358. X509_LOOKUP_TYPE type,
  359. const unsigned char* bytes,
  360. int len,
  361. X509_OBJECT *ret);
  362. typedef int (*X509_LOOKUP_get_by_alias_fn)(X509_LOOKUP *ctx,
  363. X509_LOOKUP_TYPE type,
  364. const char *str,
  365. int len,
  366. X509_OBJECT *ret);
  367. X509_LOOKUP_METHOD *X509_LOOKUP_meth_new(const char *name);
  368. void X509_LOOKUP_meth_free(X509_LOOKUP_METHOD *method);
  369. int X509_LOOKUP_meth_set_new_item(X509_LOOKUP_METHOD *method,
  370. int (*new_item) (X509_LOOKUP *ctx));
  371. int (*X509_LOOKUP_meth_get_new_item(const X509_LOOKUP_METHOD* method))
  372. (X509_LOOKUP *ctx);
  373. int X509_LOOKUP_meth_set_free(X509_LOOKUP_METHOD *method,
  374. void (*free_fn) (X509_LOOKUP *ctx));
  375. void (*X509_LOOKUP_meth_get_free(const X509_LOOKUP_METHOD* method))
  376. (X509_LOOKUP *ctx);
  377. int X509_LOOKUP_meth_set_init(X509_LOOKUP_METHOD *method,
  378. int (*init) (X509_LOOKUP *ctx));
  379. int (*X509_LOOKUP_meth_get_init(const X509_LOOKUP_METHOD* method))
  380. (X509_LOOKUP *ctx);
  381. int X509_LOOKUP_meth_set_shutdown(X509_LOOKUP_METHOD *method,
  382. int (*shutdown) (X509_LOOKUP *ctx));
  383. int (*X509_LOOKUP_meth_get_shutdown(const X509_LOOKUP_METHOD* method))
  384. (X509_LOOKUP *ctx);
  385. int X509_LOOKUP_meth_set_ctrl(X509_LOOKUP_METHOD *method,
  386. X509_LOOKUP_ctrl_fn ctrl_fn);
  387. X509_LOOKUP_ctrl_fn X509_LOOKUP_meth_get_ctrl(const X509_LOOKUP_METHOD *method);
  388. int X509_LOOKUP_meth_set_get_by_subject(X509_LOOKUP_METHOD *method,
  389. X509_LOOKUP_get_by_subject_fn fn);
  390. X509_LOOKUP_get_by_subject_fn X509_LOOKUP_meth_get_get_by_subject(
  391. const X509_LOOKUP_METHOD *method);
  392. int X509_LOOKUP_meth_set_get_by_issuer_serial(X509_LOOKUP_METHOD *method,
  393. X509_LOOKUP_get_by_issuer_serial_fn fn);
  394. X509_LOOKUP_get_by_issuer_serial_fn X509_LOOKUP_meth_get_get_by_issuer_serial(
  395. const X509_LOOKUP_METHOD *method);
  396. int X509_LOOKUP_meth_set_get_by_fingerprint(X509_LOOKUP_METHOD *method,
  397. X509_LOOKUP_get_by_fingerprint_fn fn);
  398. X509_LOOKUP_get_by_fingerprint_fn X509_LOOKUP_meth_get_get_by_fingerprint(
  399. const X509_LOOKUP_METHOD *method);
  400. int X509_LOOKUP_meth_set_get_by_alias(X509_LOOKUP_METHOD *method,
  401. X509_LOOKUP_get_by_alias_fn fn);
  402. X509_LOOKUP_get_by_alias_fn X509_LOOKUP_meth_get_get_by_alias(
  403. const X509_LOOKUP_METHOD *method);
  404. int X509_STORE_add_cert(X509_STORE *ctx, X509 *x);
  405. int X509_STORE_add_crl(X509_STORE *ctx, X509_CRL *x);
  406. int X509_STORE_CTX_get_by_subject(X509_STORE_CTX *vs, X509_LOOKUP_TYPE type,
  407. X509_NAME *name, X509_OBJECT *ret);
  408. X509_OBJECT *X509_STORE_CTX_get_obj_by_subject(X509_STORE_CTX *vs,
  409. X509_LOOKUP_TYPE type,
  410. X509_NAME *name);
  411. int X509_LOOKUP_ctrl(X509_LOOKUP *ctx, int cmd, const char *argc,
  412. long argl, char **ret);
  413. int X509_load_cert_file(X509_LOOKUP *ctx, const char *file, int type);
  414. int X509_load_crl_file(X509_LOOKUP *ctx, const char *file, int type);
  415. int X509_load_cert_crl_file(X509_LOOKUP *ctx, const char *file, int type);
  416. X509_LOOKUP *X509_LOOKUP_new(X509_LOOKUP_METHOD *method);
  417. void X509_LOOKUP_free(X509_LOOKUP *ctx);
  418. int X509_LOOKUP_init(X509_LOOKUP *ctx);
  419. int X509_LOOKUP_by_subject(X509_LOOKUP *ctx, X509_LOOKUP_TYPE type,
  420. X509_NAME *name, X509_OBJECT *ret);
  421. int X509_LOOKUP_by_issuer_serial(X509_LOOKUP *ctx, X509_LOOKUP_TYPE type,
  422. X509_NAME *name, ASN1_INTEGER *serial,
  423. X509_OBJECT *ret);
  424. int X509_LOOKUP_by_fingerprint(X509_LOOKUP *ctx, X509_LOOKUP_TYPE type,
  425. const unsigned char *bytes, int len,
  426. X509_OBJECT *ret);
  427. int X509_LOOKUP_by_alias(X509_LOOKUP *ctx, X509_LOOKUP_TYPE type,
  428. const char *str, int len, X509_OBJECT *ret);
  429. int X509_LOOKUP_set_method_data(X509_LOOKUP *ctx, void *data);
  430. void *X509_LOOKUP_get_method_data(const X509_LOOKUP *ctx);
  431. X509_STORE *X509_LOOKUP_get_store(const X509_LOOKUP *ctx);
  432. int X509_LOOKUP_shutdown(X509_LOOKUP *ctx);
  433. int X509_STORE_load_locations(X509_STORE *ctx,
  434. const char *file, const char *dir);
  435. int X509_STORE_set_default_paths(X509_STORE *ctx);
  436. #define X509_STORE_CTX_get_ex_new_index(l, p, newf, dupf, freef) \
  437. CRYPTO_get_ex_new_index(CRYPTO_EX_INDEX_X509_STORE_CTX, l, p, newf, dupf, freef)
  438. int X509_STORE_CTX_set_ex_data(X509_STORE_CTX *ctx, int idx, void *data);
  439. void *X509_STORE_CTX_get_ex_data(X509_STORE_CTX *ctx, int idx);
  440. int X509_STORE_CTX_get_error(X509_STORE_CTX *ctx);
  441. void X509_STORE_CTX_set_error(X509_STORE_CTX *ctx, int s);
  442. int X509_STORE_CTX_get_error_depth(X509_STORE_CTX *ctx);
  443. void X509_STORE_CTX_set_error_depth(X509_STORE_CTX *ctx, int depth);
  444. X509 *X509_STORE_CTX_get_current_cert(X509_STORE_CTX *ctx);
  445. void X509_STORE_CTX_set_current_cert(X509_STORE_CTX *ctx, X509 *x);
  446. X509 *X509_STORE_CTX_get0_current_issuer(X509_STORE_CTX *ctx);
  447. X509_CRL *X509_STORE_CTX_get0_current_crl(X509_STORE_CTX *ctx);
  448. X509_STORE_CTX *X509_STORE_CTX_get0_parent_ctx(X509_STORE_CTX *ctx);
  449. STACK_OF(X509) *X509_STORE_CTX_get0_chain(X509_STORE_CTX *ctx);
  450. STACK_OF(X509) *X509_STORE_CTX_get1_chain(X509_STORE_CTX *ctx);
  451. void X509_STORE_CTX_set_cert(X509_STORE_CTX *c, X509 *x);
  452. void X509_STORE_CTX_set0_verified_chain(X509_STORE_CTX *c, STACK_OF(X509) *sk);
  453. void X509_STORE_CTX_set0_crls(X509_STORE_CTX *c, STACK_OF(X509_CRL) *sk);
  454. int X509_STORE_CTX_set_purpose(X509_STORE_CTX *ctx, int purpose);
  455. int X509_STORE_CTX_set_trust(X509_STORE_CTX *ctx, int trust);
  456. int X509_STORE_CTX_purpose_inherit(X509_STORE_CTX *ctx, int def_purpose,
  457. int purpose, int trust);
  458. void X509_STORE_CTX_set_flags(X509_STORE_CTX *ctx, unsigned long flags);
  459. void X509_STORE_CTX_set_time(X509_STORE_CTX *ctx, unsigned long flags,
  460. time_t t);
  461. X509_POLICY_TREE *X509_STORE_CTX_get0_policy_tree(X509_STORE_CTX *ctx);
  462. int X509_STORE_CTX_get_explicit_policy(X509_STORE_CTX *ctx);
  463. int X509_STORE_CTX_get_num_untrusted(X509_STORE_CTX *ctx);
  464. X509_VERIFY_PARAM *X509_STORE_CTX_get0_param(X509_STORE_CTX *ctx);
  465. void X509_STORE_CTX_set0_param(X509_STORE_CTX *ctx, X509_VERIFY_PARAM *param);
  466. int X509_STORE_CTX_set_default(X509_STORE_CTX *ctx, const char *name);
  467. /*
  468. * Bridge opacity barrier between libcrypt and libssl, also needed to support
  469. * offline testing in test/danetest.c
  470. */
  471. void X509_STORE_CTX_set0_dane(X509_STORE_CTX *ctx, SSL_DANE *dane);
  472. #define DANE_FLAG_NO_DANE_EE_NAMECHECKS (1L << 0)
  473. /* X509_VERIFY_PARAM functions */
  474. X509_VERIFY_PARAM *X509_VERIFY_PARAM_new(void);
  475. void X509_VERIFY_PARAM_free(X509_VERIFY_PARAM *param);
  476. int X509_VERIFY_PARAM_inherit(X509_VERIFY_PARAM *to,
  477. const X509_VERIFY_PARAM *from);
  478. int X509_VERIFY_PARAM_set1(X509_VERIFY_PARAM *to,
  479. const X509_VERIFY_PARAM *from);
  480. int X509_VERIFY_PARAM_set1_name(X509_VERIFY_PARAM *param, const char *name);
  481. int X509_VERIFY_PARAM_set_flags(X509_VERIFY_PARAM *param,
  482. unsigned long flags);
  483. int X509_VERIFY_PARAM_clear_flags(X509_VERIFY_PARAM *param,
  484. unsigned long flags);
  485. unsigned long X509_VERIFY_PARAM_get_flags(X509_VERIFY_PARAM *param);
  486. int X509_VERIFY_PARAM_set_purpose(X509_VERIFY_PARAM *param, int purpose);
  487. int X509_VERIFY_PARAM_set_trust(X509_VERIFY_PARAM *param, int trust);
  488. void X509_VERIFY_PARAM_set_depth(X509_VERIFY_PARAM *param, int depth);
  489. void X509_VERIFY_PARAM_set_auth_level(X509_VERIFY_PARAM *param, int auth_level);
  490. time_t X509_VERIFY_PARAM_get_time(const X509_VERIFY_PARAM *param);
  491. void X509_VERIFY_PARAM_set_time(X509_VERIFY_PARAM *param, time_t t);
  492. int X509_VERIFY_PARAM_add0_policy(X509_VERIFY_PARAM *param,
  493. ASN1_OBJECT *policy);
  494. int X509_VERIFY_PARAM_set1_policies(X509_VERIFY_PARAM *param,
  495. STACK_OF(ASN1_OBJECT) *policies);
  496. int X509_VERIFY_PARAM_set_inh_flags(X509_VERIFY_PARAM *param,
  497. uint32_t flags);
  498. uint32_t X509_VERIFY_PARAM_get_inh_flags(const X509_VERIFY_PARAM *param);
  499. int X509_VERIFY_PARAM_set1_host(X509_VERIFY_PARAM *param,
  500. const char *name, size_t namelen);
  501. int X509_VERIFY_PARAM_add1_host(X509_VERIFY_PARAM *param,
  502. const char *name, size_t namelen);
  503. void X509_VERIFY_PARAM_set_hostflags(X509_VERIFY_PARAM *param,
  504. unsigned int flags);
  505. unsigned int X509_VERIFY_PARAM_get_hostflags(const X509_VERIFY_PARAM *param);
  506. char *X509_VERIFY_PARAM_get0_peername(X509_VERIFY_PARAM *);
  507. void X509_VERIFY_PARAM_move_peername(X509_VERIFY_PARAM *, X509_VERIFY_PARAM *);
  508. int X509_VERIFY_PARAM_set1_email(X509_VERIFY_PARAM *param,
  509. const char *email, size_t emaillen);
  510. int X509_VERIFY_PARAM_set1_ip(X509_VERIFY_PARAM *param,
  511. const unsigned char *ip, size_t iplen);
  512. int X509_VERIFY_PARAM_set1_ip_asc(X509_VERIFY_PARAM *param,
  513. const char *ipasc);
  514. int X509_VERIFY_PARAM_get_depth(const X509_VERIFY_PARAM *param);
  515. int X509_VERIFY_PARAM_get_auth_level(const X509_VERIFY_PARAM *param);
  516. const char *X509_VERIFY_PARAM_get0_name(const X509_VERIFY_PARAM *param);
  517. int X509_VERIFY_PARAM_add0_table(X509_VERIFY_PARAM *param);
  518. int X509_VERIFY_PARAM_get_count(void);
  519. const X509_VERIFY_PARAM *X509_VERIFY_PARAM_get0(int id);
  520. const X509_VERIFY_PARAM *X509_VERIFY_PARAM_lookup(const char *name);
  521. void X509_VERIFY_PARAM_table_cleanup(void);
  522. /* Non positive return values are errors */
  523. #define X509_PCY_TREE_FAILURE -2 /* Failure to satisfy explicit policy */
  524. #define X509_PCY_TREE_INVALID -1 /* Inconsistent or invalid extensions */
  525. #define X509_PCY_TREE_INTERNAL 0 /* Internal error, most likely malloc */
  526. /*
  527. * Positive return values form a bit mask, all but the first are internal to
  528. * the library and don't appear in results from X509_policy_check().
  529. */
  530. #define X509_PCY_TREE_VALID 1 /* The policy tree is valid */
  531. #define X509_PCY_TREE_EMPTY 2 /* The policy tree is empty */
  532. #define X509_PCY_TREE_EXPLICIT 4 /* Explicit policy required */
  533. int X509_policy_check(X509_POLICY_TREE **ptree, int *pexplicit_policy,
  534. STACK_OF(X509) *certs,
  535. STACK_OF(ASN1_OBJECT) *policy_oids, unsigned int flags);
  536. void X509_policy_tree_free(X509_POLICY_TREE *tree);
  537. int X509_policy_tree_level_count(const X509_POLICY_TREE *tree);
  538. X509_POLICY_LEVEL *X509_policy_tree_get0_level(const X509_POLICY_TREE *tree,
  539. int i);
  540. STACK_OF(X509_POLICY_NODE) *X509_policy_tree_get0_policies(const
  541. X509_POLICY_TREE
  542. *tree);
  543. STACK_OF(X509_POLICY_NODE) *X509_policy_tree_get0_user_policies(const
  544. X509_POLICY_TREE
  545. *tree);
  546. int X509_policy_level_node_count(X509_POLICY_LEVEL *level);
  547. X509_POLICY_NODE *X509_policy_level_get0_node(X509_POLICY_LEVEL *level,
  548. int i);
  549. const ASN1_OBJECT *X509_policy_node_get0_policy(const X509_POLICY_NODE *node);
  550. STACK_OF(POLICYQUALINFO) *X509_policy_node_get0_qualifiers(const
  551. X509_POLICY_NODE
  552. *node);
  553. const X509_POLICY_NODE *X509_policy_node_get0_parent(const X509_POLICY_NODE
  554. *node);
  555. #ifdef __cplusplus
  556. }
  557. #endif
  558. #endif