AddressBook::DB::LDAP - Backend for AddressBook to use LDAP.
use AddressBook; $a = AddressBook->new(source => "LDAP:hostname/ou=People,dc=example,dc=com", username => "user", password => "pass"); $a->add($entry) || die $a->code;
The Net::LDAP library module is required in order to use this package.
AddressBook::DB::LDAP supports random access backend database methods.
Behavior can be modified using the following options:
A list of LDAP attribute names (not cannonical names) which can be used to uniquely identify an entry.
The LDAP host to which to connect.
The base for LDAP queries.
The objectclass for AddressBook entries.
An LDAP dn to use for accessing the server.
A perl expression which, when eval'd returns a valid LDAP "dn" (omitting the "base" part of the dn). Other attributes may be referenced as "$<attr>".
For example, if LDAP entries have a dn like: "cn=John Doe,mail=jdoe@mail.com", then use the following:
dn_calculate="'cn=' . $cn . ',mail=' . $mail"
Any of these options may be specified in the constructor, or in the configuration file.
$a = AddressBook->new(source => "LDAP"); $a = AddressBook->new(source => "LDAP:localhost/ou=People,dc=example,dc=com"); $a = AddressBook->new(source => "LDAP", hostname=>"localhost", base=>"o=test" );
Any or all options may be specified in the constructor, or in the configuration file.
For syncronization purposes, all records are timestamped using the "modifytimestamp" LDAP attribute. If the record has no "modifytimestamp", "createtimestamp" is used. If there is no "createtimestamp", the current time is used.
Mark A. Hershberger, <mah@everybody.org> David L. Leigh, <dleigh@sameasiteverwas.net>
AddressBook, AddressBook::Config, AddressBook::Entry.
Net::LDAP
To install AddressBook, copy and paste the appropriate command in to your terminal.
cpanm
cpanm AddressBook
CPAN shell
perl -MCPAN -e shell install AddressBook
For more information on module installation, please visit the detailed CPAN module installation guide.