3 * Written by Dr Stephen N Henson (steve@openssl.org) for the OpenSSL
6 /* ====================================================================
7 * Copyright (c) 2003 The OpenSSL Project. All rights reserved.
9 * Redistribution and use in source and binary forms, with or without
10 * modification, are permitted provided that the following conditions
13 * 1. Redistributions of source code must retain the above copyright
14 * notice, this list of conditions and the following disclaimer.
16 * 2. Redistributions in binary form must reproduce the above copyright
17 * notice, this list of conditions and the following disclaimer in
18 * the documentation and/or other materials provided with the
21 * 3. All advertising materials mentioning features or use of this
22 * software must display the following acknowledgment:
23 * "This product includes software developed by the OpenSSL Project
24 * for use in the OpenSSL Toolkit. (http://www.OpenSSL.org/)"
26 * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
27 * endorse or promote products derived from this software without
28 * prior written permission. For written permission, please contact
29 * licensing@OpenSSL.org.
31 * 5. Products derived from this software may not be called "OpenSSL"
32 * nor may "OpenSSL" appear in their names without prior written
33 * permission of the OpenSSL Project.
35 * 6. Redistributions of any form whatsoever must retain the following
37 * "This product includes software developed by the OpenSSL Project
38 * for use in the OpenSSL Toolkit (http://www.OpenSSL.org/)"
40 * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
41 * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
42 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
43 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR
44 * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
45 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
46 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
47 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
48 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
49 * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
50 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
51 * OF THE POSSIBILITY OF SUCH DAMAGE.
52 * ====================================================================
54 * This product includes cryptographic software written by Eric Young
55 * (eay@cryptsoft.com). This product includes software written by Tim
56 * Hudson (tjh@cryptsoft.com).
62 #include <openssl/asn1t.h>
63 #include <openssl/conf.h>
64 #include <openssl/x509v3.h>
66 static void *v2i_NAME_CONSTRAINTS(const X509V3_EXT_METHOD
*method
,
68 STACK_OF(CONF_VALUE
) *nval
);
69 static int i2r_NAME_CONSTRAINTS(const X509V3_EXT_METHOD
*method
, void *a
,
71 static int do_i2r_name_constraints(const X509V3_EXT_METHOD
*method
,
72 STACK_OF(GENERAL_SUBTREE
) *trees
, BIO
*bp
,
74 static int print_nc_ipadd(BIO
*bp
, ASN1_OCTET_STRING
*ip
);
76 static int nc_match(GENERAL_NAME
*gen
, NAME_CONSTRAINTS
*nc
);
77 static int nc_match_single(GENERAL_NAME
*sub
, GENERAL_NAME
*gen
);
78 static int nc_dn(X509_NAME
*sub
, X509_NAME
*nm
);
79 static int nc_dns(ASN1_IA5STRING
*sub
, ASN1_IA5STRING
*dns
);
80 static int nc_email(ASN1_IA5STRING
*sub
, ASN1_IA5STRING
*eml
);
81 static int nc_uri(ASN1_IA5STRING
*uri
, ASN1_IA5STRING
*base
);
83 const X509V3_EXT_METHOD v3_name_constraints
= {
84 NID_name_constraints
, 0,
85 ASN1_ITEM_ref(NAME_CONSTRAINTS
),
88 0, v2i_NAME_CONSTRAINTS
,
89 i2r_NAME_CONSTRAINTS
, 0,
93 ASN1_SEQUENCE(GENERAL_SUBTREE
) = {
94 ASN1_SIMPLE(GENERAL_SUBTREE
, base
, GENERAL_NAME
),
95 ASN1_IMP_OPT(GENERAL_SUBTREE
, minimum
, ASN1_INTEGER
, 0),
96 ASN1_IMP_OPT(GENERAL_SUBTREE
, maximum
, ASN1_INTEGER
, 1)
97 } ASN1_SEQUENCE_END(GENERAL_SUBTREE
)
99 ASN1_SEQUENCE(NAME_CONSTRAINTS
) = {
100 ASN1_IMP_SEQUENCE_OF_OPT(NAME_CONSTRAINTS
, permittedSubtrees
,
102 ASN1_IMP_SEQUENCE_OF_OPT(NAME_CONSTRAINTS
, excludedSubtrees
,
104 } ASN1_SEQUENCE_END(NAME_CONSTRAINTS
)
107 IMPLEMENT_ASN1_ALLOC_FUNCTIONS(GENERAL_SUBTREE
)
108 IMPLEMENT_ASN1_ALLOC_FUNCTIONS(NAME_CONSTRAINTS
)
110 static void *v2i_NAME_CONSTRAINTS(const X509V3_EXT_METHOD
*method
,
111 X509V3_CTX
*ctx
, STACK_OF(CONF_VALUE
) *nval
)
114 CONF_VALUE tval
, *val
;
115 STACK_OF(GENERAL_SUBTREE
) **ptree
= NULL
;
116 NAME_CONSTRAINTS
*ncons
= NULL
;
117 GENERAL_SUBTREE
*sub
= NULL
;
118 ncons
= NAME_CONSTRAINTS_new();
121 for (i
= 0; i
< sk_CONF_VALUE_num(nval
); i
++) {
122 val
= sk_CONF_VALUE_value(nval
, i
);
123 if (!strncmp(val
->name
, "permitted", 9) && val
->name
[9]) {
124 ptree
= &ncons
->permittedSubtrees
;
125 tval
.name
= val
->name
+ 10;
126 } else if (!strncmp(val
->name
, "excluded", 8) && val
->name
[8]) {
127 ptree
= &ncons
->excludedSubtrees
;
128 tval
.name
= val
->name
+ 9;
130 X509V3err(X509V3_F_V2I_NAME_CONSTRAINTS
, X509V3_R_INVALID_SYNTAX
);
133 tval
.value
= val
->value
;
134 sub
= GENERAL_SUBTREE_new();
137 if (!v2i_GENERAL_NAME_ex(sub
->base
, method
, ctx
, &tval
, 1))
140 *ptree
= sk_GENERAL_SUBTREE_new_null();
141 if (!*ptree
|| !sk_GENERAL_SUBTREE_push(*ptree
, sub
))
149 X509V3err(X509V3_F_V2I_NAME_CONSTRAINTS
, ERR_R_MALLOC_FAILURE
);
152 NAME_CONSTRAINTS_free(ncons
);
154 GENERAL_SUBTREE_free(sub
);
159 static int i2r_NAME_CONSTRAINTS(const X509V3_EXT_METHOD
*method
, void *a
,
162 NAME_CONSTRAINTS
*ncons
= a
;
163 do_i2r_name_constraints(method
, ncons
->permittedSubtrees
,
164 bp
, ind
, "Permitted");
165 do_i2r_name_constraints(method
, ncons
->excludedSubtrees
,
166 bp
, ind
, "Excluded");
170 static int do_i2r_name_constraints(const X509V3_EXT_METHOD
*method
,
171 STACK_OF(GENERAL_SUBTREE
) *trees
,
172 BIO
*bp
, int ind
, char *name
)
174 GENERAL_SUBTREE
*tree
;
176 if (sk_GENERAL_SUBTREE_num(trees
) > 0)
177 BIO_printf(bp
, "%*s%s:\n", ind
, "", name
);
178 for (i
= 0; i
< sk_GENERAL_SUBTREE_num(trees
); i
++) {
179 tree
= sk_GENERAL_SUBTREE_value(trees
, i
);
180 BIO_printf(bp
, "%*s", ind
+ 2, "");
181 if (tree
->base
->type
== GEN_IPADD
)
182 print_nc_ipadd(bp
, tree
->base
->d
.ip
);
184 GENERAL_NAME_print(bp
, tree
->base
);
190 static int print_nc_ipadd(BIO
*bp
, ASN1_OCTET_STRING
*ip
)
198 BIO_printf(bp
, "%d.%d.%d.%d/%d.%d.%d.%d",
199 p
[0], p
[1], p
[2], p
[3], p
[4], p
[5], p
[6], p
[7]);
200 } else if (len
== 32) {
201 for (i
= 0; i
< 16; i
++) {
202 BIO_printf(bp
, "%X", p
[0] << 8 | p
[1]);
210 BIO_printf(bp
, "IP Address:<invalid>");
215 * Check a certificate conforms to a specified set of constraints.
217 * X509_V_OK: All constraints obeyed.
218 * X509_V_ERR_PERMITTED_VIOLATION: Permitted subtree violation.
219 * X509_V_ERR_EXCLUDED_VIOLATION: Excluded subtree violation.
220 * X509_V_ERR_SUBTREE_MINMAX: Min or max values present and matching type.
221 * X509_V_ERR_UNSUPPORTED_CONSTRAINT_TYPE: Unsupported constraint type.
222 * X509_V_ERR_UNSUPPORTED_CONSTRAINT_SYNTAX: bad unsupported constraint syntax.
223 * X509_V_ERR_UNSUPPORTED_NAME_SYNTAX: bad or unsupported syntax of name
226 int NAME_CONSTRAINTS_check(X509
*x
, NAME_CONSTRAINTS
*nc
)
231 nm
= X509_get_subject_name(x
);
233 if (X509_NAME_entry_count(nm
) > 0) {
235 gntmp
.type
= GEN_DIRNAME
;
236 gntmp
.d
.directoryName
= nm
;
238 r
= nc_match(&gntmp
, nc
);
243 gntmp
.type
= GEN_EMAIL
;
245 /* Process any email address attributes in subject name */
249 i
= X509_NAME_get_index_by_NID(nm
, NID_pkcs9_emailAddress
, i
);
252 ne
= X509_NAME_get_entry(nm
, i
);
253 gntmp
.d
.rfc822Name
= X509_NAME_ENTRY_get_data(ne
);
254 if (gntmp
.d
.rfc822Name
->type
!= V_ASN1_IA5STRING
)
255 return X509_V_ERR_UNSUPPORTED_NAME_SYNTAX
;
257 r
= nc_match(&gntmp
, nc
);
265 for (i
= 0; i
< sk_GENERAL_NAME_num(x
->altname
); i
++) {
266 GENERAL_NAME
*gen
= sk_GENERAL_NAME_value(x
->altname
, i
);
267 r
= nc_match(gen
, nc
);
276 static int nc_match(GENERAL_NAME
*gen
, NAME_CONSTRAINTS
*nc
)
278 GENERAL_SUBTREE
*sub
;
282 * Permitted subtrees: if any subtrees exist of matching the type at
283 * least one subtree must match.
286 for (i
= 0; i
< sk_GENERAL_SUBTREE_num(nc
->permittedSubtrees
); i
++) {
287 sub
= sk_GENERAL_SUBTREE_value(nc
->permittedSubtrees
, i
);
288 if (gen
->type
!= sub
->base
->type
)
290 if (sub
->minimum
|| sub
->maximum
)
291 return X509_V_ERR_SUBTREE_MINMAX
;
292 /* If we already have a match don't bother trying any more */
297 r
= nc_match_single(gen
, sub
->base
);
300 else if (r
!= X509_V_ERR_PERMITTED_VIOLATION
)
305 return X509_V_ERR_PERMITTED_VIOLATION
;
307 /* Excluded subtrees: must not match any of these */
309 for (i
= 0; i
< sk_GENERAL_SUBTREE_num(nc
->excludedSubtrees
); i
++) {
310 sub
= sk_GENERAL_SUBTREE_value(nc
->excludedSubtrees
, i
);
311 if (gen
->type
!= sub
->base
->type
)
313 if (sub
->minimum
|| sub
->maximum
)
314 return X509_V_ERR_SUBTREE_MINMAX
;
316 r
= nc_match_single(gen
, sub
->base
);
318 return X509_V_ERR_EXCLUDED_VIOLATION
;
319 else if (r
!= X509_V_ERR_PERMITTED_VIOLATION
)
328 static int nc_match_single(GENERAL_NAME
*gen
, GENERAL_NAME
*base
)
330 switch (base
->type
) {
332 return nc_dn(gen
->d
.directoryName
, base
->d
.directoryName
);
335 return nc_dns(gen
->d
.dNSName
, base
->d
.dNSName
);
338 return nc_email(gen
->d
.rfc822Name
, base
->d
.rfc822Name
);
341 return nc_uri(gen
->d
.uniformResourceIdentifier
,
342 base
->d
.uniformResourceIdentifier
);
345 return X509_V_ERR_UNSUPPORTED_CONSTRAINT_TYPE
;
351 * directoryName name constraint matching. The canonical encoding of
352 * X509_NAME makes this comparison easy. It is matched if the subtree is a
353 * subset of the name.
356 static int nc_dn(X509_NAME
*nm
, X509_NAME
*base
)
358 /* Ensure canonical encodings are up to date. */
359 if (nm
->modified
&& i2d_X509_NAME(nm
, NULL
) < 0)
360 return X509_V_ERR_OUT_OF_MEM
;
361 if (base
->modified
&& i2d_X509_NAME(base
, NULL
) < 0)
362 return X509_V_ERR_OUT_OF_MEM
;
363 if (base
->canon_enclen
> nm
->canon_enclen
)
364 return X509_V_ERR_PERMITTED_VIOLATION
;
365 if (memcmp(base
->canon_enc
, nm
->canon_enc
, base
->canon_enclen
))
366 return X509_V_ERR_PERMITTED_VIOLATION
;
370 static int nc_dns(ASN1_IA5STRING
*dns
, ASN1_IA5STRING
*base
)
372 char *baseptr
= (char *)base
->data
;
373 char *dnsptr
= (char *)dns
->data
;
374 /* Empty matches everything */
378 * Otherwise can add zero or more components on the left so compare RHS
379 * and if dns is longer and expect '.' as preceding character.
381 if (dns
->length
> base
->length
) {
382 dnsptr
+= dns
->length
- base
->length
;
383 if (*baseptr
!= '.' && dnsptr
[-1] != '.')
384 return X509_V_ERR_PERMITTED_VIOLATION
;
387 if (strcasecmp(baseptr
, dnsptr
))
388 return X509_V_ERR_PERMITTED_VIOLATION
;
394 static int nc_email(ASN1_IA5STRING
*eml
, ASN1_IA5STRING
*base
)
396 const char *baseptr
= (char *)base
->data
;
397 const char *emlptr
= (char *)eml
->data
;
399 const char *baseat
= strchr(baseptr
, '@');
400 const char *emlat
= strchr(emlptr
, '@');
402 return X509_V_ERR_UNSUPPORTED_NAME_SYNTAX
;
403 /* Special case: inital '.' is RHS match */
404 if (!baseat
&& (*baseptr
== '.')) {
405 if (eml
->length
> base
->length
) {
406 emlptr
+= eml
->length
- base
->length
;
407 if (!strcasecmp(baseptr
, emlptr
))
410 return X509_V_ERR_PERMITTED_VIOLATION
;
413 /* If we have anything before '@' match local part */
416 if (baseat
!= baseptr
) {
417 if ((baseat
- baseptr
) != (emlat
- emlptr
))
418 return X509_V_ERR_PERMITTED_VIOLATION
;
419 /* Case sensitive match of local part */
420 if (strncmp(baseptr
, emlptr
, emlat
- emlptr
))
421 return X509_V_ERR_PERMITTED_VIOLATION
;
423 /* Position base after '@' */
424 baseptr
= baseat
+ 1;
427 /* Just have hostname left to match: case insensitive */
428 if (strcasecmp(baseptr
, emlptr
))
429 return X509_V_ERR_PERMITTED_VIOLATION
;
435 static int nc_uri(ASN1_IA5STRING
*uri
, ASN1_IA5STRING
*base
)
437 const char *baseptr
= (char *)base
->data
;
438 const char *hostptr
= (char *)uri
->data
;
439 const char *p
= strchr(hostptr
, ':');
441 /* Check for foo:// and skip past it */
442 if (!p
|| (p
[1] != '/') || (p
[2] != '/'))
443 return X509_V_ERR_UNSUPPORTED_NAME_SYNTAX
;
446 /* Determine length of hostname part of URI */
448 /* Look for a port indicator as end of hostname first */
450 p
= strchr(hostptr
, ':');
451 /* Otherwise look for trailing slash */
453 p
= strchr(hostptr
, '/');
456 hostlen
= strlen(hostptr
);
458 hostlen
= p
- hostptr
;
461 return X509_V_ERR_UNSUPPORTED_NAME_SYNTAX
;
463 /* Special case: inital '.' is RHS match */
464 if (*baseptr
== '.') {
465 if (hostlen
> base
->length
) {
466 p
= hostptr
+ hostlen
- base
->length
;
467 if (!strncasecmp(p
, baseptr
, base
->length
))
470 return X509_V_ERR_PERMITTED_VIOLATION
;
473 if ((base
->length
!= (int)hostlen
)
474 || strncasecmp(hostptr
, baseptr
, hostlen
))
475 return X509_V_ERR_PERMITTED_VIOLATION
;