Ce guide décrit les étapes nécessaires pour configurer un serveur proxy. Vous utiliserez le serveur proxy conjointement avec un serveur d'application 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 nécessaires 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éployé le serveur d'application.
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'application. LivePerson fournira ces variables lorsque vous créerez une application Conversational Cloud. Vous les mettrez alors à jour. Vous allez également ignorer initialement APPLICATION_SERVER_URL et DF_PROXY_SERVER_URL, en définissant les deux après le déploiement des serveurs d'application et proxy, et après qu'ils ont renvoyé les valeurs requises.
LP_ACCOUNT_ID: ID de compte LivePerson.LP_CLIENT_ID: ID client LivePerson. Il vous 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 "sentinel".LP_ACCOUNT_CONFIG_READONLY_DOMAIN: Accédez à https://developers.liveperson.com/domain-api.html. Saisissez votre numéro de compte, puis recherchez le domaine "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 expression, mais un secret long et aléatoire est plus sécurisé. Veuillez consulter les bonnes pratiques sur 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 du projet Google Cloud Platform de votre agent et SERVICE-ACCOUNT-EMAIL par l'adresse e-mail du 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 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 nécessaires.
Une fois le service déployé, l&#CLI affiche l'URL à 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'application à 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 choisie précédemment 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