ZCS Administrator Guide 8.0

Open Source Edition

Global Address List

The Global Address List (GAL) is a company directory of users, usually within the organization itself, that is available to all users of the email system. VMware Zimbra Collaboration Server uses the company directory to look up user addresses from within the company.

For each VMware Zimbra Collaboration Server domain you can configure GAL to use:

External LDAP server

VMware Zimbra Collaboration Server internal LDAP server

Both external LDAP server and OpenLDAP in GAL searches

The VMware Zimbra Collaboration Server Web Client can search the GAL. When the user searches for a name, that name is turned into an LDAP search filter similar to the following example, where the string %s is the name the user is searching for.

 

(|(cn = %s*)(sn=%s*)(gn=%s*)(mail=%s*)) (zimbraMailDeliveryAddress = %s*) (zimbraMailAlias=%s*) (zimbraMailAddress = %s*)

GAL Attributes in VMware Zimbra Collaboration Server

The Attributes Mapped to VMware Zimbra Collaboration Server Contact table maps generic GAL search attributes to their VMware Zimbra Collaboration Server contact fields.

LDAP attributes are mapped to GAL entry fields. For example, the LDAP attribute displayName and cn can be mapped to GAL entry field fullName. The mapping is configured in the zimbraGalLdapAttrMap attribute.

Table 1: Attributes Mapped to VMware Zimbra Collaboration Server Contact

Standard LDAP Attribute	VMware Zimbra Collaboration Server Contact Field
co	workCountry
company	Company
givenName/gn	firstName
sn	lastName
cn	fullName
initials	initials
l	workCity
street, streetaddress	workStreet
postalCode	workPostalCode
telephoneNumber	workPhone
mobile	mobile
pager	pager
facisimileTelephoneNumber	faxNumber
st	workState
title	jobTitle
mail	email
objectClass	Not currently mapped

VMware Zimbra Collaboration Server GAL Search Parameters

GAL is configured on a per-domain basis. To configure the attributes, you can run the GAL Configuration Wizard from the administration console.

Modifying Attributes

Additions, changes and deletions to the GAL attributes are made through the Zimbra administration console or from the zmprov CLI utility.

Users can modify attributes for their account in the directory when users change their options from the Zimbra Web Client, they also modify the attributes when they change their preferences.