Technical information

INSTALLATION AND ADMINISTRATION GUIDE
126
Note
The attributes shown in this example are common to most LDAP directories.
Attribute names (dn, cn, givenName, etc.) are loosely defined in various RFCs. Although attribute names are defined
in RFCs, the standard is very informal. Therefore, each LDAP server may use slightly different attribute names to
store data.
One of the setup tasks for using an LDAP directory with VSI-FAX will be to map certain essential LDAP attributes
(e.g., the attributes for fax number, recipient name, etc.) to VSI-FAX tags so that VSI-FAX can find and use them at
send time. This mapping information is stored in the datasource database.
Important
Because attribute names may differ among LDAP servers, it is beyond the scope of this documentation to provide
exact mapping parameters that will work with every LDAP directory. Instead, you must list the attributes in your
LDAP directory and determine which ones store essential fax information. Consult your LDAP administrator to
obtain a list of attributes used on your LDAP server.
Sample LDAP attribute mappings
The following tables shows some sample LDAP attribute mappings. These settings may or may not be compatible
with your LDAP directory. They should only be considered as examples and possible initial settings for your LDAP
directory.
LDAP Attribute Name VSI-FAX
Info
Microsoft Exchange Lotus Domino ldap.vsi.com
First name
givenName givenName givenname
Last name
sn sn sn
Company
Company CompanyName company
Phone
Phone telephoneNumber phone
Fax
facsimileTelephoneNumber facsimileTelephoneNumber facsimiletelephonenumber
Email
mail mail mail
Address 1
postalAddress OfficeStreetAddress postaladdress
Address 2
l L l
Address 3
st st st
Country
co c co
General LDAP notes
Search Base
LDAP directories are arranged in a tree-like manner. The search base is used to specify which branch of the tree to
start searching on.
For example, using a search base of c=US starts searching on the branch for entries in the US.
If no search base is specified, the search will start looking globally (from the top-most branch), which could take a
long time.
Scope
The values for scope define whether a search can descend into other branches of the LDAP tree. Possible values:
Base: the search will only search the current branch.
One level: allows descending down only one level.