Package org.opends.server.extensions

Class PemTrustManagerProvider

java.lang.Object

org.opends.server.api.TrustManagerProvider<PemTrustManagerProviderCfg>

org.opends.server.extensions.PemTrustManagerProvider

All Implemented Interfaces:

ConfigurationChangeListener<PemTrustManagerProviderCfg>

public final class PemTrustManagerProvider
extends TrustManagerProvider<PemTrustManagerProviderCfg>
implements ConfigurationChangeListener<PemTrustManagerProviderCfg>

A TrustManagerProvider that reads trusted certificates from PEM files in a configured file system directory and automatically reacts to file modification, deletion or addition.

Constructor Summary

Constructors

Constructor	Description
PemTrustManagerProvider()	Constructs a PemTrustManagerProvider with the default clock.

Method Summary

Modifier and Type	Method	Description
ConfigChangeResult	applyConfigurationChange(PemTrustManagerProviderCfg configuration)	Applies the configuration changes to this change listener.
void	finalizeTrustManagerProvider()	Performs any finalization that may be necessary for this trust manager provider.
TrustManager[]	getTrustManagers()	Retrieves a set of TrustManager objects that may be used for interactions requiring access to a trust manager.
void	initializeTrustManagerProvider(PemTrustManagerProviderCfg configuration)	Initializes this trust manager provider based on the information in the provided configuration entry.
boolean	isConfigurationAcceptable(PemTrustManagerProviderCfg configuration, List<LocalizableMessage> unacceptableReasons)	Indicates whether the provided configuration is acceptable for this trust manager provider.
boolean	isConfigurationChangeAcceptable(PemTrustManagerProviderCfg configuration, List<LocalizableMessage> unacceptableReasons)	Indicates whether the proposed change to the configuration is acceptable to this change listener.

Methods inherited from class org.opends.server.api.TrustManagerProvider

getServerContext, setServerContext

Methods inherited from class java.lang.Object

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

Constructor Detail

PemTrustManagerProvider

public PemTrustManagerProvider()

Constructs a PemTrustManagerProvider with the default clock.

Method Detail

initializeTrustManagerProvider

public void initializeTrustManagerProvider(PemTrustManagerProviderCfg configuration)
                                    throws InitializationException

Description copied from class: TrustManagerProvider

Initializes this trust manager provider based on the information in the provided configuration entry.

Specified by:

initializeTrustManagerProvider in class TrustManagerProvider<PemTrustManagerProviderCfg>

Parameters:

configuration - The configuration to use for this trust manager provider.

Throws:

InitializationException - If a problem occurs during initialization that is not related to the server configuration.

finalizeTrustManagerProvider

public void finalizeTrustManagerProvider()

Description copied from class: TrustManagerProvider

Performs any finalization that may be necessary for this trust manager provider.

Specified by:

finalizeTrustManagerProvider in class TrustManagerProvider<PemTrustManagerProviderCfg>

getTrustManagers

public TrustManager[] getTrustManagers()

Description copied from class: TrustManagerProvider

Retrieves a set of TrustManager objects that may be used for interactions requiring access to a trust manager.

Specified by:

getTrustManagers in class TrustManagerProvider<PemTrustManagerProviderCfg>

Returns:

A set of TrustManager objects that may be used for interactions requiring access to a trust manager.

isConfigurationAcceptable

public boolean isConfigurationAcceptable(PemTrustManagerProviderCfg configuration,
                                         List<LocalizableMessage> unacceptableReasons)

Description copied from class: TrustManagerProvider

Indicates whether the provided configuration is acceptable for this trust manager provider. It should be possible to call this method on an uninitialized trust manager provider instance in order to determine whether the trust manager provider would be able to use the provided configuration.

Overrides:

isConfigurationAcceptable in class TrustManagerProvider<PemTrustManagerProviderCfg>

Parameters:

configuration - The trust manager provider configuration for which to make the determination.

unacceptableReasons - A list that may be used to hold the reasons that the provided configuration is not acceptable.

Returns:

true if the provided configuration is acceptable for this trust manager provider, or false if not.

isConfigurationChangeAcceptable

public boolean isConfigurationChangeAcceptable(PemTrustManagerProviderCfg configuration,
                                               List<LocalizableMessage> unacceptableReasons)

Description copied from interface: ConfigurationChangeListener

Indicates whether the proposed change to the configuration is acceptable to this change listener.

Specified by:

isConfigurationChangeAcceptable in interface ConfigurationChangeListener<PemTrustManagerProviderCfg>

Parameters:

configuration - The new configuration containing the changes.

unacceptableReasons - A list that can be used to hold messages about why the provided configuration is not acceptable.

Returns:

Returns true if the proposed change is acceptable, or false if it is not.

applyConfigurationChange

public ConfigChangeResult applyConfigurationChange(PemTrustManagerProviderCfg configuration)

Description copied from interface: ConfigurationChangeListener

Applies the configuration changes to this change listener.

Specified by:

applyConfigurationChange in interface ConfigurationChangeListener<PemTrustManagerProviderCfg>

Parameters:

configuration - The new configuration containing the changes.

Returns:

Returns information about the result of changing the configuration.