The information in this document applies to:
This document describes how to configure the FTP Workspace in HTML-Kit Build 292 to connect to a remote FTP server through a SSH FTP tunnel.
Section A. Establish a SSH tunnel between the local computer and the remote FTP server.
First make sure that the remote computer, where the FTP server that you intend to access is hosted, supports SSH. If it's at a third-party web space provider, for example, the web host can verify whether it supports SSH. If SSH support is not available, a free package such as OpenSSH can be used to SSH-enable the server.
Once the SSH support is verified on the server side, the local computer can establish a SSH connection to it using SSH client software. While many SSH clients are available for Windows, the following instructions are for configuring the SSH Secure Shell client version 3.x.
- Download, install and run the SSH Secure Shell client.
- Select "File | Profiles | Add Profiles" from the main menu. Enter a name for the profile such as "FTPOverSSH" and click "Add to Profiles."
- Select "File | Profiles | Edit Profiles" from the main menu. Select the "FTPOverSSH" profile.
- Change to the "Connection" tab and enter the "Host name" (the IP/host address of the remote computer) and the "User name" (the user name used to login to the SSH server on the remote computer).
- Change to the "Tunneling" tab and click "Add."
- Enter a name such as "FTP Tunnel" for the "Display Name."
- Open the "Type" drop-down list and pick "FTP."
- Enter 21 for the "Listen Port."
- Keep the "Allow Local Connections Only" option checked.
- The IP address of the FTP server or its host name can be entered for the "Destination Host." The generic "localhost" (without quotes) name may also work as it refers to the localhost on the remote computer.
- Enter 21 for the "Destination Port."
- Click "OK."
- Click "OK" again to close the "Profiles" dialog.
- Select "File | Profiles | FTPOverSSH" from the main menu. Enter the password when prompted to connect to the SSH server on the remote computer.
The local computer should now be connected to the remote computer through SSH.
Section B. Configure the HTML-Kit Workspace to use the SSH FTP tunnel.
Once a SSH connection is established between the local computer and the remote SSH server, HTML-Kit's FTP Workspace can be configured to connect to the remote FTP server through the SSH connection.
- Open HTML-Kit and make sure that the Workspace window is visible by checking the "View | Workspace" main menu option.
- Select "Workspace | Add Folder / FTP Server | Add FTP Server" from the main menu.
- Enter "localhost" (without quotes) for the "Server address." Note that this is not the host address of the remote FTP server, since the SSH client will be creating a forwarded FTP ports on the local computer.
- Keep the "Port" number at 21.
- Enter the "Login user name" (this should be the user name used to login to the FTP server, not the SSH server).
- Enter the matching "Password" for the FTP user name.
- Enter a "Display name" such as "SSH - FTP Server Name."
- Check the "Passive mode" option.
- Click "OK."
- Make sure that the "View | Messages" main menu option is checked. The details about the FTP connection will appear in the "Workspace" area of the Messages Window.
A new entry will appear in the HTML-Kit Workspace window. Expand it or right click and select "Connect." The FTP Workspace should now connect to the remote FTP server through the SSH client running on the local computer, which in turn will connect to the SSH server on the remote computer.
Due to the complexities involved in transferring FTP data through different layers as well as SSH FTP tunneling issues, please note that any problems are unlikely to be related to HTML-Kit. If any issues arise, testing the SSH FTP tunnel using the default FTP client in Windows is recommend. The Windows' FTP client can be invoked by typing "ftp" (without quotes) in a DOS/Command Prompt window outside of HTML-Kit.
THE INFORMATION IN THIS DOCUMENT IS PROVIDED ON AN AS-IS BASIS WITHOUT WARRANTY OF ANY KIND.
PROVIDER SPECIFICALLY DISCLAIMS ANY OTHER WARRANTY, EXPRESS OR IMPLIED, INCLUDING ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL PROVIDER BE LIABLE FOR ANY CONSEQUENTIAL, INDIRECT, SPECIAL OR INCIDENTAL DAMAGES, EVEN IF PROVIDER HAS BEEN ADVISED BY "USER" OF THE POSSIBILITY OF SUCH POTENTIAL LOSS OR DAMAGE. "USER" AGREES TO HOLD PROVIDER HARMLESS FROM AND AGAINST ANY AND ALL CLAIMS, LOSSES, LIABILITIES AND EXPENSES.
Document ID: H000156
Audience: Advanced user
Reviewed On: 10-Jul-2003