2 * Copyright 1999-2023 The OpenSSL Project Authors. All Rights Reserved.
4 * Licensed under the Apache License 2.0 (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
10 /* X509 v3 extension utilities */
13 #include "internal/cryptlib.h"
14 #include <openssl/conf.h>
15 #include <openssl/x509v3.h>
19 static STACK_OF(X509V3_EXT_METHOD) *ext_list = NULL;
21 static int ext_cmp(const X509V3_EXT_METHOD *const *a,
22 const X509V3_EXT_METHOD *const *b);
23 static void ext_list_free(X509V3_EXT_METHOD *ext);
25 int X509V3_EXT_add(X509V3_EXT_METHOD *ext)
28 && (ext_list = sk_X509V3_EXT_METHOD_new(ext_cmp)) == NULL) {
29 ERR_raise(ERR_LIB_X509V3, ERR_R_CRYPTO_LIB);
32 if (!sk_X509V3_EXT_METHOD_push(ext_list, ext)) {
33 ERR_raise(ERR_LIB_X509V3, ERR_R_CRYPTO_LIB);
39 static int ext_cmp(const X509V3_EXT_METHOD *const *a,
40 const X509V3_EXT_METHOD *const *b)
42 return ((*a)->ext_nid - (*b)->ext_nid);
45 DECLARE_OBJ_BSEARCH_CMP_FN(const X509V3_EXT_METHOD *,
46 const X509V3_EXT_METHOD *, ext);
47 IMPLEMENT_OBJ_BSEARCH_CMP_FN(const X509V3_EXT_METHOD *,
48 const X509V3_EXT_METHOD *, ext);
50 #include "standard_exts.h"
52 const X509V3_EXT_METHOD *X509V3_EXT_get_nid(int nid)
54 X509V3_EXT_METHOD tmp;
55 const X509V3_EXT_METHOD *t = &tmp, *const *ret;
61 ret = OBJ_bsearch_ext(&t, standard_exts, STANDARD_EXTENSION_COUNT);
66 /* Ideally, this would be done under a lock */
67 sk_X509V3_EXT_METHOD_sort(ext_list);
68 idx = sk_X509V3_EXT_METHOD_find(ext_list, &tmp);
69 /* A failure to locate the item is handled by the value method */
70 return sk_X509V3_EXT_METHOD_value(ext_list, idx);
73 const X509V3_EXT_METHOD *X509V3_EXT_get(X509_EXTENSION *ext)
76 if ((nid = OBJ_obj2nid(X509_EXTENSION_get_object(ext))) == NID_undef)
78 return X509V3_EXT_get_nid(nid);
81 int X509V3_EXT_add_list(X509V3_EXT_METHOD *extlist)
83 for (; extlist->ext_nid != -1; extlist++)
84 if (!X509V3_EXT_add(extlist))
89 int X509V3_EXT_add_alias(int nid_to, int nid_from)
91 const X509V3_EXT_METHOD *ext;
92 X509V3_EXT_METHOD *tmpext;
94 if ((ext = X509V3_EXT_get_nid(nid_from)) == NULL) {
95 ERR_raise(ERR_LIB_X509V3, X509V3_R_EXTENSION_NOT_FOUND);
98 if ((tmpext = OPENSSL_malloc(sizeof(*tmpext))) == NULL)
101 tmpext->ext_nid = nid_to;
102 tmpext->ext_flags |= X509V3_EXT_DYNAMIC;
103 return X509V3_EXT_add(tmpext);
106 void X509V3_EXT_cleanup(void)
108 sk_X509V3_EXT_METHOD_pop_free(ext_list, ext_list_free);
112 static void ext_list_free(X509V3_EXT_METHOD *ext)
114 if (ext->ext_flags & X509V3_EXT_DYNAMIC)
119 * Legacy function: we don't need to add standard extensions any more because
120 * they are now kept in ext_dat.h.
123 int X509V3_add_standard_extensions(void)
128 /* Return an extension internal structure */
130 void *X509V3_EXT_d2i(X509_EXTENSION *ext)
132 const X509V3_EXT_METHOD *method;
133 const unsigned char *p;
134 ASN1_STRING *extvalue;
137 if ((method = X509V3_EXT_get(ext)) == NULL)
139 extvalue = X509_EXTENSION_get_data(ext);
140 p = ASN1_STRING_get0_data(extvalue);
141 extlen = ASN1_STRING_length(extvalue);
143 return ASN1_item_d2i(NULL, &p, extlen, ASN1_ITEM_ptr(method->it));
144 return method->d2i(NULL, &p, extlen);
148 * Get critical flag and decoded version of extension from a NID.
149 * The "idx" variable returns the last found extension and can
150 * be used to retrieve multiple extensions of the same NID.
151 * However multiple extensions with the same NID is usually
152 * due to a badly encoded certificate so if idx is NULL we
153 * choke if multiple extensions exist.
154 * The "crit" variable is set to the critical value.
155 * The return value is the decoded extension or NULL on
156 * error. The actual error can have several different causes,
157 * the value of *crit reflects the cause:
158 * >= 0, extension found but not decoded (reflects critical value).
159 * -1 extension not found.
160 * -2 extension occurs more than once.
163 void *X509V3_get_d2i(const STACK_OF(X509_EXTENSION) *x, int nid, int *crit,
167 X509_EXTENSION *ex, *found_ex = NULL;
182 for (i = lastpos; i < sk_X509_EXTENSION_num(x); i++) {
183 ex = sk_X509_EXTENSION_value(x, i);
184 if (OBJ_obj2nid(X509_EXTENSION_get_object(ex)) == nid) {
189 } else if (found_ex) {
190 /* Found more than one */
201 *crit = X509_EXTENSION_get_critical(found_ex);
202 return X509V3_EXT_d2i(found_ex);
205 /* Extension not found */
214 * This function is a general extension append, replace and delete utility.
215 * The precise operation is governed by the 'flags' value. The 'crit' and
216 * 'value' arguments (if relevant) are the extensions internal structure.
219 int X509V3_add1_i2d(STACK_OF(X509_EXTENSION) **x, int nid, void *value,
220 int crit, unsigned long flags)
222 int errcode, extidx = -1;
223 X509_EXTENSION *ext = NULL, *extmp;
224 STACK_OF(X509_EXTENSION) *ret = NULL;
225 unsigned long ext_op = flags & X509V3_ADD_OP_MASK;
228 * If appending we don't care if it exists, otherwise look for existing
231 if (ext_op != X509V3_ADD_APPEND)
232 extidx = X509v3_get_ext_by_NID(*x, nid, -1);
234 /* See if extension exists */
236 /* If keep existing, nothing to do */
237 if (ext_op == X509V3_ADD_KEEP_EXISTING)
239 /* If default then its an error */
240 if (ext_op == X509V3_ADD_DEFAULT) {
241 errcode = X509V3_R_EXTENSION_EXISTS;
244 /* If delete, just delete it */
245 if (ext_op == X509V3_ADD_DELETE) {
246 extmp = sk_X509_EXTENSION_delete(*x, extidx);
249 X509_EXTENSION_free(extmp);
254 * If replace existing or delete, error since extension must exist
256 if ((ext_op == X509V3_ADD_REPLACE_EXISTING) ||
257 (ext_op == X509V3_ADD_DELETE)) {
258 errcode = X509V3_R_EXTENSION_NOT_FOUND;
264 * If we get this far then we have to create an extension: could have
265 * some flags for alternative encoding schemes...
268 ext = X509V3_EXT_i2d(nid, crit, value);
271 ERR_raise(ERR_LIB_X509V3, X509V3_R_ERROR_CREATING_EXTENSION);
275 /* If extension exists replace it.. */
277 extmp = sk_X509_EXTENSION_value(*x, extidx);
278 X509_EXTENSION_free(extmp);
279 if (!sk_X509_EXTENSION_set(*x, extidx, ext))
286 && (ret = sk_X509_EXTENSION_new_null()) == NULL)
288 if (!sk_X509_EXTENSION_push(ret, ext))
295 /* ERR_raise(ERR_LIB_X509V3, ERR_R_CRYPTO_LIB); */
297 sk_X509_EXTENSION_free(ret);
298 X509_EXTENSION_free(ext);
302 if (!(flags & X509V3_ADD_SILENT))
303 ERR_raise(ERR_LIB_X509V3, errcode);