SSH client keys are used to authenticate Jitterbit with external resources such as SFTP servers. This page describes how to use SSL client keys specifically for SFTP connections (used with Cloud Studio FTP endpoints or Design Studio FTP sources/targets), and how to convert keys to an appropriate format for Jitterbit Harmony Private Agents.
NOTE: Connecting to SFTP with SSH keys requires using a Jitterbit Harmony Private Agent.
You can use public/private key authentication for SFTP connections. In order to use key authentication, you must have the appropriate keys in an OpenSSH format. If your keys are not in an OpenSSH format, see these instructions below for how to convert keys to the required format.
Configure Private Agent to Use SSH Keys
Once you have public and private keys in an OpenSSH format, you can specify that the keys are to be used in the Jitterbit configuration file.
Under the [SSH] section, the configuration should be edited to include the paths of the public and private keys and, if applicable, the passphrase. These keys will then be used for SSH by default. For example:
Multiple sets of keys can be included and configured by using Jitterbit variables to override the default keys. For example, you can set these source or target variables equal to a string in a Jitterbit script that is part of an operation:
Then, you provide matching entries using that ID as a suffix in the Jitterbit configuration file. For example, using the above ID of
These entries would then be used for SSH when required.
To return to using the default SSH keys, reset the appropriate variables back to empty strings:
After making configuration changes, always restart the Jitterbit agent in order for the changes to take effect. See Editing the Configuration File - jitterbit.conf for additional information.
Configuring an SFTP Connection in Studio
Now you are ready to configure your SFTP connection in the Studio project design application.
- Host: The servername or IP address of the SFTP server. (Required.)
- Port: The default port for SFTP is 22. If the server is configured for a different port for SFTP, clear the Use Default Port checkbox and specify the port. (Required.)
- Security Options: Use the dropdown to select SFTP.
- Username: Enter the login name for the server.
- Password: Since keys are being used for authentication, leave empty to pass a blank password.
Add any additional settings and specifications that are required to configure the connection or activity for your requirements.
Host: The servername or IP address of the SFTP server. (Required.)
- Port: The default for SFTP is 22. If the server is configured for a different port for SFTP, specify the Port by deselecting the Use default port checkbox.
- Path: Enter the path(s) to read files from, if your account on the SFTP server is not set to switch automatically to the desired location.
Login: Enter the login name for the server. (Required.)
Password: Since keys are being used for authentication, leave empty to pass a blank password.
- Get Files: Enter the desired names for the source file(s). Wildcards and variables may be used in this field. (Required.)
Options: Expand the Options. Under Security Options, select SFTP.
Add any additional settings and specifications that are required to configure the source or target for your requirements.
Convert a Key to OpenSSH Format
- PuTTYgen is recommended as the application to use to generate SSH keys for use in Jitterbit. On the Windows OS, it comes with a GUI interface.
- The private key to be used to create a public key in an OpenSSH format. The private key file may have a .ppk or a .crt extension.
Step 1 – Load the Private Key
Open PuTTYgen application. Either use the menu File > Load private key or click the Load button, and select the private key file that's to be converted:
Step 2 – Open the Private Key
Once the private key file has been loaded, enter its key passphrase—if required—in the dialog. A passphrase is not required.
Step 3 – Convert and Save the Private Key
To create—from the private key—a private key in the OpenSSH format, use the menu Conversions > Export OpenSSH key.
The public key file data in the OpenSSH format is in the text box labeled "Public key for pasting into OpenSSH authorized_keys file:"
Step 4 – Save the Public Key
To save the public key to a file, either use the menus File > Save public key or click the Save public key button.
The files created can then be used as described above on the Jitterbit Private Agent with the private key. The public key would be placed on the SFTP server and used for authentication.