Ce guide décrit les étapes requises pour configurer un serveur proxy. Vous utiliserez le serveur proxy avec un serveur d'application pour simplifier l'authentification avec l'API Dialogflow. Pour savoir comment afficher les modules d'interface utilisateur dans l'espace de travail de l'agent, consultez la page principale du tutoriel LivePerson. Vous devez disposer à la fois d'un serveur d'applications et d'un serveur proxy dans le même répertoire avant de pouvoir afficher les modules dans LivePerson.
Bien qu'il soit possible de configurer ce déploiement d'intégration sur n'importe quelle plate-forme d'hébergement, ces instructions utilisent Cloud Run de Google.
Avant de commencer
Avant de commencer ce tutoriel, assurez-vous d'avoir déjà déploqué le serveur d'applications.
Configuration
Lorsque vous déployez le service, vous devez définir les variables d'environnement suivantes.
Veillez à laisser les variables LP_CLIENT_ID et LP_CLIENT_SECRET vides lorsque vous créez initialement le serveur d'application. LivePerson vous fournira ces variables lorsque vous créerez une application Conversational Cloud. Vous les mettrez à jour à ce moment-là. Vous ignorerez également initialement APPLICATION_SERVER_URL et DF_PROXY_SERVER_URL, en les définissant après le déploiement des serveurs d'application et de proxy et le retour des valeurs requises.
LP_ACCOUNT_ID: ID de compte LivePerson.LP_CLIENT_ID: votre ID client LivePerson. LivePerson vous fournira cette information une fois l'application Conversational Cloud installée. (Ignorez cette variable pour le moment, vous la mettrez à jour une fois que les informations auront été fournies).LP_CLIENT_SECRET: votre code secret du client LivePerson. LivePerson vous fournira cette information une fois l'application Conversational Cloud installée. (Ignorez cette variable pour le moment, vous la mettrez à jour une fois les informations fournies).LP_SENTINEL_DOMAIN: accédez à https://developers.liveperson.com/domain-api.html. Saisissez votre numéro de compte, puis recherchez le domaine "sentinel".LP_ACCOUNT_CONFIG_READONLY_DOMAIN: accédez à https://developers.liveperson.com/domain-api.html. Saisissez votre numéro de compte et recherchez le domaine pour "accountConfigReadOnly".APPLICATION_SERVER_URL: URL du serveur d'application de l'UI.JWT_SECRET: phrase "secrète" qui sera utilisée pour signer les jetons d'authentification. Vous pouvez utiliser n'importe quelle phrase, bien qu'un secret long et aléatoire soit le plus sécurisé. Pour connaître les bonnes pratiques, consultez la page https://fusionauth.io/learn/expert-advice/tokens/building-a-secure-jwt/#keys.
Exemple de fichier .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
Déployer
Le serveur d'application de l'UI doit être déployé sur un service d'hébergement Google Cloud. Nous vous recommandons d'utiliser Google App Engine ou Cloud Run. Les étapes ci-dessous utilisent Cloud Run à titre d'exemple.
Déployer à l'aide de la CLI
Dans votre terminal local, remplacez le répertoire actif par le répertoire racine du dépôt.
Exécutez la commande suivante pour enregistrer l'état de votre dépôt dans Google Cloud Platform Container Registry. Remplacez PROJECT-ID par l'ID de votre projet Google Cloud Platform.
gcloud builds submit --tag gcr.io/PROJECT-ID/agent-assist-modules-proxy-server
Déployez votre intégration en production à l'aide de la commande suivante. Remplacez PROJECT-ID par l'ID de projet Google Cloud Platform de votre agent et SERVICE-ACCOUNT-EMAIL par l'adresse e-mail client de votre compte de service.
gcloud run deploy --image gcr.io/PROJECT-ID/agent-assist-modules-proxy-server --service-account=SERVICE-ACCOUNT-EMAIL --memory 1Gi --platform managed
- Lorsque vous êtes invité à indiquer une région, sélectionnez-en une (par exemple,
us-central1). - Lorsque vous êtes invité à saisir un nom de service, appuyez sur Entrée pour accepter le nom par défaut.
- Lorsque vous êtes invité à autoriser les appels non authentifiés, appuyez sur
y.
Pour en savoir plus, consultez la documentation de Cloud Run. Vous pouvez afficher la liste de vos déploiements d'intégration actifs sous Cloud Run dans la console Google Cloud Platform.
Variables d'environnement
Suivez les instructions Cloud Run pour définir les variables d'environnement nécessaires.
Une fois le service déployé, la CLI affiche l'URL sur laquelle l'application a été déployée (target_url). Revenez en arrière et définissez la variable d'environnement DF_PROXY_SERVER_URL pour le serveur d'applications à l'aide de cette valeur.
Arrêter le serveur proxy
Pour arrêter le serveur d'application, vous devez supprimer le service Cloud Run.
Dans votre terminal local, exécutez la commande suivante et sélectionnez la plate-forme cible précédemment choisie pour lister les déploiements actifs:
gcloud beta run services list
Exécutez ensuite la commande suivante:
gcloud beta run services delete agent-assist-modules-proxy-server