Readme
NetDrive for OS/2
SSH File Transfer Protocol plugin
http://www.bmtmicro.com/netdrive
Full featured version of the plugin can be ordered at
https://www.arcanoae.com/shop/sftp-plugin-for-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
—- ——————————————————–
15 July 2016 Version 3.1.5
—- ——————————————————–
NEW ndsftp command line utility
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 at bmtmicro dot 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.
