Documentation
Pour commencer
Enrôler votre premier agent, vérifier un domaine, examiner les détections et configurer les actions à distance, étape par étape.
1. Enrôlez votre premier agent#
Avant de commencer, installez osquery sur la machine à surveiller (osquery.io). L'agent s'en sert pour lire l'état du système.
Ensuite, en tant qu'Administrateur, ouvrez Agents et cliquez sur Enrôler un agent. Le panneau vous guide en quatre étapes : téléchargez l'agent avec la commande affichée pour votre plateforme, vérifiez le téléchargement avec sa somme de contrôle SHA-256, générez un token d'enrôlement à usage unique (valide 20 minutes pour une seule machine, et affiché une seule fois), puis copiez les commandes d'enrôlement et d'installation.
Exécutez les commandes sur la machine elle-même : avec sudo sous Linux et macOS, ou dans une fenêtre PowerShell en mode administrateur sous Windows. L'installation configure l'agent comme service en arrière-plan, qui continue de tourner après votre déconnexion et redémarre après un redémarrage de la machine. Aucun fichier de configuration à modifier.
L'agent apparaît sur la page Agents dès qu'il se signale. Cliquez sur sa ligne pour la déplier et afficher quatre onglets : Aperçu (détails, et Révoquer pour les administrateurs), Envoyer une commande, Rapports (les changements signalés par l'agent depuis l'ouverture de la page) et Historique (toutes les commandes envoyées à cet agent).
Les tuiles en haut de la page Agents (Enrôlés, En ligne, Hors ligne, Révoqués) servent aussi de filtres : cliquez sur l'une d'elles pour n'afficher que ces agents, ou utilisez la zone de recherche pour trouver une machine par nom, ID d'agent ou plateforme.
2. Vérifiez un domaine et lancez votre premier scan#
Les scans actifs ne visent que les domaines dont votre organisation a prouvé être propriétaire. En tant qu'Administrateur, ouvrez Domaines vérifiés, ajoutez le domaine et publiez l'enregistrement DNS TXT fourni par Sokendi; dès que l'enregistrement est trouvé, le domaine est vérifié, ainsi que tous ses sous-domaines. Votre offre détermine le nombre de domaines que vous pouvez vérifier : 3 avec Standard et 15 avec Pro (Entreprise : selon le contrat). L'offre Gratuit n'effectue que des recherches passives : elle n'utilise donc pas de domaines vérifiés.
Avec Pro et les offres supérieures, les scans actifs exigent aussi la vérification de l'entreprise. Sous Paramètres → Vérification, un Administrateur indique la raison sociale de votre organisation, et au moins un administrateur doit se connecter avec une adresse courriel sur un domaine vérifié (par exemple [email protected] pour votreentreprise.com). Aucune pièce d'identité n'est demandée. L'onglet Vérification indique ce qui est fait et ce qui reste à faire.
Allez ensuite dans Scan, choisissez la cible vérifiée et un profil de scan (ou celui par défaut), puis lancez-le. Les résultats apparaissent dans Rapports une fois le scan terminé.
3. Examinez les détections#
Quand un agent trouve le hash d'un fichier malveillant connu ou qu'un de ses détecteurs comportementaux se déclenche (par exemple un chiffrement massif de fichiers ou une rafale de connexions échouées), la détection apparaît sous Threat Intel → Détections, étiquetée selon son type d'attaque. Marquez chacune comme Prise en compte pendant votre analyse, puis Résolue une fois terminée, pour que votre équipe voie ce qui demande encore de l'attention.
4. Ajoutez un indicateur de hash (facultatif)#
Sous Threat Intel → Indicateurs de hash, les administrateurs peuvent ajouter des hash SHA-256 de fichiers malveillants connus, chacun avec une catégorie d'attaque. Chaque agent enrôlé les récupère à sa prochaine lecture de politique et signale comme Critique tout processus en cours correspondant.
5. Activez les actions à distance#
Les nouvelles organisations commencent avec les actions à distance désactivées : les agents refusent toute commande tant qu'un Administrateur ne les a pas activées. Sur la page Agents, cliquez sur Actions à distance (à côté d'Actualiser). Tout le monde peut l'ouvrir pour voir ce qui est permis; seul un Administrateur peut le modifier.
Activez Autoriser les actions à distance, puis cochez celles dont votre équipe a besoin. Rescan relance à la demande les collecteurs de l'agent. osquery ad hoc permet aux analystes d'exécuter des requêtes en lecture seule; en le cochant, choisissez les tables osquery qui peuvent être interrogées (parmi les Tables suggérées, ou avec Tout ajouter pour un groupe). Remédiation permet aux Administrateurs d'agir sur ;une machine en la cochant, choisissez parmi Arrêter un processus, Mettre un fichier en quarantaine et Désactiver un compte utilisateur.
Une requête ne s'exécute que si chaque table qu'elle lit figure dans la liste, y compris dans les jointures et les sous-requêtes : joindre processes à users exige les deux. curl, curl_certificate et carves ne sont jamais permises, car elles amènent la machine à envoyer des requêtes réseau ou à téléverser des fichiers.
Cliquez sur Enregistrer. Les agents appliquent le changement à leur prochaine vérification de politique, généralement d'ici une minute ou deux. L'activation d'une remédiation demande d'abord une confirmation, et chaque changement est consigné dans le journal d'audit.
6. Envoyez une commande à distance à un agent#
Dépliez un agent sur la page Agents et ouvrez son onglet Envoyer une commande. Choisissez Rescan, Requête ad hoc ou Remédiation. Les analystes peuvent lancer Rescan et Requête ad hoc; la Remédiation exige le rôle Administrateur, puisqu'elle modifie la machine au lieu de seulement l'observer.
Si le dernier rapport date un peu, lancez d'abord un Rescan : l'état des processus, des fichiers et des comptes a pu changer. Sous Options avancées, vous pouvez définir un Délai d'expiration (10 à 3600 s), soit le temps pendant lequel la commande peut attendre l'agent avant d'expirer.
Après avoir cliqué sur Envoyer la commande, le résultat apparaît sous le formulaire dans Dernier résultat, avec un statut mis à jour en direct (En attente, Reçu, Terminé). Votre requête reste dans la zone de saisie pour que vous puissiez l'ajuster et la relancer. Chaque commande figure aussi dans l'onglet Historique de l'agent.
Une remédiation demande toujours une confirmation et affiche la machine, l'action et la cible exacte. Chaque commande est signée par la plateforme, et l'agent vérifie la signature avant d'exécuter quoi que ce soit.
7. Trouvez et arrêtez un processus#
Beaucoup de programmes exécutent plusieurs processus (un navigateur web peut en avoir des dizaines) et c'est généralement le processus principal qui vous intéresse : l'arrêter arrête tous les autres. Lancez une requête ad hoc comme : SELECT pid, parent, name, cmdline FROM processes WHERE name = 'firefox'. Le processus principal est celui dont le parent n'est pas un autre processus du même nom; pour les navigateurs, c'est aussi celui dont la ligne de commande ne contient pas -contentproc.
Dans les résultats, cliquez sur Arrêter… sur cette ligne. Cela remplit Remédiation → Arrêter un processus avec le PID; cliquez sur Vérifier la remédiation, puis confirmez. Les ID de processus sont réutilisés : faites-le juste après la requête plutôt qu'à partir d'un ancien rapport. Arrêter un processus met fin au programme immédiatement, sans lui laisser le temps d'enregistrer quoi que ce soit; certains programmes et processus système (PID 1, l'agent lui-même, les processus Windows critiques) sont toujours refusés.
8. Invitez votre équipe#
Sous Équipe, un administrateur peut inviter des collègues et attribuer à chacun un rôle (Lecteur, Analyste ou Administrateur) selon ce qu'il doit faire.