autodiscover

Name

autodiscover — Autodiscover HTTP Service Protocol handler (AutoDiscover responder)

Description

A client would make a HTTP request to the /Autodiscover/Autodiscover.xml endpoint, which is handled by the Gromox oxdisco plugin.

The Autodiscover response contains the home server name and protocol options (MAPI-RPC-HTTP, MAPIHTTP, IMAP, etc.). A client uses this to set up the mailbox with MAPI services (like ``MSEMS`` or ``INTERSTOR``) within a MAPI profile.

Configuration directives (gromox.cfg)

The following directives are recognized when they appear in /etc/gromox/gromox.cfg.

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_exonym: Globally valid name pointing to a default mailbox server in the Gromox server forest. (Since AutoDiscover nodes are also mailbox nodes, the exonym should simply be: this server's hostname).

Default: (inherited from http.cfg:host_id, which defaults to the system FQDN)
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 of public stores are always permitted.)

Default: yes
x500_org_name: Default: (unspecified)

Configuration directives (autodiscover.cfg)

The following directives are recognized when they appear in /etc/gromox/autodiscover.cfg. autodiscover.cfg is obsolete in favor of gromox.cfg.

x500_org_name: Same as gromox.cfg:x500_org_name.

Default: (unspecified)

Configuration directives (autodiscover.ini)

The following directives are recognized when they appear in /etc/gromox/autodiscover.ini. autodiscover.ini is obsolete in favor of gromox.cfg.

organization: Same as gromox.cfg:x500_org_name.

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