1 /* ====================================================================
2  * Copyright (c) 2006 The OpenSSL Project.  All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  *
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  *
11  * 2. Redistributions in binary form must reproduce the above copyright
12  *    notice, this list of conditions and the following disclaimer in
13  *    the documentation and/or other materials provided with the
14  *    distribution.
15  *
16  * 3. All advertising materials mentioning features or use of this
17  *    software must display the following acknowledgment:
18  *    "This product includes software developed by the OpenSSL Project
19  *    for use in the OpenSSL Toolkit. (http://www.OpenSSL.org/)"
20  *
21  * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
22  *    endorse or promote products derived from this software without
23  *    prior written permission. For written permission, please contact
24  *    licensing@OpenSSL.org.
25  *
26  * 5. Products derived from this software may not be called "OpenSSL"
27  *    nor may "OpenSSL" appear in their names without prior written
28  *    permission of the OpenSSL Project.
29  *
30  * 6. Redistributions of any form whatsoever must retain the following
31  *    acknowledgment:
32  *    "This product includes software developed by the OpenSSL Project
33  *    for use in the OpenSSL Toolkit (http://www.OpenSSL.org/)"
34  *
35  * THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT ``AS IS'' AND ANY
36  * EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
37  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
38  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE OpenSSL PROJECT OR
39  * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
40  * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
41  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
42  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
43  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
44  * STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
45  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
46  * OF THE POSSIBILITY OF SUCH DAMAGE.
47  * ====================================================================
48  *
49  * This product includes cryptographic software written by Eric Young
50  * (eay@cryptsoft.com).  This product includes software written by Tim
51  * Hudson (tjh@cryptsoft.com).
52  *
53  */
54 
55 #include "eng_int.h"
56 #include "asn1_locl.h"
57 #include <openssl/evp.h>
58 
59 /* If this symbol is defined then ENGINE_get_pkey_asn1_meth_engine(), the
60  * function that is used by EVP to hook in pkey_asn1_meth code and cache
61  * defaults (etc), will display brief debugging summaries to stderr with the
62  * 'nid'. */
63 /* #define ENGINE_PKEY_ASN1_METH_DEBUG */
64 
65 static ENGINE_TABLE *pkey_asn1_meth_table = NULL;
66 
67 void ENGINE_unregister_pkey_asn1_meths(ENGINE *e)
68 	{
69 	engine_table_unregister(&pkey_asn1_meth_table, e);
70 	}
71 
72 static void engine_unregister_all_pkey_asn1_meths(void)
73 	{
74 	engine_table_cleanup(&pkey_asn1_meth_table);
75 	}
76 
77 int ENGINE_register_pkey_asn1_meths(ENGINE *e)
78 	{
79 	if(e->pkey_asn1_meths)
80 		{
81 		const int *nids;
82 		int num_nids = e->pkey_asn1_meths(e, NULL, &nids, 0);
83 		if(num_nids > 0)
84 			return engine_table_register(&pkey_asn1_meth_table,
85 				engine_unregister_all_pkey_asn1_meths, e, nids,
86 					num_nids, 0);
87 		}
88 	return 1;
89 	}
90 
91 void ENGINE_register_all_pkey_asn1_meths(void)
92 	{
93 	ENGINE *e;
94 
95 	for(e=ENGINE_get_first() ; e ; e=ENGINE_get_next(e))
96 		ENGINE_register_pkey_asn1_meths(e);
97 	}
98 
99 int ENGINE_set_default_pkey_asn1_meths(ENGINE *e)
100 	{
101 	if(e->pkey_asn1_meths)
102 		{
103 		const int *nids;
104 		int num_nids = e->pkey_asn1_meths(e, NULL, &nids, 0);
105 		if(num_nids > 0)
106 			return engine_table_register(&pkey_asn1_meth_table,
107 				engine_unregister_all_pkey_asn1_meths, e, nids,
108 					num_nids, 1);
109 		}
110 	return 1;
111 	}
112 
113 /* Exposed API function to get a functional reference from the implementation
114  * table (ie. try to get a functional reference from the tabled structural
115  * references) for a given pkey_asn1_meth 'nid' */
116 ENGINE *ENGINE_get_pkey_asn1_meth_engine(int nid)
117 	{
118 	return engine_table_select(&pkey_asn1_meth_table, nid);
119 	}
120 
121 /* Obtains a pkey_asn1_meth implementation from an ENGINE functional reference */
122 const EVP_PKEY_ASN1_METHOD *ENGINE_get_pkey_asn1_meth(ENGINE *e, int nid)
123 	{
124 	EVP_PKEY_ASN1_METHOD *ret;
125 	ENGINE_PKEY_ASN1_METHS_PTR fn = ENGINE_get_pkey_asn1_meths(e);
126 	if(!fn || !fn(e, &ret, NULL, nid))
127 		{
128 		ENGINEerr(ENGINE_F_ENGINE_GET_PKEY_ASN1_METH,
129 				ENGINE_R_UNIMPLEMENTED_PUBLIC_KEY_METHOD);
130 		return NULL;
131 		}
132 	return ret;
133 	}
134 
135 /* Gets the pkey_asn1_meth callback from an ENGINE structure */
136 ENGINE_PKEY_ASN1_METHS_PTR ENGINE_get_pkey_asn1_meths(const ENGINE *e)
137 	{
138 	return e->pkey_asn1_meths;
139 	}
140 
141 /* Sets the pkey_asn1_meth callback in an ENGINE structure */
142 int ENGINE_set_pkey_asn1_meths(ENGINE *e, ENGINE_PKEY_ASN1_METHS_PTR f)
143 	{
144 	e->pkey_asn1_meths = f;
145 	return 1;
146 	}
147 
148 /* Internal function to free up EVP_PKEY_ASN1_METHOD structures before an
149  * ENGINE is destroyed
150  */
151 
152 void engine_pkey_asn1_meths_free(ENGINE *e)
153 	{
154 	int i;
155 	EVP_PKEY_ASN1_METHOD *pkm;
156 	if (e->pkey_asn1_meths)
157 		{
158 		const int *pknids;
159 		int npknids;
160 		npknids = e->pkey_asn1_meths(e, NULL, &pknids, 0);
161 		for (i = 0; i < npknids; i++)
162 			{
163 			if (e->pkey_asn1_meths(e, &pkm, NULL, pknids[i]))
164 				{
165 				EVP_PKEY_asn1_free(pkm);
166 				}
167 			}
168 		}
169 	}
170 
171 /* Find a method based on a string. This does a linear search through
172  * all implemented algorithms. This is OK in practice because only
173  * a small number of algorithms are likely to be implemented in an engine
174  * and it is not used for speed critical operations.
175  */
176 
177 const EVP_PKEY_ASN1_METHOD *ENGINE_get_pkey_asn1_meth_str(ENGINE *e,
178 					const char *str, int len)
179 	{
180 	int i, nidcount;
181 	const int *nids;
182 	EVP_PKEY_ASN1_METHOD *ameth;
183 	if (!e->pkey_asn1_meths)
184 		return NULL;
185 	if (len == -1)
186 		len = strlen(str);
187 	nidcount = e->pkey_asn1_meths(e, NULL, &nids, 0);
188 	for (i = 0; i < nidcount; i++)
189 		{
190 		e->pkey_asn1_meths(e, &ameth, NULL, nids[i]);
191 		if (((int)strlen(ameth->pem_str) == len) &&
192 					!strncasecmp(ameth->pem_str, str, len))
193 			return ameth;
194 		}
195 	return NULL;
196 	}
197 
198 typedef struct
199 	{
200 	ENGINE *e;
201 	const EVP_PKEY_ASN1_METHOD *ameth;
202 	const char *str;
203 	int len;
204 	} ENGINE_FIND_STR;
205 
206 static void look_str_cb(int nid, STACK_OF(ENGINE) *sk, ENGINE *def, void *arg)
207 	{
208 	ENGINE_FIND_STR *lk = arg;
209 	int i;
210 	if (lk->ameth)
211 		return;
212 	for (i = 0; i < sk_ENGINE_num(sk); i++)
213 		{
214 		ENGINE *e = sk_ENGINE_value(sk, i);
215 		EVP_PKEY_ASN1_METHOD *ameth;
216 		e->pkey_asn1_meths(e, &ameth, NULL, nid);
217 		if (((int)strlen(ameth->pem_str) == lk->len) &&
218 				!strncasecmp(ameth->pem_str, lk->str, lk->len))
219 			{
220 			lk->e = e;
221 			lk->ameth = ameth;
222 			return;
223 			}
224 		}
225 	}
226 
227 const EVP_PKEY_ASN1_METHOD *ENGINE_pkey_asn1_find_str(ENGINE **pe,
228 					const char *str, int len)
229 	{
230 	ENGINE_FIND_STR fstr;
231 	fstr.e = NULL;
232 	fstr.ameth = NULL;
233 	fstr.str = str;
234 	fstr.len = len;
235 	CRYPTO_w_lock(CRYPTO_LOCK_ENGINE);
236 	engine_table_doall(pkey_asn1_meth_table, look_str_cb, &fstr);
237 	/* If found obtain a structural reference to engine */
238 	if (fstr.e)
239 		{
240 		fstr.e->struct_ref++;
241 		engine_ref_debug(fstr.e, 0, 1)
242 		}
243 	*pe = fstr.e;
244 	CRYPTO_w_unlock(CRYPTO_LOCK_ENGINE);
245 	return fstr.ameth;
246 	}
247