session_url » Revisions »
Differences
This shows you the differences between the selected revisions of the page.
| 2013-10-24 | 2013-10-24 | ||
| sections (martin) | 5.2.5: Bug 93: Support for SSH hostkey fingerprint specification in session URL using connection parameter fingerprint defined by draft-ietf-secsh-scp-sftp-ssh-uri + URL session parameter save to initiate site saving (martin) | ||
| Line 4: | Line 4: | ||
| ===== Syntax ===== | ===== Syntax ===== | ||
| - | [ sftp|ftp|ftps|scp :// ][ <username> [ : <password> ] @ ] <host> [ : <port> ] | + | [ sftp|ftp|ftps|scp :// ][ <username> [ : <password> ] [ ; <fingerprint> ] @ ] <host> [ : <port> ] [ ; <options> ] |
| ===== Elements ===== | ===== Elements ===== | ||
| Line 11: | Line 11: | ||
| The ''host'' can either be a host name (such as ''example.com''), an IPv4 address (such as ''127.0.0.1'') or an IPv6 address surrounded by square brackets (such as ''[2001:db8:85a3:8d3:1319:8a2e:370:7348]''). | The ''host'' can either be a host name (such as ''example.com''), an IPv4 address (such as ''127.0.0.1'') or an IPv6 address surrounded by square brackets (such as ''[2001:db8:85a3:8d3:1319:8a2e:370:7348]''). | ||
| + | |||
| + | ===== [[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>''. | ||
| + | |||
| + | Providing the fingerprint in the session URL is mainly useful, if you need to provide all session settings using URL only, such as using 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 ''-hostkey'' switch of ''[[scriptcommand_open|open]]'' command in scripting. | ||
| + | |||
| + | Format of the fingerprint for URL somewhat differs from format used in other WinSCP features (''-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 ''1024'' or ''2048''); | ||
| + | - Replace remaining space and all colons ('':'') with a dash sign (''-''). | ||
| + | |||
| + | For example WinSCP fingerprint ''ssh-rsa 2048 ee:f3:c1:59:4d:b4:e2:c5:da:22:3a:6e:97:a0:28:29'' converts to ''ssh-rsa-ee-f3-c1-59-4d-b4-e2-c5-da-22-3a-6e-97-a0-28-29''. | ||
| + | |||
| + | ===== Saving URL to Site ===== | ||
| + | |||
| + | To make WinSCP [[session_configuration#site|save session settings]] provided by URL to a site instead of opening a session, add URL option ''save''. | ||
| + | |||
| + | Options are separated by a semicolon ('';'') from the actual URL. | ||
| + | |||
| + | The ''save'' option can be used, when using session URL on [[commandline|command-line]] only. But particularly it is useful, when providing session settings using a hyperlink (on a web page). For SFTP/SCP URL this should be combined with including [[session_url#hostkey|SSH host key fingerprint in the URL]]. | ||
| ===== Special Characters ===== | ===== Special Characters ===== | ||