内容

概要

前提条件

要件

使用するコンポーネント

背景

項目の確認

最小バージョン

システム コンフィギュレーション

Azure ADアプリケーション

トークン生成

メールボックスの設定

Exchangeライセンス

メールボックスの権限

ネットワーク接続

URL

ポート

接続テスト

ドキュメントのリンク

11.6(1)

12.0(1)

12.5(1)

12.6(1)

概要

このドキュメントでは、Microsoft Office 365(O365)電子メールとのエンタープライズチャットおよび電子メール(ECE)の統合をトラブルシューティングする手順について説明します。

前提条件

要件

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

- Enterprise Chat and Email(ECE)12.6

- Microsoft Office 365 (O365)

- Microsoft Azure Active Directory (Azure AD)

使用するコンポーネント

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

- ECE 12.6(1)

- Azure AD

- O365

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

背景

Microsoftは、O365電子メールアカウントでの基本認証を正式に廃止しました。これは2019年に発表され、その後COVID-19のために2022年10月まで延期されました。2022年10月の期限を過ぎても、Microsoftは基本認証を最後にもう一度有効にすることを許可しました。この最後の例外は2022年12月31日に終了しました。この日付以降、Microsoftは顧客に対して基本認証を有効ではなくなりました。

このチェックリストの項目は、TACがお客様と協力してこの機能を設定したサービスリクエストに基づいています。O365とAzure ADのライセンスの仕組みにより、TACにはラボでこれらの項目を再作成またはチェックする機能がありません。これらのサポートが必要な場合は、Microsoftサポートまたは社内のITサポートチームにお問い合わせください。

項目の確認

最小バージョン

O365を使用したECEのOAuthサポートは、Cisco Bug ID CSCvr86493への対応としてECEのエンジニアリングスペシャル(ES)で導入されました .ECEに正しいESがインストールされ、正しいドキュメントが使用されていることを確認する必要があります。

- ECE 11.6(1):ES12およびES12_ET1が必要

- ECE 12.0(1):ES6が必要

- ECE 12.5(1):ES3が必要

- ECE 12.6(1):ES1が必要

ベストプラクティスは、ご使用のバージョンで利用可能な最新のESをインストールすることです。

システム コンフィギュレーション

Web URLを正しく設定する必要があります。特定の設定は、ECEのバージョンに応じて変更されます。これは、エージェントおよび管理者がECEへのログインに使用するURLと一致するように設定する必要があります。URLの形式はhttps://ece.example.comです。

各バージョンの設定名：

11.5 ～ 12.5：パーティションレベル設定、「WebサーバURLまたはロードバランサURL」

12.6 + :[Partition] > [Apps] > [General Settings] > [External URL of Application]

この設定は、シングルサインオン(SSO)およびチャットエントリポイントのデフォルトHTMLにも使用されます。O365用OAuthのリリース前のバージョンでは、エージェントSSOを使用しない限り、この設定は必須ではありませんでした。OAuthを使用するすべての導入では、これを設定する必要があります。また、これは管理コンソールへのログインに使用されるFQDNと一致する必要があります。

Azure ADアプリケーション

Azure ADアプリケーションを構成する際は、ドキュメントに正確に従ってください。

具体的な注意事項：

1. [Redirect URL]:FQDNはECEの[External URL of Application]設定と一致する必要があり、管理コンソールにアクセスする際に使用する必要があります。

2. アクセストークン – 更新トークンは60分間続く必要があります。

トークン生成

トークン生成プロセスは、設定プロセスの中で最も重要な手順の1つです。ベストプラクティスは、トークンを発行する前に、ブラウザが隠しモードまたはプライベートモードで開かれていることを確認することです。ユーザにクレデンシャルの入力を求めます。トークンを作成するユーザがメールボックスを完全に制御できることを確認します。

これは、ほとんどの顧客がユーザー認証にAzure ADも使用しているためです。ユーザがブラウザを開くと、そのクレデンシャルがKerberosを通じてlogin.microsoft.comサイトに渡されます。これにより、メールボックスにアクセスできるアカウントではなく、ワークステーションまたはサーバにログインしているユーザに対してトークンが発行されます。

メールボックスの設定

メールボックスで必要なプロトコルが有効になっていることを確認します。少なくとも、メールのディスパッチを許可するにはSMTPを有効にする必要があります。また、設計に基づいてIMAPまたはPOP3を有効にする必要があります。

Exchangeライセンス

少なくとも1つのE3ライセンスがExchange Onlineのメールボックスに割り当てられていることを確認してください。

メールボックスの権限

ECEでは、メールボックスへのアクセスに対して2種類のユーザアカウントがサポートされています。

1.メールボックスアカウント：この方法では、ECEチェックを行うメールボックスごとにアカウントとアクセストークンを作成する必要があります。たとえば、2つのメールボックス(sales@example.comとsupport@example.com)がある場合、部門に2つの電子メールアカウントを作成する必要があります。1つのアカウントに対して、トークンを作成し、sales@example.comユーザ名とパスワードを使用してログインする必要があります。2番目のアカウントトークンは、support@example.comユーザ名とパスワードを使用して作成する必要があります。

2.共有アカウント：この方法では、複数のメールボックスにアクセスできる単一のメールアカウントを使用できます。セールスメールボックスとサポートメールボックスを引き続き使用するには、ここでは1つのアカウントを作成しますが、メールボックスのフルコントロールが与えられているAzure ADアカウントのユーザー名とパスワードを使用してトークンを作成します。

どちらのアクセス方法にも長所と短所がありますが、特定の環境に最適なアクセス方法を決定するのはユーザーです。

ネットワーク接続

ECEでは、サービスサーバとすべてのアプリケーションサーバがO365ドメインおよびlogin.microsoft.comドメインにアクセスできる必要があります。最初のトークンの作成はアプリケーションサーバから行われ、以降のすべてのトークンの更新はサービスサーバで行われます。サービスサーバには取得元とディスパッチャのプロセスが存在するため、このサーバに対してIMAP/POP3およびSMTPポートが開いている必要があります。また、アプリケーションサーバは、アラーム通知が機能するように電子メールを送信できる必要があります。O365統合をセットアップまたは使用する前に、インストールガイドで呼び出されたすべてのポートが開かれていることを確認します。

URL

サービスサーバとアプリケーションサーバの両方が、少なくともURLにアクセスできる必要があります。

-*.office365.com

-login.microsoftonline.com

特定の実装に必要な追加のURLが存在する場合があります。

ポート

サービスサーバとアプリケーションサーバの両方が、最低限これらのポートにアクセスできる必要があります。

- TCP 443 - (HTTPS)アクセスおよびリフレッシュトークンの生成と更新に使用されます。

- TCP 587 - (SMTP over STARTTLS)ディスパッチャプロセスおよびアラーム通知プロセスで使用される

- TCP 993 - (IMAP over SSL/TLS)取得元プロセスによって使用される

- TCP 995 - (POP3 over SSL/TLS)取得元プロセスによって使用される

参考：POP、IMAP、およびSMTPの設定

接続テスト

Microsoftは、接続のテストに使用できるWebサイトを作成しました。これはシスコまたはeGainが提供するツールではなく、TACはその使用に関するサポートを提供できません。これをApplication and Servicesサーバから使用して、設定と接続をテストできます。ECEはアウトバウンドにはSMTPのみをサポートし、インバウンドにはIMAPまたはPOP3のいずれかをサポートします。Microsoft WebサイトのPOP電子メールおよびIMAP電子メールテストと共に、送信SMTP電子メールテストを使用します。

https://testconnectivity.microsoft.com/tests/o365

ドキュメントのリンク

11.6(1)

- UCCE/PCCE:電子メールリソースの管理者ガイド

12.0(1)

- UCCE:Administrator's Guide to Email Resources(UCCE)

- PCCE:チャットおよび電子メールリソース(PCCE)の管理者ガイド

12.5(1)

- UCCE:Administrator's Guide to Email Resources(UCCE)

- PCCE:チャットおよび電子メールリソース(PCCE)の管理者ガイド

12.6(1)

- UCCE/PCCE:電子メールおよびルーティングリソースに関する管理者ガイド