[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.67

1.67    ! markus      1: /* $OpenBSD: kex.h,v 1.66 2015/01/15 09:40: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.65      markus     29: #include "mac.h"
1.66      djm        30: #include "buffer.h" /* XXX for typedef */
                     31: #include "key.h" /* XXX for typedef */
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.67    ! markus     81: typedef struct kex Kex;
        !            82: typedef struct sshcomp Comp;
1.65      markus     83: typedef struct sshmac Mac;
1.67    ! markus     84: typedef struct sshenc Enc;
        !            85: typedef struct newkeys Newkeys;
1.1       markus     86:
1.67    ! markus     87: struct sshenc {
1.19      markus     88:        char    *name;
1.67    ! markus     89:        const struct sshcipher *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: };
1.67    ! markus     97: struct sshcomp {
        !            98:        u_int   type;
1.19      markus     99:        int     enabled;
                    100:        char    *name;
                    101: };
1.67    ! markus    102: struct newkeys {
        !           103:        struct sshenc   enc;
        !           104:        struct sshmac   mac;
        !           105:        struct sshcomp  comp;
1.1       markus    106: };
1.67    ! markus    107: struct kex {
1.19      markus    108:        u_char  *session_id;
1.67    ! markus    109:        size_t  session_id_len;
        !           110:        struct newkeys  *newkeys[MODE_MAX];
1.36      djm       111:        u_int   we_need;
1.61      dtucker   112:        u_int   dh_need;
1.19      markus    113:        int     server;
                    114:        char    *name;
                    115:        int     hostkey_type;
                    116:        int     kex_type;
1.48      andreas   117:        int     roaming;
1.67    ! markus    118:        struct sshbuf *my;
        !           119:        struct sshbuf *peer;
1.42      djm       120:        sig_atomic_t done;
1.19      markus    121:        int     flags;
1.59      djm       122:        int     hash_alg;
1.55      djm       123:        int     ec_nid;
1.19      markus    124:        char    *client_version_string;
                    125:        char    *server_version_string;
1.25      itojun    126:        int     (*verify_host_key)(Key *);
1.49      djm       127:        Key     *(*load_host_public_key)(int);
                    128:        Key     *(*load_host_private_key)(int);
1.30      provos    129:        int     (*host_key_index)(Key *);
1.56      markus    130:        void    (*sign)(Key *, Key *, u_char **, u_int *, u_char *, u_int);
1.33      markus    131:        void    (*kex[KEX_MAX])(Kex *);
1.1       markus    132: };
1.52      djm       133:
                    134: int     kex_names_valid(const char *);
1.58      dtucker   135: char   *kex_alg_list(char);
1.1       markus    136:
1.25      itojun    137: Kex    *kex_setup(char *[PROPOSAL_MAX]);
1.26      markus    138: void    kex_finish(Kex *);
1.67    ! markus    139: void     kex_free_newkeys(struct newkeys *);
1.20      markus    140:
1.26      markus    141: void    kex_send_kexinit(Kex *);
1.28      markus    142: void    kex_input_kexinit(int, u_int32_t, void *);
1.60      djm       143: void    kex_derive_keys(Kex *, u_char *, u_int, const u_char *, u_int);
                    144: void    kex_derive_keys_bn(Kex *, u_char *, u_int, const BIGNUM *);
1.19      markus    145:
1.33      markus    146: void    kexdh_client(Kex *);
                    147: void    kexdh_server(Kex *);
                    148: void    kexgex_client(Kex *);
                    149: void    kexgex_server(Kex *);
1.50      djm       150: void    kexecdh_client(Kex *);
                    151: void    kexecdh_server(Kex *);
1.57      markus    152: void    kexc25519_client(Kex *);
                    153: void    kexc25519_server(Kex *);
1.33      markus    154:
1.38      djm       155: void
1.33      markus    156: kex_dh_hash(char *, char *, char *, int, char *, int, u_char *, int,
1.38      djm       157:     BIGNUM *, BIGNUM *, BIGNUM *, u_char **, u_int *);
                    158: void
1.59      djm       159: kexgex_hash(int, char *, char *, char *, int, char *,
1.40      deraadt   160:     int, u_char *, int, int, int, int, BIGNUM *, BIGNUM *, BIGNUM *,
1.38      djm       161:     BIGNUM *, BIGNUM *, u_char **, u_int *);
1.50      djm       162: void
1.59      djm       163: kex_ecdh_hash(int, const EC_GROUP *, char *, char *, char *, int,
1.50      djm       164:     char *, int, u_char *, int, const EC_POINT *, const EC_POINT *,
                    165:     const BIGNUM *, u_char **, u_int *);
1.57      markus    166: void
1.59      djm       167: kex_c25519_hash(int, char *, char *, char *, int,
1.57      markus    168:     char *, int, u_char *, int, const u_char *, const u_char *,
1.60      djm       169:     const u_char *, u_int, u_char **, u_int *);
1.57      markus    170:
                    171: #define CURVE25519_SIZE 32
                    172: void   kexc25519_keygen(u_char[CURVE25519_SIZE], u_char[CURVE25519_SIZE])
1.64      djm       173:        __attribute__((__bounded__(__minbytes__, 1, CURVE25519_SIZE)))
                    174:        __attribute__((__bounded__(__minbytes__, 2, CURVE25519_SIZE)));
1.60      djm       175: void kexc25519_shared_key(const u_char key[CURVE25519_SIZE],
                    176:     const u_char pub[CURVE25519_SIZE], Buffer *out)
1.64      djm       177:        __attribute__((__bounded__(__minbytes__, 1, CURVE25519_SIZE)))
                    178:        __attribute__((__bounded__(__minbytes__, 2, CURVE25519_SIZE)));
1.34      markus    179:
                    180: void
                    181: derive_ssh1_session_id(BIGNUM *, BIGNUM *, u_int8_t[8], u_int8_t[16]);
1.18      markus    182:
1.50      djm       183: #if defined(DEBUG_KEX) || defined(DEBUG_KEXDH) || defined(DEBUG_KEXECDH)
1.25      itojun    184: void   dump_digest(char *, u_char *, int);
1.18      markus    185: #endif
1.1       markus    186:
                    187: #endif