Auto-discovery for eM Client (via IMAP / POP3, CalDAV & CardDAV)

Axigen Auto-discovery

This article was built using eM Client 7.

 

eM Client attempts Auto-discovery (IMAP, POP, SMTP, CalDAV, CardDAV) only via HTTPS.

SSL connections (HTTPS, IMAPS, POP3S, and SMTPS) will work only if TLS 1.0 is enabled.

If HTTPS Auto-discovery connection fails (using POST), it will fail over on HTTP (using GET) — this will also fail as Axigen does not support this method.

 

1. In axigen.cfg, set to "yes" the flags that enable Auto-discovery for the desired protocol and provide the hostnames and ports corresponding to the IMAP(S) / POP(S) and SMTP(S) protocols, to be advertised by Auto-discovery.

autodiscoveryParams = {
    enableIMAPAutodiscovery = yes
    enablePOP3Autodiscovery = no
    enableSMTPAutodiscovery = yes
    enableWebDavAutodiscovery = yes
    autodiscoveryDefaultUrls = {
        httpAutodiscoveryUrl = ""
        imapAutodiscoveryUrl = "imaps://example.com:993"
        pop3AutodiscoveryUrl = "pop3s://example.com:995"
        smtpAutodiscoveryUrl = "smtps://example.com:465"
        webDavAutodiscoveryUrl = ""
    }
}

 

2. In your DNS server, configure an entry with the name autodiscover.youremaildomain.tld, such as:

autodiscover          IN      A       193.230.245.23

If you perform a custom configuration:

  • enableIMAPAutodiscovery = yes
  • enablePOP3Autodiscovery = yes
  • enableSMTPAutodiscovery = yes

eM Client will automatically choose IMAP over POP3.

SCREENSHOTS

INSTRUCTIONS

Within eM Client, go to the "Tools" menu and click "Accounts" → "New account..."

Enter your email address and click on "Start Now".

Enter your email account's password and click on "Continue"

Under this step you can change your "Display Name" and "Account Name".

Press the "Finish" button to create your account.

eM Client displays your general settings and allows you to edit them.

You can click on "Ok" if you want to finish the eM Client setup and start using it.

Under the IMAP tab you can check the IMAP settings applied via Auto-discovery.

You can click on "Ok" if you want to finish the eM Client Setup and start using it.

Under the SMTP tab you can check the SMTP settings applied via Auto-discovery.

You can click on "Ok" if you want to finish the eM Client Setup and start using it.

Under the Diagnostic tab, you can "Diagnose" your mail settings.

You can click on "Ok" if you want to finish the eM Client setup and start using it.

 

 

The request is traceable in everything.txt (log level set to "Protocol Communication") and should be similar to:

2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: << POST /autodiscover/autodiscover.xml HTTP/1.1
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: << Content-Type: text/xml
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: << Authorization: ***
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: << Host: example.com
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: << Content-Length: 453
2016-11-23 07:35:02 -0500 08 axigen WEBMAIL:0000140B: ASYNC account 'user@example.com' has logged in
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: << AUTODISCOVER REQUEST
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: << AUTODISC <?xml version="1.0" encoding="utf-8" standalone="no" ?>
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: << AUTODISC <Autodiscover xmlns="http://schemas.microsoft.com/exchange/autodiscover/outlook/requestschema/2006" xmlns="http://schemas.microsoft.com/exchange/autodiscover/outlook/requestschema/2006" xsd="http://www.w3.org/2001/XMLSchema" xsi="http://www.w3.org/2001/XMLSchema-instance">
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: << AUTODISC   <Request>
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: << AUTODISC     <EMailAddress>user@example.com</EMailAddress>
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: << AUTODISC     <AcceptableResponseSchema>http://schemas.microsoft.com/exchange/autodiscover/outlook/responseschema/2006a</AcceptableResponseSchema>
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: << AUTODISC   </Request>
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: << AUTODISC 
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: << AUTODISC </Autodiscover>
2016-11-23 07:35:02 -0500 08 axigen WEBMAIL:0000140B: AUTODISC Start reading Autodiscover requests for 1 email addresses
2016-11-23 07:35:02 -0500 08 axigen WEBMAIL:0000140B: AUTODISC Build response for Autodiscover OUTLOOK Schema
2016-11-23 07:35:02 -0500 08 axigen WEBMAIL:0000140B: AUTODISC Using IMAP AUTODISCOVER URL from server configuration: imaps://example.com:993
2016-11-23 07:35:02 -0500 08 axigen WEBMAIL:0000140B: AUTODISC POP3 Autodiscovery is disabled
2016-11-23 07:35:02 -0500 08 axigen WEBMAIL:0000140B: AUTODISC Using SMTP AUTODISCOVER URL from server configuration: smtps://example.com:465
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: >> 200 OK
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: >> AUTODISCOVER RESPONSE
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: >> AUTODISC <?xml version="1.0" encoding="utf-8" standalone="no" ?>
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: >> AUTODISC <Autodiscover xmlns="http://schemas.microsoft.com/exchange/autodiscover/responseschema/2006">
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: >> AUTODISC 
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: >> AUTODISC   <Response xmlns="http://schemas.microsoft.com/exchange/autodiscover/outlook/responseschema/2006a">
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: >> AUTODISC     <Culture>en:us</Culture>
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: >> AUTODISC     <User>
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: >> AUTODISC       <DisplayName/>
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: >> AUTODISC       <EMailAddress>user@example.com</EMailAddress>
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: >> AUTODISC     </User>
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: >> AUTODISC     <Account>
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: >> AUTODISC       <AccountType>email</AccountType>
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: >> AUTODISC       <Action>settings</Action>
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: >> AUTODISC       <Protocol>
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: >> AUTODISC         <Type>IMAP</Type>
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: >> AUTODISC         <Server>example.com</Server>
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: >> AUTODISC         <Port>993</Port>
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: >> AUTODISC         <SSL>on</SSL>
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: >> AUTODISC         <LoginName>user@example.com</LoginName>
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: >> AUTODISC       </Protocol>
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: >> AUTODISC       <Protocol>
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: >> AUTODISC         <Type>SMTP</Type>
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: >> AUTODISC         <Server>example.com</Server>
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: >> AUTODISC         <Port>465</Port>
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: >> AUTODISC         <SSL>on</SSL>
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: >> AUTODISC         <LoginName>user@example.com</LoginName>
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: >> AUTODISC       </Protocol>
2016-11-23 07:35:02 -0500 16 axigen WEBMAIL:0000140B: >> AUTODISC     </Account>