001 /*
002 * $HeadURL: http://juliusdavies.ca/svn/not-yet-commons-ssl/tags/commons-ssl-0.3.11/src/java/org/apache/commons/ssl/SSLClient.java $
003 * $Revision: 155 $
004 * $Date: 2009-09-17 14:00:58 -0700 (Thu, 17 Sep 2009) $
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.Map;
047
048 /**
049 * @author Credit Union Central of British Columbia
050 * @author <a href="http://www.cucbc.com/">www.cucbc.com</a>
051 * @author <a href="mailto:juliusdavies@cucbc.com">juliusdavies@cucbc.com</a>
052 * @since 27-Feb-2006
053 */
054 public class SSLClient extends SSLSocketFactory {
055 private final SSL ssl;
056
057 public SSLClient()
058 throws GeneralSecurityException, IOException {
059 this.ssl = new SSL();
060 }
061
062 public void addTrustMaterial(TrustChain trustChain)
063 throws NoSuchAlgorithmException, KeyStoreException,
064 KeyManagementException, IOException, CertificateException {
065 ssl.addTrustMaterial(trustChain);
066 }
067
068 public void setTrustMaterial(TrustChain trustChain)
069 throws NoSuchAlgorithmException, KeyStoreException,
070 KeyManagementException, IOException, CertificateException {
071 ssl.setTrustMaterial(trustChain);
072 }
073
074 public void setKeyMaterial(KeyMaterial keyMaterial)
075 throws NoSuchAlgorithmException, KeyStoreException,
076 KeyManagementException, IOException, CertificateException {
077 ssl.setKeyMaterial(keyMaterial);
078 }
079
080 public void setIsSecure(boolean b) { ssl.setIsSecure(b); }
081
082 public void setDnsOverride(Map m) { ssl.setDnsOverride(m); }
083
084 public void setCheckCRL(boolean b) { ssl.setCheckCRL(b); }
085
086 public void setCheckExpiry(boolean b) { ssl.setCheckExpiry(b); }
087
088 public void setCheckHostname(boolean b) { ssl.setCheckHostname(b); }
089
090 public void setConnectTimeout(int i) { ssl.setConnectTimeout(i); }
091
092 public void setDefaultProtocol(String s) { ssl.setDefaultProtocol(s); }
093
094 public void useDefaultJavaCiphers() { ssl.useDefaultJavaCiphers(); }
095
096 public void useStrongCiphers() { ssl.useStrongCiphers(); }
097
098 public void setEnabledCiphers(String[] ciphers) {
099 ssl.setEnabledCiphers(ciphers);
100 }
101
102 public void setEnabledProtocols(String[] protocols) {
103 ssl.setEnabledProtocols(protocols);
104 }
105
106 public void setHostnameVerifier(HostnameVerifier verifier) {
107 ssl.setHostnameVerifier(verifier);
108 }
109
110 public void setSoTimeout(int soTimeout) { ssl.setSoTimeout(soTimeout); }
111
112 public void setSSLWrapperFactory(SSLWrapperFactory wf) {
113 ssl.setSSLWrapperFactory(wf);
114 }
115
116 public void setNeedClientAuth(boolean b) { ssl.setNeedClientAuth(b); }
117
118 public void setWantClientAuth(boolean b) { ssl.setWantClientAuth(b); }
119
120 public void setUseClientMode(boolean b) { ssl.setUseClientMode(b); }
121
122 public boolean isSecure() { return ssl.isSecure(); }
123
124 public X509Certificate[] getAssociatedCertificateChain() {
125 return ssl.getAssociatedCertificateChain();
126 }
127
128 public boolean getCheckCRL() { return ssl.getCheckCRL(); }
129
130 public boolean getCheckExpiry() { return ssl.getCheckExpiry(); }
131
132 public boolean getCheckHostname() { return ssl.getCheckHostname(); }
133
134 public int getConnectTimeout() { return ssl.getConnectTimeout(); }
135
136 public String getDefaultProtocol() { return ssl.getDefaultProtocol(); }
137
138 public String[] getEnabledCiphers() { return ssl.getEnabledCiphers(); }
139
140 public String[] getEnabledProtocols() { return ssl.getEnabledProtocols(); }
141
142 public HostnameVerifier getHostnameVerifier() {
143 return ssl.getHostnameVerifier();
144 }
145
146 public int getSoTimeout() { return ssl.getSoTimeout(); }
147
148 public SSLWrapperFactory getSSLWrapperFactory() {
149 return ssl.getSSLWrapperFactory();
150 }
151
152 public boolean getNeedClientAuth() { return ssl.getNeedClientAuth(); }
153
154 public boolean getWantClientAuth() { return ssl.getWantClientAuth(); }
155
156 public boolean getUseClientMode() { /* SSLClient's default is true. */
157 return ssl.getUseClientModeDefault() || ssl.getUseClientMode();
158 }
159
160 public SSLContext getSSLContext() throws GeneralSecurityException, IOException {
161 return ssl.getSSLContext();
162 }
163
164 public TrustChain getTrustChain() { return ssl.getTrustChain(); }
165
166 public X509Certificate[] getCurrentServerChain() {
167 return ssl.getCurrentServerChain();
168 }
169
170 public String[] getDefaultCipherSuites() {
171 return ssl.getDefaultCipherSuites();
172 }
173
174 public String[] getSupportedCipherSuites() {
175 return ssl.getSupportedCipherSuites();
176 }
177
178 public Socket createSocket() throws IOException {
179 return ssl.createSocket();
180 }
181
182 public Socket createSocket(String host, int port)
183 throws IOException {
184 return createSocket(host, port, null, 0);
185 }
186
187 public Socket createSocket(InetAddress host, int port)
188 throws IOException {
189 return createSocket(host.getHostName(), port);
190 }
191
192 public Socket createSocket(InetAddress host, int port,
193 InetAddress localHost, int localPort)
194 throws IOException {
195 return createSocket(host.getHostName(), port, localHost, localPort);
196 }
197
198 public Socket createSocket(String host, int port,
199 InetAddress localHost, int localPort)
200 throws IOException {
201 return createSocket(host, port, localHost, localPort, 0);
202 }
203
204 /**
205 * Attempts to get a new socket connection to the given host within the
206 * given time limit.
207 *
208 * @param host the host name/IP
209 * @param port the port on the host
210 * @param localHost the local host name/IP to bind the socket to
211 * @param localPort the port on the local machine
212 * @param timeout the connection timeout (0==infinite)
213 * @return Socket a new socket
214 * @throws IOException if an I/O error occurs while creating thesocket
215 * @throws UnknownHostException if the IP address of the host cannot be
216 * determined
217 */
218 public Socket createSocket(String host, int port, InetAddress localHost,
219 int localPort, int timeout)
220 throws IOException {
221 return ssl.createSocket(host, port, localHost, localPort, timeout);
222 }
223
224 public Socket createSocket(Socket s, String remoteHost, int remotePort,
225 boolean autoClose)
226 throws IOException {
227 return ssl.createSocket(s, remoteHost, remotePort, autoClose);
228 }
229
230 }