]>
Commit | Line | Data |
---|---|---|
d02b48c6 | 1 | /* crypto/x509/x509_vfy.h */ |
58964a49 | 2 | /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com) |
d02b48c6 RE |
3 | * All rights reserved. |
4 | * | |
5 | * This package is an SSL implementation written | |
6 | * by Eric Young (eay@cryptsoft.com). | |
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 (tjh@cryptsoft.com). | |
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 (eay@cryptsoft.com)" | |
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 (tjh@cryptsoft.com)" | |
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 | ||
59 | #ifndef HEADER_X509_VFY_H | |
60 | #define HEADER_X509_VFY_H | |
61 | ||
62 | #ifdef __cplusplus | |
63 | extern "C" { | |
64 | #endif | |
65 | ||
58964a49 RE |
66 | #include "bio.h" |
67 | #include "crypto.h" | |
68 | ||
d02b48c6 RE |
69 | /* Outer object */ |
70 | typedef struct x509_hash_dir_st | |
71 | { | |
72 | int num_dirs; | |
73 | char **dirs; | |
74 | int *dirs_type; | |
75 | int num_dirs_alloced; | |
76 | } X509_HASH_DIR_CTX; | |
77 | ||
78 | typedef struct x509_file_st | |
79 | { | |
80 | int num_paths; /* number of paths to files or directories */ | |
81 | int num_alloced; | |
82 | char **paths; /* the list of paths or directories */ | |
83 | int *path_type; | |
84 | } X509_CERT_FILE_CTX; | |
85 | ||
86 | /*******************************/ | |
87 | /* | |
88 | SSL_CTX -> X509_STORE | |
89 | -> X509_LOOKUP | |
90 | ->X509_LOOKUP_METHOD | |
91 | -> X509_LOOKUP | |
92 | ->X509_LOOKUP_METHOD | |
93 | ||
94 | SSL -> X509_STORE_CTX | |
95 | ->X509_STORE | |
96 | ||
97 | The X509_STORE holds the tables etc for verification stuff. | |
98 | A X509_STORE_CTX is used while validating a single certificate. | |
99 | The X509_STORE has X509_LOOKUPs for looking up certs. | |
100 | The X509_STORE then calls a function to actually verify the | |
101 | certificate chain. | |
102 | */ | |
103 | ||
104 | #define X509_LU_RETRY -1 | |
105 | #define X509_LU_FAIL 0 | |
106 | #define X509_LU_X509 1 | |
107 | #define X509_LU_CRL 2 | |
108 | #define X509_LU_PKEY 3 | |
109 | ||
110 | typedef struct x509_object_st | |
111 | { | |
112 | /* one of the above types */ | |
113 | int type; | |
114 | union { | |
115 | char *ptr; | |
116 | X509 *x509; | |
117 | X509_CRL *crl; | |
118 | EVP_PKEY *pkey; | |
119 | } data; | |
120 | } X509_OBJECT; | |
121 | ||
122 | /* This is a static that defines the function interface */ | |
123 | typedef struct x509_lookup_method_st | |
124 | { | |
125 | char *name; | |
126 | int (*new_item)(); | |
127 | void (*free)(); | |
128 | int (*init)(/* meth, char ** */); | |
129 | int (*shutdown)( /* meth, char ** */); | |
130 | int (*ctrl)( /* meth, char **, int cmd, char *argp, int argi */); | |
131 | int (*get_by_subject)(/* meth, char **, XNAME *, X509 **ret */); | |
132 | int (*get_by_issuer_serial)(); | |
133 | int (*get_by_fingerprint)(); | |
134 | int (*get_by_alias)(); | |
135 | } X509_LOOKUP_METHOD; | |
136 | ||
137 | /* This is used to hold everything. It is used for all certificate | |
138 | * validation. Once we have a certificate chain, the 'verify' | |
139 | * function is then called to actually check the cert chain. */ | |
140 | typedef struct x509_store_st | |
141 | { | |
142 | /* The following is a cache of trusted certs */ | |
143 | int cache; /* if true, stash any hits */ | |
144 | #ifdef HEADER_LHASH_H | |
145 | LHASH *certs; /* cached certs; */ | |
146 | #else | |
147 | char *certs; | |
148 | #endif | |
149 | ||
150 | /* These are external lookup methods */ | |
151 | STACK *get_cert_methods;/* X509_LOOKUP */ | |
152 | int (*verify)(); /* called to verify a certificate */ | |
153 | int (*verify_cb)(); /* error callback */ | |
154 | ||
58964a49 | 155 | CRYPTO_EX_DATA ex_data; |
d02b48c6 RE |
156 | int references; |
157 | int depth; /* how deep to look */ | |
158 | } X509_STORE; | |
159 | ||
58964a49 | 160 | #define X509_STORE_set_depth(ctx,d) ((ctx)->depth=(d)) |
d02b48c6 RE |
161 | |
162 | #define X509_STORE_set_verify_cb_func(ctx,func) ((ctx)->verify_cb=(func)) | |
163 | #define X509_STORE_set_verify_func(ctx,func) ((ctx)->verify=(func)) | |
164 | ||
165 | /* This is the functions plus an instance of the local variables. */ | |
166 | typedef struct x509_lookup_st | |
167 | { | |
168 | int init; /* have we been started */ | |
169 | int skip; /* don't use us. */ | |
170 | X509_LOOKUP_METHOD *method; /* the functions */ | |
171 | char *method_data; /* method data */ | |
172 | ||
173 | X509_STORE *store_ctx; /* who owns us */ | |
174 | } X509_LOOKUP; | |
175 | ||
176 | /* This is a temporary used when processing cert chains. Since the | |
177 | * gathering of the cert chain can take some time (and have to be | |
178 | * 'retried', this needs to be kept and passed around. */ | |
179 | typedef struct x509_store_state_st | |
180 | { | |
181 | X509_STORE *ctx; | |
182 | int current_method; /* used when looking up certs */ | |
183 | ||
184 | /* The following are set by the caller */ | |
185 | X509 *cert; /* The cert to check */ | |
186 | STACK *untrusted; /* chain of X509s - untrusted - passed in */ | |
187 | ||
188 | /* The following is built up */ | |
189 | int depth; /* how far to go looking up certs */ | |
190 | int valid; /* if 0, rebuild chain */ | |
191 | int last_untrusted; /* index of last untrusted cert */ | |
192 | STACK *chain; /* chain of X509s - built up and trusted */ | |
193 | ||
194 | /* When something goes wrong, this is why */ | |
195 | int error_depth; | |
196 | int error; | |
197 | X509 *current_cert; | |
198 | ||
58964a49 | 199 | CRYPTO_EX_DATA ex_data; |
d02b48c6 RE |
200 | } X509_STORE_CTX; |
201 | ||
58964a49 RE |
202 | #define X509_STORE_CTX_set_app_data(ctx,data) \ |
203 | X509_STORE_CTX_set_ex_data(ctx,0,data) | |
204 | #define X509_STORE_CTX_get_app_data(ctx) \ | |
205 | X509_STORE_CTX_get_ex_data(ctx,0) | |
d02b48c6 RE |
206 | |
207 | #define X509_L_FILE_LOAD 1 | |
208 | #define X509_L_ADD_DIR 2 | |
209 | ||
210 | X509_LOOKUP_METHOD *X509_LOOKUP_file(); | |
211 | #define X509_LOOKUP_load_file(x,name,type) \ | |
212 | X509_LOOKUP_ctrl((x),X509_L_FILE_LOAD,(name),(long)(type),NULL) | |
213 | ||
214 | X509_LOOKUP_METHOD *X509_LOOKUP_dir(); | |
215 | #define X509_LOOKUP_add_dir(x,name,type) \ | |
216 | X509_LOOKUP_ctrl((x),X509_L_ADD_DIR,(name),(long)(type),NULL) | |
217 | ||
218 | #define X509_V_OK 0 | |
219 | ||
220 | #define X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT 2 | |
221 | #define X509_V_ERR_UNABLE_TO_GET_CRL 3 | |
222 | #define X509_V_ERR_UNABLE_TO_DECRYPT_CERT_SIGNATURE 4 | |
223 | #define X509_V_ERR_UNABLE_TO_DECRYPT_CRL_SIGNATURE 5 | |
224 | #define X509_V_ERR_UNABLE_TO_DECODE_ISSUER_PUBLIC_KEY 6 | |
225 | #define X509_V_ERR_CERT_SIGNATURE_FAILURE 7 | |
226 | #define X509_V_ERR_CRL_SIGNATURE_FAILURE 8 | |
227 | #define X509_V_ERR_CERT_NOT_YET_VALID 9 | |
228 | #define X509_V_ERR_CERT_HAS_EXPIRED 10 | |
229 | #define X509_V_ERR_CRL_NOT_YET_VALID 11 | |
230 | #define X509_V_ERR_CRL_HAS_EXPIRED 12 | |
231 | #define X509_V_ERR_ERROR_IN_CERT_NOT_BEFORE_FIELD 13 | |
232 | #define X509_V_ERR_ERROR_IN_CERT_NOT_AFTER_FIELD 14 | |
58964a49 RE |
233 | #define X509_V_ERR_ERROR_IN_CRL_LAST_UPDATE_FIELD 15 |
234 | #define X509_V_ERR_ERROR_IN_CRL_NEXT_UPDATE_FIELD 16 | |
d02b48c6 RE |
235 | #define X509_V_ERR_OUT_OF_MEM 17 |
236 | #define X509_V_ERR_DEPTH_ZERO_SELF_SIGNED_CERT 18 | |
237 | #define X509_V_ERR_SELF_SIGNED_CERT_IN_CHAIN 19 | |
238 | #define X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT_LOCALLY 20 | |
239 | #define X509_V_ERR_UNABLE_TO_VERIFY_LEAF_SIGNATURE 21 | |
240 | #define X509_V_ERR_CERT_CHAIN_TOO_LONG 22 | |
58964a49 RE |
241 | #define X509_V_ERR_CERT_REVOKED 23 |
242 | ||
243 | /* The application is not happy */ | |
244 | #define X509_V_ERR_APPLICATION_VERIFICATION 50 | |
d02b48c6 RE |
245 | |
246 | #ifndef NOPROTO | |
247 | #ifdef HEADER_LHASH_H | |
dfeab068 | 248 | X509_OBJECT *X509_OBJECT_retrieve_by_subject(LHASH *h,int type,X509_NAME *name); |
d02b48c6 RE |
249 | #endif |
250 | void X509_OBJECT_up_ref_count(X509_OBJECT *a); | |
251 | void X509_OBJECT_free_contents(X509_OBJECT *a); | |
252 | X509_STORE *X509_STORE_new(void ); | |
253 | void X509_STORE_free(X509_STORE *v); | |
254 | ||
255 | void X509_STORE_CTX_init(X509_STORE_CTX *ctx, X509_STORE *store, | |
256 | X509 *x509, STACK *chain); | |
257 | void X509_STORE_CTX_cleanup(X509_STORE_CTX *ctx); | |
258 | ||
259 | X509_LOOKUP *X509_STORE_add_lookup(X509_STORE *v, X509_LOOKUP_METHOD *m); | |
260 | ||
261 | X509_LOOKUP_METHOD *X509_LOOKUP_hash_dir(void); | |
262 | X509_LOOKUP_METHOD *X509_LOOKUP_file(void); | |
263 | ||
264 | int X509_STORE_add_cert(X509_STORE *ctx, X509 *x); | |
58964a49 | 265 | int X509_STORE_add_crl(X509_STORE *ctx, X509_CRL *x); |
d02b48c6 RE |
266 | |
267 | int X509_STORE_get_by_subject(X509_STORE_CTX *vs,int type,X509_NAME *name, | |
268 | X509_OBJECT *ret); | |
269 | ||
270 | int X509_LOOKUP_ctrl(X509_LOOKUP *ctx,int cmd,char *argc,long argl,char **ret); | |
58964a49 RE |
271 | |
272 | #ifndef NO_STDIO | |
d02b48c6 | 273 | int X509_load_cert_file(X509_LOOKUP *ctx, char *file, int type); |
58964a49 RE |
274 | int X509_load_crl_file(X509_LOOKUP *ctx, char *file, int type); |
275 | #endif | |
d02b48c6 RE |
276 | |
277 | void X509v3_cleanup_extensions(void ); | |
278 | int X509v3_add_extension(X509_EXTENSION_METHOD *x); | |
279 | int X509v3_add_netscape_extensions(void ); | |
280 | int X509v3_add_standard_extensions(void ); | |
281 | ||
282 | X509_LOOKUP *X509_LOOKUP_new(X509_LOOKUP_METHOD *method); | |
283 | void X509_LOOKUP_free(X509_LOOKUP *ctx); | |
284 | int X509_LOOKUP_init(X509_LOOKUP *ctx); | |
285 | int X509_LOOKUP_by_subject(X509_LOOKUP *ctx, int type, X509_NAME *name, | |
286 | X509_OBJECT *ret); | |
287 | int X509_LOOKUP_by_issuer_serial(X509_LOOKUP *ctx, int type, X509_NAME *name, | |
288 | ASN1_INTEGER *serial, X509_OBJECT *ret); | |
289 | int X509_LOOKUP_by_fingerprint(X509_LOOKUP *ctx, int type, | |
290 | unsigned char *bytes, int len, X509_OBJECT *ret); | |
291 | int X509_LOOKUP_by_alias(X509_LOOKUP *ctx, int type, char *str, | |
292 | int len, X509_OBJECT *ret); | |
293 | int X509_LOOKUP_shutdown(X509_LOOKUP *ctx); | |
294 | ||
58964a49 | 295 | #ifndef NO_STDIO |
d02b48c6 RE |
296 | int X509_STORE_load_locations (X509_STORE *ctx, |
297 | char *file, char *dir); | |
298 | int X509_STORE_set_default_paths(X509_STORE *ctx); | |
58964a49 RE |
299 | #endif |
300 | ||
301 | int X509_STORE_CTX_get_ex_new_index(long argl, char *argp, int (*new_func)(), | |
302 | int (*dup_func)(), void (*free_func)()); | |
303 | int X509_STORE_CTX_set_ex_data(X509_STORE_CTX *ctx,int idx,char *data); | |
304 | char * X509_STORE_CTX_get_ex_data(X509_STORE_CTX *ctx,int idx); | |
305 | int X509_STORE_CTX_get_error(X509_STORE_CTX *ctx); | |
306 | void X509_STORE_CTX_set_error(X509_STORE_CTX *ctx,int s); | |
307 | int X509_STORE_CTX_get_error_depth(X509_STORE_CTX *ctx); | |
308 | X509 * X509_STORE_CTX_get_current_cert(X509_STORE_CTX *ctx); | |
309 | STACK * X509_STORE_CTX_get_chain(X509_STORE_CTX *ctx); | |
310 | void X509_STORE_CTX_set_cert(X509_STORE_CTX *c,X509 *x); | |
311 | void X509_STORE_CTX_set_chain(X509_STORE_CTX *c,STACK /* X509 */ *sk); | |
d02b48c6 RE |
312 | |
313 | #else | |
314 | ||
315 | #ifdef HEADER_LHASH_H | |
dfeab068 | 316 | X509_OBJECT *X509_OBJECT_retrieve_by_subject(); |
d02b48c6 RE |
317 | #endif |
318 | void X509_OBJECT_up_ref_count(); | |
319 | void X509_OBJECT_free_contents(); | |
320 | X509_STORE *X509_STORE_new(); | |
321 | void X509_STORE_free(); | |
322 | ||
323 | void X509_STORE_CTX_init(); | |
324 | void X509_STORE_CTX_cleanup(); | |
325 | ||
326 | X509_LOOKUP *X509_STORE_add_lookup(); | |
327 | ||
328 | X509_LOOKUP_METHOD *X509_LOOKUP_hash_dir(); | |
329 | X509_LOOKUP_METHOD *X509_LOOKUP_file(); | |
330 | ||
331 | int X509_STORE_add_cert(); | |
58964a49 | 332 | int X509_STORE_add_crl(); |
d02b48c6 RE |
333 | |
334 | int X509_STORE_get_by_subject(); | |
335 | ||
336 | int X509_LOOKUP_ctrl(); | |
58964a49 RE |
337 | |
338 | #ifndef NO_STDIO | |
d02b48c6 | 339 | int X509_load_cert_file(); |
58964a49 RE |
340 | int X509_load_crl_file(); |
341 | #endif | |
d02b48c6 RE |
342 | |
343 | void X509v3_cleanup_extensions(); | |
344 | int X509v3_add_extension(); | |
345 | int X509v3_add_netscape_extensions(); | |
346 | int X509v3_add_standard_extensions(); | |
347 | ||
348 | X509_LOOKUP *X509_LOOKUP_new(); | |
349 | void X509_LOOKUP_free(); | |
350 | int X509_LOOKUP_init(); | |
351 | int X509_LOOKUP_by_subject(); | |
352 | int X509_LOOKUP_by_issuer_serial(); | |
353 | int X509_LOOKUP_by_fingerprint(); | |
354 | int X509_LOOKUP_by_alias(); | |
355 | int X509_LOOKUP_shutdown(); | |
356 | ||
58964a49 | 357 | #ifndef NO_STDIO |
d02b48c6 RE |
358 | int X509_STORE_load_locations (); |
359 | int X509_STORE_set_default_paths(); | |
58964a49 RE |
360 | #endif |
361 | ||
dfeab068 | 362 | int X509_STORE_CTX_get_ex_new_index(); |
58964a49 RE |
363 | int X509_STORE_CTX_set_ex_data(); |
364 | char * X509_STORE_CTX_get_ex_data(); | |
365 | int X509_STORE_CTX_get_error(); | |
366 | void X509_STORE_CTX_set_error(); | |
367 | int X509_STORE_CTX_get_error_depth(); | |
368 | X509 * X509_STORE_CTX_get_current_cert(); | |
369 | STACK * X509_STORE_CTX_get_chain(); | |
370 | void X509_STORE_CTX_set_cert(); | |
371 | void X509_STORE_CTX_set_chain(); | |
d02b48c6 RE |
372 | |
373 | #endif | |
374 | ||
375 | #ifdef __cplusplus | |
376 | } | |
377 | #endif | |
378 | #endif | |
379 |