com.unboundid.ldap.listener
Class InMemorySASLBindHandler

java.lang.Object
  extended by com.unboundid.ldap.listener.InMemorySASLBindHandler
Direct Known Subclasses:
PLAINBindHandler

@Extensible
@ThreadSafety(level=INTERFACE_NOT_THREADSAFE)
public abstract class InMemorySASLBindHandler
extends java.lang.Object

This class defines an API that may be used to provide support for a specified SASL mechanism in the in-memory directory server.


Constructor Summary
InMemorySASLBindHandler()
           
 
Method Summary
abstract  java.lang.String getSASLMechanismName()
          Retrieves the name of the SASL mechanism supported by this bind handler.
abstract  BindResult processSASLBind(InMemoryRequestHandler handler, int messageID, DN bindDN, ASN1OctetString credentials, java.util.List<Control> controls)
          Performs the appropriate processing for a SASL bind request with the provided information.
 java.lang.String toString()
          Retrieves a string representation of this SASL bind handler.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

InMemorySASLBindHandler

public InMemorySASLBindHandler()
Method Detail

getSASLMechanismName

public abstract java.lang.String getSASLMechanismName()
Retrieves the name of the SASL mechanism supported by this bind handler.

Returns:
The name of the SASL mechanism supported by this bind handler.

processSASLBind

public abstract BindResult processSASLBind(InMemoryRequestHandler handler,
                                           int messageID,
                                           DN bindDN,
                                           ASN1OctetString credentials,
                                           java.util.List<Control> controls)
Performs the appropriate processing for a SASL bind request with the provided information.

If the bind processing is successful, then this method should also call InMemoryRequestHandler.setAuthenticatedDN(DN) on the provided request handler instance to set the identity of the authenticated user.

If the associated SASL mechanism requires multiple stages of processing and it is necessary to store and retrieve state information to use in other stages of the bind processing, then the map returned by the InMemoryRequestHandler.getConnectionState() method should be used for this purpose.

Parameters:
handler - The in-memory request handler that accepted the bind request.
messageID - The message ID for the LDAP message that the client used to send the request.
bindDN - The bind DN provided by the client.
credentials - The SASL credentials provided by the client, or null if there were none.
controls - The request controls provided by the client.
Returns:
The result that should be returned to the client in response to the provided request.

toString

public java.lang.String toString()
Retrieves a string representation of this SASL bind handler.

Overrides:
toString in class java.lang.Object
Returns:
A string representation of this SASL bind handler.