com.entrust.toolkit.smproxy

Class SMProxySSLSocketFactory

java.lang.Object

javax.net.SocketFactory

javax.net.ssl.SSLSocketFactory

com.entrust.toolkit.smproxy.SMProxySSLSocketFactory

public class SMProxySSLSocketFactory
extends javax.net.ssl.SSLSocketFactory

Provides a Security Manager Proxy specific version of an SSLSocketFactory class.

Since:

8.1

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SMProxySSLSocketFactory.InetHandling Define Enumeration for Inet Handling

Constructor Summary

Constructors

Constructor and Description
SMProxySSLSocketFactory(javax.net.ssl.TrustManager[] tms, javax.net.ssl.KeyManager[] kms, java.security.SecureRandom sr) Initializes an SMProxySSLSocketFactory from an array of TrustManagers, an array of KeyManagers, and a Secure random number generator.

Method Summary

Modifier and Type	Method and Description
java.net.Socket	createSocket() Creates an unconnected SSLSocket.
java.net.Socket	createSocket(java.net.InetAddress host, int port)
java.net.Socket	createSocket(java.net.InetAddress address, int port, java.net.InetAddress localAddress, int localPort)
java.net.Socket	createSocket(java.net.Socket s, java.lang.String host, int port, boolean autoClose)
java.net.Socket	createSocket(java.lang.String host, int port)
java.net.Socket	createSocket(java.lang.String host, int port, java.net.InetAddress localHost, int localPort)
static javax.net.SocketFactory	getDefault() Get the default socket from a static instance.
java.lang.String[]	getDefaultCipherSuites()
java.lang.String[]	getSupportedCipherSuites()
static SMProxySSLSocketFactory.InetHandling	readInetHandlingProperty() Reads the system property com.entrust.toolkit.x509.directory.EntrustSSLSocketFactory.InetHandling
static void	setDefault(javax.net.ssl.TrustManager tm, javax.net.ssl.KeyManager km, SMProxyWrapper wrapper) Set the X509TrustManager, X509KeyManager and SecureRandom which should be used by the static call to getDefault().
static void	setEnabledProtocols(java.lang.String[] protocols) Sets the protocol versions to enable.

Methods inherited from class javax.net.ssl.SSLSocketFactory

createSocket

Methods inherited from class java.lang.Object

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

Constructor Detail

SMProxySSLSocketFactory

public SMProxySSLSocketFactory(javax.net.ssl.TrustManager[] tms,
                               javax.net.ssl.KeyManager[] kms,
                               java.security.SecureRandom sr)

Initializes an SMProxySSLSocketFactory from an array of TrustManagers, an array of KeyManagers, and a Secure random number generator.

Parameters:

tms - the TrustManagers

kms - the KeyManagers

sr - The SecureRandom

Since:

8.1

Method Detail

getDefault

public static javax.net.SocketFactory getDefault()

Get the default socket from a static instance.

Note this class gets the key material for the TrustManager by using the SMProxyTrustStoreSingleton object. If no key material has been supplied, then the TLS connection will fail.

Returns:

SocketFactory A newly created socket factory configured with a JSSEX509TrustManager.

Since:

8.1

readInetHandlingProperty

public static SMProxySSLSocketFactory.InetHandling readInetHandlingProperty()
                                                                     throws java.net.SocketException

Reads the system property com.entrust.toolkit.x509.directory.EntrustSSLSocketFactory.InetHandling

Returns:

the InetHandling read from the property

Throws:

java.net.SocketException

Since:

8.1

createSocket

public java.net.Socket createSocket()
                             throws java.io.IOException

Creates an unconnected SSLSocket.

Overrides:

createSocket in class javax.net.SocketFactory

Throws:

java.io.IOException

setDefault

public static void setDefault(javax.net.ssl.TrustManager tm,
                              javax.net.ssl.KeyManager km,
                              SMProxyWrapper wrapper)

Set the X509TrustManager, X509KeyManager and SecureRandom which should be used by the static call to getDefault().

Parameters:

tm - The X509TrustManager

km - The X509KeyManager

wrapper - The SMProxyWrapper to use

Since:

8.1

getSupportedCipherSuites

public java.lang.String[] getSupportedCipherSuites()

Specified by:

getSupportedCipherSuites in class javax.net.ssl.SSLSocketFactory

getDefaultCipherSuites

public java.lang.String[] getDefaultCipherSuites()

Specified by:

getDefaultCipherSuites in class javax.net.ssl.SSLSocketFactory

createSocket

public java.net.Socket createSocket(java.net.Socket s,
                                    java.lang.String host,
                                    int port,
                                    boolean autoClose)
                             throws java.io.IOException

Specified by:

createSocket in class javax.net.ssl.SSLSocketFactory

Throws:

java.io.IOException

createSocket

public java.net.Socket createSocket(java.lang.String host,
                                    int port)
                             throws java.io.IOException,
                                    java.net.UnknownHostException

Specified by:

createSocket in class javax.net.SocketFactory

Throws:

java.io.IOException

java.net.UnknownHostException

createSocket

public java.net.Socket createSocket(java.net.InetAddress host,
                                    int port)
                             throws java.io.IOException

Specified by:

createSocket in class javax.net.SocketFactory

Throws:

java.io.IOException

createSocket

public java.net.Socket createSocket(java.lang.String host,
                                    int port,
                                    java.net.InetAddress localHost,
                                    int localPort)
                             throws java.io.IOException,
                                    java.net.UnknownHostException

Specified by:

createSocket in class javax.net.SocketFactory

Throws:

java.io.IOException

java.net.UnknownHostException

createSocket

public java.net.Socket createSocket(java.net.InetAddress address,
                                    int port,
                                    java.net.InetAddress localAddress,
                                    int localPort)
                             throws java.io.IOException

Specified by:

createSocket in class javax.net.SocketFactory

Throws:

java.io.IOException

setEnabledProtocols

public static void setEnabledProtocols(java.lang.String[] protocols)

Sets the protocol versions to enable.

If this is not set the default protocols for the JSSE will be used.

Parameters:

protocols - Names of the protocols to enable

Since:

8.1