シングルサインオンの設定

ID プロバイダ (IdP) を使用した SSO 接続アプリケーションと Salesforce の設定

1. カスタムドメイン名を設定していることを確認します。詳細は、[私のドメイン] を参照してください。
   1. [設定] から、[私のドメイン] に移動します。サブドメイン名を入力して、使用可能かどうかを確認します。
   2. 使用できる名前であれば、[ドメインの登録] をクリックします。
   3. ドメインをテストして、ユーザにリリースします。
2. [設定] から、[クイック検索] ボックスに「ID プロバイダ」と入力し、[ID プロバイダ] を選択して有効化します。証明書とメタデータファイルをダウンロードします。
3. [クイック検索] ボックスに「アプリケーションマネージャ」と入力します。[アプリケーションマネージャ] | [新規接続アプリケーション] をクリックします。
4. 新しい接続アプリケーションを作成し、[基本情報] および [Web アプリケーショ��設定] で詳細を入力します。
   1. 接続アプリケーションの名前を指定します。
   2. SAML を有効にします。
   3. [ACS URL] と [エンティティ ID] を入力します。
   4. [件名種別] を [必須] として選択し、予想される SSO と一致するように名前 ID 形式を更新します。
   5. ドロップダウンオプションから IdP 証明書を選択します。
   6. [保存] をクリックします。
   7. [プロファイルを管理する] をクリックし、SSO を使用するためのアクセス権を付与するすべてのプロファイルを選択します。
5. ID プロバイダを有効にしたら、IdP として Salesforce を使用するためのメタデータファイルをダウンロードします。このメタデータ XML ファイルは、SSO の設定で使用されます。

ヘッドレス SSO の実行

テレフォニーシステムログインページが必要ない場合、サービスへのヘッドレスシングルサインオン (SSO) を使用できます。Salesforce は、{contactCenterName}.callCenter で定義されたコンタクトセンター全体の設定を使用してメッセージをコネクタ iFrame に送信します。これらの詳細を使用して SSO を許可し、Promise が成功または拒否されたときに InitResult 型の値を使用して達成された Promise を返すことで Salesforce に通知します。

コネクタの初期化時に Salesforce から送信されるサンプルコンタクトセンター設定を次に示します。

1init(ssoConfig) {
2  const ssoResult = pbx.performSSO(ssoConfig)
3  if (ssoResult.success) {
4    return Promise.resolve(new InitResult({}));
5  } else {
6    return Promise.reject("Failed to login");
7  }
8}

SSO が成功すると、SSO ダイヤラーが有効になり、エージェントが発信通話を発信することができるようになります。SSO が失敗すると、ベースコネクタは CAN_NOT_LOG_IN エラーをディスパッチします。エージェントは、オムニチャネルユーティリティまたは Salesforce ウィンドウでエラーメッセージを受信し、キーパッドが無効化されたままになります。