nhyatt/putty-source
1
0
Fork 0
mirror of https://git.tartarus.org/simon/putty.git synced 2025-07-02 12:02:47 -05:00
Code Issues Projects Releases Wiki Activity

Editorial policy change: I've decided that it's better to use \q

Browse Source 
than \e when describing button names and menu items: the "Foo"
button rather than the _Foo_ button. Certainly consistent use of
either is better than the mixed use of both we had before :-)

[originally from svn r1420]
This commit is contained in:
Simon Tatham
2001-11-25 17:32:39 +00:00
parent b7efa34942
commit 17f54e4c3d
5 changed files with 54 additions and 53 deletions
Download Patch File Download Diff File Expand all files Collapse all files

37
doc/pubkey.but
View File

@ -1,4 +1,4 @@
\versionid $Id: pubkey.but,v 1.9 2001/11/25 17:14:00 simon Exp $
\versionid $Id: pubkey.but,v 1.10 2001/11/25 17:32:39 simon Exp $
\# FIXME: passphrases, examples (e.g what does a key for pasting into
\# authorized_keys look like?), index entries, links.
@ -99,32 +99,33 @@ authentication agent, Pageant (see \k{pageant}). PuTTYgen generates
RSA keys.
When you run PuTTYgen you will see a window where you have two
choices: \e{Generate} new public/private key pair or \e{Load} an
existing private key.
choices: \q{Generate}, to generate a new public/private key pair, or
\q{Load} to load in an existing private key.
\S{pubkey-puttygen-generate} Generate a new key
Before generating a new key you have to choose the strength of the
encryption, and the type of the key (see \k{pubkey-types}). With
\e{Parameters} you define the strength of the key. The default of
\q{Parameters} you define the strength of the key. The default of
1024 should be OK for most users.
Pressing the \e{Generate} button starts the process of generating a
Pressing the \q{Generate} button starts the process of generating a
new key pair. You then have to move the mouse over the blank area in
order to generate random data for the algorithm. Continue until the
progress bar is complete.
As soon as enough random data is available the key is generated. This
may take a little while, especially on slow machines. Once the key is
generated, its details appear in the \e{Key} part of the PuTTYgen
generated, its details appear in the \q{Key} part of the PuTTYgen
window.
Now you can change the \e{Key comment} to something more meaningful
than the default (which is based on the current date). e.g. add the
name of the host you will use it for. When using multiple keys a
meaningful comment may help you remember which passphrase to use! You
should always enter a \e{Key passphrase} and \e{Confirm passphrase} to
protect your keys.
Now you can change the \q{Key comment} field to something more
meaningful than the default (which is based on the current date).
e.g. add the name of the host you will use it for. When using
multiple keys a meaningful comment may help you remember which
passphrase to use! You should always enter a passphrase in the
\q{Key passphrase} and \q{Confirm passphrase} fields, to protect
your keys.
(Choosing a good passphrase is difficult. Just as you shouldn't use
a dictionary word as a password because it's easy for an attacker to
@ -137,17 +138,17 @@ scheme. If you want your passphrase to make grammatical sense, this
cuts down the possibilities a lot and you should use a longer one as
a result.)
Finally save the key by pressing the \e{Save} button. Do not close the
Finally save the key by pressing the \q{Save} button. Do not close the
window but proceed with step \k{pubkey-gettingready}, otherwise you
will have to \e{Load} the private key again as described below.
will have to load the private key again (as described below).
\S{pubkey-puttygen-load} Load and modify a key
PuTTYgen does not store the public key in a file by default. If you
have to distribute the public key you can press the \e{Load} button,
have to distribute the public key you can press the \q{Load} button,
select the private key file, and PuTTYgen will give you the public key
again. You can also change the comment and passphrase for your
private key this way. Just modify the values and \e{Save} the key.
private key this way. Just modify the values and save the key.
\S{pubkey-gettingready} Getting ready for public key authentication
@ -160,7 +161,7 @@ accept your public key for authentication:
into the \c{.ssh} directory and open the file \c{authorized_keys}
with your favorite editor. (You may have to create this file if this
is the first key you have put in it). Then switch to the PuTTYgen
window, select all of the text in the \e{Public key for pasting into
window, select all of the text in the \q{Public key for pasting into
authorized_keys file} box, and copy it to the clipboard
(\c{Ctrl+C}). Then, switch back to the PuTTY window and insert the
data into the open file, making sure it ends up all on one line.
@ -183,6 +184,6 @@ that server.
From now on you should be able to use the private key for
authentication to this host. Either select the private key in
PuTTY's \e{Connection}, \e{SSH} panel: \e{Private key file for
PuTTY's \q{Connection}, \q{SSH} panel: \q{Private key file for
authentication} dialog or use it with Pageant as described in
\k{pageant}.