Fix typo in help & comment formatting
[openssl.git] / engines / e_sureware.c
1 /*-
2 *  Written by Corinne Dive-Reclus(cdive@baltimore.com)
3 *
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 *
9 * 1. Redistributions of source code must retain the above copyright
10 *    notice, this list of conditions and the following disclaimer.
11 *
12 * 2. Redistributions in binary form must reproduce the above copyright
13 *    notice, this list of conditions and the following disclaimer in
14 *    the documentation and/or other materials provided with the
15 *    distribution.
16 *
17 * 3. All advertising materials mentioning features or use of this
18 *    software must display the following acknowledgment:
19 *    "This product includes software developed by the OpenSSL Project
20 *    for use in the OpenSSL Toolkit. (http://www.OpenSSL.org/)"
21 *
22 * 4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to
23 *    endorse or promote products derived from this software without
24 *    prior written permission. For written permission, please contact
25 *    licensing@OpenSSL.org.
26 *
27 * 5. Products derived from this software may not be called "OpenSSL"
28 *    nor may "OpenSSL" appear in their names without prior written
29 *    permission of the OpenSSL Project.
30 *
31 * 6. Redistributions of any form whatsoever must retain the following
32 *    acknowledgment:
33 *    "This product includes software developed by the OpenSSL Project
34 *    for use in the OpenSSL Toolkit (http://www.OpenSSL.org/)"
35 *
36 * Written by Corinne Dive-Reclus(cdive@baltimore.com)
37 *
38 * Copyright@2001 Baltimore Technologies Ltd.
39 * All right Reserved.
40 *                                                                                      *
41 *        THIS FILE IS PROVIDED BY BALTIMORE TECHNOLOGIES ``AS IS'' AND                 *
42 *        ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE         *
43 *        IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE    *
44 *        ARE DISCLAIMED.  IN NO EVENT SHALL BALTIMORE TECHNOLOGIES BE LIABLE           *
45 *        FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL    *
46 *        DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS       *
47 *        OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)         *
48 *        HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT    *
49 *        LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY     *
50 *        OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF        *
51 *        SUCH DAMAGE.                                                                  *
52 ====================================================================*/
53
54 #include <stdio.h>
55 #include <string.h>
56 #include <openssl/crypto.h>
57 #include <openssl/pem.h>
58 #include <openssl/dso.h>
59 #include <openssl/engine.h>
60 #include <openssl/rand.h>
61 #ifndef OPENSSL_NO_RSA
62 # include <openssl/rsa.h>
63 #endif
64 #ifndef OPENSSL_NO_DSA
65 # include <openssl/dsa.h>
66 #endif
67 #ifndef OPENSSL_NO_DH
68 # include <openssl/dh.h>
69 #endif
70 #include <openssl/bn.h>
71
72 #ifndef OPENSSL_NO_HW
73 # ifndef OPENSSL_NO_HW_SUREWARE
74
75 #  ifdef FLAT_INC
76 #   include "sureware.h"
77 #  else
78 #   include "vendor_defns/sureware.h"
79 #  endif
80
81 #  define SUREWARE_LIB_NAME "sureware engine"
82 #  include "e_sureware_err.c"
83
84 static int surewarehk_ctrl(ENGINE *e, int cmd, long i, void *p,
85                            void (*f) (void));
86 static int surewarehk_destroy(ENGINE *e);
87 static int surewarehk_init(ENGINE *e);
88 static int surewarehk_finish(ENGINE *e);
89 static int surewarehk_modexp(BIGNUM *r, const BIGNUM *a, const BIGNUM *p,
90                              const BIGNUM *m, BN_CTX *ctx);
91
92 /* RSA stuff */
93 #  ifndef OPENSSL_NO_RSA
94 static int surewarehk_rsa_priv_dec(int flen, const unsigned char *from,
95                                    unsigned char *to, RSA *rsa, int padding);
96 static int surewarehk_rsa_sign(int flen, const unsigned char *from,
97                                unsigned char *to, RSA *rsa, int padding);
98 #  endif
99
100 /* RAND stuff */
101 static int surewarehk_rand_bytes(unsigned char *buf, int num);
102 static int surewarehk_rand_seed(const void *buf, int num);
103 static int surewarehk_rand_add(const void *buf, int num, double entropy);
104
105 /* KM stuff */
106 static EVP_PKEY *surewarehk_load_privkey(ENGINE *e, const char *key_id,
107                                          UI_METHOD *ui_method,
108                                          void *callback_data);
109 static EVP_PKEY *surewarehk_load_pubkey(ENGINE *e, const char *key_id,
110                                         UI_METHOD *ui_method,
111                                         void *callback_data);
112 static void surewarehk_ex_free(void *obj, void *item, CRYPTO_EX_DATA *ad,
113                                int idx, long argl, void *argp);
114
115 #  ifndef OPENSSL_NO_RSA
116 /* This function is aliased to mod_exp (with the mont stuff dropped). */
117 static int surewarehk_mod_exp_mont(BIGNUM *r, const BIGNUM *a,
118                                    const BIGNUM *p, const BIGNUM *m,
119                                    BN_CTX *ctx, BN_MONT_CTX *m_ctx)
120 {
121     return surewarehk_modexp(r, a, p, m, ctx);
122 }
123
124 /* Our internal RSA_METHOD that we provide pointers to */
125 static RSA_METHOD surewarehk_rsa = {
126     "SureWare RSA method",
127     NULL,                       /* pub_enc */
128     NULL,                       /* pub_dec */
129     surewarehk_rsa_sign,        /* our rsa_sign is OpenSSL priv_enc */
130     surewarehk_rsa_priv_dec,    /* priv_dec */
131     NULL,                       /* mod_exp */
132     surewarehk_mod_exp_mont,    /* mod_exp_mongomery */
133     NULL,                       /* init */
134     NULL,                       /* finish */
135     0,                          /* RSA flag */
136     NULL,
137     NULL,                       /* OpenSSL sign */
138     NULL,                       /* OpenSSL verify */
139     NULL                        /* keygen */
140 };
141 #  endif
142
143 #  ifndef OPENSSL_NO_DH
144 /* Our internal DH_METHOD that we provide pointers to */
145 /* This function is aliased to mod_exp (with the dh and mont dropped). */
146 static int surewarehk_modexp_dh(const DH *dh, BIGNUM *r, const BIGNUM *a,
147                                 const BIGNUM *p, const BIGNUM *m, BN_CTX *ctx,
148                                 BN_MONT_CTX *m_ctx)
149 {
150     return surewarehk_modexp(r, a, p, m, ctx);
151 }
152
153 static DH_METHOD surewarehk_dh = {
154     "SureWare DH method",
155     NULL,                       /* gen_key */
156     NULL,                       /* agree, */
157     surewarehk_modexp_dh,       /* dh mod exp */
158     NULL,                       /* init */
159     NULL,                       /* finish */
160     0,                          /* flags */
161     NULL,
162     NULL
163 };
164 #  endif
165
166 static RAND_METHOD surewarehk_rand = {
167     /* "SureWare RAND method", */
168     surewarehk_rand_seed,
169     surewarehk_rand_bytes,
170     NULL,                       /* cleanup */
171     surewarehk_rand_add,
172     surewarehk_rand_bytes,
173     NULL,                       /* rand_status */
174 };
175
176 #  ifndef OPENSSL_NO_DSA
177 /* DSA stuff */
178 static DSA_SIG *surewarehk_dsa_do_sign(const unsigned char *dgst, int dlen,
179                                        DSA *dsa);
180 static int surewarehk_dsa_mod_exp(DSA *dsa, BIGNUM *rr, BIGNUM *a1,
181                                   BIGNUM *p1, BIGNUM *a2, BIGNUM *p2,
182                                   BIGNUM *m, BN_CTX *ctx,
183                                   BN_MONT_CTX *in_mont)
184 {
185     BIGNUM t;
186     int to_return = 0;
187     BN_init(&t);
188     /* let rr = a1 ^ p1 mod m */
189     if (!surewarehk_modexp(rr, a1, p1, m, ctx))
190         goto end;
191     /* let t = a2 ^ p2 mod m */
192     if (!surewarehk_modexp(&t, a2, p2, m, ctx))
193         goto end;
194     /* let rr = rr * t mod m */
195     if (!BN_mod_mul(rr, rr, &t, m, ctx))
196         goto end;
197     to_return = 1;
198  end:
199     BN_free(&t);
200     return to_return;
201 }
202
203 static DSA_METHOD surewarehk_dsa = {
204     "SureWare DSA method",
205     surewarehk_dsa_do_sign,
206     NULL,                       /* sign setup */
207     NULL,                       /* verify, */
208     surewarehk_dsa_mod_exp,     /* mod exp */
209     NULL,                       /* bn mod exp */
210     NULL,                       /* init */
211     NULL,                       /* finish */
212     0,
213     NULL,
214     NULL,
215     NULL
216 };
217 #  endif
218
219 static const char *engine_sureware_id = "sureware";
220 static const char *engine_sureware_name = "SureWare hardware engine support";
221
222 /* Now, to our own code */
223
224 /*
225  * As this is only ever called once, there's no need for locking (indeed -
226  * the lock will already be held by our caller!!!)
227  */
228 static int bind_sureware(ENGINE *e)
229 {
230 #  ifndef OPENSSL_NO_RSA
231     const RSA_METHOD *meth1;
232 #  endif
233 #  ifndef OPENSSL_NO_DSA
234     const DSA_METHOD *meth2;
235 #  endif
236 #  ifndef OPENSSL_NO_DH
237     const DH_METHOD *meth3;
238 #  endif
239
240     if (!ENGINE_set_id(e, engine_sureware_id) ||
241         !ENGINE_set_name(e, engine_sureware_name) ||
242 #  ifndef OPENSSL_NO_RSA
243         !ENGINE_set_RSA(e, &surewarehk_rsa) ||
244 #  endif
245 #  ifndef OPENSSL_NO_DSA
246         !ENGINE_set_DSA(e, &surewarehk_dsa) ||
247 #  endif
248 #  ifndef OPENSSL_NO_DH
249         !ENGINE_set_DH(e, &surewarehk_dh) ||
250 #  endif
251         !ENGINE_set_RAND(e, &surewarehk_rand) ||
252         !ENGINE_set_destroy_function(e, surewarehk_destroy) ||
253         !ENGINE_set_init_function(e, surewarehk_init) ||
254         !ENGINE_set_finish_function(e, surewarehk_finish) ||
255         !ENGINE_set_ctrl_function(e, surewarehk_ctrl) ||
256         !ENGINE_set_load_privkey_function(e, surewarehk_load_privkey) ||
257         !ENGINE_set_load_pubkey_function(e, surewarehk_load_pubkey))
258         return 0;
259
260 #  ifndef OPENSSL_NO_RSA
261     /*
262      * We know that the "PKCS1_SSLeay()" functions hook properly to the
263      * cswift-specific mod_exp and mod_exp_crt so we use those functions. NB:
264      * We don't use ENGINE_openssl() or anything "more generic" because
265      * something like the RSAref code may not hook properly, and if you own
266      * one of these cards then you have the right to do RSA operations on it
267      * anyway!
268      */
269     meth1 = RSA_PKCS1_SSLeay();
270     if (meth1) {
271         surewarehk_rsa.rsa_pub_enc = meth1->rsa_pub_enc;
272         surewarehk_rsa.rsa_pub_dec = meth1->rsa_pub_dec;
273     }
274 #  endif
275
276 #  ifndef OPENSSL_NO_DSA
277     /*
278      * Use the DSA_OpenSSL() method and just hook the mod_exp-ish bits.
279      */
280     meth2 = DSA_OpenSSL();
281     if (meth2) {
282         surewarehk_dsa.dsa_do_verify = meth2->dsa_do_verify;
283     }
284 #  endif
285
286 #  ifndef OPENSSL_NO_DH
287     /* Much the same for Diffie-Hellman */
288     meth3 = DH_OpenSSL();
289     if (meth3) {
290         surewarehk_dh.generate_key = meth3->generate_key;
291         surewarehk_dh.compute_key = meth3->compute_key;
292     }
293 #  endif
294
295     /* Ensure the sureware error handling is set up */
296     ERR_load_SUREWARE_strings();
297     return 1;
298 }
299
300 #  ifndef OPENSSL_NO_DYNAMIC_ENGINE
301 static int bind_helper(ENGINE *e, const char *id)
302 {
303     if (id && (strcmp(id, engine_sureware_id) != 0))
304         return 0;
305     if (!bind_sureware(e))
306         return 0;
307     return 1;
308 }
309
310 IMPLEMENT_DYNAMIC_CHECK_FN()
311     IMPLEMENT_DYNAMIC_BIND_FN(bind_helper)
312 #  else
313 static ENGINE *engine_sureware(void)
314 {
315     ENGINE *ret = ENGINE_new();
316     if (!ret)
317         return NULL;
318     if (!bind_sureware(ret)) {
319         ENGINE_free(ret);
320         return NULL;
321     }
322     return ret;
323 }
324
325 void ENGINE_load_sureware(void)
326 {
327     /* Copied from eng_[openssl|dyn].c */
328     ENGINE *toadd = engine_sureware();
329     if (!toadd)
330         return;
331     ENGINE_add(toadd);
332     ENGINE_free(toadd);
333     ERR_clear_error();
334 }
335 #  endif
336
337 /*
338  * This is a process-global DSO handle used for loading and unloading the
339  * SureWareHook library. NB: This is only set (or unset) during an init() or
340  * finish() call (reference counts permitting) and they're operating with
341  * global locks, so this should be thread-safe implicitly.
342  */
343 static DSO *surewarehk_dso = NULL;
344 #  ifndef OPENSSL_NO_RSA
345 /* Index for KM handle.  Not really used yet. */
346 static int rsaHndidx = -1;
347 #  endif
348 #  ifndef OPENSSL_NO_DSA
349 /* Index for KM handle.  Not really used yet. */
350 static int dsaHndidx = -1;
351 #  endif
352
353 /*
354  * These are the function pointers that are (un)set when the library has
355  * successfully (un)loaded.
356  */
357 static SureWareHook_Init_t *p_surewarehk_Init = NULL;
358 static SureWareHook_Finish_t *p_surewarehk_Finish = NULL;
359 static SureWareHook_Rand_Bytes_t *p_surewarehk_Rand_Bytes = NULL;
360 static SureWareHook_Rand_Seed_t *p_surewarehk_Rand_Seed = NULL;
361 static SureWareHook_Load_Privkey_t *p_surewarehk_Load_Privkey = NULL;
362 static SureWareHook_Info_Pubkey_t *p_surewarehk_Info_Pubkey = NULL;
363 static SureWareHook_Load_Rsa_Pubkey_t *p_surewarehk_Load_Rsa_Pubkey = NULL;
364 static SureWareHook_Load_Dsa_Pubkey_t *p_surewarehk_Load_Dsa_Pubkey = NULL;
365 static SureWareHook_Free_t *p_surewarehk_Free = NULL;
366 static SureWareHook_Rsa_Priv_Dec_t *p_surewarehk_Rsa_Priv_Dec = NULL;
367 static SureWareHook_Rsa_Sign_t *p_surewarehk_Rsa_Sign = NULL;
368 static SureWareHook_Dsa_Sign_t *p_surewarehk_Dsa_Sign = NULL;
369 static SureWareHook_Mod_Exp_t *p_surewarehk_Mod_Exp = NULL;
370
371 /* Used in the DSO operations. */
372 static const char *surewarehk_LIBNAME = "SureWareHook";
373 static const char *n_surewarehk_Init = "SureWareHook_Init";
374 static const char *n_surewarehk_Finish = "SureWareHook_Finish";
375 static const char *n_surewarehk_Rand_Bytes = "SureWareHook_Rand_Bytes";
376 static const char *n_surewarehk_Rand_Seed = "SureWareHook_Rand_Seed";
377 static const char *n_surewarehk_Load_Privkey = "SureWareHook_Load_Privkey";
378 static const char *n_surewarehk_Info_Pubkey = "SureWareHook_Info_Pubkey";
379 static const char *n_surewarehk_Load_Rsa_Pubkey =
380     "SureWareHook_Load_Rsa_Pubkey";
381 static const char *n_surewarehk_Load_Dsa_Pubkey =
382     "SureWareHook_Load_Dsa_Pubkey";
383 static const char *n_surewarehk_Free = "SureWareHook_Free";
384 static const char *n_surewarehk_Rsa_Priv_Dec = "SureWareHook_Rsa_Priv_Dec";
385 static const char *n_surewarehk_Rsa_Sign = "SureWareHook_Rsa_Sign";
386 static const char *n_surewarehk_Dsa_Sign = "SureWareHook_Dsa_Sign";
387 static const char *n_surewarehk_Mod_Exp = "SureWareHook_Mod_Exp";
388 static BIO *logstream = NULL;
389
390 /*
391  * SureWareHook library functions and mechanics - these are used by the
392  * higher-level functions further down. NB: As and where there's no error
393  * checking, take a look lower down where these functions are called, the
394  * checking and error handling is probably down there.
395  */
396 static int threadsafe = 1;
397 static int surewarehk_ctrl(ENGINE *e, int cmd, long i, void *p,
398                            void (*f) (void))
399 {
400     int to_return = 1;
401
402     switch (cmd) {
403     case ENGINE_CTRL_SET_LOGSTREAM:
404         {
405             BIO *bio = (BIO *)p;
406             CRYPTO_w_lock(CRYPTO_LOCK_ENGINE);
407             BIO_free(logstream);
408             logstream = NULL;
409             if (CRYPTO_add(&bio->references, 1, CRYPTO_LOCK_BIO) > 1)
410                 logstream = bio;
411             else
412                 SUREWAREerr(SUREWARE_F_SUREWAREHK_CTRL,
413                             SUREWARE_R_BIO_WAS_FREED);
414         }
415         CRYPTO_w_unlock(CRYPTO_LOCK_ENGINE);
416         break;
417         /*
418          * This will prevent the initialisation function from "installing"
419          * the mutex-handling callbacks, even if they are available from
420          * within the library (or were provided to the library from the
421          * calling application). This is to remove any baggage for
422          * applications not using multithreading.
423          */
424     case ENGINE_CTRL_CHIL_NO_LOCKING:
425         CRYPTO_w_lock(CRYPTO_LOCK_ENGINE);
426         threadsafe = 0;
427         CRYPTO_w_unlock(CRYPTO_LOCK_ENGINE);
428         break;
429
430         /* The command isn't understood by this engine */
431     default:
432         SUREWAREerr(SUREWARE_F_SUREWAREHK_CTRL,
433                     ENGINE_R_CTRL_COMMAND_NOT_IMPLEMENTED);
434         to_return = 0;
435         break;
436     }
437
438     return to_return;
439 }
440
441 /* Destructor (complements the "ENGINE_surewarehk()" constructor) */
442 static int surewarehk_destroy(ENGINE *e)
443 {
444     ERR_unload_SUREWARE_strings();
445     return 1;
446 }
447
448 /* (de)initialisation functions. */
449 static int surewarehk_init(ENGINE *e)
450 {
451     char msg[64] = "ENGINE_init";
452     SureWareHook_Init_t *p1 = NULL;
453     SureWareHook_Finish_t *p2 = NULL;
454     SureWareHook_Rand_Bytes_t *p3 = NULL;
455     SureWareHook_Rand_Seed_t *p4 = NULL;
456     SureWareHook_Load_Privkey_t *p5 = NULL;
457     SureWareHook_Load_Rsa_Pubkey_t *p6 = NULL;
458     SureWareHook_Free_t *p7 = NULL;
459     SureWareHook_Rsa_Priv_Dec_t *p8 = NULL;
460     SureWareHook_Rsa_Sign_t *p9 = NULL;
461     SureWareHook_Dsa_Sign_t *p12 = NULL;
462     SureWareHook_Info_Pubkey_t *p13 = NULL;
463     SureWareHook_Load_Dsa_Pubkey_t *p14 = NULL;
464     SureWareHook_Mod_Exp_t *p15 = NULL;
465
466     if (surewarehk_dso != NULL) {
467         SUREWAREerr(SUREWARE_F_SUREWAREHK_INIT, ENGINE_R_ALREADY_LOADED);
468         goto err;
469     }
470     /* Attempt to load libsurewarehk.so/surewarehk.dll/whatever. */
471     surewarehk_dso = DSO_load(NULL, surewarehk_LIBNAME, NULL, 0);
472     if (surewarehk_dso == NULL) {
473         SUREWAREerr(SUREWARE_F_SUREWAREHK_INIT, ENGINE_R_DSO_FAILURE);
474         goto err;
475     }
476     if (!
477         (p1 =
478          (SureWareHook_Init_t *) DSO_bind_func(surewarehk_dso,
479                                                n_surewarehk_Init))
480 || !(p2 =
481      (SureWareHook_Finish_t *) DSO_bind_func(surewarehk_dso,
482                                              n_surewarehk_Finish))
483 || !(p3 =
484      (SureWareHook_Rand_Bytes_t *) DSO_bind_func(surewarehk_dso,
485                                                  n_surewarehk_Rand_Bytes))
486 || !(p4 =
487      (SureWareHook_Rand_Seed_t *) DSO_bind_func(surewarehk_dso,
488                                                 n_surewarehk_Rand_Seed))
489 || !(p5 =
490      (SureWareHook_Load_Privkey_t *) DSO_bind_func(surewarehk_dso,
491                                                    n_surewarehk_Load_Privkey))
492 || !(p6 =
493      (SureWareHook_Load_Rsa_Pubkey_t *) DSO_bind_func(surewarehk_dso,
494                                                       n_surewarehk_Load_Rsa_Pubkey))
495 || !(p7 =
496      (SureWareHook_Free_t *) DSO_bind_func(surewarehk_dso, n_surewarehk_Free))
497 || !(p8 =
498      (SureWareHook_Rsa_Priv_Dec_t *) DSO_bind_func(surewarehk_dso,
499                                                    n_surewarehk_Rsa_Priv_Dec))
500 || !(p9 =
501      (SureWareHook_Rsa_Sign_t *) DSO_bind_func(surewarehk_dso,
502                                                n_surewarehk_Rsa_Sign))
503 || !(p12 =
504      (SureWareHook_Dsa_Sign_t *) DSO_bind_func(surewarehk_dso,
505                                                n_surewarehk_Dsa_Sign))
506 || !(p13 =
507      (SureWareHook_Info_Pubkey_t *) DSO_bind_func(surewarehk_dso,
508                                                   n_surewarehk_Info_Pubkey))
509 || !(p14 =
510      (SureWareHook_Load_Dsa_Pubkey_t *) DSO_bind_func(surewarehk_dso,
511                                                       n_surewarehk_Load_Dsa_Pubkey))
512 || !(p15 =
513      (SureWareHook_Mod_Exp_t *) DSO_bind_func(surewarehk_dso,
514                                               n_surewarehk_Mod_Exp))) {
515         SUREWAREerr(SUREWARE_F_SUREWAREHK_INIT, ENGINE_R_DSO_FAILURE);
516         goto err;
517     }
518     /* Copy the pointers */
519     p_surewarehk_Init = p1;
520     p_surewarehk_Finish = p2;
521     p_surewarehk_Rand_Bytes = p3;
522     p_surewarehk_Rand_Seed = p4;
523     p_surewarehk_Load_Privkey = p5;
524     p_surewarehk_Load_Rsa_Pubkey = p6;
525     p_surewarehk_Free = p7;
526     p_surewarehk_Rsa_Priv_Dec = p8;
527     p_surewarehk_Rsa_Sign = p9;
528     p_surewarehk_Dsa_Sign = p12;
529     p_surewarehk_Info_Pubkey = p13;
530     p_surewarehk_Load_Dsa_Pubkey = p14;
531     p_surewarehk_Mod_Exp = p15;
532     /* Contact the hardware and initialises it. */
533     if (p_surewarehk_Init(msg, threadsafe) == SUREWAREHOOK_ERROR_UNIT_FAILURE) {
534         SUREWAREerr(SUREWARE_F_SUREWAREHK_INIT, SUREWARE_R_UNIT_FAILURE);
535         goto err;
536     }
537     if (p_surewarehk_Init(msg, threadsafe) == SUREWAREHOOK_ERROR_UNIT_FAILURE) {
538         SUREWAREerr(SUREWARE_F_SUREWAREHK_INIT, SUREWARE_R_UNIT_FAILURE);
539         goto err;
540     }
541     /*
542      * try to load the default private key, if failed does not return a
543      * failure but wait for an explicit ENGINE_load_privakey
544      */
545     surewarehk_load_privkey(e, NULL, NULL, NULL);
546
547     /* Everything's fine. */
548 #  ifndef OPENSSL_NO_RSA
549     if (rsaHndidx == -1)
550         rsaHndidx = RSA_get_ex_new_index(0,
551                                          "SureWareHook RSA key handle",
552                                          NULL, NULL, surewarehk_ex_free);
553 #  endif
554 #  ifndef OPENSSL_NO_DSA
555     if (dsaHndidx == -1)
556         dsaHndidx = DSA_get_ex_new_index(0,
557                                          "SureWareHook DSA key handle",
558                                          NULL, NULL, surewarehk_ex_free);
559 #  endif
560
561     return 1;
562  err:
563     if (surewarehk_dso)
564         DSO_free(surewarehk_dso);
565     surewarehk_dso = NULL;
566     p_surewarehk_Init = NULL;
567     p_surewarehk_Finish = NULL;
568     p_surewarehk_Rand_Bytes = NULL;
569     p_surewarehk_Rand_Seed = NULL;
570     p_surewarehk_Load_Privkey = NULL;
571     p_surewarehk_Load_Rsa_Pubkey = NULL;
572     p_surewarehk_Free = NULL;
573     p_surewarehk_Rsa_Priv_Dec = NULL;
574     p_surewarehk_Rsa_Sign = NULL;
575     p_surewarehk_Dsa_Sign = NULL;
576     p_surewarehk_Info_Pubkey = NULL;
577     p_surewarehk_Load_Dsa_Pubkey = NULL;
578     p_surewarehk_Mod_Exp = NULL;
579     return 0;
580 }
581
582 static int surewarehk_finish(ENGINE *e)
583 {
584     int to_return = 1;
585     if (surewarehk_dso == NULL) {
586         SUREWAREerr(SUREWARE_F_SUREWAREHK_FINISH, ENGINE_R_NOT_LOADED);
587         to_return = 0;
588         goto err;
589     }
590     p_surewarehk_Finish();
591     if (!DSO_free(surewarehk_dso)) {
592         SUREWAREerr(SUREWARE_F_SUREWAREHK_FINISH, ENGINE_R_DSO_FAILURE);
593         to_return = 0;
594         goto err;
595     }
596  err:
597     BIO_free(logstream);
598     surewarehk_dso = NULL;
599     p_surewarehk_Init = NULL;
600     p_surewarehk_Finish = NULL;
601     p_surewarehk_Rand_Bytes = NULL;
602     p_surewarehk_Rand_Seed = NULL;
603     p_surewarehk_Load_Privkey = NULL;
604     p_surewarehk_Load_Rsa_Pubkey = NULL;
605     p_surewarehk_Free = NULL;
606     p_surewarehk_Rsa_Priv_Dec = NULL;
607     p_surewarehk_Rsa_Sign = NULL;
608     p_surewarehk_Dsa_Sign = NULL;
609     p_surewarehk_Info_Pubkey = NULL;
610     p_surewarehk_Load_Dsa_Pubkey = NULL;
611     p_surewarehk_Mod_Exp = NULL;
612     return to_return;
613 }
614
615 static void surewarehk_error_handling(char *const msg, int func, int ret)
616 {
617     switch (ret) {
618     case SUREWAREHOOK_ERROR_UNIT_FAILURE:
619         ENGINEerr(func, SUREWARE_R_UNIT_FAILURE);
620         break;
621     case SUREWAREHOOK_ERROR_FALLBACK:
622         ENGINEerr(func, SUREWARE_R_REQUEST_FALLBACK);
623         break;
624     case SUREWAREHOOK_ERROR_DATA_SIZE:
625         ENGINEerr(func, SUREWARE_R_SIZE_TOO_LARGE_OR_TOO_SMALL);
626         break;
627     case SUREWAREHOOK_ERROR_INVALID_PAD:
628         ENGINEerr(func, SUREWARE_R_PADDING_CHECK_FAILED);
629         break;
630     default:
631         ENGINEerr(func, SUREWARE_R_REQUEST_FAILED);
632         break;
633     case 1:                    /* nothing */
634         msg[0] = '\0';
635     }
636     if (*msg) {
637         ERR_add_error_data(1, msg);
638         if (logstream) {
639             CRYPTO_w_lock(CRYPTO_LOCK_BIO);
640             BIO_write(logstream, msg, strlen(msg));
641             CRYPTO_w_unlock(CRYPTO_LOCK_BIO);
642         }
643     }
644 }
645
646 static int surewarehk_rand_bytes(unsigned char *buf, int num)
647 {
648     int ret = 0;
649     char msg[64] = "ENGINE_rand_bytes";
650     if (!p_surewarehk_Rand_Bytes) {
651         SUREWAREerr(SUREWARE_F_SUREWAREHK_RAND_BYTES,
652                     ENGINE_R_NOT_INITIALISED);
653     } else {
654         ret = p_surewarehk_Rand_Bytes(msg, buf, num);
655         surewarehk_error_handling(msg, SUREWARE_F_SUREWAREHK_RAND_BYTES, ret);
656     }
657     return ret == 1 ? 1 : 0;
658 }
659
660 static int surewarehk_rand_seed(const void *buf, int num)
661 {
662     int ret = 0;
663     char msg[64] = "ENGINE_rand_seed";
664     if (!p_surewarehk_Rand_Seed) {
665         SUREWAREerr(SUREWARE_F_SUREWAREHK_RAND_SEED,
666                     ENGINE_R_NOT_INITIALISED);
667         return 0;
668     } else {
669         ret = p_surewarehk_Rand_Seed(msg, buf, num);
670         surewarehk_error_handling(msg, SUREWARE_F_SUREWAREHK_RAND_SEED, ret);
671         if (ret == 1)
672             return 1;
673         else
674             return 0;
675     }
676 }
677
678 static int surewarehk_rand_add(const void *buf, int num, double entropy)
679 {
680     return surewarehk_rand_seed(buf, num);
681 }
682
683 static EVP_PKEY *sureware_load_public(ENGINE *e, const char *key_id,
684                                       char *hptr, unsigned long el,
685                                       char keytype)
686 {
687     EVP_PKEY *res = NULL;
688 #  ifndef OPENSSL_NO_RSA
689     RSA *rsatmp = NULL;
690 #  endif
691 #  ifndef OPENSSL_NO_DSA
692     DSA *dsatmp = NULL;
693 #  endif
694     char msg[64] = "sureware_load_public";
695     int ret = 0;
696     if (!p_surewarehk_Load_Rsa_Pubkey || !p_surewarehk_Load_Dsa_Pubkey) {
697         SUREWAREerr(SUREWARE_F_SUREWARE_LOAD_PUBLIC,
698                     ENGINE_R_NOT_INITIALISED);
699         goto err;
700     }
701     switch (keytype) {
702 #  ifndef OPENSSL_NO_RSA
703     case 1:
704          /*RSA*/
705             /* set private external reference */
706             rsatmp = RSA_new_method(e);
707         RSA_set_ex_data(rsatmp, rsaHndidx, hptr);
708         rsatmp->flags |= RSA_FLAG_EXT_PKEY;
709
710         /* set public big nums */
711         rsatmp->e = BN_new();
712         rsatmp->n = BN_new();
713         if (!rsatmp->e || !rsatmp->n)
714             goto err;
715         bn_expand2(rsatmp->e, el / sizeof(BN_ULONG));
716         bn_expand2(rsatmp->n, el / sizeof(BN_ULONG));
717         if (rsatmp->e->dmax != (int)(el / sizeof(BN_ULONG)) ||
718             rsatmp->n->dmax != (int)(el / sizeof(BN_ULONG)))
719             goto err;
720         ret = p_surewarehk_Load_Rsa_Pubkey(msg, key_id, el,
721                                            (unsigned long *)rsatmp->n->d,
722                                            (unsigned long *)rsatmp->e->d);
723         surewarehk_error_handling(msg, SUREWARE_F_SUREWARE_LOAD_PUBLIC, ret);
724         if (ret != 1) {
725             SUREWAREerr(SUREWARE_F_SUREWARE_LOAD_PUBLIC,
726                         ENGINE_R_FAILED_LOADING_PUBLIC_KEY);
727             goto err;
728         }
729         /* normalise pub e and pub n */
730         rsatmp->e->top = el / sizeof(BN_ULONG);
731         bn_fix_top(rsatmp->e);
732         rsatmp->n->top = el / sizeof(BN_ULONG);
733         bn_fix_top(rsatmp->n);
734         /* create an EVP object: engine + rsa key */
735         res = EVP_PKEY_new();
736         EVP_PKEY_assign_RSA(res, rsatmp);
737         break;
738 #  endif
739
740 #  ifndef OPENSSL_NO_DSA
741     case 2:
742          /*DSA*/
743             /* set private/public external reference */
744             dsatmp = DSA_new_method(e);
745         DSA_set_ex_data(dsatmp, dsaHndidx, hptr);
746         /*
747          * dsatmp->flags |= DSA_FLAG_EXT_PKEY;
748          */
749
750         /* set public key */
751         dsatmp->pub_key = BN_new();
752         dsatmp->p = BN_new();
753         dsatmp->q = BN_new();
754         dsatmp->g = BN_new();
755         if (!dsatmp->pub_key || !dsatmp->p || !dsatmp->q || !dsatmp->g)
756             goto err;
757         bn_expand2(dsatmp->pub_key, el / sizeof(BN_ULONG));
758         bn_expand2(dsatmp->p, el / sizeof(BN_ULONG));
759         bn_expand2(dsatmp->q, 20 / sizeof(BN_ULONG));
760         bn_expand2(dsatmp->g, el / sizeof(BN_ULONG));
761         if (dsatmp->pub_key->dmax != (int)(el / sizeof(BN_ULONG))
762             || dsatmp->p->dmax != (int)(el / sizeof(BN_ULONG))
763             || dsatmp->q->dmax != 20 / sizeof(BN_ULONG)
764             || dsatmp->g->dmax != (int)(el / sizeof(BN_ULONG)))
765             goto err;
766
767         ret = p_surewarehk_Load_Dsa_Pubkey(msg, key_id, el,
768                                            (unsigned long *)dsatmp->
769                                            pub_key->d,
770                                            (unsigned long *)dsatmp->p->d,
771                                            (unsigned long *)dsatmp->q->d,
772                                            (unsigned long *)dsatmp->g->d);
773         surewarehk_error_handling(msg, SUREWARE_F_SUREWARE_LOAD_PUBLIC, ret);
774         if (ret != 1) {
775             SUREWAREerr(SUREWARE_F_SUREWARE_LOAD_PUBLIC,
776                         ENGINE_R_FAILED_LOADING_PUBLIC_KEY);
777             goto err;
778         }
779         /* set parameters */
780         /* normalise pubkey and parameters in case of */
781         dsatmp->pub_key->top = el / sizeof(BN_ULONG);
782         bn_fix_top(dsatmp->pub_key);
783         dsatmp->p->top = el / sizeof(BN_ULONG);
784         bn_fix_top(dsatmp->p);
785         dsatmp->q->top = 20 / sizeof(BN_ULONG);
786         bn_fix_top(dsatmp->q);
787         dsatmp->g->top = el / sizeof(BN_ULONG);
788         bn_fix_top(dsatmp->g);
789
790         /* create an EVP object: engine + rsa key */
791         res = EVP_PKEY_new();
792         EVP_PKEY_assign_DSA(res, dsatmp);
793         break;
794 #  endif
795
796     default:
797         SUREWAREerr(SUREWARE_F_SUREWARE_LOAD_PUBLIC,
798                     ENGINE_R_FAILED_LOADING_PRIVATE_KEY);
799         goto err;
800     }
801     return res;
802  err:
803 #  ifndef OPENSSL_NO_RSA
804     RSA_free(rsatmp);
805 #  endif
806 #  ifndef OPENSSL_NO_DSA
807     DSA_free(dsatmp);
808 #  endif
809     return NULL;
810 }
811
812 static EVP_PKEY *surewarehk_load_privkey(ENGINE *e, const char *key_id,
813                                          UI_METHOD *ui_method,
814                                          void *callback_data)
815 {
816     EVP_PKEY *res = NULL;
817     int ret = 0;
818     unsigned long el = 0;
819     char *hptr = NULL;
820     char keytype = 0;
821     char msg[64] = "ENGINE_load_privkey";
822
823     if (!p_surewarehk_Load_Privkey) {
824         SUREWAREerr(SUREWARE_F_SUREWAREHK_LOAD_PRIVKEY,
825                     ENGINE_R_NOT_INITIALISED);
826     } else {
827         ret = p_surewarehk_Load_Privkey(msg, key_id, &hptr, &el, &keytype);
828         if (ret != 1) {
829             SUREWAREerr(SUREWARE_F_SUREWAREHK_LOAD_PRIVKEY,
830                         ENGINE_R_FAILED_LOADING_PRIVATE_KEY);
831             ERR_add_error_data(1, msg);
832         } else
833             res = sureware_load_public(e, key_id, hptr, el, keytype);
834     }
835     return res;
836 }
837
838 static EVP_PKEY *surewarehk_load_pubkey(ENGINE *e, const char *key_id,
839                                         UI_METHOD *ui_method,
840                                         void *callback_data)
841 {
842     EVP_PKEY *res = NULL;
843     int ret = 0;
844     unsigned long el = 0;
845     char *hptr = NULL;
846     char keytype = 0;
847     char msg[64] = "ENGINE_load_pubkey";
848
849     if (!p_surewarehk_Info_Pubkey) {
850         SUREWAREerr(SUREWARE_F_SUREWAREHK_LOAD_PUBKEY,
851                     ENGINE_R_NOT_INITIALISED);
852     } else {
853         /* call once to identify if DSA or RSA */
854         ret = p_surewarehk_Info_Pubkey(msg, key_id, &el, &keytype);
855         if (ret != 1) {
856             SUREWAREerr(SUREWARE_F_SUREWAREHK_LOAD_PUBKEY,
857                         ENGINE_R_FAILED_LOADING_PUBLIC_KEY);
858             ERR_add_error_data(1, msg);
859         } else
860             res = sureware_load_public(e, key_id, hptr, el, keytype);
861     }
862     return res;
863 }
864
865 /*
866  * This cleans up an RSA/DSA KM key(do not destroy the key into the hardware)
867  * , called when ex_data is freed
868  */
869 static void surewarehk_ex_free(void *obj, void *item, CRYPTO_EX_DATA *ad,
870                                int idx, long argl, void *argp)
871 {
872     if (!p_surewarehk_Free) {
873         SUREWAREerr(SUREWARE_F_SUREWAREHK_EX_FREE, ENGINE_R_NOT_INITIALISED);
874     } else
875         p_surewarehk_Free((char *)item, 0);
876 }
877
878 /*
879  * return number of decrypted bytes
880  */
881 #  ifndef OPENSSL_NO_RSA
882 static int surewarehk_rsa_priv_dec(int flen, const unsigned char *from,
883                                    unsigned char *to, RSA *rsa, int padding)
884 {
885     int ret = 0, tlen;
886     char *buf = NULL, *hptr = NULL;
887     char msg[64] = "ENGINE_rsa_priv_dec";
888     if (!p_surewarehk_Rsa_Priv_Dec) {
889         SUREWAREerr(SUREWARE_F_SUREWAREHK_RSA_PRIV_DEC,
890                     ENGINE_R_NOT_INITIALISED);
891     }
892     /* extract ref to private key */
893     else if (!(hptr = RSA_get_ex_data(rsa, rsaHndidx))) {
894         SUREWAREerr(SUREWARE_F_SUREWAREHK_RSA_PRIV_DEC,
895                     SUREWARE_R_MISSING_KEY_COMPONENTS);
896         goto err;
897     }
898     /* analyse what padding we can do into the hardware */
899     if (padding == RSA_PKCS1_PADDING) {
900         /* do it one shot */
901         ret =
902             p_surewarehk_Rsa_Priv_Dec(msg, flen, (unsigned char *)from, &tlen,
903                                       to, hptr, SUREWARE_PKCS1_PAD);
904         surewarehk_error_handling(msg, SUREWARE_F_SUREWAREHK_RSA_PRIV_DEC,
905                                   ret);
906         if (ret != 1)
907             goto err;
908         ret = tlen;
909     } else {                    /* do with no padding into hardware */
910
911         ret =
912             p_surewarehk_Rsa_Priv_Dec(msg, flen, (unsigned char *)from, &tlen,
913                                       to, hptr, SUREWARE_NO_PAD);
914         surewarehk_error_handling(msg, SUREWARE_F_SUREWAREHK_RSA_PRIV_DEC,
915                                   ret);
916         if (ret != 1)
917             goto err;
918         /* intermediate buffer for padding */
919         if ((buf = OPENSSL_malloc(tlen)) == NULL) {
920             SUREWAREerr(SUREWARE_F_SUREWAREHK_RSA_PRIV_DEC,
921                         ERR_R_MALLOC_FAILURE);
922             goto err;
923         }
924         memcpy(buf, to, tlen);  /* transfert to into buf */
925         switch (padding) {      /* check padding in software */
926         case RSA_PKCS1_OAEP_PADDING:
927             ret =
928                 RSA_padding_check_PKCS1_OAEP(to, tlen, (unsigned char *)buf,
929                                              tlen, tlen, NULL, 0);
930             break;
931         case RSA_SSLV23_PADDING:
932             ret =
933                 RSA_padding_check_SSLv23(to, tlen, (unsigned char *)buf, flen,
934                                          tlen);
935             break;
936         case RSA_NO_PADDING:
937             ret =
938                 RSA_padding_check_none(to, tlen, (unsigned char *)buf, flen,
939                                        tlen);
940             break;
941         default:
942             SUREWAREerr(SUREWARE_F_SUREWAREHK_RSA_PRIV_DEC,
943                         SUREWARE_R_UNKNOWN_PADDING_TYPE);
944             goto err;
945         }
946         if (ret < 0)
947             SUREWAREerr(SUREWARE_F_SUREWAREHK_RSA_PRIV_DEC,
948                         SUREWARE_R_PADDING_CHECK_FAILED);
949     }
950  err:
951     if (buf) {
952         OPENSSL_cleanse(buf, tlen);
953         OPENSSL_free(buf);
954     }
955     return ret;
956 }
957
958 /*
959  * Does what OpenSSL rsa_priv_enc does.
960  */
961 static int surewarehk_rsa_sign(int flen, const unsigned char *from,
962                                unsigned char *to, RSA *rsa, int padding)
963 {
964     int ret = 0, tlen;
965     char *hptr = NULL;
966     char msg[64] = "ENGINE_rsa_sign";
967     if (!p_surewarehk_Rsa_Sign) {
968         SUREWAREerr(SUREWARE_F_SUREWAREHK_RSA_SIGN, ENGINE_R_NOT_INITIALISED);
969     }
970     /* extract ref to private key */
971     else if (!(hptr = RSA_get_ex_data(rsa, rsaHndidx))) {
972         SUREWAREerr(SUREWARE_F_SUREWAREHK_RSA_SIGN,
973                     SUREWARE_R_MISSING_KEY_COMPONENTS);
974     } else {
975         switch (padding) {
976         case RSA_PKCS1_PADDING: /* do it in one shot */
977             ret =
978                 p_surewarehk_Rsa_Sign(msg, flen, (unsigned char *)from, &tlen,
979                                       to, hptr, SUREWARE_PKCS1_PAD);
980             surewarehk_error_handling(msg, SUREWARE_F_SUREWAREHK_RSA_SIGN,
981                                       ret);
982             break;
983         case RSA_NO_PADDING:
984         default:
985             SUREWAREerr(SUREWARE_F_SUREWAREHK_RSA_SIGN,
986                         SUREWARE_R_UNKNOWN_PADDING_TYPE);
987         }
988     }
989     return ret == 1 ? tlen : ret;
990 }
991
992 #  endif
993
994 #  ifndef OPENSSL_NO_DSA
995 /* DSA sign and verify */
996 static DSA_SIG *surewarehk_dsa_do_sign(const unsigned char *from, int flen,
997                                        DSA *dsa)
998 {
999     int ret = 0;
1000     char *hptr = NULL;
1001     DSA_SIG *psign = NULL;
1002     char msg[64] = "ENGINE_dsa_do_sign";
1003     if (!p_surewarehk_Dsa_Sign) {
1004         SUREWAREerr(SUREWARE_F_SUREWAREHK_DSA_DO_SIGN,
1005                     ENGINE_R_NOT_INITIALISED);
1006         goto err;
1007     }
1008     /* extract ref to private key */
1009     else if (!(hptr = DSA_get_ex_data(dsa, dsaHndidx))) {
1010         SUREWAREerr(SUREWARE_F_SUREWAREHK_DSA_DO_SIGN,
1011                     SUREWARE_R_MISSING_KEY_COMPONENTS);
1012         goto err;
1013     } else {
1014         if ((psign = DSA_SIG_new()) == NULL) {
1015             SUREWAREerr(SUREWARE_F_SUREWAREHK_DSA_DO_SIGN,
1016                         ERR_R_MALLOC_FAILURE);
1017             goto err;
1018         }
1019         psign->r = BN_new();
1020         psign->s = BN_new();
1021         if (!psign->r || !psign->s)
1022             goto err;
1023         bn_expand2(psign->r, 20 / sizeof(BN_ULONG));
1024         bn_expand2(psign->s, 20 / sizeof(BN_ULONG));
1025         if (psign->r->dmax != 20 / sizeof(BN_ULONG) ||
1026             psign->s->dmax != 20 / sizeof(BN_ULONG))
1027             goto err;
1028         ret = p_surewarehk_Dsa_Sign(msg, flen, from,
1029                                     (unsigned long *)psign->r->d,
1030                                     (unsigned long *)psign->s->d, hptr);
1031         surewarehk_error_handling(msg, SUREWARE_F_SUREWAREHK_DSA_DO_SIGN,
1032                                   ret);
1033     }
1034     psign->r->top = 20 / sizeof(BN_ULONG);
1035     bn_fix_top(psign->r);
1036     psign->s->top = 20 / sizeof(BN_ULONG);
1037     bn_fix_top(psign->s);
1038
1039  err:
1040     if (psign) {
1041         DSA_SIG_free(psign);
1042         psign = NULL;
1043     }
1044     return psign;
1045 }
1046 #  endif
1047
1048 static int surewarehk_modexp(BIGNUM *r, const BIGNUM *a, const BIGNUM *p,
1049                              const BIGNUM *m, BN_CTX *ctx)
1050 {
1051     int ret = 0;
1052     char msg[64] = "ENGINE_modexp";
1053     if (!p_surewarehk_Mod_Exp) {
1054         SUREWAREerr(SUREWARE_F_SUREWAREHK_MODEXP, ENGINE_R_NOT_INITIALISED);
1055     } else if (r) {
1056         bn_expand2(r, m->top);
1057         if (r->dmax == m->top) {
1058             /* do it */
1059             ret = p_surewarehk_Mod_Exp(msg,
1060                                        m->top * sizeof(BN_ULONG),
1061                                        (unsigned long *)m->d,
1062                                        p->top * sizeof(BN_ULONG),
1063                                        (unsigned long *)p->d,
1064                                        a->top * sizeof(BN_ULONG),
1065                                        (unsigned long *)a->d,
1066                                        (unsigned long *)r->d);
1067             surewarehk_error_handling(msg, SUREWARE_F_SUREWAREHK_MODEXP, ret);
1068             if (ret == 1) {
1069                 /* normalise result */
1070                 r->top = m->top;
1071                 bn_fix_top(r);
1072             }
1073         }
1074     }
1075     return ret;
1076 }
1077 # endif                         /* !OPENSSL_NO_HW_SUREWARE */
1078 #endif                          /* !OPENSSL_NO_HW */