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