Whenever a JabberGuestCall instance encounters an error condition verifying the validity of a certificate installed on a Cisco Jabber Guest server, the instance will attempt to notify the implementing application of this failure, by calling this method, as long as the application has registered a valid implementation of this interface with this JabberGuestCall class prior to encountering the certificate error. More...
Public Member Functions | |
| void | onInvalidCertificate (String certFingerprint, String identifierToDisplay, String certSubjectCN, String referenceID, List< String > invalidReason, String subjectCertificateData, List< String > intermediateCACertificateData, boolean allowUserToAccept) |
| JabberGuestCall instance will call this method whenever a certificate error is encountered if there is a problem verifying the validity of an installed certificate from a Cisco Jabber Guest server. More... | |
Detailed Description
Whenever a JabberGuestCall instance encounters an error condition verifying the validity of a certificate installed on a Cisco Jabber Guest server, the instance will attempt to notify the implementing application of this failure, by calling this method, as long as the application has registered a valid implementation of this interface with this JabberGuestCall class prior to encountering the certificate error.
Note that if you do not register an implementation of this InvalidCertificateCallback interface with the JabberGuestCall class, if the JabberGuestCall instance encounters a certificate error the instance will reject the invalid certificate and terminate any pending call immediately.
Member Function Documentation
| void com.cisco.jabber.guest.JabberGuestCall.JabberGuestInvalidCertificateCallback.onInvalidCertificate | ( | String | certFingerprint, |
| String | identifierToDisplay, | ||
| String | certSubjectCN, | ||
| String | referenceID, | ||
| List< String > | invalidReason, | ||
| String | subjectCertificateData, | ||
| List< String > | intermediateCACertificateData, | ||
| boolean | allowUserToAccept | ||
| ) |
JabberGuestCall instance will call this method whenever a certificate error is encountered if there is a problem verifying the validity of an installed certificate from a Cisco Jabber Guest server.
The passed parameters will include more information about the nature of the certificate that it received, along with any error codes that were generated when analyzing the returned certificate.
When receiving this callback, the implementing application can choose to either accept the invalid certificate and allow the call to proceed as normal by calling the acceptInvalidCert method on the JabberGuestCall instance, or reject the invalid certificate and cause the call to terminate immediately by calling the rejectInvalidCert method on the JabberGuestCall instance.
- Parameters
-
certFingerprint The fingerprint of the invalid certificate. identifierToDisplay A string representing the identity that provides the certificate. certSubjectCN A string representing the certificate name. referenceID A string representing an identity of the the certificate provider matching the certificate owner. invalidReason A list of strings that indicate why the certificate was judged to be invalid. subjectCertificateData A string representing the invalid subject certificate in PEM format (last element in a chain) intermediateCACertificateData A list of strings representing all certificates in the X509 certificate chain in PEM format (excluding the subject certificate) allowUserToAccept Boolean value indicating whether the certificate can be accepted. If false, the error has already been handled by JabberGuestCall instance and any pending call has been ended, but this error is being presented to the application for presentation purposes.