Auto-discovery for Outlook (via Axigen Outlook Connector)

Axigen Auto-discovery

An administrator can define a connector-specific profile using an Auto-discovery mechanism, similar to the one used for the ActiveSync service; this mechanism allows the user to specify only the email address and the password for accessing her or his Axigen account from Outlook, without having to specify additional service-related information (such as hostname or IP address, service port, running mode, etc.); the Auto-discovery can be used both immediately after the installation of the Outlook connector or at a later time.

The Axigen Outlook Connector uses only the IMAP (or IMAPS) when sending or receiving emails. Therefore, for the Auto-discovery via Axigen Outlook Connector to work, only the IMAP Auto-discovery parameters need to be enabled / configured:

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

 

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

autodiscover          IN      A       193.230.245.23

Axigen Outlook Connector initiates only HTTPS requests for Auto-discovery.

Screenshot Instructions

  1. Open Microsoft Outlook and go to Add Account >> Manual Setup or Additional Server Types then click "Next"
  2. Choose "Other" with default "Axigen Messaging" and click "Next"
  3. In the displayed popup, provide the email address and password and click "Check Now"
  4. In the background, a HTTPS POST request is initiated by the Axigen Outlook Connector:
POST /AutoDiscover/AutoDiscover.xml HTTP/1.0

Using the newly created account in Microsoft Outlook, 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 09:06:46 -0500 08 axigen WEBMAIL:000000E2: [x.x.x.x:443] connection accepted from [x.x.x.x:49767]
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: << POST /AutoDiscover/AutoDiscover.xml HTTP/1.0
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: << Authorization: ***
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: << Content-Type: text/xml
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: << Content-length: 338
2016-11-14 09:06:47 -0500 08 axigen WEBMAIL:000000E2: ASYNC account 'user@example.com' has logged in
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: << AUTODISCOVER REQUEST
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: << AUTODISC <?xml version="1.0" encoding="utf-8" standalone="no" ?>
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: << AUTODISC <Autodiscover xmlns="http://schemas.axigen.com/axigen/autodiscover/axiimap/requestschema/2010" xmlns="http://schemas.axigen.com/axigen/autodiscover/axiimap/requestschema/2010">
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: << AUTODISC      <Request>
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: << AUTODISC          <EMailAddress>user@example.com</EMailAddress>
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: << AUTODISC     <AcceptableResponseSchema>http://schemas.axigen.com/axigen/autodiscover/axiimap/responseschema/2010</AcceptableResponseSchema>
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: << AUTODISC   </Request>
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: << AUTODISC 
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: << AUTODISC </Autodiscover>
2016-11-14 09:06:47 -0500 08 axigen WEBMAIL:000000E2: AUTODISC Start reading Autodiscover requests for 1 email addresses
2016-11-14 09:06:47 -0500 08 axigen WEBMAIL:000000E2: AUTODISC Build response for Autodiscover AXIIMAP Schema
2016-11-14 09:06:47 -0500 08 axigen WEBMAIL:000000E2: AUTODISC Using IMAP AUTODISCOVER URL from server configuration: imaps://example.com:993
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: >> 200 OK
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: >> AUTODISCOVER RESPONSE
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: >> AUTODISC <?xml version="1.0" encoding="utf-8" standalone="no" ?>
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: >> AUTODISC <Autodiscover xmlns="http://schemas.axigen.com/axigen/autodiscover/axiimap/responseschema/2010">
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: >> AUTODISC 
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: >> AUTODISC   <Response>
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: >> AUTODISC     <Culture>en:us</Culture>
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: >> AUTODISC     <User>
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: >> AUTODISC       <DisplayName/>
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: >> AUTODISC       <EMailAddress>user@example.com</EMailAddress>
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: >> AUTODISC     </User>
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: >> AUTODISC     <Action>
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: >> AUTODISC       <Settings>
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: >> AUTODISC         <Server>
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: >> AUTODISC           <Type>MobileSync</Type>
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: >> AUTODISC           <Url>imaps://example.com:993</Url>
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: >> AUTODISC           <Name>imaps://example.com:993</Name>
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: >> AUTODISC         </Server>
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: >> AUTODISC       </Settings>
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: >> AUTODISC     </Action>
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: >> AUTODISC   </Response>
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: >> AUTODISC 
2016-11-14 09:06:47 -0500 16 axigen WEBMAIL:000000E2: >> AUTODISC </Autodiscover>
2016-11-14 09:06:47 -0500 08 axigen WEBMAIL:000000E2: connection closed with [x.x.x.x:49767]