Annotation of src/usr.bin/ssh/kex.h, Revision 1.56
1.56 ! markus 1: /* $OpenBSD: kex.h,v 1.55 2013/04/19 01:06:50 djm Exp $ */
1.12 niklas 2:
1.1 markus 3: /*
1.24 markus 4: * Copyright (c) 2000, 2001 Markus Friedl. All rights reserved.
1.1 markus 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:
1.14 markus 29: #include <openssl/evp.h>
1.45 djm 30: #include <openssl/hmac.h>
1.50 djm 31: #include <openssl/ec.h>
1.47 andreas 32:
33: #define KEX_COOKIE_LEN 16
1.14 markus 34:
1.38 djm 35: #define KEX_DH1 "diffie-hellman-group1-sha1"
36: #define KEX_DH14 "diffie-hellman-group14-sha1"
37: #define KEX_DHGEX_SHA1 "diffie-hellman-group-exchange-sha1"
1.39 djm 38: #define KEX_DHGEX_SHA256 "diffie-hellman-group-exchange-sha256"
1.48 andreas 39: #define KEX_RESUME "resume@appgate.com"
1.55 djm 40: #define KEX_ECDH_SHA2_NISTP256 "ecdh-sha2-nistp256"
41: #define KEX_ECDH_SHA2_NISTP384 "ecdh-sha2-nistp384"
42: #define KEX_ECDH_SHA2_NISTP521 "ecdh-sha2-nistp521"
1.37 markus 43:
44: #define COMP_NONE 0
45: #define COMP_ZLIB 1
46: #define COMP_DELAYED 2
1.1 markus 47:
48: enum kex_init_proposals {
49: PROPOSAL_KEX_ALGS,
50: PROPOSAL_SERVER_HOST_KEY_ALGS,
51: PROPOSAL_ENC_ALGS_CTOS,
52: PROPOSAL_ENC_ALGS_STOC,
53: PROPOSAL_MAC_ALGS_CTOS,
54: PROPOSAL_MAC_ALGS_STOC,
55: PROPOSAL_COMP_ALGS_CTOS,
56: PROPOSAL_COMP_ALGS_STOC,
57: PROPOSAL_LANG_CTOS,
58: PROPOSAL_LANG_STOC,
59: PROPOSAL_MAX
60: };
61:
62: enum kex_modes {
63: MODE_IN,
64: MODE_OUT,
65: MODE_MAX
66: };
67:
1.5 provos 68: enum kex_exchange {
1.33 markus 69: KEX_DH_GRP1_SHA1,
1.35 djm 70: KEX_DH_GRP14_SHA1,
1.33 markus 71: KEX_DH_GEX_SHA1,
1.39 djm 72: KEX_DH_GEX_SHA256,
1.50 djm 73: KEX_ECDH_SHA2,
1.33 markus 74: KEX_MAX
1.5 provos 75: };
1.13 stevesk 76:
1.19 markus 77: #define KEX_INIT_SENT 0x0001
78:
1.1 markus 79: typedef struct Kex Kex;
80: typedef struct Mac Mac;
81: typedef struct Comp Comp;
82: typedef struct Enc Enc;
1.19 markus 83: typedef struct Newkeys Newkeys;
1.1 markus 84:
85: struct Enc {
1.19 markus 86: char *name;
1.55 djm 87: const Cipher *cipher;
1.19 markus 88: int enabled;
1.29 markus 89: u_int key_len;
1.54 markus 90: u_int iv_len;
1.29 markus 91: u_int block_size;
1.10 markus 92: u_char *key;
93: u_char *iv;
1.1 markus 94: };
95: struct Mac {
1.19 markus 96: char *name;
97: int enabled;
1.36 djm 98: u_int mac_len;
1.10 markus 99: u_char *key;
1.36 djm 100: u_int key_len;
1.46 pvalchev 101: int type;
1.53 markus 102: int etm; /* Encrypt-then-MAC */
1.46 pvalchev 103: const EVP_MD *evp_md;
104: HMAC_CTX evp_ctx;
105: struct umac_ctx *umac_ctx;
1.1 markus 106: };
107: struct Comp {
1.19 markus 108: int type;
109: int enabled;
110: char *name;
111: };
112: struct Newkeys {
113: Enc enc;
114: Mac mac;
115: Comp comp;
1.1 markus 116: };
117: struct Kex {
1.19 markus 118: u_char *session_id;
1.32 markus 119: u_int session_id_len;
1.22 markus 120: Newkeys *newkeys[MODE_MAX];
1.36 djm 121: u_int we_need;
1.19 markus 122: int server;
123: char *name;
124: int hostkey_type;
125: int kex_type;
1.48 andreas 126: int roaming;
1.19 markus 127: Buffer my;
128: Buffer peer;
1.42 djm 129: sig_atomic_t done;
1.19 markus 130: int flags;
1.38 djm 131: const EVP_MD *evp_md;
1.55 djm 132: int ec_nid;
1.19 markus 133: char *client_version_string;
134: char *server_version_string;
1.25 itojun 135: int (*verify_host_key)(Key *);
1.49 djm 136: Key *(*load_host_public_key)(int);
137: Key *(*load_host_private_key)(int);
1.30 provos 138: int (*host_key_index)(Key *);
1.56 ! markus 139: void (*sign)(Key *, Key *, u_char **, u_int *, u_char *, u_int);
1.33 markus 140: void (*kex[KEX_MAX])(Kex *);
1.1 markus 141: };
1.52 djm 142:
143: int kex_names_valid(const char *);
1.55 djm 144: char *kex_alg_list(void);
1.1 markus 145:
1.25 itojun 146: Kex *kex_setup(char *[PROPOSAL_MAX]);
1.26 markus 147: void kex_finish(Kex *);
1.20 markus 148:
1.26 markus 149: void kex_send_kexinit(Kex *);
1.28 markus 150: void kex_input_kexinit(int, u_int32_t, void *);
1.38 djm 151: void kex_derive_keys(Kex *, u_char *, u_int, BIGNUM *);
1.18 markus 152:
1.33 markus 153: Newkeys *kex_get_newkeys(int);
1.19 markus 154:
1.33 markus 155: void kexdh_client(Kex *);
156: void kexdh_server(Kex *);
157: void kexgex_client(Kex *);
158: void kexgex_server(Kex *);
1.50 djm 159: void kexecdh_client(Kex *);
160: void kexecdh_server(Kex *);
1.33 markus 161:
1.38 djm 162: void
1.33 markus 163: kex_dh_hash(char *, char *, char *, int, char *, int, u_char *, int,
1.38 djm 164: BIGNUM *, BIGNUM *, BIGNUM *, u_char **, u_int *);
165: void
166: kexgex_hash(const EVP_MD *, char *, char *, char *, int, char *,
1.40 deraadt 167: int, u_char *, int, int, int, int, BIGNUM *, BIGNUM *, BIGNUM *,
1.38 djm 168: BIGNUM *, BIGNUM *, u_char **, u_int *);
1.50 djm 169: void
170: kex_ecdh_hash(const EVP_MD *, const EC_GROUP *, char *, char *, char *, int,
171: char *, int, u_char *, int, const EC_POINT *, const EC_POINT *,
172: const BIGNUM *, u_char **, u_int *);
1.34 markus 173:
174: void
175: derive_ssh1_session_id(BIGNUM *, BIGNUM *, u_int8_t[8], u_int8_t[16]);
1.18 markus 176:
1.50 djm 177: #if defined(DEBUG_KEX) || defined(DEBUG_KEXDH) || defined(DEBUG_KEXECDH)
1.25 itojun 178: void dump_digest(char *, u_char *, int);
1.18 markus 179: #endif
1.1 markus 180:
181: #endif