session_url » Revisions »
Differences
This shows you the differences between the selected revisions of the page.
| 2017-12-21 | 2017-12-21 | ||
| 5.12 Bug 572 Amazon S3 protocol support. (martin) | limit acronym recongnition (martin) | ||
| Line 16: | Line 16: | ||
| You should also always explicitly specify a protocol (''[[sftp]]'', ''[[ftp]]'', ''[[scp]]'', ''[[s3]]'', for [[ftps|FTP over implicit TLS/SSL]] use ''ftps'', for [[ftps|FTP over explicit TLS/SSL]] use ''ftpes'', for [[WebDAV]] use ''http'', for WebDAV over TLS/SSL use ''https''). ((Protocol is ''sftp'' by default, but the default can be changed.)) For all protocols [[integration_url#winscp|WinSCP-specific alternative]] is supported, with ''winscp-'' prefix. | You should also always explicitly specify a protocol (''[[sftp]]'', ''[[ftp]]'', ''[[scp]]'', ''[[s3]]'', for [[ftps|FTP over implicit TLS/SSL]] use ''ftps'', for [[ftps|FTP over explicit TLS/SSL]] use ''ftpes'', for [[WebDAV]] use ''http'', for WebDAV over TLS/SSL use ''https''). ((Protocol is ''sftp'' by default, but the default can be changed.)) For all protocols [[integration_url#winscp|WinSCP-specific alternative]] is supported, with ''winscp-'' prefix. | ||
| - | Most URL's will include also ''username''. | + | Most %%URL%%'s will include also ''username''. |
| The ''port'' needs to be specified only, when it differs from the default port for the protocol (22 for ''sftp''/''scp'', 21 for ''ftp'' and ''ftpes'', 990 for implicit ''ftps'', 80 for ''http'' and 443 for ''https'' and ''s3''). | The ''port'' needs to be specified only, when it differs from the default port for the protocol (22 for ''sftp''/''scp'', 21 for ''ftp'' and ''ftpes'', 990 for implicit ''ftps'', 80 for ''http'' and 443 for ''https'' and ''s3''). | ||
| Line 22: | Line 22: | ||
| ===== [[hostkey]] SSH Host Key Fingerprint ===== | ===== [[hostkey]] SSH Host Key Fingerprint ===== | ||
| - | The SFTP/SCP URL can optionally contain expected [[ssh_verifying_the_host_key|SSH host key fingerprint]] with syntax ''fingerprint=<fingerprint>''. | + | The SFTP/SCP %%URL%% can optionally contain expected [[ssh_verifying_the_host_key|SSH host key fingerprint]] with syntax ''fingerprint=<fingerprint>''. |
| - | Providing the fingerprint in the session URL is mainly useful, if you need to provide all session settings using URL only, such as using [[integration_url|a hyperlink on a web page]]. | + | Providing the fingerprint in the session %%URL%% is mainly useful, if you need to provide all session settings using %%URL%% only, such as using [[integration_url|a hyperlink on a web page]]. |
| - | For security reasons, fingerprint provided in session URL does not override any fingerprint already cached on the machine. This for instance differs from behavior, when fingerprint is provided using ''[[scriptcommand_open#hostkey|-hostkey]]'' switch of ''[[scriptcommand_open|open]]'' command in scripting. | + | For security reasons, fingerprint provided in session %%URL%% does not override any fingerprint already cached on the machine. This for instance differs from behavior, when fingerprint is provided using ''[[scriptcommand_open#hostkey|-hostkey]]'' switch of ''[[scriptcommand_open|open]]'' command in scripting. |
| - | Format of the fingerprint for URL((Fingerprint format for URL is based on [[https://tools.ietf.org/html/draft-ietf-secsh-scp-sftp-ssh-uri-04|draft-ietf-secsh-scp-sftp-ssh-uri]].)) somewhat differs from format used in other WinSCP features (''[[scriptcommand_open#hostkey|-hostkey]]'' switch of ''[[scriptcommand_open|open]]'' command in scripting for instance). To convert WinSCP fingerprint format to URL format: | + | Format of the fingerprint for %%URL%%((Fingerprint format for %%URL%% is based on [[https://tools.ietf.org/html/draft-ietf-secsh-scp-sftp-ssh-uri-04|draft-ietf-secsh-scp-sftp-ssh-uri]].)) somewhat differs from format used in other WinSCP features (''[[scriptcommand_open#hostkey|-hostkey]]'' switch of ''[[scriptcommand_open|open]]'' command in scripting for instance). To convert WinSCP fingerprint format to %%URL%% format: |
| - Drop bit count part (the number after ''ssh-rsa'' or ''ssh-dsa'', typically ''2048'' or ''1024''); | - Drop bit count part (the number after ''ssh-rsa'' or ''ssh-dsa'', typically ''2048'' or ''1024''); | ||