contrib/bind9/lib/dns/dst_internal.h

   1 /*
   2  * Portions Copyright (C) 2004-2008  Internet Systems Consortium, Inc. ("ISC")
   3  * Portions Copyright (C) 2000-2002  Internet Software Consortium.
   4  *
   5  * Permission to use, copy, modify, and/or distribute this software for any
   6  * purpose with or without fee is hereby granted, provided that the above
   7  * copyright notice and this permission notice appear in all copies.
   8  *
   9  * THE SOFTWARE IS PROVIDED "AS IS" AND ISC AND NETWORK ASSOCIATES DISCLAIMS
  10  * ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
  11  * WARRANTIES OF MERCHANTABILITY AND FITNESS.  IN NO EVENT SHALL ISC BE LIABLE
  12  * FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  13  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  14  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
  15  * IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  16  *
  17  * Portions Copyright (C) 1995-2000 by Network Associates, Inc.
  18  *
  19  * Permission to use, copy, modify, and/or distribute this software for any
  20  * purpose with or without fee is hereby granted, provided that the above
  21  * copyright notice and this permission notice appear in all copies.
  22  *
  23  * THE SOFTWARE IS PROVIDED "AS IS" AND ISC AND NETWORK ASSOCIATES DISCLAIMS
  24  * ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED
  25  * WARRANTIES OF MERCHANTABILITY AND FITNESS.  IN NO EVENT SHALL ISC BE LIABLE
  26  * FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
  27  * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
  28  * ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
  29  * IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  30  */
  31
  32 /* $Id: dst_internal.h,v 1.11 2008/04/01 23:47:10 tbox Exp $ */
  33
  34 #ifndef DST_DST_INTERNAL_H
  35 #define DST_DST_INTERNAL_H 1
  36
  37 #include <isc/lang.h>
  38 #include <isc/buffer.h>
  39 #include <isc/int.h>
  40 #include <isc/magic.h>
  41 #include <isc/region.h>
  42 #include <isc/types.h>
  43 #include <isc/md5.h>
  44 #include <isc/sha1.h>
  45 #include <isc/hmacmd5.h>
  46 #include <isc/hmacsha.h>
  47
  48 #include <dst/dst.h>
  49
  50 #ifdef OPENSSL
  51 #include <openssl/dh.h>
  52 #include <openssl/dsa.h>
  53 #include <openssl/err.h>
  54 #include <openssl/evp.h>
  55 #include <openssl/objects.h>
  56 #include <openssl/rsa.h>
  57 #endif
  58
  59 ISC_LANG_BEGINDECLS
  60
  61 #define KEY_MAGIC       ISC_MAGIC('D','S','T','K')
  62 #define CTX_MAGIC       ISC_MAGIC('D','S','T','C')
  63
  64 #define VALID_KEY(x) ISC_MAGIC_VALID(x, KEY_MAGIC)
  65 #define VALID_CTX(x) ISC_MAGIC_VALID(x, CTX_MAGIC)
  66
  67 extern isc_mem_t *dst__memory_pool;
  68
  69 /***
  70  *** Types
  71  ***/
  72
  73 typedef struct dst_func dst_func_t;
  74
  75 typedef struct dst_hmacmd5_key    dst_hmacmd5_key_t;
  76 typedef struct dst_hmacsha1_key   dst_hmacsha1_key_t;
  77 typedef struct dst_hmacsha224_key dst_hmacsha224_key_t;
  78 typedef struct dst_hmacsha256_key dst_hmacsha256_key_t;
  79 typedef struct dst_hmacsha384_key dst_hmacsha384_key_t;
  80 typedef struct dst_hmacsha512_key dst_hmacsha512_key_t;
  81
  82 /*% DST Key Structure */
  83 struct dst_key {
  84         unsigned int    magic;
  85         dns_name_t *    key_name;       /*%< name of the key */
  86         unsigned int    key_size;       /*%< size of the key in bits */
  87         unsigned int    key_proto;      /*%< protocols this key is used for */
  88         unsigned int    key_alg;        /*%< algorithm of the key */
  89         isc_uint32_t    key_flags;      /*%< flags of the public key */
  90         isc_uint16_t    key_id;         /*%< identifier of the key */
  91         isc_uint16_t    key_bits;       /*%< hmac digest bits */
  92         dns_rdataclass_t key_class;     /*%< class of the key record */
  93         isc_mem_t       *mctx;          /*%< memory context */
  94         char            *engine;        /*%< engine name (HSM) */
  95         char            *label;         /*%< engine label (HSM) */
  96         union {
  97                 void *generic;
  98                 gss_ctx_id_t gssctx;
  99 #ifdef OPENSSL
 100 #if USE_EVP_RSA
 101                 RSA *rsa;
 102 #endif
 103                 DSA *dsa;
 104                 DH *dh;
 105                 EVP_PKEY *pkey;
 106 #endif
 107                 dst_hmacmd5_key_t *hmacmd5;
 108                 dst_hmacsha1_key_t *hmacsha1;
 109                 dst_hmacsha224_key_t *hmacsha224;
 110                 dst_hmacsha256_key_t *hmacsha256;
 111                 dst_hmacsha384_key_t *hmacsha384;
 112                 dst_hmacsha512_key_t *hmacsha512;
 113
 114         } keydata;                      /*%< pointer to key in crypto pkg fmt */
 115         dst_func_t *    func;           /*%< crypto package specific functions */
 116 };
 117
 118 struct dst_context {
 119         unsigned int magic;
 120         dst_key_t *key;
 121         isc_mem_t *mctx;
 122         union {
 123                 void *generic;
 124                 dst_gssapi_signverifyctx_t *gssctx;
 125                 isc_md5_t *md5ctx;
 126                 isc_sha1_t *sha1ctx;
 127                 isc_hmacmd5_t *hmacmd5ctx;
 128                 isc_hmacsha1_t *hmacsha1ctx;
 129                 isc_hmacsha224_t *hmacsha224ctx;
 130                 isc_hmacsha256_t *hmacsha256ctx;
 131                 isc_hmacsha384_t *hmacsha384ctx;
 132                 isc_hmacsha512_t *hmacsha512ctx;
 133 #ifdef OPENSSL
 134                 EVP_MD_CTX *evp_md_ctx;
 135 #endif
 136         } ctxdata;
 137 };
 138
 139 struct dst_func {
 140         /*
 141          * Context functions
 142          */
 143         isc_result_t (*createctx)(dst_key_t *key, dst_context_t *dctx);
 144         void (*destroyctx)(dst_context_t *dctx);
 145         isc_result_t (*adddata)(dst_context_t *dctx, const isc_region_t *data);
 146
 147         /*
 148          * Key operations
 149          */
 150         isc_result_t (*sign)(dst_context_t *dctx, isc_buffer_t *sig);
 151         isc_result_t (*verify)(dst_context_t *dctx, const isc_region_t *sig);
 152         isc_result_t (*computesecret)(const dst_key_t *pub,
 153                                       const dst_key_t *priv,
 154                                       isc_buffer_t *secret);
 155         isc_boolean_t (*compare)(const dst_key_t *key1, const dst_key_t *key2);
 156         isc_boolean_t (*paramcompare)(const dst_key_t *key1,
 157                                       const dst_key_t *key2);
 158         isc_result_t (*generate)(dst_key_t *key, int parms);
 159         isc_boolean_t (*isprivate)(const dst_key_t *key);
 160         void (*destroy)(dst_key_t *key);
 161
 162         /* conversion functions */
 163         isc_result_t (*todns)(const dst_key_t *key, isc_buffer_t *data);
 164         isc_result_t (*fromdns)(dst_key_t *key, isc_buffer_t *data);
 165         isc_result_t (*tofile)(const dst_key_t *key, const char *directory);
 166         isc_result_t (*parse)(dst_key_t *key, isc_lex_t *lexer);
 167
 168         /* cleanup */
 169         void (*cleanup)(void);
 170
 171         isc_result_t (*fromlabel)(dst_key_t *key, const char *engine,
 172                                   const char *label, const char *pin);
 173 };
 174
 175 /*%
 176  * Initializers
 177  */
 178 isc_result_t dst__openssl_init(void);
 179
 180 isc_result_t dst__hmacmd5_init(struct dst_func **funcp);
 181 isc_result_t dst__hmacsha1_init(struct dst_func **funcp);
 182 isc_result_t dst__hmacsha224_init(struct dst_func **funcp);
 183 isc_result_t dst__hmacsha256_init(struct dst_func **funcp);
 184 isc_result_t dst__hmacsha384_init(struct dst_func **funcp);
 185 isc_result_t dst__hmacsha512_init(struct dst_func **funcp);
 186 isc_result_t dst__opensslrsa_init(struct dst_func **funcp);
 187 isc_result_t dst__openssldsa_init(struct dst_func **funcp);
 188 isc_result_t dst__openssldh_init(struct dst_func **funcp);
 189 isc_result_t dst__gssapi_init(struct dst_func **funcp);
 190
 191 /*%
 192  * Destructors
 193  */
 194 void dst__openssl_destroy(void);
 195
 196 /*%
 197  * Memory allocators using the DST memory pool.
 198  */
 199 void * dst__mem_alloc(size_t size);
 200 void   dst__mem_free(void *ptr);
 201 void * dst__mem_realloc(void *ptr, size_t size);
 202
 203 /*%
 204  * Entropy retriever using the DST entropy pool.
 205  */
 206 isc_result_t dst__entropy_getdata(void *buf, unsigned int len,
 207                                   isc_boolean_t pseudo);
 208
 209 /*
 210  * Entropy status hook.
 211  */
 212 unsigned int dst__entropy_status(void);
 213
 214 ISC_LANG_ENDDECLS
 215
 216 #endif /* DST_DST_INTERNAL_H */
 217 /*! \file */