session_url » Revisions »
Differences
This shows you the differences between the selected revisions of the page.
| 2017-12-21 | 2018-10-16 | ||
| styling (martin) | 5.14 Session URL can contain any raw session settings using connection parameter (martin) | ||
| Line 9: | Line 9: | ||
| <code> | <code> | ||
| - | <protocol> :// [ <username> [ : <password> ] [ ; <fingerprint> ] @ ] <host> [ : <port> ] / | + | <protocol> :// [ <username> [ : <password> ] [ ; <advanced> ] @ ] <host> [ : <port> ] / |
| </code> | </code> | ||
| Line 22: | Line 22: | ||
| 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''). | ||
| - | ===== [[hostkey]] SSH Host Key Fingerprint ===== | + | ===== [[advanced]] Advanced Settings ===== |
| - | The SFTP/SCP %%URL%% can optionally contain expected [[ssh_verifying_the_host_key|SSH host key fingerprint]] with syntax ''fingerprint=<fingerprint>''. | + | A session %%URL%% can optionally set any advanced session settings using a syntax based on [[rawsettings|raw site settings]]. |
| + | |||
| + | Providing advanced settings 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]]; or when you want to serialize all session settings into a single "connection string", such as when passing the current setting settings to a WinSCP [[extension]]. | ||
| + | |||
| + | A syntax to serialize raw site settings is '';x-name1=value1;x-name2=value2'' (inserted after username and password). | ||
| + | |||
| + | For example to use an HTTP proxy server ''proxy'', use the following %%URL%%: \\ ''%%sftp://username:passwordx;x-proxymethod=3;x-proxyhost=proxy@example.com/%%'' | ||
| + | |||
| + | To have WinSCP generate a session %%URL%% with the advanced settings, check //Advanced settings// on [[ui_generateurl|Generate session URL/code]] dialog. To serialize all session settings for a WinSCP extension, use ''!E'' [[custom_command#patterns|pattern]]. | ||
| + | |||
| + | &beta_feature | ||
| + | |||
| + | ===== [[hostkey]] SSH Host Key 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]]. | + | There's a special syntax to include an expected [[ssh_verifying_the_host_key|SSH host key fingerprint]] in SFTP/SCP %%URL%% among advanced site settings: ''fingerprint=<fingerprint>''. |
| 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. | ||