-\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.
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
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
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.
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}.
~mdw / sgt / putty / blobdiff