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

1.71    ! djm         1: /* $OpenBSD: kex.h,v 1.70 2015/01/26 06:10:03 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:
1.69      markus     33: #ifdef WITH_LEAKMALLOC
                     34: #include "leakmalloc.h"
                     35: #endif
                     36:
1.47      andreas    37: #define KEX_COOKIE_LEN 16
1.14      markus     38:
1.38      djm        39: #define        KEX_DH1                 "diffie-hellman-group1-sha1"
                     40: #define        KEX_DH14                "diffie-hellman-group14-sha1"
                     41: #define        KEX_DHGEX_SHA1          "diffie-hellman-group-exchange-sha1"
1.39      djm        42: #define        KEX_DHGEX_SHA256        "diffie-hellman-group-exchange-sha256"
1.48      andreas    43: #define        KEX_RESUME              "resume@appgate.com"
1.55      djm        44: #define        KEX_ECDH_SHA2_NISTP256  "ecdh-sha2-nistp256"
                     45: #define        KEX_ECDH_SHA2_NISTP384  "ecdh-sha2-nistp384"
                     46: #define        KEX_ECDH_SHA2_NISTP521  "ecdh-sha2-nistp521"
1.57      markus     47: #define        KEX_CURVE25519_SHA256   "curve25519-sha256@libssh.org"
1.37      markus     48:
                     49: #define COMP_NONE      0
                     50: #define COMP_ZLIB      1
                     51: #define COMP_DELAYED   2
1.1       markus     52:
1.69      markus     53: #define CURVE25519_SIZE 32
                     54:
1.1       markus     55: enum kex_init_proposals {
                     56:        PROPOSAL_KEX_ALGS,
                     57:        PROPOSAL_SERVER_HOST_KEY_ALGS,
                     58:        PROPOSAL_ENC_ALGS_CTOS,
                     59:        PROPOSAL_ENC_ALGS_STOC,
                     60:        PROPOSAL_MAC_ALGS_CTOS,
                     61:        PROPOSAL_MAC_ALGS_STOC,
                     62:        PROPOSAL_COMP_ALGS_CTOS,
                     63:        PROPOSAL_COMP_ALGS_STOC,
                     64:        PROPOSAL_LANG_CTOS,
                     65:        PROPOSAL_LANG_STOC,
                     66:        PROPOSAL_MAX
                     67: };
                     68:
                     69: enum kex_modes {
                     70:        MODE_IN,
                     71:        MODE_OUT,
                     72:        MODE_MAX
                     73: };
                     74:
1.5       provos     75: enum kex_exchange {
1.33      markus     76:        KEX_DH_GRP1_SHA1,
1.35      djm        77:        KEX_DH_GRP14_SHA1,
1.33      markus     78:        KEX_DH_GEX_SHA1,
1.39      djm        79:        KEX_DH_GEX_SHA256,
1.50      djm        80:        KEX_ECDH_SHA2,
1.57      markus     81:        KEX_C25519_SHA256,
1.33      markus     82:        KEX_MAX
1.5       provos     83: };
1.13      stevesk    84:
1.19      markus     85: #define KEX_INIT_SENT  0x0001
                     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;
1.69      markus    105:        struct sshcomp  comp;
1.1       markus    106: };
1.69      markus    107:
                    108: struct ssh;
                    109:
1.67      markus    110: struct kex {
1.19      markus    111:        u_char  *session_id;
1.67      markus    112:        size_t  session_id_len;
                    113:        struct newkeys  *newkeys[MODE_MAX];
1.36      djm       114:        u_int   we_need;
1.61      dtucker   115:        u_int   dh_need;
1.19      markus    116:        int     server;
                    117:        char    *name;
                    118:        int     hostkey_type;
1.70      djm       119:        int     hostkey_nid;
1.69      markus    120:        u_int   kex_type;
1.48      andreas   121:        int     roaming;
1.67      markus    122:        struct sshbuf *my;
                    123:        struct sshbuf *peer;
1.42      djm       124:        sig_atomic_t done;
1.69      markus    125:        u_int   flags;
1.59      djm       126:        int     hash_alg;
1.55      djm       127:        int     ec_nid;
1.19      markus    128:        char    *client_version_string;
                    129:        char    *server_version_string;
1.69      markus    130:        int     (*verify_host_key)(struct sshkey *, struct ssh *);
1.70      djm       131:        struct sshkey *(*load_host_public_key)(int, int, struct ssh *);
                    132:        struct sshkey *(*load_host_private_key)(int, int, struct ssh *);
1.71    ! djm       133:        int     (*host_key_index)(struct sshkey *, int, struct ssh *);
1.69      markus    134:        int     (*sign)(struct sshkey *, struct sshkey *,
1.71    ! djm       135:            u_char **, size_t *, const u_char *, size_t, u_int);
1.69      markus    136:        int     (*kex[KEX_MAX])(struct ssh *);
                    137:        /* kex specific state */
                    138:        DH      *dh;                    /* DH */
                    139:        u_int   min, max, nbits;        /* GEX */
                    140:        EC_KEY  *ec_client_key;         /* ECDH */
                    141:        const EC_GROUP *ec_group;       /* ECDH */
                    142:        u_char c25519_client_key[CURVE25519_SIZE]; /* 25519 */
                    143:        u_char c25519_client_pubkey[CURVE25519_SIZE]; /* 25519 */
1.1       markus    144: };
1.52      djm       145:
                    146: int     kex_names_valid(const char *);
1.58      dtucker   147: char   *kex_alg_list(char);
1.1       markus    148:
1.69      markus    149: int     kex_new(struct ssh *, char *[PROPOSAL_MAX], struct kex **);
                    150: int     kex_setup(struct ssh *, char *[PROPOSAL_MAX]);
                    151: void    kex_free_newkeys(struct newkeys *);
                    152: void    kex_free(struct kex *);
                    153:
                    154: int     kex_buf2prop(struct sshbuf *, int *, char ***);
                    155: int     kex_prop2buf(struct sshbuf *, char *proposal[PROPOSAL_MAX]);
                    156: void    kex_prop_free(char **);
1.20      markus    157:
1.69      markus    158: int     kex_send_kexinit(struct ssh *);
1.68      markus    159: int     kex_input_kexinit(int, u_int32_t, void *);
1.69      markus    160: int     kex_derive_keys(struct ssh *, u_char *, u_int, const struct sshbuf *);
                    161: int     kex_derive_keys_bn(struct ssh *, u_char *, u_int, const BIGNUM *);
                    162: int     kex_send_newkeys(struct ssh *);
                    163:
                    164: int     kexdh_client(struct ssh *);
                    165: int     kexdh_server(struct ssh *);
                    166: int     kexgex_client(struct ssh *);
                    167: int     kexgex_server(struct ssh *);
                    168: int     kexecdh_client(struct ssh *);
                    169: int     kexecdh_server(struct ssh *);
                    170: int     kexc25519_client(struct ssh *);
                    171: int     kexc25519_server(struct ssh *);
                    172:
                    173: int     kex_dh_hash(const char *, const char *,
                    174:     const u_char *, size_t, const u_char *, size_t, const u_char *, size_t,
                    175:     const BIGNUM *, const BIGNUM *, const BIGNUM *, u_char *, size_t *);
                    176:
                    177: int     kexgex_hash(int, const char *, const char *,
                    178:     const u_char *, size_t, const u_char *, size_t, const u_char *, size_t,
                    179:     int, int, int,
                    180:     const BIGNUM *, const BIGNUM *, const BIGNUM *,
                    181:     const BIGNUM *, const BIGNUM *,
                    182:     u_char *, size_t *);
                    183:
                    184: int kex_ecdh_hash(int, const EC_GROUP *, const char *, const char *,
                    185:     const u_char *, size_t, const u_char *, size_t, const u_char *, size_t,
                    186:     const EC_POINT *, const EC_POINT *, const BIGNUM *, u_char *, size_t *);
                    187:
                    188: int     kex_c25519_hash(int, const char *, const char *, const char *, size_t,
                    189:     const char *, size_t, const u_char *, size_t, const u_char *, const u_char *,
                    190:     const u_char *, size_t, u_char *, size_t *);
1.19      markus    191:
1.69      markus    192: void   kexc25519_keygen(u_char key[CURVE25519_SIZE], u_char pub[CURVE25519_SIZE])
1.64      djm       193:        __attribute__((__bounded__(__minbytes__, 1, CURVE25519_SIZE)))
                    194:        __attribute__((__bounded__(__minbytes__, 2, CURVE25519_SIZE)));
1.69      markus    195: int    kexc25519_shared_key(const u_char key[CURVE25519_SIZE],
                    196:     const u_char pub[CURVE25519_SIZE], struct sshbuf *out)
1.64      djm       197:        __attribute__((__bounded__(__minbytes__, 1, CURVE25519_SIZE)))
                    198:        __attribute__((__bounded__(__minbytes__, 2, CURVE25519_SIZE)));
1.34      markus    199:
1.69      markus    200: int
1.34      markus    201: derive_ssh1_session_id(BIGNUM *, BIGNUM *, u_int8_t[8], u_int8_t[16]);
1.18      markus    202:
1.50      djm       203: #if defined(DEBUG_KEX) || defined(DEBUG_KEXDH) || defined(DEBUG_KEXECDH)
1.25      itojun    204: void   dump_digest(char *, u_char *, int);
1.18      markus    205: #endif
1.1       markus    206:
                    207: #endif