[BACK]Return to kex.h CVS log [TXT][DIR] Up to [local] / src / usr.bin / ssh

Annotation of src/usr.bin/ssh/kex.h, Revision 1.60

1.60    ! djm         1: /* $OpenBSD: kex.h,v 1.59 2014/01/09 23:20:00 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.57      markus     43: #define        KEX_CURVE25519_SHA256   "curve25519-sha256@libssh.org"
1.37      markus     44:
                     45: #define COMP_NONE      0
                     46: #define COMP_ZLIB      1
                     47: #define COMP_DELAYED   2
1.1       markus     48:
                     49: enum kex_init_proposals {
                     50:        PROPOSAL_KEX_ALGS,
                     51:        PROPOSAL_SERVER_HOST_KEY_ALGS,
                     52:        PROPOSAL_ENC_ALGS_CTOS,
                     53:        PROPOSAL_ENC_ALGS_STOC,
                     54:        PROPOSAL_MAC_ALGS_CTOS,
                     55:        PROPOSAL_MAC_ALGS_STOC,
                     56:        PROPOSAL_COMP_ALGS_CTOS,
                     57:        PROPOSAL_COMP_ALGS_STOC,
                     58:        PROPOSAL_LANG_CTOS,
                     59:        PROPOSAL_LANG_STOC,
                     60:        PROPOSAL_MAX
                     61: };
                     62:
                     63: enum kex_modes {
                     64:        MODE_IN,
                     65:        MODE_OUT,
                     66:        MODE_MAX
                     67: };
                     68:
1.5       provos     69: enum kex_exchange {
1.33      markus     70:        KEX_DH_GRP1_SHA1,
1.35      djm        71:        KEX_DH_GRP14_SHA1,
1.33      markus     72:        KEX_DH_GEX_SHA1,
1.39      djm        73:        KEX_DH_GEX_SHA256,
1.50      djm        74:        KEX_ECDH_SHA2,
1.57      markus     75:        KEX_C25519_SHA256,
1.33      markus     76:        KEX_MAX
1.5       provos     77: };
1.13      stevesk    78:
1.19      markus     79: #define KEX_INIT_SENT  0x0001
                     80:
1.1       markus     81: typedef struct Kex Kex;
                     82: typedef struct Mac Mac;
                     83: typedef struct Comp Comp;
                     84: typedef struct Enc Enc;
1.19      markus     85: typedef struct Newkeys Newkeys;
1.1       markus     86:
                     87: struct Enc {
1.19      markus     88:        char    *name;
1.55      djm        89:        const Cipher *cipher;
1.19      markus     90:        int     enabled;
1.29      markus     91:        u_int   key_len;
1.54      markus     92:        u_int   iv_len;
1.29      markus     93:        u_int   block_size;
1.10      markus     94:        u_char  *key;
                     95:        u_char  *iv;
1.1       markus     96: };
                     97: struct Mac {
1.19      markus     98:        char    *name;
                     99:        int     enabled;
1.36      djm       100:        u_int   mac_len;
1.10      markus    101:        u_char  *key;
1.36      djm       102:        u_int   key_len;
1.46      pvalchev  103:        int     type;
1.53      markus    104:        int     etm;            /* Encrypt-then-MAC */
1.46      pvalchev  105:        const EVP_MD    *evp_md;
                    106:        HMAC_CTX        evp_ctx;
                    107:        struct umac_ctx *umac_ctx;
1.1       markus    108: };
                    109: struct Comp {
1.19      markus    110:        int     type;
                    111:        int     enabled;
                    112:        char    *name;
                    113: };
                    114: struct Newkeys {
                    115:        Enc     enc;
                    116:        Mac     mac;
                    117:        Comp    comp;
1.1       markus    118: };
                    119: struct Kex {
1.19      markus    120:        u_char  *session_id;
1.32      markus    121:        u_int   session_id_len;
1.22      markus    122:        Newkeys *newkeys[MODE_MAX];
1.36      djm       123:        u_int   we_need;
1.19      markus    124:        int     server;
                    125:        char    *name;
                    126:        int     hostkey_type;
                    127:        int     kex_type;
1.48      andreas   128:        int     roaming;
1.19      markus    129:        Buffer  my;
                    130:        Buffer  peer;
1.42      djm       131:        sig_atomic_t done;
1.19      markus    132:        int     flags;
1.59      djm       133:        int     hash_alg;
1.55      djm       134:        int     ec_nid;
1.19      markus    135:        char    *client_version_string;
                    136:        char    *server_version_string;
1.25      itojun    137:        int     (*verify_host_key)(Key *);
1.49      djm       138:        Key     *(*load_host_public_key)(int);
                    139:        Key     *(*load_host_private_key)(int);
1.30      provos    140:        int     (*host_key_index)(Key *);
1.56      markus    141:        void    (*sign)(Key *, Key *, u_char **, u_int *, u_char *, u_int);
1.33      markus    142:        void    (*kex[KEX_MAX])(Kex *);
1.1       markus    143: };
1.52      djm       144:
                    145: int     kex_names_valid(const char *);
1.58      dtucker   146: char   *kex_alg_list(char);
1.1       markus    147:
1.25      itojun    148: Kex    *kex_setup(char *[PROPOSAL_MAX]);
1.26      markus    149: void    kex_finish(Kex *);
1.20      markus    150:
1.26      markus    151: void    kex_send_kexinit(Kex *);
1.28      markus    152: void    kex_input_kexinit(int, u_int32_t, void *);
1.60    ! djm       153: void    kex_derive_keys(Kex *, u_char *, u_int, const u_char *, u_int);
        !           154: void    kex_derive_keys_bn(Kex *, u_char *, u_int, const BIGNUM *);
1.18      markus    155:
1.33      markus    156: Newkeys *kex_get_newkeys(int);
1.19      markus    157:
1.33      markus    158: void    kexdh_client(Kex *);
                    159: void    kexdh_server(Kex *);
                    160: void    kexgex_client(Kex *);
                    161: void    kexgex_server(Kex *);
1.50      djm       162: void    kexecdh_client(Kex *);
                    163: void    kexecdh_server(Kex *);
1.57      markus    164: void    kexc25519_client(Kex *);
                    165: void    kexc25519_server(Kex *);
1.33      markus    166:
1.38      djm       167: void
1.33      markus    168: kex_dh_hash(char *, char *, char *, int, char *, int, u_char *, int,
1.38      djm       169:     BIGNUM *, BIGNUM *, BIGNUM *, u_char **, u_int *);
                    170: void
1.59      djm       171: kexgex_hash(int, char *, char *, char *, int, char *,
1.40      deraadt   172:     int, u_char *, int, int, int, int, BIGNUM *, BIGNUM *, BIGNUM *,
1.38      djm       173:     BIGNUM *, BIGNUM *, u_char **, u_int *);
1.50      djm       174: void
1.59      djm       175: kex_ecdh_hash(int, const EC_GROUP *, char *, char *, char *, int,
1.50      djm       176:     char *, int, u_char *, int, const EC_POINT *, const EC_POINT *,
                    177:     const BIGNUM *, u_char **, u_int *);
1.57      markus    178: void
1.59      djm       179: kex_c25519_hash(int, char *, char *, char *, int,
1.57      markus    180:     char *, int, u_char *, int, const u_char *, const u_char *,
1.60    ! djm       181:     const u_char *, u_int, u_char **, u_int *);
1.57      markus    182:
                    183: #define CURVE25519_SIZE 32
                    184: void   kexc25519_keygen(u_char[CURVE25519_SIZE], u_char[CURVE25519_SIZE])
                    185:        __attribute__((__bounded__(__minbytes__, 1, CURVE25519_SIZE)))
                    186:        __attribute__((__bounded__(__minbytes__, 2, CURVE25519_SIZE)));
1.60    ! djm       187: void kexc25519_shared_key(const u_char key[CURVE25519_SIZE],
        !           188:     const u_char pub[CURVE25519_SIZE], Buffer *out)
1.57      markus    189:        __attribute__((__bounded__(__minbytes__, 1, CURVE25519_SIZE)))
                    190:        __attribute__((__bounded__(__minbytes__, 2, CURVE25519_SIZE)));
1.34      markus    191:
                    192: void
                    193: derive_ssh1_session_id(BIGNUM *, BIGNUM *, u_int8_t[8], u_int8_t[16]);
1.18      markus    194:
1.50      djm       195: #if defined(DEBUG_KEX) || defined(DEBUG_KEXDH) || defined(DEBUG_KEXECDH)
1.25      itojun    196: void   dump_digest(char *, u_char *, int);
1.18      markus    197: #endif
1.1       markus    198:
                    199: #endif