Konfigurieren des tragbaren Webclients Virtual Agent

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 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

    Voraussetzungen für die Verwendung des tragbaren Webclients Virtual Agent

    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.
    2. Fügen Sie die anwenderdefinierte URL (die Sie zuvor erworben und registriert haben) zu Ihrer -Instanz hinzu.
    Hinweis:
    Weitere Informationen zur Verwendung von anwenderdefinierten URLs finden Sie unter Ihrer Instanz anwenderdefinierte URLs zuordnen.

    SSO-Authentifizierung mit dem tragbaren Webclient Virtual Agent verwenden

    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).

    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. https://beispiel.com.

    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)
    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.