このセクションでは、Google Workspace を使用して SSO を構成し、企業全体の Google Workspace 認証情報を使用して Contact Center AI Platform(CCAI Platform)とエージェント アダプタにログインする方法について説明します。Google Workspace SSO は、Security Assertion Markup Language(SAML)認証プロトコルを使用します。
始める前に
Google Workspace を使用して SSO を構成するには、次のものが必要です。
- Google Workspace 管理者の認証情報
- SSO の URL
- エンティティ ID
- メール マッピング フィールド(通常は名前 ID)
- SAML 証明書(Base64 形式)
- CCAI プラットフォームの管理者認証情報
SSO 用に Workspace を構成する
Google Workspace を構成する手順は次のとおりです。
Google Workspace 管理コンソールで、[アプリ] > [ウェブアプリとモバイルアプリ] に移動します。
[アプリを追加] をクリックします。
[カスタム SAML アプリを追加] を選択します。
[アプリ名] フィールドに、この SAML アプリがナレッジベースに属していることを識別できる名前(CCAI Platform インスタンス SSO など)を追加します。
[続行] をクリックします。
Google ID プロバイダの詳細ページに移動します。Google では、CCAI Platform インスタンスに必要な Google Workspace IdP 情報を取得するための 2 つのオプションを提供しています。CCAI Platform の場合は、セクション オプションを使用しました。
[SSO の URL]、[エンティティ ID]、[証明書] の値をコピーします。
SSO 用に CCAI プラットフォーム インスタンスを構成する
CCAI Platform インスタンスの SSO を構成する手順は次のとおりです。
- Google Cloud コンソールで、プロジェクト セレクタ ダッシュボードに移動し、インスタンスを含むプロジェクトを選択します。
- ナビゲーション メニューで [CCAI Platform] をクリックします。
[CCAI プラットフォーム インスタンス] ページが表示されます。
- [名前] 列で、SSO を構成するインスタンスをクリックします。
- [CCAI Platform インスタンスの詳細] ページで、[ 編集] をクリックします。
- ログイン方法として [SAML] を選択します。
- [Single sign-on URL] フィールドに、SSO の URL を入力します。
- [エンティティ ID] フィールドに、エンティティ ID を入力します。
- [メール フィールドのマッピング] フィールドに、
Email nameやName IDなどのテキスト文字列を入力します。これは、SSO ログインページのメールアドレス フィールドのラベルとして使用されます。 - [認証コンテキスト] フィールドで、必要な認証コンテキストを選択します。IdP 構成で認証コンテキストの指定が不要な場合は、このフィールドを空のままにします。詳細については、認証コンテキストをご覧ください。
- [Certificate] フィールドに、SAML 証明書を入力します。証明書の
-----BEGIN CERTIFICATE-----と-----END CERTIFICATE-----を必ず含めてください。 - [保存] をクリックします。
CCAI Platform インスタンスのサービス プロバイダの詳細を Google Workspace SAML アプリの構成に追加する
Google Workspace 管理コンソールに戻り、[続行] を選択します。
[サービス プロバイダ] ページで、次の詳細を入力します。
ACS の URL(
https://{my_instance_id}.ccaiplatform.com/saml/v1/consume)を入力します。[Identifier (Entity ID)] URL(
https://{my_instance_id}.ccaiplatform.com/saml/v1/metadata)を入力します。[開始] URL(
https://{my_instance_id}.ccaiplatform.com/)を入力します。[名前 ID] の形式を [メール] に設定します。
画面下部の [続行] をクリックします。
アプリケーションにアクセスできるユーザー グループを選択します。
[完了] をクリックします。
SSO 認証を確認する
SSO 認証を確認する手順は次のとおりです。
顧客管理(CRM)アプリケーションでエージェント アダプタに移動します。
[Login with company SSO] をクリックします。ログインページが表示されます。
Google Workspace の認証情報を使用してログインします。