mrubinsk Sun, 19 Feb 2012 16:56:56 +0000
Modified page: http://wiki.horde.org/ActiveSync
New Revision: 127
Change log: Add some more basic setup instructions, move Provisioning section
@@ -11,9 +11,9 @@
++ Description
The Horde !ActiveSync implementation provides over the air
synchronization of contacts, calendar, and task data to devices such
as the iPhone/iPod Touch, Android and any other system supporting
!ActiveSync. This implementation supports Microsoft !ActiveSync
protocol versions up to 2.5 - the version implemented by Microsoft
Exchange 2003.
-++ Setup
+++ Server Setup
!ActiveSync support is stable, but there are still devices on which
it has not been tested yet. If you have used a device with Horde's
!ActiveSync support that is not listed below, please feel free to let
us know how it went.
To activate the server, it needs to be enabled in Horde's
configuration, on the !ActiveSync tab. It's already enabled by
default. The SQL tables that horde uses are created as usual from the
Horde configuration screen.
@@ -41,8 +41,25 @@
<code>
alias.url = ("/Microsoft-Server-ActiveSync" => "/var/www/horde/rpc.php");
</code>
+
+++ Application Configuration
+No additional steps are normally necessary for synchronization of the
supported applications. However, each application that supports
synchronization also has a user preference to determine which shares
will be synchronized. For example, in Kronolith the user's default
calendar is *always* synchronized, but the user can choose to add any
additional calendars he/she owns. Whenever the user changes one of
these settings, the device is always automatically re-paired with the
server to pick up the change.
+
+Users can also view all their paired !ActiveSync devices by visiting
their //!ActiveSync Devices// preferences. This is located within
Horde's //Global Preferences//. From here, it is possible to force a
complete re-sync, or to request a remote wipe of a provisioned device
(see below).
+
+++ Administration
+Administrators can view all of the !ActiveSync devices paired with
the server. This is the //!ActiveSync Devices// link located under the
Administration menu. From here an administrator can request a remote
wipe, or force a re-provisioning of any device.
+
+@TODO: Explain various setup configuration options and security
policies (hearbeat etc...)
+
+++ Provisioning/!RemoteWipe
+Provisioning allows devices to be more tightly registered with a
particular server. It enables the server to be able to send policy
settings to the device. These policy settings include things like
requiring a PIN to unlock the device, the complexity of the PIN
required, the number of failed login attempts allowed etc...
Additionally, it enables devices to be remotely wiped so that if a
device is lost or stolen, the user or administrator can request the
device to be wiped.
+
+Users can initiate a remote wipe, as well as view/manage their
partnered devices in the !ActiveSync user preference.
+
+Clicking //Wipe// in the Horde interfaces for device management flags
the server to send the wipe command to the device the next time it
synchronizes. The next time the device attempts to request a command
other then PING or OPTIONS, it will be wiped. The !ActiveSync
preference page shows the status of all the user's devices. If the
status is listed as //Pending//, and you wish to cancel the wipe
request, you may do this by clicking the //Cancel Wipe// button. You
should see the status be reset to //Provisioned//. After it is wiped,
the status will be shown as //Wiped//, if you wish to allow the device
to connect to your server again, you need to explicitly remove the
device as a sync partner by clicking the //Remove// button. If you do
not remove this entry, the device will continue to be wiped each time
it reconnects to the server.
++ What works
Contacts, Calendar and Task syncing are working. Note that not all
devices support Tasks. Of the tested devices, iOS (versions < 5.0) and
Android are lacking native Task applications. The !TouchDown client
and Windows Mobile both support Tasks.
@@ -76,16 +93,8 @@
A special note for the iPhone/iPod (and possibly others) - if you do
not use a SSL enabled site you may receive errors about not being able
to find the !ActiveSync server. If this happens, just continue, or
save, or whatever your option is to continue. On the iPhone, after
everything is completely set up, you must go back into the account
settings and disable SSL.
After the connection particulars are entered, you should choose to
enable the folders that you want sync'd. Contacts, Calendar and Tasks
are supported, but your device also needs to support the requested
folders.
-
-++ Provisioning/!RemoteWipe
-
-Provisioning allows devices to be more tightly registered with a
particular server. It enables the server to be able to send policy
settings to the device. These policy settings include things like
requiring a PIN to unlock the device, the complexity of the PIN
required, the number of failed login attempts allowed etc...
Additionally, it enables devices to be remotely wiped so that if a
device is lost or stolen, the user or administrator can request the
device to be wiped.
-
-Users can initiate a remote wipe, as well as view/manage their
partnered devices in the !ActiveSync user preference.
-
-Clicking //Wipe// in the Horde interfaces for device management flags
the server to send the wipe command to the device the next time it
synchronizes. The next time the device attempts to request a command
other then PING or OPTIONS, it will be wiped. The !ActiveSync
preference page shows the status of all the user's devices. If the
status is listed as //Pending//, and you wish to cancel the wipe
request, you may do this by clicking the //Cancel Wipe// button. You
should see the status be reset to //Provisioned//. After it is wiped,
the status will be shown as //Wiped//, if you wish to allow the device
to connect to your server again, you need to explicitly remove the
device as a sync partner by clicking the //Remove// button. If you do
not remove this entry, the device will continue to be wiped each time
it reconnects to the server.
++ What to do if you have problems (or How to help us help you)
**If you are not even able to get past the initial setup page on
your phone**: you should first check to be sure you do not have SSL
enabled on the phone when you're server is not serving SSL. The
iPhone/iPod will not let you turn this off until after you save the
configuration, so you must continue through all the errors and go back
into the settings to disable SSL. You should also make sure that you
have not enabled Provisioning support if your phone does not support it.
__
commits mailing list
Frequently Asked Questions: http://horde.org/faq/
To unsubscribe, mail: [email protected]
