Installer l'Agent MKController sur MikroTik
Résumé L’Agent MKController est une petite application de bureau qui analyse votre réseau local, découvre les appareils MikroTik et vous permet de les adopter dans MKController en un seul clic — remplaçant l’exécution manuelle de scripts pour les déploiements sur site. Ce guide explique ce que fait l’agent, comment l’installer sur Windows, macOS et Linux, et comment gérer l’avertissement de certificat qui apparaît lors de l’installation.
Qu’est-ce que l’Agent MKController ?
L’Agent MKController est un assistant de bureau léger qui fait le lien entre votre réseau local et la plateforme cloud MKController. Il s’exécute sur votre ordinateur, analyse le LAN à la recherche d’appareils MikroTik compatibles et les présente dans le flux d’adoption de la plateforme avec un bouton Adopter en un clic — supprimant la nécessité de copier et d’exécuter manuellement des scripts d’adoption sur chaque appareil.
Pour les équipes familières avec l’Outil de Découverte d’Appareils UniFi ou des assistants similaires d’autres fournisseurs, le flux de travail est directement comparable : un processus local gère la découverte, et la plateforme cloud gère l’administration.
La distinction clé : la découverte et l’adoption sont des actions distinctes. L’agent localise les appareils éligibles et les affiche pour vous — il n’adopte ni ne modifie rien automatiquement. Chaque adoption requiert votre confirmation explicite.
Quand Utiliser l’Agent plutôt que la Méthode Manuelle ?
| Scénario | Méthode recommandée |
|---|---|
| Premier déploiement sur un nouveau site avec plusieurs appareils | Agent — découvre tous les appareils compatibles en une fois |
| Adoption à distance d’un appareil déjà en ligne | Script manuel via WebFig, Winbox ou SSH |
| Préparation en laboratoire avant expédition au site client | Agent |
| Appareil unique, le technicien a déjà accès à la CLI | Script manuel |
| Visites récurrentes sur les sites clients | L’agent accélère l’intégration répétée |
Où l’Agent Apparaît-il dans MKController ?
Sur un nouveau compte sans appareils, MKController met en évidence deux chemins d’intégration : installer l’agent ou utiliser le script manuel.
Sur les comptes qui ont déjà des appareils, le menu Ajouter un Appareil inclut l’option de l’Assistant d’Adoption.
Un indicateur de statut dans le coin inférieur gauche de la plateforme indique si l’agent est Actif (vert), En attente ou Inactif — pour que vous sachiez toujours si l’assistant de bureau est prêt à analyser.
Comment Installer et Connecter l’Agent ?
Le flux d’installation comporte trois étapes : télécharger, appairer, confirmer.
- Cliquez sur Télécharger l’Agent dans MKController.
- Exécutez le programme d’installation téléchargé sur votre ordinateur.
- Copiez le code d’appairage affiché sur la plateforme.
- Collez ce code dans l’application de bureau.
- Attendez que la plateforme confirme la connexion — aucune configuration manuelle n’est requise.
Une fois le code saisi, la connexion s’établit automatiquement. Aucune règle de découverte, aucune commande de terminal, aucune exception de pare-feu n’est nécessaire.
Pourquoi le Système d’Exploitation Affiche-t-il un Avertissement de Certificat ?
Les certificats MKController sont actuellement en cours d’approbation. Durant cette période, Windows, macOS et Linux peuvent afficher une alerte de sécurité lors de l’exécution du programme d’installation. Il s’agit d’un comportement attendu pour les logiciels nouvellement distribués dont l’approbation de certificat est en attente — cela n’indique pas que l’agent est dangereux.
Windows : Si le système affiche un avertissement d’application protégée, cliquez sur Plus d’informations et autorisez l’installation. Les environnements d’entreprise peuvent nécessiter une approbation ponctuelle de l’administrateur informatique.
macOS : Si macOS bloque le programme d’installation, accédez à Réglages Système → Confidentialité et Sécurité, faites défiler vers le bas et approuvez l’application bloquée. Relancez ensuite le programme d’installation.
Linux : Assurez-vous que le fichier téléchargé dispose des droits d’exécution. Dans les environnements restreints, votre administrateur devra peut-être approuver la source du paquet.
Comment Confirmer que l’Agent est en Ligne ?
Lorsque l’agent est installé et en cours d’exécution, MKController affiche son statut Actif en vert dans le coin inférieur gauche de la plateforme.
À ce stade, l’Assistant d’Adoption peut analyser votre réseau et lister les appareils détectables.
Comment Analyser et Adopter des Appareils ?
Avec l’agent en ligne, MKController analyse le réseau local et liste les appareils compatibles avec un bouton Adopter à côté de chacun.
Quelques remarques pratiques :
- L’analyse atteint les appareils sur le réseau où l’ordinateur de l’agent est en cours d’exécution.
- Les appareils doivent être accessibles sur ce segment de réseau.
- La connectivité Internet reste nécessaire, car le flux d’adoption est coordonné par la plateforme MKController.
Après l’adoption, les appareils peuvent être physiquement déplacés vers n’importe quel réseau disposant d’un accès Internet et rester administrables via MKController.
Que se Passe-t-il Lorsque l’Agent se Déconnecte ?
Si l’assistant de bureau cesse de fonctionner ou perd l’accès à Internet, MKController affiche son statut hors ligne et propose une procédure de récupération.
Étapes de récupération :
- Rouvrez l’application de bureau si elle était fermée.
- Vérifiez que l’ordinateur dispose d’un accès Internet.
- Utilisez Tester l’Agent ou Reconfigurer l’Agent si demandé.
- Revenez dans MKController et attendez que l’indicateur de statut passe au vert.
Besoin d’aide pour l’installation ? Contactez notre équipe sur WhatsApp — nous pouvons vous guider pour tout problème spécifique à votre système d’exploitation.