DOCUMENTATION
search

シングル サインオンの使用

Bot 管理者コンソールの [セキュリティおよび管理] モジュールにあるKore.ai [シングル　サインオン] ページで、以下を使用して Kore.ai 管理対象ユーザー用のシングル サインオン（SSO）認証を設定できます。

  • OpenID コネクト
  • セキュリティ アサーション マークアップ ランゲージ (SAML)
  • WS-フェデレーション サインオン プロトコル

SSO　により、既存の　ID　プロバイダーを使って　Kore.ai　アプリケーションに簡単にアクセスすることができます。SSO を利用することで、ユーザーは、例えば会社のアカウントに一度ログオンすれば、ユーザーが自分の Kore.ai アプリケーションにアクセスする際に、同じログイン認証情報をシステムが自動的に使用することができます。たとえば、WS-フェデレーションサインオンプロトコルを使用すると、Microsoft® Active Directory® サーバー クレデンシャルを使用して、ユーザーが Kore.ai アプリケーションにサインオンできるようになります。以下の説明は、Bot 管理者コンソールの[セキュリティおよび管理] モジュールにある[シングル　サインオン] ページを示しています。

SSO の有効化または無効化

会社に必要なセキュリティに応じて、Kore.ai アプリケーションにアクセスするユーザーのシングル　サインオン（SSO）を有効または無効にすることができます。SSOを無効にした場合や、SSO認証の有効期間が終了した場合、ユーザーはクレデンシャルを作成して、それを使ってログオンする必要があります。アカウント固有のパスワード ポリシーが定義されていない場合は、デフォルトの Kore.ai パスワード ポリシーがユーザーに対して自動的に有効になります。

シングル サインオンを有効にするには

  • [セキュリティおよび管理] モジュールにある[シングル　サインオン] ページで、[SSO を有効にする]をクリックします。SSOを有効にする

シングル サインオンを無効にするには

  • [セキュリティおよび管理] モジュールにある[シングル サインオン] ページで、[SSO を無効にする]をクリックして、ユーザー　パスワード　ポリシーを設定します。SSOを無効にする

OpenID コネクト

以下の手順で、Bot 管理者コンソールの[セキュリティおよび管理] モジュールで、Open ID コネクト プロトコルを使用して SSO を設定します。Kore.ai は、WS-フェデレーションと SAML コネクト プロトコルもサポートしています。

  1. Bot 管理者コンソールの[セキュリティおよび管理] モジュールにある[シングル サインオン] ページで、[SSO を有効にする]をクリックします。
  2. [適切なサインオン プロトコルの選択] セクションで、[OpenID コネクト]をクリックします。
  3. [OpenID コネクト の SSO の設定] セクションで、ID プロバイダー、たとえば、[Google でサインイン]を選択します。
  4. [保存]をクリックします。
  5. ID プロバイダー情報が正常に更新されましたメッセージが、ページの上部に表示されます。

WS-フェデレーション

以下の手順で、Bot 管理者コンソールの[セキュリティおよび管理] モジュールで、WS-フェデレーション プロトコルを使用したシングル サインオン（SSO）を設定します。

  1. Bot 管理者コンソールの[セキュリティおよび管理] モジュールにある[シングル サインオン] ページで、[SSO を有効にする]をクリックします。
  2. [適切なサインオン プロトコルの選択] セクションで、[WS-フェデレーション]を選択します。
  3. [WS-フェデレーションの SSO の設定] セクションでは、[ID プロバイダー]を選択し、以下の設定を行います。
    • Windows Azure®
      • Azure AD サインオン エンドポイントの URL – Azure を使用して、Kore.ai がサインオンとサインオフのリクエストを送信する URL です。認証の応答は、Azure Active Directory の構成設定で定義された応答 URL に送信されます。
      • Azure AD フェデレーションのメタデータ ドキュメント – Azure Active Directory での認証に使用されるフェデレーション メタデータ ドキュメントの URL です。
    • その他 – Azure 以外の汎用 WS-フェデレーション ID プロバイダーの設定
      • AD サインオン エンド ポイントの URL – Kore.ai がWS-フェデレーションの ID プロバイダーを使って、サインオンおよびサインオフのリクエストを送る URL です。
      • AD フェデレーションのメタデータ ドキュメントの URL – Active Directory での認証に使用される WS-フェデレーション　メタデータド　キュメントの URL です。

  4. シングル サインオン プロバイダーの管理コンソールでは、Kore.ai と SSO プロバイダー間のデータ交換に使用される URL も定義する必要があります。SSO プロバイダーによって URL 名が異なる場合がありますが、これらの URL を定義する必要があります。

    • SAML 2.0
      • LDAP 属性: nameId
      • クレーム属性: uri
    • SAML 1.1
      • LDAP 属性: nameId
      • クレーム属性: emailAddress
    • アサーション コンシューマー サービス（ACS）の URL または https://idp.kore.ai/authorize/callback としての コールバック URL。
    • ADFS　を使用する際には、認証値に加えて、ユーザーの電子メール アドレスを　Active Directory　から　LDAP　属性として渡す必要があります。詳細については、ADFS の属性を参照してください。
    • [保存]をクリックします。

ID プロバイダー情報が正常に更新されましたメッセージが、ページの上部に表示されます。

SAML

セキュリティ アサーション マークアップ ランゲージ（SAML） とは、セキュアートークンを使用するウェブ ブラウザのシングル　サインオン（SSO） の標準プロトコルです。 SAML は、すべてのパスワードを完全に排除し、代わりに標準的な暗号とデジタル署名を使用して、ID・プロバイダから SaaS アプリケーションに安全なサインイン・トークンを渡します。

SAML は、ID・プロバイダとサービス・プロバイダが互いに別々に存在することを可能にするソリューションを提供します。ユーザーが SAML 対応アプリケーションにログインすると、サービス・プロバイダは適切な ID プロバイダに認証を要求します。ID プロバイダはユーザーの資格情報を認証した後、ユーザーに対する認可をサービス・プロバイダに返し、ユーザーはアプリケーションを使用できるようになります。

SAMLの仕組み

SAML SSO は、ユーザーの ID をある場所（ID プロバイダ）から別の場所（サービス・プロバイダ）に移すことで機能します。これは、デジタル的に署名された XML 文書の交換によって行われます。

次のようなシナリオを考えてみましょう。ユーザーは、ID プロバイダとして機能するシステムにログインします。ユーザーは、サポート・アプリケーションやアカウンティング・アプリケーションなどのリモート・アプリケーション（サービス・プロバイダ）にログインします。次のようになります。

  1. ユーザーが、イントラネット上のリンク、ブックマークなどを使用してリモート・アプリケーションにアクセスすると、アプリケーションがロードされます。
  2. アプリケーションはユーザーの発信元を（アプリケーションのサブドメイン、ユーザーの IP アドレスなどで）識別し、ユーザーを ID プロバイダにリダイレクトして認証を求めます。これが認証リクエストです。
  3. ユーザーは、ID プロバイダとの既存の有効なブラウザ・セッションを持っているか、ID プロバイダにログインしてセッションを確立します。
  4. ID プロバイダは、ユーザーのユーザー名または電子メール・アドレスを含む XML 文書の形式で認証応答を作成し、X.509 証明書を使用して署名し、この情報をサービス・プロバイダに掲示します。
  5. サービス・プロバイダは、ID プロバイダをすでに知っており、証明書のフィンガープリントを持ってい るので、認証応答を取得し、証明書のフィンガープリントを使用してそれを検証します。
  6. ユーザーのアイデンティティが確立され、ユーザーにアプリへのアクセスが提供されます。

Kore.ai の導入

Kore.ai Bots プラットフォームで SAML を利用するには、2つの方法があります。

  • ボット ビルダーにアクセスするための開発者認証用。
  • ボット にアクセスするためのユーザー認証用。

ユースケース 1: Bot ビルダーの認証。

エンタープライズは、エンタープライズ SSO を使って Bot ビルダー ツールへのアクセスをセットアップすることができます。Bot の開発者や管理者は、エンタープライズの ID プロバイダーが行うSSOを利用して、Bot ビルダーにログインすることができます。

Kore.ai Bot プラットフォームからの SSO フロー: SAMLを使って SSO を設定した場合の Kore.ai Bot プラットフォーム内の流れは以下の通りです。

  1. クライアントは、ユーザーの詳細を使って(ログイン URL を使って) Kore アプリ サーバを呼び出し、ID プロバイダ情報を取得します（SAML）。
  2. Kore　アプリ　サーバは、Kore idproxy　サーバとのハンドシェイク要求を開始します。
  3. Kore idproxy　サーバは、ユーザーの詳細情報を使って、ID　プロバイダ（SAML）へのリクエストを開始します。
  4. 認証に成功すると、ID プロバイダ（SAML）は、Kore idproxy サーバにアサーション応答を返します。
  5. ID プロバイダからの応答を検証すると、Kore idproxy サーバは、Kore app サーバへの要求を開始します。
  6. Kore idproxy サーバからのトークンの認証に成功すると、Kore app サーバはユーザーにアクセスを許可します。

v7.2 以降のリリースでは、Kore.ai は IDP が開始したフローをサポートしており、プラットフォームは SAML 応答で直接ポストバックを取得し、アサーションを検証し、ユーザーを登録/識別できます。これらのモード（SPベースとIDPベースのフロー）の設定は異なり、以下の設定ステップで説明します。

SAMLを用いた SSO の設定については、以下を参照してください。

ユースケース 2: エンドユーザー認証

このシナリオでは、SSO によるユーザー認証を必要とするカスタマー　ポータルやモバイル　アプリに　Bot チャット インターフェースが組み込まれています。
Bot　へのアクセスは、自動的に認証されたユーザーに制限されます。SSO ベースの認証が必要な API の呼び出しを必要とするタスクの場合、開発者は以下のステップを実行できます。

  • クライアントでは、開発者はログインしたユーザーの SSO トークンを取得し、Bot SDK API の secureCustomPayload パラメータを使用して Bot に渡す必要があります。
  • Bot の開発者は、ダイアログ タスクの中で、カスタムロジックを書いてこのトークンを読み取り、サービス ノードや　webhook ノードを使用して行われたセキュア API コールの API ヘッダーとして追加することができます。

クライアントに関するトークン情報は、SSO プロバイダやペイロードに応じて異なるため、開発者はカスタム ロジックを記述する必要があります。

SAMLを用いた SSO の設定

以下の手順で、Kore.ai Bot の管理コンソールで SAML（セキュリティ アサーション マークアップ ランゲージ）プロトコルを使用したシングル サインオン（SSO）を設定します。Kore.ai は、WS-フェデレーションと OpenID コネクトプロトコルもサポートしています。詳細については、シングル　サインオンの使用を参照してください。.

  1. Bot 管理者コンソールの[セキュリティおよび管理] モジュールにある[シングル サインオン] ページで、[SSO を有効にする]をクリックします。
  2. [適切なサインオン プロトコルの選択] セクションで、[SAML]を選択します。
  3. [SAMLの SSO の設定] セクションでは、[ID プロバイダー]を選択し、以下の設定を行います。
    • Okta – –
      • Okta シングル　サインオンの URL – Okta用の SSO URL: これは、サービスプロバイダーが開始したSAML　フローを有効にするために使用される。
      • ID プロバイダー発行者 – ユーザーを認証する機能を含むユーザーIDを提供するエンティティ。
      • 証明書 – ユーザー署名の検証に使用される ID プロバイダーからサービス プロバイダーが保存する公開証明書。複数（最大2つ）の証明書を追加したり、既に追加されている無効な証明書を削除したりすることができます。プラットフォームは最新の証明書を認証に使用しますが、それが無効な場合は古い証明書が使用されます。
      • SP が開始した SAML フローの ACS URL – これは サービスプロバイダーが開始した SAML フロー用の転送 URL です。
      • IDP が開始した SAML フローの ACS URL – これは ID プロバイダーが開始した SAML　フロー用のアカウント固有の URL です。
    Kore.ai SSO 用のOkta

    Oktaで Kore.ai のシングル サインオンを設定するには、まず Kore.ai アプリをOktaアカウントに追加し、URL とセキュリティ証明書を Okta から Kore.ai アカウントにコピーする必要があります。このトピックでは、Kore.ai アプリを Okta アカウントに追加してから、Oktaを使った SSO のための Kore.ai 設定に必要な URL と証明書にアクセスする方法を説明します。
    この手順を実行するには、Bot 管理者コンソールの[シングル サインオン] ページで、SAML プロバイダとしてOktaを既に選択している必要があります。
    Kore.ai アプリを　Okta に追加するには、

    1. Okta にログオンします。
    2. [ホーム] ページで、[管理者]をクリックします。[ダッシュボード] ページが表示されます。
    3. 上のナビゲーションバーで、[アプリケーション]をクリックします。[アプリケーション] ページが表示されます。
    4. [アプリケーションの追加]をクリックします。[アプリケーションの追加] ページが表示されます。
    5. [アプリケーションの作成]をクリックします。
    6. [一般設定] に、[アプリ名] を指定し、[次へ]をクリックします。
    7. [SAML の設定] に、[シングル サインオン URL] を指定します。取得するには、
      • Kore.ai Bot ビルダー管理者コンソールにログオンします
      • [セキュリティおよび管理] -> [シングル　サインオン] ページで、
      • [SAML] を有効にした後、[Okta]を選択します
      • SP が開始した SAMLフローの ACS URL フィールドには、必要な URL が含まれます
    8. 対象者 URI フィールドに https://idp.kore.com を入力します
    9. 注意: オンプレミス アカウントの場合は、SP が開始した SAML フロー用の ACS URL が https://idproxy-dev.kore.com/authorize/callback として表示されます。これを Okta プラットフォームの 「シングル サインオン URL 」として更新し、https://idproxy-dev.kore.com を “対象者 URL “として更新する必要があります。
    10. emailIdやfirstNameなどの属性情報を、必要に応じて指定できます。
    11. [終了]をクリックします。
  4. [設定] セクションの[サインオン] タブで、[セットアップ指示の表示]をクリックします。[<アプリ名> アプリケーションの SAML 2.0 の設定方法] ページが表示されます。
  5. 以下に URL をコピーします。
    • [ID プロバイダー シングル サインオン ] フィールドを、Kore.ai の [Okta シングル サインオン URL] フィールドに。
    • [ID プロバイダー発行者] フィールドを Kore.ai の[ID プロバイダー発行者] フィールドに。
  6. Okta [X.509 証明書] フィールドで、証明書データをコピーして、そのデータを Kore.ai の[証明書] テキストボックスにペーストします。

    注意: —–BEGIN CERTIFICATE—–ヘッダーの後のデータと —–END CERTIFICATE—- フッターの前のデータのみをコピーして、Kore.ai にペーストします。

  • Kore.aiで、[保存]をクリックします。これで、Okta ログインのシステム連携は完了です。

ID プロバイダー情報が正常に更新されましたメッセージが、ページの上部に表示されます。設定をテストするには、Kore.ai Bot 管理者コンソールをログオフし、再度ログオンします。Okta ポータルが表示されます。

  • OneLogin – 詳細については、以下を参照するか、 OneLogin　ドキュメントで、Kore.ai の SSO の設定を参照してください。
    • SAML 2.0 エンドポイント – サービスプロバイダーが開始したSAML フローを有効にするための OneLogin の HTTP SSO エンドポイント (例えば、https://app.onelogin.com/trust/saml2/http-post/sso/358111)。
    • 発行者の URL – OneLogin 発行者の URL、例えば、https://app.onelogin.com/saml/metadata/358111。
    • X.509証明書 – ユーザー署名の検証に使用される ID プロバイダーからサービス プロバイダーが保存する公開証明書。複数（最大2つ）の証明書を追加したり、既に追加されている無効な証明書を削除したりすることができます。プラットフォームは最新の証明書を認証に使用しますが、それが無効な場合は古い証明書が使用されます。
    • SP が開始した SAML フローの ACS URL – これは サービスプロバイダーが開始した SAML フロー用の転送 URL です。
    • IDP が開始した SAML フローの ACS URL – これは ID プロバイダーが開始した SAML　フロー用のアカウント固有の URL です。
Kore.ai SSO 用 OneLogin

OneLoginを使って Kore.ai でシングル サインオンを設定するには、まず Kore.ai アプリを OneLogin アカウントに追加し、OneLogin から URL とセキュリティ証明書を Kore.ai アカウントにコピーする必要があります。このトピックでは、Kore.ai アプリをOneLogin アカウントに追加してから、OneLoginを使った SSO のための Kore.ai 設定に必要な URL と証明書にアクセスする方法を説明します。
この手順を実行するには、Bot 管理者コンソールの[シングル サインオン] ページで、SAML プロバイダとして[OneLogin]を選択しておく必要があります。
Kore.ai アプリを　OneLogin に追加するには、

  1. [OneLogin] にログオンします。
  2. [APPS] メニューで、[アプリの追加]をクリックします。[アプリケーションの検索] ページが表示されます。
  3. [検索] フィールドに、Kore.ai を入力してから、[Enter] キーを押します。OneLogin 用 Kore.ai アプリが表示されます。
  4. Kore.ai アプリをクリックします。[Kore.aiの追加] ページが表示されます。
  5. 必要に応じて、[OneLogin]　ポータルでユーザーに表示される表示名やアイコンを変更し、[保存]をクリックします。Kore.ai アプリがOneLoginの会社のアプリに追加され、Kore.ai アプリページが表示されます。
  6. SAML2.0を有効にするセクションの[SSO] タブで、以下に URL をコピーします。
    • [OneLogin SAML 2.0 エンドポイント（HTTP）] フィールドを Kore.ai [SAML 2.0 エンドポイント] フィールドに
    • [OneLogin 発行者 URL] フィールドを Kore.ai [発行者 URL] フィールドに
  7. [OneLogin X.509 証明書] フィールドで[詳細を表示]をクリックします。[標準強度証明書 (2048 bit)] ページが表示されます。
  8. [X.509 証明書] セクションで、証明書データをコピーして、そのデータを Kore.ai の[X.509　証明書] テキストボックスにペーストします。

    注意: —–BEGIN CERTIFICATE—–ヘッダーの後のデータと —–END CERTIFICATE—- フッターの前のデータのみをコピーして、Kore.ai にペーストする必要があります。

  9. Kore.aiで、[保存]をクリックします。

ID プロバイダー情報が正常に更新されましたメッセージが、ページの上部に表示されます。設定をテストするには、Kore.ai Bot 管理者コンソールをログオフし、再度ログオンします。OneLogin ポータルが表示されます。
OneLogin Single Sign-On

  • Bitium –
    • シングル サインオン URL – サービス プロバイダーが設定した SAML フローを有効にするための Bitium の HTTP SSO エンドポイント、例えば https://www.bitium.com/7655。
    • 発行者の URL – OneLogin 発行者の URL、例えば、https://bitium.com/7655/saml/82456/metadata.xml。
    • 証明書 – ユーザー署名の検証に使用される ID プロバイダーからサービス プロバイダーが保存する公開証明書。複数（最大2つ）の証明書を追加したり、既に追加されている無効な証明書を削除したりすることができます。プラットフォームは最新の証明書を認証に使用しますが、それが無効な場合は古い証明書が使用されます。
    • SP が開始した SAML フローの ACS URL – これは サービスプロバイダーが開始した SAML フロー用の転送 URL です。
    • IDP が開始した SAML フローの ACS URL – これは ID プロバイダーが開始した SAML　フロー用のアカウント固有の URL です。

 

Bitium 用 Kore.ai SSO

Bitiumで Kore.ai のシングル サインオンを設定するには、まず Kore.ai アプリをBitium アカウントに追加して、URL とセキュリティ証明書をBitium から Kore.ai アカウントにコピーする必要があります。このトピックでは、Kore.ai アプリをBitium アカウントに追加してから、Bitiumを使った SSO のための Kore.ai 設定に必要な URL と証明書にアクセスする方法を説明します。
この手順を行うには、Bot 管理者コンソールの[シングル サインオン] ページで、SAML プロバイダとして[Bitium]を選択しておく必要があります。
Kore.ai アプリを　Bitium に追加するには、

  1. Bitium にログオンします。
  2. [管理 < 会社名 >] メニューで[アプリを管理]をクリックし、[アプリを追加]をクリックします。アプリを追加ダイアログが表示されます。
  3. [検索] フィールドに、Kore.ai を入力してから、[Enter] キーを押します。Bitium 用 Kore.ai アプリのインストールダイアログが表示されます。
  4. [組織の管理] メニューで、[アプリを管理] をクリックし、[Kore.ai]をクリックします。
  5. [シングル サインオン] タブの [シングル サインオン プロバイダーの選択] セクションで、 [SAML 認証]を選択します。
  6. 以下の URL を、Bitium から Bot 管理者コンソールの Bitium 設定セクションにコピーします。
    • [Bitium ログイン URL] フィールドから Kore.ai [シングル サインオン] フィールドに
    • [Bitium ログアウト URL] フィールドを Kore.ai [発行者 URL] フィールドに
  7. Bitium[ X.509 証明書] フィールドで、証明書データをコピーして、そのデータを Bot　管理者コンソールの[証明書] テキスト ボックスにペーストします。

    注意: —–BEGIN CERTIFICATE—–ヘッダーの後のデータと —–END CERTIFICATE—- フッターの前のデータのみをコピーして、Kore.ai にペーストします。

  8. Kore.aiで、[保存]をクリックします。

ID プロバイダー情報が正常に更新されましたメッセージが、ページの上部に表示されます。設定をテストするには、Kore.ai Bot 管理者コンソールをログオフし、再度ログオンします。Bitium　ポータルが表示されます。
Bitium Single Sign-On

  • その他 – 汎用 SAML　ID プロバイダー設定。Kore.ai ビルトイン設定を使用していない場合は、このオプションを選択します。
    • シングル　サインオンの URL – WS-フェデレーション ID プロバイダーを使用して、Kore.ai がサインオンおよびサインオフ　リクエストを送信する URL。これは SAML フローを開始したサービス　プロバイダーを有効にします。
    • 発行者の URL – Active Directory の認証に使用される WS-フェデレーションのメタデータドキュメントの URL。
    • 証明書 – ユーザー署名の検証に使用される ID プロバイダーからサービス プロバイダーが保存する公開証明書。複数（最大2つ）の証明書を追加したり、既に追加されている無効な証明書を削除したりすることができます。プラットフォームは最新の証明書を認証に使用しますが、それが無効な場合は古い証明書が使用されます。
    • SP が開始した SAML フローの ACS URL – これは サービスプロバイダーが開始した SAML フロー用の転送 URL です。
    • IDP が開始した SAML フローの ACS URL – これは ID プロバイダーが開始した SAML　フロー用のアカウント固有の URL です。
  • シングル サインオン プロバイダーの管理コンソールでは、Kore.ai と SSO プロバイダー間のデータ交換に使用される URL も定義する必要があります。SSO プロバイダーによって URL 名が異なる場合がありますが、これらの URL を定義する必要があります。
    • アサーション コンシューマー サービス（ACS）の URL または https://idp.kore.ai/authorize/callback としての コールバック URL。
    • ADFS　を使用する際には、認証値に加えて、ユーザーの電子メール アドレスを　Active Directory　から　LDAP　属性として渡す必要があります。詳細については、ADFS の属性を参照してください。.
    • https://idp.kore.ai としての ID の URL または サインオン URL
  • [保存]をクリックします。

 

ID プロバイダー情報が正常に更新されましたメッセージが、ページの上部に表示されます。

ADFSの属性 ADFS 用の LDAP を使用してシングル サインオンを設定する場合、認証属性に加えて、サード パーティの SSO プロバイダーは、アサーション　コンシューマー　サービス（ACS）URL またはコールバック URL を通じて、Kore.ai に追加の属性を送信することができます。WS-フェデレーション プロトコルのWindows Azureや SAML プロトコルのOneLoginなど、SSO に内蔵された Kore.ai アプリを使用している場合、SSO プロバイダーの管理コンソールに Kore.ai アプリを追加すると、必要な属性がすでに Kore.ai に設定されます。以下のデータは、コールバック　URL　で　Kore.ai　に渡される属性データの一例です。

<Attribute Name="FirstName" NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:uri" FriendlyName="First Name"> <AttributeValue>Michael</AttributeValue> </Attribute> <Attribute Name="LastName" NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:uri" FriendlyName="Last Name"> <AttributeValue>Mehra</AttributeValue> </Attribute> <Attribute Name="DisplayName" NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:uri" FriendlyName="Display Name"> <AttributeValue>Michael Mehra</AttributeValue> </Attribute> <Attribute Name="EmailAddress" NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:uri" FriendlyName="Email"> <AttributeValue>michael.mehra@acme.com</AttributeValue> </Attribute>

これらの属性は、必須である EmailAddress 以外はオプションです。Email Address 属性は、以下の nameId 形式を使用します。

SAML 2.0: NameID Format="urn:oasis:names:tc:SAML:2.0:attrname-format:uri" SAML 1.1: NameID Format="urn:oasis:names:tc:SAML:1.1:nameid:format:emailAddress

ADFSでの属性のマッピング ADFSは、Microsoft が Windows サーバーの標準ロールとして提供しているサービスで、既存の Active Directory の認証情報を使用してウェブ ログインを提供します。SAML　または　WS-フェデレーション　プロトコルを使用して　ADFS　でログオンする際には、認証値に加えて他の値を渡すことができます。この属性値は、SQL サーバー管理コンソールの依拠当事者の信頼ダイアログでクレームルールとして定義されます。[クレーム ルール] を編集するには、[ADFS 管理] の[依拠当事者の信託] フォルダを選択して、[アクション] サイドバーの[クレーム　ルールの編集]をクリックします。新しいルールを追加するには、[ルールの追加]をクリックして、[LDAP 属性の送信] テンプレートを選択します。以下のマッピング値を入力します。

  • SAML 2.0
    • LDAP 属性: nameId
    • クレーム属性: uri
  • SAML 1.1
    • LDAP 属性: nameId
    • クレーム属性: emailAddress

SSO の代わりに管理者パスワードを使ってログオンする

Bot　管理者として、Google　などのサードパーティのセキュリティ　システムを使用してシングル　サインオン（SSO）を有効にすることができます。何らかの理由で SSO セキュリティ システムに障害が発生した場合や、サードパーティのセキュリティ システムの SSO ログオン認証情報を忘れてしまった場合でも、Kore.ai Bot 管理者コンソールにログオンして SSO をバイパスすることができます。カスタム管理ロールを持つBot 管理者は、少なくとも1つのモジュールでカスタム権限が有効になっている場合のみ、SSOをバイパスして管理者パスワードを使用することができます。Kore.ai ディレクトリ エージェントにログオンするには、カスタム管理者は[登録 – ディレクトリの同期]の権限を有効にする必要があります。SSO を有効にする前に、Bot 管理者は、サインアップ時に提供されたログオン認証情報を使用してBot 管理コンソールにログオンしている必要があります。Bot 管理者が SSO を設定して有効にした後も、以下の URL で直接 Bot 管理コンソールにアクセスすることができます。

https://bots.kore.ai/admin

次のようなログオン ページが表示され、Bot 管理者のパスワード認証情報を使用して、Bot 管理者 コンソールにログオンし、SSO が有効な場合は SSO をバイパスすることができます。パスワードを使って　SSO　なしで　Bot　管理コンソールにログオンする Bot 管理者のパスワードが思い出せない場合は、メール ID を入力して、前の画像にある[パスワードをお忘れですか？]リンクをクリックします。Bot 管理者のパスワードをリセットする方法が記載されたメールが、Kore.ai のメールアカウントに送信されます。

ログオフ

Bot 管理者 コンソールでのセッションが終了したら、Bot アカウントを安全に保つために、コンソールをログオフしてセッションを閉じます。ログオフするには、次の図に示すように、[ユーザー名]をクリックして、[ログアウト]をクリックします。Bot 管理者コンソールからログオフ Bot 管理コンソールのセッションが15分以上アイドル状態になると、セッションは自動的に終了し、セッション ウィンドウの次のアクションでは、代わりに Kore.ai のウェブ クライアントが開きます。新しいセッションを開始するには、[Bot 管理コンソール]entadminsettingsiconアイコンをクリックして、ログオンします。

Using Single Sign-On

On the Kore.ai Single Sign-On page, in the Security & Control module of the Bots Admin Console, you can configure Single Sign-On (SSO) authentication for your Kore.ai managed users using the following:

  • OpenID Connect
  • Security Assertion Markup Language (SAML)
  • WS-Federation sign-on protocol.

SSO enables easy access to the Kore.ai application using your existing identity provider. With SSO, your users can log on once, for example, to your company account, and when accessing their Kore.ai application, the same login credentials can be used automatically by the system.

For example, using the WS-Federation sign-on protocol, you can enable a user to sign on to the Kore.ai application using Microsoft® Active Directory® server credentials.

The following illustration shows the Single Sign-On page in the Bots Admin Console Security & Control module.

Enable or Disable SSO

Depending on the security required for your company, you can enable or disable Single Sign-On (SSO) for users accessing the Kore.ai application.

When you disable SSO or when the SSO authentication validity period expires, users must create and log on using their credentials. If no account specific password policies have been defined, then default Kore.ai password policies are automatically enabled for the users.

To enable Single Sign-On

  • In the Security & Control module, on the Single Sign On page, click Enable SSO.Enable SSO

To disable Single Sign-On

  • In the Security & Control module, on the Single Sign On page, click Disable SSO, and then configure user password policies.Disable SSO

OpenID Connect

Complete the steps in the following procedure to configure SSO using Open ID Connect protocol in the Security & Control module of the Bots Admin Console. Kore.ai also supports WS-Federation and SAML Connect protocols.

  1. In the Security & Control module on the Single Sign On page in the Bots Admin Console, click Enable SSO.
  2. In the Select suitable Sign-On Protocol section, select OpenID Connect.
  3. In the Configure SSO for OpenID Connect section, select an identity provider, for example, Sign in with Google.
  4. Click Save.
  5. The Identity Provider information successfully updated message is displayed at the top of the page.

WS-Federation

Complete the steps in the following procedure to configure Single Sign-On (SSO) using the WS-Federation protocol in the Security & Control module of the Bots Admin Console.

  1. In the Security & Control module on the Single Sign On page in the Bots Admin Console, click Enable SSO.
  2. In the Select suitable Sign-On Protocol section, select WS-Federation.
  3. In the Configure SSO for WS-Federation section, select an identity provider, and then define the settings for:
    • Windows Azure®
      • Azure AD Sign-On End Point URL – The URL that Kore.ai sends sign on and sign off requests using Azure. The response for the authentication is sent to the Reply URL defined in your Azure Active Directory configuration settings.
      • Azure AD Federation Metadata Document – The URL for the federation metadata document used for authentication with Azure Active Directory.
    • Other – Generic WS-Federation identity provider configuration, other than Azure
      • AD Sign-On End Point URL – The URL that Kore.ai sends sign on and sign off requests using your WS-Federation identity provider.
      • AD Federation Metadata Document URL – The URL for the WS-Federation metadata document used for authentication with Active Directory.

  4. In the administrative console for your Single Sign-On provider, you will also need to define the URLs that are used to exchange data between Kore.ai and your SSO provider. While the URL names may vary by SSO provider, you will need to define these URLs:

    • SAML 2.0
      • LDAP Attribute: nameId
      • Claim Attribute: uri
    • SAML 1.1
      • LDAP Attribute: nameId
      • Claim Attribute: emailAddress
    • Assertion Consumer Service (ACS) URL or Callback URL as https://idp.kore.ai/authorize/callback.
    • In addition to authentication values, you must pass the email address of the user as an LDAP attribute from Active Directory when using ADFS. For more information, see Attributes for ADFS.
    • Click Save.

The Identity Provider information successfully updated message is displayed at the top of the page.

SAML

Security Assertion Markup Language (SAML) is a standard protocol for web browser Single Sign-On (SSO) using secure tokens. SAML completely eliminates all passwords and instead uses standard cryptography and digital signatures to pass a secure sign-in token from an identity provider to a SaaS application.

SAML provides a solution to allow your identity provider and service providers to exist separately from each other. When a user logs into a SAML-enabled application, the service provider requests authorization from the appropriate identity provider. The identity provider authenticates the user’s credentials and then returns the authorization for the user to the service provider, and the user is now able to use the application.

How SAML works

SAML SSO works by transferring the user’s identity from one place (the identity provider) to another (the service provider). This is done through an exchange of digitally signed XML documents.

Consider the following scenario: A user is logged into a system that acts as an identity provider. The user wants to log in to a remote application, such as a support or accounting application (the service provider). The following happens:

  1. The user accesses the remote application using a link on an intranet, a bookmark, or similar and the application loads.
  2. The application identifies the user’s origin (by application subdomain, user IP address, or similar) and redirects the user back to the identity provider, asking for authentication. This is the authentication request.
  3. The user either has an existing active browser session with the identity provider or establishes one by logging into the identity provider.
  4. The identity provider builds the authentication response in the form of an XML-document containing the user’s username or email address, signs it using an X.509 certificate, and posts this information to the service provider.
  5. The service provider, which already knows the identity provider and has a certificate fingerprint, retrieves the authentication response and validates it using the certificate fingerprint.
  6. The identity of the user is established and the user is provided with app access.

Kore.ai Implementation

There are two ways SAML can be used within Kore.ai Bots Platform:

  • For developer authentication to access the Bot Builder,
  • For user authentication to access the Bot.

Use case 1: Bot builder authentication.

Enterprises can set up access to the Bot builder tool using the enterprise SSO. Bot developers and admins can log into bot builder using SSO done by the enterprise identity provider.

SSO flow from Kore.ai Bots platform: The following is the flow within the Kore.ai Bots platform once SSO is configured using SAML:

  1. The client makes a call to Kore app server (using the login URL) with user details to get identity provider info (SAML).
  2. Kore app server initiates a handshake request with the Kore idproxy server.
  3. Kore idproxy server initiates a request to the identity provider (SAML) with user details.
  4. On successful authentication, the identity provider (SAML) returns an assertion response to the Kore idproxy server.
  5. Upon verifying the response from the identity provider, Kore idproxy server initiates a request to the Kore app server.
  6. On successful authentication of the token from Kore idproxy server, Kore app server grants access to the user.

Post v7.2 release, Kore.ai supports the IDP initiated flow, wherein the platform gets the postback directly with SAML response and is able to validate the assertion and register/identify the user. The configuration for these modes – SP-based and IDP-based flow is different and is highlighted in the configuration steps below.

Refer below to configure SSO using SAML

Use case 2: End-user authentication

In this scenario, the bot chat interface is embedded on the customer portal or Mobile app that requires user authentication via SSO.  
The Bot access is automatically limited to authenticated users.  If the task requires API invocation that requires SSO based authentication the developer can follow the below steps

  • On the client, developer needs to retrieve SSO token of the logged in user and pass it to the bot using the secureCustomPayload parameter in the Bot SDK API.
  • In the dialog task, Bot developer can write custom logic to read this token and add it as API headers for secure API calls made using service node or webhook node.

The token information on the client varies depending upon the SSO provider and the payload, accordingly the developer would need to write custom logic.

Configuring SSO using SAML

Complete the following steps to configure Single Sign-On (SSO) using Security Assertion Markup Language (SAML) protocol in the Kore.ai Bots Admin Console. Kore.ai also supports WS-Federation and OpenID Connect protocols. For more information, see Using Single Sign-On.

  1. In the Security & Control module on the Single Sign On page in the Bots Admin Console, click Enable SSO.
  2. In the Select a suitable Sign-On Protocol section, select SAML.
  3. In the Configure SSO for SAML section, select an identity provider, and then define the settings for one of:
    • Okta –
      • Okta Single Sign-On URL – The SSO URL for Okta this is to enable Service Provider initiated SAML flow.
      • Identity Provider Issuer – The entity that provides the user identities including the ability to authenticate a user.
      • Certificate – The public certificate stored by the service provider from the identity provider used to validate a user signature. You can add multiple (max of 2) certificates, delete already added invalid certificates, platform will use the latest certificate for authorization, in case it is invalid then the older certificate would be used.
      • ACS URL for SP Initiated SAML Flow – This is the redirect URL for Service Provided initiated SAML flow.
      • ACS URL for IDP Initiated SAML Flow – This is the account-specific URL for Identity Provided initiated SAML flow.
      • SAML Attribute Mapping – Enable this option to map SAML Attributes with Kore.ai Group Names or Admin Roles Names. Once enabled, you can:
        • define how the SAML attributes should be mapped with Kore.ai attributes:
          • Full Sync – Every time the user signs in, the platform will update the user’s Group and Role assignments based on the SAML Attributes present in the response. All existing assignments will be removed. Only the new group or role assignments as available in the SAML response will be assigned
          • Inclusion Only – Every time the user signs in, the platform will only assign the new group or roles available in the SAML response. All existing assignments will be retained. New assignments will be added as available in the SAML responses
        • define one or more mapping pairs. Each pair includes
          • SAML Attribute Name – Name of the SAML attribute as available in the SAML response
          • SAML Attribute Value – Value associated with the SAML attribute
          • Attribute Type – Refers to the type of mapping to be associated i.e. Group Name or Role Name
            • Group Name – Refers to any of the user groups defined in the Kore.ai account
            • Role Name – Refers to the following
            • Admin Roles defined in the Kore.ai account
            • Bot Builder Access
            • New Bot Creation
            • Manage Data Tables and Views
          • Kore.ai Attribute – Refers to either Group Name or Role Name. The list should include the following:
            • List of all Admin Roles
            • Bot Builder Access
            • New Bot Creation
            • Manage Data Tables and Views
        Okta for Kore.ai SSO

        To configure Single Sign-On in Okta for Kore.ai, you must first add the Kore.ai app to your Okta account, and then copy URLs and the security certificate from Okta into your Kore.ai account. This topic describes how to add the Kore.ai app to your Okta account, and then access the URLs and certificate needed for the Kore.ai configuration for SSO using Okta.
        To complete this procedure, you must have already selected Okta as a SAML provider on the Single Sign On page in the Bots Admin Console.
        To add the Kore.ai app to Okta

        1. Log on to Okta.
        2. On the Home page, click Admin. The Dashboard page is displayed.
        3. On the top navigation bar, click Applications. The Applications page is displayed.
        4. Click Add Application. The Add Application page is displayed.
        5. Click Create application
        6. In the General settings, provide an App name and click Next.
        7. In Configure SAML, provide the Single SignOn URL. To obtain this:
          • Login to Kore.ai Bot Builder Admin Console
          • under Security & Control -> Single Sign on page
          • after enabling SAML and selecting Okta
          • ACS URL for SP Initiated SAML Flow field would contain the required URL
        8. And in the Audience URI field, enter https://idp.kore.com
        9. Note: For on-prem accounts, the ACS URL for SP Initiated SAML Flow is displayed as https://idproxy-dev.kore.com/authorize/callback . This needs to be updated as “single sign on URL” in Okta platform and https://idproxy-dev.kore.com needs to be updated as the “Audience URL”
        10. You can provide the Attribute statements like emailId, firstName as per your requirement.
        11. Click Finish.
      • On the Sign On tab, in the Settings section, click View Setup Instructions. The How to Configure SAML 2.0 for <app-name> Application page is displayed.
      • Copy the URLs in the:
        • Identity Provider Single Sign-On URL field to the Okta Single Sign-On URL field in Kore.ai.
        • Identity Provider Issuer field to the Kore.ai Identity provider issuer field
      • In the Okta X.509 Certificate field, copy the certificate data, and then paste the data into the Kore.ai Certificate text box.

        Note: Only data after the —–BEGIN CERTIFICATE—– header and before the —–END CERTIFICATE—- footer should be copied and pasted into Kore.ai.

  • In Kore.ai, click Save. This will complete the integration of Okta login.

The Identity Provider information successfully updated message is displayed at the top of the page. To test the configuration, log off the Kore.ai Bots Admin Console, and log on again. The Okta portal should be displayed.

  • OneLogin – For more information, refer below, or in the OneLogin documentation, see Configuring SSO for Kore.ai.
    • SAML 2.0 Endpoint – The HTTP SSO endpoint for OneLogin to enable Service Provider initiated SAML flow, for example, https://app.onelogin.com/trust/saml2/http-post/sso/358111.
    • Issuer URL – The URL for the OneLogin issuer, for example,https://app.onelogin.com/saml/metadata/358111.
    • X.509 Certificate – The public certificate stored by the service provider from the identity provider used to validate a user signature. You can add multiple (max of 2) certificates, delete already added invalid certificates, platform will use the latest certificate for authorization, in case it is invalid then the older certificate would be used.
    • ACS URL for SP Initiated SAML Flow – This is the redirect URL for Service Provided initiated SAML flow.
    • ACS URL for IDP Initiated SAML Flow – This is the account-specific URL for Identity Provided initiated SAML flow.
    • SAML Attribute Mapping – Enable this option to map SAML Attributes with Kore.ai Group Names or Admin Roles Names. Once enabled, you can:
      • define how the SAML attributes should be mapped with Kore.ai attributes:
        • Full Sync – Every time the user signs in, the platform will update the user’s Group and Role assignments based on the SAML Attributes present in the response. All existing assignments will be removed. Only the new group or role assignments as available in the SAML response will be assigned
        • Inclusion Only – Every time the user signs in, the platform will only assign the new group or roles available in the SAML response. All existing assignments will be retained. New assignments will be added as available in the SAML responses
      • define one or more mapping pairs. Each pair includes
        • SAML Attribute Name – Name of the SAML attribute as available in the SAML response
        • SAML Attribute Value – Value associated with the SAML attribute
        • Attribute Type – Refers to the type of mapping to be associated i.e. Group Name or Role Name
          • Group Name – Refers to any of the user groups defined in the Kore.ai account
          • Role Name – Refers to the following
          • Admin Roles defined in the Kore.ai account
          • Bot Builder Access
          • New Bot Creation
          • Manage Data Tables and Views
        • Kore.ai Attribute – Refers to either Group Name or Role Name. The list should include the following:
          • List of all Admin Roles
          • Bot Builder Access
          • New Bot Creation
          • Manage Data Tables and Views
      OneLogin for Kore.ai SSO

      To configure Single Sign-On in Kore.ai using OneLogin, you must first add the Kore.ai app to your OneLogin account, and then copy URLs and the security certificate from OneLogin into your Kore.ai account. This topic describes how to add the Kore.ai app to your OneLogin account, and then access the URLs and certificate needed for the Kore.ai configuration for SSO using OneLogin.
      To complete this procedure, you must have already selected OneLogin as a SAML provider on the Single Sign On page in the Bots Admin Console.
      To add the Kore.ai app to OneLogin

      1. Log on to OneLogin.
      2. On the APPS menu, click Add Apps. The Find Applications page is displayed.
      3. In the Search field, enter Kore.ai, and then press Enter. The Kore.ai app for OneLogin is displayed.
      4. Click the Kore.ai app. The Add Kore.ai page is displayed.
      5. Optionally, change the display name or the icons displayed to your users in the OneLogin portal, and then click SAVE. The Kore.ai app is added to your Company apps for OneLogin and the Kore.ai app page is displayed.
      6. On the SSO tab, in the Enable SAML2.0 section, copy the URLs in the:
        • OneLogin SAML 2.0 Endpoint (HTTP) field to the Kore.ai SAML 2.0 Endpoint field
        • OneLogin Issuer URL field to the Kore.ai Issuer URL field
      7. In the OneLogin X.509 Certificate field, click View Details. The Standard Strength Certificate (2048-bit) page is displayed.
      8. In the X.509 Certificate section, copy the certificate data, and then paste the data into the Kore.ai X.509 Certificate text box.

        Note: Only data after the —–BEGIN CERTIFICATE—–header and before the —–END CERTIFICATE—- footer should be copied and pasted into Kore.ai.

      9. In Kore.ai, click Save.

      The Identity Provider information successfully updated message is displayed at the top of the page. To test the configuration, log off the Kore.ai Bots Admin Console, and log on again. The OneLogin portal should be displayed.
      OneLogin Single Sign-On

    • Bitium –
      • Single Sign-On URL – The HTTP SSO endpoint for Bitium to enable Service Provider intiated SAML flow, for example, https://www.bitium.com/7655.
      • Issuer URL – The URL for the OneLogin issuer, for example,https://bitium.com/7655/saml/82456/metadata.xml.
      • Certificate – The public certificate stored by the service provider from the identity provider used to validate a user signature. You can add multiple (max of 2) certificates, delete already added invalid certificates, platform will use the latest certificate for authorization, in case it is invalid then the older certificate would be used.
      • ACS URL for SP Initiated SAML Flow – This is the redirect URL for Service Provided initiated SAML flow.
      • ACS URL for IDP Initiated SAML Flow – This is the account-specific URL for Identity Provided initiated SAML flow.
      • SAML Attribute Mapping – Enable this option to map SAML Attributes with Kore.ai Group Names or Admin Roles Names. Once enabled, you can:
        • define how the SAML attributes should be mapped with Kore.ai attributes:
          • Full Sync – Every time the user signs in, the platform will update the user’s Group and Role assignments based on the SAML Attributes present in the response. All existing assignments will be removed. Only the new group or role assignments as available in the SAML response will be assigned
          • Inclusion Only – Every time the user signs in, the platform will only assign the new group or roles available in the SAML response. All existing assignments will be retained. New assignments will be added as available in the SAML responses
        • define one or more mapping pairs. Each pair includes
          • SAML Attribute Name – Name of the SAML attribute as available in the SAML response
          • SAML Attribute Value – Value associated with the SAML attribute
          • Attribute Type – Refers to the type of mapping to be associated i.e. Group Name or Role Name
            • Group Name – Refers to any of the user groups defined in the Kore.ai account
            • Role Name – Refers to the following
            • Admin Roles defined in the Kore.ai account
            • Bot Builder Access
            • New Bot Creation
            • Manage Data Tables and Views
          • Kore.ai Attribute – Refers to either Group Name or Role Name. The list should include the following:
            • List of all Admin Roles
            • Bot Builder Access
            • New Bot Creation
            • Manage Data Tables and Views
        Kore.ai SSO for Bitium

        To configure Single Sign-On in Bitium for Kore.ai, you must first add the Kore.ai app to your Bitium account, and then copy URLs and the security certificate from Bitium into your Kore.ai account. This topic describes how to add the Kore.ai app to your Bitium account, and then access the URLs and certificate needed for the Kore.ai configuration for SSO using Bitium.
        To complete this procedure, you must have already selected Bitium as a SAML provider on the Single Sign On page in the Bots Admin Console.
        To add the Kore.ai app to Bitium

        1. Log on to Bitium.
        2. On the Manage < Company Name > menu, click Manage Apps, then click Add an App. The Add Apps dialog is displayed.
        3. In the Search field, enter Kore.ai, and then press Enter. The Install Kore.ai app for Bitium  dialog is displayed.
        4. On the Manage Organization menu, click Manage Apps, and then click Kore.ai.
        5. On the Single Sign-On tab, in the Select a Single Sign-On Provider section, select SAML Authentication.
        6. Copy the following URLs from Bitium into the Bots Admin Console Bitium configuration section:
          • Bitium Login URL field to the Kore.ai Single Sign-On field
          • Bitium Logout URL field to the Kore.ai Issuer URL field
        7. In the Bitium X.509 Certificate field, copy the certificate data, and then paste the data into the Bots Admin Console Certificate text box.

          Note: Only data after the —–BEGIN CERTIFICATE—– header and before the —–END CERTIFICATE—- footer should be copied and pasted into Kore.ai.

        8. In Kore.ai, click Save.

        The Identity Provider information successfully updated message is displayed at the top of the page. To test the configuration, log off the Kore.ai Bots Admin Console, and log on again. The Bitium portal should be displayed.
        Bitium Single Sign-On

      • Other – Generic SAML identity provider configuration. Select this option if you are not using a Kore.ai built-in configuration.
        • Single Sign-On URL – The URL that Kore.ai sends sign on and sign off requests using your WS-Federation identity provider. This is to enable Service Provider initiated SAML flow.
        • Issuer URL – The URL for the WS-Federation metadata document used for authentication with Active Directory.
        • Certificate – The public certificate stored by the service provider from the identity provider used to validate a user signature. You can add multiple (max of 2) certificates, delete already added invalid certificates, platform will use the latest certificate for authorization, in case it is invalid then the older certificate would be used.
        • ACS URL for SP Initiated SAML Flow – This is the redirect URL for Service Provided initiated SAML flow.
        • ACS URL for IDP Initiated SAML Flow – This is the account-specific URL for Identity Provided initiated SAML flow.
        • SAML Attribute Mapping – Enable this option to map SAML Attributes with Kore.ai Group Names or Admin Roles Names. Once enabled, you can:
          • define how the SAML attributes should be mapped with Kore.ai attributes:
            • Full Sync – Every time the user signs in, the platform will update the user’s Group and Role assignments based on the SAML Attributes present in the response. All existing assignments will be removed. Only the new group or role assignments as available in the SAML response will be assigned
            • Inclusion Only – Every time the user signs in, the platform will only assign the new group or roles available in the SAML response. All existing assignments will be retained. New assignments will be added as available in the SAML responses
          • define one or more mapping pairs. Each pair includes
            • SAML Attribute Name – Name of the SAML attribute as available in the SAML response
            • SAML Attribute Value – Value associated with the SAML attribute
            • Attribute Type – Refers to the type of mapping to be associated i.e. Group Name or Role Name
              • Group Name – Refers to any of the user groups defined in the Kore.ai account
              • Role Name – Refers to the following
              • Admin Roles defined in the Kore.ai account
              • Bot Builder Access
              • New Bot Creation
              • Manage Data Tables and Views
            • Kore.ai Attribute – Refers to either Group Name or Role Name. The list should include the following:
              • List of all Admin Roles
              • Bot Builder Access
              • New Bot Creation
              • Manage Data Tables and Views
          • In the administrative console for your Single Sign-On provider, you will also need to define the URLs that are used to exchange data between Kore.ai and your SSO provider. While the URL names may vary by SSO provider, you will need to define these URLs:
            • Assertion Consumer Service (ACS) URL or Callback URL as https://idp.kore.ai/authorize/callback.
            • In addition to authentication values, you must pass the email address of the user as an LDAP attribute from Active Directory when using ADFS. For more information, see Attributes for ADFS.
            • Identity URL or Sign On URL as https://idp.kore.ai
        • Click Save.

        The Identity Provider information successfully updated message is displayed at the top of the page.

Attributes for ADFS
When you configure Single Sign-On using LDAP for ADFS, in addition to authentication attributes, your third-party SSO provider can send additional attributes to Kore.ai through the Assertion Consumer Service (ACS) URL or Callback URL.

If you are using a built-in Kore.ai app for SSO, such as Windows Azure for WS-Federation protocol, or OneLogin for SAML protocol, required attributes are already configured for Kore.ai when you add the Kore.ai app to your SSO provider admin console.

The following data is an example of attribute data passed to Kore.ai in the callback URL.

<Attribute Name="FirstName" NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:uri" FriendlyName="First Name">
<AttributeValue>Michael</AttributeValue>
</Attribute>
<Attribute Name="LastName" NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:uri" FriendlyName="Last Name">
<AttributeValue>Mehra</AttributeValue>
</Attribute>
<Attribute Name="DisplayName" NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:uri" FriendlyName="Display Name">
<AttributeValue>Michael Mehra</AttributeValue>
</Attribute>
<Attribute Name="EmailAddress" NameFormat="urn:oasis:names:tc:SAML:2.0:attrname-format:uri" FriendlyName="Email">
<AttributeValue>michael.mehra@acme.com</AttributeValue>
</Attribute>

These attributes are optional except for the EmailAddress, which is required. The Email Address attribute uses the following nameId format:

SAML 2.0:
NameID Format="urn:oasis:names:tc:SAML:2.0:attrname-format:uri"
SAML 1.1:
NameID Format="urn:oasis:names:tc:SAML:1.1:nameid:format:emailAddress

Mapping Attributes in ADFS

ADFS is a service provided by Microsoft as a standard role for Windows Server that provides a web login using existing Active Directory credentials. When using SAML or WS-Federation protocols to log on with ADFS, you can pass other values in addition to the authentication values.

The attribute values are defined as Claim Rules in the Relying Party Trust dialog in the SQL Server admin console. To edit the Claim Rules, select the Relying Party Trusts folder in ADFS Management, and then click Edit Claim Rules from the Actions sidebar. To add a new rule, click Add Rule, and then select the Send LDAP Attributes template. Enter the following mapping values:

  • SAML 2.0
    • LDAP Attribute: nameId
    • Claim Attribute: uri
  • SAML 1.1
    • LDAP Attribute: nameId
    • Claim Attribute: emailAddress

Logging On Using Your Admin Password Instead of SSO

As an Bots Admin, you can enable Single Sign-On (SSO) using a third-party security system, for example, Google. If for some reason, your SSO security system fails, or you forget your SSO log on credentials for your third-party security system, you can still log on to the Kore.ai Bots Admin Console and bypass SSO.

A Bots Admin with a custom admin role can only bypass SSO and use their admin password if custom privileges are enabled for at least one module. To log on to the Kore.ai Directory Agent, the custom admin must have privileges enabled for Enrollment – Directory Sync.

Before you can enable SSO, the Bots Admin must have logged on the Bots Admin Console using the log on credentials provided when signing up. After the Bots Admin configures and enables SSO, you can still access the Bots Admin Console directly at the following URL:

https://bots.kore.ai/admin

The following log on page is displayed and using your Bots Admin password credentials, you can log on to the Bots Admin Console and bypass SSO, if enabled.
Using Your Password to Log On to the Bots Admin Console without SSO
If you cannot remember your Bots Admin password, enter your email ID, and then click the Forgot your password? link shown in the previous image. An email is sent to your Kore.ai email account with instructions on how to reset your Bots Admin password.

Logging Off

When you are finished with your session with the Bots Admin Console, you should log off the console and close your session to keep your bots account secure. To log off, click on your user name, and then click Logout as shown in the following illustration.
Logging out of the Bots Admin Console
If your Bots Admin Console session is idle for more than 15 minutes, your session is automatically terminated, and the next action in the session window will open the Kore.ai web client instead. To start a new session, click the Bots Admin Console entadminsettingsicon icon and log on.