When you have specified From File as the source component for a channel, you can indicate that the files that are received by this channel are obtained from an FTP server. To do this, select the Download from FTP to source directory check box.

	New Feature in Iguana 4.5 The Download from FTP to source directory feature is new in Iguana 4.5.

When this check box is selected, additional fields appear that enable you to provide information about the FTP server from which the files are to be obtained:

• From the FTP protocol list box, select the FTP protocol that you want to use. You can select FTP (standard FTP), FTPS (FTP over SSL) or SFTP (Secure Shell FTP).
• In the FTP server field, type the name of the FTP server from which you will be obtaining the files.
• In the FTP port field, type the port that the FTP server is using. If you are using the FTP protocol, this is usually port 21. If you are using FTPS, this is usually port 990. If you are using SFTP, this is usually port 22.
• In the FTP username field, type the username that you use to access the FTP server.
• If your FTP server requires a password for access, type the password in the FTP password field.
• In the FTP path field, type the location of the directory on the FTP server from which the obtained files are to be retrieved. How this field is interpreted depends on the protocol that you are using. See the note below for more details.

	If you are using the FTP or FTPS protocol, the directory specified in the FTP path field is relative to the home directory for the FTP user. For example, if the FTP user is iguanauser and the user's home directory is C:\iguanauser\FTP, specifying iguanadir in the FTP path field indicates that files should be read from C:\iguanauser\FTP\iguanadir. If you are using the SFTP protocol, the FTP path field must contain the full path of the directory from which files are to be read. If the FTP path field is empty, the files are obtained from the user's home directory if you are using the FTP or FTPS protocol, and from the FTP server's root directory if you are using the SFTP protocol.

If you have selected FTPS from the FTP protocol list box, fields appear that enable you to specify encryption information:

• In the Certificate file field, type or browse for the location of your certificate file.
• In the Private key file field, type or browse for the location of your private key file.

	For information on how to create a public/private key file, see Creating Public/Private Key Files.

• If you want to verify the authenticity of the server that is sending you messages, select the Verify peer check box. If the Verify peer check box is selected, the Certificate authority file field is displayed:

• In the Certificate authority file field, type or browse for the location of the certificate authority file.

If you have selected SFTP from the FTP protocol list box, fields appear that enable you to specify how to authenticate your connection:

From the Authentication list box, select the type of SFTP authentication to use (either Username/Password or Private/Public Key).

If you have selected Username/Password from the Authentication list box, the FTP Options section of the Source screen will appear as shown above. Continue as follows:

• In the FTP password field, type the password that your FTP server is expecting.
• Select the Verify host fingerprint check box to verify the authenticity of the server that is receiving the messages.

	New Feature in Iguana 4.5.3 The ability to specify a password when using the SFTP protocol is new in Iguana 4.5.3. Host fingerprint verification is new in Iguana 4.5.3.

If you have selected the Verify host fingerprint check box, the Host fingerprint field appears:

This field contains the host fingerprint, which is a 32-character string created using the MD5 cryptographic hash function. If the field is empty, click the Get Fingerprint link to obtain the host fingerprint.

If you have selected Private/Public Key from the Authentication list box, the FTP Options section of the Source screen displays the fields shown below:

Continue as follows:

• Select the Verify host fingerprint check box to verify the authenticity of the server that is receiving the messages. If you have selected this check box, the Host fingerprint field appears:

This field contains the host fingerprint, which is a 32-character string created using the MD5 cryptographic hash function. If the field is empty, click the Get Fingerprint link to obtain the host fingerprint.

• In the Private key file field, type or browse for the location of your private key file.
• In the Public key file field, type or browse for the location of your public key file.

	If you have selected Private/Public Key from the Authentication list box, you will need to configure your FTP server's SSH daemon so that it will not prompt for a password when Iguana is downloading files. For information on how to create a public/private key file, see Creating Public/Private Key Files.

At the bottom of the FTP Options section, fields enable you to specify how reconnection should be handled and what to do with downloaded files:

• From the Attempt to reconnect? list box, select whether you want Iguana to try and reconnect to the FTP server if an initial connection could not be made or if the connection is dropped. Select No if you do not want Iguana to reconnect, Yes (unlimited) if you want Iguana to keep trying to connect forever, or Yes, with limit if you want Iguana to make a limited number of reconnection attempts.
• If you select Yes, with limit from the Attempt to reconnect? list box, a text field appears:

In this text field, type the amount of times that Iguana should try to connect before giving up.

• If you select Yes, with limit or Yes (unlimited) from the Attempt to reconnect? list box, the Reconnection interval text field is displayed. In this field, type the number of milliseconds that Iguana should wait before trying to connect again.
• In the Action to perform on downloaded files section, select a radio button to specify what to do with the files on the FTP server after they have been obtained. Select either Delete remote files after downloading or Move remote files after downloading to another remote directory.
• If you have selected Move remote files after downloading to another remote directory, a field appears that enables you to specify the FTP path for downloaded files:

• In the FTP path for downloaded files field, specify the FTP path for the downloaded files.