org.ldaptive.ssl

Class SslConfig

java.lang.Object

org.ldaptive.AbstractConfig

org.ldaptive.ssl.SslConfig

public class SslConfig
extends AbstractConfig

Contains all the configuration data for SSL and startTLS. Providers are not guaranteed to support all the options contained here.

Field Summary

Fields

Modifier and Type	Field and Description
private CredentialConfig	credentialConfig Configuration for the trust and authentication material to use for SSL and startTLS.
private java.lang.String[]	enabledCipherSuites Enabled cipher suites.
private java.lang.String[]	enabledProtocols Enabled protocol versions.
private javax.net.ssl.HandshakeCompletedListener[]	handshakeCompletedListeners Handshake completed listeners.
private javax.net.ssl.TrustManager[]	trustManagers Trust managers.

Fields inherited from class org.ldaptive.AbstractConfig

logger

Constructor Summary

Constructors

Constructor and Description
SslConfig() Default constructor.
SslConfig(CredentialConfig config) Creates a new ssl config.
SslConfig(CredentialConfig config, javax.net.ssl.TrustManager... managers) Creates a new ssl config.
SslConfig(javax.net.ssl.TrustManager... managers) Creates a new ssl config.

Method Summary

Modifier and Type	Method and Description
CredentialConfig	getCredentialConfig() Returns the credential config.
java.lang.String[]	getEnabledCipherSuites() Returns the names of the SSL cipher suites to use for secure connections.
java.lang.String[]	getEnabledProtocols() Returns the names of the SSL protocols to use for secure connections.
javax.net.ssl.HandshakeCompletedListener[]	getHandshakeCompletedListeners() Returns the handshake completed listeners to use for secure connections.
javax.net.ssl.TrustManager[]	getTrustManagers() Returns the trust managers.
boolean	isEmpty() Returns whether this ssl config contains any configuration data.
static SslConfig	newSslConfig(SslConfig config) Returns a ssl config initialized with the supplied config.
void	setCredentialConfig(CredentialConfig config) Sets the credential config.
void	setEnabledCipherSuites(java.lang.String... suites) Sets the SSL cipher suites to use for secure connections.
void	setEnabledProtocols(java.lang.String... protocols) Sets the SSL protocol versions to use for secure connections.
void	setHandshakeCompletedListeners(javax.net.ssl.HandshakeCompletedListener... listeners) Sets the handshake completed listeners to use for secure connections.
void	setTrustManagers(javax.net.ssl.TrustManager... managers) Sets the trust managers.
java.lang.String	toString()

Methods inherited from class org.ldaptive.AbstractConfig

checkImmutable, checkStringInput, makeImmutable

Methods inherited from class java.lang.Object

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

Field Detail

credentialConfig

private CredentialConfig credentialConfig

Configuration for the trust and authentication material to use for SSL and startTLS.

trustManagers

private javax.net.ssl.TrustManager[] trustManagers

Trust managers.

enabledCipherSuites

private java.lang.String[] enabledCipherSuites

Enabled cipher suites.

enabledProtocols

private java.lang.String[] enabledProtocols

Enabled protocol versions.

handshakeCompletedListeners

private javax.net.ssl.HandshakeCompletedListener[] handshakeCompletedListeners

Handshake completed listeners.

Constructor Detail

SslConfig

public SslConfig()

Default constructor.

SslConfig

public SslConfig(CredentialConfig config)

Creates a new ssl config.

Parameters:

config - credential config

SslConfig

public SslConfig(javax.net.ssl.TrustManager... managers)

Creates a new ssl config.

Parameters:

managers - trust managers

SslConfig

public SslConfig(CredentialConfig config,
                 javax.net.ssl.TrustManager... managers)

Creates a new ssl config.

Parameters:

config - credential config

managers - trust managers

Method Detail

isEmpty

public boolean isEmpty()

Returns whether this ssl config contains any configuration data.

Returns:

whether all properties are null

getCredentialConfig

public CredentialConfig getCredentialConfig()

Returns the credential config.

Returns:

credential config

setCredentialConfig

public void setCredentialConfig(CredentialConfig config)

Sets the credential config.

Parameters:

config - credential config

getTrustManagers

public javax.net.ssl.TrustManager[] getTrustManagers()

Returns the trust managers.

Returns:

trust managers

setTrustManagers

public void setTrustManagers(javax.net.ssl.TrustManager... managers)

Sets the trust managers.

Parameters:

managers - trust managers

getEnabledCipherSuites

public java.lang.String[] getEnabledCipherSuites()

Returns the names of the SSL cipher suites to use for secure connections.

Returns:

cipher suites

setEnabledCipherSuites

public void setEnabledCipherSuites(java.lang.String... suites)

Sets the SSL cipher suites to use for secure connections.

Parameters:

suites - cipher suites

getEnabledProtocols

public java.lang.String[] getEnabledProtocols()

Returns the names of the SSL protocols to use for secure connections.

Returns:

enabled protocols

setEnabledProtocols

public void setEnabledProtocols(java.lang.String... protocols)

Sets the SSL protocol versions to use for secure connections.

Parameters:

protocols - enabled protocols

getHandshakeCompletedListeners

public javax.net.ssl.HandshakeCompletedListener[] getHandshakeCompletedListeners()

Returns the handshake completed listeners to use for secure connections.

Returns:

handshake completed listeners

setHandshakeCompletedListeners

public void setHandshakeCompletedListeners(javax.net.ssl.HandshakeCompletedListener... listeners)

Sets the handshake completed listeners to use for secure connections.

Parameters:

listeners - for SSL handshake events

newSslConfig

public static SslConfig newSslConfig(SslConfig config)

Returns a ssl config initialized with the supplied config.

Parameters:

config - ssl config to read properties from

Returns:

ssl config

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object