Skip to Content

Actions à distance

Isolez un appareil, modifiez son enrôlement MFA, épinglez son utilisateur et exécutez des commandes d'appareil via l'API de gestion.

RequiresDevice Identity (DIAM)

Add-on requis : les actions à distance nécessitent l'add-on DIAM (Device Identity) avec la fonctionnalité deviceTrust.

Il est possible d'agir depuis la console sur un appareil connecté. Les actions ci-dessous constituent le volet réponse aux incidents de l'inventaire des appareils : vous confinez une machine, modifiez ce qu'elle exige lors de la connexion ou corrigez à qui elle appartient, sans y toucher physiquement.

Actions dans la console

Ouvrez un appareil dans l'inventaire des appareils et utilisez son menu Actions.

ActionEffet
IsolerCoupe l'appareil du réseau pour confiner un incident. Voir ce que bloque l'isolation.
Annuler l'isolationSupprime les règles d'isolation et rétablit l'accès normal au réseau.
Configurer la MFA pour l'appareilDéfinit l'enrôlement MFA de l'appareil sur Requis, Facultatif ou Désactivé, vérifié sur l'appareil. Verrouillé tant qu'une politique de conformité des appareils définit le mode de cet appareil. Voir MFA à la connexion Windows.
Épingler l'utilisateur / Épingler le groupeLie un compte du système d'exploitation de l'appareil à un compte employé de votre choix, ou permet à chaque membre d'un groupe d'utiliser l'appareil. Le compte du système d'exploitation est prérempli avec le dernier compte connecté et peut être saisi à la place, de sorte qu'un appareil peut être épinglé avant la première connexion de son utilisateur : le nom d'utilisateur sans le domaine, et le nom de domaine court (DEV, et non dev.example.com) ou, pour un compte local, le nom de l'ordinateur. Sous Windows, le domaine est obligatoire. Les comptes dont le nom d'utilisateur correspond sont suggérés. Un appareil peut porter plusieurs comptes épinglés (un par compte du système d'exploitation) et plusieurs groupes ; la liste Comptes épinglés de l'onglet Présentation les affiche et c'est là qu'un épinglage se supprime. Un appareil dont l'utilisateur actif ne fait pas partie de ses utilisateurs épinglés est signalé dans la liste ; c'est ainsi qu'un appareil ayant changé de mains devient visible.
Installer les mises à jourInstalle les mises à jour du système d'exploitation que l'appareil a signalées comme manquantes. Voir installer les mises à jour manquantes.
Collecter les diagnosticsDemande à l'agent de terminal ses journaux et son état des dernières 24, 48 ou 72 heures, pseudonymisés sur l'appareil. Voir paquets de diagnostic.
Supprimer l'appareilSupprime l'enregistrement de l'inventaire. Rien n'est désinstallé sur la machine elle-même.

Chaque action est consignée dans le journal d'audit, y compris la personne qui l'a déclenchée.

Ce que l'isolation bloque réellement

L'isolation installe des règles de pare-feu locales sur le terminal. Il s'agit d'une mesure de confinement, et non d'un interrupteur : une connectivité suffisante est délibérément préservée pour que la machine reste gérable et que vous puissiez lever l'isolation.

Bloqué : tout autre trafic entrant et sortant, IPv4 et IPv6.

Délibérément toujours autorisé :

  • La connexion de l'appareil vers la plateforme, afin que vous puissiez annuler l'isolation à distance.
  • DNS, DHCP et la configuration automatique du proxy, afin que la machine conserve la résolution de noms et l'adressage de base.
  • L'authentification de domaine Windows, afin que la connexion au domaine continue de fonctionner.
  • La synchronisation de l'heure, afin que l'horloge reste juste (agent de terminal).
  • Le trafic de bouclage (loopback) sur la machine elle-même.

Deux propriétés comptent en exploitation. Les règles sont persistantes et appliquées au démarrage : un redémarrage ne lève donc pas l'isolation, et l'isolation prend effet avant le démarrage du service client. Et les règles ne sont supprimées que par l'annulation de l'isolation, ou par la désinstallation de l'agent de terminal, qui lève d'abord l'isolation. Désinstaller le legacy client d'une machine isolée la laisse isolée ; annulez donc d'abord l'isolation dans ce cas. Si l'isolation coupe un appareil de la plateforme, dts-agent revert-isolation sur l'appareil la lève localement.

L'isolation est disponible sous Windows, macOS et Linux avec l'agent de terminal, et sous Windows avec le legacy client. Sur une machine Linux qui héberge des conteneurs, l'isolation coupe également le réseau des conteneurs, et un pare-feu propre à l'hôte peut encore bloquer ce que l'isolation autorise.

Isolation partielle

Un appareil peut signaler Partiellement isolé. Il s'agit d'un état, et non d'un mode que vous pouvez choisir : le client compare les règles d'isolation réellement présentes à l'ensemble complet attendu, et signale une isolation partielle lorsque certaines règles sont en place, mais pas toutes. Cela signifie généralement qu'une isolation ou une annulation n'a abouti qu'en partie. Considérez l'appareil comme « non confiné » et relancez l'action.

Installer les mises à jour manquantes

Remarque : l'installation des mises à jour fait partie de la gestion des correctifs, qui nécessite le plan Pro avec l'add-on DIAM. Sur les autres plans, l'onglet des correctifs continue de lister les mises à jour manquantes, mais n'affiche aucun bouton d'installation.

L'onglet Correctifs manquants d'un appareil liste les mises à jour du système d'exploitation que la machine a signalées comme manquantes. Avec l'agent de terminal actuel, vous pouvez les installer depuis cet onglet. Sur un appareil doté de l'ancien client DTS, ainsi que sous Linux, les boutons d'installation sont grisés.

Chaque mise à jour possède son propre bouton Installer, et Installer toutes les mises à jour en attente, au-dessus de la section Mises à jour système, les lance toutes en une seule exécution. L'action groupée demande d'abord une confirmation ; une mise à jour individuelle démarre immédiatement, sauf si elle porte la mention Redémarrage requis, auquel cas une confirmation est également demandée. Les mises à jour qui proviennent du catalogue de vulnérabilités plutôt que de la machine elle-même n'ont pas de bouton : ce sont des mises à jour d'applications, et cette action ne pilote que le mécanisme de mise à jour propre au système d'exploitation.

Ce qui se passe après le clic :

  • L'appareil confirme que l'installation a démarré, et non qu'elle est terminée. Une installation s'exécute en arrière-plan pendant quelques minutes à plusieurs heures ; la console ne signale donc jamais une mise à jour comme installée.
  • Le correctif conserve un marqueur Installation demandée jusqu'à ce que l'appareil signale de nouveau son état, et tous les boutons d'installation de l'appareil sont verrouillés tant qu'il est présent. Une machine installe un seul lot de mises à jour à la fois ; c'est aussi ce qui empêche deux administrateurs d'empiler des installations. Le marqueur expire au bout de deux heures, au cas où une installation ne donnerait jamais de nouvelles.
  • Une installation qui a échoué l'indique au niveau de la mise à jour. L'appareil transmet ce que son propre mécanisme de mise à jour a signalé, dans ses propres termes, et les boutons sont immédiatement libérés au lieu de l'être au bout des deux heures. Un message reste affiché au niveau de la mise à jour jusqu'à ce qu'elle soit installée ou que vous lanciez une nouvelle tentative.
  • Chaque exécution terminée figure dans le journal d'audit, sous la forme DEVICE_UPDATES_INSTALLED ou DEVICE_UPDATES_FAILED avec le message de l'appareil, de sorte que le résultat reste lisible une fois le marqueur disparu, et qu'une alarme peut signaler les installations ayant échoué.
  • La liste est corrigée lorsque l'appareil envoie son prochain rapport d'état. Actualiser l'état de l'appareil, dans l'en-tête de l'appareil, demande ce rapport immédiatement au lieu d'attendre le rapport quotidien, et l'alerte relative à l'installation en cours reprend ce bouton.
  • L'appareil n'est jamais redémarré. Une mise à jour portant la mention Redémarrage requis prend effet après le prochain redémarrage, qui reste à la charge de l'utilisateur ou de votre maintenance habituelle.

Prérequis et limites :

  • L'appareil doit être connecté. Les installations ne sont pas mises en file d'attente pour les appareils hors ligne : une installation différée s'exécuterait des jours plus tard, à un moment arbitraire, à partir d'une liste qui était à jour au moment de sa mise en file d'attente.
  • L'action nécessite l'agent de terminal actuel. Elle n'est pas proposée pour les appareils exécutant l'ancien client, ni sous Linux, où l'agent ne pilote aucun mécanisme de mise à jour.
  • Sous Windows, une seule session d'installation s'exécute à la fois. La console verrouille les boutons tant qu'une installation est ouverte, ce qui fait que ce cas se présente rarement ; une demande qui arrive malgré tout est refusée avec un message plutôt qu'ignorée silencieusement.

Mises à jour d'applications

Sur les appareils Windows dotés de l'agent de terminal actuel, l'onglet des correctifs liste également les mises à jour d'applications issues du catalogue de paquets, et une mise à jour confirmée dispose de son propre bouton Télécharger & installer. L'appareil télécharge lui-même le programme d'installation depuis l'adresse de l'éditeur, le vérifie à l'aide de la somme de contrôle du catalogue et de la signature de l'éditeur, puis l'exécute en mode silencieux ; la console ne manipule jamais le fichier. Tout ce qui précède s'applique : l'appareil confirme le démarrage, les boutons restent verrouillés pendant l'exécution, un échec est affiché au niveau de la mise à jour, et l'appareil n'est jamais redémarré. Une mise à jour qui ne se termine qu'avec un redémarrage est signalée comme installée.

Une mise à jour d'application sans bouton en indique la raison en dessous, par exemple :

  • le paquet n'est pas confirmé (plusieurs paquets conviennent, ou le programme d'installation diffère de la version installée) : choisissez-le avec Choisir le paquet à côté de la mise à jour ;
  • l'application est installée dans un profil utilisateur, ou son programme d'installation installe par utilisateur ;
  • plusieurs applications de l'appareil correspondent au même paquet, comme deux environnements d'exécution côte à côte ;
  • le programme d'installation n'a pas de mode silencieux, supprime d'abord la version installée, ou est contenu dans une archive ;
  • les informations de mise à jour ne sont pas à jour : les installations utilisent des données de catalogue de sept jours au plus ;
  • l'appareil fonctionne sous macOS : les mises à jour d'applications y sont listées, mais pas installées.

L'installation des mises à jour d'applications fonctionne également sur un appareil isolé : l'isolation laisse passer l'agent de terminal lui-même, et c'est l'agent qui télécharge le programme d'installation. Elle n'est pas proposée via l'API.

Paquets de diagnostic

Lorsqu'un appareil se comporte mal et que personne ne peut accéder à la machine, Collecter les diagnostics dans le menu Actions demande à l'agent de terminal ses journaux et son état des dernières 24, 48 ou 72 heures. L'appareil doit être connecté. Sur un appareil qui exécute encore l'ancien client DTS, l'entrée de menu est grisée. Le paquet arrive en une demi-minute environ et figure dans l'onglet Diagnostics de l'appareil, d'où il se télécharge sous forme de fichier JSON.

  • Pseudonymisé sur l'appareil. Avant que le paquet ne quitte la machine, l'agent remplace les noms d'utilisateur, adresses e-mail, noms de domaine et d'hôte, SID, adresses IP et MAC, numéros de série et chemins de profil par des espaces réservés tels que user-1 ou host-2. Une même valeur reçoit le même espace réservé dans tout le paquet, de sorte que les relations restent lisibles. La correspondance ne quitte jamais l'appareil. Les codes d'erreur, horodatages, versions et états restent inchangés.
  • Jamais inclus : clés, tokens, mots de passe, codes, journaux d'événements Windows et données de posture brutes.
  • Taille. L'agent maintient un paquet sous 1 Mo et supprime les lignes de journal les plus anciennes si nécessaire. Un tel paquet est marqué comme tronqué.
  • Conservation. Un paquet est supprimé 14 jours après sa collecte.
  • Audit. La collecte est consignée sous DEVICE_COMMAND_SENT et chaque téléchargement sous DEVICE_DIAGNOSTICS_DOWNLOADED, chacun avec l'administrateur qui l'a effectué.

Un paquet pseudonymisé reste une donnée personnelle. Ne le transmettez au support que dans le cadre de l'accord de traitement des données qui couvre votre instance.

Appareils hors ligne et commandes en file d'attente

Un appareil est considéré comme hors ligne environ dix secondes après son dernier contact.

Trois actions peuvent être mises en file d'attente jusqu'à la reconnexion : Isoler, Annuler l'isolation et Configurer la MFA pour l'appareil. Si l'appareil est hors ligne, la console propose de mettre la commande en file d'attente, et celle-ci est remise automatiquement dès que l'appareil revient. Toute autre action échoue immédiatement sur un appareil hors ligne au lieu d'être conservée.

Règles de la file d'attente :

  • Une seule commande en attente par objet. L'isolation et l'enrôlement MFA sont mis en file d'attente séparément, mais une commande d'isolation plus récente remplace une commande plus ancienne en attente, de sorte qu'un appareil ne peut pas accumuler d'instructions contradictoires.
  • Les commandes en file d'attente expirent au bout de sept jours si l'appareil ne revient jamais.
  • Les actions en attente sont visibles sur la page de l'appareil et peuvent être annulées avant leur remise.
  • La remise est également consignée dans le journal d'audit, de sorte que vous voyez à la fois quand une commande a été mise en file d'attente et quand elle a réellement atteint l'appareil.

Via l'API

Remarque : nécessite la fonctionnalité deviceTrust.

Les mêmes commandes sont disponibles par programmation ; c'est ce que vous utilisez pour intégrer le confinement dans un playbook SOAR ou dans vos propres outils.

curl -X POST https://<your-instance>/api/v1/devices/<deviceUid>/query/Isolate \
  -H "Authorization: Bearer <access token>" \
  -H "Content-Type: application/json" \
  -d '{"queueIfOffline": true}'

L'appel nécessite le scope devices.query. Définissez queueIfOffline sur true pour obtenir le comportement de file d'attente décrit ci-dessus ; la valeur par défaut est false, de sorte qu'un simple appel visant un appareil hors ligne échoue immédiatement au lieu d'être différé.

Commandes disponibles

CommandeParamètresObjectif
IsolateaucunCouper l'appareil du réseau.
RevertIsolationaucunRétablir l'accès au réseau.
SetMfaEnrollmentenrollment : Required, Optional, DisabledDéfinir l'enrôlement MFA pour la connexion Windows.
RequestFullUpdateaucunDemander à l'appareil de renvoyer l'intégralité de sa posture. Ne modifie rien sur le terminal.
GetProcessListaucunRenvoyer les processus en cours d'exécution.
TerminateProcessespids (agent de terminal) ou signature (legacy client)Arrêter les processus portant ces identifiants, lus via GetProcessList sur le même appareil, ou ceux d'un produit détecté. L'agent de terminal n'arrête jamais lui-même ni un processus critique pour le système.
RunsignatureDémarrer un produit détecté. Legacy client uniquement.
Scansignature, scanType : full, default ou path, path, cleanDéclencher une analyse antimalware par le produit de sécurité désigné.
UpdateDefinitionssignatureMettre à jour les définitions antimalware du produit désigné.
EnableRTPsignatureRéactiver la protection en temps réel.
SetFirewallStatesignature, operation : enable ou disable, passwordActiver ou désactiver un produit de pare-feu.
SetAgentStatesignature, operation : enable ou disableActiver ou désactiver un agent de gestion des correctifs. Legacy client uniquement.
GetProductInfoproductListLire les détails des produits désignés. Legacy client uniquement.
GetRunningStatesignatureListVérifier si les produits désignés sont en cours d'exécution. Legacy client uniquement.
BlockEndpointDestinationsdestinationsBloquer des adresses ou réseaux IPv4 spécifiques sur le terminal. Legacy client uniquement.
UnblockEndpointDestinationsfilterKeysSupprimer des blocages de destination définis précédemment. Legacy client uniquement.
GetEndpointBlockedDestinationsListaucunLister les blocages de destination actuellement en place. Legacy client uniquement.
DownloadMissingPatchespatchesTélécharger les mises à jour du système d'exploitation que l'appareil a signalées comme manquantes. Sans la liste, toutes celles qui lui sont proposées.
InstallMissingPatchespatchesInstaller ces mises à jour. L'appareil n'est jamais redémarré pour cela.
CollectDiagnosticshours (1 à 72, 24 par défaut)Renvoyer les journaux et l'état de l'agent pour cette période, pseudonymisés sur l'appareil. Via l'API, le paquet est remis à l'appelant et n'est pas stocké.

Le paramètre patches contient les identifiants que l'appareil a lui-même signalés sous missingPatches : un numéro KB sous Windows, l'identifiant propre de la mise à jour lorsqu'elle n'a pas de numéro KB, un libellé de mise à jour sous macOS. Lisez-les d'abord dans les données de correctifs de l'appareil. Ces deux commandes nécessitent l'agent de terminal actuel ; elles agissent sur le mécanisme de mise à jour propre au système d'exploitation et reçoivent une réponse « non pris en charge » sous Linux.

Le paramètre signature identifie un produit de sécurité tel que l'appareil concerné le signale. Lisez-le d'abord dans les données produit de l'appareil, avec GetProductInfo, plutôt que de supposer un identifiant stable d'une machine à l'autre.

Sur un appareil doté de l'agent de terminal, Scan, UpdateDefinitions et EnableRTP agissent sur Microsoft Defender (Windows) et SetFirewallState sur le pare-feu du système d'exploitation (Windows et macOS) ; signature y reste obligatoire mais n'est pas évalué. Une commande marquée legacy client uniquement est refusée pour un tel appareil. Sur le legacy client, les commandes au niveau produit agissent sur des logiciels de sécurité tiers installés sur le terminal et ne fonctionnent que si ce produit prend en charge l'opération. Interprétez un échec comme « le produit a refusé », et non comme « l'appareil est injoignable » ; les deux sont signalés différemment.

Le blocage de destinations s'applique uniquement à IPv4.

Dépannage

  • La commande a expiré. L'appareil était joignable mais n'a pas répondu à temps. Vérifiez qu'il est toujours connecté, puis réessayez. Seules les trois actions pouvant être mises en file d'attente survivent à une reconnexion ; tout le reste doit être relancé.
  • L'action a été mise en file d'attente alors que l'appareil semble en ligne. La liste affiche le dernier état connu. Si l'appareil a cessé de se manifester il y a quelques secondes, il est déjà considéré comme hors ligne.
  • Un appareil reste isolé après la suppression du client. Avec le legacy client, les règles de pare-feu sont locales et survivent au client. Réinstallez un client, annulez l'isolation, puis désinstallez-le correctement. L'agent de terminal lève l'isolation lors de sa désinstallation.
  • L'appareil signale une isolation partielle. Relancez Isoler ou Annuler l'isolation pour le ramener à un état défini.

Voir aussi

Sur cette page