Utterly hideous new approach to extracting install-sh from the
[u/mdw/putty] / ssh.h
... / ...
CommitLineData
1#include <stdio.h>
2#include <string.h>
3
4#include "puttymem.h"
5#include "network.h"
6#include "int64.h"
7#include "misc.h"
8
9struct ssh_channel;
10
11extern void sshfwd_close(struct ssh_channel *c);
12extern int sshfwd_write(struct ssh_channel *c, char *, int);
13extern void sshfwd_unthrottle(struct ssh_channel *c, int bufsize);
14
15/*
16 * Useful thing.
17 */
18#ifndef lenof
19#define lenof(x) ( (sizeof((x))) / (sizeof(*(x))))
20#endif
21
22#define SSH_CIPHER_IDEA 1
23#define SSH_CIPHER_DES 2
24#define SSH_CIPHER_3DES 3
25#define SSH_CIPHER_BLOWFISH 6
26
27#ifdef MSCRYPTOAPI
28#define APIEXTRA 8
29#else
30#define APIEXTRA 0
31#endif
32
33#ifndef BIGNUM_INTERNAL
34typedef void *Bignum;
35#endif
36
37struct RSAKey {
38 int bits;
39 int bytes;
40#ifdef MSCRYPTOAPI
41 unsigned long exponent;
42 unsigned char *modulus;
43#else
44 Bignum modulus;
45 Bignum exponent;
46 Bignum private_exponent;
47 Bignum p;
48 Bignum q;
49 Bignum iqmp;
50#endif
51 char *comment;
52};
53
54struct dss_key {
55 Bignum p, q, g, y, x;
56};
57
58int makekey(unsigned char *data, int len, struct RSAKey *result,
59 unsigned char **keystr, int order);
60int makeprivate(unsigned char *data, int len, struct RSAKey *result);
61int rsaencrypt(unsigned char *data, int length, struct RSAKey *key);
62Bignum rsadecrypt(Bignum input, struct RSAKey *key);
63void rsasign(unsigned char *data, int length, struct RSAKey *key);
64void rsasanitise(struct RSAKey *key);
65int rsastr_len(struct RSAKey *key);
66void rsastr_fmt(char *str, struct RSAKey *key);
67void rsa_fingerprint(char *str, int len, struct RSAKey *key);
68int rsa_verify(struct RSAKey *key);
69unsigned char *rsa_public_blob(struct RSAKey *key, int *len);
70int rsa_public_blob_len(void *data, int maxlen);
71void freersakey(struct RSAKey *key);
72
73typedef unsigned int word32;
74typedef unsigned int uint32;
75
76unsigned long crc32_compute(const void *s, size_t len);
77unsigned long crc32_update(unsigned long crc_input, const void *s, size_t len);
78
79/* SSH CRC compensation attack detector */
80void *crcda_make_context(void);
81void crcda_free_context(void *handle);
82int detect_attack(void *handle, unsigned char *buf, uint32 len,
83 unsigned char *IV);
84
85/*
86 * SSH2 RSA key exchange functions
87 */
88struct ssh_hash;
89void *ssh_rsakex_newkey(char *data, int len);
90void ssh_rsakex_freekey(void *key);
91int ssh_rsakex_klen(void *key);
92void ssh_rsakex_encrypt(const struct ssh_hash *h, unsigned char *in, int inlen,
93 unsigned char *out, int outlen,
94 void *key);
95
96typedef struct {
97 uint32 h[4];
98} MD5_Core_State;
99
100struct MD5Context {
101#ifdef MSCRYPTOAPI
102 unsigned long hHash;
103#else
104 MD5_Core_State core;
105 unsigned char block[64];
106 int blkused;
107 uint32 lenhi, lenlo;
108#endif
109};
110
111void MD5Init(struct MD5Context *context);
112void MD5Update(struct MD5Context *context, unsigned char const *buf,
113 unsigned len);
114void MD5Final(unsigned char digest[16], struct MD5Context *context);
115void MD5Simple(void const *p, unsigned len, unsigned char output[16]);
116
117void *hmacmd5_make_context(void);
118void hmacmd5_free_context(void *handle);
119void hmacmd5_key(void *handle, void const *key, int len);
120void hmacmd5_do_hmac(void *handle, unsigned char const *blk, int len,
121 unsigned char *hmac);
122
123typedef struct {
124 uint32 h[5];
125 unsigned char block[64];
126 int blkused;
127 uint32 lenhi, lenlo;
128} SHA_State;
129void SHA_Init(SHA_State * s);
130void SHA_Bytes(SHA_State * s, void *p, int len);
131void SHA_Final(SHA_State * s, unsigned char *output);
132void SHA_Simple(void *p, int len, unsigned char *output);
133
134void hmac_sha1_simple(void *key, int keylen, void *data, int datalen,
135 unsigned char *output);
136typedef struct {
137 uint32 h[8];
138 unsigned char block[64];
139 int blkused;
140 uint32 lenhi, lenlo;
141} SHA256_State;
142void SHA256_Init(SHA256_State * s);
143void SHA256_Bytes(SHA256_State * s, const void *p, int len);
144void SHA256_Final(SHA256_State * s, unsigned char *output);
145void SHA256_Simple(const void *p, int len, unsigned char *output);
146
147typedef struct {
148 uint64 h[8];
149 unsigned char block[128];
150 int blkused;
151 uint32 len[4];
152} SHA512_State;
153void SHA512_Init(SHA512_State * s);
154void SHA512_Bytes(SHA512_State * s, const void *p, int len);
155void SHA512_Final(SHA512_State * s, unsigned char *output);
156void SHA512_Simple(const void *p, int len, unsigned char *output);
157
158struct ssh_cipher {
159 void *(*make_context)(void);
160 void (*free_context)(void *);
161 void (*sesskey) (void *, unsigned char *key); /* for SSH-1 */
162 void (*encrypt) (void *, unsigned char *blk, int len);
163 void (*decrypt) (void *, unsigned char *blk, int len);
164 int blksize;
165 char *text_name;
166};
167
168struct ssh2_cipher {
169 void *(*make_context)(void);
170 void (*free_context)(void *);
171 void (*setiv) (void *, unsigned char *key); /* for SSH-2 */
172 void (*setkey) (void *, unsigned char *key);/* for SSH-2 */
173 void (*encrypt) (void *, unsigned char *blk, int len);
174 void (*decrypt) (void *, unsigned char *blk, int len);
175 char *name;
176 int blksize;
177 int keylen;
178 unsigned int flags;
179#define SSH_CIPHER_IS_CBC 1
180 char *text_name;
181};
182
183struct ssh2_ciphers {
184 int nciphers;
185 const struct ssh2_cipher *const *list;
186};
187
188struct ssh_mac {
189 void *(*make_context)(void);
190 void (*free_context)(void *);
191 void (*setkey) (void *, unsigned char *key);
192 void (*generate) (void *, unsigned char *blk, int len, unsigned long seq);
193 int (*verify) (void *, unsigned char *blk, int len, unsigned long seq);
194 char *name;
195 int len;
196 char *text_name;
197};
198
199struct ssh_hash {
200 void *(*init)(void); /* also allocates context */
201 void (*bytes)(void *, void *, int);
202 void (*final)(void *, unsigned char *); /* also frees context */
203 int hlen; /* output length in bytes */
204 char *text_name;
205};
206
207struct ssh_kex {
208 char *name, *groupname;
209 enum { KEXTYPE_DH, KEXTYPE_RSA } main_type;
210 /* For DH */
211 const unsigned char *pdata, *gdata; /* NULL means group exchange */
212 int plen, glen;
213 const struct ssh_hash *hash;
214};
215
216struct ssh_kexes {
217 int nkexes;
218 const struct ssh_kex *const *list;
219};
220
221struct ssh_signkey {
222 void *(*newkey) (char *data, int len);
223 void (*freekey) (void *key);
224 char *(*fmtkey) (void *key);
225 unsigned char *(*public_blob) (void *key, int *len);
226 unsigned char *(*private_blob) (void *key, int *len);
227 void *(*createkey) (unsigned char *pub_blob, int pub_len,
228 unsigned char *priv_blob, int priv_len);
229 void *(*openssh_createkey) (unsigned char **blob, int *len);
230 int (*openssh_fmtkey) (void *key, unsigned char *blob, int len);
231 int (*pubkey_bits) (void *blob, int len);
232 char *(*fingerprint) (void *key);
233 int (*verifysig) (void *key, char *sig, int siglen,
234 char *data, int datalen);
235 unsigned char *(*sign) (void *key, char *data, int datalen,
236 int *siglen);
237 char *name;
238 char *keytype; /* for host key cache */
239};
240
241struct ssh_compress {
242 char *name;
243 void *(*compress_init) (void);
244 void (*compress_cleanup) (void *);
245 int (*compress) (void *, unsigned char *block, int len,
246 unsigned char **outblock, int *outlen);
247 void *(*decompress_init) (void);
248 void (*decompress_cleanup) (void *);
249 int (*decompress) (void *, unsigned char *block, int len,
250 unsigned char **outblock, int *outlen);
251 int (*disable_compression) (void *);
252 char *text_name;
253};
254
255struct ssh2_userkey {
256 const struct ssh_signkey *alg; /* the key algorithm */
257 void *data; /* the key data */
258 char *comment; /* the key comment */
259};
260
261/* The maximum length of any hash algorithm used in kex. (bytes) */
262#define SSH2_KEX_MAX_HASH_LEN (32) /* SHA-256 */
263
264extern const struct ssh_cipher ssh_3des;
265extern const struct ssh_cipher ssh_des;
266extern const struct ssh_cipher ssh_blowfish_ssh1;
267extern const struct ssh2_ciphers ssh2_3des;
268extern const struct ssh2_ciphers ssh2_des;
269extern const struct ssh2_ciphers ssh2_aes;
270extern const struct ssh2_ciphers ssh2_blowfish;
271extern const struct ssh2_ciphers ssh2_arcfour;
272extern const struct ssh_hash ssh_sha1;
273extern const struct ssh_hash ssh_sha256;
274extern const struct ssh_kexes ssh_diffiehellman_group1;
275extern const struct ssh_kexes ssh_diffiehellman_group14;
276extern const struct ssh_kexes ssh_diffiehellman_gex;
277extern const struct ssh_kexes ssh_rsa_kex;
278extern const struct ssh_signkey ssh_dss;
279extern const struct ssh_signkey ssh_rsa;
280extern const struct ssh_mac ssh_hmac_md5;
281extern const struct ssh_mac ssh_hmac_sha1;
282extern const struct ssh_mac ssh_hmac_sha1_buggy;
283extern const struct ssh_mac ssh_hmac_sha1_96;
284extern const struct ssh_mac ssh_hmac_sha1_96_buggy;
285
286
287/*
288 * PuTTY version number formatted as an SSH version string.
289 */
290extern char sshver[];
291
292/*
293 * Gross hack: pscp will try to start SFTP but fall back to scp1 if
294 * that fails. This variable is the means by which scp.c can reach
295 * into the SSH code and find out which one it got.
296 */
297extern int ssh_fallback_cmd(void *handle);
298
299#ifndef MSCRYPTOAPI
300void SHATransform(word32 * digest, word32 * data);
301#endif
302
303int random_byte(void);
304void random_add_noise(void *noise, int length);
305void random_add_heavynoise(void *noise, int length);
306
307void logevent(void *, const char *);
308
309/* Allocate and register a new channel for port forwarding */
310void *new_sock_channel(void *handle, Socket s);
311void ssh_send_port_open(void *channel, char *hostname, int port, char *org);
312
313/* Exports from portfwd.c */
314extern const char *pfd_newconnect(Socket * s, char *hostname, int port,
315 void *c, const Config *cfg,
316 int addressfamily);
317/* desthost == NULL indicates dynamic (SOCKS) port forwarding */
318extern const char *pfd_addforward(char *desthost, int destport, char *srcaddr,
319 int port, void *backhandle,
320 const Config *cfg, void **sockdata,
321 int address_family);
322extern void pfd_close(Socket s);
323extern void pfd_terminate(void *sockdata);
324extern int pfd_send(Socket s, char *data, int len);
325extern void pfd_confirm(Socket s);
326extern void pfd_unthrottle(Socket s);
327extern void pfd_override_throttle(Socket s, int enable);
328
329/* Exports from x11fwd.c */
330extern const char *x11_init(Socket *, char *, void *, void *, const char *,
331 int, const Config *);
332extern void x11_close(Socket);
333extern int x11_send(Socket, char *, int);
334extern void *x11_invent_auth(char *, int, char *, int, int);
335extern void x11_free_auth(void *);
336extern void x11_unthrottle(Socket s);
337extern void x11_override_throttle(Socket s, int enable);
338extern int x11_get_screen_number(char *display);
339void x11_get_real_auth(void *authv, char *display);
340char *x11_display(const char *display);
341
342/* Platform-dependent X11 functions */
343extern void platform_get_x11_auth(char *display, int *proto,
344 unsigned char *data, int *datalen);
345extern const char platform_x11_best_transport[];
346/* best X11 hostname for this platform if none specified */
347SockAddr platform_get_x11_unix_address(int displaynum, char **canonicalname);
348/* make up a SockAddr naming the address for displaynum */
349char *platform_get_x_display(void);
350/* allocated local X display string, if any */
351
352Bignum copybn(Bignum b);
353Bignum bn_power_2(int n);
354void bn_restore_invariant(Bignum b);
355Bignum bignum_from_long(unsigned long n);
356void freebn(Bignum b);
357Bignum modpow(Bignum base, Bignum exp, Bignum mod);
358Bignum modmul(Bignum a, Bignum b, Bignum mod);
359void decbn(Bignum n);
360extern Bignum Zero, One;
361Bignum bignum_from_bytes(const unsigned char *data, int nbytes);
362int ssh1_read_bignum(const unsigned char *data, int len, Bignum * result);
363int bignum_bitcount(Bignum bn);
364int ssh1_bignum_length(Bignum bn);
365int ssh2_bignum_length(Bignum bn);
366int bignum_byte(Bignum bn, int i);
367int bignum_bit(Bignum bn, int i);
368void bignum_set_bit(Bignum bn, int i, int value);
369int ssh1_write_bignum(void *data, Bignum bn);
370Bignum biggcd(Bignum a, Bignum b);
371unsigned short bignum_mod_short(Bignum number, unsigned short modulus);
372Bignum bignum_add_long(Bignum number, unsigned long addend);
373Bignum bigmul(Bignum a, Bignum b);
374Bignum bigmuladd(Bignum a, Bignum b, Bignum addend);
375Bignum bigdiv(Bignum a, Bignum b);
376Bignum bigmod(Bignum a, Bignum b);
377Bignum modinv(Bignum number, Bignum modulus);
378Bignum bignum_bitmask(Bignum number);
379Bignum bignum_rshift(Bignum number, int shift);
380int bignum_cmp(Bignum a, Bignum b);
381char *bignum_decimal(Bignum x);
382
383#ifdef DEBUG
384void diagbn(char *prefix, Bignum md);
385#endif
386
387void *dh_setup_group(const struct ssh_kex *kex);
388void *dh_setup_gex(Bignum pval, Bignum gval);
389void dh_cleanup(void *);
390Bignum dh_create_e(void *, int nbits);
391Bignum dh_find_K(void *, Bignum f);
392
393int loadrsakey(const Filename *filename, struct RSAKey *key,
394 char *passphrase, const char **errorstr);
395int rsakey_encrypted(const Filename *filename, char **comment);
396int rsakey_pubblob(const Filename *filename, void **blob, int *bloblen,
397 char **commentptr, const char **errorstr);
398
399int saversakey(const Filename *filename, struct RSAKey *key, char *passphrase);
400
401extern int base64_decode_atom(char *atom, unsigned char *out);
402extern int base64_lines(int datalen);
403extern void base64_encode_atom(unsigned char *data, int n, char *out);
404extern void base64_encode(FILE *fp, unsigned char *data, int datalen, int cpl);
405
406/* ssh2_load_userkey can return this as an error */
407extern struct ssh2_userkey ssh2_wrong_passphrase;
408#define SSH2_WRONG_PASSPHRASE (&ssh2_wrong_passphrase)
409
410int ssh2_userkey_encrypted(const Filename *filename, char **comment);
411struct ssh2_userkey *ssh2_load_userkey(const Filename *filename,
412 char *passphrase, const char **errorstr);
413unsigned char *ssh2_userkey_loadpub(const Filename *filename, char **algorithm,
414 int *pub_blob_len, char **commentptr,
415 const char **errorstr);
416int ssh2_save_userkey(const Filename *filename, struct ssh2_userkey *key,
417 char *passphrase);
418const struct ssh_signkey *find_pubkey_alg(const char *name);
419
420enum {
421 SSH_KEYTYPE_UNOPENABLE,
422 SSH_KEYTYPE_UNKNOWN,
423 SSH_KEYTYPE_SSH1, SSH_KEYTYPE_SSH2,
424 SSH_KEYTYPE_OPENSSH, SSH_KEYTYPE_SSHCOM
425};
426int key_type(const Filename *filename);
427char *key_type_to_str(int type);
428
429int import_possible(int type);
430int import_target_type(int type);
431int import_encrypted(const Filename *filename, int type, char **comment);
432int import_ssh1(const Filename *filename, int type,
433 struct RSAKey *key, char *passphrase, const char **errmsg_p);
434struct ssh2_userkey *import_ssh2(const Filename *filename, int type,
435 char *passphrase, const char **errmsg_p);
436int export_ssh1(const Filename *filename, int type,
437 struct RSAKey *key, char *passphrase);
438int export_ssh2(const Filename *filename, int type,
439 struct ssh2_userkey *key, char *passphrase);
440
441void des3_decrypt_pubkey(unsigned char *key, unsigned char *blk, int len);
442void des3_encrypt_pubkey(unsigned char *key, unsigned char *blk, int len);
443void des3_decrypt_pubkey_ossh(unsigned char *key, unsigned char *iv,
444 unsigned char *blk, int len);
445void des3_encrypt_pubkey_ossh(unsigned char *key, unsigned char *iv,
446 unsigned char *blk, int len);
447void aes256_encrypt_pubkey(unsigned char *key, unsigned char *blk,
448 int len);
449void aes256_decrypt_pubkey(unsigned char *key, unsigned char *blk,
450 int len);
451
452void des_encrypt_xdmauth(unsigned char *key, unsigned char *blk, int len);
453void des_decrypt_xdmauth(unsigned char *key, unsigned char *blk, int len);
454
455/*
456 * For progress updates in the key generation utility.
457 */
458#define PROGFN_INITIALISE 1
459#define PROGFN_LIN_PHASE 2
460#define PROGFN_EXP_PHASE 3
461#define PROGFN_PHASE_EXTENT 4
462#define PROGFN_READY 5
463#define PROGFN_PROGRESS 6
464typedef void (*progfn_t) (void *param, int action, int phase, int progress);
465
466int rsa_generate(struct RSAKey *key, int bits, progfn_t pfn,
467 void *pfnparam);
468int dsa_generate(struct dss_key *key, int bits, progfn_t pfn,
469 void *pfnparam);
470Bignum primegen(int bits, int modulus, int residue, Bignum factor,
471 int phase, progfn_t pfn, void *pfnparam);
472
473
474/*
475 * zlib compression.
476 */
477void *zlib_compress_init(void);
478void zlib_compress_cleanup(void *);
479void *zlib_decompress_init(void);
480void zlib_decompress_cleanup(void *);
481int zlib_compress_block(void *, unsigned char *block, int len,
482 unsigned char **outblock, int *outlen);
483int zlib_decompress_block(void *, unsigned char *block, int len,
484 unsigned char **outblock, int *outlen);
485
486/*
487 * SSH-1 agent messages.
488 */
489#define SSH1_AGENTC_REQUEST_RSA_IDENTITIES 1
490#define SSH1_AGENT_RSA_IDENTITIES_ANSWER 2
491#define SSH1_AGENTC_RSA_CHALLENGE 3
492#define SSH1_AGENT_RSA_RESPONSE 4
493#define SSH1_AGENTC_ADD_RSA_IDENTITY 7
494#define SSH1_AGENTC_REMOVE_RSA_IDENTITY 8
495#define SSH1_AGENTC_REMOVE_ALL_RSA_IDENTITIES 9 /* openssh private? */
496
497/*
498 * Messages common to SSH-1 and OpenSSH's SSH-2.
499 */
500#define SSH_AGENT_FAILURE 5
501#define SSH_AGENT_SUCCESS 6
502
503/*
504 * OpenSSH's SSH-2 agent messages.
505 */
506#define SSH2_AGENTC_REQUEST_IDENTITIES 11
507#define SSH2_AGENT_IDENTITIES_ANSWER 12
508#define SSH2_AGENTC_SIGN_REQUEST 13
509#define SSH2_AGENT_SIGN_RESPONSE 14
510#define SSH2_AGENTC_ADD_IDENTITY 17
511#define SSH2_AGENTC_REMOVE_IDENTITY 18
512#define SSH2_AGENTC_REMOVE_ALL_IDENTITIES 19
513
514/*
515 * Need this to warn about support for the original SSH-2 keyfile
516 * format.
517 */
518void old_keyfile_warning(void);