---
sourceDocument: Xanadu 対話型インターフェース
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/conversational-interfaces

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu 対話型インターフェース

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

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

# ポータブル 仮想エージェント Web クライアントの構成 {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：3分

ポータブル Web クライアントは、サードパーティの Web ページ、サービスポータル、または UI ビルダー ポータルで実行できるチャットウィジェットです。
ポータブル Web クライアントは、仮想エージェント チャットをページに簡単に追加できるようにする新しい Seismic コンポーネントです。構成を簡素化し、次の機能を提供します。

* 簡単に構成可能
* 簡素化されたシングルサインオン (SSO) 認証フロー
* サービスポータル エージェントチャット への接続
* システムパラメーターとコンテキスト変数は以前と同様に機能
{#use-portable-va-web-client__ul_pl5_ndk_ktb}

## ポータブル仮想エージェント Web クライアントを使用するための前提条件 {#use-portable-va-web-client__section_q4m_3qp_r5b}

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

1. [インスタンスでカスタム URL プラグイン (com.snc.customurl) をアクティブ化します。](https://www.servicenow.com/docs/access?context=activate-custom-url-plugin&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US)
2. [カスタム URL (以前に購入して登録したもの) をインスタンスに追加します。](https://www.servicenow.com/docs/access?context=configure-custom-url&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US)
{#use-portable-va-web-client__ol_mtc_4kp_ktb}  
注:  
カスタム URL の使用法の詳細については、「[インスタンスへのカスタム URL の関連付け](https://www.servicenow.com/docs/access?context=custom-url&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US)」を参照してください。

## ポータブル仮想エージェント Web クライ アントでの SSO 認証の使用 {#use-portable-va-web-client__section_bbj_tsp_r5b}

仮想エージェントクライアントを埋め込んだ後、オプションで Web クライアントから SSO 認証をトリガーできますが、これはインスタンスが外部 SSO プロバイダーを使用するように設定されている場合に限られます。ホスティングサイトでも、インスタンスと同じ SSO プロバイダーを使用する必要があります。SSO プロバイダーの設定の詳細については、「[外部 Single Sign-on (SSO)](https://www.servicenow.com/docs/access?context=c_MultipleProviderSingleSignOn&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US)」を参照してください。

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

* com.glide.cs.embed.csp_frame_ancestors
* com.glide.cs.embed.xframe_options (IE 11 のみ)

{#use-portable-va-web-client__ul_awd_xsp_r5b}これらのプロパティは、埋め込み Web クライアントのセキュリティポリシー、つまり、Web チャットクライアントを埋め込む前に、iframe 内でブラウザが仮想エージェントおよびライブエージェントチャットの HTML コンテンツをレンダリングして保護する方法を決定します。指定する HTTP ヘッダーディレクティブは、クリックジャッキングの試行を軽減するために特定のドメインにページを埋め込むことができるかどうかをブラウザに指示します。両方のプロパティを設定すると、主要なブラウザと Internet Explorer などの古いブラウザのセキュリティディレクティブが確実に存在するようになります。  
注:  
Content Management System (CMS) アプリケーションを使用して Now Platform および ServiceNow® アプリケーションのカスタムインターフェイスを作成している場合は、仮想エージェントをサポートしていないことに注意してください。
* **[ポータブル仮想エージェント Web クライアントの構成](https://servicenow-prod.fluidtopics.net/5_gE8lIm7JoH~jUjXSBvFw)**   
  ポータブル Web クライアントのチャットウィジェットを構成して、サードパーティの Web ページで仮想エージェントを実行します。
* **[サードパーティ Web サイトにポータブル仮想エージェント Web クライアントを追加する](https://servicenow-prod.fluidtopics.net/KON4rqzYPo9UDGEIMOBdKA)**   
  サードパーティの Web ページで仮想エージェントのポータブル Web クライアントチャットウィジェットを使用するには、必要なコードを Web ページに追加します。
* **[仮想エージェント Web クライアントを外部 Web ページに埋め込む (従来の方法)](https://servicenow-prod.fluidtopics.net/4bSf9AT5NuAgv8wvBCOboQ)**   
  インラインフレーム要素 (iframe) を使用して、外部 Web ページに仮想エージェント Web クライアントインターフェイスを読み込みます。また、オプションで、シングルサインオン (SSO) 認証プロセスが、Web クライアントを使用するログインしていないゲストユーザーに対して自動的に実行されるようにすることもできます。

**関連タスク**   

* [ポータブル仮想エージェント Web クライアントの構成](https://servicenow-prod.fluidtopics.net/5_gE8lIm7JoH~jUjXSBvFw "ポータブル Web クライアントのチャットウィジェットを構成して、サードパーティの Web ページで仮想エージェントを実行します。")
* [サードパーティ Web サイトにポータブル仮想エージェント Web クライアントを追加する](https://servicenow-prod.fluidtopics.net/KON4rqzYPo9UDGEIMOBdKA "サードパーティの Web ページで仮想エージェントのポータブル Web クライアントチャットウィジェットを使用するには、必要なコードを Web ページに追加します。")