# check-object-password

<check-object-password> is used to validate a password against an eDirectory object. A <status> result is returned indicating success or failure.

One of an <association> element, a dest-dn attribute, or a dest-entry-id attribute is used to specify the eDirectory object against which the password is to be checked.

Note that if the eDirectory object's "Login Disabled" attribute is set to true then the <status> will indicate an error even if the password is correct.

Example

>     <check-object-password dest-dn="container\object">abdc1234</check-object-password>

## 1. Allowed Content

> association
>   Unique key of the application object.
> password
>   The authentication password.
> operation-data
>   Operation additional custom data.

## 2. Attributes

> Attribute | Value(s) | Default Value
> --- | --- | ---
> dest-dn | CDATA The distinguished name of the target object in the namespace of the receiver. | #IMPLIED
> dest-entry-id | CDATA The entry id of the target object in the namespace of the receiver. | #IMPLIED
> event-id | CDATA An identifier used to tag the results of an event or command. | #IMPLIED

## 3. Content Rule

> ( association ? , password , operation-data ? )

## 4. Parent Elements

> input
>   Input events or commands.

Top Elements || All Elements || Tree