Differences
This shows you the differences between the selected revisions of the page.
| ui_login_authentication 2024-02-01 | ui_login_authentication 2026-04-02 (current) | ||
| Line 20: | Line 20: | ||
| ===== Authentication Options ===== | ===== Authentication Options ===== | ||
| - | ==== Attempt Authentication Using Pageant ==== | + | ==== Attempt Authentication Using Agent ==== |
| - | If this option is enabled, then WinSCP will look for [[ui_pageant|Pageant]] and attempt to authenticate with any suitable public keys Pageant currently holds. | + | If this option is enabled, then WinSCP will look for an authentication agent and attempt to authenticate with any suitable public keys the agent currently holds (You can [[ui_pref_security#authentication|configure]], if WinSCP uses Pageant or OpenSSH ssh-agent). |
| This behavior is almost always desirable, and is therefore enabled by default. In rare cases you might need to turn it off in order to force authentication by some non-public-key method such as passwords. ((&puttydoccite)) | This behavior is almost always desirable, and is therefore enabled by default. In rare cases you might need to turn it off in order to force authentication by some non-public-key method such as passwords. ((&puttydoccite)) | ||
| Line 50: | Line 50: | ||
| The passphrase 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. | The passphrase 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. If certificate file with the same name·(but ''-cert.pub'' suffix) is found, it will be automatically added to the converted key file. | + | 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. If certificate file with the same name((but ''-cert.pub'' or ''.pub-aadcert.pub'' suffixes.)) is found, it will be automatically added to the converted key file. |
| === [[private_key_tools]] Private Key Tools === | === [[private_key_tools]] Private Key Tools === | ||
| Line 58: | Line 58: | ||
| The command //Tools > Generate New Key Pair with PuTTYgen// starts [[ui_puttygen|PuTTYgen]], in which you can [[ui_puttygen#generating|generate a new private key pair]]. After you [[ui_puttygen#saving_private|save your new key pair]] in PuTTYgen, WinSCP will detect it and automatically insert a path to the new key file into //Private key file// box. | The command //Tools > Generate New Key Pair with PuTTYgen// starts [[ui_puttygen|PuTTYgen]], in which you can [[ui_puttygen#generating|generate a new private key pair]]. After you [[ui_puttygen#saving_private|save your new key pair]] in PuTTYgen, WinSCP will detect it and automatically insert a path to the new key file into //Private key file// box. | ||
| - | Use the command //Tools > Install Public Key into Server// to [[guide_public_key#configure_openssh|install a public key into OpenSSH server]]. You will be prompted to select key pair to install. You will need to authenticate to the server to install the key. You can authenticate using a password or using another key (select it in //Private key file// box). After installing succeeds, the new private key will be inserted into the //Private key file// box. | + | Use the command //Tools > Install Public Key into Server// to [[guide_public_key#configure_openssh|install a public key into OpenSSH server]]. You will be prompted to select key pair to install.((You can also select public key file in OpenSSH ''authorized_keys'' file format.)) You will need to authenticate to the server to install the key. You can authenticate using a password or using another key (select it in //Private key file// box). After installing succeeds, the new private key will be inserted into the //Private key file// box. |
| ==== [[certificate]] Certificate to use with the private key ==== | ==== [[certificate]] Certificate to use with the private key ==== | ||