Main Page   Class Hierarchy   Compound List   File List   Compound Members   File Members  

ssh.h

00001 #include <string.h>
00002 
00003 #include "puttymem.h"
00004 #include "network.h"
00005 #include "int64.h"
00006 
00007 struct ssh_channel;
00008 
00009 extern void sshfwd_close(struct ssh_channel *c);
00010 extern int sshfwd_write(struct ssh_channel *c, char *, int);
00011 extern void sshfwd_unthrottle(struct ssh_channel *c, int bufsize);
00012 
00013 /*
00014  * Useful thing.
00015  */
00016 #ifndef lenof
00017 #define lenof(x) ( (sizeof((x))) / (sizeof(*(x))))
00018 #endif
00019 
00020 #define SSH_CIPHER_IDEA         1
00021 #define SSH_CIPHER_DES          2
00022 #define SSH_CIPHER_3DES         3
00023 #define SSH_CIPHER_BLOWFISH     6
00024 
00025 #ifdef MSCRYPTOAPI
00026 #define APIEXTRA 8
00027 #else
00028 #define APIEXTRA 0
00029 #endif
00030 
00031 #ifndef BIGNUM_INTERNAL
00032 typedef void *Bignum;
00033 #endif
00034 
00035 struct RSAKey {
00036     int bits;
00037     int bytes;
00038 #ifdef MSCRYPTOAPI
00039     unsigned long exponent;
00040     unsigned char *modulus;
00041 #else
00042     Bignum modulus;
00043     Bignum exponent;
00044     Bignum private_exponent;
00045     Bignum p;
00046     Bignum q;
00047     Bignum iqmp;
00048 #endif
00049     char *comment;
00050 };
00051 
00052 struct dss_key {
00053     Bignum p, q, g, y, x;
00054 };
00055 
00056 int makekey(unsigned char *data, struct RSAKey *result,
00057             unsigned char **keystr, int order);
00058 int makeprivate(unsigned char *data, struct RSAKey *result);
00059 void rsaencrypt(unsigned char *data, int length, struct RSAKey *key);
00060 Bignum rsadecrypt(Bignum input, struct RSAKey *key);
00061 void rsasign(unsigned char *data, int length, struct RSAKey *key);
00062 void rsasanitise(struct RSAKey *key);
00063 int rsastr_len(struct RSAKey *key);
00064 void rsastr_fmt(char *str, struct RSAKey *key);
00065 void rsa_fingerprint(char *str, int len, struct RSAKey *key);
00066 int rsa_verify(struct RSAKey *key);
00067 unsigned char *rsa_public_blob(struct RSAKey *key, int *len);
00068 int rsa_public_blob_len(void *data);
00069 void freersakey(struct RSAKey *key);
00070 
00071 typedef unsigned int word32;
00072 typedef unsigned int uint32;
00073 
00074 unsigned long crc32(const void *s, size_t len);
00075 unsigned long crc32_update(unsigned long crc_input, const void *s, size_t len);
00076 
00077 /* SSH CRC compensation attack detector */
00078 int detect_attack(unsigned char *buf, uint32 len, unsigned char *IV);
00079 
00080 typedef struct {
00081     uint32 h[4];
00082 } MD5_Core_State;
00083 
00084 struct MD5Context {
00085 #ifdef MSCRYPTOAPI
00086     unsigned long hHash;
00087 #else
00088     MD5_Core_State core;
00089     unsigned char block[64];
00090     int blkused;
00091     uint32 lenhi, lenlo;
00092 #endif
00093 };
00094 
00095 void MD5Init(struct MD5Context *context);
00096 void MD5Update(struct MD5Context *context, unsigned char const *buf,
00097                unsigned len);
00098 void MD5Final(unsigned char digest[16], struct MD5Context *context);
00099 
00100 typedef struct {
00101     uint32 h[5];
00102     unsigned char block[64];
00103     int blkused;
00104     uint32 lenhi, lenlo;
00105 } SHA_State;
00106 void SHA_Init(SHA_State * s);
00107 void SHA_Bytes(SHA_State * s, void *p, int len);
00108 void SHA_Final(SHA_State * s, unsigned char *output);
00109 void SHA_Simple(void *p, int len, unsigned char *output);
00110 
00111 void hmac_sha1_simple(void *key, int keylen, void *data, int datalen,
00112                       unsigned char *output);
00113 
00114 typedef struct {
00115     uint64 h[8];
00116     unsigned char block[128];
00117     int blkused;
00118     uint32 len[4];
00119 } SHA512_State;
00120 void SHA512_Init(SHA512_State * s);
00121 void SHA512_Bytes(SHA512_State * s, const void *p, int len);
00122 void SHA512_Final(SHA512_State * s, unsigned char *output);
00123 void SHA512_Simple(const void *p, int len, unsigned char *output);
00124 
00125 struct ssh_cipher {
00126     void (*sesskey) (unsigned char *key);       /* for ssh 1 */
00127     void (*encrypt) (unsigned char *blk, int len);
00128     void (*decrypt) (unsigned char *blk, int len);
00129     int blksize;
00130 };
00131 
00132 struct ssh2_cipher {
00133     void (*setcsiv) (unsigned char *key);       /* for ssh 2 */
00134     void (*setcskey) (unsigned char *key);      /* for ssh 2 */
00135     void (*setsciv) (unsigned char *key);       /* for ssh 2 */
00136     void (*setsckey) (unsigned char *key);      /* for ssh 2 */
00137     void (*encrypt) (unsigned char *blk, int len);
00138     void (*decrypt) (unsigned char *blk, int len);
00139     char *name;
00140     int blksize;
00141     int keylen;
00142 };
00143 
00144 struct ssh2_ciphers {
00145     int nciphers;
00146     const struct ssh2_cipher *const *list;
00147 };
00148 
00149 struct ssh_mac {
00150     void (*setcskey) (unsigned char *key);
00151     void (*setsckey) (unsigned char *key);
00152     void (*generate) (unsigned char *blk, int len, unsigned long seq);
00153     int (*verify) (unsigned char *blk, int len, unsigned long seq);
00154     char *name;
00155     int len;
00156 };
00157 
00158 struct ssh_kex {
00159     /*
00160      * Plugging in another KEX algorithm requires structural chaos,
00161      * so it's hard to abstract them into nice little structures
00162      * like this. Hence, for the moment, this is just a
00163      * placeholder. I claim justification in the fact that OpenSSH
00164      * does this too :-)
00165      */
00166     char *name;
00167 };
00168 
00169 struct ssh_signkey {
00170     void *(*newkey) (char *data, int len);
00171     void (*freekey) (void *key);
00172     char *(*fmtkey) (void *key);
00173     unsigned char *(*public_blob) (void *key, int *len);
00174     unsigned char *(*private_blob) (void *key, int *len);
00175     void *(*createkey) (unsigned char *pub_blob, int pub_len,
00176                         unsigned char *priv_blob, int priv_len);
00177     void *(*openssh_createkey) (unsigned char **blob, int *len);
00178     int (*openssh_fmtkey) (void *key, unsigned char *blob, int len);
00179     char *(*fingerprint) (void *key);
00180     int (*verifysig) (void *key, char *sig, int siglen,
00181                       char *data, int datalen);
00182     unsigned char *(*sign) (void *key, char *data, int datalen,
00183                             int *siglen);
00184     char *name;
00185     char *keytype;                     /* for host key cache */
00186 };
00187 
00188 struct ssh_compress {
00189     char *name;
00190     void (*compress_init) (void);
00191     int (*compress) (unsigned char *block, int len,
00192                      unsigned char **outblock, int *outlen);
00193     void (*decompress_init) (void);
00194     int (*decompress) (unsigned char *block, int len,
00195                        unsigned char **outblock, int *outlen);
00196     int (*disable_compression) (void);
00197 };
00198 
00199 struct ssh2_userkey {
00200     const struct ssh_signkey *alg;     /* the key algorithm */
00201     void *data;                        /* the key data */
00202     char *comment;                     /* the key comment */
00203 };
00204 
00205 extern const struct ssh_cipher ssh_3des;
00206 extern const struct ssh_cipher ssh_des;
00207 extern const struct ssh_cipher ssh_blowfish_ssh1;
00208 extern const struct ssh2_ciphers ssh2_3des;
00209 extern const struct ssh2_ciphers ssh2_des;
00210 extern const struct ssh2_ciphers ssh2_aes;
00211 extern const struct ssh2_ciphers ssh2_blowfish;
00212 extern const struct ssh_kex ssh_diffiehellman;
00213 extern const struct ssh_kex ssh_diffiehellman_gex;
00214 extern const struct ssh_signkey ssh_dss;
00215 extern const struct ssh_signkey ssh_rsa;
00216 extern const struct ssh_mac ssh_md5;
00217 extern const struct ssh_mac ssh_sha1;
00218 extern const struct ssh_mac ssh_sha1_buggy;
00219 
00220 /*
00221  * PuTTY version number formatted as an SSH version string. 
00222  */
00223 extern char sshver[];
00224 
00225 /*
00226  * Gross hack: pscp will try to start SFTP but fall back to scp1 if
00227  * that fails. This variable is the means by which scp.c can reach
00228  * into the SSH code and find out which one it got.
00229  */
00230 extern int ssh_fallback_cmd;
00231 
00232 #ifndef MSCRYPTOAPI
00233 void SHATransform(word32 * digest, word32 * data);
00234 #endif
00235 
00236 int random_byte(void);
00237 void random_add_noise(void *noise, int length);
00238 void random_add_heavynoise(void *noise, int length);
00239 
00240 void logevent(char *);
00241 void *new_sock_channel(Socket s); // allocates and register a new channel for port forwarding
00242 void ssh_send_port_open(void *channel, char *hostname, int port, char *org);
00243 
00244 Bignum copybn(Bignum b);
00245 Bignum bn_power_2(int n);
00246 void bn_restore_invariant(Bignum b);
00247 Bignum bignum_from_long(unsigned long n);
00248 void freebn(Bignum b);
00249 Bignum modpow(Bignum base, Bignum exp, Bignum mod);
00250 Bignum modmul(Bignum a, Bignum b, Bignum mod);
00251 void decbn(Bignum n);
00252 extern Bignum Zero, One;
00253 Bignum bignum_from_bytes(unsigned char *data, int nbytes);
00254 int ssh1_read_bignum(unsigned char *data, Bignum * result);
00255 int bignum_bitcount(Bignum bn);
00256 int ssh1_bignum_length(Bignum bn);
00257 int ssh2_bignum_length(Bignum bn);
00258 int bignum_byte(Bignum bn, int i);
00259 int bignum_bit(Bignum bn, int i);
00260 void bignum_set_bit(Bignum bn, int i, int value);
00261 int ssh1_write_bignum(void *data, Bignum bn);
00262 Bignum biggcd(Bignum a, Bignum b);
00263 unsigned short bignum_mod_short(Bignum number, unsigned short modulus);
00264 Bignum bignum_add_long(Bignum number, unsigned long addend);
00265 Bignum bigmul(Bignum a, Bignum b);
00266 Bignum bigmuladd(Bignum a, Bignum b, Bignum addend);
00267 Bignum bigdiv(Bignum a, Bignum b);
00268 Bignum bigmod(Bignum a, Bignum b);
00269 Bignum modinv(Bignum number, Bignum modulus);
00270 Bignum bignum_bitmask(Bignum number);
00271 Bignum bignum_rshift(Bignum number, int shift);
00272 int bignum_cmp(Bignum a, Bignum b);
00273 char *bignum_decimal(Bignum x);
00274 
00275 void dh_setup_group1(void);
00276 void dh_setup_group(Bignum pval, Bignum gval);
00277 void dh_cleanup(void);
00278 Bignum dh_create_e(int nbits);
00279 Bignum dh_find_K(Bignum f);
00280 
00281 int loadrsakey(char *filename, struct RSAKey *key, char *passphrase);
00282 int rsakey_encrypted(char *filename, char **comment);
00283 int rsakey_pubblob(char *filename, void **blob, int *bloblen);
00284 
00285 int saversakey(char *filename, struct RSAKey *key, char *passphrase);
00286 
00287 void base64_encode_atom(unsigned char *data, int n, char *out);
00288 
00289 /* ssh2_load_userkey can return this as an error */
00290 extern struct ssh2_userkey ssh2_wrong_passphrase;
00291 #define SSH2_WRONG_PASSPHRASE (&ssh2_wrong_passphrase)
00292 
00293 int ssh2_userkey_encrypted(char *filename, char **comment);
00294 struct ssh2_userkey *ssh2_load_userkey(char *filename, char *passphrase);
00295 char *ssh2_userkey_loadpub(char *filename, char **algorithm,
00296                            int *pub_blob_len);
00297 int ssh2_save_userkey(char *filename, struct ssh2_userkey *key,
00298                       char *passphrase);
00299 
00300 enum {
00301     SSH_KEYTYPE_UNOPENABLE,
00302     SSH_KEYTYPE_UNKNOWN,
00303     SSH_KEYTYPE_SSH1, SSH_KEYTYPE_SSH2,
00304     SSH_KEYTYPE_OPENSSH, SSH_KEYTYPE_SSHCOM
00305 };
00306 int key_type(char *filename);
00307 char *key_type_to_str(int type);
00308 
00309 int import_possible(int type);
00310 int import_target_type(int type);
00311 int import_encrypted(char *filename, int type, char **comment);
00312 int import_ssh1(char *filename, int type, struct RSAKey *key,char *passphrase);
00313 struct ssh2_userkey *import_ssh2(char *filename, int type, char *passphrase);
00314 int export_ssh1(char *filename, int type, struct RSAKey *key,char *passphrase);
00315 int export_ssh2(char *filename, int type,
00316                 struct ssh2_userkey *key, char *passphrase);
00317 
00318 void des3_decrypt_pubkey(unsigned char *key, unsigned char *blk, int len);
00319 void des3_encrypt_pubkey(unsigned char *key, unsigned char *blk, int len);
00320 void des3_decrypt_pubkey_ossh(unsigned char *key, unsigned char *iv,
00321                               unsigned char *blk, int len);
00322 void des3_encrypt_pubkey_ossh(unsigned char *key, unsigned char *iv,
00323                               unsigned char *blk, int len);
00324 void aes256_encrypt_pubkey(unsigned char *key, unsigned char *blk,
00325                            int len);
00326 void aes256_decrypt_pubkey(unsigned char *key, unsigned char *blk,
00327                            int len);
00328 
00329 /*
00330  * For progress updates in the key generation utility.
00331  */
00332 #define PROGFN_INITIALISE 1
00333 #define PROGFN_LIN_PHASE 2
00334 #define PROGFN_EXP_PHASE 3
00335 #define PROGFN_PHASE_EXTENT 4
00336 #define PROGFN_READY 5
00337 #define PROGFN_PROGRESS 6
00338 typedef void (*progfn_t) (void *param, int action, int phase, int progress);
00339 
00340 int rsa_generate(struct RSAKey *key, int bits, progfn_t pfn,
00341                  void *pfnparam);
00342 int dsa_generate(struct dss_key *key, int bits, progfn_t pfn,
00343                  void *pfnparam);
00344 Bignum primegen(int bits, int modulus, int residue, Bignum factor,
00345                 int phase, progfn_t pfn, void *pfnparam);
00346 
00347 
00348 /*
00349  * zlib compression.
00350  */
00351 void zlib_compress_init(void);
00352 void zlib_decompress_init(void);
00353 int zlib_compress_block(unsigned char *block, int len,
00354                         unsigned char **outblock, int *outlen);
00355 int zlib_decompress_block(unsigned char *block, int len,
00356                           unsigned char **outblock, int *outlen);
00357 
00358 /*
00359  * SSH1 agent messages.
00360  */
00361 #define SSH1_AGENTC_REQUEST_RSA_IDENTITIES    1
00362 #define SSH1_AGENT_RSA_IDENTITIES_ANSWER      2
00363 #define SSH1_AGENTC_RSA_CHALLENGE             3
00364 #define SSH1_AGENT_RSA_RESPONSE               4
00365 #define SSH1_AGENTC_ADD_RSA_IDENTITY          7
00366 #define SSH1_AGENTC_REMOVE_RSA_IDENTITY       8
00367 #define SSH1_AGENTC_REMOVE_ALL_RSA_IDENTITIES 9 /* openssh private? */
00368 
00369 /*
00370  * Messages common to SSH1 and OpenSSH's SSH2.
00371  */
00372 #define SSH_AGENT_FAILURE                    5
00373 #define SSH_AGENT_SUCCESS                    6
00374 
00375 /*
00376  * OpenSSH's SSH2 agent messages.
00377  */
00378 #define SSH2_AGENTC_REQUEST_IDENTITIES          11
00379 #define SSH2_AGENT_IDENTITIES_ANSWER            12
00380 #define SSH2_AGENTC_SIGN_REQUEST                13
00381 #define SSH2_AGENT_SIGN_RESPONSE                14
00382 #define SSH2_AGENTC_ADD_IDENTITY                17
00383 #define SSH2_AGENTC_REMOVE_IDENTITY             18
00384 #define SSH2_AGENTC_REMOVE_ALL_IDENTITIES       19
00385 
00386 /*
00387  * Need this to warn about support for the original SSH2 keyfile
00388  * format.
00389  */
00390 void old_keyfile_warning(void);

Generated on Sun Feb 9 13:01:29 2003 for PuTTY by doxygen1.2.18