Differences
This shows you the differences between the selected revisions of the page.
| 2004-12-14 | 2004-12-15 | ||
| no summary (martin) | no summary (martin) | ||
| Line 3: | Line 3: | ||
| Using WinSCP, it is possible to connect to a SSH (Secure SHell) server with SFTP (SSH File Transfer Protocol) or SCP (Secure Copy Protocol) service, mainly to UNIX machines. SFTP is a standard part of SSH2 package. SCP is a standard part of SSH1 package. Both protocols can be run even on the latter SSH version. WinSCP supports both SSH1 and SSH2. For authentication, the user can use username and password or public key (RSA or DSA). Other supported means of authorization include TIS, Cryptocard and Keyboard-interactive. | Using WinSCP, it is possible to connect to a SSH (Secure SHell) server with SFTP (SSH File Transfer Protocol) or SCP (Secure Copy Protocol) service, mainly to UNIX machines. SFTP is a standard part of SSH2 package. SCP is a standard part of SSH1 package. Both protocols can be run even on the latter SSH version. WinSCP supports both SSH1 and SSH2. For authentication, the user can use username and password or public key (RSA or DSA). Other supported means of authorization include TIS, Cryptocard and Keyboard-interactive. | ||
| - | [[http://xxxx|{{screenshots:tn_advanced.png}}]] | + | &screenshot(advanced) |
| To generate a public key file, use the [[&puttygenhelp|PuTTYgen]] application. Also read how to use the [[&pageanthelp|Pageant]] application for public key authentication. (PuTTY's SSH authentication agent). You can find links to download these programs in the [[&download|Download]] section. The installation package of WinSCP already includes these applications. | To generate a public key file, use the [[&puttygenhelp|PuTTYgen]] application. Also read how to use the [[&pageanthelp|Pageant]] application for public key authentication. (PuTTY's SSH authentication agent). You can find links to download these programs in the [[&download|Download]] section. The installation package of WinSCP already includes these applications. | ||
| Line 17: | Line 17: | ||
| For correct functionality, it is necessary to satisfy a few conditions. The BASH shell is recommended for working with WinSCP. If your default shell doesn't work with WinSCP, you can specify another shell on the "SCP" tab in the Login dialog. Typing the full path (e.g. "/bin/bash") is recommended. | For correct functionality, it is necessary to satisfy a few conditions. The BASH shell is recommended for working with WinSCP. If your default shell doesn't work with WinSCP, you can specify another shell on the "SCP" tab in the Login dialog. Typing the full path (e.g. "/bin/bash") is recommended. | ||
| - | + | &screenshot(shell) | |
| + | |||
| + | For its operation, WinSCP needs several commands: alias, cd, chgrp, chmod, chown, echo, groups, ls, mkdir, mv, pwd, scp, rm, ln, unalias and unset. These commands have to be placed in the path and user must have sufficient permissions to execute them. WinSCP expects "standard" behaviour of these commands. You can avoid needing these commands by not using some of WinSCP functions (mkdir, chown, ln, etc.) or by changing some configuration options (alias, groups, unalias and unset). | ||
| + | |||
| + | Just after estabilishing the connection with server, all aliases on the above commands are cleared. This is done to avoid unexpected behaviour (e.g. alias "rm" to "rm -i"). If there are no aliases influencing command behaviour, this feature can be disabled on the "SCP" tab in the Login dialog. This setting speeds up the login process. | ||
| + | |||
| + | Another precondition is that the output of all commands is in English. This mostly concerns names of months in directory listings ("ls -la"). Because of this, WinSCP clears all user variables that govern command output after login. These variables are: LANG, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY, LC_NUMERIC, LC_TIME, LC_MESSAGES and LC_ALL. If no such variable is set, is is possible to turn off this feature in the session settings. If command output also reflects some other server settings, it may be necessary to change this before WinSCP can be used. | ||
| + | |||
| + | The last necessary condition is the proper output of la -la command, which is supposed to include file group name! If the group name is absent, it can be temporarily added using the relevant option on the "SCP" tab in the Login dialog. The option causes the execution of the command "alias ls="ls -g"" on startup. | ||
| + | |||
| + | ===== Using WinSCP with Restricted Shell Enviroments ===== | ||
| + | A number of restricted shell enviroments exist for supporting | ||
| + | scp/sftp only accounts. These systems restrict the user to a small | ||
| + | subset of commands needed to manipulate files while denying the | ||
| + | ability to execute arbitrary commands. Some of these enviroments | ||
| + | create incompatabilities with WinSCP, particularly if using SCP | ||
| + | instead of SFTP. | ||
| + | |||
| + | ===== Client Requirements ===== | ||
| + | WinSCP should run on any system running Windows 95 or later. | ||