NAME

Connector::Proxy::Net::LDAP::Single

DESCRIPTION

Search and return a single item from the repository. Attributes from the ldap entry can be mapped to the returned structure using a map.

The connector will die if multiple entries are found.

configuration options

See Connector::Proxy::Net::LDAP for basic configuration options

The class needs a map of attribute names to map between the returned hash and the names of the ldap attributes.

 connector:
    LOCATION:...
    ....
    attrmap:
      certificate:usercertificate
      department:ou

Warning: Do not set the attr property

accessor methods

You need to define a map to assign the resulting ldap attributes to the returned hash structure. The maps keys remain keys whereas the value is set to the value of the ldap attribute with that name. Multivalued attributes are truncated to the first entry by default. To get them as array ref, set the deep parameter to true "{ deep =" 1}>.

Note: the special name pkey is reserved and contains the dn of the entry.

get_keys

Return the keys which are set in the resulting hash. Keys that do not have a matching attribute value are not set.

get_list / get_size

Not supported.

set

Set attributes of a node, if configured will create a non-exisiting node. The set method requires a hash as value parameter.

You can control how existing attributes in the node are treated and if missing nodes are created on the fly. See Connector::Proxy::Net::LDAP for details.

Set multiple attributes on an existing node

The connector first does a search similar to its "get" method based on the passed filter arguments. If exactly one entry is found, it works like the inverse of the get_hash method. It needs an attributemap and maps all values from the input hash to the ldap attributes. Only keys which are present in the input array are handled.

Set operation when the dn is known

If you used another ldap operation before and already know the dn, you can pass this dn as parameter pkey to the set method.

    $conn->set('John Doe', { mail => <new mail address>}, { pkey => $dn });

The dn is returned by example by the "get_hash" method.

Set operation with node autocreation

To enable the automated creation of missing nodes, look for the corresponding section in the base class Connector::Proxy::Net::LDAP.