Differences
This shows you the differences between the selected revisions of the page.
| 2014-06-13 | 2014-07-14 | ||
| ssh#verifying_the_host_key moved to ssh_verifying_the_host_key (martin) | 5.6 Bug 816 Passphrase can be provided on command line/in scripting and .NET assembly. (martin) | ||
| Line 11: | Line 11: | ||
| Establishes connection to given host. Use [[session_url|session URL]] or name of the [[session_configuration#site|site]]. To open site, stored in folder, use path syntax “folder/site”. Using session URL is preferred as it makes your script independent on the persisted configuration. | Establishes connection to given host. Use [[session_url|session URL]] or name of the [[session_configuration#site|site]]. To open site, stored in folder, use path syntax “folder/site”. Using session URL is preferred as it makes your script independent on the persisted configuration. | ||
| - | Note that to allow the session be opened automatically without interaction, you need to make sure you provide all details, including all credentials. Generally, you need to provide a password in your [[session_url|session URL]] or [[session_configuration#site|site]]. With [[ssh|SSH]] you may alternatively use passphrase-less private key or use [[ui_pageant|Pageant]]. With SSH and [[ftps|FTPS]] you need to [[scripting#hostkey|verify the host or certificate]]. | + | Note that to allow the session be opened automatically without interaction, you need to make sure you provide all details, including all credentials. Generally, you need to provide a password in your [[session_url|session URL]] or [[session_configuration#site|site]]. With [[ssh|SSH]] you may alternatively use private key or use [[ui_pageant|Pageant]]. With SSH and [[ftps|FTPS]] you need to [[scripting#hostkey|verify the host or certificate]]. |
| Switches: | Switches: | ||
| ^ Switch ^ Description ^ | ^ Switch ^ Description ^ | ||
| | ''-privatekey=<key>'' | [[public_key#private|Private key]] path | | | ''-privatekey=<key>'' | [[public_key#private|Private key]] path | | ||
| + | | ''-passphrase=<phrase>'' | Passphrase for encrypted private keys. &beta_feature | | ||
| | ''-timeout=<sec>'' | Server response timeout | | | ''-timeout=<sec>'' | Server response timeout | | ||
| | ''%%-hostkey="<fingerprint>"%%'' | Specifies fingerprint of expected [[ssh_verifying_the_host_key|SSH host key]] (or several alternative fingerprints separated by semicolon). It makes WinSCP automatically [[scripting#hostkey|accept host key]] with the fingerprint. As the host key fingerprint contains spaces you need to surround it by quotes. //Learn how to [[faq_script_hostkey|obtain host key fingerprint]]//. \\ In exceptional situations, when security is not required, you can use value ''*'' to accept any host key. In this case, script output and log file will include warning about insecure connection. \\ [[SFTP]] and [[SCP]] protocols only. | | | ''%%-hostkey="<fingerprint>"%%'' | Specifies fingerprint of expected [[ssh_verifying_the_host_key|SSH host key]] (or several alternative fingerprints separated by semicolon). It makes WinSCP automatically [[scripting#hostkey|accept host key]] with the fingerprint. As the host key fingerprint contains spaces you need to surround it by quotes. //Learn how to [[faq_script_hostkey|obtain host key fingerprint]]//. \\ In exceptional situations, when security is not required, you can use value ''*'' to accept any host key. In this case, script output and log file will include warning about insecure connection. \\ [[SFTP]] and [[SCP]] protocols only. | | ||
| Line 57: | Line 58: | ||
| ^ Switch ^ Mapping ^ | ^ Switch ^ Mapping ^ | ||
| | ''-privatekey'' | Set ''[[library_sessionoptions|SessionOptions.SshPrivateKeyPath]]''. | | | ''-privatekey'' | Set ''[[library_sessionoptions|SessionOptions.SshPrivateKeyPath]]''. | | ||
| + | | ''-passphrase'' | Set ''[[library_sessionoptions|SessionOptions.SshPrivateKeyPassphrase]]''. | | ||
| | ''-timeout'' | Set ''[[library_sessionoptions|SessionOptions.Timeout]]''. | | | ''-timeout'' | Set ''[[library_sessionoptions|SessionOptions.Timeout]]''. | | ||
| | ''-hostkey'' | Set ''[[library_sessionoptions|SessionOptions.SshHostKeyFingerprint]]''. | | | ''-hostkey'' | Set ''[[library_sessionoptions|SessionOptions.SshHostKeyFingerprint]]''. | | ||