ポータブル 仮想エージェント Web クライアントの構成

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：3分

    • ポータブル Web クライアントは、サードパーティの Web ページ、サービスポータル、または UI ビルダー ポータルで実行できるチャットウィジェットです。

    ポータブル Web クライアントは、仮想エージェント チャットをページに簡単に追加できるようにする新しい Seismic コンポーネントです。構成を簡素化し、次の機能を提供します。
    • 簡単に構成可能
    • 簡素化されたシングルサインオン (SSO) 認証フロー
    • サービスポータル エージェントチャット への接続
    • システムパラメーターとコンテキスト変数は以前と同様に機能

    ポータブル仮想エージェント Web クライアントを使用するための前提条件

    ポータブル Web クライアントは、インラインフレーム要素 (iframe) を使用します。サードパーティの Web サイトは、ServiceNow® インスタンスと同じ親ドメインの下にある必要があります。たとえば、site1.company.com と site2.company.com は同じ親ドメインを共有しています。ServiceNow インスタンスと共有されていないサブドメインに Web クライアントを埋め込む場合は、URL をカスタムインスタンス URL にする必要があります。ブラウザのセキュリティ強化のため、カスタム URL を使用しないと Web クライアントのロードに失敗する場合があります。

    開始する前に、次の作業を行います。
    1. インスタンスでカスタム URL プラグイン (com.snc.customurl) をアクティブ化します。
    2. カスタム URL (以前に購入して登録したもの) をインスタンスに追加します。
    注:
    カスタム URL の使用法の詳細については、「インスタンスへのカスタム URL の関連付け」を参照してください。

    ポータブル仮想エージェント Web クライ アントでの SSO 認証の使用

    仮想エージェントクライアントを埋め込んだ後、オプションで Web クライアントから SSO 認証をトリガーできますが、これはインスタンスが外部 SSO プロバイダーを使用するように設定されている場合に限られます。ホスティングサイトでも、インスタンスと同じ SSO プロバイダーを使用する必要があります。SSO プロバイダーの設定の詳細については、「外部 Single Sign-on (SSO)」を参照してください。

    SSO 認証をトリガーするには、認証を実行するための条件を定義し、指定した Web クライアントページにユーザーをリダイレクトする JavaScript スクリプトを作成します。com.glide.cs.web_client_login_redirect_urls システムプロパティでそれらを識別することによって、このスクリプトで渡すことができる許可された URL を指定することもできます。完全なリダイレクト URL または URL のホスト部分 (https://example.com など) を指定します。

    この手順では、次の 2 つのシステムプロパティの値を設定する必要があります。
    • com.glide.cs.embed.csp_frame_ancestors
    • com.glide.cs.embed.xframe_options (IE 11 のみ)
    これらのプロパティは、埋め込み Web クライアントのセキュリティポリシー、つまり、Web チャットクライアントを埋め込む前に、iframe 内でブラウザが仮想エージェントおよびライブエージェントチャットの HTML コンテンツをレンダリングして保護する方法を決定します。指定する HTTP ヘッダーディレクティブは、クリックジャッキングの試行を軽減するために特定のドメインにページを埋め込むことができるかどうかをブラウザに指示します。両方のプロパティを設定すると、主要なブラウザと Internet Explorer などの古いブラウザのセキュリティディレクティブが確実に存在するようになります。
    注:
    Content Management System (CMS) アプリケーションを使用して Now Platform および ServiceNow® アプリケーションのカスタムインターフェイスを作成している場合は、仮想エージェントをサポートしていないことに注意してください。