SFTP Service Provider

Location: Available from the File Servers Window

The SFTP Service Provider Properties window contains the settings used to connect to an SFTP (SSH) server for File Triggers and File Operation Tasks.

If you are connecting to an FTP server, create an FTP Service Provider instead. SFTP is not the same as FTP.

Property Pages

SFTP Settings

Server Address

Enter the DNS name or address of the SFTP server.

Port

Enter the port to connect to. This is generally port 22.

Authentication

The following forms of authentincation are supported for SFTP. Select the option required by your server.

• User ID and Password. Enter the user ID and password for the account.

• User ID and Private Key. Enter the user ID for the account.

  Then select the file that contains your private key (provided by the server administrator). adTempus supports private keys in OpenSSH format (file extension .pem) or PuTTY format (file extension .ppk). Once you have selected the file, the contents are saved in adTempus and the original file is no longer needed by adTempus.

  If the private key file is encrypted, you must enter the private key password when you import the key.

• User ID, Password, and Private Key. Enter all user ID, password, and private key information as described for the two options above.

Expected host key fingerprint

To have adTempus confirm the identity of the SSH server on each connection, enter the host key fingerprint for the server. If no fingerprint is specified, adTempus will not validate the server's identity. The easiest way to obtain the key fingerprint is to use the Test button to validate the connection. When you do this, adTempus will show you the key fingerprint and prompt you to save it for future validation.

Preserve timestamp on upload

When this option is checked, adTempus will attempt to preserve each file's timestamp when uploading files. If the option is not checked, the server will set the timestamp to the current date/time.

Preserve timestamp on download

When this option is checked, adTempus will attempt to preserve each file's timestamp when downloading files. If the option is not checked, adTempus will set the timestamp to the current date/time.

Use temporary file during upload5.0 Server version 5.0 or later
Console version 5.0 or later

When this option is checked, adTempus uploads each file to a temporary file name, then renames the file to the final file name after the upload completes. This ensures that a partial file is not left on the server in the event of an upload failure, and reduces the chances that a process on the remote server tries the read the file while it is being uploaded. In some cases this approach may not work correctly (for example, if the user does not have permission to rename files on the server). In this case, uncheck this option to upload the file directly to the final name.

Proxy

If adTempus needs to go through a proxy server to connect to the file server, specify the proxy information here.

Proxy Type

Select the type of proxy server:

• None (no proxy server is used)
• HTTP
• SOCKS4
• SOCKS5
• FTP
• SSH (tunnel through an SSH server)

Server Address

Enter the DNS name or address of the proxy server.

Port

Enter the port to connect to on the proxy server.

Authentication Type

Select the type of authentication that the proxy server uses, and enter the user ID and password if needed.

The supported authentication types for HTTP proxies are:

• Basic
• NTLM

The supported authentication types for FTP proxies are:

• Automatic. adTempus will attempt to determine the correct authentication type
• SITE host
• USER user@host
• USER with login
• USER/PASS/ACCT
• OPEN host

The supported authentication types for SSH tunnels are:

• User ID and Password. Enter the user ID and password for the account.

• User ID and Private Key. Enter the user ID for the account.

  Then select the file that contains your private key (provided by the server administrator). adTempus supports private keys in OpenSSH format (file extension .pem) or PuTTY format (file extension .ppk). Once you have selected the file, the contents are saved in adTempus and the original file is no longer needed by adTempus.

  If the private key file is encrypted, you must enter the private key password when you import the key.

• User ID, Password, and Private Key. Enter all user ID, password, and private key information as described for the two options above.

Expected host key fingerprint

To have adTempus confirm the identity of the SSH server on each connection, enter the host key fingerprint for the server. If no fingerprint is specified, adTempus will not validate the server's identity. The easiest way to obtain the key fingerprint is to use the Test button to validate the connection. When you do this, adTempus will show you the key fingerprint and prompt you to save it for future validation.

Notes

Enter an optional description or notes for this provider.

Security

The Security page contains a standard Security Editor used to managed permissions for this server definition.

Test

When you click the Test button adTempus will attempt to connect to the SFTP server using the settings you have provided.