Ce guide décrit les étapes nécessaires pour configurer un serveur proxy. Vous utiliserez le serveur proxy avec un serveur d'applications pour simplifier l'authentification auprès de 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. Un serveur d'applications et un serveur proxy dans le même répertoire sont requis pour 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
Assurez-vous d'avoir déjà déployé le serveur d'applications avant de commencer ce tutoriel.
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 le serveur d'applications. LivePerson fournira
ces variables lorsque vous
créerez une application Conversational Cloud,
et vous les mettrez à jour à ce moment-là. Vous ignorerez également initialement APPLICATION_SERVER_URL et DF_PROXY_SERVER_URL, en définissant les deux après le déploiement des serveurs d'applications et proxy, et après qu'ils auront renvoyé les valeurs requises.
LP_ACCOUNT_ID: ID de compte LivePerson.LP_CLIENT_ID: ID client LivePerson. Il sera fourni par LivePerson une fois l'application Conversational Cloud installée. (Ignorez cette variable pour le moment. Vous la mettrez à jour une fois les informations fournies ).LP_CLIENT_SECRET: code secret du client LivePerson. Il sera fourni par LivePerson 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 et recherchez le domaine de "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 de "accountConfigReadOnly".APPLICATION_SERVER_URL: URL du serveur d'applications de l'interface utilisateur.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 plus sécurisé. Pour connaître les bonnes pratiques, consultez 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'applications de l'interface utilisateur 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 comme 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 direct à 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 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 la valeur par défaut.
- Lorsque vous êtes invité à autoriser les appels non authentifiés, appuyez sur
y.
Pour en savoir plus, consultez la documentation 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 requises.
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'applications, 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 afficher la liste des déploiements actifs :
gcloud beta run services list
Exécutez ensuite la commande suivante :
gcloud beta run services delete agent-assist-modules-proxy-server