How to set up the shared addressbook

All Forget About IT™ servers have an LDAP based shared addressbook. It can be accessed from many applications, including most email clients, and a number of desktop address books as well, and you will find that your webmail account already has this facility enabled. In order to access the shared addressbook from an application you will need the following information.

• Server Name: Usually mail.<your domain name> or server.<your domain name>. Often you can use a short name such as "server" on its own if the computer is not used outside of the office network.

• User Name / Account ID: This is a bit complicated. We have a web page on your server where you can copy this from. It takes the following form: uid=<your user id>,ou=People,dc=<your domain shortcode>,dc=uk,dc=fabit,dc=net. (fabit is the shortest version of Forget ABout IT we could find that was still available. It was only afterwards we realised that it could also be read as FABulous IT!).

• Password: Hopefully you will already know this, as we cannot find out what your password is as it stored as an encrypted form.

• Search Base: ou=AddressBook,dc=<your domain shortcode>,dc=uk,dc=fabit,dc=net.

Specific information on the settings for your server are available on the help page of the Address Book web interface. See How do I access the system remotely on how to log in to your server's web interface.

Outlook 2010

1. Go to File -> Info -> Account Settings.
2. Click on the Address Book tab.
3. Click on New.
4. Select Internet Directory Service
5. Enter your server name (from the Address Book help page) and tick This server requires me to log on.
6. Enter your LDAP format user name (from the Address Book help page) and your password (the same you use to log in to email). Do not tick SPA.
7. Click on More Settings and click OK to the warning message.
8. Choose a friendly display name, like Shared Address Book.
9. Click on search and enter the search base (from the Address Book help page).
10. Click on OK, and then on Finish.

Useful Links

• http://helpdesk.wisc.edu/wiscmail/page.php?id=13789
• http://kb.wisc.edu/page.php?id=13847

Outlook 2007

1. Select Tools > Account Settings
2. Select Address Books then select New
3. Select Internet Directory Service (LDAP) then select Next
4. Enter your server name (from the Address Book help page) and tick This server requires me to log on.
5. Enter your LDAP format user name (from the Address Book help page) and your password (the same you use to log in to email). Do not tick SPA.
6. Click on More Settings and click OK to the warning message.
7. Choose a friendly display name, like Shared Address Book.
8. Click on search and enter the search base (from the Address Book help page).
9. Click on OK, and then on Finish.

Thunderbird

How to set up Thunderbird

Mac OS X 10.10.x (Yosemite) - Contacts.app 9.x

1. Go to menu Contacts > Preferences > Accounts
   1. (Attention! Not directly to Contacts > Accounts which would redirect to another UI Apple > Preferences > Internet Accounts)
2. Press + at the bottom left corner to add an account
3. Select CardDav in account type in the selection box, shall be already pre-selected, select it otherwise
4. Enter your username (e.g richard)
5. Enter your password (e.g blablabla)
6. Enter Server Path which is an URL in the following format as: <serverhostname>/davical/caldav.php/<ressource>/<collection>
   1. e.g for personal addressbook enter something like:remote.monserver.com/davical/caldav.php/richard/addresses or
   2. e.g for shared addressbook enter something like:remote.monserver.com/davical/caldav.php/shared/addresses

ATTENTION: Make sure NOT to prefix server name with https:// as this is automatically added by Contacts.app client software (this rule may also apply for Manual setup under 10.11 El Capitain version, to be confirmed) and would result in a failed authentication due to wrong URL format.

Known issue 1 (https://gitlab.com/davical-project/davical/issues/72): While contacts can be viewed and updated, creating new contact would fail and crash the application. This is a known issue that shall be resolved in future version of Davical server. If a new contact is created and application crash, the only way to sort it out is to remove the new added entry in the address book before it crashes (you may need to disable automatic sync update first) or remove/re-add account. ==> As a temporary workaround, use an alternative client application to create new contacts (Contacts.app on iOS - iPhone/iPad, Cardbook add-on for Thunderbird setup to sync the CardDav address book).

Fixed issue 1: Add $c->post_add_member = false in config.php file on server

Known issue 2: With Davical 1.1.3.1 and lower, address formatting in Contact.app on Mac OS X may be lost (formatted on one line with semi-colon)...

Fixed issue 2: Upgrade to Davical 1.1.4 or upper package... on server...

Known issue 3: Import of several thousand of contact in Mac OS X contacts.app fails and timeout (only partially imported).

Fixed issue 3: Upgrade operating system on server to upgrade php,postgres,etc... package versions!

Mac OS X 10.11.x (El Capitain) - Contacts.app 10.x

1. Go to menu Contacts > Preferences > Accounts
   1. (Attention! Not directly to Contacts > Accounts which would redirect to another UI Apple > Preferences > Internet Accounts)
2. Press + at the bottom left corner to add an account
3. Select CardDav in in the first selection box, shall be already pre-selected, select it otherwise
4. Select Manual in account type in the selection box instead of Automatic as preset.
5. Enter your username (e.g richard)
6. Enter your password (e.g blablabla)
7. Enter Server Path which is an URL in the following format as: <serverhostname>/davical/caldav.php/<ressource>/<collection>
   1. e.g for personal addressbook enter something like:remote.monserver.com/davical/caldav.php/richard/addresses

ATTENTION: Make sure NOT to prefix server name with https:// as this is automatically added by Contacts.app client software and would result in a failed authentication due to wrong URL format.

Known issue 1: This client version cannot access shared resource. Bug reported to Apple that still need to come up with a fix :-)

iOS iphone/ipad

1. Go to Settings > Mail,Contacts,Calendar
2. Add new account of type Others (you may need to scroll down to see this type)
3. Add CardDav account
4. Enter Server Path which is an URL in the following format as: <serverhostname>/davical/caldav.php/<ressource>/<collection>
   1. e.g for personal addressbook enter something like:https://remote.monserver.com/davical/caldav.php/richard/addresses
5. Enter your username (e.g richard)
6. Enter your password (e.g blablabla)
7. Enter a description (display name) for the account

Done :-)