Using FAOPGP
FTP'ing Files
FAOPGP CLS totally automates the process of retrieving and sending files to and from your web server(s). You can use this facility to retreive protected (encrypted) / unprotected files which FAOPGP CLS will unprotect (decrypt) / protect (encrypt) locally or to upload protected / unprotected files up to a web server.
For example you might want to protect files and upload them to a web server (so other people can retrieve them securely) or retrieve protected files and unprotect them locally (on your hard disk).
You can also use the FTP features of FAOPGP CLS without having to protect or unprotect files (just select the FTP only check box). This is useful in cases where you want to download a file, run a DOS command and then call FAOPGP CLS to perform cryptographic functions or simply just to move files from one server to another.
See also FTP command line parameters
Retrieving files from a web server
Select the FTP radio button from the 'Input Files / Directories' section in the FAOPGP CLS command editor
and then press the
button. The following dialog is displayed :
Profile
Enter a name here to identify the server you are connecting to. This name is purely for your own use so you can recognize what server the parameters relate to. Press the
button to save these parameters to the keystore for future use. Existing profiles can be deleted by selecting them from the pull-down list box and pressing the
button.
Server
Enter the name of the server you want to connect to.
Username
Enter the user (logon) name for the server.
Password
Enter the logon password for the server. NOTE: FAOPGP CLS automatically encrypts the password you enter here under your keystore password.
Port
Enter the port number you normally use to connect to this server. If you do not know this value leave it as 21.
Download directory
Enter the folder where you want to download files to.
Transfer type
Ascii - select this option for files that have been protected in .asc format.
Binary - select this option for files that have been protected in .pgp format.
Some firewalls or filters may be set to reject binary files (because these may be hostile code). In which case the file should be encrypted in .asc format and the Ascii option used for transfer. Please be aware that an ascii file may be 30% larger than its binary equivalent.
IMPORTANT NOTE: Make sure both parties transfer files of type PGP in Binary format. If a file of type PGP is transferred in ASCII format you will receive a java.io.IOException error message on decryption because the file has been corrupted and therefore cannot be decrypted.
Connection type
Active - some servers require this type of connection. Switch to this mode if you have trouble connecting in passive mode.
Passive - use this option if you are using a firewall.
Once you have entered the settings above, press the
button.
Input List Contains Only Files![]()
You will need to check the 'Input List contains only files' checkbox if you are connecting to an FTP server hosted by a non-Unix / Linux / Windows environment such as IBM OS390 or the filename you are retreiving has no file extenstion. If this option is checked the file that you want to download must be in the directory that you log on to. Also note that some servers have FTP software installed on them that require you to specify the current directory first so you will need to enter ./ before your filename(s). For example ./myfile.pgp instead of myfile.pgp.
The wildcard character is not supported when you select this option. Instead it is treated as part of the filename just like any other character. So specifying *.doc.pgp will download a single file called *.doc.pgp instead of all files with a .doc.pgp extension.
Rename![]()
Here you can specify a new name for the file that will be downloaded. For example, you might want to download a file from a server and rename it before encrypting it and uploading it to a new server. Wildcards are also accepted here for the multiple renaming of file extensions.
Delete Files from Server after Download![]()
If you check this box then the file(s) you are downloading will get deleted from the server once they have been successfully downloaded to your local disk. This action performs a normal delete of the file(s) and NOT a secure delete.
Input files
You must now specify the files you want to retrieve via the 'Input files' field below. Type in the folder and filenames that you want to retrieve and press the
button to add them to the list.
In the example above, files of type .pgp in the Documents folder will be downloaded from the server.
To remove files/folders from the list, highlight them in the window and press the
button.
Select the
checkbox if you want sub-folders to also be actioned on.
Please see the Command Editor for all other options.
Uploading files to a web server
Select the 'Upload output files by FTP' checkbox in the FAOPGP CLS command editor.
press the
button and enter your FTP connection properties as explained above. If you had previously saved a Profile it will be available from the pull-down list box.
The only difference is that an 'Upload directory' is now specified. In this field enter the folder where you want the files uploaded to. In the example above, files are uploaded to a folder off root called "Protected". This could have also been specified as "/Protected".