Difference between revisions of "SFTP"

From SME Server
Jump to navigationJump to search
(Refactor page to allow for other sFTP clients as well a sa major overhaul for the WinSCP page)
m (corrected References level)
 
(37 intermediate revisions by 5 users not shown)
Line 1: Line 1:
 +
==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 [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].
 +
 +
==Additional Information==
 +
 +
*[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.
 +
 +
*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===
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://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.]
  
====Install WinSCP====
+
Legacy SCP protocol is also supported. Its main function is safe copying of files between a local and a remote computer.
# Download the MSI installer from the [http://winscp.net/download/ WinSCP Download Page].
+
 
# After succesfully downloading the file execute it to install the program, your best bet is to run a typical install, unless you know what you are doing.
+
====Download & Install WinSCP====
# After the installation we also can install PuTTy, which can be downloaded [http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html here].
+
# 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 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====
 +
 
 +
[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.
  
====Configuring PuTTy integration====
 
 
# Open WinSCP
 
# Open WinSCP
# Select Preferences from the tree
+
# Select Preferences from the left tree
# Click on the Preferences button in the right hand pane
+
# Then click on the Preferences button
# Select Applications under Integration in the tree in the left hand pane
+
# Select Applications under Integration from the left tree
# Now supply the path to PuTTy. You can use the Windows variables like for instance %PROGRAMFILES% to specify the path to your Program Files folder.
+
# 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.
 
# When done click OK.
 
# When done click OK.
  
====Choosing a preferred editor====
+
====Choosing a Preferred Editor====
WinSCP allows for defining preferred editors based on file extensions, to review or modify them:
+
WinSCP allows for defining preferred editors based on file extensions to add, remove, '''edit''' remote files.
 
# Open WinSCP
 
# Open WinSCP
# Select Preferences from the tree
+
# Select Preferences from the left tree
# Click on the Preferences button in the right hand pane
+
# Then click on the Preferences button
# Select Editors in the tree in the left hand pane
+
# Select Editors in the left tree
# Now you can add or edit existing editor definitions
+
# Then select the add button
 +
# Within the Add Editor popup window make the appropriate changes and select the OK button
  
 
====Using WinSCP====
 
====Using WinSCP====
For first time use you can create a connection to your server like this:
+
The first time use of WinSCP requires connection information to login to your server:
 
# Start WinSCP
 
# Start WinSCP
# Enter your Host Name i.e. www.yoursite.com or site ip 234.234.234.555
+
# Enter the hostname or IP number of your server
 
# Set the port number to 22.
 
# Set the port number to 22.
# Enter your credentials (username: root and it's password which should have the same 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.]
 +
 +
====Download & Install FileZilla====
 +
# 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.
 +
 +
====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.
 +
 +
===SmartFTP===
 +
{{Incomplete}}
 +
[http://www.smartftp.com/ SmartFTP] is a 30-day trail sFTP/FTP client for Windows.
 +
[http://www.smartftp.com/ftplib/documentation/html/frames.html SmartFTP documentation]
 +
 +
====Download & Install SmartFTP====
 +
# Download the Windows installer from the [http://www.smartftp.com/download/ SmartFTP Download Page].
 +
# 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:
 +
# 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.
 +
 +
=== Other Windows SFTP Clients ===
 +
 +
*[http://www.enginsite.com/ssh-webdav-ftp-sftp-client.htm DataFreeway]
 +
 +
==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.
 +
 +
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:
 +
 +
# If you omit the [:port], Nautilus will use it's default port setting.
 +
# [root] can be replaced with any valid username.
 +
 +
 +
==References==
  
 +
http://forums.contribs.org/index.php/topic,48307.0.html
  
 
----
 
----
 
[[Category:Howto]]
 
[[Category:Howto]]
 +
[[Category:Administration:Remote Access]]

Latest revision as of 21:25, 7 February 2012

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.


References

http://forums.contribs.org/index.php/topic,48307.0.html