移行ガイド: Exchange Web サービス (EWS) から Microsoft Graph API へ

2026 年 10 月の非推奨化の期限までに、Exchange との連携を Exchange Web サービス (EWS) から Microsoft Graph API に移行してください。

概要

Microsoft は、Exchange Online の Exchange Web サービス (EWS) API を廃止し、2026 年 10 月 1 日に完全に無効化します。この廃止は Exchange Online にのみ適用され、オンプレミスの Exchange Server は影響を受けません。

現在 EWS を使用しているすべての Exchange Online 連携を Microsoft Graph API に移行して、引き続き機能するようにする必要があります。

ベスト プラクティス

• 運用環境の統合は慎重に扱ってください。資格情報の切り替えはライブ連携に直接影響します。また、プラットフォーム内で資格情報の変更を元に戻すことはできません。すべてを一度に移行するのではなく、各運用環境の切り替えを慎重に計画します。
• 最初に別の連携でテストします。運用環境の連携に触れる前に、新しい Graph API 資格情報を使用して専用のテスト インテグレーションを作成します ( 「手順 3: Graph API の資格情報をテストする」を参照)。これにより、運用環境のメールボックスを危険にさらすことなく、アプリケーションの登録、アクセス許可、および管理者の同意が正しいことを確認できます。
• ピーク時間外の切り替えをスケジュールします。各運用環境の切り替えは、資格情報の切り替え後に発生する一時的な取り込みギャップの影響を制限するために、ギャップが許容できる時間帯に計画します。

前提条件

移行を開始する前に、次の要件を満たしていることを確認してください。

• Azure Portal へのアクセス: 組織の Azure Portal への管理アクセスです。
• 権限: Azure AD でアプリケーションを登録し、管理者の同意を与える機能。
• 連携へのアクセス: Communications Mining との連携への管理アクセスです。
• メールボックス情報: EWS との連携を介して現在接続されているすべてのメールボックスのリストです。

移行プロセス

連携の資格情報を切り替えると、Graph との連携は、メールボックス内のいずれかのフォルダーが EWS 経由で到達した最も早い時点から再開し、そこからメールを再確認します。既に同期されているメールはすべてスキップされます。その結果、何も 2 回インポートされません。

警告:

本番インテグレーションの認証情報をGraphに切り替えると、新しいインテグレーションが追いつく前に、メールの取り込みに一時的なギャップが生じることが予想されます。これは、エラーではなく、EWS との連携と Graph との連携の違いによって予想される副作用です。切り替えは、取り込みのギャップが許容されるピーク時間外にスケジュールします。

手順 1: 現在の EWS 連携を特定する

1. Automation Cloud で IXP 経由で Communications Mining にログインします。
2. [設定] > [連携] タブに移動します。
3. 以下を含む、既存のすべての Exchange 統合を文書化します。
   • 連携の名前
   • 接続されたメールボックス
   • 関連プロジェクト

手順 2: Azure アプリケーションを登録する

Graph API アクセス用の Azure アプリケーションをまだ作成していない場合は、以下の手順を適用します。

2.1 アプリケーション登録の作成

1. Azure Portal にサインインします。

2. [アプリの登録] に移動し、[新規登録] を選択します。

   

3. アプリケーションを次のように設定します。

   • 名前: わかりやすい名前 (例: uipath-exchange-graph-integrationなど) を使用します。
   • サポートされているアカウントの種類: [ この組織ディレクトリのみに含まれるアカウント (シングル テナント)] を選択します。

4. [登録] を選択します。

5. アプリケーションの概要ページで次の値をメモします。

   • アプリケーション (クライアント) ID
   • ディレクトリ (テナント) ID

2.2 クライアント シークレットを作成する

1. アプリケーションで、左側のメニューから [ 証明書とシークレット ] を選択します。

2. [ クライアント シークレット] で [ 新しいクライアント シークレット] を選択します。

   

3. [ クライアント シークレットを追加 ] サイドパネルが開きます。シークレットを設定します。

   • 説明: わかりやすい説明を入力します。たとえば、「 Exchange Graph Integration Secret」と入力します。
   • 有効期限: 有効期限を選択します。推奨されるオプションは 12 か月または 24 か月です。有効期限は、シークレットの有効期限が切れると、ローテーションするまでメールの取り込みが停止します。

4. [追加] を選択します。

5. ただちにシークレット 値 をコピーし、安全に保管します。

   

注:

Azure がシークレット値を表示するのは 1 回だけです。紛失した場合は、新しいシークレットを作成する必要があります。

2.3 Microsoft Graph の API アクセス許可を設定する

1. 左側のメニューから [ API のアクセス許可 ] を選択します。

2. [ アクセス許可の追加] を選択します。

   

3. [Microsoft API] タブで [Microsoft Graph] を選択します。

   

4. [アプリケーションの許可] を選択します。

   

5. [メール] を展開し、Mail.Read を選択します。

   

6. [ アクセス許可の追加] を選択します。

7. もう一度 [ アクセス許可の追加 ] を選択し、[ Microsoft Graph のアプリケーションの アクセス許可] → を選択します。

8. MailboxFolder.Read.All を検索して選択します。

   

9. [ アクセス許可の追加] を選択します。

10. [ API のアクセス許可 ] メニューに戻り、[[ 組織] に管理者の同意を与えます] を選択します。

11. 確認ダイアログで [ はい ] を選択します。

    

設定した権限には、次のように表示されます。

• Mail.Read (アプリケーション) — [ステータス] の下にある緑色のチェックマーク。
• MailboxFolder.Read.All (アプリケーション) — [ステータス] の下にある緑色のチェックマーク。

2.4 メールボックスへのアクセスを制限する (推奨)

セキュリティを強化するために、Exchange 管理者はアプリケーション アクセス ポリシーを作成することで、アプリケーションが必要なメールボックスにのみアクセスするように制限できます。Microsoft ガイドの「 アプリケーションのアクセス許可を Exchange Online の特定のメールボックスに制限する」に従ってください。

運用環境との連携を移行する前に、同期する予定のすべてのメールボックスがポリシーでカバーされていることを確認します。ポリシーの外部にあるメールボックスは、同期が初めてそのメールボックスの読み取りを試みたときに ErrorAccessDenied エラーが発生して無効化されます。詳しくは、「 Exchange との連携のトラブルシューティング」をご覧ください。

手順 3: Graph API の資格情報をテストする

運用環境の連携を更新する前に、まず別のテスト インテグレーションで新しい Graph API 資格情報をテストしてください。

1. Automation Cloud の IXP の Communications Mining に移動します。
2. [設定] → [連携] タブに移動します。
3. [新しい連携] を選択します。
4. テスト連携を設定します。
   • テスト プロジェクトを選択します。
   • 明確なテスト名 ( Exchange Graph Test や [Production Name] - Testなど) を入力します。
5. [ アプリケーションに接続する] で [ Graph API] を選択します。
6. [ アプリケーション アクセス] を選択します。
7. 手順 2 の資格情報を入力します。
   • OAuth 認証局: https://login.microsoftonline.com/{tenant_id}
   • OAuth クライアント ID: アプリケーション (クライアント) ID。
   • クライアント シークレット: クライアント シークレットの値。
8. [資格情報の検証と保存] を選択します。
9. 運用インテグレーションで使用するメールボックスを追加します。最新の開始タイムスタンプを使用して、最初に同期されるデータの量を制限します。
10. [ 連携を作成] を選択します。
11. 最初の同期が完了するまで待ちます。

メールが正常に同期されていること、および連携のステータス ページにエラー メッセージが表示されないことを確認します。メールボックスは数分以内に同期を開始します。選択した開始タイムスタンプより大量のメールが落ちた場合、追いつくのに時間がかかる。1 時間経ってもメールが届かない場合は、「 Exchange との連携のトラブルシューティング」をご覧ください。

確認が完了したら、運用連携の更新に進みます。

手順 4: 現在の EWS 構成をバックアップする

運用環境の連携を変更する前に、現在の EWS 接続の詳細を記録し、EWS クライアント シークレットのコピーがまだ保持されていることを確認します (組織のシークレット ストアなどに保管されていることを確認します)。保存した資格情報は表示されないため、シークレットを他の場所に保持していた場合にのみ EWS に戻すことができます。

手順 5: 運用インテグレーションを更新する

注:

元に戻す必要がある場合は、連携を編集し、資格情報を EWS の詳細に戻します。

1. Automation Cloud の IXP の Communications Mining に移動します。

2. [設定] > [連携] タブに移動します。

3. 移行する運用環境の連携を見つけて、その設定を開きます。

4. [ 資格情報 ] タブを選択し、[ 資格情報を変更] を選択します。

5. [ アプリケーションに接続する] で [ Graph API] を選択します。

6. [ アプリケーション アクセス] を選択します。

7. 次のフィールドを更新します。

   • OAuth 認証機関: [OAuth Authority]: https://login.microsoftonline.com/{tenant_id} — {tenant_id} を Azure ディレクトリ (テナント) ID に置き換えます。
   • OAuth クライアント ID: アプリケーション (クライアント) ID。
   • クライアント シークレット: クライアント シークレットの値。

8. [ 検証して資格情報を保存 ] を選択して、構成を確認します。

   注:

   検証に失敗した場合は、テナント ID、クライアント ID、クライアント シークレットを再確認してください。API のアクセス許可に対して管理者の同意が付与されていることを確認します。検証に成功すると認証のみが確認されます。メールボックスへのアクセスは確認されません。

9. [ 保存 ] または [ 続行 ] を選択して、更新した設定を適用します。

10. 連携を少なくとも 1 時間監視して、安定した動作とメールの同期が成功することを確認します。連携またはメールボックスにエラーが表示されている場合は、「 Exchange との連携のトラブルシューティング」をご覧ください。

手順 6: 残りの連携を更新する

組織内の残りの EWS 統合ごとに、手順 3 から 5 を繰り返します。