Office365 Oauthを使用したWebex Connectメールアプリの設定

概要

このドキュメントでは、オープン認証(OAuth 2.0)を使用してOffice 365の電子メールアプリケーションを設定する手順について説明します。

著者：Cisco TACエンジニア、Andrius SuchankaおよびBhushan Suresh

前提条件

要件

次の項目に関する知識があることが推奨されます。

• Webex Contact Center(WxCC)2.0
• 電子メールフローが設定されたWebex connectportal 
• MS Azureアクセス
• MS Office 365アクセス

使用するコンポーネント

このドキュメントの情報は、次のソフトウェアのバージョンに基づいています。

• WxCC 2.0
• Cisco Webex Connect
• Microsoft Azure
• Microsoft Office365

このドキュメントの情報は、特定のラボ環境にあるデバイスに基づいて作成されました。このドキュメントで使用するすべてのデバイスは、初期（デフォルト）設定の状態から起動しています。本稼働中のネットワークでは、各コマンドによって起こる可能性がある影響を十分確認してください。

設定

ステップ 1： Webex Connectでメールアプリの設定を開始する

Webex Connectプラットフォームで電子メールアプリケーションの設定を開始します。 

- Webex Connectテナントにログインします。

-[Assets（資産）] -> [Apps（アプリ）]に移動し、[Configure New App（新しいアプリの設定）]をクリックして[Email（メール）]を選択します。認証タイプとして[OAuth 2.0]を選択し、後の設定手順で[Forwarding Address]と[Call Back URL]をコピーして保存します。

Microsoft側での設定に進みます。

ステップ 2： Microsoft Azureでアプリを作成する

Azureポータルにアプリを登録するには、「Microsoft IDプラットフォームにアプリケーションを登録する」のドキュメントを参照してください。

https://portal.azure.comにログインします。

-[Azure Active Directory]に移動し、[アプリの登録]を選択して[新しい登録]をクリックします。

– アプリケーション名を入力し、適切なアカウントタイプを選択し、Webの「リダイレクトURI」をテナント名(手順1で確認したhttps://yourwebexconnectname.us.webexconnect.io/callback as)に入力し、アプリケーションを登録します。

– アプリケーションの登録後、[Authentication]に移動し、[Implicit grand and hybrid flows]まで下にスクロールし、[Access tokens]オプションを選択して保存します。

-[Certificates & secrets]に移動し、[Client Secrets]を選択し、[New client secret]をクリックし、説明と有効期間を追加します。

– クライアントシークレット値をコピーし、後で使用できるように保存します。

-[APIアクセス許可]に移動し、[アクセス許可の追加]をクリックし、[組織で使用するAPI]を選択し、検索フィールドに「office 365」と入力し、[Office 365 Exchange Online]を選択します。[Application permissions]を選択し、[Mail]セクションを展開して[Mail.Send]をオンにし、[Add permission]をクリックします。

・当該許可を付与した後は、管理者の同意を得ること。[Grant admin consent]をクリックします。

-[Overview（概要）]に移動し、[Application (client) ID(アプリケーション（クライアント） ID)]と[Directory （テナント） ID(ディレクトリ（テナント） ID)]を書き留めて、さらに設定を行います。

注： Azureで、[エンタープライズアプリケーション]の[同意とアクセス許可]の下で、アプリケーションに対するユーザーの同意が許可されていることを確認してください（これは既定の設定です）。

ステップ 3： Office 365でメールボックスユーザーを構成する

https://admin.microsoft.comにログインします。

-Users->Active Usersに移動します。

- Webex Connectと統合するメールボックスを持つユーザを選択します。

– 特定のユーザーを選択した後、[メール]に移動し、[メールアプリ]の[メールアプリの管理]をクリックします。[認証されたSMTP]が選択されていることを確認し、[変更の保存]をクリックします。

-[Email Forwarding（メール転送）]で[Manage email forwarding（メール転送の管理）]をクリックし、[Forward all emails sent to this mailbox（このメールボックスに送信されたメールをすべて転送）]を選択し、ステップ1で確認したWebex Connectアプリケーション設定のエイリアスで[Forwarding email address（メール転送アドレス）]に入力し、[Save changes（変更を保存）]をクリックします。

– 外部メールアドレスへの送信メール転送がMicrosoft 365 Defenderポータルで許可されていることを確認します。

– そうでない場合は、Microsoftのドキュメントに従って既存のスパム対策ポリシーを作成または変更します。

送信スパムフィルタリングの構成 – Office 365

注：転送が'On'に設定されたスパム対策ポリシーを保存しようとしているときに、'Enable-OrganizationCustomization'に関連するエラーが表示される場合は、Microsoftの記事「Enable-OrganizationCustomization」に記載されているように、'Enable-OrganizationCustomization'コマンドレットを実行してください（このコマンドレットの変更が有効になるまで最大24時間かかる場合があります）。

注2: Exchange Online PowerShellに接続するには、「Exchange Online PowerShellに接続する」を参照してください。

ステップ 4： Webex Connectでの電子メールアプリケーションの設定

Webex Connect電子メールアプリケーションの設定に戻り、必須フィールドに入力します。

– 「Email ID」には、手順3でWebex Connect電子メールalisに向けて電子メールを転送するように設定されたメールボックスを使用します。

- SMTP設定の設定を使用します。

SMTP Server: smtp.office365.com
Port: 587
Security: STARTTLS

– 「Username」には、ステップ3で設定したのと同じユーザを使用します。

– 「クライアントID」には、ステップ2に示すように、保存された「アプリケーション（クライアント）ID」を使用します。

– 「Client Secret」には、ステップ2に示すように、保存された「Client secret」を使用します。

-[Authorization URL]に「https://login.microsoftonline.com/<your-azure-tenant-id>/oauth2/v2.0/authorize」を使用します。

– 「offline_access https://outlook.office.com/SMTP.Send' for 'Scope';

-[アクセストークンURL]および[トークンURLの更新]には、'https://login.microsoftonline.com/<your-azure-tenant-id>/oauth2/v2.0/token'を使用してください：

-[トークンの生成]をクリックし、[ユーザー名]フィールドと同じユーザーを必ず使用してください。[アクセストークン]、[トークンの更新]、および[有効性]フィールドが入力されます。

-[保存(Save)]をクリックし、[Webex Engageに登録(Register to Webex Engage)]をクリックします。

確認

Office 365メールボックスに電子メールを送信して確認します。その電子メールがWebex Contact Centerエージェントに送信され、Webex Contact Centerエージェントからの応答が元の送信者によって受信された場合、設定は成功します。

トラブルシューティング

それでも電子メールフローが失敗する場合は、Webex Connectポータルページのデバッグコンソールにアクセスし、電子メールチャネルとタイムスタンプで検索します 

このセクションには、Incoming MessageおよびOutgoing MessageとStatus

障害の詳細を収集するには、メッセージIDを選択します 

[Message ID] を選択すると、[Error & Warnings] セクションにエラーの詳細が表示されます

Cisco TACを有効にする必要がある場合は、次の情報を収集してください。 

• 電子メールチャネルの資産ID 
• 次に示すように、デバッグログで失敗したトランザクションIDとスクリーンショット