dwww Home | Manual pages | Find package

Net::LDAP::Extra::AD(3User Contributed Perl DocumentaNet::LDAP::Extra::AD(3pm)

NAME
       Net::LDAP::Extra::AD -- AD convenience methods

SYNOPSIS
         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 in AD password change operations.

       To do so, it provides the following methods:

METHODS
       is_AD ( )
           Tell if the LDAP server queried is an Active Directory Domain
           Controller.

           As the check is done by querying the root DSE of the directory, it
           works without being bound to the directory.

       is_ADAM ( )
           Tell if the LDAP server queried is running AD LDS (Active Directory
           Lightweight Directory Services), previously known as ADAM (Active
           Directory Application Mode).

           As the check is done by querying the root DSE of 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 DN from its old value
           OLD_PASSWORD to the new value NEW_PASSWORD.

           This method requires encrypted connections.

       reset_ADpassword ( DN, NEW_PASSWORD, OPTIONS )
           Reset the password of the account given by DN to the value given in
           NEW_PASSWORD.  OPTIONS is 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 AD with
           sufficient permissions, and the connection needs to be encrypted.

AUTHOR
       Peter Marschall <peter@adpm.de<gt>

COPYRIGHT
       Copyright (c) 2012 Peter Marschall. All rights reserved. This program
       is free software; you can redistribute it and/or modify it under the
       same terms as Perl itself.

perl v5.32.0                      2021-01-03         Net::LDAP::Extra::AD(3pm)

Generated by dwww version 1.15 on Tue Jun 25 08:16:58 CEST 2024.