Proxyserver bereitstellen

In diesem Leitfaden werden die Schritte beschrieben, die zum Einrichten eines Proxyservers erforderlich sind. Sie verwenden den Proxyserver in Verbindung mit einem Anwendungsserver, um die Authentifizierung bei der Dialogflow API zu vereinfachen. Eine Anleitung zum Rendern der UI-Module im Agent-Arbeitsbereich finden Sie auf der Hauptseite des LivePerson-Tutorials. Sie benötigen sowohl einen Anwendungsserver als auch einen Proxyserver im selben Verzeichnis, bevor Sie die Module in LivePerson rendern können.

Diese Integration kann auf jeder Hostingplattform eingerichtet werden. In dieser Anleitung wird jedoch Cloud Run von Google verwendet.

Hinweise

Bevor Sie mit diesem Tutorial beginnen, müssen Sie den Anwendungsserver bereitgestellt haben.

Konfiguration

Wenn Sie den Dienst bereitstellen, müssen Sie die folgenden Umgebungsvariablen definieren. Lassen Sie die Variablen LP_CLIENT_ID und LP_CLIENT_SECRET leer, wenn Sie den Anwendungsserver zum ersten Mal erstellen. LivePerson stellt diese Variablen bereit, wenn Sie eine Conversational Cloud-Anwendung erstellen, und Sie aktualisieren sie dann. Sie überspringen APPLICATION_SERVER_URL und DF_PROXY_SERVER_URL zunächst und legen beide fest, nachdem die Anwendungs- und Proxyserver bereitgestellt wurden und die erforderlichen Werte zurückgegeben haben.

  • LP_ACCOUNT_ID: LivePerson-Konto-ID.
  • LP_CLIENT_ID: Ihre LivePerson-Client-ID. Diese wird von LivePerson bereitgestellt, sobald die Conversational Cloud-Anwendung installiert wurde. Überspringen Sie diese Variable vorerst. Sie wird aktualisiert, sobald die Informationen bereitgestellt wurden.
  • LP_CLIENT_SECRET: Ihr LivePerson-Clientschlüssel. Diese wird von LivePerson bereitgestellt, sobald die Conversational Cloud-Anwendung installiert wurde. Überspringen Sie diese Variable vorerst. Sie wird aktualisiert, sobald die Informationen bereitgestellt wurden.
  • LP_SENTINEL_DOMAIN: Rufen Sie https://developers.liveperson.com/domain-api.html auf. Geben Sie Ihre Kontonummer ein und suchen Sie nach der Domain für „sentinel“.
  • LP_ACCOUNT_CONFIG_READONLY_DOMAIN: Rufen Sie https://developers.liveperson.com/domain-api.html auf. Geben Sie Ihre Kontonummer ein und suchen Sie nach der Domain für „accountConfigReadOnly“.
  • APPLICATION_SERVER_URL: URL des UI-Anwendungsservers.
  • JWT_SECRET: Eine „geheime“ Phrase, die zum Signieren der Authentifizierungstokens verwendet wird. Sie können einen beliebigen Begriff verwenden. Ein langes, zufälliges Secret ist jedoch am sichersten. Best Practices finden Sie unter https://fusionauth.io/learn/expert-advice/tokens/building-a-secure-jwt/#keys.

Beispieldatei .env:

    LP_ACCOUNT_ID = 12345678
    LP_CLIENT_ID = abc-123-f0f0
    LP_CLIENT_SECRET = abc123abc123abc123abc123
    LP_SENTINEL_DOMAIN = va.sentinel.liveperson.net
    LP_ACCOUNT_CONFIG_READONLY_DOMAIN = z1.acr.liveperson.net
    APPLICATION_SERVER_URL = https://my-project.wm.r.appspot.com
    JWT_SECRET = an_example_JWT_secret_phrase_please_use_something_better

Bereitstellen

Der UI-Anwendungsserver muss in einem Google Cloud-Hostingdienst bereitgestellt werden. Wir empfehlen die Verwendung von Google App Engine oder Cloud Run. In den folgenden Schritten wird Cloud Run als Beispiel verwendet.

Mit der Befehlszeile bereitstellen

Wechseln Sie in Ihrem lokalen Terminal in das Stammverzeichnis des Repositorys.

Führen Sie den folgenden Befehl aus, um den Status Ihres Repository in der Google Cloud Platform Container Registry zu speichern. Ersetzen Sie PROJECT-ID durch die ID Ihres Google Cloud-Projekts.

    gcloud builds submit --tag gcr.io/PROJECT-ID/agent-assist-modules-proxy-server

Stellen Sie Ihre Integration mit dem folgenden Befehl live bereit. Ersetzen Sie PROJECT-ID durch die Google Cloud-Projekt-ID Ihres Agents und SERVICE-ACCOUNT-EMAIL durch die Client-E-Mail-Adresse Ihres Dienstkontos.

    gcloud run deploy --image gcr.io/PROJECT-ID/agent-assist-modules-proxy-server --service-account=SERVICE-ACCOUNT-EMAIL --memory 1Gi --platform managed
  • Wenn Sie zur Eingabe einer Region aufgefordert werden, wählen Sie eine Region aus, z. B. us-central1.
  • Wenn Sie zur Eingabe eines Dienstnamens aufgefordert werden, drücken Sie die Eingabetaste, um den Standardwert zu übernehmen.
  • Wenn Sie aufgefordert werden, nicht authentifizierte Aufrufe zuzulassen, drücken Sie y.

Weitere Informationen finden Sie in der Cloud Run-Dokumentation. Eine Liste Ihrer aktiven Integrationsbereitstellungen finden Sie in der Google Cloud Console unter Cloud Run.

Umgebungsvariablen

Folgen Sie der Cloud Run-Anleitung, um die erforderlichen Umgebungsvariablen festzulegen.

Nachdem der Dienst bereitgestellt wurde, gibt die CLI die URL aus, unter der die Anwendung bereitgestellt wurde (target_url). Gehen Sie zurück und legen Sie mit diesem Wert die Umgebungsvariable DF_PROXY_SERVER_URL für den Anwendungsserver fest.

Proxyserver herunterfahren

Um den Anwendungsserver herunterzufahren, müssen Sie den Cloud Run-Dienst löschen.

Führen Sie in Ihrem lokalen Terminal den folgenden Befehl aus und wählen Sie die zuvor ausgewählte Zielplattform aus, um aktive Bereitstellungen aufzulisten:

    gcloud beta run services list

Führen Sie als Nächstes den folgenden Befehl aus:

    gcloud beta run services delete agent-assist-modules-proxy-server