com.sssw.jbroker.api.security
Interface CertificateEventHandler

public interface CertificateEventHandler

Callback to handle Certificate verification errors.

SSL implementation provides built-in certificate handling which follows a chain of certificates and authenticates a certificate against a trusted root. However, when a certificate cannot be verified, the application receives and error and the session is closed. With this API the application program can gracefully handle the error.

Since:

jBroker 3.0

Field Summary

static int	BAD_CERTIFICATE the certificate was corrupted
static int	BAD_CHAIN the certificate chain didn't validate
static int	BAD_SIGNATURE certificate signature didn't verify
static int	BAD_VALIDITY_DATE the certificate was either expired or not valid yet
static int	UNKNOWN_ERROR unknow error happened during certificate verification

Method Summary

boolean

handleCertificateEvent(byte[][] certChain, int event) Handle the certificate event.

Field Detail

BAD_CHAIN

public static final int BAD_CHAIN

the certificate chain didn't validate

See Also:

Constant Field Values

BAD_CERTIFICATE

public static final int BAD_CERTIFICATE

the certificate was corrupted

See Also:

Constant Field Values

BAD_VALIDITY_DATE

public static final int BAD_VALIDITY_DATE

the certificate was either expired or not valid yet

See Also:

Constant Field Values

BAD_SIGNATURE

public static final int BAD_SIGNATURE

certificate signature didn't verify

See Also:

Constant Field Values

UNKNOWN_ERROR

public static final int UNKNOWN_ERROR

unknow error happened during certificate verification

See Also:

Constant Field Values

Method Detail

handleCertificateEvent

public boolean handleCertificateEvent(byte[][] certChain,
                                      int event)

Handle the certificate event. This callback is called by the certificate verifying logic when the certificate does not verify properly.

Parameters:

event - one of the events described in this interface