  NetDrive for OS/2

  SSH File Transfer Protocol plugin

    http://www.bmtmicro.com/netdrive
  
  CONTENTS
  _____________________________________________________________
  
  1. Overview
  2. Installation
  3. Using SFTP Resources
  3.1. Password and public key authentication
  3.2. Important note on passwords and passphrases
  3.3. The host keys file
  3.4. Command line utility ndsftp
  4. Known Limitations and Problems
  5. Revision History
  6. Support
  7. License Agreement
  7.1. SSH File Transfer Protocol Plugin License
  7.2. Third Party Disclaimer
  7.3. Demo Version Note
  _____________________________________________________________
  
  
  1. Overview
  ___________
  
  SSH File Transfer Protocol is a remote file system protocol
  used with the SSH-2 protocol. It provides secure file transfer
  and client/server authentication. To ensure this level of
  security several strong encryption methods are used.
  
  In some countries the use or possesion of encryption technology
  is illegal. If you reside in such a country, this means that
  downloading and using the SFTP plugin is illegal.

  The U.S. government considers strong encryption a military
  technology and prohibits export of such. Methods used in SSH
  are covered by U.S. export laws. This means that you are legally
  allowed to import such technology into the U.S. But, once it is
  inside the U.S. it is illegal to export it from the U.S. to other
  countries, which includes putting it on an internationally accessible
  ftp server, sending it by mail or email or any other means of
  transportation.
  
  Disclaimer: The information on legality of using encryption has been
  obtained by monitoring the discussion about SSH and encryption on the
  Internet and can in no way be considered legally binding. If you require
  a legally binding statement regarding the legality of downloading or using
  this software, please contact an attorney in your country.
  
  
  2. Installation
  _______________
  
  This plugin requires the NetDrive for OS/2 Control Program 
  version 3.1.0 or higher. ndsftp command line utility requires
  NetDrive version 3.1.5. The version can be queried using
  the following command:
  
  ND QUERY CTL 
  
  Alternatively you can select 'Help->About NetDrive for OS/2'
  menu item in NetDrive for OS/2 Control Panel. The Control
  Program version is displayed in the lower left part of 
  the message box in between two horizontal lines.
  
  To install the plugin run instpl.cmd

  
  3. Using SFTP Resources
  _______________________
  
  SFTP resource can be mounted either from command line or in
  the NetDrive Control Panel.
  
  Command line example:
  
    rem Create a drive letter
    nd attach n:
    rem Create a mount point for SFTP resource
    nd createmp n:\sftp
    rem Mount a SFTP server directory
    rem The server description format is: [user@]host[:port][/[directory]]
    nd mount sftp n:\sftp user@server.hostname;password=secret w
  
  3.1. Password and public key authentication
  -------------------------------------------
  The SFTP plugin supports both password and public key
  authentication.
  
  Public key authentication is enabled when the resource
  properties contain the private key file name.

  The sftpkey.exe utility is used for the key generation.

  The following command creates a RSA key with a passphrase
  and saves it in encrypted form to the file test.key:

    sftpkey.exe -t rsa -P -o test.key

  When the key is used the plugin will ask you to enter
  the passphrase to decrypt the key. 

  The SFTP server has to be configured to accept the public key.

  The public key suitable for OpenSSH server is created using:

    sftpkey.exe test.key -L >pub.key

  The pub.key will contain a line that must be added to file
  $HOME/.ssh/authorized_keys on the server.
  
  3.2. Important note on passwords and passphrases
  ------------------------------------------------
  If the password or the passphrase is entered in the resource
  properties, it is saved as plain text in the configuration
  file (volumes.cfg in the NetDrive installation directory).
  
  It is recommended to leave the password field empty.
  The plugin will ask for the information, when it is required,
  and will keep the information in the memory.
  
  3.3. The host keys file
  -----------------------
  The plugin saves the host keys to the file sshhostkeys in the
  %HOME%\.ndpsftp directory. If the HOME environment variable is
  empty, then the .ndpsftp directory is created at the root of the
  system drive.
  
  3.4. Command line utility ndsftp
  --------------------------------
  The utility allows the user to log off and disconnect from
  the SFTP server without unmounting the SFTP resource. The
  connection will be reestablished when the resource is accessed
  again.
  
  The following command will close the SFTP connection for
  a SFTP resource mounted at s:\path_to_sftp:
  
  ndsftp logoff s:\path_to_sftp
  
  
  4. Known limitations and problems
  _________________________________
  
  The following issues might limit the plugin use:
  
      * OS/2 extended attributes (EA) are not supported.
      
      
  5. Revision history
  ___________________
  
  TYPE DESCRIPTION
  ---- --------------------------------------------------------
  21 July 2016 Version 3.1.5
  ---- --------------------------------------------------------
  NEW  ndsftp command line utility
  FIX  compatibility with OpenSSH
  FIX  disconnect from the server when resource is unmounted
  ---- --------------------------------------------------------
  6 August 2011 Version 3.1.4
  ---- --------------------------------------------------------
  CHG  New contact e-Mail: netdrive@bmtmicro.com
  FIX  compatibility with ServU SFTP server
  ---- --------------------------------------------------------
  7 January 2011 Version 3.1.2
  ---- --------------------------------------------------------
  FIX  allow to specify server:port in resource properties
  FIX  connection dropped in rare cases
  ---- --------------------------------------------------------
  6 July 2008 Version 3.1.1
  ---- --------------------------------------------------------
  NEW  sftpauth GUI login dialog utility.
  NEW  Default remote directory can be specified for
       the SFTP resource.
  FIX  Performance improvements.
  FIX  Network stability fixes.
  FIX  Implemented the directory moving.
  FIX  Use the password from the resource properties,
       if specified.
  ---- --------------------------------------------------------
  20 November 2007 Version 3.1.0
  ---- --------------------------------------------------------
  NEW  Initial version.
  ---- --------------------------------------------------------
  
  
  6. Support
  __________
  
  Support is available for registered customers via email:
      netdrive@bmtmicro.com
  
  
  7. License agreement
  ____________________
  
  7.1. SSH File Transfer Protocol Plugin License
  ----------------------------------------------
  Use of the SSH File Transfer Protocol plugin ("Software") is
  subject to the following terms and conditions.
  
  Demo version
  
  The demo version of the Software can be used without any
  limitations, so long as this does not violate the
  NetDrive for OS/2 license.
  
  Full version
  
  You may not distribute the full version. You may copy it onto
  a computer to be used and you may make archival copies of it 
  for the sole purpose of backing up the software and protecting
  your investment from loss.

  You may threat your full version just like a book. This means
  that the full version may be used by any number of people, and
  may be freely moved from one computer location to another,
  so long as there is NO POSSIBILITY of it being used at one
  location or on one computer while it is being used at another.
  
  Just like a book cannot be read by two different people in two
  different places at one time, neither can the full version
  of the "Software" be used by two different people in two 
  different places at the same time (unless, of course, 
  the license is being violated).
  
  Disclaimer
  
            BMT Micro, Inc. does not warrant that
  the "Software" will meet your requirements, that operation of
  the "Software" will be uninterrupted or error-free, or that all
  "Software" errors will be corrected. The aforementioned parties
  are not responsible for problems caused by changes in the operating
  characteristics of computer hardware or computer operating systems
  that are made after the release of the "Software" nor for problems
  in the interaction of the "Software" with other software.
  
  The aforementioned parties have no responsibility to replace or
  refund the fee of and media or license damaged by accident, abuse
  or misapplication.
  
  7.2. Third Party Disclaimer
  ---------------------------
  SSH File Transfer Protocol plugin includes PuTTY SSH implementation.

  PuTTY is copyright 1997-2007 Simon Tatham.

  Portions copyright Robert de Bath, Joris van Rantwijk, Delian Delchev,
  Andreas Schultz, Jeroen Massar, Wez Furlong, Nicolas Barry, Justin Bradford,
  Ben Harris, Malcolm Smith, Ahmad Khalifa, Markus Kuhn, and CORE SDI S.A.

  Permission is hereby granted, free of charge, to any person obtaining a copy
  of this software and associated documentation files (the 'Software'), to deal
  in the Software without restriction, including without limitation the rights
  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  copies of the Software, and to permit persons to whom the Software is furnished
  to do so, subject to the following conditions:

  The above copyright notice and this permission notice shall be included
  in all copies or substantial portions of the Software.

  THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
  SIMON TATHAM BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
  IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
  CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.  
  
  7.3. Demo version note
  ----------------------
  The demo version can only use one SFTP server at a time.
  
  _____________________________________________________________
  
  (C) COPYRIGHT NetDrive Development 2007-2016.
  ALL RIGHTS RESERVED.
