Difference between revisions of "SFTP"

From SME Server
Jump to navigationJump to search
Line 1: Line 1:
==Intent==
+
==Introduction==
SME Server requires an encrypted connection (like SFTP and SCP) to do file management.
 
  
Ibays can be accessed with unencrypted FTP if they are configured that way in the server-manager.  
+
This document describes how to configure SFTP/FTP client software packages (Windows & Linux) for use with SME Server.
  
This HowTo will show you clients for this together with some tips and tricks.
+
The primary function of a SFTP/FTP client software is, secure file transfer between a local (client) and a remote (server) computer.
  
==Remote access==
+
Beyond this, some SFTP/FTP clients offer various features such as basic file manager, file synchronization and integrated file editing functionality.
If you need remote access (e.g. over internet) to your server, SME Server requires some additional configuration for use with SFTP/ FTP clients like WinSCP.
 
  
Information on configuring SME Server for Remote access can be found in the [[SME_Server:Documentation:Administration_Manual:Chapter11#Security|SME Server Administration Manual]].
+
For secure transfers, SFTP/FTP clients use Secure Shell [http://en.wikipedia.org/wiki/SSH_File_Transfer_Protocol (SSH)] and support the [http://en.wikipedia.org/wiki/SSH_File_Transfer_Protocol SCP] protocol in addition to [http://en.wikipedia.org/wiki/SFTP SFTP].
  
==WinSCP==
+
==Additional Information==
WinSCP is an open source free sFTP client and FTP client for Windows. Legacy SCP protocol is also supported. Its main function is safe copying of files between a local and a remote computer.
+
 
 +
*[http://en.wikipedia.org/wiki/Comparison_of_SSH_clients Comparison of some of the more popular SSH clients]
 +
 
 +
* See Also [[FTP Access to Ibays]]
 +
 
 +
==Editors==
 +
There are many basic and advanced editors that can be used with SFTP/FTP client software packages to provide remote editing functionality.
 +
Example integration is included with each SFTP/FTP client software package below.
 +
 
 +
IF you use an editor that you think others might enjoy, then please feel free to list them below and thank you.
 +
 
 +
*[http://notepad-plus.sourceforge.net/uk/site.htm notepad-plus] Multi-Tabbed Linux or Windows editor.
 +
 
 +
*[http://www.liquidninja.com/metapad/download.html MetaPad] A NotePad work alike Single-Window for use in editing Linux or Windows files. Note: NotePad should not be used to edit Linux files.
 +
 
 +
==Configuring SME Server==
 +
SME Server requires some additional "Remote Access" configuration for use with all SFTP/FTP client software.
 +
It is important at this point to decide if you will need Remote (internet) Access or Local Lan access only, for your SFTP/ FTP remote client.
 +
Information on configuring SME Server for "Remote Access" can be found in the [[SME_Server:Documentation:Administration_Manual:Chapter11#Security|SME Server Administration Manual]].
 +
 
 +
*SFTP (port 22) is the preferred protocol for use with SME Server.
 +
*If your FQDN (hostname) resolution is setup and working you can substitute the [IP.of.your.server] with your FQDN (hostname).
 +
 
 +
==Cautionary Notes==
 +
* Enabling "Remote (internet) Access" on SME Server imposes an additional Network Security Risk to SME Server and any associated networks.
 +
*Therefore, one should read all documentation and corporate policies carefully and understand the Network Security risks involved as they apply to your particular situation and or network configuration.
 +
*'''It is highly advised to have Written Authorization before enabling "Remote (internet) Access" on any server you do not have authoritative control.'''
 +
*Most countries have implemented specific laws regarding Remote System Access as well as most companies having specific Remote System Access policies.
 +
*If your doing business with a company without a written policy, you should work closely with them to develop a written policy before you enable "Remote (internet) Access" on their system.  
  
===Download & Install WinSCP===
+
*There is a very fine line between "someone authorized, employee or contractor" and a "not authorized hacker".
 +
*It is very important to have proper written authorization in your possession (employee or contractor) to avoid any possible legal ramifications. CYA
 +
*"Remote (internet) Access" should be diligently maintained and or disabled when not being used.
 +
 
 +
==Windows Clients==
 +
 
 +
===WinSCP===
 +
[http://winscp.net/eng/index.php WinSCP] is an open source free sFTP/FTP client for Windows and the prefered choice for remote file management and editing. [http://winscp.net/eng/docs/start WinSCP documentation.]
 +
 
 +
Legacy SCP protocol is also supported. Its main function is safe copying of files between a local and a remote computer.
 +
 
 +
====Download & Install WinSCP====
 
# Download the Windows installer from the [http://winscp.net/eng/download.php WinSCP Download Page].
 
# Download the Windows installer from the [http://winscp.net/eng/download.php WinSCP Download Page].
 
# After successfully downloading the file execute it to install the program, your best bet is to run a typical install.
 
# After successfully downloading the file execute it to install the program, your best bet is to run a typical install.
# After the installation we also can install PuTTy, which can be downloaded [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html here]. Save the putty.exe file in the WinSCP folder tree C:\Program Files\WinSCP\PuTTY
+
# After the installation of WinSCP we also can also integrate [http://en.wikipedia.org/wiki/PuTTY PuTTY], which can be downloaded [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html here]. Save the putty.exe file in the WinSCP folder tree C:\Program Files\WinSCP\PuTTY
  
===Configuring PuTTy Integration===
+
====Configuring PuTTy Integration====
  
PuTTY is a free implementation of Telnet and SSH for Win32 and Unix platforms, along with an xterm terminal emulator.
+
[http://en.wikipedia.org/wiki/PuTTY PuTTY] is a free implementation of Telnet and SSH for Win32 and Unix platforms, along with an xterm terminal emulator.
  
 
# Open WinSCP
 
# Open WinSCP
Line 30: Line 67:
 
# When done click OK.
 
# When done click OK.
  
Putty can also be used as standalone ssh-client to execute terminal commands on the server.
+
====Choosing a Preferred Editor====
 
+
WinSCP allows for defining preferred editors based on file extensions to add, remove, '''edit''' remote files.
===Choosing a Preferred Editor===
 
WinSCP allows for defining preferred editors based on file extensions, to add, edit, remove Editor Preferences:
 
 
# Open WinSCP
 
# Open WinSCP
 
# Select Preferences from the left tree
 
# Select Preferences from the left tree
Line 41: Line 76:
 
# Within the Add Editor popup window make the appropriate changes and select the OK button
 
# Within the Add Editor popup window make the appropriate changes and select the OK button
  
===Using WinSCP===
+
====Using WinSCP====
 
The first time use of WinSCP requires connection information to login to your server:
 
The first time use of WinSCP requires connection information to login to your server:
 
# Start WinSCP
 
# Start WinSCP
 
# Enter the hostname or IP number of your server
 
# Enter the hostname or IP number of your server
 
# Set the port number to 22.
 
# Set the port number to 22.
# Enter your credentials (root username and password) Note: The root password is the same as the admin password unless you have changed the admin password.
+
# Enter your credentials (username=root and associated password). The root password is the same as the admin password unless you have changed the admin password.
 
# Click Save
 
# Click Save
 
# Click Login
 
# Click Login
  
 +
===FileZilla===
 +
{{Incomplete}}
 +
[http://filezilla-project.org/index.php FileZilla] is an open source free sFTP/FTP client for Windows. [http://wiki.filezilla-project.org/Documentation FileZilla documentation.]
  
==Nautilus==
+
====Download & Install FileZilla====
This program is the standard graphical file manager in many Linux distributions and it supports several protocols, including FTP and SFTP.
+
# Download the Windows installer from the [http://filezilla-project.org/download.php FileZilla Download Page].
 +
# After successfully downloading the file execute it to install the program, your best bet is to run a typical install.
  
If you omit the [:port], it uses the default one. If your name resolution works you can replace [IP.of.your.server] with a hostname. [root] can be replaced with any valid username.
+
====Using FileZilla====
 +
The first time use of FileZilla requires connection information to login to your server:
 +
# Start FileZilla
 +
# Enter the hostname or IP number of your server
 +
# Set the port number to 22.
 +
# Enter your credentials (username=root and your associated password). The root password is the same as the admin password unless you have changed the admin password.
  
To connect to your server with SFTP (default port 22):
+
===SmartFTP===
sftp://root@IP.of.your.server:port/
+
{{Incomplete}}
To connect to your server with FTP (default port 21):
+
[http://www.smartftp.com/ SmartFTP] is a 30-day trail sFTP/FTP client for Windows.
ftp://root@IP.of.your.server:port/
+
[http://www.smartftp.com/ftplib/documentation/html/frames.html SmartFTP documentation]
  
==FileZilla==
+
====Download & Install SmartFTP====
{{Incomplete}}
+
# Download the Windows installer from the [http://www.smartftp.com/download/ SmartFTP Download Page].
This program can be downloaded [http://filezilla-project.org/download.php here].
+
# After successfully downloading the file execute it to install the program, your best bet is to run a typical install.
  
==SmartFTP==
+
====Using SmartFTP====
{{Incomplete}}
+
The first time use of SmartFTP requires connection information to login to your server:
This program can be downloaded [http://www.smartftp.com/download/ here].
+
# Start SmartFTP
 +
# Enter the hostname or IP number of your server
 +
# Set the port number to 22.
 +
# Enter your credentials (username=root and your associated password). The root password is the same as the admin password unless you have changed the admin password.
  
==Additional Information==
+
== Other Windows SFTP Clients ==
*[[FTP Access to Ibays]]
 
  
*[http://en.wikipedia.org/wiki/SFTP wikipedia.org SFTP]
+
*[http://www.enginsite.com/ssh-webdav-ftp-sftp-client.htm DataFreeway]
  
There are many editors that can be used with WinSCP.
+
==Linux Clients==
 +
===Nautilus===
 +
{{Incomplete}}
 +
[http://live.gnome.org/Nautilus Nautilus] is a popular graphical file manager available in many Linux distributions and supports several protocols, FTP and SFTP.
  
IF you use an editor that you think others might enjoy then list it below and thank you.
+
To connect to your server with SFTP (default port 22):
 +
sftp://root@IP.of.your.server:port/
 +
To connect to your server with FTP (default port 21):
 +
ftp://root@IP.of.your.server:port/
  
*[http://notepad-plus.sourceforge.net/uk/site.htm notepad-plus]
+
Notes:
  
*[http://www.liquidninja.com/metapad/download.html MetaPad]
+
# If you omit the [:port], Nautilus will use it's default port setting.
 +
# [root] can be replaced with any valid username.
  
 
----
 
----
 
[[Category:Howto]]
 
[[Category:Howto]]

Revision as of 07:21, 1 April 2009

Introduction

This document describes how to configure SFTP/FTP client software packages (Windows & Linux) for use with SME Server.

The primary function of a SFTP/FTP client software is, secure file transfer between a local (client) and a remote (server) computer.

Beyond this, some SFTP/FTP clients offer various features such as basic file manager, file synchronization and integrated file editing functionality.

For secure transfers, SFTP/FTP clients use Secure Shell (SSH) and support the SCP protocol in addition to SFTP.

Additional Information

Editors

There are many basic and advanced editors that can be used with SFTP/FTP client software packages to provide remote editing functionality. Example integration is included with each SFTP/FTP client software package below.

IF you use an editor that you think others might enjoy, then please feel free to list them below and thank you.

  • MetaPad A NotePad work alike Single-Window for use in editing Linux or Windows files. Note: NotePad should not be used to edit Linux files.

Configuring SME Server

SME Server requires some additional "Remote Access" configuration for use with all SFTP/FTP client software. It is important at this point to decide if you will need Remote (internet) Access or Local Lan access only, for your SFTP/ FTP remote client. Information on configuring SME Server for "Remote Access" can be found in the SME Server Administration Manual.

  • SFTP (port 22) is the preferred protocol for use with SME Server.
  • If your FQDN (hostname) resolution is setup and working you can substitute the [IP.of.your.server] with your FQDN (hostname).

Cautionary Notes

  • Enabling "Remote (internet) Access" on SME Server imposes an additional Network Security Risk to SME Server and any associated networks.
  • Therefore, one should read all documentation and corporate policies carefully and understand the Network Security risks involved as they apply to your particular situation and or network configuration.
  • It is highly advised to have Written Authorization before enabling "Remote (internet) Access" on any server you do not have authoritative control.
  • Most countries have implemented specific laws regarding Remote System Access as well as most companies having specific Remote System Access policies.
  • If your doing business with a company without a written policy, you should work closely with them to develop a written policy before you enable "Remote (internet) Access" on their system.
  • There is a very fine line between "someone authorized, employee or contractor" and a "not authorized hacker".
  • It is very important to have proper written authorization in your possession (employee or contractor) to avoid any possible legal ramifications. CYA
  • "Remote (internet) Access" should be diligently maintained and or disabled when not being used.

Windows Clients

WinSCP

WinSCP is an open source free sFTP/FTP client for Windows and the prefered choice for remote file management and editing. WinSCP documentation.

Legacy SCP protocol is also supported. Its main function is safe copying of files between a local and a remote computer.

Download & Install WinSCP

  1. Download the Windows installer from the WinSCP Download Page.
  2. After successfully downloading the file execute it to install the program, your best bet is to run a typical install.
  3. After the installation of WinSCP we also can also integrate PuTTY, which can be downloaded here. Save the putty.exe file in the WinSCP folder tree C:\Program Files\WinSCP\PuTTY

Configuring PuTTy Integration

PuTTY is a free implementation of Telnet and SSH for Win32 and Unix platforms, along with an xterm terminal emulator.

  1. Open WinSCP
  2. Select Preferences from the left tree
  3. Then click on the Preferences button
  4. Select Applications under Integration from the left tree
  5. Browse to the location where you saved the putty.exe file typically "C:\Program Files\WinSCP\PuTTY\putty.exe" Note:You can use the Windows variables for instance %PROGRAMFILES% to specify the path to your Program Files folder.
  6. When done click OK.

Choosing a Preferred Editor

WinSCP allows for defining preferred editors based on file extensions to add, remove, edit remote files.

  1. Open WinSCP
  2. Select Preferences from the left tree
  3. Then click on the Preferences button
  4. Select Editors in the left tree
  5. Then select the add button
  6. Within the Add Editor popup window make the appropriate changes and select the OK button

Using WinSCP

The first time use of WinSCP requires connection information to login to your server:

  1. Start WinSCP
  2. Enter the hostname or IP number of your server
  3. Set the port number to 22.
  4. Enter your credentials (username=root and associated password). The root password is the same as the admin password unless you have changed the admin password.
  5. Click Save
  6. Click Login

FileZilla

Incomplete.png Incomplete:
This article or section needs to be expanded. Please help to fill the gaps or discuss the issue on the talk page


FileZilla is an open source free sFTP/FTP client for Windows. FileZilla documentation.

Download & Install FileZilla

  1. Download the Windows installer from the FileZilla Download Page.
  2. After successfully downloading the file execute it to install the program, your best bet is to run a typical install.

Using FileZilla

The first time use of FileZilla requires connection information to login to your server:

  1. Start FileZilla
  2. Enter the hostname or IP number of your server
  3. Set the port number to 22.
  4. Enter your credentials (username=root and your associated password). The root password is the same as the admin password unless you have changed the admin password.

SmartFTP

Incomplete.png Incomplete:
This article or section needs to be expanded. Please help to fill the gaps or discuss the issue on the talk page


SmartFTP is a 30-day trail sFTP/FTP client for Windows. SmartFTP documentation

Download & Install SmartFTP

  1. Download the Windows installer from the SmartFTP Download Page.
  2. After successfully downloading the file execute it to install the program, your best bet is to run a typical install.

Using SmartFTP

The first time use of SmartFTP requires connection information to login to your server:

  1. Start SmartFTP
  2. Enter the hostname or IP number of your server
  3. Set the port number to 22.
  4. Enter your credentials (username=root and your associated password). The root password is the same as the admin password unless you have changed the admin password.

Other Windows SFTP Clients

Linux Clients

Nautilus

Incomplete.png Incomplete:
This article or section needs to be expanded. Please help to fill the gaps or discuss the issue on the talk page


Nautilus is a popular graphical file manager available in many Linux distributions and supports several protocols, FTP and SFTP.

To connect to your server with SFTP (default port 22):

sftp://root@IP.of.your.server:port/

To connect to your server with FTP (default port 21):

ftp://root@IP.of.your.server:port/

Notes:

  1. If you omit the [:port], Nautilus will use it's default port setting.
  2. [root] can be replaced with any valid username.