autodiscover - AutoDiscover HTTP Service Protocol handler (responder)
Name Description Configuration directives (gromox.cfg) Configuration directives (autodiscover.cfg) Configuration directives (autodiscover.ini) Outlook notes Exchange notes Normative references See alsoName
autodiscover — AutoDiscover HTTP Service Protocol handler (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.
Exchange notes
In EXC, MH can be toggled on/off via an EAC Shell command: ‘Set-OrganizationConfig -MapiHttpEnable $false‘ (or $true).
Normative references
|
• |
MS-OXDISCO: Autodiscover HTTP Service Protocol |
|||
|
• |
MS-OXDSCLI: Autodiscover Publishing and Lookup Protocol |
See also
gromox(7), autodiscover(7)