Documentation » Getting Started » Protocols » SSH » Using Public Keys for Authentication »
PuTTYgen is a key generator. It generates pairs of public and private keys to be used with WinSCP. PuTTYgen generates RSA, DSA, ECDSA, and Ed25519 keys.
PuTTYgen, also known as PuTTY Key Generator is a component of PuTTY, a widely known free and open-source terminal emulator, serial console and network file transfer application that is today used all over the world by advanced users. May 10, 2013 Creating OpenSSH Key using PuTTY Key Gen. You can download PuTTYgen here: http://www.chiark.greenend.org.uk/sgtatham/putty/download.html.
PuTTYgen is included in the WinSCP installation package. You can also download it separately from the WinSCP download page.
PuTTYgen originates from PuTTY and is also part of the PuTTY installation package. It does not matter if you use PuTTYgen from WinSCP or the PuTTY installation package, they are identical.
To start PuTTYgen, go to Tools > PuTTYgen on Login dialog.
Advertisement
When you run PuTTYgen you will see a window where you have two main choices: Generate, to generate a new public/private key pair, or Load to load in an existing private key.
This is a general outline of the procedure for generating a new key pair. The following sections describe the process in more detail.
- First, you need to select which type of key you want to generate, and also select the strength of the key.
- Then press the Generate button, to actually generate the key.
- Once you have generated the key, select a comment field and a passphrase.
- Now you’re ready to save the private key to disk; press the Save private key button.
Your key pair is now ready for use. You may also want to copy the public key to your server, either by copying it out of the Public key for pasting into OpenSSH authorized_keys file box, or by using the Save public key button. However, you don’t need to do this immediately; if you want, you can load the private key back into PuTTYgen later and the public key will be available for copying and pasting again.
For more details refer to guide to setting up public key authentication.
Before generating a key pair using PuTTYgen, you need to select which type of key you need.
The current version of the SSH protocol, SSH-2, supports several different key types. PuTTYgen can generate:
- An RSA key for use with the SSH-2 protocol.
- A DSA key for use with the SSH-2 protocol.
- An ECDSA (elliptic curve DSA) key for use with the SSH-2 protocol.
- An Ed25519 key (another elliptic curve algorithm) for use with the SSH-2 protocol.
PuTTYgen can also generate an RSA key suitable for use with the old SSH-1 protocol (which only supports RSA); for this, you need to select the SSH-1 (RSA) option. Since the SSH-1 protocol is no longer considered secure, it’s rare to need this option.
The Number of bits input box allows you to choose the strength of the key PuTTYgen will generate.
For RSA, 2048 bits should currently be sufficient for most purposes.
For ECDSA, only 256, 384, and 521 bits are supported. (ECDSA offers equivalent security to RSA with smaller key sizes.)
For Ed25519, the only valid size is 256 bits.
Once you have chosen the type of key you want, and the strength of the key, press the Generate button and PuTTYgen will begin the process of actually generating the key.
First, a progress bar will appear and PuTTYgen will ask you to move the mouse around to generate randomness. Wave the mouse in circles over the blank area in the PuTTYgen window, and the progress bar will gradually fill up as PuTTYgen collects enough randomness. You don’t need to wave the mouse in particularly imaginative patterns (although it can’t hurt); PuTTYgen will collect enough randomness just from the fine detail of exactly how far the mouse has moved each time Windows samples its position.
When the progress bar reaches the end, PuTTYgen will begin creating the key. The progress bar will reset to the start, and gradually move up again to track the progress of the key generation. It will not move evenly, and may occasionally slow down to a stop; this is unfortunately unavoidable, because key generation is a random process and it is impossible to reliably predict how long it will take.
When the key generation is complete, a new set of controls will appear in the window to indicate this.
The Key fingerprint Wt.fv.info secret key generated successfully. box shows you a fingerprint value for the generated key. Windows 7 ultimate 64 bit free. This is derived cryptographically from the public key value, so it doesn’t need to be kept secret; it is supposed to be more manageable for human beings than the public key itself.
The fingerprint value is intended to be cryptographically secure, in the sense that it is computationally infeasible for someone to invent a second key with the same fingerprint, or to find a key with a particular fingerprint.
If you have more than one key and use them for different purposes, you don’t need to memorize the key fingerprints in order to tell them apart. PuTTYgen allows you to enter a comment for your key, which will be displayed whenever WinSCP or Pageant asks you for the passphrase.
The default comment format, if you don’t specify one, contains the key type and the date of generation, such as rsa-key-20011212. Another commonly used approach is to use your name and the name of the computer the key will be used on, such as simon@simons-pc.
To alter the key comment, just type your comment text into the Key comment box before saving the private key. If you want to change the comment later, you can load the private key back into PuTTYgen, change the comment, and save it again.
The Key passphrase and Confirm passphrase boxes allow you to choose a passphrase for your key. The passphrase will be used to encrypt the key on disk, so you will not be able to use the key without first entering the passphrase.
![Putty Key Generator Zip Download Putty Key Generator Zip Download](/uploads/1/2/6/5/126518215/354516636.png)
Putty Key File
When you save the key, PuTTYgen will check that the Key passphrase and Confirm passphrase boxes both contain exactly the same passphrase, and will refuse to save the key otherwise.
If you leave the passphrase fields blank, the key will be saved unencrypted. You should not do this without good reason; if you do, your private key file on disk will be all an attacker needs to gain access to any machine configured to accept that key. If you want to be able to passwordless log in without having to type a passphrase every time, you should consider using Pageant so that your decrypted key is only held in memory rather than on disk.
Advertisement
Under special circumstances you may genuinely need to use a key with no passphrase; for example, if you need to run an automated batch script that needs to make an SSH connection, you can’t be there to type the passphrase. In this case we recommend you generate a special key for each specific batch script (or whatever) that needs one, and on the server side you should arrange that each key is restricted so that it can only be used for that specific purpose. The documentation for your SSH server should explain how to do this (it will probably vary between servers).
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 run through a whole dictionary, you should not use a song lyric, quotation or other well-known sentence as a passphrase. 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.
Do not forget your passphrase. There is no way to recover it.
Once you have generated a key, set a comment field and set a passphrase, you are ready to save your private key to disk.
Press the Save private key button. PuTTYgen will put up a dialog box asking you where to save the file. Select a directory, type in a file name, and press Save.
This file is in PuTTY’s native format (
*.PPK
); it is the one you will need to tell WinSCP to use for authentication.If you have started PuTTYgen from SSH > Authentication page of Advanced Site Settings dialog, WinSCP automatically detects the saved key and will insert its path it into Private key file box.
RFC 4716 specifies a standard format for storing SSH-2 public keys on disk. Some SSH servers (such as ssh.com’s) require a public key in this format in order to accept authentication with the corresponding private key. (Others, such as OpenSSH, use a different format)
To save your public key in the SSH-2 standard format, press the Save public key button in PuTTYgen. PuTTYgen will put up a dialog box asking you where to save the file. Select a directory, type in a file name, and press Save.
You will then probably want to copy the public key file to your SSH server machine.
If you use this option with an SSH-1 key, the file PuTTYgen saves will contain exactly the same text that appears in the Public key for pasting box. This is the only existing standard for SSH-1 public keys.
The OpenSSH server, among others, requires your public key to be given to it in a one-line format before it will accept authentication with your private key. (SSH-1 servers also used this method.)
The Public key for pasting into OpenSSH authorized_keys file gives the public-key data in the correct one-line format.
For more details refer to guide to setting up public key authentication.
WinSCP can show you the public key too.
PuTTYgen allows you to load an existing private key file into memory. If you do this, you can then change the passphrase and comment before saving it again; you can also make extra copies of the public key.
To load an existing key, press the Load button. PuTTYgen will display a dialog box where you can browse around the file system and find your key file. Once you select the file, PuTTYgen will ask you for a passphrase (if necessary) and will then display the key details in the same way as if it had just generated the key.
If you use the Load command to load a foreign key format, it will work, but you will see a message box warning you that the key you have loaded is not a PuTTY native key. See below for information about importing foreign key formats.
SSH-2 private keys have no standard format. OpenSSH and ssh.com have different formats, and WinSCP’s is different again. So a key generated with one client cannot immediately be used with another.
Using the Import command from the Conversions menu, PuTTYgen can load SSH-2 private keys in OpenSSH’s format and ssh.com’s format. Once you have loaded one of these key types, you can then save it back out as a PuTTY-format key (
*.PPK
) so that you can use it with the WinSCP. The passphrase will be unchanged by this process (unless you deliberately change it). You may want to change the key comment before you save the key, since some OpenSSH key formats contained no space for a comment, and ssh.com’s default comment format is long and verbose.PuTTYgen can also export private keys in OpenSSH format and in ssh.com format. To do so, select one of the Export options from the Conversions menu. Exporting a key works exactly like saving it – you need to have typed your passphrase in beforehand, and you will be warned if you are about to save a key without a passphrase.
For OpenSSH there are two options. Modern OpenSSH actually has two formats it uses for storing private keys. Export OpenSSH key will automatically choose the oldest format supported for the key type, for maximum backward compatibility with older versions of OpenSSH; for newer key types like Ed25519, it will use the newer format as that is the only legal option. If you have some specific reason for wanting to use OpenSSH’s newer format even for RSA, DSA, or ECDSA keys, you can choose Export OpenSSH key (force new file format).
Most clients for the older SSH-1 protocol use a standard format for storing private keys on disk. PuTTY uses this format as well; so if you have generated an SSH-1 private key using OpenSSH or ssh.com’s client, you can use it with WinSCP, and vice versa. Hence, the export options are not available if you have generated an SSH-1 key.1
You can also use WinSCP
/keygen
command-line switch to convert the private key from other formats.- The text is copy of PuTTY User Manual or was inspired by it.Back
Home |FAQ |Feedback |Licence |Updates |Mirrors |Keys |Links |Team
Download:Stable ·Snapshot |Docs |Changes |Wishlist
PuTTY is a free implementation of SSH and Telnet for Windows and Unixplatforms, along with an
xterm
terminal emulator. It iswritten and maintained primarily bySimon Tatham.The latest version is 0.73.Download it here.
LEGAL WARNING:Use of PuTTY, PSCP, PSFTP and Plink is illegal in countries whereencryption is outlawed. We believe it is legal to use PuTTY, PSCP,PSFTP and Plink in England and Wales and in many other countries, butwe are not lawyers, and so if in doubt you should seek legal advicebefore downloading it. You may find useful information atcryptolaw.org, which collectsinformation on cryptography laws in many countries, but wecan't vouch for its correctness.
Use of the Telnet-only binary (PuTTYtel) is unrestricted by anycryptography laws.
Latest news
2019-09-29 PuTTY 0.73 released
PuTTY 0.73, released today, is a bug-fix release. It fixes a small number of bugs since 0.72, and a couple of them have potential security implications.
2019-07-20 PuTTY 0.72 released
PuTTY 0.72, released today, is a bug-fix release. It fixes a smallnumber of further security issues found by the 2019 EU-fundedHackerOne bug bounty, and a variety of other bugs introduced in 0.71.
2019-07-08 Bug bounty concluded
The EU-funded bug bounty programme is now closed. Many thanks toeverybody who sent in reports!
Anyone with a vulnerability to report should now go back to reportingit in the old way, via email to the PuTTY team, as described on theFeedback page.If you think it needs to be reported confidentially, encrypt it withour Secure Contact Key.
2019-03-25 Bug bounty continues
This year's EU-funded bug bounty programme is stillrunning. It was originally scheduled to end on 7th March, butthere was money left over in the budget. So while that money lasts,you still have a chance to earn some by finding vulnerabilities inPuTTY 0.71 or the development snapshots!
As before, vulnerabilities should be reported through theHackerOne web sitein order to qualify for a bounty: if you send reports directly to thePuTTY team in the usual way, then we'll still fix them, but we can'tprovide money for them.
2019-03-16 PuTTY 0.71 released
PuTTY 0.71, released today, includes a large number of security fixes,many of which were found by the recent EU-funded HackerOne bug bounty.There are also other security enhancements (side-channel resistance),and a few new features.It's also the first release to be built for Windows on Arm.
2019-01-18 EU bug bounty for finding vulnerabilities in PuTTY
From now until 7th March, you can earn money by reporting securityvulnerabilities in PuTTY!
HackerOne is running a bugbounty programme for PuTTY, funded by the European Union as partof the ‘Free and Open Source Software Audit’ project(EU-FOSSA 2). If you report a vulnerability through their web site, itmay qualify for a bounty. (The exact amount will depend on how seriousthe problem is, and there's also a bonus for providing a patch thatfixes it.)
Putty Key Generator Download
For more details, or if you have something to report, see the linkabove.
(Please note that HackerOne will only consider vulnerabilitiesreported to them. If you send a report directly to the PuTTYteam in the usual way, then of course we'll still fix it, but we can'talso arrange for you to get paid.)
2018-08-25 GPG key rollover
![Generator Generator](/uploads/1/2/6/5/126518215/847640696.jpg)
This week we've generated a fresh set of GPG keys for signing PuTTYrelease and snapshot builds. We will begin signing snapshots with thenew snapshot key, and future releases with the new release key. Thenew master key is signed with the old master keys, of course. Seethe keys page for more information.
2017-07-08 PuTTY 0.70 released, containing security and bug fixes
PuTTY 0.70, released today, fixes further problems with Windows DLLhijacking, and also fixes a small number of bugs in 0.69, includingbroken printing support and Unicode keyboard input on Windows.
Download Putty Generator
Site map
- Licence conditions under which you mayuse PuTTY.
- The FAQ.
- The documentation.
- Download PuTTY:
- latest release 0.73
- Subscribe to the PuTTY-announcemailing list to be notified of new releases.
- Feedback and bug reporting: contactaddress and guidelines. Please read the guidelines beforesending us mail; we get a very large amount of mail and it will helpus answer you more quickly.
- Changes in recent releases.
- Wish list and list of known bugs.
- Links to related software andspecifications elsewhere.
- A page about the PuTTY team members.