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