Konfigurieren des tragbaren Virtual Agent Webclients

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 2 Minuten Lesedauer

    • Der Portable Web Client ist ein Chat-Widget, das auf Webseiten von Drittanbietern, im Service Portal oder in UI Builder -Portalen ausgeführt werden kann.

    Der tragbare Webclient ist eine neue seismische Komponente, die das Hinzufügen von Virtual Agent Chat zu Ihrer Seite erleichtert. Sie vereinfacht die Konfiguration und bietet die folgenden Funktionen:
    • Einfach zu konfigurieren
    • Einfacherer SSO-Authentifizierungs-Flow (Single Sign-on).
    • Stellen Sie eine Verbindung zum Service Portal 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 ServiceNow® -Instanz befinden. Zum Beispiel teilen sich site1.company.com und site2.company.com dieselbe übergeordnete Domäne. Wenn Sie den Webclient in eine Subdomäne einbetten, die nicht mit Ihrer ServiceNow -Instanz geteilt wird, muss die URL eine benutzerdefinierte Instanz-URL sein. Aufgrund der erhöhten Browsersicherheit kann der Webclient möglicherweise nicht geladen werden, wenn Sie keine benutzerdefinierte URL verwenden.

    Bevor Sie beginnen, gehen Sie wie folgt vor:
    1. Aktivieren Sie das benutzerdefinierte URL-Plugin (com.snc.customurl) in Ihrer Instanz.
    2. Fügen Sie die benutzerdefinierte URL (die Sie zuvor erworben und registriert haben) zu Ihrer Instanz hinzu.
    Hinweis:
    Weitere Informationen zur Verwendung von benutzerdefinierten URLs finden Sie unter Benutzerdefinierte URLs zu Ihrer Instanz zuordnen.

    Verwenden der SSO-Authentifizierung mit dem tragbaren Virtual Agent Webclient

    Nachdem Sie den Virtual Agent-Client eingebettet haben, können Sie optional die SSO-Authentifizierung über den Webclient auslösen, jedoch nur, wenn Ihre Instanz für die Verwendung eines externen SSO-Providers eingerichtet ist. Außerdem muss die Host Website denselben SSO-Provider wie Ihre Instanz verwenden. Weitere Informationen zum Festlegen von SSO-Providern 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 Benutzer 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://example.com.

    Für dieses Verfahren müssen 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, d. h. wie Browser HTML-Inhalte für Virtual Agent und Service Desk-Mitarbeiter Chat in einem IFrame rendern und sichern, bevor Sie den Webchat-Client einbetten. Die von Ihnen angegebenen HTTP-Header-Anweisungen teilen dem Browser mit, ob eine Seite in bestimmten Domänen eingebettet werden kann, um Clickjacking-Versuche abzuschwächen. Durch das Festlegen beider Eigenschaften wird sichergestellt, dass Sicherheitsrichtlinien für die wichtigsten Browser und auch für ältere Browser wie Internet Explorer vorhanden sind.
    Hinweis:
    Wenn Sie die Anwendung Content Management System (CMS) verwenden, um benutzerdefinierte Schnittstellen für die Anwendungen Now Platform und ServiceNow® zu erstellen, beachten Sie, dass sie Virtual Agentnicht unterstützt.