In diesem Leitfaden werden die Schritte zur Einrichtung eines Proxyservers beschrieben. Sie verwenden den Proxyserver in Verbindung mit einem Anwendungsserver, um die Authentifizierung mit der Dialogflow API zu vereinfachen. Eine Anleitung zum Rendern der UI-Module im Kundenservicemitarbeiterbereich finden Sie auf der Hauptseite der LivePerson-Anleitung. Sowohl ein Anwendungsserver als auch ein Proxyserver im selben Verzeichnis sind erforderlich, damit 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
Der Anwendungsserver muss bereits bereitgestellt sein, bevor Sie mit dieser Anleitung beginnen.
Konfiguration
Wenn Sie den Dienst bereitstellen, müssen Sie die folgenden Umgebungsvariablen definieren.
Lassen Sie die Variablen LP_CLIENT_ID und LP_CLIENT_SECRET beim Erstellen des Anwendungsservers leer. Diese Variablen werden von LivePerson bereitgestellt, wenn Sie eine Conversational Cloud-Anwendung erstellen. Sie aktualisieren sie dann. Außerdem überspringen Sie APPLICATION_SERVER_URL und DF_PROXY_SERVER_URL. Legen Sie beide Werte fest, nachdem die Anwendung und die Proxyserver bereitgestellt und die erforderlichen Werte zurückgegeben wurden.
LP_ACCOUNT_ID: LivePerson-Konto-ID.LP_CLIENT_ID: Ihre LivePerson-Kundennummer. Diese wird von LivePerson bereitgestellt, sobald die Conversational Cloud-Anwendung installiert wurde. (Überspringen Sie diese Variable vorerst. Sie aktualisieren sie, sobald die Informationen vorliegen.)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 aktualisieren sie, sobald die Informationen vorliegen.)LP_SENTINEL_DOMAIN: Rufen Sie https://developers.liveperson.com/domain-api.html auf. Geben Sie Ihre Kontonummer ein und suchen Sie in der Domain nach „sentinel“.LP_ACCOUNT_CONFIG_READONLY_DOMAIN: Rufen Sie https://developers.liveperson.com/domain-api.html auf. Geben Sie Ihre Kontonummer ein und suchen Sie in der Domain nach „accountConfigReadOnly“.APPLICATION_SERVER_URL: URL des UI-Anwendungsservers.JWT_SECRET: Ein „geheimer“ Begriff, der zum Signieren der Authentifizierungstokens verwendet wird. Sie können eine beliebige Zeichenfolge verwenden. Am sichersten ist jedoch ein langes, zufälliges Secret. 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 der Google App Engine oder von Cloud Run. In den folgenden Schritten wird Cloud Run als Beispiel verwendet.
Mit der Befehlszeile bereitstellen
Ändern Sie im lokalen Terminal das aktive Verzeichnis in das Stammverzeichnis des Repositorys.
Führen Sie den folgenden Befehl aus, um den Status Ihres Repositorys 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 Platform-Projekt-ID Ihres Kundenservicemitarbeiters und SERVICE-ACCOUNT-EMAIL durch die E-Mail-Adresse des Dienstkontos.
gcloud run deploy --image gcr.io/PROJECT-ID/agent-assist-modules-proxy-server --service-account=SERVICE-ACCOUNT-EMAIL --memory 1Gi --platform managed
- Wählen Sie auf Aufforderung eine Region aus, z. B.
us-central1. - Wenn Sie nach einem Dienstnamen gefragt werden, drücken Sie die Eingabetaste, um den Standardnamen zu akzeptieren.
- Drücken Sie
y, wenn Sie nicht authentifizierte Aufrufe zulassen möchten.
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 Anleitung für Cloud Run, um die erforderlichen Umgebungsvariablen festzulegen.
Nach der Bereitstellung des Dienstes gibt die Befehlszeile die URL aus, unter der die Anwendung bereitgestellt wurde (target_url). Kehren Sie zurück und legen Sie die Umgebungsvariable DF_PROXY_SERVER_URL für den Anwendungsserver mit diesem Wert fest.
Proxyserver herunterfahren
Wenn Sie den Anwendungsserver herunterfahren möchten, 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