Differences
This shows you the differences between the selected revisions of the page.
2016-04-01 | 2016-04-01 | ||
updating from putty doc (martin) | updating from putty doc (Support using public-only key files.) (martin) | ||
Line 52: | Line 52: | ||
==== [[private_key]] Private key file ==== | ==== [[private_key]] Private key file ==== | ||
- | Use the //Private key file// box to specify [[local_path|local path]] to your [[public_key#private|private key file]] if you are going to use [[public_key|public key authentication]]. The file must be in [[public_key#private|PuTTY format]]. If the private key is passphrase-protected, you will be [[ui_authenticate#private_key_passphrase|prompted for passphrase]] once the authentication begins. If you have your private keys loaded into [[ui_pageant|Pageant]], leave the box blank, unless you want to ensure that only that particular key is used for authentication. | + | Use the //Private key file// box to specify [[local_path|local path]] to your [[public_key#private|private key file]] if you are going to use [[public_key|public key authentication]]. The file must be in [[public_key#private|PuTTY format]]. If the private key is passphrase-protected, you will be [[ui_authenticate#private_key_passphrase|prompted for passphrase]] once the authentication begins. |
- | The passphase cannot be entered in advance on Login dialog and thus it cannot be saved to [[session_configuration#site|site]]. If you need to login to server automatically without prompt, generate key without passphrase. Use this method carefully and only under special circumstances. | + | You can use [[ui_pageant|Pageant]] so that you do not need to explicitly configure a key here. |
+ | |||
+ | If a private key file is specified here with Pageant running, WinSCP will first try asking Pageant to authenticate with that key, and ignore any other keys Pageant may have. If that fails, WinSCP will ask for a passphrase as normal. You can also specify a public key file in this case (in RFC 4716 or OpenSSH format), as that's sufficient to identify the key to Pageant, but of course if Pageant isn't present WinSCP can't fall back to using this file itself. &beta_feature | ||
+ | |||
+ | The passphase cannot be entered in advance in session settings and thus it cannot be saved to [[session_configuration#site|site]]. If you need to login to server automatically without prompt, generate a key without passphrase. Use this method carefully and only under special circumstances. | ||
If you select a key file in a different format (OpenSSH or ssh.com), WinSCP will offer you to convert the key to PuTTY format. &beta_feature | If you select a key file in a different format (OpenSSH or ssh.com), WinSCP will offer you to convert the key to PuTTY format. &beta_feature | ||
+ | |||
===== GSSAPI ===== | ===== GSSAPI ===== |