org.postgresql.ssl.jdbc4

Class LibPQFactory

java.lang.Object

javax.net.SocketFactory

javax.net.ssl.SSLSocketFactory

org.postgresql.ssl.WrappedFactory

org.postgresql.ssl.jdbc4.LibPQFactory

All Implemented Interfaces:

javax.net.ssl.HostnameVerifier

public class LibPQFactory
extends WrappedFactory
implements javax.net.ssl.HostnameVerifier

Provide an SSLSocketFactory that is compatible with the libpq behaviour.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
(package private) static class	LibPQFactory.ConsoleCallbackHandler A CallbackHandler that reads the password from the console or returns the password given to its constructor.

Field Summary

Fields

Modifier and Type	Field and Description
private static int	ALT_DNS_NAME
(package private) LazyKeyManager	km
(package private) java.lang.String	sslmode

Fields inherited from class org.postgresql.ssl.WrappedFactory

_factory

Constructor Summary

Constructors

Constructor and Description
LibPQFactory(java.util.Properties info)

Method Summary

Modifier and Type	Method and Description
void	throwKeyManagerException() Propagates any exception from LazyKeyManager.
boolean	verify(java.lang.String hostname, javax.net.ssl.SSLSession session) Verifies the server certificate according to the libpq rules.
static boolean	verifyHostName(java.lang.String hostname, java.lang.String pattern)

Methods inherited from class org.postgresql.ssl.WrappedFactory

createSocket, createSocket, createSocket, createSocket, createSocket, getDefaultCipherSuites, getSupportedCipherSuites

Methods inherited from class javax.net.ssl.SSLSocketFactory

createSocket, getDefault

Methods inherited from class javax.net.SocketFactory

createSocket

Methods inherited from class java.lang.Object

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

Field Detail

ALT_DNS_NAME

private static final int ALT_DNS_NAME

See Also:

Constant Field Values

km

LazyKeyManager km

sslmode

java.lang.String sslmode

Constructor Detail

LibPQFactory

public LibPQFactory(java.util.Properties info)
             throws PSQLException

Parameters:

info - the connection parameters The following parameters are used: sslmode,sslcert,sslkey,sslrootcert,sslhostnameverifier,sslpasswordcallback,sslpassword

Throws:

PSQLException - if security error appears when initializing factory

Method Detail

throwKeyManagerException

public void throwKeyManagerException()
                              throws PSQLException

Propagates any exception from LazyKeyManager.

Throws:

PSQLException - if there is an exception to propagate

verifyHostName

public static boolean verifyHostName(java.lang.String hostname,
                                     java.lang.String pattern)

verify

public boolean verify(java.lang.String hostname,
                      javax.net.ssl.SSLSession session)

Verifies the server certificate according to the libpq rules. The cn attribute of the certificate is matched against the hostname. If the cn attribute starts with an asterisk (*), it will be treated as a wildcard, and will match all characters except a dot (.). This means the certificate will not match subdomains. If the connection is made using an IP address instead of a hostname, the IP address will be matched (without doing any DNS lookups).

Specified by:

verify in interface javax.net.ssl.HostnameVerifier

Parameters:

hostname - Hostname or IP address of the server.

session - The SSL session.

Returns:

true if the certificate belongs to the server, false otherwise.