NAME

SYNOPSIS

  use AddressBook;
  $a = AddressBook->new(source => "LDAP:hostname/ou=People,dc=example,dc=com",
                        username => "user", password => "pass");
  $a->add($entry) || die $a->code;

DESCRIPTION

AddressBook::DB::LDAP supports random access backend database methods.

Behavior can be modified using the following options:

key_fields

A list of LDAP attribute names (not cannonical names) which can be used to uniquely identify an entry.

hostname

The LDAP host to which to connect.

base

The base for LDAP queries.

objectclass

The objectclass for AddressBook entries.

username

An LDAP dn to use for accessing the server.

password

dn_calculate

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"
                        );

AUTHOR

SEE ALSO

Net::LDAP