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.

Votre routeur n'est pas encore configuré en hotspot ? Commencez par le générateur de configuration : il prépare le hotspot, les profils au format Mikhmon et le VPN en une seule fois. Revenez ensuite à l'étape 3.

É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.
Une adresse locale du type 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 :

ChampQue mettre ?
NomUn nom pour reconnaître le site, par exemple « Café Central ».
Adresse du routeurL'IP Tunnel du VPN, ou l'IP publique du routeur.
Utilisateur et mot de passe APICeux créés à l'étape 2.
Nom du serveur hotspotColonne Name de /ip hotspot print, par exemple hotspot1.
Nom DNS du hotspotChamp dns-name de /ip hotspot profile print, par exemple wifi.bf.
DeviseLa monnaie affichée sur les tickets et les rapports (FCFA…).
Version MikhmonV3 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èmeSolution
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ésVé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 serveurLe nom du serveur hotspot ne correspond pas : reprenez /ip hotspot print.
Les tickets n'expirent pasLa version Mikhmon ne correspond pas à RouterOS : voir Tickets Mikhmon qui n'expirent pas.

Gérez votre hotspot MikroTik depuis le cloud

Mikhmon Online, vente de tickets par Orange Money et Moov Money, revendeurs et VPN. Inscription gratuite.