自動検出を使用して接続ポイントを検索する

[アーティクル]
06/01/2021

自動検出サービスを使用して、適切な Exchange サーバーにクライアントアプリケーションを誘導する方法について説明します。

Exchange 自動検出サービスは、Exchange Online、Office 365 の一部としての Exchange Online、または Exchange 2013 以降のバージョンの Exchange を実行する Exchange サーバー上でホストされているメールアカウントの構成設定をクライアントアプリケーションに提供します。自動検出サービスは、構成設定を提供する Web サービスです。自動検出サービスは、クライアントアプリケーションに Exchange サーバーの構成情報を提供する Web サービスです。クライアントアプリケーションは、自動検出を使用して、特定のメールボックスの自動検出サービスのエンドポイントを決定します。この記事では、Exchange サーバーからの応答に従って適切なエンドポイントを検索する方法について説明します。

メールアドレスの構成設定を取得する方法の詳細については、「自動検出を使用して Exchange からユーザー設定を取得する」および「Exchange サーバーからドメイン設定を取得する」をご覧ください。

注意

適切なエンドポイントを検索するプロセスは、ユーザーまたはドメイン設定の要求の一部です。自動検出サービスは、一連のリダイレクト応答を使用して、クライアントアプリケーションにメールアドレスの適切なエンドポイントを指示します。

自動検出サービスにアクセスするには、次の Exchange 開発テクノロジのうちの 1 つを使用できます。

Exchange Web サービス (EWS) マネージ API
EWS

EWS を使用する場合は、次の方法を使用してユーザー設定を取得できます。

SOAP ベースの自動検出サービス
XML (POX) 自動検出サービス
SOAP または XML の自動検出サービスから生成される、自動生成されたプロキシ

これらの方法の詳細については、「Exchange の自動検出」をご覧ください。

これらの Exchange 開発テクノロジの詳細については、「Exchange の EWS マネージ API、EWS、および Web サービスについて学ぶ」を参照してください。

EWS マネージ API は、ユーザー設定を取得するためのオブジェクトベースのインターフェイスを提供します。クライアントアプリケーションがマネージコードを使用する場合は、EWS マネージ API を使用することをお勧めします。EWS マネージ API インターフェイスは、標準的な自動生成された Web サービスプロキシよりも、単純なオブジェクトモデルに対してより最適化されています。

EWS を使用している場合は、POX の自動検出サービスよりも豊富な機能をサポートしている SOAP の自動検出サービスの使用をお勧めします。

エンドポイントを検索するための前提条件

自動検出サービスを使用するクライアントアプリケーションを作成するには、次のものにアクセスできる必要があります。

Exchange Online または Exchange 2007 SP1 以降のバージョンの Exchange を実行しているサーバー。SOAP ベースの自動検出サービスを使用している場合は、Exchange Online または Exchange 2010 以降のバージョンの Exchange。
クライアントアプリケーションからの接続を受け入れるように構成されている Exchange サーバー。 Exchange サーバーを構成する方法の詳細については、「Exchange において、EWS へのクライアントアプリケーションのアクセスを制御する」をご覧ください。
EWS を使用する権限を持つアカウント。アカウントを構成する方法の詳細については、「Exchange において、EWS へのクライアントアプリケーションのアクセスを制御する」をご覧ください。

注意

EWS マネージ API を使用する場合、状況によっては証明書の検証コールバックを提供する必要があります。 Visual Studio で作成されたものなど、いくつかの生成されたプロキシライブラリによる証明書の検証コールバックが必要になる場合もあります。詳細については、「EWS マネージ API のサーバー証明書を検証する」をご覧ください。

エンドポイントを検索するための中核となる概念

自動検出を使用してエンドポイントを検索する前に、次の表に一覧表示されている概念について理解してください。

概念	説明
Exchange の自動検出	自動検出サービスの動作方法の概要を示します。

EWS マネージ API を使用する場合は、Microsoft.Exchange.WebServices.Data 名前空間の Microsoft.Exchange.WebServices.Data.ExchangeService クラスを使用して、EWS への接続を管理します。この記事の EWS マネージ API のコードサンプルを使用するには、コード内で次の名前空間を参照する必要があります。

System.Net
Microsoft.Exchange.WebServices.Data.ExchangeService

EWS マネージ API を使用して、適切なエンドポイントを検索する

EWS マネージ API を使用する場合、自動検出サービスの呼び出しは ExchangeService クラスによって処理されます。メールアカウントの適切なエンドポイントを決定するには、[ExchangeService] オブジェクトに AutodiscoverUrl メソッドを呼び出します。次のコード例では、EWS マネージ API を使用して、メールアドレスの EWS の Web サービスエンドポイントを適切なクライアントアクセスサーバー上の Exchange.asmx ファイルに設定する方法を示します。

NetworkCredential credentials = new NetworkCredential(securelyStoredEmail, securelyStoredPassword);
ExchangeService service = new ExchangeService(ExchangeVersion.Exchange2013);
service.Credentials = credentials;
service.AutodiscoverUrl("User1@contoso.com");

EWS を使用して、適切なエンドポイントを検索する

SOAP の自動検出サービスは、EWS の適切なエンドポイントにアプリケーションを誘導するために、一連の要求と応答を使用する場合があります。メールアカウントの適切なエンドポイントを決定するプロセスについては、「Exchange の自動検出」をご覧ください。次の XML の例では、適切なエンドポイントを検索するために SOAP の自動検出の要求を行う場合に予想される一連の要求と応答を示します。

SOAP の自動検出エンドポイントの要求

次の例では、適切なエンドポイントを検索するために自動検出サービスに送信される XML 要求を示します。

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:a="https://schemas.microsoft.com/exchange/2010/Autodiscover" 
        xmlns:wsa="http://www.w3.org/2005/08/addressing" 
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
        xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <a:RequestedServerVersion>Exchange2013</a:RequestedServerVersion>
    <wsa:Action>https://schemas.microsoft.com/exchange/2010/Autodiscover/Autodiscover/GetUserSettings</wsa:Action>
    <wsa:To>https://mail.microsoft.com/autodiscover/autodiscover.svc</wsa:To>
  </soap:Header>
  <soap:Body>
    <a:GetUserSettingsRequestMessage xmlns:a="https://schemas.microsoft.com/exchange/2010/Autodiscover">
      <a:Request>
        <a:Users>
          <a:User>
            <a:Mailbox>User1@Contoso.com</a:Mailbox>
          </a:User>
        </a:Users>
        <a:RequestedSettings>
          <a:Setting>InternalEwsUrl</a:Setting>
          <a:Setting>ExternalEwsUrl</a:Setting>
        </a:RequestedSettings>
      </a:Request>
    </a:GetUserSettingsRequestMessage>
  </soap:Body>
</soap:Envelope>

SOAP 自動検出リダイレクト応答

自動検出サービスは、HTTP 302 リダイレクト応答と SOAP リダイレクト応答の 2 つのうち、いずれかのリダイレクト応答で応答する場合があります。Exchange サーバーからの応答が HTTP 302 リダイレクトである場合、クライアントアプリケーションはリダイレクトのアドレスが受入可能であることを検証してから、リダイレクト応答に従う必要があります。

重要

リダイレクト応答を検証するための条件については、「Exchange の自動検出」をご覧ください。

自動検出サービスが、UserResponse 要素のエラーコード要素で示されるリダイレクト応答を返す場合は、クライアントアプリケーションは RedirectTarget 要素を使用して、リダイレクト応答で指定されたサーバーに送信される新しい設定要求を作成する必要があります。次の例では、サーバーからのリダイレクト応答を示します。

<s:Envelope xmlns:s="https://schemas.xmlsoap.org/soap/envelope/" xmlns:a="http://www.w3.org/2005/08/addressing">
  <s:Header>
    <a:Action s:mustUnderstand="1">https://schemas.microsoft.com/exchange/2010/
        Autodiscover/Autodiscover/GetUserSettingsResponse</a:Action>
    <h:ServerVersionInfo xmlns:h="https://schemas.microsoft.com/exchange/2010/Autodiscover" 
        xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
      <h:MajorVersion>15</h:MajorVersion>
      <h:MinorVersion>0</h:MinorVersion>
      <h:MajorBuildNumber>682</h:MajorBuildNumber>
      <h:MinorBuildNumber>1</h:MinorBuildNumber>
      <h:Version>Exchange2013</h:Version>
    </h:ServerVersionInfo>
  </s:Header>
  <s:Body>
    <GetUserSettingsResponseMessage xmlns="https://schemas.microsoft.com/exchange/2010/Autodiscover">
      <Response xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <ErrorCode>NoError</ErrorCode>
        <ErrorMessage />
        <UserResponses>
          <UserResponse>
            <ErrorCode>RedirectAddress</ErrorCode>
            <ErrorMessage>Redirection address.</ErrorMessage>
            <RedirectTarget>User1@mail.Contoso.com</RedirectTarget>
            <UserSettingErrors />
            <UserSettings />
          </UserResponse>
        </UserResponses>
      </Response>
    </GetUserSettingsResponseMessage>
  </s:Body>
</s:Envelope>

リダイレクトを行った後は、クライアントはリダイレクト URL を使用して別の要求を準備します。次のコードは、リダイレクト応答から作成される要求の例を示します。

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:a="https://schemas.microsoft.com/exchange/2010/Autodiscover" 
        xmlns:wsa="http://www.w3.org/2005/08/addressing" 
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
        xmlns:soap="https://schemas.xmlsoap.org/soap/envelope/">
  <soap:Header>
    <a:RequestedServerVersion>Exchange2013</a:RequestedServerVersion>
    <wsa:Action>https://schemas.microsoft.com/exchange/2010/
        Autodiscover/Autodiscover/GetUserSettings</wsa:Action>
    <wsa:To>https://autodiscover.exchange.microsoft.com/autodiscover/autodiscover.svc</wsa:To>
  </soap:Header>
  <soap:Body>
    <a:GetUserSettingsRequestMessage xmlns:a="https://schemas.microsoft.com/exchange/2010/Autodiscover">
      <a:Request>
        <a:Users>
          <a:User>
            <a:Mailbox>User1@mail.Contoso.com</a:Mailbox>
          </a:User>
        </a:Users>
        <a:RequestedSettings>
          <a:Setting>InternalEwsUrl</a:Setting>
          <a:Setting>ExternalEwsUrl</a:Setting>
        </a:RequestedSettings>
      </a:Request>
    </a:GetUserSettingsRequestMessage>
  </soap:Body>
</soap:Envelope>

クライアントアプリケーションが自動検出サービスの適切なエンドポイントを指示されると、サーバーは、UserResponse 要素の ErrorCode 要素が NoError に設定されていて、要求されたユーザー設定を含んだ応答を送信します。要求されたユーザー設定である、InternalEwsUrl と ExternalEwsUrl のみが返されます。次の例は、サーバーからの応答を示しています。

<s:Envelope xmlns:s="https://schemas.xmlsoap.org/soap/envelope/" 
        xmlns:a="http://www.w3.org/2005/08/addressing">
  <s:Header>
    <a:Action s:mustUnderstand="1">https://schemas.microsoft.com/exchange/2010/
        Autodiscover/Autodiscover/GetUserSettingsResponse</a:Action>
    <h:ServerVersionInfo xmlns:h="https://schemas.microsoft.com/exchange/2010/Autodiscover" 
        xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
      <h:MajorVersion>15</h:MajorVersion>
      <h:MinorVersion>0</h:MinorVersion>
      <h:MajorBuildNumber>160</h:MajorBuildNumber>
      <h:MinorBuildNumber>4</h:MinorBuildNumber>
      <h:Version>Exchange2013</h:Version>
    </h:ServerVersionInfo>
  </s:Header>
  <s:Body>
    <GetUserSettingsResponseMessage xmlns="https://schemas.microsoft.com/exchange/2010/Autodiscover">
      <Response xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
        <ErrorCode>NoError</ErrorCode>
        <ErrorMessage />
        <UserResponses>
          <UserResponse>
            <ErrorCode>NoError</ErrorCode>
            <ErrorMessage>No error.</ErrorMessage>
            <RedirectTarget i:nil="true" />
            <UserSettingErrors />
            <UserSettings>
              <UserSetting i:type="StringSetting">
                <Name>InternalEwsUrl</Name>
                <Value>https://server.Contoso.com/ews/exchange.asmx</Value>
              </UserSetting>
              <UserSetting i:type="StringSetting">
                <Name>ExternalEwsUrl</Name>
                <Value>https://server.Contoso.com/ews/exchange.asmx</Value>
              </UserSetting>
            </UserSettings>
          </UserResponse>
        </UserResponses>
      </Response>
    </GetUserSettingsResponseMessage>
  </s:Body>
</s:Envelope>

次の手順

自動検出プロセスに従ってエンドポイントを検索すると、要求されたドメインまたはユーザー設定が返されます。特定の設定を要求することについては、次の記事をご覧ください。

次の方法で共有