Configuration Mikhmon : connecter votre routeur MikroTik pas à pas
Mis à jour le · Équipe MonMikroTik
La configuration de Mikhmon se résume à une chose : permettre à Mikhmon de dialoguer avec votre routeur MikroTik par l'API RouterOS. Une fois cette connexion établie, vos profils, utilisateurs et tickets hotspot apparaissent et vous pouvez tout gérer. Ce guide détaille chaque étape avec Mikhmon Online, la version cloud de Mikhmon : rien à installer, et le routeur reste joignable même sans IP publique.
Étape 1 : activer l'API sur le routeur
Mikhmon passe par le service API du routeur (port 8728). Dans Winbox, ouvrez IP > Services et activez la ligne api, ou tapez dans New Terminal :
/ip service enable api
Si le champ Available From de la ligne api est rempli, il doit autoriser l'adresse d'où Mikhmon se connecte ; laissez-le vide en cas de doute.
Étape 2 : créer un utilisateur API dédié
Évitez d'utiliser le compte admin : créez un utilisateur réservé à Mikhmon, avec un mot de passe solide. Il doit appartenir au groupe full (ou à un groupe qui a la politique write), sinon Mikhmon pourra lire mais pas créer de tickets ni modifier les profils.
/user add name=mikhmon group=full password=VotreMotDePasseSolide
Étape 3 : rendre le routeur joignable
Mikhmon Online tourne sur nos serveurs : il doit pouvoir joindre votre routeur depuis Internet. Deux cas :
- Le routeur a une IP publique fixe : utilisez-la comme adresse du routeur. Limitez alors l'accès à l'API avec le champ Available From.
- Le routeur est derrière une box 4G ou fibre (cas le plus courant) : installez le VPN MonMikroTik et utilisez l'IP Tunnel affichée sur la fiche du VPN. Aucun port à ouvrir.
192.168.x.x ne fonctionne pas avec Mikhmon Online : elle n'est joignable que depuis votre réseau local. Voir Accéder à son MikroTik sans IP publique.
Étape 4 : ajouter le routeur dans Mikhmon Online
Dans votre espace, ouvrez Mikhmon Online et ajoutez un routeur. Voici où trouver chaque information :
| Champ | Que mettre ? |
|---|---|
| Nom | Un nom pour reconnaître le site, par exemple « Café Central ». |
| Adresse du routeur | L'IP Tunnel du VPN, ou l'IP publique du routeur. |
| Utilisateur et mot de passe API | Ceux créés à l'étape 2. |
| Nom du serveur hotspot | Colonne Name de /ip hotspot print, par exemple hotspot1. |
| Nom DNS du hotspot | Champ dns-name de /ip hotspot profile print, par exemple wifi.bf. |
| Devise | La monnaie affichée sur les tickets et les rapports (FCFA…). |
| Version Mikhmon | V3 pour RouterOS v6 et v7.0 à 7.9, V7 pour RouterOS 7.10 et plus. Voir Mikhmon V7 ou V3 ? |
Choisissez la durée d'abonnement (1 crédit par mois, ou 10 crédits pour 12 mois) puis enregistrez.
Étape 5 : tester la connexion
Dans la liste des routeurs, cliquez sur Tester la connexion. Quand le routeur répond, le bouton d'accès au tableau de bord Mikhmon s'active : vos profils, utilisateurs actifs et tickets existants s'affichent immédiatement, sans rien réimporter.
Étape 6 : configurer les profils et le format des tickets
- Profils utilisateurs (menu Hotspot > User Profiles) : pour chaque forfait, réglez la validité (par exemple
1d), le prix et le mode d'expiration (Remove & Record ou Notice & Record pour enregistrer les ventes). Mikhmon installe alors les scripts qui font expirer les tickets. - Format des tickets : dans les détails du routeur, choisissez le type de code, les caractères, la longueur et un préfixe. Il s'applique à tous les tickets générés pour ce routeur.
Vous êtes prêt à créer et imprimer vos tickets Mikhmon.
Problèmes fréquents
| Problème | Solution |
|---|---|
| Connexion refusée ou délai dépassé | L'API est désactivée, limitée par Available From, ou l'adresse n'est pas joignable : vérifiez l'étape 1 et utilisez l'IP Tunnel du VPN. |
| Identifiants refusés | Vérifiez l'utilisateur et le mot de passe API (attention aux majuscules). |
| « not enough permissions » | L'utilisateur API est en lecture seule : mettez-le dans le groupe full (System > Users). |
| Aucun utilisateur actif ou mauvais serveur | Le nom du serveur hotspot ne correspond pas : reprenez /ip hotspot print. |
| Les tickets n'expirent pas | La version Mikhmon ne correspond pas à RouterOS : voir Tickets Mikhmon qui n'expirent pas. |