File	Doc	Category	Size	Date	Package
MailSSLSocketFactory.java	API Doc	JavaMail 1.4.3	11346	Tue Nov 17 10:38:12 GMT 2009	com.sun.mail.util

MailSSLSocketFactory

• java.lang.Object
  • javax.net.SocketFactory
    • javax.net.ssl.SSLSocketFactory

Fields Summary
private boolean	trustAllHosts Should all hosts be trusted?
private String[]	trustedHosts String-array of trusted hosts
private SSLContext	sslcontext Holds a SSLContext to get SSLSocketFactories from
private KeyManager[]	keyManagers Holds the KeyManager array to use
private TrustManager[]	trustManagers Holds the TrustManager array to use
private SecureRandom	secureRandom Holds the SecureRandom to use
private SSLSocketFactory	adapteeFactory Holds a SSLSocketFactory to pass all API-method-calls to

Constructors Summary
public MailSSLSocketFactory() Initializes a new MailSSLSocketFactory. throws GeneralSecurityException this("TLS");
public MailSSLSocketFactory(String protocol) Initializes a new MailSSLSocketFactory with a given protocol. Normally the protocol will be specified as "TLS". param protocol The protocol to use throws NoSuchAlgorithmException if given protocol is not supported // By default we do NOT trust all hosts. trustAllHosts = false; // Get an instance of an SSLContext. sslcontext = SSLContext.getInstance(protocol); // Default properties to init the SSLContext keyManagers = null; trustManagers = new TrustManager[] { new MailTrustManager() }; secureRandom = null; // Assemble a default SSLSocketFactory to delegate all API-calls to. newAdapteeFactory();

Methods Summary
public synchronized java.net.Socket	createSocket(java.net.Socket socket, java.lang.String s, int i, boolean flag) return adapteeFactory.createSocket(socket, s, i, flag);
public synchronized java.net.Socket	createSocket() return adapteeFactory.createSocket();
public synchronized java.net.Socket	createSocket(java.net.InetAddress inetaddress, int i, java.net.InetAddress inetaddress1, int j) return adapteeFactory.createSocket(inetaddress, i, inetaddress1, j);
public synchronized java.net.Socket	createSocket(java.net.InetAddress inetaddress, int i) return adapteeFactory.createSocket(inetaddress, i);
public synchronized java.net.Socket	createSocket(java.lang.String s, int i, java.net.InetAddress inetaddress, int j) return adapteeFactory.createSocket(s, i, inetaddress, j);
public synchronized java.net.Socket	createSocket(java.lang.String s, int i) return adapteeFactory.createSocket(s, i);
public synchronized java.lang.String[]	getDefaultCipherSuites() return adapteeFactory.getDefaultCipherSuites();
public synchronized javax.net.ssl.KeyManager[]	getKeyManagers() return the keyManagers return (KeyManager[])keyManagers.clone();
public synchronized java.security.SecureRandom	getSecureRandom() return the secureRandom return secureRandom;
public synchronized java.lang.String[]	getSupportedCipherSuites() return adapteeFactory.getSupportedCipherSuites();
public synchronized javax.net.ssl.TrustManager[]	getTrustManagers() return the trustManagers return trustManagers;
public synchronized java.lang.String[]	getTrustedHosts() return the trusted hosts return (String[])trustedHosts.clone();
public synchronized boolean	isServerTrusted(java.lang.String server, javax.net.ssl.SSLSocket sslSocket) After a successful conection to the server, this method is called to ensure that the server should be trusted. param server name of the server we connected to param sslSocket SSLSocket connected to the server return true if "trustAllHosts" is set to true OR the server is contained in the "trustedHosts" array; //System.out.println("DEBUG: isServerTrusted host " + server); // If "trustAllHosts" is set to true, we return true if (trustAllHosts) return true; // If the socket host is contained in the "trustedHosts" array, // we return true if (trustedHosts != null) return Arrays.asList(trustedHosts).contains(server); // ignore case? // If we get here, trust of the server was verified by the trust manager return true;
public synchronized boolean	isTrustAllHosts() return true if all hosts should be trusted return trustAllHosts;
private synchronized void	newAdapteeFactory() Gets an SSLSocketFactory based on the given (or default) KeyManager array, TrustManager array and SecureRandom and sets it to the instance var adapteeFactory. sslcontext.init(keyManagers, trustManagers, secureRandom); // Get SocketFactory and save it in our instance var adapteeFactory = (SSLSocketFactory)sslcontext.getSocketFactory();
public synchronized void	setKeyManagers(javax.net.ssl.KeyManager[] keyManagers) param keyManagers the keyManagers to set this.keyManagers = (KeyManager[])keyManagers.clone(); newAdapteeFactory();
public synchronized void	setSecureRandom(java.security.SecureRandom secureRandom) param secureRandom the secureRandom to set this.secureRandom = secureRandom; newAdapteeFactory();
public synchronized void	setTrustAllHosts(boolean trustAllHosts) param trustAllHosts should all hosts be trusted? this.trustAllHosts = trustAllHosts;
public synchronized void	setTrustManagers(javax.net.ssl.TrustManager[] trustManagers) param trustManagers the trustManagers to set this.trustManagers = trustManagers; newAdapteeFactory();
public synchronized void	setTrustedHosts(java.lang.String[] trustedHosts) param trustedHosts the hosts to trust this.trustedHosts = (String[])trustedHosts.clone();