1
0
mirror of https://git.tartarus.org/simon/putty.git synced 2025-01-09 17:38:00 +00:00
putty-source/doc
Simon Tatham 08d17140a0 Introduce PPK file format version 3.
This removes both uses of SHA-1 in the file format: it was used as the
MAC protecting the key file against tamperproofing, and also used in
the key derivation step that converted the user's passphrase to cipher
and MAC keys.

The MAC is simply upgraded from HMAC-SHA-1 to HMAC-SHA-256; it is
otherwise unchanged in how it's applied (in particular, to what data).

The key derivation is totally reworked, to be based on Argon2, which
I've just added to the code base. This should make stolen encrypted
key files more resistant to brute-force attack.

Argon2 has assorted configurable parameters for memory and CPU usage;
the new key format includes all those parameters. So there's no reason
we can't have them under user control, if a user wants to be
particularly vigorous or particularly lightweight with their own key
files. They could even switch to one of the other flavours of Argon2,
if they thought side channels were an especially large or small risk
in their particular environment. In this commit I haven't added any UI
for controlling that kind of thing, but the PPK loading function is
all set up to cope, so that can all be added in a future commit
without having to change the file format.

While I'm at it, I've also switched the CBC encryption to using a
random IV (or rather, one derived from the passphrase along with the
cipher and MAC keys). That's more like normal SSH-2 practice.
2021-02-20 16:57:47 +00:00
..
blurb.but Acknowledge Unix pageant. 2019-03-18 23:09:24 +00:00
chm.css Minor style tweaks for the CHM. 2006-12-19 10:28:44 +00:00
config.but Merge the 0.74 release branch back to master. 2020-06-27 08:11:22 +01:00
errors.but Whitespace rationalisation of entire code base. 2019-09-08 20:29:21 +01:00
faq.but Documentation for SUPDUP. 2020-03-10 07:11:32 +00:00
feedback.but Discourage unnecessary use of Secure Contact key. 2019-11-22 09:21:43 +00:00
gs.but Rewrite "Getting started / Logging in". 2019-04-19 12:08:31 +01:00
index.but Documentation for SUPDUP. 2020-03-10 07:11:32 +00:00
intro.but Documentation for SUPDUP. 2020-03-10 07:11:32 +00:00
Makefile Move PPK format documentation into a manual appendix. 2021-02-15 18:48:34 +00:00
man-pageant.but Rename manpage sources in the doc subdirectory. 2020-12-13 12:36:38 +00:00
man-plink.but Rename manpage sources in the doc subdirectory. 2020-12-13 12:36:38 +00:00
man-pscp.but Document -logoverwrite and -logappend. 2020-11-25 15:12:56 +00:00
man-psftp.but Rename manpage sources in the doc subdirectory. 2020-12-13 12:36:38 +00:00
man-psusan.but psusan: write a man page. 2020-12-13 12:36:38 +00:00
man-pterm.but Rename manpage sources in the doc subdirectory. 2020-12-13 12:36:38 +00:00
man-putty.but Rename manpage sources in the doc subdirectory. 2020-12-13 12:36:38 +00:00
man-puttygen.but Rename manpage sources in the doc subdirectory. 2020-12-13 12:36:38 +00:00
man-puttytel.but Rename manpage sources in the doc subdirectory. 2020-12-13 12:36:38 +00:00
mancfg.but Now that Halibut is capable of generating man pages better than I 2004-03-24 19:36:04 +00:00
manpages.but Now that Halibut is capable of generating man pages better than I 2004-03-24 19:36:04 +00:00
pageant.but Docs: talk about SSH-2 before SSH-1. 2019-04-19 15:49:05 +01:00
pgpkeys.but Remove most traces of WinHelp support. 2019-03-26 00:27:04 +00:00
plink.but Document -logoverwrite and -logappend. 2020-11-25 15:12:56 +00:00
pscp.but Document -logoverwrite and -logappend. 2020-11-25 15:12:56 +00:00
psftp.but File transfer tools: sanitise remote filenames and stderr. 2019-02-20 07:27:22 +00:00
pubkey.but Minimally document key generation novelties. 2020-03-02 23:36:09 +00:00
pubkeyfmt.but Introduce PPK file format version 3. 2021-02-20 16:57:47 +00:00
site.but Hmm, that relative link wasn't too good. Try a more helpful one. 2003-10-30 10:41:59 +00:00
sshnames.but Cross-reference the description of winadj@putty.projects.tartarus.org 2014-10-21 11:33:33 +00:00
udp.but Clarify wording in the new traits section. 2021-01-17 09:18:42 +00:00
using.but Document -logoverwrite and -logappend. 2020-11-25 15:12:56 +00:00
vids.but Rework versioning system to not depend on Subversion. 2014-09-24 10:33:13 +00:00