Using the SSH Connection Manager
The SSH Task can be used to create an SSH Connection and consists of four pages:
- General
- Proxy Settings
- Key Settings
- Miscellaneous Settings
General Page
The General page on the SSH Connection Manager allows you to specify general settings for the connection.
- Host Name
-
The Host Name represents the Server containing your SSH server.
- Port
-
The Port contains a default value of 22.
- Authentication
-
- Username
-
Enter the username for the SSH connection.
- Password
-
Enter the password for the SSH Connection.
- Path to Key File
-
You could select the Browse button for the Path to Key File parameter to find the location of the Key for the Username account of your SSH server.
- Key File Password
-
Specify the password for the key file.
- Test Connection
-
After all the connection information has been provided, you may click the Test Connection button to test if the connection settings entered are valid.
Proxy Settings Page
The Proxy Settings page on the SSH Connection Manager allows you to specify the proxy settings for the connection.
- Proxy Type
-
The Proxy Type option lets you select if you are using a Proxy, and if so, what type.
- None
- Socks4
- Socks4a
- Socks5
- HTTP Connect
- Proxy Server
-
Using the Proxy Server option allows you to specify the name of the proxy server for the connection.
- Port
-
The Port option allows you to specify the port number of the proxy server for the connection.
- Username
-
The Username option allows you to specify the proxy user account.
- Password
-
Using the Password option (under Proxy Server Authentication) allows you to specify the proxy user's password.
Note: The Proxy Password is not included in the connection manager's ConnectionString property by default. This is done by design for security reasons. However, you can include it in your ConnectionString if you want to parameterize your connection manager. The format would be ProxyPassword=myProxyPassword; (make sure you have a semicolon as the last character). It can be anywhere in the ConnectionString.
Key Settings Page
- Key Exchange Algorithms
-
Specify the list of key exchange algorithms in order of preference.
- Use Legacy Group Exchange
-
This option can be unchecked to disable Use Legacy Group Exchange. By default, this option would be enabled.
- Encryption Algorithms
-
Specify the list of acceptable symmetric encryption algorithms in order of preference.
- Host Key Algorithm
-
Sets the preferred host key (server key) algorithm.
- Preferred Host Key Algorithm
-
You can choose the Host Key algorithm from the given list:
- Certificate
- DSS
- ESDsaNistP256
- ESDsaNistP384
- ESDsaNistP521
- ED25519
- RSA
- Minimum RSA Key Size
-
Sets the minimum allowed size of the RSA key. The default size is 1024.
Miscellaneous Settings Page
- Timeout (secs)
-
The Timeout (secs) option allows you to specify a timeout value in seconds for the connection. The default value is 120 seconds.
- Keep Alive Interval
-
The Keep Alive Interval option allows you to specify the interval of sending the empty packet to the prevent connection from being closed by SSH-unfriendly routers along the way during no activity. The default is 0, which means no empty package will be sent.
- Encoding
-
The Encoding option allows you to specify the encoding code to read the file system information on the SSH server.
- Use Compression
-
Enable this option to use compression.
- Path To Log File
-
The Path To Log File option allows you to specify the file path to write the SSH communication log to.
- Output Log
-
Enables this option to have an output log.
- Log Level
-
There are several options available:
- Off: default
- Error: logs error messages only
- Info: logs important informative messages as well
- Debug: logs all messages useful for debugging purposes
- Verbose: very detailed log for advanced analysis; logs content of communication packets