com.novell.nds.dirxml.ldap
Class CheckObjectPasswordRequest

java.lang.Object
  extended by com.novell.ldap.LDAPExtendedOperation
      extended by com.novell.nds.dirxml.ldap.CheckObjectPasswordRequest
All Implemented Interfaces:
Externalizable, Serializable, Cloneable, ExtendedRequest

public class CheckObjectPasswordRequest
extends LDAPExtendedOperation
implements ExtendedRequest

LDAP request to check the nspmDistributionPassword value of an eDirectory object against the object's associated password in a connected system.

To use this class with the Novell Java LDAP SDK create an instance and call LDAPConnection.extendedOperation with the instance as the LDAPExtendedOperation parameter.

If the corresponding response class has been registered then the return from LDAPConnection.extendedOperation will be an instance of the response class.

To use this class with Java LDAP JNDI create an instance and call LdapContext.extendedOperation with the instance as the ExtendedRequest parameter.

The return from LdapContext.extendedOperation will be an instance of the response class.

Rights needed:
The request issuer must have Manage Password rights to the target object, or must be authenticated as the target object.

To check the password of the issuer's object, the issuer must have read access to the DirXML-AccessCheckObjectPassword attribute on the target DirXML-Driver object.

To check the password of any object, the issuer must have write access to the DirXML-AccessCheckObjectPassword attribute on the target DirXML-Driver object.

OID:
2.16.840.1.113719.1.14.100.37

Request data:
 ASN1OctetString    object DN
 ASN1OctetString    driver DN
 

Notes:
Manage Password rights means that the request issuer has write access to the ACL attribute on the target object.

See Also:
CheckObjectPasswordResponse, LDAPConnection.extendedOperation(com.novell.ldap.LDAPExtendedOperation), Serialized Form

Constructor Summary
CheckObjectPasswordRequest(String objectDN, String driverDN)
          Construct an LDAP extended operation to check an eDir object's password against the corresponding password in a connected system.
CheckObjectPasswordRequest(String objectDN, String driverDN, int version, int timeout)
          Construct an LDAP extended operation to check an eDir object's password against the corresponding password in a connected system.
 
Method Summary
 ExtendedResponse createExtendedResponse(String id, byte[] berValue, int offset, int length)
          Create the ExtendedResponse-implementing object that corresponds to this request.
 byte[] getEncodedValue()
          Return the LBER-encoded data for this request.
 
Methods inherited from class com.novell.ldap.LDAPExtendedOperation
clone, getID, getValue, readDSML, readExternal, setID, setValue, toString, writeDSML, writeExternal
 
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface javax.naming.ldap.ExtendedRequest
createExtendedResponse, getEncodedValue, getID
 

Constructor Detail

CheckObjectPasswordRequest

public CheckObjectPasswordRequest(String objectDN,
                                  String driverDN)
                           throws LDAPException
Construct an LDAP extended operation to check an eDir object's password against the corresponding password in a connected system.

Parameters:
objectDN - the DN of the eDirectory object
driverDN - the DN of the DirXML-Driver object
Throws:
LDAPException

CheckObjectPasswordRequest

public CheckObjectPasswordRequest(String objectDN,
                                  String driverDN,
                                  int version,
                                  int timeout)
                           throws LDAPException
Construct an LDAP extended operation to check an eDir object's password against the corresponding password in a connected system.

Parameters:
objectDN - the DN of the eDirectory object
driverDN - the DN of the DirXML-Driver object
version - the sub-verb version to use
Throws:
LDAPException
Method Detail

getEncodedValue

public byte[] getEncodedValue()
Return the LBER-encoded data for this request. This is an implementation method for the JNDI ExtendedRequest interface.

Specified by:
getEncodedValue in interface ExtendedRequest
Returns:
LBER-encoded data or null, if there is no request data.

createExtendedResponse

public ExtendedResponse createExtendedResponse(String id,
                                               byte[] berValue,
                                               int offset,
                                               int length)
                                        throws NamingException
Create the ExtendedResponse-implementing object that corresponds to this request. This is an implementation method for the JNDI ExtendedRequest interface.

Specified by:
createExtendedResponse in interface ExtendedRequest
Parameters:
id - (ignored)
berValue - contains LBER-encoded response data
offset - offset into berValue
length - length (in bytes) of reponse data
Throws:
NamingException