Kolab ActiveSync Service Settings Reference¶
The web service is based on Roundcube Framework and because of that it uses
the same configuration file as the webmail application i.e. /etc/roundcubemail/config.inc.php
.
Basic Configuration¶
activesync_debug
¶
Enables ActiveSync protocol debuging. This will store the complete communication between
server and activesync client into logs/console
file. Default is false
.
activesync_user_log
¶
Enables logging to a separate directory for every user/device. Default is false
.
activesync_user_debug
¶
Enables per-user debugging only if /var/log/kolab-syncroton/<username>/ folder exists.
Default is false
.
activesync_log_file
¶
If specified all ActiveSync-related logs will be saved to this file. Default is null
.
Note: This doesn’t change Roundcube Framework log locations.
activesync_addressbooks
¶
A list of global addressbooks (GAL). Default is array()
.
Note: If empty autocomplete_addressbooks
setting will be used.
activesync_gal_fieldmap
¶
ActiveSync to Roundcube contact fields map for GAL search. Default:
array(
'alias' => 'nickname',
'company' => 'organization',
'displayName' => 'name',
'emailAddress' => 'email',
'firstName' => 'firstname',
'lastName' => 'surname',
'mobilePhone' => 'phone.mobile',
'office' => 'office',
'picture' => 'photo',
'phone' => 'phone',
'title' => 'jobtitle',
);
activesync_gal_sync
¶
List of device types that will sync the LDAP addressbook(s) as a normal folder.
For devices that do not support GAL searching, e.g. Outlook. Default is false
.
Example: array('windowsoutlook')
# enable for Oultook only
Example: true
# enable for all
Note: To make the LDAP addressbook sources working we need two additional fields (‘uid’ and ‘changed’) specified in the fieldmap array of the LDAP configuration (‘ldap_public’ option). For example:
activesync_plugins
¶
List of Roundcube plugins available for ActiveSync service. WARNING: Not all plugins used in Roundcube can be listed here. Use the default!
activesync_init_subscriptions
¶
When a device is reqistered (connects for the first time), by default a set of folders is subscribed for syncronization, i.e. INBOX and personal folders with defined folder type: mail.drafts, mail.wastebasket, mail.sentitems, mail.outbox, event, event.default, contact, contact.default, task, task.default.
This default set can be extended by adding following values:
1
- all subscribed folders in personal namespace
2
- all folders in personal namespace
4
- all subscribed folders in other users namespace
8
- all folders in other users namespace
16
- all subscribed folders in shared namespace
32
- all folders in shared namespace
activesync_multifolder_blacklist
¶
Defines a blacklist of devices (device type strings) that do not support folder hierarchies.
When set to an array folder hierarchies are used on all devices not listed here.
When set to null
an old whitelist approach will be used where we do opposite
action and enable folder hierarchies only on device types known to support it.
Note: To enable multi-folder for all devices set it to array()
.
activesync_multifolder_blacklist_*
¶
Blacklist overwrites for specified object type. If set to an array
it will have a precedence over activesync_multifolder_blacklist
list only for that type.
Note: Outlook does not support multiple folders for contacts, in that case use $config['activesync_multifolder_blacklist_contact'] = array('windowsoutlook');
.
Supported types: mail, event, contact, note, task.
activesync_fix_from
¶
Enables adding sender name in the From: header of an email sent via ActiveSync
when a device uses email address only (e.g. iOS devices). Default is false
.