Exchange と Azure アプリケーション認証の統合

はじめに

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

統合の成功が重要なのはなぜですか?

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

The step-by-step integration process

1. Register a new Communications Mining application

1. Sign into your Azure portal.
2. Go to the App Registrations menu and select New Registration.
   
   
   
   
3. Fill in and configure the required fields:
   • Name: for example, reinfer-exchange-integration.
   • Supported account types: select the single tenant option.
4. Select Register, which redirects you to a page with details of the registered application, such as Application (client) ID, Directory (tenant) ID.

2. Create a client secret for a Communications Mining application

To keep your application secure, create a client secret as follows:

1. Select Certificates and secrets under the Manage drop-down list.
2. Select New client secret under the Client secrets tab.
   
   
   
   
3. This opens the Add a client secret sidepanel.
4. 必要なフィールドに入力します。
   • Description: enter a description for the client secret.
   • Expires: select an expiry date. The recommended option is 12 months.
   
   
   
   
   
5. [追加] を選択します。
6. The client secret is displayed under the Value column.
   
   
   
   

Note: Azure displays the secret value only once. Therefore, make sure you copy and store it in a safe place. If you ever lose your secret value, create a new one.

3. Set API permissions

When using the Microsoft Graph API

1. Go to API permissions under the Manage drop-down list.
2. Select Add a permission.
   
   
   
   
3. Select Microsoft Graph under the Microsoft APIs tab.
   Figure 1. The Microsoft APIs tab
   

   

   
   
4. Select Application permissions.
   Figure 2. The permission options of Microsoft Graph
   

   

   
   
5. Expland the Mail drop-down list and select the Mail.Read permission.
   Figure 3. Selecting a permission
   

   

   
   
6. Select Add permissions.
7. Select the MailboxFolder.Read.All permission.
   Figure 4. Selecting a permission
   

   

   
   
8. Select Add permissions.
9. Back in the API permissions menu, select Grant admin consent for Communications Mining.
10. Select Yes in the Grant admin consent confirmation pop-up.
    
    
    
    

When using the EWS API

1. Go to the API permissions under the Manage drop-down list.
2. [アクセス許可の追加] を選択します。
   
   
   
   
3. [所属する組織で使用している API] を選択します。
   
   
   
   
4. Search for Office 365 Exchange Online and select it.
5. Select Application permissions.
   
   
   
   
6. Select the full_access_as_app permission.
7. Select Add permissions.
   
   
   
   
8. Back in the API permissions menu, select Grant admin consent for Communications Mining.
9. Select Yes in the Grant admin consent confirmation pop-up.
   
   
   
   

4. Restrict mailbox access with a conditional access policy

At this point, you may want to limit the application permissions so that it can only access certain mailboxes within your organization. To learn how to do this, check Limiting application permissions to specific Exchange Online mailboxes in the official Microsoft documentation.

5. Create a new integration in Communications Mining

1. Go to Communications Mining by accessing IXP in Automation Cloud and selecting Communication Data.
2. Select the Integrations tab under the settings option.
3. Select New integration.
   
   
   
   
4. Select an existing project, enter a name for your integration, and, optionally, a title.
5. [続行] を選択します。
   
   
   
   
6. Fill in and configure the required fields as follows:
   • Oauth Authority: enter the previously generated tenant ID in the following format: https://login.microsoftonline.com/{tenant_id}.
   • Oauth Client Id: enter the previously generated client ID.
   • Client Secret: enter the previously generated client secret.
7. [アプリケーション アクセス] オプションを選択します。
8. Select Validate and save credentials to check that your credentials are valid.
9. [続行] を選択します。
   Figure 5. The create a new integration configuration page
   

   

   
   
10. Select Add Mailbox to open the mailbox form.
11. Enter the email address for which you want to copy emails into Communications Mining.
12. Select Add Mailbox again to save the mailbox.
13. Select Create Integration.
    
    
    
    

最終ステップ

これで、Azure を介した Communications Mining と Microsoft Exchange 間の連携が正常に作成されました。 統合を無効にするには、[統合] ページの右上隅にあるスイッチを押します。 削除するには、ごみ箱アイコンを選択します。

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

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