1
0
mirror of https://git.tartarus.org/simon/putty.git synced 2025-01-09 17:38:00 +00:00
putty-source/windows
Simon Tatham d515e4f1a3 Support GSS key exchange, for Kerberos 5 only.
This is a heavily edited (by me) version of a patch originally due to
Nico Williams and Viktor Dukhovni. Their comments:

 * Don't delegate credentials when rekeying unless there's a new TGT
   or the old service ticket is nearly expired.

 * Check for the above conditions more frequently (every two minutes
   by default) and rekey when we would delegate credentials.

 * Do not rekey with very short service ticket lifetimes; some GSSAPI
   libraries may lose the race to use an almost expired ticket. Adjust
   the timing of rekey checks to try to avoid this possibility.

My further comments:

The most interesting thing about this patch to me is that the use of
GSS key exchange causes a switch over to a completely different model
of what host keys are for. This comes from RFC 4462 section 2.1: the
basic idea is that when your session is mostly bidirectionally
authenticated by the GSSAPI exchanges happening in initial kex and
every rekey, host keys become more or less vestigial, and their
remaining purpose is to allow a rekey to happen if the requirements of
the SSH protocol demand it at an awkward moment when the GSS
credentials are not currently available (e.g. timed out and haven't
been renewed yet). As such, there's no need for host keys to be
_permanent_ or to be a reliable identifier of a particular host, and
RFC 4462 allows for the possibility that they might be purely
transient and only for this kind of emergency fallback purpose.

Therefore, once PuTTY has done a GSS key exchange, it disconnects
itself completely from the permanent host key cache functions in
storage.h, and instead switches to a _transient_ host key cache stored
in memory with the lifetime of just that SSH session. That cache is
populated with keys received from the server as a side effect of GSS
kex (via the optional SSH2_MSG_KEXGSS_HOSTKEY message), and used if
later in the session we have to fall back to a non-GSS key exchange.
However, in practice servers we've tested against do not send a host
key in that way, so we also have a fallback method of populating the
transient cache by triggering an immediate non-GSS rekey straight
after userauth (reusing the code path we also use to turn on OpenSSH
delayed encryption without the race condition).
2018-04-26 07:21:16 +01:00
..
installer.wxs Use / in pathnames in the Wix installer source. 2017-05-25 08:22:22 +01:00
pageant.ico Tweak the icon script, and the generated icons, to more closely 2007-01-07 10:17:12 +00:00
pageant.mft Make manifest files work with 64bit builds of PuTTY. 2015-08-15 13:54:44 +01:00
pageant.rc Pageant and PuTTYgen About boxes: add the website button. 2017-02-22 07:06:00 +00:00
pageants.ico Tweak the icon script, and the generated icons, to more closely 2007-01-07 10:17:12 +00:00
plink.rc `win-versioninfo': all builds of all Windows binaries now contain 2005-10-04 14:13:28 +00:00
pscp.ico Tweak the icon script, and the generated icons, to more closely 2007-01-07 10:17:12 +00:00
pscp.rc `win-versioninfo': all builds of all Windows binaries now contain 2005-10-04 14:13:28 +00:00
psftp.rc `win-versioninfo': all builds of all Windows binaries now contain 2005-10-04 14:13:28 +00:00
putty.ico Tweak the icon script, and the generated icons, to more closely 2007-01-07 10:17:12 +00:00
putty.iss Update version number for 0.70 release. 2017-07-04 20:29:54 +01:00
putty.mft Make manifest files work with 64bit builds of PuTTY. 2015-08-15 13:54:44 +01:00
putty.rc `win-versioninfo': all builds of all Windows binaries now contain 2005-10-04 14:13:28 +00:00
puttycfg.ico Tweak the icon script, and the generated icons, to more closely 2007-01-07 10:17:12 +00:00
puttygen.ico Tweak the icon script, and the generated icons, to more closely 2007-01-07 10:17:12 +00:00
puttygen.mft Make manifest files work with 64bit builds of PuTTY. 2015-08-15 13:54:44 +01:00
puttygen.rc Pageant and PuTTYgen About boxes: add the website button. 2017-02-22 07:06:00 +00:00
puttyins.ico `installer.ico' doesn't fit into 8.3, so gets truncated to INSTALLE.ICO in 2007-02-06 22:39:15 +00:00
puttytel.rc `win-versioninfo': all builds of all Windows binaries now contain 2005-10-04 14:13:28 +00:00
rcstuff.h Remove Makefile.bor. 2017-09-13 19:26:28 +01:00
README-msi.txt Switch chiark URLs to https. 2017-05-07 16:29:01 +01:00
README.txt Switch chiark URLs to https. 2017-05-07 16:29:01 +01:00
sizetip.c Sprinkle some header comments in various files in an attempt to explain what 2006-04-23 18:26:03 +00:00
version.rc2 Stop copying the licence text into C source code. 2016-02-29 19:59:35 +00:00
website.url Switch chiark URLs to https. 2017-05-07 16:29:01 +01:00
win_res.h Use readonly edit controls in some Windows dialogs. 2016-02-29 19:59:35 +00:00
win_res.rc2 Expand the About box. 2017-07-04 19:35:18 +01:00
wincapi.c Coverity build fixes. 2017-06-20 19:02:48 +01:00
wincapi.h Make our process's ACL more restrictive. 2016-02-29 19:59:34 +00:00
wincfg.c Document 'Permit control characters in pasted text' 2018-03-24 15:35:46 +00:00
wincons.c Windows Plink: treat EOF at host key prompt as 'abort connection'. 2017-02-15 06:03:50 +00:00
winctrls.c A small pile of Windows compiler-warning fixes. 2017-12-10 09:22:22 +00:00
windefs.c Turn 'Filename' into a dynamically allocated type with no arbitrary 2011-10-02 11:01:57 +00:00
windlg.c Add missing casts in dupcat(). 2018-02-13 19:45:54 +00:00
window.c Add GUI configuration for choice of clipboards. 2017-12-17 17:02:56 +00:00
wingss.c Support GSS key exchange, for Kerberos 5 only. 2018-04-26 07:21:16 +01:00
winhandl.c Fix an EOF-testing goof in winhandl.c. 2017-02-03 19:33:50 +00:00
winhelp.c A small pile of Windows compiler-warning fixes. 2017-12-10 09:22:22 +00:00
winhelp.h Support GSS key exchange, for Kerberos 5 only. 2018-04-26 07:21:16 +01:00
winhsock.c A small pile of Windows compiler-warning fixes. 2017-12-10 09:22:22 +00:00
winjump.c Add automatic type-checking to GET_WINDOWS_FUNCTION. 2017-04-11 18:56:55 +01:00
winmisc.c Better file-existence test on Windows. 2018-02-07 20:05:32 +00:00
winnet.c A small pile of Windows compiler-warning fixes. 2017-12-10 09:22:22 +00:00
winnoise.c Been meaning to get round to this for a while: use CryptGenRandom to 2013-07-20 08:34:54 +00:00
winnojmp.c Fix up svn:eol-style and svn:keywords on new files. 2010-12-27 00:24:48 +00:00
winnpc.c Merge branch 'pre-0.67' 2016-02-29 19:59:59 +00:00
winnps.c In GUI PuTTY, log standard error from local proxy commands. 2015-11-22 15:11:00 +00:00
winpgen.c Switch chiark URLs to https. 2017-05-07 16:29:01 +01:00
winpgnt.c Add a -restrict-putty-acl option to Windows Pageant. 2017-09-20 18:24:34 +01:00
winpgntc.c Remove duplicate definition of AGENT_MAX_MSGLEN. 2017-01-30 19:42:28 +00:00
winplink.c A small pile of Windows compiler-warning fixes. 2017-12-10 09:22:22 +00:00
winprint.c Seek all Windows print functions in winspool.drv. 2017-06-15 23:37:16 +01:00
winproxy.c Add an assortment of missing frees and closes. 2017-02-14 22:14:25 +00:00
winsecur.c clang-specific pragmas to suppress -Wmissing-braces. 2017-02-05 11:53:58 +00:00
winsecur.h Turn off Windows process ACL restriction by default. 2017-01-29 23:08:19 +00:00
winser.c Add an assortment of missing frees and closes. 2017-02-14 22:14:25 +00:00
winsftp.c windows: Remove spurious redeclarations of select_result(). 2017-05-14 16:34:48 +01:00
winshare.c Rename Makefile.cyg to Makefile.mgw. 2016-04-10 15:10:45 +01:00
winstore.c A bunch of further warning fixes in the Windows code. 2017-02-03 19:37:59 +00:00
winstuff.h Add GUI configuration for choice of clipboards. 2017-12-17 17:02:56 +00:00
wintime.c wintime: add a precautionary memset to zero. 2017-02-14 23:25:25 +00:00
winucs.c Reformat the composetbl[] array in winucs.c. 2017-04-08 15:10:57 +01:00
winutils.c Remove assorted dead code. 2017-02-14 22:18:01 +00:00
winx11.c Post-release destabilisation! Completely remove the struct type 2011-07-14 18:52:21 +00:00

PuTTY README
============

This is the README file for the PuTTY installer distribution. If
you're reading this, you've probably just run our installer and
installed PuTTY on your system.

What should I do next?
----------------------

If you want to use PuTTY to connect to other computers, or use PSFTP
to transfer files, you should just be able to run them from the
Start menu.

If you want to use the command-line-only file transfer utility PSCP,
you will probably want to put the PuTTY installation directory on
your PATH. On Windows 7 and similar versions, you can do this at
Control Panel > System and Security > System > Advanced system
settings > Environment Variables.

Some versions of Windows will refuse to run HTML Help files (.CHM)
if they are installed on a network drive. If you have installed
PuTTY on a network drive, you might want to check that the help file
works properly. If not, see http://support.microsoft.com/kb/896054
for information on how to solve this problem.

What do I do if it doesn't work?
--------------------------------

The PuTTY home web site is

    https://www.chiark.greenend.org.uk/~sgtatham/putty/

Here you will find our list of known bugs and pending feature
requests. If your problem is not listed in there, or in the FAQ, or
in the manuals, read the Feedback page to find out how to report
bugs to us. PLEASE read the Feedback page carefully: it is there to
save you time as well as us. Do not send us one-line bug reports
telling us `it doesn't work'.