メール OAuth プロファイルと Microsoft 365 クライアント認証情報

メール OAuth プロファイルを使用すると、コンタクト センター AI プラットフォーム(CCAI プラットフォーム)のメールアカウントの OAuth 設定を管理できます。すべての OAuth IMAP アカウントに単一のグローバル OAuth 構成を使用するのではなく、個別のメール OAuth プロファイルを作成し、各メールアカウントを使用するプロファイルにリンクできます。

Microsoft 365 の場合、メール OAuth プロファイルはクライアント認証情報の権限付与タイプをサポートしています。この権限付与タイプは、個々のユーザーのログインに依存するのではなく、アプリケーション レベルで認証を行います。アクセスが 1 人の管理者ユーザーのパスワード、同意セッション、雇用状況に依存しないため、support@company.com などの共有メールボックスに特に便利です。

このページでは、クライアント認証情報を使用して Microsoft 365 のメール OAuth プロファイルを設定する方法について説明します。

認証コードとクライアント認証情報

CCAI プラットフォームは、メールアカウントの認証コードとクライアント認証情報の OAuth 権限付与タイプをサポートしています。次の表に、これらの権限付与タイプを比較します。

付与タイプ 最適な用途 仕組み
認証コード ユーザー固有のメールボックス 管理者またはメールボックス ユーザーが Microsoft OAuth 同意フローを使用してログインします。
クライアント認証情報 共有またはアプリケーション管理の Microsoft 365 メールボックス CCAI プラットフォームは、アプリの登録、クライアント シークレット、 インスタンス レベルの権限を使用して、インタラクティブ ユーザーのログインなしでアクセスをリクエストします。

各メール OAuth プロファイルは 1 つの権限付与タイプを使用します。組織で異なる権限付与タイプ、プロバイダ、メールボックス構成が必要な場合は、個別のメール OAuth プロファイルを作成し、各メールアカウントを適切なプロファイルにリンクします。

始める前に

以下のものが揃っていることを確認してください。

  • Microsoft 365 インスタンス。

  • Microsoft Entra 管理者アクセス。

  • メール設定を管理する権限を持つ CCAI プラットフォーム管理者アカウント。

  • ローカルにインストールされた PowerShell。

  • ExchangeOnlineManagement PowerShell モジュールがインストールされている。

  • ディレクトリの Microsoft インスタンス ID。

また、CCAI プラットフォームがアクセスするメールボックスを確認する必要があります。

Microsoft Entra アプリの登録を作成する

CCAI プラットフォームは、Microsoft Entra アプリの登録を使用して、Microsoft 365 メールアクセス用の OAuth トークンをリクエストします。

Microsoft Entra アプリの登録を作成する手順は次のとおりです。

  1. Microsoft Azure で、[Microsoft Entra ID] > [アプリの登録] に移動します。

  2. [新規登録] を選択します。

  3. アプリにわかりやすい名前(CCAI プラットフォーム メール OAuth など)を入力します。

  4. 登録を完了します。

  5. アプリケーション(クライアント)ID をコピーします。

  6. ディレクトリ(テナント)ID をコピーします。

メール OAuth プロファイルを作成 するときに、これらの値を使用します。

クライアント シークレットを作成する

クライアント シークレットを作成する手順は次のとおりです。

  1. アプリの登録で、[証明書とシークレット] に移動します。

  2. 新しいクライアント シークレットを作成します。

  3. シークレット値をすぐにコピーします。

Microsoft API 権限を追加する

アプリには、Exchange Online を介してメールにアクセスして送信する権限が必要です。

Microsoft API 権限を追加する手順は次のとおりです。

  1. アプリの登録で、[API 権限] に移動します。

  2. [Add a Permission] を選択します。

  3. [Office 365 Exchange Online] を選択します。

  4. [Application permissions] を選択します。

  5. 必要な権限を追加します。

    • IMAP.AccessAsApp

    • SMTP.SendAsApp

  6. CCAI プラットフォームで利用可能な Microsoft 365 メールボックスをプルダウンに表示する場合は、インスタンスのユーザーまたはメールボックスを一覧表示するために必要な Microsoft Graph アプリケーション権限を追加します。

  7. [Grant admin consent for your organization] を選択します。

続行する前に、権限が付与されていることを確認します。

メールボックスへのアプリのアクセス権を付与する

アプリにインスタンス レベルの権限が付与されたら、CCAI プラットフォームが接続する特定のメールボックスへのアクセス権を付与します。

メールボックスへのアプリのアクセス権を付与する手順は次のとおりです。

  1. PowerShell を開きます。

  2. Exchange Online に接続します。

    Connect-ExchangeOnline -Organization TENANT_ID
    

    TENANT_ID は、Microsoft 365 ディレクトリ(テナント)ID に置き換えます。

  3. Exchange にサービス プリンシパルを登録します。

    New-ServicePrincipal `
        -AppId APPLICATION_CLIENT_ID `
        -ObjectId OBJECT_ID
    

    次のように置き換えます。

    • APPLICATION_CLIENT_ID: Microsoft Entra アプリの登録のアプリケーション(クライアント)ID

    • OBJECT_ID: [エンタープライズ アプリケーション] のオブジェクト ID

  4. メールボックスへのアクセス権を付与します。

    Add-MailboxPermission `
        -Identity EMAIL_ADDRESS `
        -User SERVICE_PRINCIPAL_ID `
        -AccessRights FullAccess
    

    次のように置き換えます。

    • EMAIL_ADDRESS: CCAI プラットフォームがアクセスするメールボックスのメールアドレス

    • SERVICE_PRINCIPAL_ID: サービス プリンシパル ID

CCAI プラットフォームでメール OAuth プロファイルを作成する

Microsoft 365 クライアント認証情報構成のメール OAuth プロファイルを作成する手順は次のとおりです。

  1. CCAI プラットフォーム ポータルで、[設定] > [デベロッパー設定] をクリックします。 [**設定**] メニューが表示されない場合は、 [**メニュー**] をクリックします。

  2. [メールアカウント管理] ペインに移動し、[メールアカウントを管理] をクリックします。[メールアカウント管理] ページが表示されます。

  3. [メール OAuth] タブをクリックします。

  4. [プロフィールを追加] をクリックします。

  5. [名前] フィールドにプロファイル名を入力します。

  6. [権限付与タイプ] リストで、[クライアント認証情報] を選択します。

  7. [トークン URL] フィールドに、インスタンスの Microsoft OAuth トークン エンドポイントを入力します。

  8. [クライアント ID] フィールドに、Microsoft Entra のアプリケーション(クライアント)ID を入力します。

  9. [クライアント シークレット] フィールドに、Microsoft Entra のクライアント シークレット値を入力します。

  10. [オーディエンス] フィールドに、オーディエンスを入力します。

  11. [スコープ] フィールドに、スコープを入力します。

  12. [状態] フィールドに、状態を入力します。

  13. [アクセスタイプ] フィールドに、アクセスタイプを入力します。

  14. [保存] をクリックします。

メールアカウントを OAuth プロファイルにリンクする手順は次のとおりです。

  1. CCAI プラットフォーム ポータルで、[設定] > [デベロッパー設定] をクリックします。 [**設定**] メニューが表示されない場合は、 [**メニュー**] をクリックします。

  2. [メールアカウント管理] ペインに移動し、[メールアカウントを管理] をクリックします。[メールアカウント管理] ページが表示されます。

  3. [メールアカウント リスト] タブをクリックします。

  4. 編集するメールアカウントで をクリックし、[Edit email account] をクリックします。

  5. [メールサービス] リストで、[OAuth IMAP] を選択します。

  6. [OAuth プロファイル] リストで、前の手順で作成した OAuth プロファイルを選択します。

  7. [リンク] をクリックします。

  8. [メール ID] リストで、メールボックスを選択します。

  9. [保存] をクリックします。

リンクすると、CCAI プラットフォームが選択した OAuth プロファイルで認証できることが確認されます。メールボックスを選択すると、メールアカウントで使用するメールボックスが CCAI プラットフォームに通知されます。

CCAI プラットフォームが Microsoft からメールボックス リストを取得できない場合、フォームはメールアドレスの手動入力に戻ります。メールボックスのアドレスを手動で入力し、アカウントを保存します。

トラブルシューティング

問題 解決策
メールボックス リストが読み込まれない Microsoft アプリに必要な Microsoft Graph 権限と管理者の同意があることを確認します。プルダウンが使用できない場合は、メールボックスを手動で入力できます。
認証エラーでリンクに失敗する クライアント ID、クライアント シークレット、インスタンス ID、トークン URL が正しいことを確認します。また、クライアント シークレットの有効期限が切れていないことを確認します。
メールボックスでメールを送受信できない アプリに Exchange Online のメールボックス権限があり メールアカウントが正しいメール OAuth プロファイルにリンクされていることを確認します。