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

概要

Microsoft は Exchange Web サービス (EWS) API を非推奨としており、2026 年 10 月に完全に無効化される予定です。

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

前提条件

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

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

移行プロセス

手順 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] を選択します。

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

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

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

    

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

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

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

セキュリティを強化するには、アプリケーションが必要なメールボックスにのみアクセスするように制限します。Microsoft のガイド「 Limiting application permissions to specific Exchange Online mailboxes」に従っていることを確認してください。

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

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

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

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

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

運用環境のインテグレーションを変更する前に、現在の EWS 資格情報と接続の詳細を記録します。プラットフォーム内で資格情報の変更を元に戻すことはできないため、必要に応じて元に戻せます。

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

情報:

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

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

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

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

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

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

   • OAuth 認証機関: [OAuth Authority]: https://login.microsoftonline.com/{tenant_id} — {tenant_id} を Azure ディレクトリ (テナント) ID に置き換えます。
   • OAuth クライアント ID: アプリケーション (クライアント) ID。
   • クライアント シークレット: クライアント シークレットの値。
   • 認証方法: [ アプリケーションによるアクセス権あり] を選択します。
   • API バージョン: [Microsoft Graph] を選択します。

6. [ 資格情報を検証して保存] を選択して、設定を確認します。

   注:

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

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

8. 連携を少なくとも 1 時間監視して、動作が安定していることと、メールが同期が成功したことを確認します。

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

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