Troubleshoot UNKNOWN or BAD certificates or CERTIFICATE authorities

Enable logging for TLS/SSL decryption rules to monitor connection events and identify CERTIFICATE-related issues. This helps you diagnose problems with CERTIFICATE authorities, BAD certificates, or UNKNOWN certificates in your TLS/SSL connections.

You can view connection events to determine whether or not the devices are experiencing UNKNOWN CERTIFICATE authorities, BAD certificates, or UNKNOWN certificates. This procedure can also be used if a TLS/SSL CERTIFICATE has been pinned. You must add at least the SSL Flow Flags and SSL Flow Messages columns to the table view of connection events.

Before you begin

Follow these steps to troubleshoot UNKNOWN or BAD certificates or CERTIFICATE authorities:

Procedure


Step 1

Click Events & Logs > + Show more > Connection > Events.

Step 2

Click Table View of Connection Events.

Step 3

Click x on any column in the connection events table to add additional columns for at least SSL Flow Flags and SSL Flow Messages.

The image illustrates the addition of various SSL-related columns, including SSL Actual Action, SSL Flow Error, SSL Flow Flags, SSL Flow Messages, SSL Policy, and SSL Rule, to a table of connection events.

The following example shows adding the SSL Actual Action, SSL Flow Error, SSL Flow Flags, SSL Flow Messages, SSL Policy, and SSL Rule columns to the table of connection events.

The image illustrates the addition of various SSL-related columns, including SSL Actual Action, SSL Flow Error, SSL Flow Flags, SSL Flow Messages, SSL Policy, and SSL Rule, to a table of connection events.

The columns are added in the order discussed in the section on connection and security intelligence event fields in the Secure Firewall Management Center and Threat Defense Management Network Administration guide.

Step 4

Click Apply.

Step 5

Review the SSL flow flags to determine if a CERTIFICATE or CERTIFICATE authority is BAD or missing.

SSL flow flag

Meaning

CLIENT_ALERT_SEEN_UNKNOWN_CA

Indicates a valid CERTIFICATE chain or partial chain was received by an SSL CLIENT application, but the CERTIFICATE was not accepted because the CA CERTIFICATE could not be located or could not be matched with a known, trusted CA. This message always indicates an unrecoverable error.

CLIENT_ALERT_SEEN_BAD_CERTIFICATE

A CERTIFICATE was corrupt, contained signatures that did not verify correctly, or had other problems.

CLIENT_ALERT_SEEN_CERTIFICATE_UNKNOWN

Some other (unspecified) issue arose in processing the CERTIFICATE, rendering it unacceptable.