1Net::LDAP::Extra::AD(3)User Contributed Perl DocumentatioNnet::LDAP::Extra::AD(3)
2
3
4
6 Net::LDAP::Extra::AD -- AD convenience methods
7
9 use Net::LDAP::Extra qw(AD);
10
11 $ldap = Net::LDAP->new( ... );
12
13 ...
14
15 if ($ldap->is_AD || $ldap->is_ADAM) {
16 $ldap->change_ADpassword($dn, $old_password, $new_password);
17 }
18
20 Net::LDAP::Extra::AD tries to spare users the necessity to reinvent the
21 wheel again and again in order to correctly encode password strings so
22 that they can be used in AD password change operations.
23
24 To do so, it provides the following methods:
25
27 is_AD ( )
28 Tell if the LDAP server queried is an Active Directory Domain
29 Controller.
30
31 As the check is done by querying the root DSE of the directory, it
32 works without being bound to the directory.
33
34 is_ADAM ( )
35 Tell if the LDAP server queried is running AD LDS (Active Directory
36 Lightweight Directory Services), previously known as ADAM (Active
37 Directory Application Mode).
38
39 As the check is done by querying the root DSE of the directory, it
40 works without being bound to the directory.
41
42 change_ADpassword ( DN, OLD_PASSWORD, NEW_PASSWORD )
43 Change the password of the account given by DN from its old value
44 OLD_PASSWORD to the new value NEW_PASSWORD.
45
46 This method requires encrypted connections.
47
48 reset_ADpassword ( DN, NEW_PASSWORD, OPTIONS )
49 Reset the password of the account given by DN to the value given in
50 NEW_PASSWORD. OPTIONS is a list of key/value pairs. The following
51 keys are recognized:
52
53 force_change
54 If TRUE, the affected user is required to change the password
55 at next login.
56
57 For this method to work, the caller needs to be bound to AD with
58 sufficient permissions, and the connection needs to be encrypted.
59
61 Peter Marschall <peter@adpm.de<gt>
62
64 Copyright (c) 2012 Peter Marschall. All rights reserved. This program
65 is free software; you can redistribute it and/or modify it under the
66 same terms as Perl itself.
67
68
69
70perl v5.36.0 2023-01-24 Net::LDAP::Extra::AD(3)