Documentation
Dépannage
Solutions pour l'enrôlement, les agents hors ligne, les commandes et scans refusés, les limites des offres et la connexion.
La somme de contrôle du téléchargement ne correspond pas#
N'exécutez pas le fichier. Supprimez-le et téléchargez-le de nouveau avec la commande affichée dans Enrôler un agent; une différence signifie généralement un téléchargement interrompu ou altéré. Si elle ne correspond toujours pas, écrivez à [email protected].
« Impossible de charger la dernière version » ou « build pas encore publié »#
Le panneau d'enrôlement n'a pas pu obtenir les informations sur la version actuelle, ou aucun build n'existe encore pour la plateforme choisie. Réessayez dans quelques minutes ou choisissez une autre plateforme. Si le problème persiste, communiquez avec le support.
L'enrôlement échoue : token expiré ou déjà utilisé#
Chaque token d'enrôlement est valide 20 minutes pour une seule machine, et n'est affiché qu'une fois. Générez-en un nouveau dans Enrôler un agent et exécutez de nouveau les commandes avec celui-ci.
L'installation exige les droits root, ou indique que l'agent n'est pas enrôlé#
Exécutez les commandes d'enrôlement et d'installation avec sudo sous Linux et macOS, ou dans une fenêtre PowerShell ouverte avec « Exécuter en tant qu'administrateur » sous Windows. L'enrôlement doit réussir avant l'installation : exécutez les commandes dans l'ordre indiqué.
L'installation indique qu'osquery ne fonctionne pas#
L'agent a besoin d'osquery pour lire l'état du système, et l'installation le vérifie d'abord pour éviter que le service redémarre en boucle. Installez osquery à partir d'osquery.io, puis relancez la commande d'installation.
L'enrôlement indique que la machine est déjà enrôlée#
La machine appartient déjà à une organisation. Pour l'enrôler de nouveau (par exemple dans une autre organisation), exécutez d'abord la commande de désinstallation de l'agent, puis celle de désenrôlement, toutes deux en tant que root ou administrateur, puis enrôlez-la avec un nouveau token.
L'agent est affiché hors ligne alors que la machine fonctionne#
Vérifiez que le service de l'agent tourne sur la machine. Sous Linux : sudo systemctl status pcs-agent (et sudo journalctl -u pcs-agent -n 50 pour son journal récent). Sous Windows : Get-Service pcs-agent dans PowerShell.
Si le service tourne, assurez-vous que la machine peut joindre le serveur Sokendi. Après une panne réseau, l'agent se reconnecte de lui-même, en attendant jusqu'à environ 30 secondes entre les tentatives. Un agent révoqué ne peut plus se connecter; enrôlez-le plutôt avec un nouveau token.
J'ai envoyé une commande à distance, mais rien ne semble se passer#
Une commande ne s'exécute que lorsque l'agent est en ligne. S'il est hors ligne, la commande attend et est transmise à sa reconnexion, sauf si son délai d'expiration est dépassé avant, auquel cas elle expire. Vérifiez l'état de l'agent sur la page Agents; le statut de la commande apparaît dans Dernier résultat, dans l'onglet Envoyer une commande, et dans l'onglet Historique de l'agent.
Échec de la commande : actions à distance désactivées ou non permises#
Les actions à distance sont désactivées tant qu'un Administrateur ne les active pas : Agents → Actions à distance → Autoriser les actions à distance, puis cochez l'action voulue. osquery ad hoc ne fonctionne que pour les tables de cette liste, et la remédiation que pour les types cochés. Après l'enregistrement, les agents appliquent le changement à leur prochaine vérification de politique, généralement d'ici une minute ou deux; si une commande échoue encore juste après un changement, attendez un instant et renvoyez-la.
Requête refusée : table absente de la liste autorisée#
Chaque table lue par une requête doit figurer dans la liste de votre organisation, y compris les tables des jointures, des sous-requêtes et des clauses « IN table ». Le message indique les tables manquantes. Un Administrateur peut les ajouter sous Agents → Actions à distance → osquery ad hoc → Modifier.
Certains éléments sont toujours refusés, peu importe la liste : curl, curl_certificate et carves (qui amènent la machine à envoyer des requêtes réseau ou à téléverser des fichiers), les noms avec préfixe de schéma comme main.processes, plus d'une instruction, et tout ce qui n'est pas un SELECT.
« Les requêtes ad hoc ne sont pas disponibles sur ce serveur pour le moment »#
Le serveur ne peut pas vérifier les requêtes pour l'instant; il les refuse donc toutes plutôt que de laisser passer une requête non vérifiée. Le rescan et la remédiation fonctionnent toujours. Réessayez plus tard, et écrivez à [email protected] si le problème persiste.
L'arrêt du processus a échoué ou a été refusé#
L'agent refuse toujours les PID 0 et 1, son propre processus et le processus auxiliaire d'osquery, ainsi que les processus dont l'arrêt ferait planter Windows (comme lsass.exe ou csrss.exe). Il refuse aussi un PID qui n'existe plus : les ID de processus changent au redémarrage des programmes, alors relancez la requête et utilisez le PID du nouveau résultat.
Échec de la commande : commande rejetée#
L'agent vérifie chaque commande avant de l'exécuter : qu'elle est signée par la plateforme, adressée à cet agent et non expirée. Un rejet signifie généralement que la commande a expiré avant que l'agent la reçoive (renvoyez-la), ou que les identifiants de l'agent ne correspondent plus (enrôlez l'agent de nouveau). Des rejets répétés dont vous n'êtes pas à l'origine méritent d'être signalés au support.
Indicateur de hash ajouté, mais l'agent ne le détecte pas#
Les indicateurs de hash parviennent aux agents lors de leur lecture de politique habituelle, ce qui peut prendre quelques minutes. Vérifiez que le hash est un SHA-256 (exactement 64 caractères hexadécimaux) et que l'agent est en ligne. Les correspondances sont signalées sur les processus en cours d'exécution : le fichier doit donc réellement s'exécuter sur la machine.
Une ancienne détection a disparu#
Les détections, comme les résultats de scan et la télémétrie des agents, sont supprimées automatiquement une fois plus anciennes que la période de conservation de votre offre (30 jours avec Gratuit, 45 avec Standard, 90 avec Pro, 365 avec Entreprise), quel que soit leur statut.
La carte des menaces n'affiche aucun point#
La carte n'affiche que les adresses IP publiques et routables (les adresses privées du réseau local de vos propres agents sont exclues volontairement) qui sont apparues dans une activité réseau promue au flux en direct. Une carte vide alors que le flux contient de vraies menaces signifie généralement qu'aucune d'elles n'implique encore d'adresse distante publique.
Le filtre « Mes agents » de la carte des menaces n'affiche jamais rien#
C'est normal. Les agents enrôlés transmettent presque toujours une adresse privée de réseau local ou de RPV (par exemple 192.168.x.x), qui n'a pas d'emplacement géographique réel et n'est jamais placée sur la carte. Seul le filtre Attaquants (les IP distantes publiques vues dans l'activité réseau des agents) affiche des points pour les données des agents. « Mes agents » sert au rare agent qui a lui-même une IP publique.
Tout le flux en direct s'affiche comme Critique#
Si de l'activité courante apparaît comme Critique, les paramètres de détection sont probablement trop sensibles pour votre environnement; ce n'est pas le signe d'un problème. Un Administrateur peut revoir les paramètres de détection sous Threat Intel; communiquez avec le support si cela persiste après une mise à jour récente de l'agent.
Un scan est refusé parce que le domaine n'est pas vérifié#
Les scans actifs ne visent que les domaines que votre organisation a vérifiés en publiant l'enregistrement DNS TXT fourni par Sokendi.
La vérification est refaite chaque semaine. Si l'enregistrement est retiré, ou reste introuvable pendant 14 jours malgré des vérifications répétées, le domaine redevient non vérifié et les scans qui le visent sont refusés jusqu'à une nouvelle vérification. Laissez l'enregistrement TXT _sokendi-challenge en place.
Un scan est refusé : « Ce scan exige le niveau Entreprise vérifiée »#
Avec Pro et les offres supérieures, les scans actifs exigent la vérification de l'entreprise. Ouvrez Paramètres → Vérification : l'onglet indique ce qui manque encore. Il s'agit généralement des informations sur l'entreprise (un Administrateur indique la raison sociale) ou d'une adresse courriel d'administrateur sur un domaine vérifié : au moins un Administrateur doit se connecter avec une adresse sur l'un de vos domaines vérifiés. Si tous vos administrateurs utilisent des adresses personnelles (comme gmail.com), invitez-en un avec une adresse d'entreprise. Les recherches passives (WHOIS, géolocalisation IP, recherche de CVE) n'en ont pas besoin.
Impossible d'ajouter un domaine : « Votre offre permet jusqu'à N domaines »#
Chaque offre permet de vérifier un nombre défini de domaines : 3 avec Standard et 15 avec Pro. Chaque domaine ajouté compte, en attente ou vérifié : retirez-en un dont vous n'avez plus besoin dans Domaines vérifiés, ou passez à une offre supérieure. Avec l'offre Gratuit, l'ajout de domaines n'est pas offert : Gratuit n'effectue que des recherches passives.
Un domaine vérifié dépasse « la limite de votre offre »#
Cela se produit après un passage à une offre qui permet moins de domaines. Vos domaines restent dans la liste, mais seuls ceux que l'offre permet peuvent être scannés, en commençant par les premiers vérifiés. Retirez les domaines dont vous n'avez plus besoin, ou passez à une offre supérieure, pour scanner de nouveau les autres.
« Limite quotidienne de scans atteinte » ou « limite d'usage raisonnable »#
L'offre Gratuit comprend 25 scans par jour. Standard et Pro comprennent des scans illimités selon un usage raisonnable, avec une protection quotidienne contre un volume automatisé ou incontrôlé que l'usage normal n'atteint pas. Les deux limites se réinitialisent à 0 h UTC. Un scan compte lorsqu'il démarre ou est relancé, et l'exécution d'un seul module à partir de la page Modules compte aussi. Si vous atteignez la limite d'usage raisonnable dans le cadre d'un travail normal, écrivez à [email protected].
« Trop de scans en cours »#
Chaque offre peut exécuter un nombre défini de scans en même temps : 1 avec Gratuit, 2 avec Standard et 5 avec Pro. Attendez qu'un scan se termine, ou arrêtez-en un dont vous n'avez pas besoin, puis lancez le suivant.
La vérification des fuites est refusée pour une adresse courriel#
La vérification des fuites d'identifiants ne couvre que les adresses courriel sur les domaines vérifiés de votre organisation : une adresse sur un autre domaine (y compris une adresse personnelle comme gmail.com) est refusée. Vérifiez d'abord le domaine, ou vérifiez une adresse sur un domaine déjà vérifié.
Le scan d'une adresse ou d'une plage IP est refusé#
Les scans actifs ne visent que des domaines vérifiés, parce que la propriété d'une adresse IP ne peut pas être prouvée par un enregistrement DNS. Scannez plutôt le domaine qui pointe vers cette adresse. Le scan de plages IP peut être prévu avec l'offre Entreprise, au moyen d'une autorisation de scan signée; écrivez à [email protected].
Connexion impossible : connexion suspendue#
Après plusieurs tentatives de connexion échouées, la connexion à ce compte est suspendue pendant 15 minutes. Attendez, puis réessayez, ou utilisez Mot de passe oublié. Changer votre mot de passe vous déconnecte de tous vos appareils.
Impossible de changer ou de retirer le rôle d'un membre#
La gestion des membres exige le rôle Administrateur, et le dernier Administrateur ne peut être ni rétrogradé ni retiré, pour qu'une organisation ne se retrouve jamais sans personne pour la gérer. Nommez d'abord un autre membre Administrateur si vous devez changer cela.
J'ai invité un collègue, mais il dit n'avoir reçu aucun courriel#
Vérifiez d'abord la page Équipe : si son adresse est marquée « Non vérifié », l'invitation est bien passée, mais il n'a pas terminé la configuration de son compte. Demandez-lui de vérifier ses courriels indésirables et confirmez que l'adresse a été saisie correctement; inviter une adresse corrigée compte comme une nouvelle invitation, pas comme une modification.
L'option pour changer d'offre est absente des Paramètres#
Seul un Administrateur peut changer l'offre. Si vous êtes Lecteur ou Analyste, demandez à l'administrateur de votre organisation de faire le changement, ou de vous attribuer le rôle Administrateur si vous devez gérer la facturation. Les administrateurs de la plateforme ne voient pas cette option non plus, puisqu'elle relève de l'abonnement d'une organisation en particulier.
L'offre Entreprise n'est pas offerte en libre-service#
C'est normal : seuls les passages de Gratuit → Standard → Pro se font en libre-service. Les offres Entreprise (limites personnalisées, support dédié) sont mises en place par l'équipe Sokendi. Écrivez à [email protected] pour en discuter.
Des agents d'une organisation supprimée tentent encore de transmettre leurs données#
La suppression d'une organisation la désactive au lieu de couper toutes les connexions d'un coup; les agents peuvent donc continuer d'essayer de transmettre leurs données pendant un court moment avant d'être refusés. Désinstallez l'agent de ces machines. Les données de l'organisation sont conservées 30 jours pour pouvoir être restaurées en cas d'erreur, puis supprimées définitivement; communiquez avec le support pendant cette période si vous voulez les récupérer.