Si vous utilisez Tactical RMM avec MeshCentral et que vous rencontrez un écran noir lors de la connexion à vos agents, cet article vous guide pas à pas pour résoudre ce problème.
Pourquoi l’écran noir apparaît ?
L’écran noir se produit généralement lorsque :
- Le hash du certificat TLS/SSL de l’agent ne correspond pas à celui enregistré sur le serveur.
- Une mise à jour ou un renouvellement de certificat a été effectué.
- L’agent a été réinstallé, créant une incompatibilité temporaire avec le serveur.
Résultat : l’agent refuse de se connecter correctement, affichant un écran noir (ou blanc selon les cas) au lieu du bureau à distance.
Étape 1 : Localiser le fichier de configuration
Le fichier principal de configuration de MeshCentral se trouve généralement ici :
/meshcentral/meshcentral-data/config.json
Astuce : faites une sauvegarde avant toute modification :
cp /meshcentral/meshcentral-data/config.json /meshcentral/meshcentral-data/config.json.backup
Étape 2 : Modifier le fichier config.json
- Ouvrez le fichier avec votre éditeur préféré :
nano /meshcentral/meshcentral-data/config.json
- Dans la section
"domains", ajoutez le paramètre suivant :
"IgnoreAgentHashCheck": true
Exemple concret :
"domains": {
"": {
"title": "Tactical RMM",
"AllowLoginToken": true,
"IgnoreAgentHashCheck": true
}
}
💡 Explication : Ce paramètre permet à MeshCentral d’ignorer la vérification du hash de l’agent, corrigeant ainsi l’écran noir tout en conservant la connexion fonctionnelle avec Tactical RMM.
Étape 3 : Redémarrer MeshCentral
Pour appliquer les modifications, redémarrez le serveur MeshCentral :
systemctl restart meshcentral
ou, si vous utilisez Node.js directement :
node /meshcentral/meshcentral
Étape 4 : Vérifier la connexion
- Connectez-vous à vos agents via Tactical RMM.
- L’écran noir devrait avoir disparu.
- Les agents doivent maintenant afficher correctement le contrôle à distance correctement et être pleinement opérationnels.
⚡ Astuces supplémentaires
- Vérifiez toujours les mises à jour de MeshCentral et Tactical RMM pour éviter les conflits de certificats.
- Conservez une sauvegarde régulière du fichier config.json.
- Si le problème persiste, revérifiez les certificats TLS/SSL utilisés par le serveur.
Conclusion
L’écran noir sur MeshCentral avec Tactical RMM est un problème courant lié aux hash des certificats.
En ajoutant "IgnoreAgentHashCheck": true dans le fichier config.json et en redémarrant le serveur, vous restaurez rapidement la connexion des agents sans compromettre la sécurité globale.
