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

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

概要

Microsoft is retiring the Exchange Web Services (EWS) API for Exchange Online, with full disablement on October 1, 2026. The retirement applies to Exchange Online only: on-premises Exchange Server is not affected.

You must migrate all Exchange Online integrations that currently use EWS to the Microsoft Graph API to make sure that these continue to function.

ベスト プラクティス

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

前提条件

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

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

移行プロセス

After you switch an integration's credentials, the Graph integration resumes from the earliest point that any folder in the mailbox had reached over EWS, and re-checks emails from there onward, skipping anything already synced. Nothing is imported twice as a result.

警告:

本番インテグレーションの認証情報を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」と入力します。
   • Expires: Select an expiration period. The recommended option is 12 or 24 months. Note the expiry date somewhere you will see it: when the secret expires, email ingestion stops until you rotate it.

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. Search for and select MailboxFolder.Read.All.

   

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

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

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

    

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

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

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

For enhanced security, your Exchange administrator can limit the application to access only the required mailboxes by creating an application access policy. Make sure you follow the Microsoft guide: Limiting application permissions to specific Exchange Online mailboxes.

Before you migrate a production integration, verify that the policy covers every mailbox you plan to sync. A mailbox outside the policy is disabled with an ErrorAccessDenied error the first time the sync attempts to read it. For details, check Troubleshooting Exchange integrations.

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

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

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

Verify that emails are syncing successfully and that no error messages appear on the integration status page. The mailbox starts syncing within minutes; catching up takes longer when a large amount of email falls after the chosen start timestamp. If no emails have arrived after an hour, check Troubleshooting Exchange integrations.

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

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

Before modifying your production integration, record your current EWS connection details, and confirm that you still hold a copy of the EWS client secret, for example in your organization's secret store. The platform does not display saved credentials back to you, so you can only revert to EWS if you kept the secret elsewhere.

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

注:

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

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

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

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

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

5. Under Connect with your application, select Graph API.

6. Select With application access.

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

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

8. Select Validate & save credentials to verify your configuration.

   注:

   If validation fails, double-check your tenant ID, client ID, and client secret. Ensure admin consent was granted for the API permissions. Note that successful validation confirms authentication only: it does not check access to any mailbox.

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

10. Monitor the integration for at least one hour to confirm stable operation and successful email sync. If the integration or a mailbox shows an error, check Troubleshooting Exchange integrations.

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

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