CardDAV

Introduction

Zimbra 6.0 supports the CardDAV standard. Supported clients are Apple Address Book, Sunbird, and others. Connectivity is supported with or without a ZCS reverse proxy server.

Configuring CardDAV

Apple Address Book for OS X 10.6 (Snow Leopard)

1. Address Book -> Preferences -> Accounts
2. Click the "+" to add a new account.
3. Configure account details
   • Account type: CardDAV
   • User name: your_zcs_useraccount@domain.tld
   • Password: zcsUserAccountPassword
   • Server address: zcsserver.domain.tld:port

     Be sure to include the port specification when configuring Apple AB to ensure the account is setup correctly. Use 443 if your ZCS server supports the default HTTPS port. Otherwise, specify 80 if your server does not support HTTPS and listens for HTTP on the default port 80.

4. Click Create.

   An error may display after configuring account details that states:

   Address Book couldn't discover the account settings for the CardDAV server "zcsserver.domain.tld:port". Make sure the user name and server address are correct, then click Create.

   If you receive this error, check the settings with your ZCS server administrator and try again.

5. Close AB preferences.

Apple Address Book is now setup for CardDAV to your Zimbra server.

Apple iOS 4 for iPhone/iPad/iPod Touch

1. Settings -> Mail, Contacts, Calendars -> Add Account... -> Other
2. Add CardDAV Account
3. Configure account details
   • Server: zcsserver.domain.tld:port

     Be sure to include the port specification when configuring CardDAV for iOS 4 to ensure the account is setup correctly. Use 443 if your ZCS server supports the default HTTPS port. Otherwise, specify 80 if your server does not support HTTPS and listens for HTTP on the default port 80.

   • User Name: your_zcs_useraccount@domain.tld
   • Password: zcsUserAccountPassword
   • Description: Zimbra
4. Tap Next.
5. Accept the SSL certificate warning if applicable.

iOS 4 is now setup for CardDAV to your Zimbra server. To use, navigate to the Contacts app and locate the group with the description provided during setup. Then, search for contacts.

Android

1. Install CardDAV-Sync (http://dmfs.org/carddav/)
2. Settings -> Accounts & sync
3. Tap Add account
4. Configure account details
   • Server name: zcsserver.domain.tld:port

     Be sure to include the port specification if you do not use standard ports (i.e. 80 for http and 443 for https)

   • Use SSL: leave checked if you want to connect using SSL, un-check otherwise
   • Username: your_zcs_useraccount@domain.tld
   • Password: zcsUserAccountPassword
5. Tap Next
6. Confirm SSL warning if you use a self signed certificate (and the fingerprint matches your certificate)
7. Tap the address book you want to sync
8. Enter account name (i.e. the description)
9. Un-check sync from server to phone only if you want two-way-sync
10. Tap Finish and confirm warning about two-way-sync if necessary

CardDAV-Sync starts immediately to sync your contacts. To edit settings for this account tap your new account and select Edit account settings

References and Resources

• Bug 46297 CardDAV not working correctly n Mac OS X Snow Leopard Address Book
• Bug 50595 CardDAV fails in 6.0.8 for Evolution and Mac Address Book
• Bug 50133 can't setup CalDAV account in iCal on MacOS 10.6
• Bug 59352 Contact is not getting forwarded completely
• Bug 75160 Truncates contact when exported or synched
• Ajcody's Apple Mac Issues for CardDAV
• CalDAV on SunBird

Please update this page if you have information on configuring other clients.