kex.h

   1 /*      $OpenBSD: kex.h,v 1.20 2001/04/04 09:48:34 markus Exp $ */
   2
   3 /*
   4  * Copyright (c) 2000 Markus Friedl.  All rights reserved.
   5  *
   6  * Redistribution and use in source and binary forms, with or without
   7  * modification, are permitted provided that the following conditions
   8  * are met:
   9  * 1. Redistributions of source code must retain the above copyright
  10  *    notice, this list of conditions and the following disclaimer.
  11  * 2. Redistributions in binary form must reproduce the above copyright
  12  *    notice, this list of conditions and the following disclaimer in the
  13  *    documentation and/or other materials provided with the distribution.
  14  *
  15  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
  16  * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
  17  * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
  18  * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
  19  * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
  20  * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  21  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  22  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  23  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
  24  * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  25  */
  26 #ifndef KEX_H
  27 #define KEX_H
  28
  29 #include <openssl/evp.h>
  30 #include "buffer.h"
  31 #include "cipher.h"
  32 #include "key.h"
  33
  34 #define KEX_DH1         "diffie-hellman-group1-sha1"
  35 #define KEX_DHGEX       "diffie-hellman-group-exchange-sha1"
  36
  37 enum kex_init_proposals {
  38         PROPOSAL_KEX_ALGS,
  39         PROPOSAL_SERVER_HOST_KEY_ALGS,
  40         PROPOSAL_ENC_ALGS_CTOS,
  41         PROPOSAL_ENC_ALGS_STOC,
  42         PROPOSAL_MAC_ALGS_CTOS,
  43         PROPOSAL_MAC_ALGS_STOC,
  44         PROPOSAL_COMP_ALGS_CTOS,
  45         PROPOSAL_COMP_ALGS_STOC,
  46         PROPOSAL_LANG_CTOS,
  47         PROPOSAL_LANG_STOC,
  48         PROPOSAL_MAX
  49 };
  50
  51 enum kex_modes {
  52         MODE_IN,
  53         MODE_OUT,
  54         MODE_MAX
  55 };
  56
  57 enum kex_exchange {
  58         DH_GRP1_SHA1,
  59         DH_GEX_SHA1
  60 };
  61
  62 #define KEX_INIT_SENT   0x0001
  63
  64 typedef struct Kex Kex;
  65 typedef struct Mac Mac;
  66 typedef struct Comp Comp;
  67 typedef struct Enc Enc;
  68 typedef struct Newkeys Newkeys;
  69
  70 struct Enc {
  71         char    *name;
  72         Cipher  *cipher;
  73         int     enabled;
  74         u_char  *key;
  75         u_char  *iv;
  76 };
  77 struct Mac {
  78         char    *name;
  79         int     enabled;
  80         EVP_MD  *md;
  81         int     mac_len;
  82         u_char  *key;
  83         int     key_len;
  84 };
  85 struct Comp {
  86         int     type;
  87         int     enabled;
  88         char    *name;
  89 };
  90 struct Newkeys {
  91         Enc     enc;
  92         Mac     mac;
  93         Comp    comp;
  94 };
  95 struct Kex {
  96         u_char  *session_id;
  97         int     session_id_len;
  98         Newkeys *keys[MODE_MAX];
  99         int     we_need;
 100         int     server;
 101         char    *name;
 102         int     hostkey_type;
 103         int     kex_type;
 104         Buffer  my;
 105         Buffer  peer;
 106         int     newkeys;
 107         int     flags;
 108         char    *client_version_string;
 109         char    *server_version_string;
 110         int     (*check_host_key)(Key *hostkey);
 111         Key     *(*load_host_key)(int type);
 112 };
 113
 114 Kex     *kex_setup(char *proposal[PROPOSAL_MAX]);
 115 void    kex_finish(Kex *kex);
 116
 117 void    kex_send_kexinit(Kex *kex);
 118 void    kex_protocol_error(int type, int plen, void *ctxt);
 119 void    kex_derive_keys(Kex *k, u_char *hash, BIGNUM *shared_secret);
 120
 121 void    kexdh(Kex *);
 122 void    kexgex(Kex *);
 123
 124 Newkeys *kex_get_newkeys(int mode);
 125
 126 #if defined(DEBUG_KEX) || defined(DEBUG_KEXDH)
 127 void    dump_digest(char *msg, u_char *digest, int len);
 128 #endif
 129
 130 #endif