Using SSL Certificates and Java Keystores

Some secure sites and APIs require that you supply a client certificate, that has been provided to you, in order to access them. To monitor these sites with AlertSite, you need to upload the certificates to your AlertSite account and assign them to the appropriate monitoring devices. AlertSite will automatically install these certificates in the monitoring locations so that they can successfully reach your secure sites.

Note: Only Admin and Co-Admin users can upload certificates to AlertSite and assign them to the monitoring devices.

Supported Certificate Types

AlertSite monitoring devices support the following certificate types:

Certificate Type
Device Type PKCS #12 (.p12 or .pfx) Java Keystore (.jks)
Secure Web Site  
Secure API Endpoint
API (SoapUI)
FTP over SSL (FTPS)  

Uploading SSL Certificates and Java Keystores to AlertSite

  • From the top menu, select Configure > SSL Certificates.
  • Click Add a New Certificate in the top right.
    Add a New Certificate
  • On the screen that appers, enter a name for the certificate.
  • Select the certificate type – PKCS #12 (usually .p12 or .pfx) or Keystore (.jks).
  • Browse for the certificate file.
    Specifying certificate properties
  • If your PKCS #12 certificate is self-signed, or if it is a chain certificate that includes Certificate Authority, select the Use Certificate Authority (CA) check box.
  • Enter the Certificate Password.
  • Click Submit.

Assigning Certificates to Devices

Once you have uploaded a certificate, you can assign it to your monitoring devices in the device settings:

  • On the Dashboard, click the wrench icon next to the device name. This opens the device settings.
  • Select the uploaded certificate from the SSL Certificate list.
    Selecting a SSL certificate for a monitoring device
  • Click Submit to save the changes.
  • (Optional.) Click Test On Demand to verify the connectivity using the certificate. You should see "Test completed successfully".

Managing Certificates

You can view and manage your uploaded certificates and keystores on the Manage SSL Certificates screen, accessible via the Configure > SSL Certificates menu. The certificates are listed in a table with the following columns:

Column Description
Certificate Name A user-defined name for the certificate or keystore.
Type The certificate type: PKCS #12 or Java keystore.
Sites How many devices use this certificate or keystore.

Clicking the certificate name opens the certificate edit screen, where you can view, update or delete the certificate.

See Which Devices Use a Certificate

Click the certificate on the Manage SSL Certificates screen. All devices that use this certificate are listed at the bottom of the page.

Sites that use this SSL Certificate

Replace an Uploaded Certificate

You can replace the uploaded certificates, for example, those about to expire.

  • Click the certificate on the Manage SSL Certificates screen.
  • Specify the new certificate:
    • Browse for the certificate file.
    • Enter the Certificate Password.
    • For self-signed PKCS #12 certificates, select Use Certificate Authority (CA).
  • Click Submit in the top right to replace the certificate.

Note: In this way, you can replace Java keystores with PKCS #12 certificates, but not vice versa.

View Certificate Contents

Click the certificate on the Manage SSL Certificates screen, then click the Show Certificate Information link. Here you can see the certificate issuer, valid date range, and other details.

Certificate contents

Delete a Certificate

You can delete certificates that are no longer used by your monitored sites and API transactions.

  • Click the certificate on the Manage SSL Certificates screen.
  • Click Delete in the top right, and confirm the deletion.

Back to index
Back to top

© 2016 SmartBear Software --
Syndicate this site RSSATOM