Dépannage
Les messages de la console et de l'agent, ce qu'ils signifient et comment y répondre. Suivis des limites fonctionnelles connues des agents Windows et Linux.
Cette page recense les situations les plus courantes rencontrées en exploitation. Chaque message est reproduit tel quel. La colonne de droite indique l'action attendue.
Messages de la console
La console affiche des messages précis quand une action échoue ou qu'une valeur manque. Elle ne crée jamais une donnée que le serveur ne lui fournit pas. Un tiret ou l'étiquette Non disponible signale une absence.
| Message | Que faire |
|---|---|
| « Vous n'avez pas les droits nécessaires pour cette action. » | Votre rôle ne le permet pas. Demandez à l'administrateur de tenant de revoir la correspondance groupes vers rôles. |
| « Votre session a expiré. Reconnectez-vous. » | Reconnectez-vous. Les modifications non enregistrées sont perdues. |
| « L'élément a changé entre-temps. Rechargez puis recommencez. » | Une autre personne a modifié l'élément. Rechargez la page avant de recommencer. |
| « L'action n'a pas pu être confirmée. Vérifiez son état avant de réessayer. » | Le serveur n'a pas confirmé. Rechargez et vérifiez si l'action a été prise en compte avant de la relancer. |
| « Données indisponibles » | Cliquez sur Réessayer. Si l'erreur persiste, prévenez l'exploitant. |
| « Unité masquée sur n événements de cette page » | L'unité de ces événements compte moins de k personnes. Elle est masquée, les événements restent listés. |
| « Aucune donnée sur cette période avec ces filtres. » | Élargissez la période ou retirez des filtres. |
| Valeur « Masqué » | Groupe de moins de k personnes, masqué pour protéger les personnes. |
| « Non calculable » | Taux sans dénominateur sur la période, par exemple aucune entité détectée. |
| « Remise au poste, résultat non transmis » | L'action a été remise au poste, qui n'en renvoie pas le résultat. Vérifiez son effet sur la fiche du poste. |
États particuliers des valeurs
Quatre états ne doivent pas être confondus. Chacun a un sens précis dans les tableaux et les exports.
- 0 : mesure réelle, le compteur vaut zéro sur la période.
- Absent, tiret ou Non disponible : le serveur n'a pas fourni la valeur.
- Masqué : le groupe sous-jacent compte moins de k personnes, la valeur est masquée pour protéger les personnes.
- Non calculable : taux ou ratio sans dénominateur, par exemple aucune entité détectée.
Agent qui ne redirige plus
Si l'agent cesse de rediriger, la cause la plus fréquente est le driver qui ne répond plus au service, ou un conflit avec une autre couche réseau. Le comportement dépend du mode configuré.
- fail-open : le driver cesse de rediriger. Le trafic sort sans inspection. Un événement est écrit.
- fail-closed : seules les IP des services d'IA connues sont bloquées. Le reste du trafic passe. Un événement est écrit.
- Redémarrez le service de l'agent. Si le driver ne charge pas, consultez les journaux Windows ou Linux.
- Vérifiez l'état des canaux dans la console : un canal inactif n'est jamais déchiffré.
Application non inspectable
Certaines applications refusent le certificat de la CA locale. Elles pratiquent l'épinglage de certificat. L'agent les marque comme non inspectables et applique la politique configurée.
- Relayer : la connexion passe sans inspection, un événement est écrit une fois par jour et par couple processus-domaine.
- Bloquer : les connexions suivantes de ce couple sont bloquées, un événement est écrit.
- Extension : pour les navigateurs, bascule vers l'extension de repli déployée par stratégie.
Enrôlement d'un poste
- Jeton expiré : les jetons d'enrôlement sont à usage unique et valides 24 heures. Demandez un nouveau jeton depuis la console.
- Jeton consommé : un jeton ne peut servir qu'une fois. Générez-en un nouveau pour chaque poste.
- Horloge décalée : un décalage supérieur à cinq minutes avec le serveur empêche l'enrôlement TLS mutuel.
- Clé publique de licence inconnue : la licence est émise pour un tenant différent. Vérifiez l'identifiant du tenant.
Limites fonctionnelles de l'agent Windows
Le paquet Windows actuel ne couvre pas encore tous les scénarios. Voici ce qui est inspecté et ce qui ne l'est pas dans la préproduction.
- Le canal Interface web est protégé pour les services du catalogue.
- Le canal Application desktop n'a pas encore d'entrée au catalogue. La redirection WFP et le relais TLS fonctionnent, mais aucun blocage DLP n'est appliqué sur le contenu de ces applications.
- Le canal Assistant de code n'a pas d'entrée IDE livrée dans le catalogue par défaut.
- Les drivers de préproduction sont signés en test. L'activation de testsigning est requise et désactive une partie des protections de démarrage de Windows.
- Les navigateurs installés hors MSI du système, par exemple en Store, peuvent nécessiter une stratégie dédiée pour faire confiance à la CA locale.
Limites fonctionnelles de l'agent Linux
- Le canal Interface web est protégé pour les services du catalogue, dans Chrome .deb et dans le Firefox Snap d'Ubuntu.
- Les navigateurs installés en Flatpak ont leur propre magasin de confiance. Ils ne sont pas couverts par le build actuel.
- L'OCR des PDF scannés et des images n'est pas disponible sous Linux dans ce build.
- Le canal Application desktop n'a pas d'entrée au catalogue : la redirection est validée, pas le blocage DLP du contenu.
- Linux ARM64 n'est pas livré. Seule l'architecture x86_64 est disponible.
Base locale et rétention
L'agent stocke les événements dans une base SQLite chiffrée en AES-256, sur le poste. La rétention par défaut est de 90 jours ou 2 Go, selon ce qui arrive en premier. Ces valeurs sont configurables.
- Les événements sont chaînés par HMAC-SHA-256 et ancrés par des sceaux horaires signés.
- Aucune valeur sensible n'est écrite dans la base locale. Seules les métadonnées de détection sont retenues.
- Au-delà de la limite, les événements les plus anciens sont purgés.