/*- * Written by Corinne Dive-Reclus(cdive@baltimore.com) * * Copyright@2001 Baltimore Technologies Ltd. * * THIS FILE IS PROVIDED BY BALTIMORE TECHNOLOGIES ``AS IS'' AND * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL BALTIMORE TECHNOLOGIES BE LIABLE * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF * SUCH DAMAGE. */ #ifdef WIN32 #define SW_EXPORT __declspec ( dllexport ) #else #define SW_EXPORT #endif /* * List of exposed SureWare errors */ #define SUREWAREHOOK_ERROR_FAILED -1 #define SUREWAREHOOK_ERROR_FALLBACK -2 #define SUREWAREHOOK_ERROR_UNIT_FAILURE -3 #define SUREWAREHOOK_ERROR_DATA_SIZE -4 #define SUREWAREHOOK_ERROR_INVALID_PAD -5 /*- * -----------------WARNING----------------------------------- * In all the following functions: * msg is a string with at least 24 bytes free. * A 24 bytes string will be concatenated to the existing content of msg. */ /*- * SureWare Initialisation function * in param threadsafe, if !=0, thread safe enabled * return SureWareHOOK_ERROR_UNIT_FAILURE if failure, 1 if success */ typedef int SureWareHook_Init_t(char*const msg,int threadsafe); extern SW_EXPORT SureWareHook_Init_t SureWareHook_Init; /*- * SureWare Finish function */ typedef void SureWareHook_Finish_t(void); extern SW_EXPORT SureWareHook_Finish_t SureWareHook_Finish; /*- * PRE_CONDITION: * DO NOT CALL ANY OF THE FOLLOWING FUNCTIONS IN CASE OF INIT FAILURE */ /*- * SureWare RAND Bytes function * In case of failure, the content of buf is unpredictable. * return 1 if success * SureWareHOOK_ERROR_FALLBACK if function not available in hardware * SureWareHOOK_ERROR_FAILED if error while processing * SureWareHOOK_ERROR_UNIT_FAILURE if hardware failure * SUREWAREHOOK_ERROR_DATA_SIZE wrong size for buf * * in/out param buf : a num bytes long buffer where random bytes will be put * in param num : the number of bytes into buf */ typedef int SureWareHook_Rand_Bytes_t(char*const msg,unsigned char *buf, int num); extern SW_EXPORT SureWareHook_Rand_Bytes_t SureWareHook_Rand_Bytes; /*- * SureWare RAND Seed function * Adds some seed to the Hardware Random Number Generator * return 1 if success * SureWareHOOK_ERROR_FALLBACK if function not available in hardware * SureWareHOOK_ERROR_FAILED if error while processing * SureWareHOOK_ERROR_UNIT_FAILURE if hardware failure * SUREWAREHOOK_ERROR_DATA_SIZE wrong size for buf * * in param buf : the seed to add into the HRNG * in param num : the number of bytes into buf */ typedef int SureWareHook_Rand_Seed_t(char*const msg,const void *buf, int num); extern SW_EXPORT SureWareHook_Rand_Seed_t SureWareHook_Rand_Seed; /*- * SureWare Load Private Key function * return 1 if success * SureWareHOOK_ERROR_FAILED if error while processing * No hardware is contact for this function. * * in param key_id :the name of the private protected key file without the extension ".sws" * out param hptr : a pointer to a buffer allocated by SureWare_Hook * out param num: the effective key length in bytes * out param keytype: 1 if RSA 2 if DSA */ typedef int SureWareHook_Load_Privkey_t(char*const msg,const char *key_id,char **hptr,unsigned long *num,char *keytype); extern SW_EXPORT SureWareHook_Load_Privkey_t SureWareHook_Load_Privkey; /*- * SureWare Info Public Key function * return 1 if success * SureWareHOOK_ERROR_FAILED if error while processing * No hardware is contact for this function. * * in param key_id :the name of the private protected key file without the extension ".swp" * out param hptr : a pointer to a buffer allocated by SureWare_Hook * out param num: the effective key length in bytes * out param keytype: 1 if RSA 2 if DSA */ typedef int SureWareHook_Info_Pubkey_t(char*const msg,const char *key_id,unsigned long *num, char *keytype); extern SW_EXPORT SureWareHook_Info_Pubkey_t SureWareHook_Info_Pubkey; /*- * SureWare Load Public Key function * return 1 if success * SureWareHOOK_ERROR_FAILED if error while processing * No hardware is contact for this function. * * in param key_id :the name of the public protected key file without the extension ".swp" * in param num : the bytes size of n and e * out param n: where to write modulus in bn format * out param e: where to write exponent in bn format */ typedef int SureWareHook_Load_Rsa_Pubkey_t(char*const msg,const char *key_id,unsigned long num, unsigned long *n, unsigned long *e); extern SW_EXPORT SureWareHook_Load_Rsa_Pubkey_t SureWareHook_Load_Rsa_Pubkey; /*- * SureWare Load DSA Public Key function * return 1 if success * SureWareHOOK_ERROR_FAILED if error while processing * No hardware is contact for this function. * * in param key_id :the name of the public protected key file without the extension ".swp" * in param num : the bytes size of n and e * out param pub: where to write pub key in bn format * out param p: where to write prime in bn format * out param q: where to write sunprime (length 20 bytes) in bn format * out param g: where to write base in bn format */ typedef int SureWareHook_Load_Dsa_Pubkey_t(char*const msg,const char *key_id,unsigned long num, unsigned long *pub, unsigned long *p,unsigned long*q, unsigned long *g); extern SW_EXPORT SureWareHook_Load_Dsa_Pubkey_t SureWareHook_Load_Dsa_Pubkey; /*- * SureWare Free function * Destroy the key into the hardware if destroy==1 */ typedef void SureWareHook_Free_t(char *p,int destroy); extern SW_EXPORT SureWareHook_Free_t SureWareHook_Free; #define SUREWARE_PKCS1_PAD 1 #define SUREWARE_ISO9796_PAD 2 #define SUREWARE_NO_PAD 0 /*- * SureWare RSA Private Decryption * return 1 if success * SureWareHOOK_ERROR_FAILED if error while processing * SureWareHOOK_ERROR_UNIT_FAILURE if hardware failure * SUREWAREHOOK_ERROR_DATA_SIZE wrong size for buf * * in param flen : byte size of from and to * in param from : encrypted data buffer, should be a not-null valid pointer * out param tlen: byte size of decrypted data, if error, unexpected value * out param to : decrypted data buffer, should be a not-null valid pointer * in param prsa: a protected key pointer, should be a not-null valid pointer * int padding: padding id as follow * SUREWARE_PKCS1_PAD * SUREWARE_NO_PAD * */ typedef int SureWareHook_Rsa_Priv_Dec_t(char*const msg,int flen,unsigned char *from, int *tlen,unsigned char *to, char *prsa,int padding); extern SW_EXPORT SureWareHook_Rsa_Priv_Dec_t SureWareHook_Rsa_Priv_Dec; /*- * SureWare RSA Signature * return 1 if success * SureWareHOOK_ERROR_FAILED if error while processing * SureWareHOOK_ERROR_UNIT_FAILURE if hardware failure * SUREWAREHOOK_ERROR_DATA_SIZE wrong size for buf * * in param flen : byte size of from and to * in param from : encrypted data buffer, should be a not-null valid pointer * out param tlen: byte size of decrypted data, if error, unexpected value * out param to : decrypted data buffer, should be a not-null valid pointer * in param prsa: a protected key pointer, should be a not-null valid pointer * int padding: padding id as follow * SUREWARE_PKCS1_PAD * SUREWARE_ISO9796_PAD * */ typedef int SureWareHook_Rsa_Sign_t(char*const msg,int flen,unsigned char *from, int *tlen,unsigned char *to, char *prsa,int padding); extern SW_EXPORT SureWareHook_Rsa_Sign_t SureWareHook_Rsa_Sign; /*- * SureWare DSA Signature * return 1 if success * SureWareHOOK_ERROR_FAILED if error while processing * SureWareHOOK_ERROR_UNIT_FAILURE if hardware failure * SUREWAREHOOK_ERROR_DATA_SIZE wrong size for buf * * in param flen : byte size of from and to * in param from : encrypted data buffer, should be a not-null valid pointer * out param to : decrypted data buffer, should be a 40bytes valid pointer * in param pdsa: a protected key pointer, should be a not-null valid pointer * */ typedef int SureWareHook_Dsa_Sign_t(char*const msg,int flen,const unsigned char *from, unsigned long *r,unsigned long *s,char *pdsa); extern SW_EXPORT SureWareHook_Dsa_Sign_t SureWareHook_Dsa_Sign; /*- * SureWare Mod Exp * return 1 if success * SureWareHOOK_ERROR_FAILED if error while processing * SureWareHOOK_ERROR_UNIT_FAILURE if hardware failure * SUREWAREHOOK_ERROR_DATA_SIZE wrong size for buf * * mod and res are mlen bytes long. * exp is elen bytes long * data is dlen bytes long * mlen,elen and dlen are all multiple of sizeof(unsigned long) */ typedef int SureWareHook_Mod_Exp_t(char*const msg,int mlen,const unsigned long *mod, int elen,const unsigned long *exponent, int dlen,unsigned long *data, unsigned long *res); extern SW_EXPORT SureWareHook_Mod_Exp_t SureWareHook_Mod_Exp;