Interface SSLSetupHandler

All Known Implementing Classes:
SSLIOSessionHandlerAdaptor, SSLSetupHandlerAdaptor

public interface SSLSetupHandler
Callback interface that can be used to customize various aspects of the TLS/SSL protocol.
Since:
4.2
  • Method Summary

    Modifier and Type
    Method
    Description
    void
    initalize(SSLEngine sslEngine)
    Triggered when the SSL connection is being initialized.
    void
    verify(IOSession ioSession, SSLSession sslSession)
    Triggered when the SSL connection has been established and initial SSL handshake has been successfully completed.
  • Method Details

    • initalize

      void initalize(SSLEngine sslEngine) throws SSLException
      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.
      Throws:
      SSLException - if case of SSL protocol error.
    • verify

      void verify(IOSession ioSession, SSLSession sslSession) throws SSLException
      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.