SFTP Connections

The SFTP Connections window allows you to configure and manage the SFTP connections used in the available SFTP actions.

SFTP connections support the SSH.NET library version 2024.1.0.

Note: Only users with Owner and Contributor roles can manage SFTP connections.

The window shows the:

1. Main toolbar – Basic search
2. SFTP connections list
3. Bottom toolbar – New connection button

1. Main toolbar

Basic search filter

Click on the Basic search button to search the SFTP connection by Connection name.

2. SFTP connections list

It shows the SFTP connections that are currently added to the tenant. It displays the following data:

Column	Description
Connection name	A user-defined label for the SFTP connection.
Host server address	The host name of the SFTP server.
Port number	The network port used for the SFTP connection.
User name	The username for authenticating to the SFTP server.
Delete connection	The button to delete the SFTP connection. After clicking it, a dialog appears to ask for confirmation.

Note: All values must be entered manually by the user when creating a new SFTP connection.

3. Bottom toolbar

New connection button

To add a new SFTP connection:

1. Click on the New connection button.
2. Enter the SFTP connection details:

Field	Description
Name	Enter a descriptive name for your connection.
Host	Enter the host name of the SFTP server. It is provided by the server administrator or the relevant documentation.
Port	Enter the network port used for the SFTP connection. The default SFTP port is 22, but it might vary depending on the server configuration.
User	Enter the username for authenticating to the SFTP server. This is assigned by the server administrator and must be known in advance.
Authentication type	Select the desired radio button. See the Authentication type fields table below for the fields for each option.

Authentication type fields

Depending on the selected Authentication type, a different set of fields is displayed.

Authentication type	Field	Description
Password	Password	Enter the password associated to the User.
	SSH hostkey fingerprint	Enter the SSH key of the server to verify its identity.
SSH private key	SSH private key	Enter the full contents of the private key file.
	SSH private key passphrase	For added security, enter the key passphrase if the matching key requires one.
	SSH hostkey fingerprint	Enter the SSH key of the server to verify its identity.
Dual	Password	Enter the password associated to the User.
	SSH hostkey fingerprint	Enter the SSH key of the server to verify its identity.
	SSH private key passphrase	For added security, enter the key passphrase if the matching key requires one.

SSH private key authentication

Only OpenSSH formatted keys are allowed. Also make sure that the private key is properly formatted. Missing characters and/or incorrect formatting will result in an error.

Note: The length of the SSH private key data has been reduced to simplify this example.