Aller au contenu

Gérer les hôtes découverts

Nécessite @openlatch/client 0.11.12 ou une version ultérieure

Utilisez Settings › Discovery pour obtenir la commande qui déploie la découverte, et pour gérer chaque hôte de votre organisation, quelle que soit la façon dont il a été inscrit. Il vous faut le rôle admin ou owner : la page se trouve à /settings/discovery, sous Integration, et un rôle inférieur est renvoyé vers la page d’accueil.

Une organisation qui ne déploie jamais la découverte ne voit aucun changement hormis cette page.

Le bloc Deploy discovery présente la commande dans trois onglets :

OngletCommandeExécution
macOS / LinuxLa commande qui télécharge et exécute discover.shAvec sudo, pour déployer la découverte sur cette machine
WindowsLa commande qui télécharge et exécute discover.ps1Dans un PowerShell élevé
Fleet toolLa forme fichier de script qu’exécute votre outil de gestion de parc, sous Windows et sous macOS ou LinuxPar votre outil de gestion de parc, qui fournit la clé et l’organisation depuis son coffre de secrets

La clé et l’organisation s’affichent comme des espaces réservés jusqu’à ce que vous appuyiez sur Generate key and fill. Cela crée une clé d’organisation depuis le préréglage Host enrollment, nommée Discovery avec la date du jour, et remplit les commandes macOS / Linux et Windows avec la clé et votre organisation. La clé ne s’affiche qu’une fois et ne peut qu’inscrire des hôtes. Une notification propose Manage API keys, qui ouvre Settings › API keys, où la clé reste listée. L’onglet Fleet tool garde ses espaces réservés, car votre outil de gestion de parc fournit les deux valeurs.

Le script Windows ne porte pas encore de signature Authenticode. Exécutez-le avec -ExecutionPolicy Bypass, comme le montre Déployer la découverte. La commande Windows de l’onglet Fleet tool l’exécute ainsi, et l’onglet indique que le script ne porte pas encore de signature.

Si la clé ne peut pas être créée, une notification le dit et rien n’est créé ; appuyez sur Try again. Deployment guides ouvre Déployer la découverte.

Le tableau Hosts liste chaque machine inscrite dans votre organisation, par la découverte ou à la main.

ColonneAffiche
HostnameLe nom de la machine, avec son utilisateur et son système d’exploitation en dessous
StateActive, Inactive, De-enrolled ou Removed
AgentsLes agents de la machine
Enrolled viaDiscovery ou Manual
IPLes adresses privée et publique
FoundQuand une analyse y a découvert un agent pour la première fois
ScannedQuand la dernière analyse s’est exécutée
ActiveQuand l’hôte a envoyé son dernier événement

Recherchez par nom d’hôte, adresse IP ou utilisateur, et filtrez par Enrolled via, State, OS et Last active. Les hôtes retirés sont masqués tant que vous n’activez pas Show removed hosts.

Sélectionnez une ligne, ou View host dans son menu, pour ouvrir le panneau de l’hôte :

SectionAffiche
IdentityNom d’hôte, système d’exploitation, utilisateur et état
NetworkLes adresses IPv4 et IPv6 privées et publiques, chacune avec un bouton de copie
DiscoveryComment il a été inscrit, quand il a été découvert, la dernière analyse et le privilège d’analyse
Agents on this hostChaque agent avec son niveau de contrôle et sa dernière activité, avec un lien vers sa fiche
Recent activityLes derniers événements de cycle de vie de l’hôte et de ses agents

Remove fonctionne comme sur la page des licences : choisissez de laisser l’hôte revenir quand il est revu, ou de le couper. Un hôte retiré cesse de compter dans vos hôtes sous licence. Un hôte coupé reste dehors jusqu’à ce qu’une personne l’inscrive à nouveau à la main sur cette machine : une analyse de découverte ne le ramène pas.

Auto-remove hosts inactive for 90 days est activé par défaut, sous le tableau. Il retire un hôte sans activité depuis 90 jours et le laisse revenir quand il est revu. Il n’agit que dans une organisation où au moins un agent a été inscrit par la découverte, et ne touche jamais un hôte coupé ou désinscrit.

Utilisez De-enrol quand une machine doit rester hors de votre organisation, même si la découverte s’y exécute. Sélectionnez un ou plusieurs hôtes, choisissez De-enrol et confirmez.

Ce qui se passeDétail
Ses agents cessent d’envoyer des événementsChaque identifiant de l’hôte est refusé dès son prochain appel. Le client continue d’appliquer les politiques qu’il détient déjà et n’est pas désinstallé
La découverte ne l’inscrit pas à nouveauUne analyse sur cet hôte détecte et enregistre seulement. Une inscription à la main est refusée aussi
Son historique est conservéLa fiche et le journal d’audit gardent tout jusqu’à la désinscription

L’hôte affiche De-enrolled dans le tableau, dans son panneau et sur la fiche de chacun de ses agents.

Choisissez Re-enrol sur un hôte désinscrit. L’analyse de découverte suivante sur cet hôte l’inscrit à nouveau. Un hôte sans découverte a besoin que quelqu’un exécute openlatch init avec une clé d’organisation sur cette machine.

Chaque fiche d’agent a un onglet Host, sous Economics, lisible par tous ceux qui peuvent ouvrir l’agent. Il montre la machine sur laquelle l’agent s’exécute : son identité, son réseau, ses données de découverte, son activité récente et Agents on this host, chaque autre agent de la même machine avec un lien vers sa fiche. Manage hosts, affiché aux admins, ouvre Settings › Discovery : l’onglet lui-même n’a aucune action.

La fiche de l’agent porte aussi un badge Enrolled via discovery pour un agent qu’une analyse a inscrit, un badge Removed une fois l’agent disparu de sa machine, et un badge De-enrolled quand son hôte est désinscrit. Un agent qui n’est pas encore pris en charge affiche Known, avec No enforcement adapter.

NotificationQuand
Nouvel agent découvertLa découverte a inscrit un agent
Agent réinscritLa découverte a inscrit un agent à nouveau après la suppression de son client
Agent suppriméUn agent n’est plus installé sur sa machine. Son historique est conservé
Hôte désinscritUn administrateur a désinscrit un hôte

Elles apparaissent dans la console. Un canal les reçoit une fois que vous les ajoutez à ses abonnements dans Settings › Notifications.