2 /* Written by Dr Stephen N Henson (shenson@bigfoot.com) for the OpenSSL
5 /* ====================================================================
6 * Copyright (c) 1999 The OpenSSL Project. All rights reserved.
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions
12 * 1. Redistributions of source code must retain the above copyright
13 * notice, this list of conditions and the following disclaimer.
15 * 2. Redistributions in binary form must reproduce the above copyright
16 * notice, this list of conditions and the following disclaimer in
17 * the documentation and/or other materials provided with the
20 * 3. All advertising materials mentioning features or use of this
21 * software must display the following acknowledgment:
22 * "This product includes software developed by the OpenSSL Project
23 * for use in the OpenSSL Toolkit. (http://www.OpenSSL.org/)"
25 * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
26 * endorse or promote products derived from this software without
27 * prior written permission. For written permission, please contact
28 * licensing@OpenSSL.org.
30 * 5. Products derived from this software may not be called "OpenSSL"
31 * nor may "OpenSSL" appear in their names without prior written
32 * permission of the OpenSSL Project.
34 * 6. Redistributions of any form whatsoever must retain the following
36 * "This product includes software developed by the OpenSSL Project
37 * for use in the OpenSSL Toolkit (http://www.OpenSSL.org/)"
39 * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
40 * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
41 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
42 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
43 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
44 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
45 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
46 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
47 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
48 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
49 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
50 * OF THE POSSIBILITY OF SUCH DAMAGE.
51 * ====================================================================
53 * This product includes cryptographic software written by Eric Young
54 * (eay@cryptsoft.com). This product includes software written by Tim
55 * Hudson (tjh@cryptsoft.com).
58 #ifndef HEADER_X509V3_H
59 #define HEADER_X509V3_H
68 /* Forward reference */
74 typedef char * (*X509V3_EXT_NEW)();
75 typedef void (*X509V3_EXT_FREE)();
76 typedef char * (*X509V3_EXT_D2I)();
77 typedef int (*X509V3_EXT_I2D)();
78 typedef STACK * (*X509V3_EXT_I2V)(struct v3_ext_method *method, char *ext, STACK *extlist);
79 typedef char * (*X509V3_EXT_V2I)(struct v3_ext_method *method, struct v3_ext_ctx *ctx, STACK *values);
80 typedef char * (*X509V3_EXT_I2S)(struct v3_ext_method *method, char *ext);
81 typedef char * (*X509V3_EXT_S2I)(struct v3_ext_method *method, struct v3_ext_ctx *ctx, char *str);
82 typedef int (*X509V3_EXT_I2R)(struct v3_ext_method *method, char *ext, BIO *out, int indent);
83 typedef char *(*X509V3_EXT_R2I)(struct v3_ext_method *method, char *db, char *value);
85 /* V3 extension structure */
87 struct v3_ext_method {
90 X509V3_EXT_NEW ext_new;
91 X509V3_EXT_FREE ext_free;
95 /* The following pair is used for string extensions */
99 /* The following pair is used for multi-valued extensions */
103 /* The following are used for raw extensions */
105 X509V3_EXT_R2I r2i; /* Doesn't do anything *YET* */
107 char *usr_data; /* Any extension specific data */
111 /* Context specific info */
117 X509_REQ *subject_req;
119 /* Maybe more here */
122 typedef struct v3_ext_method X509V3_EXT_METHOD;
123 typedef struct v3_ext_ctx X509V3_CTX;
125 /* ext_flags values */
126 #define X509V3_EXT_DYNAMIC 0x1
127 #define X509V3_EXT_CTX_DEP 0x2
128 #define X509V3_EXT_MULTILINE 0x4
130 typedef struct BIT_STRING_BITNAME_st {
134 } BIT_STRING_BITNAME;
136 typedef BIT_STRING_BITNAME ENUMERATED_NAMES;
138 typedef struct BASIC_CONSTRAINTS_st {
140 ASN1_INTEGER *pathlen;
143 typedef struct AUTHORITY_KEYID_st {
144 ASN1_OCTET_STRING *keyid;
146 ASN1_INTEGER *serial;
149 typedef struct PKEY_USAGE_PERIOD_st {
150 ASN1_GENERALIZEDTIME *notBefore;
151 ASN1_GENERALIZEDTIME *notAfter;
154 typedef struct GENERAL_NAME_st {
156 #define GEN_OTHERNAME (0|V_ASN1_CONTEXT_SPECIFIC)
157 #define GEN_EMAIL (1|V_ASN1_CONTEXT_SPECIFIC)
158 #define GEN_DNS (2|V_ASN1_CONTEXT_SPECIFIC)
159 #define GEN_X400 (3|V_ASN1_CONTEXT_SPECIFIC)
160 #define GEN_DIRNAME (4|V_ASN1_CONTEXT_SPECIFIC)
161 #define GEN_EDIPARTY (5|V_ASN1_CONTEXT_SPECIFIC)
162 #define GEN_URI (6|V_ASN1_CONTEXT_SPECIFIC)
163 #define GEN_IPADD (7|V_ASN1_CONTEXT_SPECIFIC)
164 #define GEN_RID (8|V_ASN1_CONTEXT_SPECIFIC)
169 ASN1_IA5STRING *ia5;/* rfc822Name, dNSName, uniformResourceIdentifier */
170 ASN1_OCTET_STRING *ip; /* iPAddress */
171 X509_NAME *dirn; /* dirn */
172 ASN1_OBJECT *rid; /* registeredID */
173 ASN1_TYPE *other; /* otherName, ediPartyName, x400Address */
177 /* Strong extranet structures */
179 typedef struct SXNET_st {
180 ASN1_INTEGER *version;
181 STACK /* SXNETID */ *ids;
184 typedef struct SXNET_ID_st {
186 ASN1_OCTET_STRING *user;
189 #define X509V3_conf_err(val) ERR_add_error_data(6, "section:", val->section, \
190 ",name:", val->name, ",value:", val->value);
192 #define EXT_BITSTRING(nid, table) { nid, 0, \
193 (X509V3_EXT_NEW)asn1_bit_string_new, ASN1_STRING_free, \
194 (X509V3_EXT_D2I)d2i_ASN1_BIT_STRING, \
195 i2d_ASN1_BIT_STRING, \
197 (X509V3_EXT_I2V)i2v_ASN1_BIT_STRING, \
198 (X509V3_EXT_V2I)v2i_ASN1_BIT_STRING, \
202 #define EXT_IA5STRING(nid) { nid, 0, \
203 (X509V3_EXT_NEW)ia5string_new, ASN1_STRING_free, \
204 (X509V3_EXT_D2I)d2i_ASN1_IA5STRING, \
205 i2d_ASN1_IA5STRING, \
206 (X509V3_EXT_I2S)i2s_ASN1_IA5STRING, \
207 (X509V3_EXT_S2I)s2i_ASN1_IA5STRING, \
208 NULL, NULL, NULL, NULL, \
211 #define EXT_END { -1, 0, NULL, NULL, NULL, NULL, NULL, NULL, \
212 NULL, NULL, NULL, NULL, \
216 void ERR_load_X509V3_strings(void);
217 int i2d_BASIC_CONSTRAINTS(BASIC_CONSTRAINTS *a, unsigned char **pp);
218 BASIC_CONSTRAINTS *d2i_BASIC_CONSTRAINTS(BASIC_CONSTRAINTS **a, unsigned char **pp, long length);
219 BASIC_CONSTRAINTS *BASIC_CONSTRAINTS_new(void);
220 void BASIC_CONSTRAINTS_free(BASIC_CONSTRAINTS *a);
222 int i2d_GENERAL_NAME(GENERAL_NAME *a, unsigned char **pp);
223 GENERAL_NAME *d2i_GENERAL_NAME(GENERAL_NAME **a, unsigned char **pp, long length);
224 GENERAL_NAME *GENERAL_NAME_new(void);
225 void GENERAL_NAME_free(GENERAL_NAME *a);
226 STACK *i2v_GENERAL_NAME(X509V3_EXT_METHOD *method, GENERAL_NAME *gen, STACK *ret);
228 int i2d_SXNET(SXNET *a, unsigned char **pp);
229 SXNET *d2i_SXNET(SXNET **a, unsigned char **pp, long length);
230 SXNET *SXNET_new(void);
231 void SXNET_free(SXNET *a);
233 int i2d_SXNETID(SXNETID *a, unsigned char **pp);
234 SXNETID *d2i_SXNETID(SXNETID **a, unsigned char **pp, long length);
235 SXNETID *SXNETID_new(void);
236 void SXNETID_free(SXNETID *a);
238 int SXNET_add_id_asc(SXNET **psx, char *zone, unsigned char *user, int userlen);
239 int SXNET_add_id_ulong(SXNET **psx, unsigned long lzone, unsigned char *user, int userlen);
240 int SXNET_add_id_INTEGER(SXNET **psx, ASN1_INTEGER *izone, unsigned char *user, int userlen);
242 ASN1_OCTET_STRING *SXNET_get_id_asc(SXNET *sx, char *zone);
243 ASN1_OCTET_STRING *SXNET_get_id_ulong(SXNET *sx, unsigned long lzone);
244 ASN1_OCTET_STRING *SXNET_get_id_INTEGER(SXNET *sx, ASN1_INTEGER *zone);
246 int i2d_AUTHORITY_KEYID(AUTHORITY_KEYID *a, unsigned char **pp);
247 AUTHORITY_KEYID *d2i_AUTHORITY_KEYID(AUTHORITY_KEYID **a, unsigned char **pp, long length);
248 AUTHORITY_KEYID *AUTHORITY_KEYID_new(void);
249 void AUTHORITY_KEYID_free(AUTHORITY_KEYID *a);
251 int i2d_PKEY_USAGE_PERIOD(PKEY_USAGE_PERIOD *a, unsigned char **pp);
252 PKEY_USAGE_PERIOD *d2i_PKEY_USAGE_PERIOD(PKEY_USAGE_PERIOD **a, unsigned char **pp, long length);
253 PKEY_USAGE_PERIOD *PKEY_USAGE_PERIOD_new(void);
254 void PKEY_USAGE_PERIOD_free(PKEY_USAGE_PERIOD *a);
256 STACK *GENERAL_NAMES_new(void);
257 void GENERAL_NAMES_free(STACK *a);
258 STACK *d2i_GENERAL_NAMES(STACK **a, unsigned char **pp, long length);
259 int i2d_GENERAL_NAMES(STACK *a, unsigned char **pp);
260 STACK *i2v_GENERAL_NAMES(X509V3_EXT_METHOD *method, STACK *gen, STACK *extlist);
261 STACK *v2i_GENERAL_NAMES(X509V3_EXT_METHOD *method, X509V3_CTX *ctx, STACK *nval);
263 char *i2s_ASN1_OCTET_STRING(X509V3_EXT_METHOD *method, ASN1_OCTET_STRING *ia5);
264 ASN1_OCTET_STRING *s2i_ASN1_OCTET_STRING(X509V3_EXT_METHOD *method, X509V3_CTX *ctx, char *str);
266 int i2d_ext_ku(STACK *a, unsigned char **pp);
267 STACK *d2i_ext_ku(STACK **a, unsigned char **pp, long length);
268 void ext_ku_free(STACK *a);
269 STACK *ext_ku_new(void);
272 GENERAL_NAME *v2i_GENERAL_NAME(X509V3_EXT_METHOD *method, X509V3_CTX *ctx, CONF_VALUE *cnf);
273 void X509V3_conf_free(CONF_VALUE *val);
274 X509_EXTENSION *X509V3_EXT_conf_nid(LHASH *conf, X509V3_CTX *ctx, int ext_nid, char *value);
275 X509_EXTENSION *X509V3_EXT_conf(LHASH *conf, X509V3_CTX *ctx, char *name, char *value);
276 int X509V3_EXT_add_conf(LHASH *conf, X509V3_CTX *ctx, char *section, X509 *cert);
277 int X509V3_EXT_CRL_add_conf(LHASH *conf, X509V3_CTX *ctx, char *section, X509_CRL *crl);
278 int X509V3_EXT_check_conf(LHASH *conf, char *section);
279 int X509V3_get_value_bool(CONF_VALUE *value, int *asn1_bool);
280 int X509V3_get_value_int(CONF_VALUE *value, ASN1_INTEGER **aint);
283 int X509V3_add_value(char *name, char *value, STACK **extlist);
284 int X509V3_add_value_bool(char *name, int asn1_bool, STACK **extlist);
285 int X509V3_add_value_int( char *name, ASN1_INTEGER *aint, STACK **extlist);
286 char * i2s_ASN1_INTEGER(X509V3_EXT_METHOD *meth, ASN1_INTEGER *aint);
287 ASN1_INTEGER * s2i_ASN1_INTEGER(X509V3_EXT_METHOD *meth, char *value);
288 char * i2s_ASN1_ENUMERATED(X509V3_EXT_METHOD *meth, ASN1_ENUMERATED *aint);
289 char * i2s_ASN1_ENUMERATED_TABLE(X509V3_EXT_METHOD *meth, ASN1_ENUMERATED *aint);
290 int X509V3_EXT_add(X509V3_EXT_METHOD *ext);
291 int X509V3_EXT_add_alias(int nid_to, int nid_from);
292 void X509V3_EXT_cleanup(void);
294 X509V3_EXT_METHOD *X509V3_EXT_get(X509_EXTENSION *ext);
295 X509V3_EXT_METHOD *X509V3_EXT_get_nid(int nid);
296 int X509V3_add_standard_extensions(void);
297 STACK *X509V3_parse_list(char *line);
298 char *X509V3_EXT_d2i(X509_EXTENSION *ext);
300 char *hex_to_string(unsigned char *buffer, long len);
301 unsigned char *string_to_hex(char *str, long *len);
302 int name_cmp(char *name, char *cmp);
304 int X509V3_EXT_print(BIO *out, X509_EXTENSION *ext, int flag, int indent);
305 int X509V3_EXT_print_fp(FILE *out, X509_EXTENSION *ext, int flag, int indent);
309 void ERR_load_X509V3_strings();
310 int i2d_BASIC_CONSTRAINTS();
311 BASIC_CONSTRAINTS *d2i_BASIC_CONSTRAINTS();
312 BASIC_CONSTRAINTS *BASIC_CONSTRAINTS_new();
313 void BASIC_CONSTRAINTS_free();
315 int i2d_GENERAL_NAME();
316 GENERAL_NAME *d2i_GENERAL_NAME();
317 GENERAL_NAME *GENERAL_NAME_new();
318 void GENERAL_NAME_free();
319 STACK *i2v_GENERAL_NAME();
320 GENERAL_NAME *v2i_GENERAL_NAME();
328 SXNETID *d2i_SXNETID();
329 SXNETID *SXNETID_new();
331 int SXNET_add_id_asc();
332 int SXNET_add_id_ulong();
333 int SXNET_add_id_INTEGER();
334 ASN1_OCTET_STRING *SXNET_get_id_asc();
335 ASN1_OCTET_STRING *SXNET_get_id_ulong();
336 ASN1_OCTET_STRING *SXNET_get_id_INTEGER();
338 int i2d_AUTHORITY_KEYID();
339 AUTHORITY_KEYID *d2i_AUTHORITY_KEYID();
340 AUTHORITY_KEYID *AUTHORITY_KEYID_new();
341 void AUTHORITY_KEYID_free();
343 int i2d_PKEY_USAGE_PERIOD();
344 PKEY_USAGE_PERIOD *d2i_PKEY_USAGE_PERIOD();
345 PKEY_USAGE_PERIOD *PKEY_USAGE_PERIOD_new();
346 void PKEY_USAGE_PERIOD_free();
348 STACK *GENERAL_NAMES_new():
349 void GENERAL_NAMES_free():
350 STACK *d2i_GENERAL_NAMES();
351 int i2d_GENERAL_NAMES();
352 STACK *i2v_GENERAL_NAMES();
353 STACK *v2i_GENERAL_NAMES();
355 char *i2s_ASN1_OCTET_STRING();
356 ASN1_OCTET_STRING *s2i_ASN1_OCTET_STRING();
364 void X509V3_conf_free();
365 X509_EXTENSION *X509V3_EXT_conf_nid();
366 X509_EXTENSION *X509V3_EXT_conf();
367 int X509V3_EXT_add_conf();
368 int X509V3_EXT_check_conf();
369 int X509V3_get_value_bool();
370 int X509V3_get_value_int();
373 int X509V3_add_value();
374 int X509V3_add_value_bool();
375 int X509V3_add_value_int();
376 char *i2s_ASN1_INTEGER();
377 ASN1_INTEGER * s2i_ASN1_INTEGER();
378 char * i2s_ASN1_ENUMERATED();
379 char * i2s_ASN1_ENUMERATED_TABLE();
380 int X509V3_EXT_add();
381 int X509V3_EXT_CRL_add_conf();
382 int X509V3_EXT_add_alias();
383 void X509V3_EXT_cleanup();
385 X509V3_EXT_METHOD *X509V3_EXT_get();
386 X509V3_EXT_METHOD *X509V3_EXT_get_nid();
387 int X509V3_add_standard_extensions();
388 STACK *X509V3_parse_list();
389 char *X509V3_EXT_d2i();
391 char *hex_to_string();
392 unsigned char *string_to_hex();
395 int X509V3_EXT_print();
396 int X509V3_EXT_print_fp();
399 /* BEGIN ERROR CODES */
400 /* Error codes for the X509V3 functions. */
402 /* Function codes. */
403 #define X509V3_F_COPY_EMAIL 122
404 #define X509V3_F_COPY_ISSUER 123
405 #define X509V3_F_DO_EXT_CONF 124
406 #define X509V3_F_HEX_TO_STRING 111
407 #define X509V3_F_I2S_ASN1_ENUMERATED 121
408 #define X509V3_F_I2S_ASN1_INTEGER 120
409 #define X509V3_F_S2I_ASN1_IA5STRING 100
410 #define X509V3_F_S2I_ASN1_INTEGER 108
411 #define X509V3_F_S2I_ASN1_OCTET_STRING 112
412 #define X509V3_F_S2I_ASN1_SKEY_ID 114
413 #define X509V3_F_S2I_S2I_SKEY_ID 115
414 #define X509V3_F_STRING_TO_HEX 113
415 #define X509V3_F_SXNET_ADD_ASC 125
416 #define X509V3_F_SXNET_ADD_ID_INTEGER 126
417 #define X509V3_F_SXNET_ADD_ID_ULONG 127
418 #define X509V3_F_SXNET_GET_ID_ASC 128
419 #define X509V3_F_SXNET_GET_ID_ULONG 129
420 #define X509V3_F_V2I_ASN1_BIT_STRING 101
421 #define X509V3_F_V2I_AUTHORITY_KEYID 119
422 #define X509V3_F_V2I_BASIC_CONSTRAINTS 102
423 #define X509V3_F_V2I_EXT_KU 103
424 #define X509V3_F_V2I_GENERAL_NAME 117
425 #define X509V3_F_V2I_GENERAL_NAMES 118
426 #define X509V3_F_V3_GENERIC_EXTENSION 116
427 #define X509V3_F_X509V3_EXT_ADD 104
428 #define X509V3_F_X509V3_ADD_VALUE 105
429 #define X509V3_F_X509V3_EXT_ADD_ALIAS 106
430 #define X509V3_F_X509V3_EXT_CONF 107
431 #define X509V3_F_X509V3_PARSE_LIST 109
432 #define X509V3_F_X509V3_GET_VALUE_BOOL 110
435 #define X509V3_R_BAD_IP_ADDRESS 118
436 #define X509V3_R_BAD_OBJECT 119
437 #define X509V3_R_BN_DEC2BN_ERROR 100
438 #define X509V3_R_BN_TO_ASN1_INTEGER_ERROR 101
439 #define X509V3_R_DUPLICATE_ZONE_ID 133
440 #define X509V3_R_ERROR_CONVERTING_ZONE 131
441 #define X509V3_R_ERROR_IN_EXTENSION 128
442 #define X509V3_R_EXTENSION_NAME_ERROR 115
443 #define X509V3_R_EXTENSION_NOT_FOUND 102
444 #define X509V3_R_EXTENSION_SETTING_NOT_SUPPORTED 103
445 #define X509V3_R_EXTENSION_VALUE_ERROR 116
446 #define X509V3_R_ILLEGAL_HEX_DIGIT 113
447 #define X509V3_R_INVALID_BOOLEAN_STRING 104
448 #define X509V3_R_INVALID_EXTENSION_STRING 105
449 #define X509V3_R_INVALID_NAME 106
450 #define X509V3_R_INVALID_NULL_ARGUMENT 107
451 #define X509V3_R_INVALID_NULL_NAME 108
452 #define X509V3_R_INVALID_NULL_VALUE 109
453 #define X509V3_R_INVALID_OBJECT_IDENTIFIER 110
454 #define X509V3_R_ISSUER_DECODE_ERROR 126
455 #define X509V3_R_MISSING_VALUE 124
456 #define X509V3_R_NO_ISSUER_CERTIFICATE 121
457 #define X509V3_R_NO_ISSUER_DETAILS 127
458 #define X509V3_R_NO_PUBLIC_KEY 114
459 #define X509V3_R_NO_SUBJECT_DETAILS 125
460 #define X509V3_R_ODD_NUMBER_OF_DIGITS 112
461 #define X509V3_R_UNABLE_TO_GET_ISSUER_DETAILS 122
462 #define X509V3_R_UNABLE_TO_GET_ISSUER_KEYID 123
463 #define X509V3_R_UNKNOWN_BIT_STRING_ARGUMENT 111
464 #define X509V3_R_UNKNOWN_EXTENSION 129
465 #define X509V3_R_UNKNOWN_EXTENSION_NAME 130
466 #define X509V3_R_UNKNOWN_OPTION 120
467 #define X509V3_R_UNSUPPORTED_OPTION 117
468 #define X509V3_R_USER_TOO_LONG 132