910

MDaemon: How to setup the ActiveSync AutoDiscovery Service

MDaemon's ActiveSync server now supports AutoDiscovery which significantly simplifies the configuration of mobile devices by providing support for account through AutoDiscovery. The feature facilitates the discovery of core account configuration information by using the user‘s SMTP address as the primary input by means of the following process. 

Note:AutoDiscovery requires HTTPS, you must configure WorldClient to use HTTPS. Please see related articles on how to configure this.

  1. Add a new A Record or CNAME to your public DNS. If using an A record, it is required that the record is autodiscover.domain.com and it points to public IP address of the server that MDaemon is installed on. If using a CNAME, it is required that the record is autodiscover.domain.com and it points to the hostname of the MDaemon server.
    • Once the record has been propagated, verify that you can access the AutoDiscovery Service for MDaemon. You can verify this by browsing to the following link:
    • https://AutoDiscover.domain.com/AutoDiscover/AutoDiscover.xml
    • The response should be similar to the following:
  2. The end-user enters his or her e-mail address and domain credentials, for example, kim@example.com.
  3. The client uses the domain information in the user‘s e-mail address, that is, example.com, and tries to locate the AutoDiscovery service by sending an AutoDiscovery command request to the following predefined URLs:
    • https://(smtp-address-domain)/AutoDiscover/AutoDiscover.xml
    • https://AutoDiscover.(smtp-address-domain)/AutoDiscover/AutoDiscover.xml
    • In the above example, these URLs map to https://example.com/AutoDiscover/AutoDiscover.xml and https://AutoDiscover.example.com/AutoDiscover/AutoDiscover.xml

Example

Account AutoDiscovery uses an e-mail address to look up information that is required to configure software. Given an email EduardDell@example.com, a list of possible AutoDiscovery servers is generated. The client contacts the name AutoDiscover.domain.com to provide the information. If that information is not found, the client tries to send the request to the domain name. If the information still is not retrieved, the client can use a manual configuration.

For example, the client tries these servers:

  • AutoDiscover.example.com
  • example.com

Each server is sent an HTTP Post command. The post data is an XML request for a certain type of information. E-mail account configuration will be the first use. The XML contains information that helps execute the request. For mail, the information includes the e-mail address, the protocols that the client software supports, the Web browser that is installed, the type of proxy that is being used, and the types of authentication that can be used. The post is sent for servername/AutoDiscover/AutoDiscover.xml. The servername is defined according to the process described earlier in this topic.

If running Worldclient under IIS, you will need to configure a new URL Rewrite:

  1. Open the IIS Manager
    1. Click Start
    2. Click All Programs
    3. Click Administrative Tools
    4. Click Internet Information Services (IIS) Manager
  2. On the Connections pane, expand the [Machine_name] node
  3. Expand the Sites node
  4. Click on the WorldClient site in the Connections pane
  5. Double click on URL Rewrite
  6. On the Actions pane, click Add Rule(s)...
    1. Under Inbound Rules, select Blank Rule and click OK
    2. Name the rule: mdAutoDiscover.dll
    3. Under Match URLset these settings:
      1. Requested URL: 'Matches the Pattern' (the default)
      2. Using: 'Regular Expressions' (the default)
      3. Pattern: ^AutoDiscover
      4. Ignore Case: 'Enabled' (the default)
    4. Under Actionset these settings:
      1. Action type: 'Rewrite' (the default)
      2. Rewrite URL: 'mdAutoDiscover.dll'
      3. Append query string: 'Enabled' (the default)
    5. In the Actions pane, click Apply
    6. In the Actions pane, click Back to Rules
  7. Close Internet Information Services (IIS) Manager

Additional Comments

Note: The setup of this program under IIS is NOT supported by tech support and those who choose to run WorldClient under IIS must be aware of all security issues and ramifications of running any applications under IIS. It is recommended that all Patches and updates be installed on IIS before the installation of MDSyncML as an ISAPI extension.

Note: Some devices act differently when attempting to connect via AutoDiscover.