Aller au contenu

Il est parfois nécessaire et souhaitable d’accéder à des données ou d’exécuter des processus depuis un système distant qui n’autorise pas l’accès externe. C’est fréquent dans les environnements d’entreprise protégés par des pare-feu. PlaidCloud offre cette possibilité grâce à PlaidLink, qui permet d’accéder à des systèmes distants situés derrière un pare-feu ou lorsqu’un accès direct depuis PlaidCloud n’est pas souhaité.

PlaidLink repose sur un système d’agents. Un agent, c’est-à-dire l’utilisateur distant, est installé sur un système situé à l’intérieur du pare-feu ou d’une autre zone restreinte. L’agent peut alors se connecter à PlaidCloud au moyen d’un processus d’initiation sortante via une connexion websocket HTTPS sécurisée. Elle est aussi sûre que n’importe quelle autre connexion web chiffrée et ne nécessite généralement pas l’ouverture de ports non standard. Avant d’obtenir l’accès, l’agent doit s’identifier en envoyant son identifiant d’agent. Si l’authentification de l’agent réussit, celui-ci obtient l’accès aux opérations approuvées.

PlaidLink peut être installé sur les systèmes Windows, Unix et Linux et peut s’exécuter sous des utilisateurs à privilèges réduits. Sous Windows, PlaidLink peut fonctionner comme un service Windows avec un contrôle complet depuis le panneau Services. Sous Linux ou Unix, il peut s’exécuter comme un processus démon.

PlaidLink peut également s’exécuter comme conteneur Docker autonome ou comme pod Kubernetes.

Pour gérer les agents :

  1. Ouvrez Analyze
  2. Sélectionnez « Tools »
  3. Cliquez sur « Agents PlaidLink »

Vous accédez à la table des agents PlaidLink, où vous pouvez afficher, modifier et obtenir les identifiants de la liste des agents disponibles.

Pour créer un agent :

  1. Ouvrez Analyze
  2. Sélectionnez « Tools »
  3. Cliquez sur « Agents PlaidLink »
  4. Cliquez sur « Add PlaidLink Agent »
  5. Renseignez les champs obligatoires
  6. Cliquez sur « Créer »
  7. Affectez l’agent aux groupes de sécurité nécessaires pour accéder aux ressources dont il a besoin pour accomplir sa tâche
  8. Affectez l’agent aux comptes de documents nécessaires pour accéder aux documents dont il a besoin pour accomplir sa tâche

Pour configurer des agents PlaidLink sur le système distant, vous devez d’abord obtenir les informations d’identification de l’agent afin de préserver la sécurité. Ces informations comprennent une clé publique et une clé privée.

Pour obtenir ces clés :

  1. Ouvrez Analyze
  2. Sélectionnez « Tools »
  3. Cliquez sur « Agents PlaidLink »
  4. Cliquez sur l’icône de modification

Un formulaire s’ouvre, dans lequel vous pouvez consulter les valeurs de la clé publique et de la clé privée.

La clé privée et le bouton Afficher la configuration RPC n’apparaissent qu’aux membres autorisés à modifier les agents ; les autres membres ne voient que la clé publique.

Il est conseillé de régénérer périodiquement les clés publique et privée et de mettre à jour la configuration des systèmes distants afin de préserver la sécurité.

Pour régénérer les identifiants :

  1. Ouvrez Analyze
  2. Sélectionnez « Tools »
  3. Cliquez sur « Agents PlaidLink »
  4. Cliquez sur l’icône de régénération

Une fois les identifiants régénérés, vous pouvez les obtenir de la même manière que ceux d’un nouvel agent (décrite plus haut).

Pour désactiver un agent :

  1. Ouvrez Analyze
  2. Sélectionnez « Tools »
  3. Cliquez sur « Agents PlaidLink »
  4. Décochez la case « Active »

Une connexion peut contenir une configuration différente par environnement ; changer l’environnement d’un projet redirige donc d’un seul coup toutes les connexions qu’il utilise. Les agents peuvent suivre ce même changement.

Chaque agent possède deux paramètres :

  • Agent Group — un nom partagé par les agents qui se remplacent mutuellement. Les agents d’un groupe sont des alternatives pour un même travail, à raison d’un par environnement.
  • Environnement desservi par cet agent — l’environnement de connexion que cet agent dessert. Il doit correspondre à l’environnement indiqué dans la configuration PlaidLink de l’agent.

Une étape nomme toujours un agent précis. Lors de l’exécution du workflow, PlaidCloud examine le groupe auquel appartient cet agent et choisit le membre qui dessert l’environnement actuel du projet. Ainsi, un projet qui passe de votre environnement par défaut à QA exécute ses étapes distantes sur la machine QA, sans modifier aucune étape.

Pour un groupe nommé Finance comprenant un agent desservant Default et un autre desservant QA, une étape qui nomme l’un ou l’autre s’exécute sur celui qui correspond au projet ; et un projet rebasculé sur Default s’exécute sur l’agent Default, même si l’étape nomme l’agent QA.

Pour affecter un agent à un environnement :

  1. Ouvrez Analyze
  2. Sélectionnez « Tools »
  3. Cliquez sur « Agents PlaidLink »
  4. Ouvrez l’agent
  5. Définissez « Agent Group » avec un nom partagé avec les agents alternatifs, et définissez « Environnement desservi par cet agent » sur l’environnement dont il exécute le travail, par exemple QA
  6. Sur la machine qui exécute cet agent, définissez le nom d’environnement correspondant dans le fichier de configuration de PlaidLink — voir Faire correspondre la machine de l’agent ci-dessous

Retirer un agent d’un groupe restreint ce que le groupe couvre ; c’est donc aussi lourd de conséquences que d’en ajouter un. Si vous videz le groupe de l’agent qui desservait votre environnement par défaut, les projets qui s’y exécutent n’ont plus rien vers quoi se résoudre et échouent à leur prochaine exécution. Déplacez l’environnement vers un autre membre du groupe avant d’en retirer un. Chaque enregistrement qui modifie ce que couvre un groupe vous renvoie la nouvelle couverture.

Les environnements sont partagés avec les connexions ; les noms d’environnement proposés ici sont donc les mêmes que ceux sous lesquels vous configurez une connexion. Consultez Créer et gérer une connexion.

L’environnement que vous définissez ici doit correspondre à celui pour lequel le service PlaidLink de cette machine est configuré. PlaidLink s’abonne à une file précise pour l’environnement nommé dans son fichier de configuration ; un agent dont l’enregistrement indique QA alors que sa machine est toujours configurée pour l’environnement par défaut écoute donc une autre file que celle vers laquelle le travail est envoyé. L’étape attend, puis échoue en signalant que l’agent ne prend pas en charge la tâche.

Définissez-le dans le bloc environments du fichier de configuration de PlaidLink, dans l’entrée de cet agent :

environments:
- name: QA
agent_id: <agent identifier>

Le name est le nom de l’environnement tel qu’il apparaît dans PlaidCloud. S’il est omis, l’agent dessert l’environnement par défaut. Redémarrez le service PlaidLink après toute modification.

PlaidLink est conçu pour permettre l’exploitation de plusieurs agents avec une seule installation du service. Ce système d’installation simplifié permet à une installation de gérer des agents provenant de plusieurs espaces de travail et/ou des agents dotés de niveaux de permissions différents pour l’exécution des tâches.

Pour activer plusieurs agents, il vous suffit d’ajouter les identifiants des agents au fichier de configuration de PlaidLink.

De la même manière que pour plusieurs agents au sein d’un même service PlaidLink, il est également possible d’exécuter plusieurs services PlaidLink.

C’est parfois nécessaire en raison de l’usage d’une sécurité basée sur le système ou de restrictions d’accès réseau qui empêchent la communication au-delà de certaines frontières réseau.

Le service PlaidLink est extrêmement léger et ne nécessite que très peu de calcul et de mémoire pour fonctionner. Lors du traitement de volumes de données importants, il peut être nécessaire d’augmenter les ressources de calcul et surtout la mémoire.

Normalement, l’agent fonctionne sans problème avec 5 % d’un processeur et 200 Mo de mémoire. Pour les opérations de données intensives, il est recommandé d’allouer un processeur entier et au moins 4 Go de RAM. Pour les systèmes à allocation dynamique de ressources comme Kubernetes, il suffit que l’agent ait accès à des ressources extensibles plutôt que réservées.

L’espace disque requis par l’agent est lui aussi minimal. Les opérations de l’agent utilisent l’espace disque comme tampon de données lors du transfert de grandes quantités de données. En général, 8 Go d’espace suffisent pour un usage normal. Pour les opérations de données intensives, il est recommandé d’augmenter le disque en fonction des volumes de données attendus. Il n’existe pas de valeur fixe, car elle dépend de plusieurs facteurs, notamment la vitesse du processeur, la vitesse du réseau, la quantité de données, etc. Un bon point de départ est toutefois 20 Go, à ajuster ensuite.

L’agent PlaidLink est conçu pour fonctionner avec une configuration minimale. Il ne nécessite ni VPN ni configuration réseau particulière, hormis l’autorisation du trafic réseau HTTPS standard. Les agents communiquent via le même protocole que le trafic web habituel des navigateurs.

Le service de l’agent initie toujours la communication avec PlaidCloud ; il n’est donc pas nécessaire de configurer un accès entrant dans les pare-feu.