|
pbFtpClient is an application, written mostly in Power Script (PowerBuilders native programming language), which uses the Windows Winsock API to perform the following:
- Connect to ftp servers.
- View files on Ftp servers.
- Transfer files from your local file system to Ftp servers.
- Download files to your local file system from Ftp servers.
- Upload and download multiple files in sequence.
- Upload and download entire directories of files, recursive.
- Added Scintilla: Source Code Editing Component.
- Connect to remote ftp sites using Proxy server connections.
- Supports S/KEY one-time password authentication with MD4,MD5,SHA-1 encryption.
- Support SFTP and FTP/S (AUTH SSL,TLS) protocols.
- SSL Certificates, Cert Requests, PrivateKeys (PEM format) and PublicKeys (OpenSSH).
- SFTP Secure Fingerprint.
- Export/Import Sites Favorites (XML format).
- Check/Download/Install latest updates using Check for Updates.
- Manage multiple open connections with new Connection Manager feature.
- Download files for editing then upload changes to server.
- Raw FTP Command Builder.
I purchased an Ftp Server named WinFtpServer which I used during all phases of development and will use to illustrate Ftp Client functionality; you can download WinFtpServer at http://www.wftpserver.com.
The server is running and waiting for commands.
Start à
Programs à Ftp Client à pbftpclient.exe
Ftp Client Browser
(1)
Sites - User defined ftp connection properties
(2)
Explorer - Local file system window
(3)
Transfer Queue - Files are queued prior to transfer. (Ftp Client only supports synchronous transfers for queued files. For queued directories it will open a secondary connection).
(4)
Ftp server file system window
(5)
Ftp command window. (Display and Printing only)
(6)
Bytes Sent to the ftp server
(7)
Bytes Received from the ftp server
(8)
Enable/Disable detailed logging in ftp command window
(9)
Connect to the most recent Site
(10)Disconnect from the current Site
(11)
Download files to the local file system which are queued for download from the ftp server
(12)Upload files to the ftp server which are queued for upload from the local file system
(13)Get the ftp server current directory listing
(14)Print the ftp command window text
(15)Disconnect from the ftp server if connected and close the Ftp Client browser
(16)Delete selected file(s) from the Queue
(17)Remove all files from the Queue
(18)Drag/Drop selected file(s) from the Queue for deletion.
(19)Ftp Client browser status
(20)
Running total of bytes received from the ftp server for the current connection
(21)Running total of bytes sent to the ftp server for the current connection
(22)
New!! Critical errors. Double click to open current errors in client.
(23)
Activity
(24)
Current ftp server user connection
(25)
System Clock
(26)
Current directory of the local file system
(27)
Change local directory
(28)
Search for files in local file list
(29)
Refresh local file list
(30)
Delete file(s) from local directory
(31)Transfer file(s) from the local file list to the ftp server’s current directory
(32)
Transfer file(s) from ftp server’s current directory file list to the current local directory
(33)
Current directory of the ftp server
(34)
Refresh ftp server directory file list
(35)
Change ftp server directory (Traverse one directory level up relative to the current path. If you are at the root or top most level this will do nothing.)
(36)
Delete file(s) from the ftp server directory
(37)
Opens the Ftp Client browser
(38)
Print the ftp command window text
(39)
Printer Setup
(40)
Disconnect from the ftp server if connected and close the Ftp Client browser
(41)Display/Hide ftp command toolbar
(42)
External Program Setup
(43)
Exit
File System - Popup Menu
Right click on local or ftp server file list->pop menu
(44)
Create Dir - Make new local or remote directory.
(45)
Delete - remove local or remote files and directories. Note A
(46)
Rename - rename local or remote files. Note B
(47)
View - Open local or remote file for viewing in its associated external program. Note C
Notes:
A. Remote directory must be empty to be deleted.
B. Rename directory is not supported.
C. Associate file types with external programs using External Program Setup. (42)
Right click on Favorites: ODBC db=SOCKETS
Create Site: Create new site configuration.
Export Sites: Export sites to <Application Directory>\archive\ pbFtpClient-Sites.xml.
Import Sites: Import sites file pbFtpClient-Sites.xml or older versions of this file.
Right click on site.
Disconnect: Disconnect from the selected site.
Delete: Delete the selected Site.
Properties: Open the configuration settings for the selected site.
FEAT: Invoke the FEAT command for the selected site. Display ftp site extended features.
STAT: Invoke the STAT command for the selected site. Display connection status.
Transfer -> ASCII: Changes transfer type to ASCII for the selected site.
Transfer -> Binary: Changes transfer type to Binary for the selected site.
External Programs: External programs for file viewing.
Toolbar: Display Ftp Command Toolbar
Global Settings: Open Global Connection and Proxy Settings
Local file system has been enhanced to enable you to traverse to the previous directory without having to use the Change local Directory button (27).
Recursive file uploads and downloads.
Download the latest updates without having to re-install.
If updates are available the Star indicator in the lower right corner of the screen will display Update! Double-click the Star indicator to download updates. An application restart may be necessary depending on the impact of the updates. Upon restart the latest sites configuration file will be loaded. The location of the sites configuration file is C:\Program Files\Level 5 Software\FtpClient\archive\ pbFtpClient-Sites.xml. Sites are backed up automatically each time the application is closed.
PowerBuilder files can be downloaded and viewed in the new Scintilla based editor. Scintilla*, the free source code editing component first used to build SciTE* a SCIntilla-based Text Editor Copyright 1998-2003 by Neil Hodgson adds a PB like editing capability and look and feel to the built in file viewer.
How to configure:
Menu -> Options -> External Programs (PB Tab)
Switch between the default editor and the SCIntilla-based Editor and also change the margin background and text colors.
If you are behind a firewall and cannot access ftp sites directly pbFtpClient can connect to proxy servers using standard and custom authentications.
Site Proxy Settings
Select right-click the site to open Site properties. In Site Properties tab to Firewall and fill in the proxy server address and port information then select the appropriate authentication type required to authenticate to the proxy server.
USER user@site:Proxy Server requires ftpsiteuserid@ftpsiteaddress to be passed in the USER command. @ separator can be configured to which ever symbol the proxy server requires.
SITE site:Proxy Server requires ftpsiteaddress to be passed in the SITE command.
USER with login:Proxy Server requires USER and PASS commands with USER user@site.
USER user@site fw_user:Proxy Server requires ftpsiteuserid@ftpsiteaddress firewalluserid to be passed in the USER command. pbFtpClient will pass the filewallpassword to the proxy server in the ACCT command. Note: firewalluserid and firewallpassword can be saved in the Username and Password boxes directly under the Use Authentication check box.
OPEN site:Proxy Server requires ftpsiteaddress to be passed in the OPEN command.
Custom:pbFtpClient will execute authentication commands in the order you define.
Check Use Site Specific Proxy Settings checkbox to use the settings defined in the Firewall Tab for the Site. If you uncheck this box the global proxy settings will be used. Refer to menu -> Options -> Global Settings.
Global Proxy Settings
Proxy settings defined here will be used by all connections which do not have the Use Site Specific Proxy Settings checkbox checked.
S/KEY one-time password authentication with MD4,MD5,SHA-1 encryption
pbFtpClient supports OTP (One-Time-Password) Authentication. In site properties tab to Action and choose the encryption type required to authenticate to the ftp server. Choose Auto Detect OTP if you want pbFtpClient to decide when to use encryption. Auto Detect determines which encryption method to use by parsing the server response.
Choose Use Global to use the global password encryption settings. Refer to menu -> Options -> Global Settings.
Global Settings
Connection Attempts and Delay: If the initial attempt to connect to the ftp server fails pbFtpClient will initiate n attempts to connect at n second intervals.
Server Type: Ftp server is Unix or Windows based.
Connection Type:PORT or PASV. Use PORT if the ftp server can initiate a data connection to an IP address and Port on the ftp client computer. Use PASV if the ftp server cannot access your computer due to firewall limitations. In passive mode pbFtpClient will initiate the data connection to an IP address and Port on the ftp server computer.
Transfer Type: Ascii or Binary. Use Ascii for text based files only. Use Binary for files which are executables or contain images. Binary works best for all file types.
Password Encryption:MD4,MD5 or SHA-1 encryption methods required to authenticate to the ftp server.
File Case for Uploads:Use this if you wish to change the filename to upper or lower case when uploading files to the ftp server.
Site Settings
 
Connection settings can be defined for each Site. Select right-click on the site then select Properties. At site properties tab to Action for Connection Type, Transfer Type, Password Encryption and File Case or tab to Connection for Connection attempts and delay.
On the Connection tab there is a check box property named Use Site Specific Connection Settings. If this check box is unchecked pbFtpClient will use Global Settings for (1) Connection attempts and delay and (2) After Connected Change Directory to Local Path.
On the Action tab there is a property named After Connected Change Directory to Remote Path. This is a site specific property and does not have a corresponding Global setting since remote directories are specific to each ftp site.
Manually export Sites favorites to XML or Import Site configuration file.
The location of the sites configuration file is C:\Program Files\Level 5 Software \FtpClient \archive\
pbFtpClient-Sites.xml.
Note: Sites are saved to pbFtpClient-Sites.xml automatically each time the application is closed. The auto-save process performs overwrite and does not create backup files. When you manually Export Sites, pbFtpClient renames the current file to pbFtpClient-Sites.xml.<date>.<n> then writes a new file named pbFtpClient-Sites.xml which becomes the current site configuration file.
Version 4.2 introduced support for FTP proxy servers. New for version 4.3 are the following additional proxy protocols.
Site Proxy
Settings
SOCKS4
SOCKS5
Web (using web
CONNECT)
Relay
SOCKS4a
Windows
New for version 4.3 are the following secure protocols.
Site General
Settings
FTP + TLS/SSL; alias FTP/S or FTPS (AUTH - Explicit with insecure data channel)
FTP + TLS/SSL; alias FTP/S or FTPS (AUTH - Explicit with secured data channel)
FTP + TLS/SSL; alias FTP/S or FTPS (Implicit on Port 990)
SFTP using SSH2 (Secured Shell)
Notes:
1.
FTP proxy is not supported by the secure ftp protocols listed above. You will need to use SOCKS or WEB Standard proxy types if a proxy is required for authentication.
2.
FTP/S (FTP +SSL Secured Sockets Layer or more recent FTP + TLS Transport Layer Security), pbFtpClient will always use AUTH TLS if TLS is supported. You have a choice to select SSL/TLS with encrypted data channel or unencrypted data channel. If you select secured data channel PROT P command will be issued and the data channel will be encrypted. If you select insecure data channel PROT C command will be issued and the data channel will be clean or unencrypted.
3.
SFTP - Simple File Transfer Protocol
Import/Create SSL certificates; certificate requests, private and public keys for TLS/SSL authentication handshake.
Import:
If you need to use certificate authentication and you have a signed certificate by a Certificate Authority such as Verisign, etc., you will need to enable Use Certificate when Authenticating, import the locations ** of the certificate and privatekey files then enter the passphrase used for privatekey. pbFtpClient will use the certificate when the SSL authentication handshake occurs.
** The easiest way to import the certificate and private key location is to physically store the files in C:\Documents and Settings\<user>\Local Settings\Application Data\Level 5 Software\pbFtpClient\Certificates\ directory.
Create:
You can create a new unsigned certificate by selecting Generate Certificate. The form fields will be pre-populated and will need to be revised to be more accurate and specific to your domain name and organization. Enter the passphrase and select the encryption. Optionally, you can have the certificate imported into Global settings so it can be used for the SSL authentication handshake by checking Set as current certificate. Finally select Create Certificate.
When the certificate is displayed you can optionally install it into the Trusted Certificate Authorities store by selecting Install Certificate.
Select next then follow the steps accordingly.
Select Yes to the security warning since this is not a signed certificate form a CA.
After installation into the CA store you will receive confirmation for the following files which are created in your user certificate directory:
SSLCertificate_*.key Privatekey
SSLCertificate_*.crt Certificate
SSLCertificate_*.csr Certificate Request (You can send this to a CA to get it signed)
SSLCertificate_*.pub Publickey
(You will need to install this key on the ftp server)
If you selected to import the certificate into Global Settings you will receive confirmation if the import was successful. You should now be able to see your certificate and private key locations and the passphrase used for privatekey in Global settings.
View
Certificate:
Opens the Windows Certificate dialog for the current certificate, privatekey and passphrase defined in Global settings.
All
Certificates:
Opens list of certificates saved in your user certificate directory for viewing. Note you will need to supply the passphrase used for privatekey generation in order to view the certificate in the Windows Certificate dialog.
Select the certificate file.
Select View.
Enter passphrase.
Select Ok.
The Windows Certificate dialog will display your certificate.
Enable/Disable SFTP Secure Fingerprint. If you enable this feature and the sFtp server submits a fingerprint at connection time, pbFtpClient will first check if the finger print file exists and store it if not exists or validate it if exists. Fingerprint files are saved to the users fingerprint directory for each remote hostname. If the submitted fingerprint does not match the fingerprint stored the connection will be closed. To re-save a server fingerprint simply delete the existing fingerprint file saved in the following directory.
C:\Documents and Settings\<user>\Local Settings\Application Data\Level 5 Software \pbFtpClient\Fingerprint\<sftphostname>\SSH2-Fingerprint.txt
Enable Colors - enables/disables the log screen text coloring.
Buffer Size - defines number of bytes displayed in the log screen. Setting this to high can result in poor application performance.
Select Sites tab.
Right click on Homeà Properties.
Enter the IP address of the ftp server and the port (Normally 21 for non-secured ftp). The login type is normal which means you will need to have a user account defined on the ftp server with a valid password. If you select Anonymous, Ftp Client will connect the server with a user account named Anonymous. This would require an anonymous account to be defined on the ftp server. The Anonymous account usually has limited access to the ftp server in contrast to a normal user account.
Enter the Username and Password as defined on the ftp server then enter the remote path. The remote path is where you would like to start, within the directory tree your user can access, after a connection is established.
Directory List Method by default is Unix V ls -l. Ftp Client will get the list of directories and files from the ftp server using the Unix style list command which is ls -l on most Unix operating systems. Ftp Client will parse the list returned by the ftp server and display the directories and files in its browser window. Another method available is NLST which consumes more cpu however can be used if the default ls -l method does not return the correct directory listing.
The last two connection options are Features enabled and Stat enabled. With Features enabled Ftp Client will issue the FEAT command. The ftp server will respond by returning the extended command list it supports. Ftp Client will check this list prior to running any of the extended commands it supports internally. FEAT is not supported by all ftp servers. You will know if feat is supported upon connecting to the server.
COMMAND: USER mnardell
RESPONSE: 331 Password required for mnardell
COMMAND: PASS ********
RESPONSE: 230 Logged on
COMMAND: FEAT
RESPONSE: 211-Extension supported
CLNT
PBSZ
PROT
SIZE
SITE PSWD;MSG
211End
WinFtpServer supports FEAT and returns its supported extensions.
With Stat enabled Ftp Client will issue the STAT command. The ftp server will respond by returning the status of the connection. STAT is not supported by all ftp servers. You know if Stat is supported upon connecting to the server.
COMMAND: STAT
RESPONSE: 500 Unknown command .
WinFtpServer does not support STAT and returns 500 Unknown command. Most other Ftp serversdo support STAT, especially Unix based servers.
Select the Save button to save your connection properties.
Select Sites tab.
Right click on Home à Connect.
Ftp Client Connected to Home Site
Change Directory on the ftp server
Double click on a directory in the Ftp server file system window (4). This will change the ftp server current directory to the selected directory. Keep traversing the ftp server directories until you reach the desired directory which has the files you wish to transfer,
Change directory on the local file system
Select the Explorer - Local file system window tab (2). Change the local directory by selecting Change Local Folder button (27). I will change directory to c:\temp.
Start the transfer
In the Ftp server file system window (4) Highlight the file(s) for transfer then select the Left Arrow button (32) to start the transfer. The files will be added to the Queue then one-by-one downloaded to the local directory.
Transfer from ftp server to local directory starts.
When the transfer is complete files are displayed in the local file list.
Change Directory on the ftp server
Double click on a directory in the Ftp server file system window (4). This will change the ftp server current directory to the selected directory. Keep traversing the ftp server directories until you reach the desired directory, I will change to /temp.
Change directory on the local file system
Select the Explorer - Local file system window tab (2). Change the local directory by selecting Change Local Folder button (27). I will change directory to c:\temp.
Start the transfer
In the Local file system window (2) Highlight the file(s) for transfer then select the Right Arrow button (31) to start the transfer. The files will be added to the Queue then one-by-one uploaded to the Ftp server directory.
Transfer from local directory to ftp server starts.
When the transfer is complete files are displayed in the ftp server file list.
Select the file(s) from the Ftp server file system window (4).
Delete selected file(s) from the ftp server by selecting the Delete Remote Files button (36) or right click the Ftp server file system window à popup menu à Delete (45).
Confirm each delete or check Disable this Message to disable confirmation.
Select the file(s) from the local file system window (2).
Delete selected file(s) from the local directory by selecting the Delete Local File button (30) or right click the local file system window à popup menu à Delete (45).
Confirm each delete or check Disable this Message to disable confirmation.
Select a file from the Ftp server file system window (4).
Rename file by right clicking the Ftp server file system window à popup menu à Rename (46).
Rename dialog displays with the selected file name.
Type the new file name then select Ok.
Note: Do not type the path for the file just supply the file name.
Select the file from the local file system window (2).
Rename file by right clicking the local file system window à popup menu àRename (46).
Rename dialog displays with the selected file name.
Type the new file name then select Ok.
Note: Do not type the path for the file just supply the file name.
Right click the Ftp server file system window à popup menu à Create Dir (44).
Create Directory dialog displays.
Type the directory name then select Ok.
Note: Do not type the path for the directory just supply the name.
Select the file from the Ftp server file system window (4). To view file right click the Ftp server file system windowà popup menu à View (47).
The file will be downloaded to the user temp directory then opened in the external program associated with the file type. Currently Ftp Client does not cleanup files in the user temp directory.
Main menu à Setup à External Programs (42)
Files will be opened in the external programs defined here. For example text
Documents will be opened in TextPad.exe (not supplied).
Select right click on the connected Site à popup menu à Disconnect.
You can also disconnect by selecting Logoff button (10) from the ftp command toolbar.
Select Sites tab
(1)
Select right click on Favorites à popup menu à Create Site
Fill in the site connection properties as described in Connecting to the Home Site.
Product Support for Ftp Client is available to users through my website. Please note Ftp Client Technical Support some where at the beginning of your message.Please be sure to include the following items when contacting Product Support:
Product version you are using (See Help-About Menu)
Your full name
A brief description of the problem or request.
Website : http://www.level5software.net/
Please direct your technical support questions to: support@level5software.net
Please direct your customer service questions to : service@level5software.net
Internet Programming Using PowerBuilder and WinSock 1.1 by Jason Coombs and Ted Coombs December, 1995 Volume 2 Issue 11 PowerBuilder Developers Journal.
PowerSocket Library by Jason Coombs and Ted Coombs. Version 2.1 - January 8, 1999
Windows Sockets Network Programming by Bob Quinn and Dave Shute.
WFtpServer Copyright 2008 Win FTP
PowerBuilder is a registered trademark of Sybase, Inc. or its subsidiaries.
This software is protected by the United States Copyright laws and international treaty provisions. Unauthorized duplication or distribution of this software,in whole or in part, is prohibited.
System Info Copyright Microsoft Corporation www.Microsoft.com All Rights Reserved
SciLexer.dll (Scintilla: Source Code Editing
Component) Copyright 1998-2003 by Neil Hodgson neilh@scintilla.org All Rights Reserved
License for Scintilla
Permission to use, copy, modify, and distribute
this software and its documentation for any purpose and without fee is hereby
granted, provided that the above copyright notice appear in all copies and that
both that copyright notice and this permission notice appear in supporting
documentation. NEIL HODGSON DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS
SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN
NO EVENT SHALL NEIL HODGSON BE LIABLE FOR ANY SPECIAL, INDIRECT OR
CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
SOFTWARE.
pbEditor v.1.1: written by Roland Smith is
available for free at www.topwizprogramming.com
pslib21.DLL (PowerSockets Library based on
Winsock.h v.1.1 used for standard FTP protocol.)
Initial Version By Jason Coombs and Ted Coombs.
Revisions by Level5Software.net
wodFtpDLX.OCX (Ftp component used for SFTP and
FTP+SSL)
Class name WeOnlyDo.wodFtpDLX.1
Copyright WeOnlyDo! Software www.weonlydo.com All Rights Reserved
wodCertificate.DLL (Certificate component used for
SSL Certificates)
Class name WeOnlyDo.Certificate.1
Copyright WeOnlyDo! Software www.weonlydo.com All Rights Reserved
wodAppUp.OCX (AppUpdate component used for
downloading and installing updates.)
Class name WeOnlyDo.wodAppUp.1
Copyright WeOnlyDo! Software www.weonlydo.com All Rights Reserved
SKeyX.OCX (RaidenSKey component used for S/KEY
MD4/MD5/SHA-1 password protection.)
Copyright RaidenFTPD team, a.k.a. Team Johnlong www.raidenftpd.com All Rights Reserved
|
