Interface SSLSetupHandler


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

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      void initalize​(javax.net.ssl.SSLEngine sslEngine)
      Triggered when the SSL connection is being initialized.
      void verify​(IOSession ioSession, javax.net.ssl.SSLSession sslSession)
      Triggered when the SSL connection has been established and initial SSL handshake has been successfully completed.
    • Method Detail

      • initalize

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

        void verify​(IOSession ioSession,
                    javax.net.ssl.SSLSession sslSession)
             throws javax.net.ssl.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:
        javax.net.ssl.SSLException - if case of SSL protocol error.