public interface

SSLSetupHandler

org.apache.http.impl.nio.reactor.SSLSetupHandler

Class Overview

Callback interface that can be used to customize various aspects of the TLS/SSl protocol.

Summary

Public Methods
abstract void initalize(SSLEngine sslengine, HttpParams params)
Triggered when the SSL connection is being initialized.
abstract void verify(IOSession iosession, SSLSession sslsession)
Triggered when the SSL connection has been established and initial SSL handshake has been successfully completed.

Public Methods

public abstract void initalize (SSLEngine sslengine, HttpParams params)

Triggered when the SSL connection is being initialized. Custom handlers can use this callback to customize properties of the SSLEngine used to establish the SSL session.

Parameters
sslengine the SSL engine.
params HTTP parameters.
Throws
SSLException if case of SSL protocol error.

public abstract void verify (IOSession iosession, SSLSession sslsession)

Triggered when the SSL connection has been established and initial SSL handshake has been successfully completed. Custom handlers can use this callback to verify properties of the SSLSession. For instance this would be the right place to enforce SSL cipher strength, validate certificate chain and do hostname checks.

Parameters
iosession the underlying IOSession for the SSL connection.
sslsession newly created SSL session.
Throws
SSLException if case of SSL protocol error.