netscape.ldap
Class LDAPSaslBind

java.lang.Object
  |
  +--netscape.ldap.LDAPSaslBind

public class LDAPSaslBind

extends java.lang.Object

implements LDAPBind, java.io.Serializable

Authenticates to a server using SASL

See Also:

Serialized Form

Constructor Summary

LDAPSaslBind(java.lang.String dn, java.lang.String[] mechanisms, java.lang.String packageName, java.util.Hashtable props, java.lang.Object cbh)
Construct an object which can authenticate to an LDAP server using the specified name and a specified SASL mechanism.

Method Summary

void	bind(LDAPConnection ldc) Authenticates to the LDAP server (that the object is currently connected to) using the parameter that were provided to the constructor.

Methods inherited from class java.lang.Object

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

Constructor Detail

LDAPSaslBind

public LDAPSaslBind(java.lang.String dn,
                    java.lang.String[] mechanisms,
                    java.lang.String packageName,
                    java.util.Hashtable props,
                    java.lang.Object cbh)

Construct an object which can authenticate to an LDAP server using the specified name and a specified SASL mechanism.

Parameters:

dn - if non-null and non-empty, specifies that the connection and all operations through it should authenticate with dn as the distinguished name

mechanisms - array of mechanism names, e.g. { "GSSAPI", "SKEY" }

props - optional additional properties of the desired authentication mechanism, e.g. minimum security level

cbh - a class which may be called by the SASL framework to obtain additional required information

Method Detail

bind

public void bind(LDAPConnection ldc)
          throws LDAPException

Authenticates to the LDAP server (that the object is currently connected to) using the parameter that were provided to the constructor. If the requested SASL mechanism is not available, an exception is thrown. If the object has been disconnected from an LDAP server, this method attempts to reconnect to the server. If the object had already authenticated, the old authentication is discarded.

Specified by:

bind in interface LDAPBind

Parameters:

ldc - an active connection to a server, which will have the new authentication state on return from the method

Throws:

LDAPException - Failed to authenticate to the LDAP server.