org.apache.qpid.server.security.auth
Interface AuthenticationProviderInitialiser

All Known Implementing Classes:
AmqPlainInitialiser, CRAMMD5Initialiser, PlainInitialiser, UsernamePasswordInitialiser

public interface AuthenticationProviderInitialiser


Method Summary
 javax.security.auth.callback.CallbackHandler getCallbackHandler()
           
 java.lang.String getMechanismName()
           
 java.util.Map<java.lang.String,?> getProperties()
          Get the properties that must be passed in to the Sasl.createSaslServer method.
 java.lang.Class<? extends javax.security.sasl.SaslServerFactory> getServerFactoryClassForJCARegistration()
          Get the class that is the server factory.
 void initialise(java.lang.String baseConfigPath, org.apache.commons.configuration.Configuration configuration, java.util.Map<java.lang.String,PrincipalDatabase> principalDatabases)
          Initialise the authentication provider.
 

Method Detail

getMechanismName

java.lang.String getMechanismName()
Returns:
the mechanism's name. This will be used in the list of mechanism's advertised to the client.

initialise

void initialise(java.lang.String baseConfigPath,
                org.apache.commons.configuration.Configuration configuration,
                java.util.Map<java.lang.String,PrincipalDatabase> principalDatabases)
                throws java.lang.Exception
Initialise the authentication provider.

Parameters:
baseConfigPath - the path in the config file that points to any config options for this provider. Each provider can have its own set of configuration options
configuration - the Apache Commons Configuration instance used to configure this provider
principalDatabases - the set of principal databases that are available
Throws:
java.lang.Exception

getCallbackHandler

javax.security.auth.callback.CallbackHandler getCallbackHandler()
Returns:
the callback handler that should be used to process authentication requests for this mechanism. This will be called after initialise and will be stored by the authentication manager. The callback handler must be fully threadsafe.

getProperties

java.util.Map<java.lang.String,?> getProperties()
Get the properties that must be passed in to the Sasl.createSaslServer method.

Returns:
the properties, which may be null

getServerFactoryClassForJCARegistration

java.lang.Class<? extends javax.security.sasl.SaslServerFactory> getServerFactoryClassForJCARegistration()
Get the class that is the server factory. This is used for the JCA registration.

Returns:
null if no JCA registration is required, otherwise return the class that will be used in JCA registration