Differences
This shows you the differences between the selected revisions of the page.
| integration_url 2015-12-18 | integration_url 2023-10-24 (current) | ||
| Line 3: | Line 3: | ||
| ===== [[registering]] Registering to Handle URL Addresses ===== | ===== [[registering]] Registering to Handle URL Addresses ===== | ||
| - | To register WinSCP to handle the %%URL%% addresses use [[installation|installer]] or go to [[ui_pref_integration|Preferences dialog]]. | + | To register WinSCP to handle the %%URL%% addresses use [[ui_installer_selecttasks|installer]] or go to [[ui_pref_integration|Preferences dialog]]. |
| If current user's permissions allow, WinSCP register itself for all users. Otherwise it registers for current user only. | If current user's permissions allow, WinSCP register itself for all users. Otherwise it registers for current user only. | ||
| ==== [[win_vista_and_newer]] Windows Vista and Newer ==== | ==== [[win_vista_and_newer]] Windows Vista and Newer ==== | ||
| - | On Windows 10, Windows 8, Windows 7, and Windows Vista, WinSCP registers to list of applications that handle ''%%sftp://%%'', ''%%ftp://%%'', ''%%ftps://%%'', ''%%scp://%%'' and ''%%ssh://%%'' (//Latest beta version only//) &beta protocol %%URL%% addresses. &winvista &win7 &win8 &win10 If WinSCP is the first application to support some of these protocols (most often ''%%sftp://%%'', ''%%scp://%%'' and ''%%ssh://%%'', usually also ''%%ftps://%%''), it becomes a default application for these. | + | On Windows 11, Windows 10, Windows 8, Windows 7, and Windows Vista, WinSCP registers to list of applications that handle ''%%sftp://%%'', ''%%ftp://%%'', ''%%ftps://%%'', ''%%ftpes://%%'', ''%%scp://%%'', ''%%ssh://%%'', ''%%dav://%%'', ''%%davs://%%'' and ''%%s3://%%'' protocol %%URL%% addresses. &winvista &win7 &win8 &win10 &win11 If WinSCP is the first application to support some of these protocols (most often ''%%sftp://%%'', ''%%scp://%%'', ''%%ssh://%%'', ''%%dav://%%'', ''%%davs://%%'' and ''%%s3://%%'', usually also ''%%ftps://%%'' and ''%%ftpes://%%''), it becomes a default application for these. |
| If you want to change the registration (for instance to make WinSCP default application even for ''%%ftp://%%'' %%URL%% addresses): | If you want to change the registration (for instance to make WinSCP default application even for ''%%ftp://%%'' %%URL%% addresses): | ||
| - | * On //[[ui_pref_integration|Integration page]]// of Preferences dialog go to //%%Register to handle URL addresses > Make WinSCP default handler%%//((Alternatively go to //Control Panel > Programs > Default Programs > Set your default programs//; &wincp Locate WinSCP in the list; Click //Choose defaults for this program// command link.)); | + | * On //[[ui_pref_integration|Integration page]]// of Preferences dialog go to //%%Register to handle URL addresses > Make WinSCP default handler%%//;((Alternatively: On Windows 11 and Windows 10, go to //Settings > Apps > Default Apps//. On Windows 7 and older: go to //Control Panel > Programs > Default Programs > Set your default programs//; &wincp Locate WinSCP in the list; Click //Choose defaults for this program// command link.)) |
| - | * //Set Program Associations// Control Panel applet for WinSCP opens; | + | * Windows 11 and Windows 10: |
| - | ·* Check protocols you want WinSCP to be the default application for; | + | * Windows 11: The //Settings// app opens with //Default Apps// page. Locate and select //WinSCP// in the application list. &win11 |
| - | * and confirm with //Save// button. | + | ····* Windows 10: The //Settings// app opens with //Default Apps// page. At the bottom of the page, click //Set defaults by app// link. Locate and select //WinSCP// in the application list. After selecting //WinSCP//, click the //Manage// button. &;win10 |
| + | ···* One by one locate the protocols that you want to associate with WinSCP and select //Choose a default//. In the popup menu, select //WinSCP//. | ||
| + | * In case you [[microsoft_store#transitioning|have both classic and Microsoft Store installation]], they cannot be distinguished in the application list. But at that stage, it does not matter which one you select. Later in the popup menu, when associating a protocol, select //";WinSCP"//, if you want to use the Microsoft Store installation, or //%%"WinSCP: SFTP, FTP, WebDAV, S3 and SCP client"%%//, if you want to use the classic installation. | ||
| + | * Windows 8, Windows 7 and Windows Vista: | ||
| + | * The //Set Program Associations// Control Panel applet for WinSCP opens; &win8 &win7 &winvista | ||
| + | * Choose the protocols you want WinSCP to be the default application for. | ||
| - | Note that most mainstream web browsers ignore system registration for ''%%ftp://%%'' %%URL%% addresses and handle these on web pages on their own. To override this, you may use [[#winscp|WinSCP-specific URL addresses]]. | + | WinSCP never registers to handle WebDAV ''%%http://%%'' %%URL%% addresses not to conflict with web browser registration. Though, it registers ''%%dav://%%'', ''%%davs://%%'' and [[#winscp|WinSCP-specific WebDAV URL addresses]]. |
| - | + | ||
| - | WinSCP never registers to handle WebDAV ''%%http://%%'' %%URL%% addresses not to conflict with web browser registration. Though it registers [[#winscp|WinSCP-specific WebDAV URL addresses]]. | + | |
| ==== [[winxp]] Windows XP ==== | ==== [[winxp]] Windows XP ==== | ||
| - | On Windows XP, WinSCP registers to handle ''%%sftp://%%'' and ''%%scp://%%'' protocol %%URL%% addresses, overriding previous registration, if any. &winxp | + | On Windows XP, WinSCP registers to handle ''%%sftp://%%'', ''%%scp://%%'', ''%%dav://%%'', ''%%davs://%%'' and ''%%s3://%%'' protocol %%URL%% addresses, overriding previous registration, if any. &winxp |
| To change the registration: | To change the registration: | ||
| * Go to //Control Panel > Folder Options > File Types//; &wincp | * Go to //Control Panel > Folder Options > File Types//; &wincp | ||
| - | * Search a list for //File types// "%%URL: SFTP Protocol%%" or "%%URL: SCP Protocol%%"; | + | * Search a list for //File types// "%%URL: SFTP Protocol%%", "%%URL: SCP Protocol%%", etc; |
| * Click //Advanced// button; | * Click //Advanced// button; | ||
| * Select "open" action; | * Select "open" action; | ||
| Line 31: | Line 34: | ||
| ==== [[winscp]] WinSCP-specific URL protocols ==== | ==== [[winscp]] WinSCP-specific URL protocols ==== | ||
| - | In addition to registering to generic %%URL%% protocols, WinSCP registers for application-specific %%URL%% protocols with ''winscp-'' prefix, i.e. ''%%winscp-sftp://%%'', ''%%winscp-ftp://%%'', etc. This is particularly useful for FTP protocol, for which WinSCP competes with your default web browser. Also for links on web pages, web browsers typically ignore system registration for ''%%ftp://%%'' addresses and handle these on their own anyway. | + | In addition to registering to generic %%URL%% protocols, WinSCP registers for application-specific %%URL%% protocols with ''winscp-'' prefix, i.e. ''%%winscp-sftp://%%'', ''%%winscp-ftp://%%'', etc. |
| - | Using WinSCP-specific %%URL%% protocols is reasonable also, when using WinSCP-specific extension for %%URL%% syntax, particularly the [[#save|save extension]]. | + | Using WinSCP-specific %%URL%% protocols is reasonable, when using WinSCP-specific extension for %%URL%% syntax, particularly the [[#save|save extension]]. |
| - | + | ||
| - | For WebDAV, WinSCP registers only to WinSCP-specific %%URL%% addresses, ''%%winscp-http://%%'' and ''%%winscp-https://%%''. | + | |
| ===== [[handling]] Handling URL Addresses ===== | ===== [[handling]] Handling URL Addresses ===== | ||
| Line 41: | Line 42: | ||
| If a handled %%URL%% does not include path part, WinSCP simply opens [[session_url|a session specified by the URL]]. | If a handled %%URL%% does not include path part, WinSCP simply opens [[session_url|a session specified by the URL]]. | ||
| - | If path part is included and it ends with slash (''/''), WinSCP starts with the path as initial remote directory. If the path part does not end with slash, the file (or directory) specified by it is downloaded. | + | If path part is included and it ends with slash (''/''), WinSCP starts with the path as initial remote directory. If the path part does not end with slash, the file (or directory) specified by it is [[task_download#url|downloaded]]. |
| For ''%%ssh://%%'' %%URL%%, WinSCP opens the session specified by the URL [[integration_putty|in PuTTY]]. | For ''%%ssh://%%'' %%URL%%, WinSCP opens the session specified by the URL [[integration_putty|in PuTTY]]. | ||
| + | |||
| + | If the URL (without the protocol prefix) or its part matches a name of a stored site, WinSCP will use setting from that site. That can be used for example to specify default credentials or a proxy server for a hostname. | ||
| ==== [[save]] Save Extension ==== | ==== [[save]] Save Extension ==== | ||
| Line 51: | Line 54: | ||
| For SFTP/SCP %%URL%% this should be combined with including [[session_url#hostkey|SSH host key fingerprint in the URL]]. As this is WinSCP-specific extension, and also to avoid conflicts with other applications, like web browsers, consider using [[#winscp|WinSCP-specific URL protocols]]. | For SFTP/SCP %%URL%% this should be combined with including [[session_url#hostkey|SSH host key fingerprint in the URL]]. As this is WinSCP-specific extension, and also to avoid conflicts with other applications, like web browsers, consider using [[#winscp|WinSCP-specific URL protocols]]. | ||
| - | Example: ''[[winscp-sftp://martin:mypassword;fingerprint=ssh-rsa-xx-xx-xx-xx-xx-xx-xx-xx-xx-xx-xx-xx-xx-xx-xx-xx@example.com/;save]]'' | + | Example: ''[[winscp-sftp://martin:mypassword;fingerprint=ssh-rsa-xxxxxxxxxxx...@example.com/;save]]'' |
| ===== Generating URL ===== | ===== Generating URL ===== | ||
| Line 57: | Line 60: | ||
| You can have WinSCP generate %%URL%% using: | You can have WinSCP generate %%URL%% using: | ||
| - | * //Manage > Generate %%URL%%// command on [[ui_login|Login dialog]] to generate session %%URL%% for selected site. | + | * //Tabs > Generate Session %%URL%%/Code// command on the main window to generate session %%URL%% for current session (preferred as it guarantees that [[session_url#hostkey|SSH host key fingerprint]] is included in the %%URL%%). |
| - | * //Session > Generate %%URL%%// command on main window to generate session %%URL%% for current session. | + | * //Manage > Generate Session %%URL%%/Code// command on [[ui_login|Login dialog]] to generate session %%URL%% for selected site. |
| - | * //File(s) > File Names > Generate %%URL%%// command on main window to generate file %%URL%% for files selected in remote [[ui_file_panel|file panel]]. | + | * //Files > File Names > Generate File %%URL%%// command on the main window to generate file %%URL%% for files selected in remote [[ui_file_panel|file panel]]. |
| ===== Injecting URL to a Page===== | ===== Injecting URL to a Page===== | ||
| You can use a user script to [[guide_injecting_sftp_ftp_url_to_page|inject SFTP or FTP URL to a page]] (such an Amazon EC2 management console). | You can use a user script to [[guide_injecting_sftp_ftp_url_to_page|inject SFTP or FTP URL to a page]] (such an Amazon EC2 management console). | ||