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