Export (0) Print
Expand All

2.2.2.1 Autodiscover

The Autodiscover command facilitates the discovery of core account configuration information by using the user's Simple Mail Transfer Protocol (SMTP) address as the primary input. For information about the Autodiscover service, see [MSFT-AUTODISCOVER]. For more details about the Autodiscover HTTP Service, see [MS-OXDISCO].

The Autodiscover command request and response messages are sent in XML format, not WBXML format.

When sending an Autodiscover command request, the Content-Type header value MUST be set to text/xml.<2> For more details about the Content-Type header, see [MS-ASHTTP] section 2.2.1.1.2.2.

The client SHOULD use the Autodiscover command as an initial response to common HTTP errors. Common HTTP errors are specified in [MS-ASHTTP] section 2.2.2.1.1. Autodiscover has the ability to retrieve an updated URL when a mailbox has been moved, a user is trying to connect to a server that cannot access the user's mailbox, or when there is a more efficient server to use to reach the user's mailbox.

After a successful Autodiscover command response, the client sends an HTTP Options command to the server identified in the Autodiscover command response. The HTTP Options command returns the newly supported protocol versions and commands if they changed due to the Autodiscover command.

The http://schemas.microsoft.com/exchange/autodiscover/mobilesync/requestschema/2006 namespace is the primary namespace for the Autodiscover command and this section of the specification. Elements referenced in this section that are not defined in the http://schemas.microsoft.com/exchange/autodiscover/mobilesync/requestschema/2006 namespace use the namespace prefixes defined in section 2.2.1.

The following table lists the elements that are used in Autodiscover command requests and responses.

Element name

Scope

Reference

Autodiscover

Request and Response

section 2.2.3.15

Request

Request

section 2.2.3.137.1

EMailAddress

Request and Response

section 2.2.3.52

AcceptableResponseSchema

Request

section 2.2.3.1

Response

Response

section 2.2.3.140.1

Culture

Response

section 2.2.3.38

User

Response

section 2.2.3.174

DisplayName

Response

section 2.2.3.47.1

Action

Response

section 2.2.3.6

Redirect

Response

section 2.2.3.134

Settings

Response

section 2.2.3.153.1

Server

Response

section 2.2.3.149

Type

Response

section 2.2.3.171.1

Url

Response

section 2.2.3.173

Name

Response

section 2.2.3.110.1

ServerData

Response

section 2.2.3.150

Error

Response

section 2.2.3.60

Status

Response

section 2.2.3.162.1

Message

Response

section 2.2.3.98

DebugData

Response

section 2.2.3.40

ErrorCode

Response

section 2.2.3.61

The XML schema for the Autodiscover command request is described in section 6.3. The XML schema for the Autodiscover command response is described in section 6.4.

Protocol Versions

The following table specifies the protocol versions that support this command. The client indicates the protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-ASHTTP] section 2.2.1.1.2.4, or the Protocol version field, as specified in [MS-ASHTTP] section 2.2.1.1.1.1, in the request.

Protocol version

Command support

2.5

12.0

X

12.1

X

14.0

X

14.1

X

Show:
© 2015 Microsoft