Exchange と Azure サービス ユーザーとの連携

はじめに

このステップ バイ ステップのガイドでは、Azure クラウド プラットフォームで Communications Mining™ 用の Microsoft Exchange アプリケーションを作成するための一般的な方法について説明します。ID とクライアント シークレットを使用してアプリケーション (クライアント) を作成し、既存のディレクトリ (テナント) ID を確認する方法を理解できます。これにより、ユーザーは Communications Mining で Exchange とのメールボックス連携にアクセスできるようになります。

注:

Microsoft は、2026 年 10 月 1 日に Exchange Web サービス (EWS) を廃止します。代わりに、「 Exchange と Azure のアプリケーション認証および Graph との連携 」ガイドに従うことをお勧めします。

連携の成功が重要な理由

Azure で Exchange-Communications Mining™ アプリケーションを作成しないと、アクセス許可エラーが発生し、ユーザーがメールボックス統合にアクセスできない可能性があります。Communications Mining のメリットを最大限に活用するには、以下の手順に従ってプロセスを完全に完了してください。

ステップバイステップの統合プロセス

1. Azure にサインインする

Azure Cloud Portal にサインインします。

2. Communications Mining 用の新しいアプリケーションを登録する

1. [アプリの登録] メニューにアクセスし、[新規登録] オプションを選択します。

   

2. 次の手順で、新しいアプリケーションを登録します。

   1. アプリケーションの名前を入力します (例: reinfer-exchange-integration)。
   2. [サポートされているアカウントの種類] で、シングル テナントのオプションを選択します。
   3. [ 登録 ] を選択して登録を完了します。

   

   次の図に示すように、Azure によって アプリケーション (クライアント) ID と ディレクトリ (テナント) ID が提供されます。

   

3. Communications Mining アプリケーションのクライアント シークレットを作成する

アプリケーションを安全に保つために、アプリケーションにログインするためのクライアント シークレットを作成する必要があります。まず、[管理] サイドバーの下にある [証明書とシークレット] を選択してから、次の手順に進みます。

1. [クライアント シークレット] が自動的に選択されない場合は、[クライアント シークレット] を選択します。

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

   

3. サイドバーで、わかりやすい説明を追加し、有効期限を選択します。有効期限を 12 か月に設定することをお勧めします。

4. [ 追加 ] を選択して、Communications Mining™ アプリケーションのシークレット値を作成します。

   

   

   注:

   Azure ではシークレット値が一度しか表示されないため、必ず値をコピーしてください。シークレット値を紛失した場合は、もう一度手順 3 を実行して新しい値を作成してください。

4. API のアクセス許可を設定する

1. [管理] サイドバーの下にある [API のアクセス許可] に移動します。

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

   

3. [ Microsoft API ] を選択し、[ Microsoft Graph] を選択します。

   

4. [ 委任されたアクセス許可] を選択します。

5. [権限の選択] テキスト ボックスに「EWS」と入力します。アクセス。

6. [EWS] 権限を展開し、[EWS] のチェックボックスをオンにします。AccessAsUser.All です。

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

   

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

9. [管理者の同意の確認を与えます] のポップアップで [はい] を選択します

   

5. 共有メールボックスへのアクセス権をサービス ユーザーに付与する

Communications Mining™ に接続するメールボックスへのアクセス権を持つサービス アカウントが必要です。

1. サービス アカウントを作成します。
   • ユーザーを追加します。
   • ユーザーにライセンスを割り当てます。
2. サービス アカウントに共有メールボックスへのアクセス権を付与します。サービス アカウントに読み取り専用アクセス権を付与するだけで十分です。これを行うには、次のいずれかの方法を使用します。
   • 共有メールボックスを作成し 、サービス アカウントを含むユーザーにアクセス権を付与します。
   • サービス アカウントにユーザーのメール アドレスへのアクセス権を付与します。

6. Communications Mining にサインインする

UiPath® Automation Cloud から通常どおりに Communications Mining にサインインします。

7. Communications Mining で新しい連携を作成する

1. Communications Mining から [管理 ] ページに移動します。

2. [新しい連携] を選択します。

   

3. [ 新しい連携を作成 ] ページの [ 基本情報の追加] で、以下のフィールドを設定します。

   • プロジェクト - 既存のプロジェクトを選択します。
   • タイトル - 必要に応じて、タイトルを入力します。
   • API 名 - 連携の名前を入力します。

注:

API 名は、一度設定すると変更できません。

4. [続行] を選択します。

   

5. [ アプリケーションと接続] で、次の項目を設定します。

   • API の種類を [ Graph API ] または [ EWS API] から選択します。

   • 認証方法を [ クライアント シークレットを使用する]、[ 秘密キーと拇印を使用する]、[ NTLM を使用する] から選択します。

     注:

     NTLM では、代理人アクセスのみがサポートされています。詳細については、 Exchange の代理アクセスと EWS に関する Microsoft ドキュメントをご覧ください。

   • OAuth 権限 URL - Communications Mining に新しいアプリケーションを登録するときに使用した手順 2 のテナント ID を使用して、OAuth 権限の URL を https://login.microsoftonline.com/{tenant_id}の形式で入力します。

   • OAuth クライアント ID - 手順 2 の OAuth クライアント ID を入力します。

   • クライアント シークレット - 手順 3 のクライアント シークレットを入力します。

   • 以下のいずれかのオプションを選択します。

     • サービス ユーザーのアクセス権 - サービス アカウントのユーザー名とパスワードを入力します。
     注:

     Graph API では、サービス ユーザーのアクセスはサポートされていません。

     • アプリケーション アクセス

   • [資格情報の検証と保存] を選択します。

6. [続行] を選択します。

   

7. [ 入力データを選択してください] で [ メールボックスを追加 ] を選択し、次のフィールドを設定します。

   メールボックス名

   • メール アドレス - メール アドレスを入力します。

   バケット

   • 新しいバケット - 以下のいずれかを選択します。
     • 新しいバケットを作成 - メールボックスのバケットを自動的に作成します。
     • 新しいバケットをユーザーが定義 - [プロジェクト]、[ 名前]、[ タイトル] を指定してカスタム バケットを定義します。
   • 既存のバケット - 既存の Orchestrator バケットを選択します。

   時刻フィルター

   注:

   同期する日付を選択します。必要に応じて、これを更新して、さらに前の方向に同期することができます。既に同期されているデータは影響を受けません。合計量が不明な場合は、最初に短い期間を同期して量を測定することをお勧めします。AI ユニットはアップロード時に課金されます。

   • タイムスタンプから - 次のフィールドを設定します。
     • 同期元のタイムスタンプ - 同期元の日付を入力します。一般的には、少なくとも 6 か月から 12 か月分のデータを同期することをお勧めします。
   • 全期間 - 利用可能なすべてのデータを同期します。
   重要:

   このオプションでは、予想よりも多くの AI ユニットが消費される場合があります。

   フォルダー フィルター

   注:

   フォルダー フィルターを適用する場合:

   • 入れ子になったフォルダーはスラッシュ /で区切られます。
   • Outlook に表示されるフォルダーには、通常、プレフィックスとして root/Top of Information Store/が付きます。
   • フォルダーを許可すると、明示的に許可されていないフォルダーは拒否されます。
   • 許可されているフォルダー内のフォルダーを拒否できます。
   • 拒否されたフォルダー内のフォルダーを許可することはできません。
   • 許可されたフォルダー - 許可されたフォルダーを入力します。
   • 拒否されたフォルダー - 拒否するフォルダーを入力します。
   注:

   フォルダーの場所は、「 root/Top of Information Store/」の形式で入力してください。

   ヒント:

   フォルダー フィルターの対象範囲を、ユース ケースで必要最小限の範囲に制限します。許可されたフォルダを空のままにしておくと、アーカイブや回復可能なアイテム(消去)を含むメールボックス内のすべてのフォルダから同期が継続的に行われるため、同期が大幅に遅くなります。ほとんどの BAU 処理では、以下のみを許可します。

   • root/Top of Information Store/Inbox
   • root/Top of Information Store/Sent Items

   参加者フィルター

   注:

   参加者フィルターを適用する場合:

   • 参加者を許可するということは、明示的に許可されていない参加者が拒否されることを意味します。
   • 拒否された参加者は、許可リストにも含まれている場合でも拒否されます。
   • 参加者フィルターでは大文字と小文字が区別されません。
   • 許可された参加者 - 許可された参加者のメール アドレスを入力します。
   • 拒否された参加者 - 拒否された参加者のメール アドレスを入力します。

   参加者ドメイン フィルター

   注:

   参加者ドメイン フィルターを適用する場合:

   • ドメインを許可するということは、明示的に許可されていない参加者が拒否されることを意味します。
   • 拒否された参加ドメインは、許可リストにも含まれている場合でも拒否されます。
   • トップレベルドメインをワイルドカード化できます。たとえば、 reinfer.* は reinfer.dev と reinfer.comに一致します。
   • 参加者ドメイン フィルターでは、大文字と小文字が区別されません。
   • 許可された参加者ドメイン - 許可された参加者のドメインを入力します (例: gmail.com)。
   • 拒否された参加者ドメイン :拒否された参加者のドメインを入力します(例: gmail.com)。

   添付ファイル

   • 添付ファイルの内容を同期 - このオプションを有効化すると、メールの添付ファイルも同期されます。
   8. 以下のいずれかのオプションを選択します。
      • メールボックスを追加
      • 新しいメールボックスを破棄します。
   9. [ 連携を作成] を選択します。

最終ステップ

これで、Communications Mining™ と Azure を介した Microsoft Exchange 間の連携が正常に作成されました。次の図に示すように、トグルを使用して連携を無効化できます。削除するには、ゴミ箱アイコンを選択します。

Exchange との連携では、添付ファイルの同期をメールボックス レベルで有効化することもできます。その後、ストリーム API によって、添付ファイルの参照を介して添付ファイルを取得できるようになります。添付ファイルの同期について詳しくは、「 添付ファイル 」および 「Exchange との連携を使用する 」をご覧ください。

連携プロセスについて質問がある場合やサポートが必要な場合は、UiPath® サポートまでお問い合わせください。