Line data Source code
1 : /*
2 : * Copyright 1999-2021 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_X509V3_H
11 : # define HEADER_X509V3_H
12 :
13 : # include <openssl/bio.h>
14 : # include <openssl/x509.h>
15 : # include <openssl/conf.h>
16 : # include <openssl/x509v3err.h>
17 :
18 : #ifdef __cplusplus
19 : extern "C" {
20 : #endif
21 :
22 : /* Forward reference */
23 : struct v3_ext_method;
24 : struct v3_ext_ctx;
25 :
26 : /* Useful typedefs */
27 :
28 : typedef void *(*X509V3_EXT_NEW)(void);
29 : typedef void (*X509V3_EXT_FREE) (void *);
30 : typedef void *(*X509V3_EXT_D2I)(void *, const unsigned char **, long);
31 : typedef int (*X509V3_EXT_I2D) (void *, unsigned char **);
32 : typedef STACK_OF(CONF_VALUE) *
33 : (*X509V3_EXT_I2V) (const struct v3_ext_method *method, void *ext,
34 : STACK_OF(CONF_VALUE) *extlist);
35 : typedef void *(*X509V3_EXT_V2I)(const struct v3_ext_method *method,
36 : struct v3_ext_ctx *ctx,
37 : STACK_OF(CONF_VALUE) *values);
38 : typedef char *(*X509V3_EXT_I2S)(const struct v3_ext_method *method,
39 : void *ext);
40 : typedef void *(*X509V3_EXT_S2I)(const struct v3_ext_method *method,
41 : struct v3_ext_ctx *ctx, const char *str);
42 : typedef int (*X509V3_EXT_I2R) (const struct v3_ext_method *method, void *ext,
43 : BIO *out, int indent);
44 : typedef void *(*X509V3_EXT_R2I)(const struct v3_ext_method *method,
45 : struct v3_ext_ctx *ctx, const char *str);
46 :
47 : /* V3 extension structure */
48 :
49 : struct v3_ext_method {
50 : int ext_nid;
51 : int ext_flags;
52 : /* If this is set the following four fields are ignored */
53 : ASN1_ITEM_EXP *it;
54 : /* Old style ASN1 calls */
55 : X509V3_EXT_NEW ext_new;
56 : X509V3_EXT_FREE ext_free;
57 : X509V3_EXT_D2I d2i;
58 : X509V3_EXT_I2D i2d;
59 : /* The following pair is used for string extensions */
60 : X509V3_EXT_I2S i2s;
61 : X509V3_EXT_S2I s2i;
62 : /* The following pair is used for multi-valued extensions */
63 : X509V3_EXT_I2V i2v;
64 : X509V3_EXT_V2I v2i;
65 : /* The following are used for raw extensions */
66 : X509V3_EXT_I2R i2r;
67 : X509V3_EXT_R2I r2i;
68 : void *usr_data; /* Any extension specific data */
69 : };
70 :
71 : typedef struct X509V3_CONF_METHOD_st {
72 : char *(*get_string) (void *db, const char *section, const char *value);
73 : STACK_OF(CONF_VALUE) *(*get_section) (void *db, const char *section);
74 : void (*free_string) (void *db, char *string);
75 : void (*free_section) (void *db, STACK_OF(CONF_VALUE) *section);
76 : } X509V3_CONF_METHOD;
77 :
78 : /* Context specific info */
79 : struct v3_ext_ctx {
80 : # define CTX_TEST 0x1
81 : # define X509V3_CTX_REPLACE 0x2
82 : int flags;
83 : X509 *issuer_cert;
84 : X509 *subject_cert;
85 : X509_REQ *subject_req;
86 : X509_CRL *crl;
87 : X509V3_CONF_METHOD *db_meth;
88 : void *db;
89 : /* Maybe more here */
90 : };
91 :
92 : typedef struct v3_ext_method X509V3_EXT_METHOD;
93 :
94 : DEFINE_STACK_OF(X509V3_EXT_METHOD)
95 :
96 : /* ext_flags values */
97 : # define X509V3_EXT_DYNAMIC 0x1
98 : # define X509V3_EXT_CTX_DEP 0x2
99 : # define X509V3_EXT_MULTILINE 0x4
100 :
101 : typedef BIT_STRING_BITNAME ENUMERATED_NAMES;
102 :
103 : typedef struct BASIC_CONSTRAINTS_st {
104 : int ca;
105 : ASN1_INTEGER *pathlen;
106 : } BASIC_CONSTRAINTS;
107 :
108 : typedef struct PKEY_USAGE_PERIOD_st {
109 : ASN1_GENERALIZEDTIME *notBefore;
110 : ASN1_GENERALIZEDTIME *notAfter;
111 : } PKEY_USAGE_PERIOD;
112 :
113 : typedef struct otherName_st {
114 : ASN1_OBJECT *type_id;
115 : ASN1_TYPE *value;
116 : } OTHERNAME;
117 :
118 : typedef struct EDIPartyName_st {
119 : ASN1_STRING *nameAssigner;
120 : ASN1_STRING *partyName;
121 : } EDIPARTYNAME;
122 :
123 : typedef struct GENERAL_NAME_st {
124 : # define GEN_OTHERNAME 0
125 : # define GEN_EMAIL 1
126 : # define GEN_DNS 2
127 : # define GEN_X400 3
128 : # define GEN_DIRNAME 4
129 : # define GEN_EDIPARTY 5
130 : # define GEN_URI 6
131 : # define GEN_IPADD 7
132 : # define GEN_RID 8
133 : int type;
134 : union {
135 : char *ptr;
136 : OTHERNAME *otherName; /* otherName */
137 : ASN1_IA5STRING *rfc822Name;
138 : ASN1_IA5STRING *dNSName;
139 : ASN1_TYPE *x400Address;
140 : X509_NAME *directoryName;
141 : EDIPARTYNAME *ediPartyName;
142 : ASN1_IA5STRING *uniformResourceIdentifier;
143 : ASN1_OCTET_STRING *iPAddress;
144 : ASN1_OBJECT *registeredID;
145 : /* Old names */
146 : ASN1_OCTET_STRING *ip; /* iPAddress */
147 : X509_NAME *dirn; /* dirn */
148 : ASN1_IA5STRING *ia5; /* rfc822Name, dNSName,
149 : * uniformResourceIdentifier */
150 : ASN1_OBJECT *rid; /* registeredID */
151 : ASN1_TYPE *other; /* x400Address */
152 : } d;
153 : } GENERAL_NAME;
154 :
155 : typedef struct ACCESS_DESCRIPTION_st {
156 : ASN1_OBJECT *method;
157 : GENERAL_NAME *location;
158 : } ACCESS_DESCRIPTION;
159 :
160 : typedef STACK_OF(ACCESS_DESCRIPTION) AUTHORITY_INFO_ACCESS;
161 :
162 : typedef STACK_OF(ASN1_OBJECT) EXTENDED_KEY_USAGE;
163 :
164 : typedef STACK_OF(ASN1_INTEGER) TLS_FEATURE;
165 :
166 0 : DEFINE_STACK_OF(GENERAL_NAME)
167 : typedef STACK_OF(GENERAL_NAME) GENERAL_NAMES;
168 : DEFINE_STACK_OF(GENERAL_NAMES)
169 :
170 : DEFINE_STACK_OF(ACCESS_DESCRIPTION)
171 :
172 : typedef struct DIST_POINT_NAME_st {
173 : int type;
174 : union {
175 : GENERAL_NAMES *fullname;
176 : STACK_OF(X509_NAME_ENTRY) *relativename;
177 : } name;
178 : /* If relativename then this contains the full distribution point name */
179 : X509_NAME *dpname;
180 : } DIST_POINT_NAME;
181 : /* All existing reasons */
182 : # define CRLDP_ALL_REASONS 0x807f
183 :
184 : # define CRL_REASON_NONE -1
185 : # define CRL_REASON_UNSPECIFIED 0
186 : # define CRL_REASON_KEY_COMPROMISE 1
187 : # define CRL_REASON_CA_COMPROMISE 2
188 : # define CRL_REASON_AFFILIATION_CHANGED 3
189 : # define CRL_REASON_SUPERSEDED 4
190 : # define CRL_REASON_CESSATION_OF_OPERATION 5
191 : # define CRL_REASON_CERTIFICATE_HOLD 6
192 : # define CRL_REASON_REMOVE_FROM_CRL 8
193 : # define CRL_REASON_PRIVILEGE_WITHDRAWN 9
194 : # define CRL_REASON_AA_COMPROMISE 10
195 :
196 : struct DIST_POINT_st {
197 : DIST_POINT_NAME *distpoint;
198 : ASN1_BIT_STRING *reasons;
199 : GENERAL_NAMES *CRLissuer;
200 : int dp_reasons;
201 : };
202 :
203 : typedef STACK_OF(DIST_POINT) CRL_DIST_POINTS;
204 :
205 : DEFINE_STACK_OF(DIST_POINT)
206 :
207 : struct AUTHORITY_KEYID_st {
208 : ASN1_OCTET_STRING *keyid;
209 : GENERAL_NAMES *issuer;
210 : ASN1_INTEGER *serial;
211 : };
212 :
213 : /* Strong extranet structures */
214 :
215 : typedef struct SXNET_ID_st {
216 : ASN1_INTEGER *zone;
217 : ASN1_OCTET_STRING *user;
218 : } SXNETID;
219 :
220 : DEFINE_STACK_OF(SXNETID)
221 :
222 : typedef struct SXNET_st {
223 : ASN1_INTEGER *version;
224 : STACK_OF(SXNETID) *ids;
225 : } SXNET;
226 :
227 : typedef struct NOTICEREF_st {
228 : ASN1_STRING *organization;
229 : STACK_OF(ASN1_INTEGER) *noticenos;
230 : } NOTICEREF;
231 :
232 : typedef struct USERNOTICE_st {
233 : NOTICEREF *noticeref;
234 : ASN1_STRING *exptext;
235 : } USERNOTICE;
236 :
237 : typedef struct POLICYQUALINFO_st {
238 : ASN1_OBJECT *pqualid;
239 : union {
240 : ASN1_IA5STRING *cpsuri;
241 : USERNOTICE *usernotice;
242 : ASN1_TYPE *other;
243 : } d;
244 : } POLICYQUALINFO;
245 :
246 : DEFINE_STACK_OF(POLICYQUALINFO)
247 :
248 : typedef struct POLICYINFO_st {
249 : ASN1_OBJECT *policyid;
250 : STACK_OF(POLICYQUALINFO) *qualifiers;
251 : } POLICYINFO;
252 :
253 : typedef STACK_OF(POLICYINFO) CERTIFICATEPOLICIES;
254 :
255 : DEFINE_STACK_OF(POLICYINFO)
256 :
257 : typedef struct POLICY_MAPPING_st {
258 : ASN1_OBJECT *issuerDomainPolicy;
259 : ASN1_OBJECT *subjectDomainPolicy;
260 : } POLICY_MAPPING;
261 :
262 : DEFINE_STACK_OF(POLICY_MAPPING)
263 :
264 : typedef STACK_OF(POLICY_MAPPING) POLICY_MAPPINGS;
265 :
266 : typedef struct GENERAL_SUBTREE_st {
267 : GENERAL_NAME *base;
268 : ASN1_INTEGER *minimum;
269 : ASN1_INTEGER *maximum;
270 : } GENERAL_SUBTREE;
271 :
272 : DEFINE_STACK_OF(GENERAL_SUBTREE)
273 :
274 : struct NAME_CONSTRAINTS_st {
275 : STACK_OF(GENERAL_SUBTREE) *permittedSubtrees;
276 : STACK_OF(GENERAL_SUBTREE) *excludedSubtrees;
277 : };
278 :
279 : typedef struct POLICY_CONSTRAINTS_st {
280 : ASN1_INTEGER *requireExplicitPolicy;
281 : ASN1_INTEGER *inhibitPolicyMapping;
282 : } POLICY_CONSTRAINTS;
283 :
284 : /* Proxy certificate structures, see RFC 3820 */
285 : typedef struct PROXY_POLICY_st {
286 : ASN1_OBJECT *policyLanguage;
287 : ASN1_OCTET_STRING *policy;
288 : } PROXY_POLICY;
289 :
290 : typedef struct PROXY_CERT_INFO_EXTENSION_st {
291 : ASN1_INTEGER *pcPathLengthConstraint;
292 : PROXY_POLICY *proxyPolicy;
293 : } PROXY_CERT_INFO_EXTENSION;
294 :
295 : DECLARE_ASN1_FUNCTIONS(PROXY_POLICY)
296 : DECLARE_ASN1_FUNCTIONS(PROXY_CERT_INFO_EXTENSION)
297 :
298 : struct ISSUING_DIST_POINT_st {
299 : DIST_POINT_NAME *distpoint;
300 : int onlyuser;
301 : int onlyCA;
302 : ASN1_BIT_STRING *onlysomereasons;
303 : int indirectCRL;
304 : int onlyattr;
305 : };
306 :
307 : /* Values in idp_flags field */
308 : /* IDP present */
309 : # define IDP_PRESENT 0x1
310 : /* IDP values inconsistent */
311 : # define IDP_INVALID 0x2
312 : /* onlyuser true */
313 : # define IDP_ONLYUSER 0x4
314 : /* onlyCA true */
315 : # define IDP_ONLYCA 0x8
316 : /* onlyattr true */
317 : # define IDP_ONLYATTR 0x10
318 : /* indirectCRL true */
319 : # define IDP_INDIRECT 0x20
320 : /* onlysomereasons present */
321 : # define IDP_REASONS 0x40
322 :
323 : # define X509V3_conf_err(val) ERR_add_error_data(6, \
324 : "section:", (val)->section, \
325 : ",name:", (val)->name, ",value:", (val)->value)
326 :
327 : # define X509V3_set_ctx_test(ctx) \
328 : X509V3_set_ctx(ctx, NULL, NULL, NULL, NULL, CTX_TEST)
329 : # define X509V3_set_ctx_nodb(ctx) (ctx)->db = NULL;
330 :
331 : # define EXT_BITSTRING(nid, table) { nid, 0, ASN1_ITEM_ref(ASN1_BIT_STRING), \
332 : 0,0,0,0, \
333 : 0,0, \
334 : (X509V3_EXT_I2V)i2v_ASN1_BIT_STRING, \
335 : (X509V3_EXT_V2I)v2i_ASN1_BIT_STRING, \
336 : NULL, NULL, \
337 : table}
338 :
339 : # define EXT_IA5STRING(nid) { nid, 0, ASN1_ITEM_ref(ASN1_IA5STRING), \
340 : 0,0,0,0, \
341 : (X509V3_EXT_I2S)i2s_ASN1_IA5STRING, \
342 : (X509V3_EXT_S2I)s2i_ASN1_IA5STRING, \
343 : 0,0,0,0, \
344 : NULL}
345 :
346 : # define EXT_END { -1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0}
347 :
348 : /* X509_PURPOSE stuff */
349 :
350 : # define EXFLAG_BCONS 0x1
351 : # define EXFLAG_KUSAGE 0x2
352 : # define EXFLAG_XKUSAGE 0x4
353 : # define EXFLAG_NSCERT 0x8
354 :
355 : # define EXFLAG_CA 0x10
356 : /* Really self issued not necessarily self signed */
357 : # define EXFLAG_SI 0x20
358 : # define EXFLAG_V1 0x40
359 : # define EXFLAG_INVALID 0x80
360 : /* EXFLAG_SET is set to indicate that some values have been precomputed */
361 : # define EXFLAG_SET 0x100
362 : # define EXFLAG_CRITICAL 0x200
363 : # define EXFLAG_PROXY 0x400
364 :
365 : # define EXFLAG_INVALID_POLICY 0x800
366 : # define EXFLAG_FRESHEST 0x1000
367 : # define EXFLAG_SS 0x2000 /* cert is apparently self-signed */
368 :
369 : # define EXFLAG_NO_FINGERPRINT 0x100000
370 :
371 : # define KU_DIGITAL_SIGNATURE 0x0080
372 : # define KU_NON_REPUDIATION 0x0040
373 : # define KU_KEY_ENCIPHERMENT 0x0020
374 : # define KU_DATA_ENCIPHERMENT 0x0010
375 : # define KU_KEY_AGREEMENT 0x0008
376 : # define KU_KEY_CERT_SIGN 0x0004
377 : # define KU_CRL_SIGN 0x0002
378 : # define KU_ENCIPHER_ONLY 0x0001
379 : # define KU_DECIPHER_ONLY 0x8000
380 :
381 : # define NS_SSL_CLIENT 0x80
382 : # define NS_SSL_SERVER 0x40
383 : # define NS_SMIME 0x20
384 : # define NS_OBJSIGN 0x10
385 : # define NS_SSL_CA 0x04
386 : # define NS_SMIME_CA 0x02
387 : # define NS_OBJSIGN_CA 0x01
388 : # define NS_ANY_CA (NS_SSL_CA|NS_SMIME_CA|NS_OBJSIGN_CA)
389 :
390 : # define XKU_SSL_SERVER 0x1
391 : # define XKU_SSL_CLIENT 0x2
392 : # define XKU_SMIME 0x4
393 : # define XKU_CODE_SIGN 0x8
394 : # define XKU_SGC 0x10
395 : # define XKU_OCSP_SIGN 0x20
396 : # define XKU_TIMESTAMP 0x40
397 : # define XKU_DVCS 0x80
398 : # define XKU_ANYEKU 0x100
399 :
400 : # define X509_PURPOSE_DYNAMIC 0x1
401 : # define X509_PURPOSE_DYNAMIC_NAME 0x2
402 :
403 : typedef struct x509_purpose_st {
404 : int purpose;
405 : int trust; /* Default trust ID */
406 : int flags;
407 : int (*check_purpose) (const struct x509_purpose_st *, const X509 *, int);
408 : char *name;
409 : char *sname;
410 : void *usr_data;
411 : } X509_PURPOSE;
412 :
413 : # define X509_PURPOSE_SSL_CLIENT 1
414 : # define X509_PURPOSE_SSL_SERVER 2
415 : # define X509_PURPOSE_NS_SSL_SERVER 3
416 : # define X509_PURPOSE_SMIME_SIGN 4
417 : # define X509_PURPOSE_SMIME_ENCRYPT 5
418 : # define X509_PURPOSE_CRL_SIGN 6
419 : # define X509_PURPOSE_ANY 7
420 : # define X509_PURPOSE_OCSP_HELPER 8
421 : # define X509_PURPOSE_TIMESTAMP_SIGN 9
422 :
423 : # define X509_PURPOSE_MIN 1
424 : # define X509_PURPOSE_MAX 9
425 :
426 : /* Flags for X509V3_EXT_print() */
427 :
428 : # define X509V3_EXT_UNKNOWN_MASK (0xfL << 16)
429 : /* Return error for unknown extensions */
430 : # define X509V3_EXT_DEFAULT 0
431 : /* Print error for unknown extensions */
432 : # define X509V3_EXT_ERROR_UNKNOWN (1L << 16)
433 : /* ASN1 parse unknown extensions */
434 : # define X509V3_EXT_PARSE_UNKNOWN (2L << 16)
435 : /* BIO_dump unknown extensions */
436 : # define X509V3_EXT_DUMP_UNKNOWN (3L << 16)
437 :
438 : /* Flags for X509V3_add1_i2d */
439 :
440 : # define X509V3_ADD_OP_MASK 0xfL
441 : # define X509V3_ADD_DEFAULT 0L
442 : # define X509V3_ADD_APPEND 1L
443 : # define X509V3_ADD_REPLACE 2L
444 : # define X509V3_ADD_REPLACE_EXISTING 3L
445 : # define X509V3_ADD_KEEP_EXISTING 4L
446 : # define X509V3_ADD_DELETE 5L
447 : # define X509V3_ADD_SILENT 0x10
448 :
449 : DEFINE_STACK_OF(X509_PURPOSE)
450 :
451 : DECLARE_ASN1_FUNCTIONS(BASIC_CONSTRAINTS)
452 :
453 : DECLARE_ASN1_FUNCTIONS(SXNET)
454 : DECLARE_ASN1_FUNCTIONS(SXNETID)
455 :
456 : int SXNET_add_id_asc(SXNET **psx, const char *zone, const char *user, int userlen);
457 : int SXNET_add_id_ulong(SXNET **psx, unsigned long lzone, const char *user,
458 : int userlen);
459 : int SXNET_add_id_INTEGER(SXNET **psx, ASN1_INTEGER *izone, const char *user,
460 : int userlen);
461 :
462 : ASN1_OCTET_STRING *SXNET_get_id_asc(SXNET *sx, const char *zone);
463 : ASN1_OCTET_STRING *SXNET_get_id_ulong(SXNET *sx, unsigned long lzone);
464 : ASN1_OCTET_STRING *SXNET_get_id_INTEGER(SXNET *sx, ASN1_INTEGER *zone);
465 :
466 : DECLARE_ASN1_FUNCTIONS(AUTHORITY_KEYID)
467 :
468 : DECLARE_ASN1_FUNCTIONS(PKEY_USAGE_PERIOD)
469 :
470 : DECLARE_ASN1_FUNCTIONS(GENERAL_NAME)
471 : GENERAL_NAME *GENERAL_NAME_dup(GENERAL_NAME *a);
472 : int GENERAL_NAME_cmp(GENERAL_NAME *a, GENERAL_NAME *b);
473 :
474 : ASN1_BIT_STRING *v2i_ASN1_BIT_STRING(X509V3_EXT_METHOD *method,
475 : X509V3_CTX *ctx,
476 : STACK_OF(CONF_VALUE) *nval);
477 : STACK_OF(CONF_VALUE) *i2v_ASN1_BIT_STRING(X509V3_EXT_METHOD *method,
478 : ASN1_BIT_STRING *bits,
479 : STACK_OF(CONF_VALUE) *extlist);
480 : char *i2s_ASN1_IA5STRING(X509V3_EXT_METHOD *method, ASN1_IA5STRING *ia5);
481 : ASN1_IA5STRING *s2i_ASN1_IA5STRING(X509V3_EXT_METHOD *method,
482 : X509V3_CTX *ctx, const char *str);
483 :
484 : STACK_OF(CONF_VALUE) *i2v_GENERAL_NAME(X509V3_EXT_METHOD *method,
485 : GENERAL_NAME *gen,
486 : STACK_OF(CONF_VALUE) *ret);
487 : int GENERAL_NAME_print(BIO *out, GENERAL_NAME *gen);
488 :
489 : DECLARE_ASN1_FUNCTIONS(GENERAL_NAMES)
490 :
491 : STACK_OF(CONF_VALUE) *i2v_GENERAL_NAMES(X509V3_EXT_METHOD *method,
492 : GENERAL_NAMES *gen,
493 : STACK_OF(CONF_VALUE) *extlist);
494 : GENERAL_NAMES *v2i_GENERAL_NAMES(const X509V3_EXT_METHOD *method,
495 : X509V3_CTX *ctx, STACK_OF(CONF_VALUE) *nval);
496 :
497 : DECLARE_ASN1_FUNCTIONS(OTHERNAME)
498 : DECLARE_ASN1_FUNCTIONS(EDIPARTYNAME)
499 : int OTHERNAME_cmp(OTHERNAME *a, OTHERNAME *b);
500 : void GENERAL_NAME_set0_value(GENERAL_NAME *a, int type, void *value);
501 : void *GENERAL_NAME_get0_value(const GENERAL_NAME *a, int *ptype);
502 : int GENERAL_NAME_set0_othername(GENERAL_NAME *gen,
503 : ASN1_OBJECT *oid, ASN1_TYPE *value);
504 : int GENERAL_NAME_get0_otherName(const GENERAL_NAME *gen,
505 : ASN1_OBJECT **poid, ASN1_TYPE **pvalue);
506 :
507 : char *i2s_ASN1_OCTET_STRING(X509V3_EXT_METHOD *method,
508 : const ASN1_OCTET_STRING *ia5);
509 : ASN1_OCTET_STRING *s2i_ASN1_OCTET_STRING(X509V3_EXT_METHOD *method,
510 : X509V3_CTX *ctx, const char *str);
511 :
512 : DECLARE_ASN1_FUNCTIONS(EXTENDED_KEY_USAGE)
513 : int i2a_ACCESS_DESCRIPTION(BIO *bp, const ACCESS_DESCRIPTION *a);
514 :
515 : DECLARE_ASN1_ALLOC_FUNCTIONS(TLS_FEATURE)
516 :
517 : DECLARE_ASN1_FUNCTIONS(CERTIFICATEPOLICIES)
518 : DECLARE_ASN1_FUNCTIONS(POLICYINFO)
519 : DECLARE_ASN1_FUNCTIONS(POLICYQUALINFO)
520 : DECLARE_ASN1_FUNCTIONS(USERNOTICE)
521 : DECLARE_ASN1_FUNCTIONS(NOTICEREF)
522 :
523 : DECLARE_ASN1_FUNCTIONS(CRL_DIST_POINTS)
524 : DECLARE_ASN1_FUNCTIONS(DIST_POINT)
525 : DECLARE_ASN1_FUNCTIONS(DIST_POINT_NAME)
526 : DECLARE_ASN1_FUNCTIONS(ISSUING_DIST_POINT)
527 :
528 : int DIST_POINT_set_dpname(DIST_POINT_NAME *dpn, X509_NAME *iname);
529 :
530 : int NAME_CONSTRAINTS_check(X509 *x, NAME_CONSTRAINTS *nc);
531 : int NAME_CONSTRAINTS_check_CN(X509 *x, NAME_CONSTRAINTS *nc);
532 :
533 : DECLARE_ASN1_FUNCTIONS(ACCESS_DESCRIPTION)
534 : DECLARE_ASN1_FUNCTIONS(AUTHORITY_INFO_ACCESS)
535 :
536 : DECLARE_ASN1_ITEM(POLICY_MAPPING)
537 : DECLARE_ASN1_ALLOC_FUNCTIONS(POLICY_MAPPING)
538 : DECLARE_ASN1_ITEM(POLICY_MAPPINGS)
539 :
540 : DECLARE_ASN1_ITEM(GENERAL_SUBTREE)
541 : DECLARE_ASN1_ALLOC_FUNCTIONS(GENERAL_SUBTREE)
542 :
543 : DECLARE_ASN1_ITEM(NAME_CONSTRAINTS)
544 : DECLARE_ASN1_ALLOC_FUNCTIONS(NAME_CONSTRAINTS)
545 :
546 : DECLARE_ASN1_ALLOC_FUNCTIONS(POLICY_CONSTRAINTS)
547 : DECLARE_ASN1_ITEM(POLICY_CONSTRAINTS)
548 :
549 : GENERAL_NAME *a2i_GENERAL_NAME(GENERAL_NAME *out,
550 : const X509V3_EXT_METHOD *method,
551 : X509V3_CTX *ctx, int gen_type,
552 : const char *value, int is_nc);
553 :
554 : # ifdef HEADER_CONF_H
555 : GENERAL_NAME *v2i_GENERAL_NAME(const X509V3_EXT_METHOD *method,
556 : X509V3_CTX *ctx, CONF_VALUE *cnf);
557 : GENERAL_NAME *v2i_GENERAL_NAME_ex(GENERAL_NAME *out,
558 : const X509V3_EXT_METHOD *method,
559 : X509V3_CTX *ctx, CONF_VALUE *cnf,
560 : int is_nc);
561 : void X509V3_conf_free(CONF_VALUE *val);
562 :
563 : X509_EXTENSION *X509V3_EXT_nconf_nid(CONF *conf, X509V3_CTX *ctx, int ext_nid,
564 : const char *value);
565 : X509_EXTENSION *X509V3_EXT_nconf(CONF *conf, X509V3_CTX *ctx, const char *name,
566 : const char *value);
567 : int X509V3_EXT_add_nconf_sk(CONF *conf, X509V3_CTX *ctx, const char *section,
568 : STACK_OF(X509_EXTENSION) **sk);
569 : int X509V3_EXT_add_nconf(CONF *conf, X509V3_CTX *ctx, const char *section,
570 : X509 *cert);
571 : int X509V3_EXT_REQ_add_nconf(CONF *conf, X509V3_CTX *ctx, const char *section,
572 : X509_REQ *req);
573 : int X509V3_EXT_CRL_add_nconf(CONF *conf, X509V3_CTX *ctx, const char *section,
574 : X509_CRL *crl);
575 :
576 : X509_EXTENSION *X509V3_EXT_conf_nid(LHASH_OF(CONF_VALUE) *conf,
577 : X509V3_CTX *ctx, int ext_nid,
578 : const char *value);
579 : X509_EXTENSION *X509V3_EXT_conf(LHASH_OF(CONF_VALUE) *conf, X509V3_CTX *ctx,
580 : const char *name, const char *value);
581 : int X509V3_EXT_add_conf(LHASH_OF(CONF_VALUE) *conf, X509V3_CTX *ctx,
582 : const char *section, X509 *cert);
583 : int X509V3_EXT_REQ_add_conf(LHASH_OF(CONF_VALUE) *conf, X509V3_CTX *ctx,
584 : const char *section, X509_REQ *req);
585 : int X509V3_EXT_CRL_add_conf(LHASH_OF(CONF_VALUE) *conf, X509V3_CTX *ctx,
586 : const char *section, X509_CRL *crl);
587 :
588 : int X509V3_add_value_bool_nf(const char *name, int asn1_bool,
589 : STACK_OF(CONF_VALUE) **extlist);
590 : int X509V3_get_value_bool(const CONF_VALUE *value, int *asn1_bool);
591 : int X509V3_get_value_int(const CONF_VALUE *value, ASN1_INTEGER **aint);
592 : void X509V3_set_nconf(X509V3_CTX *ctx, CONF *conf);
593 : void X509V3_set_conf_lhash(X509V3_CTX *ctx, LHASH_OF(CONF_VALUE) *lhash);
594 : # endif
595 :
596 : char *X509V3_get_string(X509V3_CTX *ctx, const char *name, const char *section);
597 : STACK_OF(CONF_VALUE) *X509V3_get_section(X509V3_CTX *ctx, const char *section);
598 : void X509V3_string_free(X509V3_CTX *ctx, char *str);
599 : void X509V3_section_free(X509V3_CTX *ctx, STACK_OF(CONF_VALUE) *section);
600 : void X509V3_set_ctx(X509V3_CTX *ctx, X509 *issuer, X509 *subject,
601 : X509_REQ *req, X509_CRL *crl, int flags);
602 :
603 : int X509V3_add_value(const char *name, const char *value,
604 : STACK_OF(CONF_VALUE) **extlist);
605 : int X509V3_add_value_uchar(const char *name, const unsigned char *value,
606 : STACK_OF(CONF_VALUE) **extlist);
607 : int X509V3_add_value_bool(const char *name, int asn1_bool,
608 : STACK_OF(CONF_VALUE) **extlist);
609 : int X509V3_add_value_int(const char *name, const ASN1_INTEGER *aint,
610 : STACK_OF(CONF_VALUE) **extlist);
611 : char *i2s_ASN1_INTEGER(X509V3_EXT_METHOD *meth, const ASN1_INTEGER *aint);
612 : ASN1_INTEGER *s2i_ASN1_INTEGER(X509V3_EXT_METHOD *meth, const char *value);
613 : char *i2s_ASN1_ENUMERATED(X509V3_EXT_METHOD *meth, const ASN1_ENUMERATED *aint);
614 : char *i2s_ASN1_ENUMERATED_TABLE(X509V3_EXT_METHOD *meth,
615 : const ASN1_ENUMERATED *aint);
616 : int X509V3_EXT_add(X509V3_EXT_METHOD *ext);
617 : int X509V3_EXT_add_list(X509V3_EXT_METHOD *extlist);
618 : int X509V3_EXT_add_alias(int nid_to, int nid_from);
619 : void X509V3_EXT_cleanup(void);
620 :
621 : const X509V3_EXT_METHOD *X509V3_EXT_get(X509_EXTENSION *ext);
622 : const X509V3_EXT_METHOD *X509V3_EXT_get_nid(int nid);
623 : int X509V3_add_standard_extensions(void);
624 : STACK_OF(CONF_VALUE) *X509V3_parse_list(const char *line);
625 : void *X509V3_EXT_d2i(X509_EXTENSION *ext);
626 : void *X509V3_get_d2i(const STACK_OF(X509_EXTENSION) *x, int nid, int *crit,
627 : int *idx);
628 :
629 : X509_EXTENSION *X509V3_EXT_i2d(int ext_nid, int crit, void *ext_struc);
630 : int X509V3_add1_i2d(STACK_OF(X509_EXTENSION) **x, int nid, void *value,
631 : int crit, unsigned long flags);
632 :
633 : #if OPENSSL_API_COMPAT < 0x10100000L
634 : /* The new declarations are in crypto.h, but the old ones were here. */
635 : # define hex_to_string OPENSSL_buf2hexstr
636 : # define string_to_hex OPENSSL_hexstr2buf
637 : #endif
638 :
639 : void X509V3_EXT_val_prn(BIO *out, STACK_OF(CONF_VALUE) *val, int indent,
640 : int ml);
641 : int X509V3_EXT_print(BIO *out, X509_EXTENSION *ext, unsigned long flag,
642 : int indent);
643 : #ifndef OPENSSL_NO_STDIO
644 : int X509V3_EXT_print_fp(FILE *out, X509_EXTENSION *ext, int flag, int indent);
645 : #endif
646 : int X509V3_extensions_print(BIO *out, const char *title,
647 : const STACK_OF(X509_EXTENSION) *exts,
648 : unsigned long flag, int indent);
649 :
650 : int X509_check_ca(X509 *x);
651 : int X509_check_purpose(X509 *x, int id, int ca);
652 : int X509_supported_extension(X509_EXTENSION *ex);
653 : int X509_PURPOSE_set(int *p, int purpose);
654 : int X509_check_issued(X509 *issuer, X509 *subject);
655 : int X509_check_akid(X509 *issuer, AUTHORITY_KEYID *akid);
656 : void X509_set_proxy_flag(X509 *x);
657 : void X509_set_proxy_pathlen(X509 *x, long l);
658 : long X509_get_proxy_pathlen(X509 *x);
659 :
660 : uint32_t X509_get_extension_flags(X509 *x);
661 : uint32_t X509_get_key_usage(X509 *x);
662 : uint32_t X509_get_extended_key_usage(X509 *x);
663 : const ASN1_OCTET_STRING *X509_get0_subject_key_id(X509 *x);
664 : const ASN1_OCTET_STRING *X509_get0_authority_key_id(X509 *x);
665 : const GENERAL_NAMES *X509_get0_authority_issuer(X509 *x);
666 : const ASN1_INTEGER *X509_get0_authority_serial(X509 *x);
667 :
668 : int X509_PURPOSE_get_count(void);
669 : X509_PURPOSE *X509_PURPOSE_get0(int idx);
670 : int X509_PURPOSE_get_by_sname(const char *sname);
671 : int X509_PURPOSE_get_by_id(int id);
672 : int X509_PURPOSE_add(int id, int trust, int flags,
673 : int (*ck) (const X509_PURPOSE *, const X509 *, int),
674 : const char *name, const char *sname, void *arg);
675 : char *X509_PURPOSE_get0_name(const X509_PURPOSE *xp);
676 : char *X509_PURPOSE_get0_sname(const X509_PURPOSE *xp);
677 : int X509_PURPOSE_get_trust(const X509_PURPOSE *xp);
678 : void X509_PURPOSE_cleanup(void);
679 : int X509_PURPOSE_get_id(const X509_PURPOSE *);
680 :
681 : STACK_OF(OPENSSL_STRING) *X509_get1_email(X509 *x);
682 : STACK_OF(OPENSSL_STRING) *X509_REQ_get1_email(X509_REQ *x);
683 : void X509_email_free(STACK_OF(OPENSSL_STRING) *sk);
684 : STACK_OF(OPENSSL_STRING) *X509_get1_ocsp(X509 *x);
685 : /* Flags for X509_check_* functions */
686 :
687 : /*
688 : * Always check subject name for host match even if subject alt names present
689 : */
690 : # define X509_CHECK_FLAG_ALWAYS_CHECK_SUBJECT 0x1
691 : /* Disable wildcard matching for dnsName fields and common name. */
692 : # define X509_CHECK_FLAG_NO_WILDCARDS 0x2
693 : /* Wildcards must not match a partial label. */
694 : # define X509_CHECK_FLAG_NO_PARTIAL_WILDCARDS 0x4
695 : /* Allow (non-partial) wildcards to match multiple labels. */
696 : # define X509_CHECK_FLAG_MULTI_LABEL_WILDCARDS 0x8
697 : /* Constraint verifier subdomain patterns to match a single labels. */
698 : # define X509_CHECK_FLAG_SINGLE_LABEL_SUBDOMAINS 0x10
699 : /* Never check the subject CN */
700 : # define X509_CHECK_FLAG_NEVER_CHECK_SUBJECT 0x20
701 : /*
702 : * Match reference identifiers starting with "." to any sub-domain.
703 : * This is a non-public flag, turned on implicitly when the subject
704 : * reference identity is a DNS name.
705 : */
706 : # define _X509_CHECK_FLAG_DOT_SUBDOMAINS 0x8000
707 :
708 : int X509_check_host(X509 *x, const char *chk, size_t chklen,
709 : unsigned int flags, char **peername);
710 : int X509_check_email(X509 *x, const char *chk, size_t chklen,
711 : unsigned int flags);
712 : int X509_check_ip(X509 *x, const unsigned char *chk, size_t chklen,
713 : unsigned int flags);
714 : int X509_check_ip_asc(X509 *x, const char *ipasc, unsigned int flags);
715 :
716 : ASN1_OCTET_STRING *a2i_IPADDRESS(const char *ipasc);
717 : ASN1_OCTET_STRING *a2i_IPADDRESS_NC(const char *ipasc);
718 : int X509V3_NAME_from_section(X509_NAME *nm, STACK_OF(CONF_VALUE) *dn_sk,
719 : unsigned long chtype);
720 :
721 : void X509_POLICY_NODE_print(BIO *out, X509_POLICY_NODE *node, int indent);
722 : DEFINE_STACK_OF(X509_POLICY_NODE)
723 :
724 : #ifndef OPENSSL_NO_RFC3779
725 : typedef struct ASRange_st {
726 : ASN1_INTEGER *min, *max;
727 : } ASRange;
728 :
729 : # define ASIdOrRange_id 0
730 : # define ASIdOrRange_range 1
731 :
732 : typedef struct ASIdOrRange_st {
733 : int type;
734 : union {
735 : ASN1_INTEGER *id;
736 : ASRange *range;
737 : } u;
738 : } ASIdOrRange;
739 :
740 : typedef STACK_OF(ASIdOrRange) ASIdOrRanges;
741 : DEFINE_STACK_OF(ASIdOrRange)
742 :
743 : # define ASIdentifierChoice_inherit 0
744 : # define ASIdentifierChoice_asIdsOrRanges 1
745 :
746 : typedef struct ASIdentifierChoice_st {
747 : int type;
748 : union {
749 : ASN1_NULL *inherit;
750 : ASIdOrRanges *asIdsOrRanges;
751 : } u;
752 : } ASIdentifierChoice;
753 :
754 : typedef struct ASIdentifiers_st {
755 : ASIdentifierChoice *asnum, *rdi;
756 : } ASIdentifiers;
757 :
758 : DECLARE_ASN1_FUNCTIONS(ASRange)
759 : DECLARE_ASN1_FUNCTIONS(ASIdOrRange)
760 : DECLARE_ASN1_FUNCTIONS(ASIdentifierChoice)
761 : DECLARE_ASN1_FUNCTIONS(ASIdentifiers)
762 :
763 : typedef struct IPAddressRange_st {
764 : ASN1_BIT_STRING *min, *max;
765 : } IPAddressRange;
766 :
767 : # define IPAddressOrRange_addressPrefix 0
768 : # define IPAddressOrRange_addressRange 1
769 :
770 : typedef struct IPAddressOrRange_st {
771 : int type;
772 : union {
773 : ASN1_BIT_STRING *addressPrefix;
774 : IPAddressRange *addressRange;
775 : } u;
776 : } IPAddressOrRange;
777 :
778 : typedef STACK_OF(IPAddressOrRange) IPAddressOrRanges;
779 : DEFINE_STACK_OF(IPAddressOrRange)
780 :
781 : # define IPAddressChoice_inherit 0
782 : # define IPAddressChoice_addressesOrRanges 1
783 :
784 : typedef struct IPAddressChoice_st {
785 : int type;
786 : union {
787 : ASN1_NULL *inherit;
788 : IPAddressOrRanges *addressesOrRanges;
789 : } u;
790 : } IPAddressChoice;
791 :
792 : typedef struct IPAddressFamily_st {
793 : ASN1_OCTET_STRING *addressFamily;
794 : IPAddressChoice *ipAddressChoice;
795 : } IPAddressFamily;
796 :
797 : typedef STACK_OF(IPAddressFamily) IPAddrBlocks;
798 : DEFINE_STACK_OF(IPAddressFamily)
799 :
800 : DECLARE_ASN1_FUNCTIONS(IPAddressRange)
801 : DECLARE_ASN1_FUNCTIONS(IPAddressOrRange)
802 : DECLARE_ASN1_FUNCTIONS(IPAddressChoice)
803 : DECLARE_ASN1_FUNCTIONS(IPAddressFamily)
804 :
805 : /*
806 : * API tag for elements of the ASIdentifer SEQUENCE.
807 : */
808 : # define V3_ASID_ASNUM 0
809 : # define V3_ASID_RDI 1
810 :
811 : /*
812 : * AFI values, assigned by IANA. It'd be nice to make the AFI
813 : * handling code totally generic, but there are too many little things
814 : * that would need to be defined for other address families for it to
815 : * be worth the trouble.
816 : */
817 : # define IANA_AFI_IPV4 1
818 : # define IANA_AFI_IPV6 2
819 :
820 : /*
821 : * Utilities to construct and extract values from RFC3779 extensions,
822 : * since some of the encodings (particularly for IP address prefixes
823 : * and ranges) are a bit tedious to work with directly.
824 : */
825 : int X509v3_asid_add_inherit(ASIdentifiers *asid, int which);
826 : int X509v3_asid_add_id_or_range(ASIdentifiers *asid, int which,
827 : ASN1_INTEGER *min, ASN1_INTEGER *max);
828 : int X509v3_addr_add_inherit(IPAddrBlocks *addr,
829 : const unsigned afi, const unsigned *safi);
830 : int X509v3_addr_add_prefix(IPAddrBlocks *addr,
831 : const unsigned afi, const unsigned *safi,
832 : unsigned char *a, const int prefixlen);
833 : int X509v3_addr_add_range(IPAddrBlocks *addr,
834 : const unsigned afi, const unsigned *safi,
835 : unsigned char *min, unsigned char *max);
836 : unsigned X509v3_addr_get_afi(const IPAddressFamily *f);
837 : int X509v3_addr_get_range(IPAddressOrRange *aor, const unsigned afi,
838 : unsigned char *min, unsigned char *max,
839 : const int length);
840 :
841 : /*
842 : * Canonical forms.
843 : */
844 : int X509v3_asid_is_canonical(ASIdentifiers *asid);
845 : int X509v3_addr_is_canonical(IPAddrBlocks *addr);
846 : int X509v3_asid_canonize(ASIdentifiers *asid);
847 : int X509v3_addr_canonize(IPAddrBlocks *addr);
848 :
849 : /*
850 : * Tests for inheritance and containment.
851 : */
852 : int X509v3_asid_inherits(ASIdentifiers *asid);
853 : int X509v3_addr_inherits(IPAddrBlocks *addr);
854 : int X509v3_asid_subset(ASIdentifiers *a, ASIdentifiers *b);
855 : int X509v3_addr_subset(IPAddrBlocks *a, IPAddrBlocks *b);
856 :
857 : /*
858 : * Check whether RFC 3779 extensions nest properly in chains.
859 : */
860 : int X509v3_asid_validate_path(X509_STORE_CTX *);
861 : int X509v3_addr_validate_path(X509_STORE_CTX *);
862 : int X509v3_asid_validate_resource_set(STACK_OF(X509) *chain,
863 : ASIdentifiers *ext,
864 : int allow_inheritance);
865 : int X509v3_addr_validate_resource_set(STACK_OF(X509) *chain,
866 : IPAddrBlocks *ext, int allow_inheritance);
867 :
868 : #endif /* OPENSSL_NO_RFC3779 */
869 :
870 : DEFINE_STACK_OF(ASN1_STRING)
871 :
872 : /*
873 : * Admission Syntax
874 : */
875 : typedef struct NamingAuthority_st NAMING_AUTHORITY;
876 : typedef struct ProfessionInfo_st PROFESSION_INFO;
877 : typedef struct Admissions_st ADMISSIONS;
878 : typedef struct AdmissionSyntax_st ADMISSION_SYNTAX;
879 : DECLARE_ASN1_FUNCTIONS(NAMING_AUTHORITY)
880 : DECLARE_ASN1_FUNCTIONS(PROFESSION_INFO)
881 : DECLARE_ASN1_FUNCTIONS(ADMISSIONS)
882 : DECLARE_ASN1_FUNCTIONS(ADMISSION_SYNTAX)
883 : DEFINE_STACK_OF(ADMISSIONS)
884 : DEFINE_STACK_OF(PROFESSION_INFO)
885 : typedef STACK_OF(PROFESSION_INFO) PROFESSION_INFOS;
886 :
887 : const ASN1_OBJECT *NAMING_AUTHORITY_get0_authorityId(
888 : const NAMING_AUTHORITY *n);
889 : const ASN1_IA5STRING *NAMING_AUTHORITY_get0_authorityURL(
890 : const NAMING_AUTHORITY *n);
891 : const ASN1_STRING *NAMING_AUTHORITY_get0_authorityText(
892 : const NAMING_AUTHORITY *n);
893 : void NAMING_AUTHORITY_set0_authorityId(NAMING_AUTHORITY *n,
894 : ASN1_OBJECT* namingAuthorityId);
895 : void NAMING_AUTHORITY_set0_authorityURL(NAMING_AUTHORITY *n,
896 : ASN1_IA5STRING* namingAuthorityUrl);
897 : void NAMING_AUTHORITY_set0_authorityText(NAMING_AUTHORITY *n,
898 : ASN1_STRING* namingAuthorityText);
899 :
900 : const GENERAL_NAME *ADMISSION_SYNTAX_get0_admissionAuthority(
901 : const ADMISSION_SYNTAX *as);
902 : void ADMISSION_SYNTAX_set0_admissionAuthority(
903 : ADMISSION_SYNTAX *as, GENERAL_NAME *aa);
904 : const STACK_OF(ADMISSIONS) *ADMISSION_SYNTAX_get0_contentsOfAdmissions(
905 : const ADMISSION_SYNTAX *as);
906 : void ADMISSION_SYNTAX_set0_contentsOfAdmissions(
907 : ADMISSION_SYNTAX *as, STACK_OF(ADMISSIONS) *a);
908 : const GENERAL_NAME *ADMISSIONS_get0_admissionAuthority(const ADMISSIONS *a);
909 : void ADMISSIONS_set0_admissionAuthority(ADMISSIONS *a, GENERAL_NAME *aa);
910 : const NAMING_AUTHORITY *ADMISSIONS_get0_namingAuthority(const ADMISSIONS *a);
911 : void ADMISSIONS_set0_namingAuthority(ADMISSIONS *a, NAMING_AUTHORITY *na);
912 : const PROFESSION_INFOS *ADMISSIONS_get0_professionInfos(const ADMISSIONS *a);
913 : void ADMISSIONS_set0_professionInfos(ADMISSIONS *a, PROFESSION_INFOS *pi);
914 : const ASN1_OCTET_STRING *PROFESSION_INFO_get0_addProfessionInfo(
915 : const PROFESSION_INFO *pi);
916 : void PROFESSION_INFO_set0_addProfessionInfo(
917 : PROFESSION_INFO *pi, ASN1_OCTET_STRING *aos);
918 : const NAMING_AUTHORITY *PROFESSION_INFO_get0_namingAuthority(
919 : const PROFESSION_INFO *pi);
920 : void PROFESSION_INFO_set0_namingAuthority(
921 : PROFESSION_INFO *pi, NAMING_AUTHORITY *na);
922 : const STACK_OF(ASN1_STRING) *PROFESSION_INFO_get0_professionItems(
923 : const PROFESSION_INFO *pi);
924 : void PROFESSION_INFO_set0_professionItems(
925 : PROFESSION_INFO *pi, STACK_OF(ASN1_STRING) *as);
926 : const STACK_OF(ASN1_OBJECT) *PROFESSION_INFO_get0_professionOIDs(
927 : const PROFESSION_INFO *pi);
928 : void PROFESSION_INFO_set0_professionOIDs(
929 : PROFESSION_INFO *pi, STACK_OF(ASN1_OBJECT) *po);
930 : const ASN1_PRINTABLESTRING *PROFESSION_INFO_get0_registrationNumber(
931 : const PROFESSION_INFO *pi);
932 : void PROFESSION_INFO_set0_registrationNumber(
933 : PROFESSION_INFO *pi, ASN1_PRINTABLESTRING *rn);
934 :
935 : # ifdef __cplusplus
936 : }
937 : # endif
938 : #endif
|