| autodiscover(4gx) | Gromox admin reference | autodiscover(4gx) |
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
See also¶
| Gromox |