- This line was added.
- This line was removed.
- Formatting was changed.
SSL client certificate(s) are used to authenticate Jitterbit with external resources. The Client Certificates page of the Management Console allows you to manage SSL certificates used when connecting to HTTPS sourcean HTTP or SOAP endpoint in Cloud Studio or HTTP sources/targets or web services in Design Studio.
|TIP: If instead you would like to use SSH client keys for SFTP connections, see Connecting to SFTP with SSH Keys.|
To access the Client Certificates page, log in to the Jitterbit Harmony Portal, then click the orange hamburger menu in the top left:
From the menu, hover over Management Console > Customizations and select Client Certificates:
Image RemovedImage Added
NOTE: Make sure you are accessing the desired organization. In the top navigation bar, use the dropdown that appears between your name and Help to switch between organizations.
Add New Certificate
To add a new certificate, first use the Environment dropdown to select an environment within your selected organization:
|TIP: You can add certificates for environments residing on either Cloud or Private Agents.|
Then click the Add New Certificate button. Additional fields will become available as follows.
- Certificate Name: Enter a name for your certificate. The name must be unique within the environment.
- Certificate: Browse to the certificate for upload. The certificate must be in PEM format.
Private Key: Browse to the private key file for upload. The key must be in PEM format.
Info NOTE: For instructions on converting a key to the appropriate format, see Convert a Key to OpenSSH Format in Connecting to SFTP with SSH Keys.
- Private Key Pass Phrase: If your key requires a passphrase, enter it here. If it does not require a passphrase, leave this field empty.
- Add / Cancel: Click Add to upload the selected certificate and key or Cancel to close without saving.
Certificates that have already been uploaded will appear within the table on the page. You may also filter the table using the Environment dropdown or by typing a keyword into the Filter text box. Actions available for each certificate appear on the far right:
- Edit: Click edit to reopen the configuration screen and update the fields. You cannot download the certificate or private key, or passphrase,
- Delete: Click delete to remove the certificate.
Use a Certificate inDesign
After you have uploaded certificate(s) within the Management Console, they will automatically be available while configuring your endpoint in either design application:
- HTTP: The option to use a certificate is available in the source or target configuration screen under Options > Security Options. Use the dropdown : During configuration of an HTTP connection, use the Certificate dropdown to select the appropriate certificate.
- SOAP: During configuration of a SOAP connection, use the Certificate dropdown to select the appropriate certificate.
- HTTP: During configuration of an HTTP source or HTTP target, under Options > Security Options, use the Certificate dropdown to select the appropriate certificate. For more information see HTTP Source and HTTP Target.
- Web Services: The option to use a certificate is available in During configuration of a web service method using the configuration wizard, within the Details screen under Additional Details > Security > Certificate. Use the dropdown , use the Certificate dropdown to select the appropriate certificate. For more information see Creating a Web Service MethodWhen editing the configuration of an existing web service method, the Certificate dropdown is available under the Security section.