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