001    /*
002     * $HeadURL: http://juliusdavies.ca/svn/not-yet-commons-ssl/tags/commons-ssl-0.3.9/src/java/org/apache/commons/ssl/SSLClient.java $
003     * $Revision: 121 $
004     * $Date: 2007-11-13 21:26:57 -0800 (Tue, 13 Nov 2007) $
005     *
006     * ====================================================================
007     * Licensed to the Apache Software Foundation (ASF) under one
008     * or more contributor license agreements.  See the NOTICE file
009     * distributed with this work for additional information
010     * regarding copyright ownership.  The ASF licenses this file
011     * to you under the Apache License, Version 2.0 (the
012     * "License"); you may not use this file except in compliance
013     * with the License.  You may obtain a copy of the License at
014     *
015     *   http://www.apache.org/licenses/LICENSE-2.0
016     *
017     * Unless required by applicable law or agreed to in writing,
018     * software distributed under the License is distributed on an
019     * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
020     * KIND, either express or implied.  See the License for the
021     * specific language governing permissions and limitations
022     * under the License.
023     * ====================================================================
024     *
025     * This software consists of voluntary contributions made by many
026     * individuals on behalf of the Apache Software Foundation.  For more
027     * information on the Apache Software Foundation, please see
028     * <http://www.apache.org/>.
029     *
030     */
031    
032    package org.apache.commons.ssl;
033    
034    import javax.net.ssl.SSLContext;
035    import javax.net.ssl.SSLSocketFactory;
036    import java.io.IOException;
037    import java.net.InetAddress;
038    import java.net.Socket;
039    import java.net.UnknownHostException;
040    import java.security.GeneralSecurityException;
041    import java.security.KeyManagementException;
042    import java.security.KeyStoreException;
043    import java.security.NoSuchAlgorithmException;
044    import java.security.cert.CertificateException;
045    import java.security.cert.X509Certificate;
046    import java.util.Collection;
047    import java.util.List;
048    
049    /**
050     * @author Credit Union Central of British Columbia
051     * @author <a href="http://www.cucbc.com/">www.cucbc.com</a>
052     * @author <a href="mailto:juliusdavies@cucbc.com">juliusdavies@cucbc.com</a>
053     * @since 27-Feb-2006
054     */
055    public class SSLClient extends SSLSocketFactory {
056        private final SSL ssl;
057    
058        public SSLClient()
059            throws GeneralSecurityException, IOException {
060            this.ssl = new SSL();
061        }
062    
063        public void addTrustMaterial(TrustChain trustChain)
064            throws NoSuchAlgorithmException, KeyStoreException,
065            KeyManagementException, IOException, CertificateException {
066            ssl.addTrustMaterial(trustChain);
067        }
068    
069        public void setTrustMaterial(TrustChain trustChain)
070            throws NoSuchAlgorithmException, KeyStoreException,
071            KeyManagementException, IOException, CertificateException {
072            ssl.setTrustMaterial(trustChain);
073        }
074    
075        public void setKeyMaterial(KeyMaterial keyMaterial)
076            throws NoSuchAlgorithmException, KeyStoreException,
077            KeyManagementException, IOException, CertificateException {
078            ssl.setKeyMaterial(keyMaterial);
079        }
080    
081        public void addAllowedName(String s) { ssl.addAllowedName(s); }
082    
083        public void addAllowedNames(Collection c) { ssl.addAllowedNames(c); }
084    
085        public void clearAllowedNames() { ssl.clearAllowedNames(); }
086    
087        public void setCheckCRL(boolean b) { ssl.setCheckCRL(b); }
088    
089        public void setCheckExpiry(boolean b) { ssl.setCheckExpiry(b); }
090    
091        public void setCheckHostname(boolean b) { ssl.setCheckHostname(b); }
092    
093        public void setConnectTimeout(int i) { ssl.setConnectTimeout(i); }
094    
095        public void setDefaultProtocol(String s) { ssl.setDefaultProtocol(s); }
096    
097        public void useDefaultJavaCiphers() { ssl.useDefaultJavaCiphers(); }
098    
099        public void useStrongCiphers() { ssl.useStrongCiphers(); }
100    
101        public void setEnabledCiphers(String[] ciphers) {
102            ssl.setEnabledCiphers(ciphers);
103        }
104    
105        public void setEnabledProtocols(String[] protocols) {
106            ssl.setEnabledProtocols(protocols);
107        }
108    
109        public void setHostnameVerifier(HostnameVerifier verifier) {
110            ssl.setHostnameVerifier(verifier);
111        }
112    
113        public void setSoTimeout(int soTimeout) { ssl.setSoTimeout(soTimeout); }
114    
115        public void setSSLWrapperFactory(SSLWrapperFactory wf) {
116            ssl.setSSLWrapperFactory(wf);
117        }
118    
119        public void setNeedClientAuth(boolean b) { ssl.setNeedClientAuth(b); }
120    
121        public void setWantClientAuth(boolean b) { ssl.setWantClientAuth(b); }
122    
123        public void setUseClientMode(boolean b) { ssl.setUseClientMode(b); }
124    
125        public List getAllowedNames() { return ssl.getAllowedNames(); }
126    
127        public X509Certificate[] getAssociatedCertificateChain() {
128            return ssl.getAssociatedCertificateChain();
129        }
130    
131        public boolean getCheckCRL() { return ssl.getCheckCRL(); }
132    
133        public boolean getCheckExpiry() { return ssl.getCheckExpiry(); }
134    
135        public boolean getCheckHostname() { return ssl.getCheckHostname(); }
136    
137        public int getConnectTimeout() { return ssl.getConnectTimeout(); }
138    
139        public String getDefaultProtocol() { return ssl.getDefaultProtocol(); }
140    
141        public String[] getEnabledCiphers() { return ssl.getEnabledCiphers(); }
142    
143        public String[] getEnabledProtocols() { return ssl.getEnabledProtocols(); }
144    
145        public HostnameVerifier getHostnameVerifier() {
146            return ssl.getHostnameVerifier();
147        }
148    
149        public int getSoTimeout() { return ssl.getSoTimeout(); }
150    
151        public SSLWrapperFactory getSSLWrapperFactory() {
152            return ssl.getSSLWrapperFactory();
153        }
154    
155        public boolean getNeedClientAuth() { return ssl.getNeedClientAuth(); }
156    
157        public boolean getWantClientAuth() { return ssl.getWantClientAuth(); }
158    
159        public boolean getUseClientMode() { /* SSLClient's default is true. */
160            return ssl.getUseClientModeDefault() || ssl.getUseClientMode();
161        }
162    
163        public SSLContext getSSLContext() throws GeneralSecurityException, IOException {
164            return ssl.getSSLContext();
165        }
166    
167        public TrustChain getTrustChain() { return ssl.getTrustChain(); }
168    
169        public X509Certificate[] getCurrentServerChain() {
170            return ssl.getCurrentServerChain();
171        }
172    
173        public String[] getDefaultCipherSuites() {
174            return ssl.getDefaultCipherSuites();
175        }
176    
177        public String[] getSupportedCipherSuites() {
178            return ssl.getSupportedCipherSuites();
179        }
180    
181        public Socket createSocket() throws IOException {
182            return ssl.createSocket();
183        }
184    
185        public Socket createSocket(String host, int port)
186            throws IOException {
187            return createSocket(host, port, null, 0);
188        }
189    
190        public Socket createSocket(InetAddress host, int port)
191            throws IOException {
192            return createSocket(host.getHostName(), port);
193        }
194    
195        public Socket createSocket(InetAddress host, int port,
196                                   InetAddress localHost, int localPort)
197            throws IOException {
198            return createSocket(host.getHostName(), port, localHost, localPort);
199        }
200    
201        public Socket createSocket(String host, int port,
202                                   InetAddress localHost, int localPort)
203            throws IOException {
204            return createSocket(host, port, localHost, localPort, 0);
205        }
206    
207        /**
208         * Attempts to get a new socket connection to the given host within the
209         * given time limit.
210         *
211         * @param host      the host name/IP
212         * @param port      the port on the host
213         * @param localHost the local host name/IP to bind the socket to
214         * @param localPort the port on the local machine
215         * @param timeout   the connection timeout (0==infinite)
216         * @return Socket a new socket
217         * @throws IOException          if an I/O error occurs while creating thesocket
218         * @throws UnknownHostException if the IP address of the host cannot be
219         *                              determined
220         */
221        public Socket createSocket(String host, int port, InetAddress localHost,
222                                   int localPort, int timeout)
223            throws IOException {
224            return ssl.createSocket(host, port, localHost, localPort, timeout);
225        }
226    
227        public Socket createSocket(Socket s, String remoteHost, int remotePort,
228                                   boolean autoClose)
229            throws IOException {
230            return ssl.createSocket(s, remoteHost, remotePort, autoClose);
231        }
232    
233    }