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

1.74    ! markus      1: /* $OpenBSD: kex.h,v 1.73 2015/07/30 00:01:34 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;
1.74    ! markus    118:        char    *hostkey_alg;
1.19      markus    119:        int     hostkey_type;
1.70      djm       120:        int     hostkey_nid;
1.69      markus    121:        u_int   kex_type;
1.48      andreas   122:        int     roaming;
1.74    ! markus    123:        int     rsa_sha2;
        !           124:        int     ext_info_c;
1.67      markus    125:        struct sshbuf *my;
                    126:        struct sshbuf *peer;
1.42      djm       127:        sig_atomic_t done;
1.69      markus    128:        u_int   flags;
1.59      djm       129:        int     hash_alg;
1.55      djm       130:        int     ec_nid;
1.19      markus    131:        char    *client_version_string;
                    132:        char    *server_version_string;
1.72      djm       133:        char    *failed_choice;
1.69      markus    134:        int     (*verify_host_key)(struct sshkey *, struct ssh *);
1.70      djm       135:        struct sshkey *(*load_host_public_key)(int, int, struct ssh *);
                    136:        struct sshkey *(*load_host_private_key)(int, int, struct ssh *);
1.71      djm       137:        int     (*host_key_index)(struct sshkey *, int, struct ssh *);
1.74    ! markus    138:        int     (*sign)(struct sshkey *, struct sshkey *, u_char **, size_t *,
        !           139:            const u_char *, size_t, const char *, u_int);
1.69      markus    140:        int     (*kex[KEX_MAX])(struct ssh *);
                    141:        /* kex specific state */
                    142:        DH      *dh;                    /* DH */
                    143:        u_int   min, max, nbits;        /* GEX */
                    144:        EC_KEY  *ec_client_key;         /* ECDH */
                    145:        const EC_GROUP *ec_group;       /* ECDH */
                    146:        u_char c25519_client_key[CURVE25519_SIZE]; /* 25519 */
                    147:        u_char c25519_client_pubkey[CURVE25519_SIZE]; /* 25519 */
1.1       markus    148: };
1.52      djm       149:
                    150: int     kex_names_valid(const char *);
1.58      dtucker   151: char   *kex_alg_list(char);
1.73      djm       152: char   *kex_names_cat(const char *, const char *);
                    153: int     kex_assemble_names(const char *, char **);
1.1       markus    154:
1.69      markus    155: int     kex_new(struct ssh *, char *[PROPOSAL_MAX], struct kex **);
                    156: int     kex_setup(struct ssh *, char *[PROPOSAL_MAX]);
                    157: void    kex_free_newkeys(struct newkeys *);
                    158: void    kex_free(struct kex *);
                    159:
                    160: int     kex_buf2prop(struct sshbuf *, int *, char ***);
                    161: int     kex_prop2buf(struct sshbuf *, char *proposal[PROPOSAL_MAX]);
                    162: void    kex_prop_free(char **);
1.20      markus    163:
1.69      markus    164: int     kex_send_kexinit(struct ssh *);
1.68      markus    165: int     kex_input_kexinit(int, u_int32_t, void *);
1.74    ! markus    166: int     kex_input_ext_info(int, u_int32_t, void *);
1.69      markus    167: int     kex_derive_keys(struct ssh *, u_char *, u_int, const struct sshbuf *);
                    168: int     kex_derive_keys_bn(struct ssh *, u_char *, u_int, const BIGNUM *);
                    169: int     kex_send_newkeys(struct ssh *);
                    170:
                    171: int     kexdh_client(struct ssh *);
                    172: int     kexdh_server(struct ssh *);
                    173: int     kexgex_client(struct ssh *);
                    174: int     kexgex_server(struct ssh *);
                    175: int     kexecdh_client(struct ssh *);
                    176: int     kexecdh_server(struct ssh *);
                    177: int     kexc25519_client(struct ssh *);
                    178: int     kexc25519_server(struct ssh *);
                    179:
                    180: int     kex_dh_hash(const char *, const char *,
                    181:     const u_char *, size_t, const u_char *, size_t, const u_char *, size_t,
                    182:     const BIGNUM *, const BIGNUM *, const BIGNUM *, u_char *, size_t *);
                    183:
                    184: int     kexgex_hash(int, const char *, const char *,
                    185:     const u_char *, size_t, const u_char *, size_t, const u_char *, size_t,
                    186:     int, int, int,
                    187:     const BIGNUM *, const BIGNUM *, const BIGNUM *,
                    188:     const BIGNUM *, const BIGNUM *,
                    189:     u_char *, size_t *);
                    190:
                    191: int kex_ecdh_hash(int, const EC_GROUP *, const char *, const char *,
                    192:     const u_char *, size_t, const u_char *, size_t, const u_char *, size_t,
                    193:     const EC_POINT *, const EC_POINT *, const BIGNUM *, u_char *, size_t *);
                    194:
                    195: int     kex_c25519_hash(int, const char *, const char *, const char *, size_t,
                    196:     const char *, size_t, const u_char *, size_t, const u_char *, const u_char *,
                    197:     const u_char *, size_t, u_char *, size_t *);
1.19      markus    198:
1.69      markus    199: void   kexc25519_keygen(u_char key[CURVE25519_SIZE], u_char pub[CURVE25519_SIZE])
1.64      djm       200:        __attribute__((__bounded__(__minbytes__, 1, CURVE25519_SIZE)))
                    201:        __attribute__((__bounded__(__minbytes__, 2, CURVE25519_SIZE)));
1.69      markus    202: int    kexc25519_shared_key(const u_char key[CURVE25519_SIZE],
                    203:     const u_char pub[CURVE25519_SIZE], struct sshbuf *out)
1.64      djm       204:        __attribute__((__bounded__(__minbytes__, 1, CURVE25519_SIZE)))
                    205:        __attribute__((__bounded__(__minbytes__, 2, CURVE25519_SIZE)));
1.34      markus    206:
1.69      markus    207: int
1.34      markus    208: derive_ssh1_session_id(BIGNUM *, BIGNUM *, u_int8_t[8], u_int8_t[16]);
1.18      markus    209:
1.50      djm       210: #if defined(DEBUG_KEX) || defined(DEBUG_KEXDH) || defined(DEBUG_KEXECDH)
1.25      itojun    211: void   dump_digest(char *, u_char *, int);
1.18      markus    212: #endif
1.1       markus    213:
                    214: #endif