ssh-keygen - Creation, management, and conversion of keys used for client and server authentication.
ssh-keygen [-b bits] [-c comment] [-D private_key]
[-e private_key] [-F key] [-h] [-H key] [-i key]
[-N new_passphrase] [-o key_name] [-O key_file] [-p passphrase]
[-P] [-q] [-t key_type] [-V] [key_name1 key_name2 ...]
Use ssh-keygen to create RSA and DSA keys for public key authentication, to edit the properties of existing keys, and to convert key file formats for compatibility with other Secure Shell implementations.
When no options are specified, ssh-keygen generates a 2048-bit RSA key pair and queries you for a passphrase to protect the private key. If you don't specify a file name on the command line, keys are created in $HOME/.ssh2/ and given a default name that identifies the key type and size (for example /home/joe/.ssh2/id_dsa_2048_a). If you specify a file name, keys are saved to the current working directory unless you include a fully qualified path name. For each private key you create, ssh-keygen also generates a public key. Public keys are given the same base name as the private key, with an added .pub extension (for example id_dsa_2048_a.pub).
Reflection for Secure IT public keys use SECSH format. Private keys use PEM-encoded PKCS#8 format.
If you use Secure Shell public keys to authenticate client users, you need to configure both the client and the server. On the client, generate the key and then add a line for this key to the client identification file ($HOME/.ssh2/identification). This file lists the keys the client presents for authentication. For details see FILES in ssh(1). On the server, copy each client user's public key to that user's Secure Shell directory ($HOME/.ssh2) and add the key to the user's authorization file ($HOME/.ssh2/authorization by default). This file lists the keys the server accepts for user authentication. For details see FILES in sshd(8).
The server installation package checks to see if an existing host key pair is already present. If no host key is found, the package creates a new host key pair and the server uses this pair for host authentication. If a host key already exists in /etc/ssh2, Reflection for Secure IT uses this key. If an OpenSSH host key is found in /etc/ssh, Reflection for Secure IT migrates the key to the correct format and location and uses the migrated key. Use ssh-keygen if you need to replace an existing host key. Use the -P option when you create a new host key pair; host keys should not be passphrase-protected. Note that when you replace your host key, the host will no longer be recognized as a trusted host by clients who had the previous host key in their known hosts key list.
Options are available in both a single-character form (such as -b) and a descriptive equivalent (--bits). Single characters are shown here. To view the descriptive equivalents, use the -h command line option.
Specifies the key size. Up to a point a larger key size improves security. A larger key size slows down the initial connection, but has no effect on the speed of encryption or decryption of the data stream after a successful connection has been made. The length of key you should use depends on many factors, including: the key type, the lifetime of the key, the value of the data being protected, the resources available to a potential attacker, and the size of the symmetric key you use in conjunction with this asymmetric key. To ensure the best choice for your needs, we recommend that you contact your security officer. The default for DSA keys is 1024 bits and for RSA keys is 2048 bits. The minimum allowed value is 512. The maximum allowed value is 32768.
Specifies information for the comment field within the key file. Use quotation marks if the string includes spaces. If you do not specify a comment, a default comment is created that includes the key type, creator, date, and time. Note: The comment is displayed when a passphrase-protected key is used for client authentication. Don't store passphrases or other sensitive information in the comment.
Uses the specified private key to derive a new copy of the public key.
Changes the passphrase of the specified private key. When you use this option alone you will be queried for the old and new passphrase for the specified private key. To edit the passphrase without opening an interactive session, you can use this option in combination with -p and-N. To change to a null passphrase, you can use this option in combination with -P.
Displays the fingerprint of the specified key in Bubble Babble format.
Displays a brief summary of command options.
Uses the specified Reflection public key to generate a public key in OpenSSH format. The converted key is created using the same base file name with an added .ssh extension. You can use the key that is created to configure public key client authentication on an OpenSSH server.
Displays information about the specified key.
Changes the passphrase to the specified new passphrase. Use this option is combination with -e.
Specifies the file name to be used for the generated private key. (A public key is also created and is always given the same name as the private key, with an added .pub file extension.) Note: An alternate way of naming key files is to specify one or more key file names at the end of the ssh-keygen command.
Uses the specified OpenSSH public or private key to create a public or private key in Reflection format. The converted key is created using the same base file name with an added .ssh2 extension.
Specifies a passphrase. Use quotation marks if the phrase includes spaces. This option creates the initial passphrase when you generate a new key. If you are managing an existing key, use this option to specify the passphrase that protects that key. If a passphrase is required and you don't use -p, you'll be prompted for the passphrase.
Creates a key with no passphrase. You can use this option to create keys for server authentication. Passphrases are recommended for client keys.
Hides the key generation progress indicator.
Specifies the algorithm used for key generation. Possible values are "rsa" and "dsa".
Displays ssh-keygen version information.
Specifies the file name (or names) to be used for the generated private key (or keys). The public key is created using the same name with a ".pub" file extension.
The default location and naming convention used for private keys generated by ssh-keygen. For example:
The default location and naming convention used for public keys generated by ssh-keygen. For example:
The default private key of the public/private key pair used to identify the server to clients.
The default public key of the public/private key pair used to authenticate the server to clients.
To generate three 1024-bit dsa key pairs using the specified key names. With this command, you'll be prompted in sequence for passphrases for each key and the key pairs will be created in the current working directory.
ssh-keygen -b 1024 -t dsa key1 key2 key3
To change the passphrase of the specified protected key without entering into an interactive session:
ssh-keygen -p "old pass" -N "new pass" -e keyname
Copyright (C) 2008 Attachmate Corporation
ssh(1), ssh2_config(5), scp(1), sftp(1), ssh-add(1), ssh-agent(1), sshd(8), sshd2_config(5)
Additional Reflection for Secure IT documentation is available online from the Attachmate documentation web page:
And from the technical note library: