Package eu.emi.security.authn.x509.impl
Class SocketFactoryCreator
java.lang.Object
eu.emi.security.authn.x509.impl.SocketFactoryCreator
Deprecated.
Simple utility allowing programmers to quickly create SSL socket factories
using
X509CertChainValidator
.- Author:
- K. Benedyczak
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionstatic void
connectWithHostnameChecking
(SSLSocket socket, HostnameMismatchCallback callback) Deprecated.This method, invoked on an initialized SSL socket will perform the initial handshake (if necessary) and then check if the peer's hostname is matching its certificate.static SSLServerSocketFactory
Deprecated.Same asgetServerSocketFactory(X509Credential, X509CertChainValidator, SecureRandom)
usingSecureRandom
implementation as the last argument.static SSLServerSocketFactory
Deprecated.Returns anSSLServerSocketFactory
configured to check client certificates with a provided validator.static SSLSocketFactory
Deprecated.Same asgetSocketFactory(X509Credential, X509CertChainValidator, SecureRandom)
usingSecureRandom
implementation as the last argument.static SSLSocketFactory
Deprecated.Returns anSSLSocketFactory
configured to check servers' certificates with a provided validator.static SSLContext
Deprecated.Low level interface.static X509TrustManager
Deprecated.Creates a SSL trustmanager which uses the provided validator.
-
Constructor Details
-
SocketFactoryCreator
public SocketFactoryCreator()Deprecated.
-
-
Method Details
-
getSSLTrustManager
Deprecated.Creates a SSL trustmanager which uses the provided validator.- Parameters:
v
- validator to use for certificates validation- Returns:
- ready to use TrustManager
-
getSSLContext
Deprecated.Low level interface. It can be used to getSSLContext
object initialized with the provided credential and validator.- Parameters:
c
- credential to use for the created sockets. If null, then anonymous socket will be created, what is useful only for client side.v
- validator to use for certificates validationr
- implementation providing random numbers- Returns:
- initialized
SSLContext
object
-
getServerSocketFactory
public static SSLServerSocketFactory getServerSocketFactory(X509Credential c, X509CertChainValidator v, SecureRandom r) Deprecated.Returns anSSLServerSocketFactory
configured to check client certificates with a provided validator. Server socket will use the provided credentials.- Parameters:
c
- credential to use for the server socketv
- validator to use for client's validationr
- implementation providing random numbers- Returns:
- configured
SSLServerSocketFactory
-
getServerSocketFactory
public static SSLServerSocketFactory getServerSocketFactory(X509Credential c, X509CertChainValidator v) Deprecated.Same asgetServerSocketFactory(X509Credential, X509CertChainValidator, SecureRandom)
usingSecureRandom
implementation as the last argument. Note that this method might block if the machine has not enough system entropy. It is not suggested to use this method for setting up automatic test environments, however it is suitable for production setups.- Parameters:
c
- credential to use for the server socketv
- validator to use for client's validation- Returns:
- configured
SSLServerSocketFactory
-
getSocketFactory
public static SSLSocketFactory getSocketFactory(X509Credential c, X509CertChainValidator v, SecureRandom r) Deprecated.Returns anSSLSocketFactory
configured to check servers' certificates with a provided validator. Client socket will use the provided credentials.- Parameters:
c
- credential to use for the client socketv
- validator to use for server's validationr
- implementation providing random numbers- Returns:
- configured
SSLSocketFactory
-
getSocketFactory
Deprecated.Same asgetSocketFactory(X509Credential, X509CertChainValidator, SecureRandom)
usingSecureRandom
implementation as the last argument. Note that this method might block if the machine has not enough system entropy. It is not suggested to use this method for setting up automatic test environments, however it is suitable for production setups.- Parameters:
c
- credential to use for the client socketv
- validator to use for server's validation- Returns:
- configured
SSLSocketFactory
-
connectWithHostnameChecking
public static void connectWithHostnameChecking(SSLSocket socket, HostnameMismatchCallback callback) throws SSLPeerUnverifiedException Deprecated.This method, invoked on an initialized SSL socket will perform the initial handshake (if necessary) and then check if the peer's hostname is matching its certificate. The reaction to a mismatch must be handled by the provided callback.- Parameters:
socket
- socket to be checkedcallback
- used when there is mismatch.- Throws:
SSLPeerUnverifiedException
- if the peer was not verified
-
SocketFactoryCreator2
instead, which handles hostname verification in a safer way. Hostname verification provided in this class requires manual wiring and in certain server configuration may cause connection errors.