- Auto-discovery Prerequisites
- Auto-discovery Configuration
- Auto-discovery for Mobile Devices (ActiveSync)
- Auto-discovery for Outlook (via Axigen Outlook Connector)
- Auto-discovery for Outlook (via IMAP / POP3)
- Auto-discovery for eM Client (via IMAP / POP3, CalDAV & CardDAV)
- Auto-discovery for Mozilla Thunderbird (via IMAP / POP3)
- DNS Based Service Discovery
The ActiveSync features built into Axigen aim to provide data and option setting synchronization between the email service and a user handset compatible with the ActiveSync protocol. The Axigen implementation of ActiveSync is based on the standards used by the Microsoft® ActiveSync® protocol.
Configuring ActiveSync Auto-discovery
The ActiveSync connection uses the WebMail service on the server side. The Auto-discovery feature can be used in order to simplify the client configuration process for mobile devices. The user can specify only the email address and the password for accessing her or his Axigen account.
The following parameters from axigen.cfg
should be configured according to your specific use case:
autodiscoveryParams = { enableIMAPAutodiscovery = yes enablePOP3Autodiscovery = no enableSMTPAutodiscovery = yes enableWebDavAutodiscovery = yes autodiscoveryDefaultUrls = { httpAutodiscoveryUrl = "https://domain.name:443/Microsoft-Server-ActiveSync" } }
Prerequisites: In order to use the ActiveSync service, you need to have it enabled under the account and server, as described here
In your DNS server, configure an entry with the name autodiscover.youremaildomain.tld
, such as:
autodiscover IN A 193.230.245.23
The ActiveSync service will connect to the WebMail Listener that listens on port 443 (default HTTPS listener).
Using ActiveSync Auto-discovery on Android devices
Step | Screenshots | Instructions |
---|---|---|
1 |
|
Navigate to Settings → Accounts → Other Accounts → Add Account → tap on Exchange |
2 |
|
Enter your mailbox information — email address and password
and tap "Next" |
3 |
|
The Auto-discovery service will provide your mail server settings and you will only need to tap on "Next".
|
Using the newly created account in the ActiveSync client, we recommend you to send an external email (and make sure it's received), in order to make sure everything works as expected.
The request is traceable in everything.txt
(log level set to "Protocol Communication") and should be similar to:
2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: << POST /autodiscover/autodiscover.xml HTTP/1.1 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: << Authorization: *** 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: << MS-ASProtocolVersion: 2.5 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: << User-Agent: Android-Mail/6.10.9.136347105.release 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: << Accept-Encoding: gzip 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: << Content-Type: text/xml 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: << X-MS-PolicyKey: 0 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: << Content-Length: 369 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: << Host: domain.name 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: << Connection: Keep-Alive 2016-11-14 06:55:21 -0500 08 axigen WEBMAIL:00000005: ASYNC account 'user@domain.name' has logged in 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: << AUTODISCOVER REQUEST 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: << AUTODISC <?xml version="1.0" encoding="utf-8" standalone="no" ?> 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: << AUTODISC <Autodiscover xmlns="http://schemas.microsoft.com/exchange/autodiscover/mobilesync/requestschema/2006" xmlns="http://schemas.microsoft.com/exchange/autodiscover/mobilesync/requestschema/2006"> 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: << AUTODISC 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: << AUTODISC <Request> 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: << AUTODISC <EMailAddress>user@domain.name</EMailAddress> 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: << AUTODISC <AcceptableResponseSchema>http://schemas.microsoft.com/exchange/autodiscover/mobilesync/responseschema/2006</AcceptableResponseSchema> 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: << AUTODISC </Request> 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: << AUTODISC 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: << AUTODISC </Autodiscover> 2016-11-14 06:55:21 -0500 08 axigen WEBMAIL:00000005: AUTODISC Start reading Autodiscover requests for 1 email addresses 2016-11-14 06:55:21 -0500 08 axigen WEBMAIL:00000005: AUTODISC Build response for Autodiscover MobileSync Schema 2016-11-14 06:55:21 -0500 08 axigen WEBMAIL:00000005: AUTODISC Using ActiveSync AUTODISCOVER URL from server configuration: https://domain.name:443/Microsoft-Server-ActiveSync 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: >> 200 OK 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: >> AUTODISCOVER RESPONSE 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: >> AUTODISC <?xml version="1.0" encoding="utf-8" standalone="no" ?> 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: >> AUTODISC <Autodiscover xmlns="http://schemas.microsoft.com/exchange/autodiscover/responseschema/2006"> 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: >> AUTODISC 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: >> AUTODISC <Response xmlns="http://schemas.microsoft.com/exchange/autodiscover/mobilesync/responseschema/2006"> 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: >> AUTODISC <Culture>en:us</Culture> 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: >> AUTODISC <User> 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: >> AUTODISC <DisplayName/> 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: >> AUTODISC <EMailAddress>user@domain.name</EMailAddress> 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: >> AUTODISC </User> 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: >> AUTODISC <Action> 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: >> AUTODISC <Settings> 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: >> AUTODISC <Server> 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: >> AUTODISC <Type>MobileSync</Type> 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: >> AUTODISC <Url>https://domain.name:443/Microsoft-Server-ActiveSync</Url> 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: >> AUTODISC <Name>https://domain.name:443/Microsoft-Server-ActiveSync</Name> 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: >> AUTODISC </Server> 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: >> AUTODISC </Settings> 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: >> AUTODISC </Action> 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: >> AUTODISC </Response> 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: >> AUTODISC 2016-11-14 06:55:21 -0500 16 axigen WEBMAIL:00000005: >> AUTODISC </Autodiscover>
Additional info on the ActiveSync Auto-discovery implementation can be found here: https://msdn.microsoft.com/en-us/library/office/hh352638%28v=exchg.140%29.aspx
In order for the Auto-discovery service to work, the SSL certificate must be issued by a valid Certificate Authority (CA).