nsIBadCertListener2

security/manager/ssl/public/nsIBadCertListener2.idlScriptable

This interface is used to is report a broken SSL status. It can also be used to obtain the SSL handshake status of a connection that will be canceled because of improper certificate status.

1.0

Introduced

Gecko 1.9

Inherits from: nsISupports Last changed in Gecko 1.9 (Firefox 3)

Replaces the obsolete nsIBadCertListener interface.

Method overview

boolean notifyCertProblem(in nsIInterfaceRequestor socketInfo, in nsISSLStatus status, in AUTF8String targetSite);

Methods

notifyCertProblem()

Called in case of a broken ssl status.

boolean notifyCertProblem(
  in nsIInterfaceRequestor socketInfo,
  in nsISSLStatus status,
  in AUTF8String targetSite
);

Parameters

socketInfo: A network communication context that can be used to obtain more information about the active connection. This object usually supports nsISSLSocketControl, nsITransportSecurityInfo, nsIIdentityInfo, nsISSLStatusProvider, nsIClientAuthUserDecision and possibly other interfaces.
status: The SSL status object that describes the problem(s).
targetSite: The Site name that was used to open the current connection.

Return value

The consumer shall return true if it wants to suppress the error message related to the bad cert (the connection will still get canceled).