org.ldaptive.ssl

Class TLSSocketFactory

java.lang.Object

javax.net.SocketFactory

javax.net.ssl.SSLSocketFactory

org.ldaptive.ssl.AbstractTLSSocketFactory

org.ldaptive.ssl.TLSSocketFactory

Direct Known Subclasses:

ThreadLocalTLSSocketFactory

public class TLSSocketFactory
extends AbstractTLSSocketFactory

An extension of SSLSocketFactory that leverages an SSL context initializer. Note that initialize() must be called prior to using this socket factory. This means that this class cannot be passed to implementations that expect the socket factory to function immediately after construction.

Field Summary

Fields inherited from class org.ldaptive.ssl.AbstractTLSSocketFactory

DEFAULT_PROTOCOL, factory, logger

Constructor Summary

Constructors

Constructor and Description
TLSSocketFactory()

Method Summary

Modifier and Type	Method and Description
protected static void	addHostnameVerifyingTrustManager(SslConfig config, java.lang.String[] names) Adds a HostnameVerifyingTrustManager to the supplied config if no trust managers have been configured.
static javax.net.SocketFactory	getDefault() Returns the default SSL socket factory.
static javax.net.ssl.SSLSocketFactory	getHostnameVerifierFactory(SslConfig config, java.lang.String[] names) Returns an instance of this socket factory configured with a hostname verifying trust manager.
void	initialize() Creates the underlying SSLContext using truststore and keystore attributes and makes this factory ready for use.
java.lang.String	toString()

Methods inherited from class org.ldaptive.ssl.AbstractTLSSocketFactory

createSocket, createSocket, createSocket, createSocket, createSocket, createSocket, getDefaultCipherSuites, getFactory, getSocketConfig, getSslConfig, getSupportedCipherSuites, initSSLSocket, setSocketConfig, setSslConfig

Methods inherited from class javax.net.ssl.SSLSocketFactory

createSocket

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

TLSSocketFactory

public TLSSocketFactory()

Method Detail

initialize

public void initialize()
                throws java.security.GeneralSecurityException

Creates the underlying SSLContext using truststore and keystore attributes and makes this factory ready for use. Must be called before factory can be used.

Specified by:

initialize in class AbstractTLSSocketFactory

Throws:

java.security.GeneralSecurityException - if the SSLContext cannot be created

getDefault

public static javax.net.SocketFactory getDefault()

Returns the default SSL socket factory.

Returns:

socket factory

getHostnameVerifierFactory

public static javax.net.ssl.SSLSocketFactory getHostnameVerifierFactory(SslConfig config,
                                                                        java.lang.String[] names)

Returns an instance of this socket factory configured with a hostname verifying trust manager. If the supplied ssl config does not contain trust managers, HostnameVerifyingTrustManager with DefaultHostnameVerifier is set. See addHostnameVerifyingTrustManager(SslConfig, String[]).

Parameters:

config - to set on the socket factory

names - to use for hostname verification

Returns:

socket factory

addHostnameVerifyingTrustManager

protected static void addHostnameVerifyingTrustManager(SslConfig config,
                                                       java.lang.String[] names)

Adds a HostnameVerifyingTrustManager to the supplied config if no trust managers have been configured. A DefaultTrustManager is also added in no CredentialConfig has been configured.

Parameters:

config - to modify

names - of the hosts to verify

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object