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

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