Differences

This shows you the differences between the selected revisions of the page.

ui_import 2017-06-28 ui_import 2023-05-24 (current)
Line 1: Line 1:
====== Importing Sites ====== ====== Importing Sites ======
-WinSCP allows you to import sites from [[&url(putty)|PuTTY SSH client]], [[https://filezilla-project.org/|FileZilla FTP client]] and host keys from OpenSSH ''known_hosts'' file (&beta_feature).+WinSCP allows you to import sites from [[&url(putty)|PuTTY SSH client]], [[https://www.9bis.net/kitty/|KiTTY SSH client]], [[https://filezilla-project.org/|FileZilla FTP/SFTP client]], OpenSSH ''config'' file and host keys from OpenSSH ''known_hosts'' file.
&screenshotpict(import) &screenshotpict(import)
Line 7: Line 7:
To open //Import session// dialog go to //Tools > Import Sites// on [[ui_login|Login dialog]]. To open //Import session// dialog go to //Tools > Import Sites// on [[ui_login|Login dialog]].
-On the dialog, select if you want to import from PuTTY, FileZilla or ''known_hosts''.+On the dialog, select if you want to import from PuTTY, KiTTY, FileZilla, OpenSSH ''config'' or ''known_hosts'' files.
-You will receive list of all sites/host keys stored in the selected application. Next to each site name there is a checkbox. Use it to select sites/keys you would like to import. By default WinSCP selects only sites with supported protocol·((It does not select Raw, Telnet, Rlogin and Serial sessions from PuTTY.)), for which there is no WinSCP site with the same name. You can alter the selection as you like. +You will receive list of all sites/host keys stored in the selected application or configuration file. Next to each site name there is a checkbox. Use it to select sites/keys you would like to import. By default WinSCP selects only sites with supported protocol,((It does not select Serial, Telnet, Rlogin, SUPDUP, Raw and Bare ssh-connection sessions from PuTTY/KiTTY.)) for which there is no WinSCP site with the same name. You can alter the selection as you like.
-For PuTTY, WinSCP looks for sites in registry. If you use PuTTY clone, you can configure WinSCP to look for [[ui_pref_integration_app|its registry keys]] instead.+===== PuTTY/KiTTY ===== 
 + 
 +For PuTTY/KiTTY, WinSCP looks for sites in registry. 
 + 
 +===== FileZilla =====
For FileZilla, WinSCP looks for sites in ''C:\Users\username\AppData\Roaming\FileZilla\sitemanager.xml''. &winpath For FileZilla, WinSCP looks for sites in ''C:\Users\username\AppData\Roaming\FileZilla\sitemanager.xml''. &winpath
 +
 +===== [[openssh_config]] OpenSSH config =====
 +
 +For [[https://man.openbsd.org/ssh_config|OpenSSH ''config'' file]], WinSCP looks to ''C:\Users\username\.ssh\config''. In the file, it  looks for all ''Host'' directives with specific hostname and imports them as sites to WinSCP.
 +
 +When resolving site settings, it considers all ''Host'' directives, even those with wildcards. The following directives are recognized: ''AddressFamily'', ''BindAddress'', ''Compression'', ''ForwardAgent'', ''GSSAPIAuthentication'', ''GSSAPIDelegateCredentials'', ''Hostname'', ''IdentityFile'', ''KbdInteractiveAuthentication'', ''Port'', ''ProxyJump'' (single jump only) and ''User''.
 +
 +When private key is found in the ''IdentityFile'' directive, WinSCP will offer you to convert the key to PuTTY format, unless a key file with the same name and ''.ppk'' extension exists already. Additionally, if certificate file with the same name (but ''-cert.pub'' suffix) is found, it will be automatically added to the converted key file.
 +
 +===== [[openssh_known_hosts]] OpenSSH known_hosts =====
For OpenSSH ''known_hosts'' files, WinSCP looks to ''C:\Users\username\.ssh\known_hosts''. &winpath You can also paste hosts key in OpenSSH format from clipboard using //Paste// button. For OpenSSH ''known_hosts'' files, WinSCP looks to ''C:\Users\username\.ssh\known_hosts''. &winpath You can also paste hosts key in OpenSSH format from clipboard using //Paste// button.
-//In versions prior to the latest beta version,// the checkbox //Import cached host keys for checked sites// makes WinSCP import SSH host keys from the source application cache for hostnames from all selected sites. So you do not need to [[ssh_verifying_the_host_key|verify]] again the SSH host keys that you have verified in the other application already. //The latest beta version// imports the host keys always.+WinSCP imports also SSH host keys from the source application cache for hostnames from all selected sites. So you do not need to [[ssh_verifying_the_host_key|verify]] again the SSH host keys that you have verified in the other application already.
When you finish your selection, press //OK// to import the sites. Note that when the name of imported site collides with name of an existing site, WinSCP appends number to the end of the name to name it unique. When you finish your selection, press //OK// to import the sites. Note that when the name of imported site collides with name of an existing site, WinSCP appends number to the end of the name to name it unique.

Last modified: by martin