[commits] [Wiki] changed: ActiveSync

Sun Feb 19 16:56:56 UTC 2012

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.
+
+ at 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.

