org.apache.directory.server.ldap.handlers.request

Class BindRequestHandler

java.lang.Object

org.apache.directory.server.ldap.handlers.LdapRequestHandler<org.apache.directory.api.ldap.model.message.BindRequest>

org.apache.directory.server.ldap.handlers.request.BindRequestHandler

All Implemented Interfaces:

org.apache.mina.handler.demux.MessageHandler<org.apache.directory.api.ldap.model.message.BindRequest>

public class BindRequestHandler
extends LdapRequestHandler<org.apache.directory.api.ldap.model.message.BindRequest>

A single reply MessageReceived handler for BindRequests. Implements server-side of RFC 2222, sections 4.2 and 4.3.

Author:

Apache Directory Project

Field Summary

Fields inherited from class org.apache.directory.server.ldap.handlers.LdapRequestHandler

ldapServer

Fields inherited from interface org.apache.mina.handler.demux.MessageHandler

NOOP

Constructor Summary

Constructors

Constructor and Description
BindRequestHandler()

Method Summary

Modifier and Type	Method and Description
void	handle(LdapSession ldapSession, org.apache.directory.api.ldap.model.message.BindRequest bindRequest) Deal with a received BindRequest
void	handleSaslAuth(LdapSession ldapSession, org.apache.directory.api.ldap.model.message.BindRequest bindRequest) Handle the SASL authentication.
void	handleSimpleAuth(LdapSession ldapSession, org.apache.directory.api.ldap.model.message.BindRequest bindRequest) Handle the Simple authentication.
void	setSaslMechanismHandlers(Map<String,MechanismHandler> handlers) Set the mechanisms handler map.

Methods inherited from class org.apache.directory.server.ldap.handlers.LdapRequestHandler

getLdapApiService, getLdapServer, handleException, handleMessage, isConfidentialityRequirementSatisfied, rejectWithoutConfidentiality, setLdapServer

Methods inherited from class java.lang.Object

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

Constructor Detail

BindRequestHandler

public BindRequestHandler()

Method Detail

setSaslMechanismHandlers

public void setSaslMechanismHandlers(Map<String,MechanismHandler> handlers)

Set the mechanisms handler map.

Parameters:

handlers - The associations btween a machanism and its handler

handleSimpleAuth

public void handleSimpleAuth(LdapSession ldapSession,
                             org.apache.directory.api.ldap.model.message.BindRequest bindRequest)
                      throws Exception

Handle the Simple authentication.

Parameters:

ldapSession - The associated Session

bindRequest - The BindRequest received

Throws:

Exception - If the authentication cannot be done

handleSaslAuth

public void handleSaslAuth(LdapSession ldapSession,
                           org.apache.directory.api.ldap.model.message.BindRequest bindRequest)
                    throws Exception

Handle the SASL authentication. If the mechanism is known, we are facing three cases :

• The user does not has a session yet
• The user already has a session
• The user has started a SASL negotiation

In the first case, we initiate a SaslBind session, which will be used all along the negotiation.
In the second case, we first have to unbind the user, and initiate a new SaslBind session.
In the third case, we have sub cases :

• The mechanism is not provided : that means the user want to reset the current negotiation. We move back to an Anonymous state
• The mechanism is provided : the user is initializing a new negotiation with another mechanism. The current SaslBind session is reinitialized

Parameters:

ldapSession - The associated Session

bindRequest - The BindRequest received

Throws:

Exception - If the authentication cannot be done

handle

public void handle(LdapSession ldapSession,
                   org.apache.directory.api.ldap.model.message.BindRequest bindRequest)
            throws Exception

Deal with a received BindRequest

Specified by:

handle in class LdapRequestHandler<org.apache.directory.api.ldap.model.message.BindRequest>

Parameters:

ldapSession - The current session

bindRequest - The received BindRequest

Throws:

Exception - If the authentication cannot be handled