How to setup the Auto-Discovery Service

MDaemon includes support for Auto-Discovery which simplifies the configuration of accounts in email clients that support the protocol.  In most cases, the email address and password are all that's required to configure accounts.



Note:Auto-Discovery requires HTTPS, you must configure Webmail 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.comand 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
  2. The end-user enters the 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 Auto-Discovery 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


Account Auto-Discovery 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 Webmail 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/Webmail 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 Webmail 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.