AppSuite:CardDAVClients: Difference between revisions

From Open-Xchange
No edit summary
No edit summary
 
(5 intermediate revisions by 3 users not shown)
Line 1: Line 1:
= Open-Xchange Contacts synchronization with CardDAV =
= Open-Xchange Contacts synchronization with CardDAV =
This article is valid until the version 7.8.4 of the Open Xchange Server.
For newer versions, please visit https://documentation.open-xchange.com .


This site describes how the Open-Xchange server can be accessed via its CardDAV interface after the server has been configured as described in [[Caldav_carddav_Bundles]]. Depending on the used client software, different steps are necessary. Other clients may be configured similarly, but are not officially supported.
This site describes how the Open-Xchange server can be accessed via its CardDAV interface after the server has been configured as described in [[Caldav_carddav_Bundles]]. Depending on the used client software, different steps are necessary. Other clients may be configured similarly, but are not officially supported.
Line 7: Line 10:
Depending on the used Mac OS X version, slightly different steps are necessary.
Depending on the used Mac OS X version, slightly different steps are necessary.


=== Mac OS X Address Book (for version 10.6 Snow Leopard) ===
=== Mac OS X Contacts ===
{|
| [[image:carddav-account2.png|thumb]] || style="width:85%" |
* Click the "+" sign in Address Book -> Preferences -> Accounts.
* In the "Account type" field keep "CardDAV" selected
* In the "User name" field enter your username '''replacing "@" with "*"''' (e.g. enter "peter.fraser*CONTEXTNAME" if you normally log in to OX with the username "peter.fraser@CONTEXTNAME".)
* In the "Password" field enter your password
* In the "Server address" field enter your server address '''with the prefix "dav." and ":443" or ":80" as suffix (e.g. "dav.MYSERVER.TLD:443")'''.<br/> Use '''443''' if you normally type '''https''' in your browser to reach your installation, '''80''' otherwise.
* Click "Create"
|}
 
=== Mac OS X Address Book (for version 10.7 Lion) / Mac OS X Contacts (for version 10.8 Mountain Lion) ===
{|  
{|  
| [[image:carddav-account5.png|thumb]] || style="width:85%" |
| [[image:carddav-account5.png|thumb]] || style="width:85%" |
* Click the "+" sign in Address Book -> Preferences -> Accounts.
* Choose "Contacts" -> "Add Account..." from the Contacts App main Menu
* In the "Account type" field keep "CardDAV" selected
* In the "Choose Contacts Account Provider..." Menu choose "Other Contacts Account..."
* In the "Add a Contacts Account" Menu choose "CardDAV" and "Account Type" "Manual"
* In the "User name" field enter your username
* In the "User name" field enter your username
* In the "Password" field enter your password
* In the "Password" field enter your password
* In the "Server address" field enter your server address '''with the prefix "dav." (e.g. "dav.MYSERVER.TLD")'''.
* In the "Server address" field enter your server address '''with the prefix "dav." (e.g. "dav.myserver.tld")'''.
* Click "Create"
* Click "Sign In"
|}
|}


Line 65: Line 58:


[[Category: AppSuite]]
[[Category: AppSuite]]
[[Category: Administrator]]
[[Category: User]]
[[Category: Clients]]
[[Category: Clients]]

Latest revision as of 08:50, 15 February 2023

Open-Xchange Contacts synchronization with CardDAV

This article is valid until the version 7.8.4 of the Open Xchange Server. For newer versions, please visit https://documentation.open-xchange.com .

This site describes how the Open-Xchange server can be accessed via its CardDAV interface after the server has been configured as described in Caldav_carddav_Bundles. Depending on the used client software, different steps are necessary. Other clients may be configured similarly, but are not officially supported.

Mac OS X Address Book / Contacts

Depending on the used Mac OS X version, slightly different steps are necessary.

Mac OS X Contacts

Carddav-account5.png
  • Choose "Contacts" -> "Add Account..." from the Contacts App main Menu
  • In the "Choose Contacts Account Provider..." Menu choose "Other Contacts Account..."
  • In the "Add a Contacts Account" Menu choose "CardDAV" and "Account Type" "Manual"
  • In the "User name" field enter your username
  • In the "Password" field enter your password
  • In the "Server address" field enter your server address with the prefix "dav." (e.g. "dav.myserver.tld").
  • Click "Sign In"

PLEASE NOTE: For our product Open-Xchange Server Edition for UCS it isn't necessary to use "dav".

Debug Options

You can enable a Debug Menu inside the Address Book application which gives you access to advanced debugging and logging options. Please notice that some of these options may increase the size of the log files of your system and/or could also log sensitive data like passwords if enabled. Keep also in mind that any setting changed here will remain active until the setting itself will be reverted or changed again which means that disabling the Debug Menu itself is not sufficient to reset any debug settings to their defaults. All settings are case sensitive.

Open a terminal window (Applications > Utilities > Terminal) and issue the following command for

  • enabling the Debug Menu in the AddressBook:
defaults write com.apple.AddressBook ABShowDebugMenu -bool true
  • disabling the Debug Menu in the AddressBook:
defaults write com.apple.AddressBook ABShowDebugMenu -bool false

PLEASE NOTE:: The debug menu is not available in Mac OS X 10.8.


iOS Contacts

The iOS Contacts application on the iPhone, iPod or iPad can be configured as follows.

Ios carddav config.png
  • Open "Settings"
  • Select "Mail, Contacts, Calendars" -> "Add Account..." -> "Other" -> "Add CardDAV Account"
  • Enter the server address, username as password as shown in the screenshot
  • Click "Next"

PLEASE NOTE: For our product Open-Xchange Server Edition for UCS it isn't necessary to use "dav".


General Limitations

Please consider the following known limitations for the CardDAV interface:

Unsupported Properties

  • Importing or exporting file attachments (property "ATTACH") is not supported via the CardDAV interface.