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)
111 * We cannot use strncasecmp here because that applies locale specific rules.
112 * For example in Turkish 'I' is not the uppercase character for 'i'. We need to
113 * do a simple ASCII case comparison ignoring the locale (that is why we use
114 * numeric constants below).
116 static int ia5ncasecmp(const char *s1, const char *s2, size_t n)
118 for (; n > 0; n--, s1++, s2++) {
120 unsigned char c1 = (unsigned char)*s1, c2 = (unsigned char)*s2;
122 /* Convert to lower case */
123 if (c1 >= 0x41 /* A */ && c1 <= 0x5A /* Z */)
125 if (c2 >= 0x41 /* A */ && c2 <= 0x5A /* Z */)
136 } else if (*s1 == 0) {
137 /* If we get here we know that *s2 == 0 too */
145 static int ia5casecmp(const char *s1, const char *s2)
147 /* No portable definition of SIZE_MAX, so we use (size_t)(-1) instead */
148 return ia5ncasecmp(s1, s2, (size_t)(-1));
151 static void *v2i_NAME_CONSTRAINTS(const X509V3_EXT_METHOD *method,
152 X509V3_CTX *ctx, STACK_OF(CONF_VALUE) *nval)
155 CONF_VALUE tval, *val;
156 STACK_OF(GENERAL_SUBTREE) **ptree = NULL;
157 NAME_CONSTRAINTS *ncons = NULL;
158 GENERAL_SUBTREE *sub = NULL;
159 ncons = NAME_CONSTRAINTS_new();
162 for (i = 0; i < sk_CONF_VALUE_num(nval); i++) {
163 val = sk_CONF_VALUE_value(nval, i);
164 if (!strncmp(val->name, "permitted", 9) && val->name[9]) {
165 ptree = &ncons->permittedSubtrees;
166 tval.name = val->name + 10;
167 } else if (!strncmp(val->name, "excluded", 8) && val->name[8]) {
168 ptree = &ncons->excludedSubtrees;
169 tval.name = val->name + 9;
171 X509V3err(X509V3_F_V2I_NAME_CONSTRAINTS, X509V3_R_INVALID_SYNTAX);
174 tval.value = val->value;
175 sub = GENERAL_SUBTREE_new();
178 if (!v2i_GENERAL_NAME_ex(sub->base, method, ctx, &tval, 1))
181 *ptree = sk_GENERAL_SUBTREE_new_null();
182 if (!*ptree || !sk_GENERAL_SUBTREE_push(*ptree, sub))
190 X509V3err(X509V3_F_V2I_NAME_CONSTRAINTS, ERR_R_MALLOC_FAILURE);
193 NAME_CONSTRAINTS_free(ncons);
195 GENERAL_SUBTREE_free(sub);
200 static int i2r_NAME_CONSTRAINTS(const X509V3_EXT_METHOD *method, void *a,
203 NAME_CONSTRAINTS *ncons = a;
204 do_i2r_name_constraints(method, ncons->permittedSubtrees,
205 bp, ind, "Permitted");
206 do_i2r_name_constraints(method, ncons->excludedSubtrees,
207 bp, ind, "Excluded");
211 static int do_i2r_name_constraints(const X509V3_EXT_METHOD *method,
212 STACK_OF(GENERAL_SUBTREE) *trees,
213 BIO *bp, int ind, char *name)
215 GENERAL_SUBTREE *tree;
217 if (sk_GENERAL_SUBTREE_num(trees) > 0)
218 BIO_printf(bp, "%*s%s:\n", ind, "", name);
219 for (i = 0; i < sk_GENERAL_SUBTREE_num(trees); i++) {
220 tree = sk_GENERAL_SUBTREE_value(trees, i);
221 BIO_printf(bp, "%*s", ind + 2, "");
222 if (tree->base->type == GEN_IPADD)
223 print_nc_ipadd(bp, tree->base->d.ip);
225 GENERAL_NAME_print(bp, tree->base);
231 static int print_nc_ipadd(BIO *bp, ASN1_OCTET_STRING *ip)
239 BIO_printf(bp, "%d.%d.%d.%d/%d.%d.%d.%d",
240 p[0], p[1], p[2], p[3], p[4], p[5], p[6], p[7]);
241 } else if (len == 32) {
242 for (i = 0; i < 16; i++) {
243 BIO_printf(bp, "%X", p[0] << 8 | p[1]);
251 BIO_printf(bp, "IP Address:<invalid>");
256 * Check a certificate conforms to a specified set of constraints.
258 * X509_V_OK: All constraints obeyed.
259 * X509_V_ERR_PERMITTED_VIOLATION: Permitted subtree violation.
260 * X509_V_ERR_EXCLUDED_VIOLATION: Excluded subtree violation.
261 * X509_V_ERR_SUBTREE_MINMAX: Min or max values present and matching type.
262 * X509_V_ERR_UNSUPPORTED_CONSTRAINT_TYPE: Unsupported constraint type.
263 * X509_V_ERR_UNSUPPORTED_CONSTRAINT_SYNTAX: bad unsupported constraint syntax.
264 * X509_V_ERR_UNSUPPORTED_NAME_SYNTAX: bad or unsupported syntax of name
267 int NAME_CONSTRAINTS_check(X509 *x, NAME_CONSTRAINTS *nc)
272 nm = X509_get_subject_name(x);
274 if (X509_NAME_entry_count(nm) > 0) {
276 gntmp.type = GEN_DIRNAME;
277 gntmp.d.directoryName = nm;
279 r = nc_match(&gntmp, nc);
284 gntmp.type = GEN_EMAIL;
286 /* Process any email address attributes in subject name */
290 i = X509_NAME_get_index_by_NID(nm, NID_pkcs9_emailAddress, i);
293 ne = X509_NAME_get_entry(nm, i);
294 gntmp.d.rfc822Name = X509_NAME_ENTRY_get_data(ne);
295 if (gntmp.d.rfc822Name->type != V_ASN1_IA5STRING)
296 return X509_V_ERR_UNSUPPORTED_NAME_SYNTAX;
298 r = nc_match(&gntmp, nc);
306 for (i = 0; i < sk_GENERAL_NAME_num(x->altname); i++) {
307 GENERAL_NAME *gen = sk_GENERAL_NAME_value(x->altname, i);
308 r = nc_match(gen, nc);
317 static int nc_match(GENERAL_NAME *gen, NAME_CONSTRAINTS *nc)
319 GENERAL_SUBTREE *sub;
323 * Permitted subtrees: if any subtrees exist of matching the type at
324 * least one subtree must match.
327 for (i = 0; i < sk_GENERAL_SUBTREE_num(nc->permittedSubtrees); i++) {
328 sub = sk_GENERAL_SUBTREE_value(nc->permittedSubtrees, i);
329 if (gen->type != sub->base->type)
331 if (sub->minimum || sub->maximum)
332 return X509_V_ERR_SUBTREE_MINMAX;
333 /* If we already have a match don't bother trying any more */
338 r = nc_match_single(gen, sub->base);
341 else if (r != X509_V_ERR_PERMITTED_VIOLATION)
346 return X509_V_ERR_PERMITTED_VIOLATION;
348 /* Excluded subtrees: must not match any of these */
350 for (i = 0; i < sk_GENERAL_SUBTREE_num(nc->excludedSubtrees); i++) {
351 sub = sk_GENERAL_SUBTREE_value(nc->excludedSubtrees, i);
352 if (gen->type != sub->base->type)
354 if (sub->minimum || sub->maximum)
355 return X509_V_ERR_SUBTREE_MINMAX;
357 r = nc_match_single(gen, sub->base);
359 return X509_V_ERR_EXCLUDED_VIOLATION;
360 else if (r != X509_V_ERR_PERMITTED_VIOLATION)
369 static int nc_match_single(GENERAL_NAME *gen, GENERAL_NAME *base)
371 switch (base->type) {
373 return nc_dn(gen->d.directoryName, base->d.directoryName);
376 return nc_dns(gen->d.dNSName, base->d.dNSName);
379 return nc_email(gen->d.rfc822Name, base->d.rfc822Name);
382 return nc_uri(gen->d.uniformResourceIdentifier,
383 base->d.uniformResourceIdentifier);
386 return X509_V_ERR_UNSUPPORTED_CONSTRAINT_TYPE;
392 * directoryName name constraint matching. The canonical encoding of
393 * X509_NAME makes this comparison easy. It is matched if the subtree is a
394 * subset of the name.
397 static int nc_dn(X509_NAME *nm, X509_NAME *base)
399 /* Ensure canonical encodings are up to date. */
400 if (nm->modified && i2d_X509_NAME(nm, NULL) < 0)
401 return X509_V_ERR_OUT_OF_MEM;
402 if (base->modified && i2d_X509_NAME(base, NULL) < 0)
403 return X509_V_ERR_OUT_OF_MEM;
404 if (base->canon_enclen > nm->canon_enclen)
405 return X509_V_ERR_PERMITTED_VIOLATION;
406 if (memcmp(base->canon_enc, nm->canon_enc, base->canon_enclen))
407 return X509_V_ERR_PERMITTED_VIOLATION;
411 static int nc_dns(ASN1_IA5STRING *dns, ASN1_IA5STRING *base)
413 char *baseptr = (char *)base->data;
414 char *dnsptr = (char *)dns->data;
415 /* Empty matches everything */
419 * Otherwise can add zero or more components on the left so compare RHS
420 * and if dns is longer and expect '.' as preceding character.
422 if (dns->length > base->length) {
423 dnsptr += dns->length - base->length;
424 if (*baseptr != '.' && dnsptr[-1] != '.')
425 return X509_V_ERR_PERMITTED_VIOLATION;
428 if (ia5casecmp(baseptr, dnsptr))
429 return X509_V_ERR_PERMITTED_VIOLATION;
435 static int nc_email(ASN1_IA5STRING *eml, ASN1_IA5STRING *base)
437 const char *baseptr = (char *)base->data;
438 const char *emlptr = (char *)eml->data;
440 const char *baseat = strchr(baseptr, '@');
441 const char *emlat = strchr(emlptr, '@');
443 return X509_V_ERR_UNSUPPORTED_NAME_SYNTAX;
444 /* Special case: inital '.' is RHS match */
445 if (!baseat && (*baseptr == '.')) {
446 if (eml->length > base->length) {
447 emlptr += eml->length - base->length;
448 if (ia5casecmp(baseptr, emlptr) == 0)
451 return X509_V_ERR_PERMITTED_VIOLATION;
454 /* If we have anything before '@' match local part */
457 if (baseat != baseptr) {
458 if ((baseat - baseptr) != (emlat - emlptr))
459 return X509_V_ERR_PERMITTED_VIOLATION;
460 /* Case sensitive match of local part */
461 if (strncmp(baseptr, emlptr, emlat - emlptr))
462 return X509_V_ERR_PERMITTED_VIOLATION;
464 /* Position base after '@' */
465 baseptr = baseat + 1;
468 /* Just have hostname left to match: case insensitive */
469 if (ia5casecmp(baseptr, emlptr))
470 return X509_V_ERR_PERMITTED_VIOLATION;
476 static int nc_uri(ASN1_IA5STRING *uri, ASN1_IA5STRING *base)
478 const char *baseptr = (char *)base->data;
479 const char *hostptr = (char *)uri->data;
480 const char *p = strchr(hostptr, ':');
482 /* Check for foo:// and skip past it */
483 if (!p || (p[1] != '/') || (p[2] != '/'))
484 return X509_V_ERR_UNSUPPORTED_NAME_SYNTAX;
487 /* Determine length of hostname part of URI */
489 /* Look for a port indicator as end of hostname first */
491 p = strchr(hostptr, ':');
492 /* Otherwise look for trailing slash */
494 p = strchr(hostptr, '/');
497 hostlen = strlen(hostptr);
499 hostlen = p - hostptr;
502 return X509_V_ERR_UNSUPPORTED_NAME_SYNTAX;
504 /* Special case: inital '.' is RHS match */
505 if (*baseptr == '.') {
506 if (hostlen > base->length) {
507 p = hostptr + hostlen - base->length;
508 if (ia5ncasecmp(p, baseptr, base->length) == 0)
511 return X509_V_ERR_PERMITTED_VIOLATION;
514 if ((base->length != (int)hostlen)
515 || ia5ncasecmp(hostptr, baseptr, hostlen))
516 return X509_V_ERR_PERMITTED_VIOLATION;