smaller reset larger        English         

Main Menu

All times are in GMT -8 (DST) :: The time is now 12:41 pm.

Sub Menu

Article Data
Article Ref
Written By
Josh Olson
Date Created
Tue, 9th Mar 2010
Updated By
Josh Olson
Date Modified
Tue, 9th Mar 2010

   LDAP and Apple Address Book


How do I get Apple Address Book connected to the CommuniGate Pro LDAP module?


So there are quite a number of variables in getting Apple Address Book to communicate with CGP via LDAP. I'm going to assume that the LDAP configuration is set up with the default settings/parameters. Assuming that to be true, we know a couple things:

1) The CGP LDAP Module is listening on port 389 (unsecure)

2) That a search base of top should filter the entire directory structure

The first thing I would do is use the CGP web administration interface to browse the directory and make sure your accounts are visible. You do this on the 'Directory | Browser' page of the web administration interface. At the bottom of the page will be an entry for each domain. If you click on that entry, at the bottom of the following page will be a list of accounts within that domain. And if you then click on an account, you'll see the information stored in the directory for that account.

Assuming the accounts are visible there, you can move on to configuring Apple Address Book. You'll start by clicking the 'Address Book' pull down menu and the option for 'Preferences...'. There you will click 'Accounts' followed by the '+' sign at the bottom left hand corner of that window to add a new account. In the following 'Add Account' window you'll select 'LDAP' from the 'Account Type' pull down menu. In the 'Server Address' text field you'll enter either the host name or ip address of your CGP server. Then click 'Server Options' in order to display the parameters for port and SSL.

Now as I stated above, we're going to assume a default configuration here. Meaning that port 389 is configured as the TCP listener ( for the CGP LDAP module. If you would like to confirm this, you can do so on the 'Settings | Services | LDAP | Listener' page of the web administration interface. Also I have not touched on utilizing SSL for secure connections. If secure connection is required, you'll have to set up an additional listener here, with INIT/SSL enabled. You'll also need to installed an SSL certificate ( for the domain in question.

However, assuming we're going to go with port 389 (unsecure), you just need to make sure the listener is there. Once that is confirmed, back in Apple Address Book under 'Server Options', you'll make sure it's configured to use port 389. Then click continue.

On the following page, you'll be presented with four fields. The 'Description' field is for you to give your address book a name, this can be anything. For 'Search base', I would try 'top' initially (no quotes of course). This means that directory searches start at the top of the subtree. For 'Scope' I would set it to subtree, so again is parsing the entire subtree for data. For 'Authentication' you should be able to use 'Simple', and then enter your CGP username and password. Once you have that information entered, click 'Create', and that should do it.

If it works, when you open Apple Address Book, you should have a new address book under the 'All Directories' section with the name you provided in the 'Description' field above. And if you choose that address book, and type something in the search box at the top right hand side of the screen, it should parse the CGP directory and locate/display any CGP directory-stored information it finds that matches the query.

How Useful Was This Article?      (Rating: 100%    Votes: 1)  

Select a Rating

Article Comments 

There are currently no comments.