Auto-discovery for Mobile Devices (ActiveSync)

Axigen Auto-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

  • Email: your_user@Your_domain.ltd
  • Password: your account 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).