autodiscover¶

Name¶

Autodiscover HTTP Service Protocol handler (AutoDiscover responder)

Description¶

Autodiscover clients can locate the Autodiscover server for a given domain example.com by attempting to resolve the _autodiscover._tcp.example.com IN SRV record from DNS, and otherwise fall back to autodiscover.example.com.

To force using a particular Autodiscover server, such as when Gromox is run in a development environment with a fake domain, c:windowssystem32driversetchosts can be populated with a static entry for autodiscover.example.com to get that particular scenario working.

An Autodiscover client would make a "POST /Autodiscover/Autodiscover.xml" request to the autodiscover server that was determined moments ago. The mailbox credentials are presented using HTTP authentication.

The Autodiscover response contains a HTTP server (generally the HTTP home server) and the designated choice for protocol framing. A client uses this to set up the EMSMDB MAPI service within a MAPI profile. Because the HTTP home server is then known, Autodiscover is not used again when making a connection to the message store service. However, the Address Book always issues Autodiscover requests. (In other words, removing the DNS entry for the Autodiscover server after a profile is set up would break the address book, but not the message store.)

Configuration directives¶

The normal config file location is /etc/gromox/autodiscover.cfg. (For backwards compatibility, if autodiscover.cfg is not present, the module will read part of autodiscover.ini.)

oxdisco_advertise_mh: This setting controls whether the AutoDiscover response should include a EXHTTP Protocol section. Possible values: yes, no, not_old_mso, only_new_mso. The latter two values can be used to finely control emission in case of clients other than Outlook.

Default: yes
oxdisco_advertise_rpch: This setting controls whether the AutoDiscover response should include EXCH/EXPR Protocol sections. Possible values: yes, no, only_old_mso, not_new_mso. The latter two values can be used to finely control emission in case of clients other than Outlook.

Default: yes
oxdisco_pretty_response: A debugging knob to make the module emit indented XML responses.

Default: no
oxdisco_request_logging: Log AutoDiscover requests. This is independent of http.cfg:http_debug, and setting both would log requests twice.

Default: no
oxdisco_response_logging: Log AutoDiscover responses. This is independent of http.cfg:http_debug, and setting both would log responses twice.

Default: no
oxdisco_validate_scndrequest: When OL opens a non-default store (store of another user) or a public store, it may also make an AutoDiscover inquiry for the extra store. This setting controls whether the server-side AutoDiscover module should perform a permission check on non-default stores and possibly reject returning connection details. (Inquiry Public stores are always permitted.)

Default: yes
x500_org_name: Default: (unspecified)

Outlook notes¶

When Outlook is active, it is possible to Ctrl-MouseBtn3 (right click) on the status tray icon to call up a context menu, from which "Test Email Autoconfiguration..." can be selected to debug AutoDiscover requests and responses from the Windows side.

Normative references¶

MS-OXDISCO: Autodiscover HTTP Service Protocol
MS-OXDSCLI: Autodiscover Publishing and Lookup Protocol