Net::LDAP::Extra::AD (3)
Leading comments
Automatically generated by Pod::Man 2.28 (Pod::Simple 3.28) Standard preamble: ========================================================================
NAME
Net::LDAP::Extra::AD -- AD convenience methodsSYNOPSIS
use Net::LDAP::Extra qw(AD); $ldap = Net::LDAP->new( ... ); ... if ($ldap->is_AD || $ldap->is_ADAM) { $ldap->change_ADpassword($dn, $old_password, $new_password); }
DESCRIPTION
Net::LDAP::Extra::AD tries to spare users the necessity to reinvent the wheel again and again in order to correctly encode password strings so that they can be used inAD
password change
operations.
To do so, it provides the following methods:
METHODS
- is_AD ( )
-
Tell if the LDAPserver queried is an Active Directory Domain Controller.
As the check is done by querying the root
DSEof the directory, it works without being bound to the directory. - is_ADAM ( )
-
Tell if the LDAPserver queried is runningAD LDS(Active Directory Lightweight Directory Services), previously known asADAM(Active Directoy Application Mode).
As the check is done by querying the root
DSEof the directory, it works without being bound to the directory. - change_ADpassword ( DN, OLD_PASSWORD, NEW_PASSWORD)
-
Change the password of the account given by DNfrom its old valueOLD_PASSWORDto the new valueNEW_PASSWORD.
This method requires encrypted connections.
- reset_ADpassword ( DN, NEW_PASSWORD, OPTIONS)
-
Reset the password of the account given by DNto the value given inNEW_PASSWORD.OPTIONSis a list of key/value pairs. The following keys are recognized:
-
- force_change
-
If TRUE,the affected user is required to change the password at next login.
-
For this method to work, the caller needs to be bound to
ADwith sufficient permissions, and the connection needs to be encrypted.
-