---
sourceDocument: Xanadu-Konversations-Schnittstellen
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/conversational-interfaces

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-Konversations-Schnittstellen

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# Konfigurieren des tragbaren Webclients Virtual Agent

# Konfigurieren des tragbaren Webclients Virtual Agent {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer

Der tragbare Webclient ist ein Chat-Widget, das auf Webseiten von Drittanbietern, im Serviceportal oder in Portalen von UI Builder ausgeführt werden kann.
Der tragbare Webclient ist eine neue Seismic-Komponente, mit der Sie Ihrer Seite ganz einfach den Chat Virtual Agent hinzufügen können. Er vereinfacht die Konfiguration und bietet die folgenden Funktionen:

* Einfach konfigurierbar
* Einfacherer SSO-Authentifizierungs-Flow (Single Sign-on).
* Stellen Sie eine Verbindung zum Serviceportal her Mitarbeiterchat
* Systemparameter und Kontextvariablen funktionieren genauso wie zuvor
{#use-portable-va-web-client__ul_pl5_ndk_ktb}

## Voraussetzungen für die Verwendung des tragbaren Webclients Virtual Agent {#use-portable-va-web-client__section_q4m_3qp_r5b}

Der tragbare Webclient verwendet ein Inline-Frame-Element (iframe). Die Drittanbieter-Website muss sich unter derselben übergeordneten Domäne wie Ihre -Instanz ServiceNow® befinden. Beispiel: Site1.company.com und Site2.company.com verwenden dieselbe übergeordnete Domäne. Wenn Sie den Webclient in eine Subdomäne einbetten, die nicht mit Ihrer Instanz ServiceNow geteilt wird, muss die URL eine anwenderdefinierte Instanz-URL sein. Aufgrund der erhöhten Browsersicherheit kann der Webclient möglicherweise nicht geladen werden, wenn Sie keine anwenderdefinierte URL verwenden.  
Bevor Sie beginnen, gehen Sie wie folgt vor:

1. [Aktivieren Sie das anwenderdefinierte URL-Plugin (com.snc.customurl) in Ihrer -Instanz.](https://www.servicenow.com/docs/access?context=activate-custom-url-plugin&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US)
2. [Fügen Sie die anwenderdefinierte URL (die Sie zuvor erworben und registriert haben) zu Ihrer -Instanz hinzu.](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}  
Hinweis:  
Weitere Informationen zur Verwendung von anwenderdefinierten URLs finden Sie [unter Ihrer Instanz anwenderdefinierte URLs zuordnen](https://www.servicenow.com/docs/access?context=custom-url&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US).

## SSO-Authentifizierung mit dem tragbaren Webclient Virtual Agent verwenden {#use-portable-va-web-client__section_bbj_tsp_r5b}

Nachdem Sie den Virtual Agent-Client eingebettet haben, können Sie die SSO-Authentifizierung optional über den Webclient auslösen, jedoch nur, wenn Ihre Instanz für die Verwendung eines externen SSO-Anbieters eingerichtet ist. Außerdem muss die Host Website denselben SSO-Provider wie Ihre Instanz verwenden. Weitere Informationen zum Festlegen von SSO-Anbietern finden Sie unter [Externes Single Sign-on (SSO)](https://www.servicenow.com/docs/access?context=c_MultipleProviderSingleSignOn&version=xanadu&pubname=xanadu-platform-security&ft:locale=en-US).

Um die SSO-Authentifizierung auszulösen, erstellen Sie ein JavaScript-Skript, das Bedingungen für die Ausführung der Authentifizierung definiert und Anwender zu einer von Ihnen angegebenen Webclient-Seite umleitet. Sie geben auch die zulässigen URLs an, die in diesem Skript übergeben werden können, indem Sie sie in der Systemeigenschaft com.glide.cs.web_client_login_redirect_urls angeben. Geben Sie die vollständigen Umleitungs-URLs oder den Host-Teil der URL an, z. B. <kbd class="ph userinput">https://beispiel.com</kbd>.  
Dieses Verfahren erfordert, dass Sie Werte für die folgenden beiden Systemeigenschaften festlegen:

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

{#use-portable-va-web-client__ul_awd_xsp_r5b}Diese Eigenschaften bestimmen die Sicherheitsrichtlinie für den eingebetteten Webclient, insbesondere wie Browser HTML-Inhalte für den Chat Virtual Agent und Service Desk-Mitarbeiter in einem iframe rendern und sichern, bevor Sie den Webchat-Client einbetten. Die von Ihnen angegebenen HTTP-Header-Richtlinien teilen dem Browser mit, ob eine Seite in bestimmten Domänen eingebettet werden kann, um Clickjacking-Versuche zu minimieren. Durch das Festlegen beider Eigenschaften wird sichergestellt, dass Sicherheitsrichtlinien für wichtige Browser und auch für ältere Browser wie Internet Explorer vorhanden sind.  
Hinweis:  
Wenn Sie die Anwendung Content Management System (CMS) verwenden, um anwenderdefinierte Schnittstellen für die Anwendungen Now Platform und ServiceNow® zu erstellen, beachten Sie, dass Virtual Agentnicht unterstützt wird.
* **[Konfigurieren Sie den tragbaren Webclient Virtual Agent .](https://servicenow-prod.fluidtopics.net/OLFa35TdCuauIVCndLx0iQ)**   
  Konfigurieren Sie das Chat-Widget des tragbaren Webclients für die Ausführung Virtual Agent auf Webseiten von Drittanbietern.
* **[Fügen Sie den tragbaren Webclient Virtual Agent einer Drittanbieter-Website hinzu](https://servicenow-prod.fluidtopics.net/PbpzY3W2aurnfN_2j~TzqQ)**   
  Um das Chat-Widget des tragbaren Webclients für Virtual Agent auf Webseiten von Drittanbietern zu verwenden, fügen Sie Ihrer Webseite den erforderlichen Code hinzu.
* **[Webclient Virtual Agent in eine externe Webseite einbetten (veraltet)](https://servicenow-prod.fluidtopics.net/iJcEs6V9ufzur5aJ0NSSaA)**   
  Laden Sie die Webclient-Schnittstelle Virtual Agent mithilfe eines Inline-Frame-Elements (iframe) in eine externe Webseite. Optional können Sie auch den Prozess der SSO-Authentifizierung (Single Sign-on) aktivieren, der für Gastbenutzer, die den Webclient verwenden und nicht angemeldet sind, automatisch ausgeführt wird.

**Zugehörige Tasks**   

* [Konfigurieren Sie den tragbaren Webclient Virtual Agent .](https://servicenow-prod.fluidtopics.net/OLFa35TdCuauIVCndLx0iQ "Konfigurieren Sie das Chat-Widget des tragbaren Webclients für die Ausführung Virtual Agent auf Webseiten von Drittanbietern.")
* [Fügen Sie den tragbaren Webclient Virtual Agent einer Drittanbieter-Website hinzu](https://servicenow-prod.fluidtopics.net/PbpzY3W2aurnfN_2j~TzqQ "Um das Chat-Widget des tragbaren Webclients für Virtual Agent auf Webseiten von Drittanbietern zu verwenden, fügen Sie Ihrer Webseite den erforderlichen Code hinzu.")