Difference between revisions of "ActiveSync"

Revision as of 11:41, 11 January 2013

You can optionally install ActiveSync support. To do so follow these steps:

1. Download z-push from: https://developer.berlios.de/project/showfiles.php?group_id=8963.
   We used version 1.5.2 (But it's probably best to take the latest stable version of z-push 1.5.*).
2. Unpack the archive and put it in the "modules" directory of Group-Office.
3. Remove all files in the "backend" directory except for backend.php and diffbackend.php.
4. Copy backend/GObackend.php from modules/sync/z-push to modules/z-push/backend/
5. Copy config.php from modules/sync/z-push/ to modules/z-push/
6. Now, you must configure Apache to redirect the URL 'Microsoft-Server-ActiveSync' to the index.php file in the Z-Push directory. This can be done by adding the line:
   
   Alias /Microsoft-Server-ActiveSync /path/to/groupoffice/modules/z-push/index.php
   
   Don't use a symlink, this won't work. You can add this alias in a file called /etc/apache2/conf.d/groupoffice.conf for example. If you installed Group-Office using the Debian packages this has already been done by the package management.
7. Restart apache2 and configure your mobile device with the servername, username and password and you should be in sync!

IMPORTANT NOTE: remember to replace the z-push files again when you are upgrading Group-Office if you installed Group-Office manually! Debian packages will do this automatically for you from now on. But you need to perform step 5 manually (this can not be automated due to licensing issues with z-push).

CGI mode

By default z-push only works when PHP is loaded as an Apache module. If you use PHP in CGI mode you'll have to follow this workaround:

http://z-push.sourceforge.net/phpbb/viewtopic.php?f=4&t=1245&p=4762&hilit=apache_request_headers#p4762

You can also try to create a .htaccess file in the Group-Office root dir and add the following lines to it:

Options +FollowSymLinks
RewriteEngine On
RewriteRule /Microsoft-Server-ActiveSync(.*) modules/z-push/index.php$1 [E=ACTIVESYNC:true,E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]

In some versionw of PHP the apache_request_header() function doesn't exist and the following needs to be added to modules/z-push/compat.php at the end of the file just before: ?>

if (!function_exists('apache_request_headers')) {
    function apache_request_headers() {
        $header = array();
        $header['Ms-Asprotocolversion'] = $_SERVER['HTTP_MS_ASPROTOCOLVERSION'];
        $header['X-Ms-Policykey'] = $_SERVER['HTTP_X_MS_POLICYKEY'];
        $header['User-Agent'] = $_SERVER['HTTP_USER_AGENT'];

        return $header;
    }
    
    list($_SERVER['PHP_AUTH_USER'], $_SERVER['PHP_AUTH_PW']) = explode(':' , base64_decode(substr($_SERVER['REDIRECT_HTTP_AUTHORIZATION'], 6)));
}

Client setup

For more information about setting up clients read the Synchronization page.