Le manuel d'utilisation complet — de la première installation aux opérations quotidiennes.
25 sujets8 sectionsInstallation en une seule commande
Installation rapide
En ligne en quelques minutes, via une seule commande.
Exécutez une seule ligne de commande sur un serveur Ubuntu ou Debian vierge — ou dans PowerShell sur Windows — et l'installateur récupère la dernière version et configure l'ensemble de la pile SAMM pour vous.
SAMM — SecuryTik Active Mikrotik
Manager — est une plateforme de gestion ISP complète pour les réseaux MikroTik PPPoE
& Hotspot. Un seul installateur transforme un serveur Linux vierge en un système complet de AAA,
de facturation et de gestion des abonnés.
À qui s'adresse SAMM
SAMM est conçu pour les FAI sans fil, les opérateurs de fibre et les fournisseurs de hotspots utilisant MikroTik RouterOS. Si vous authentifiez vos abonnés via PPPoE, Hotspot ou IPoE/DHCP et que vous devez appliquer des paliers de débit, des quotas de données, des dates d'expiration et la facturation — SAMM gère tout cela depuis un seul écran.
Les abonnés IPoE/DHCP sont identifiés par le circuit-id de l'Option 82 DHCP (le port d'accès physique — la méthode professionnelle des ISP) ou par l'adresse MAC de l'appareil, et le radius-password du serveur DHCP est simplement le secret partagé RADIUS du routeur ; il n'y a donc rien de plus à configurer.
Le IPv6 dual-stack est une option facultative : chaque abonné peut bénéficier de l'IPv6 en complément de l'IPv4. Activez-le dans l'assistant du routeur et choisissez la longueur du préfixe délégué (DHCPv6-PD) — /56 par défaut, ou entre /48 et /64 — ainsi que les blocs IPv6 à distribuer. Pour chaque Access-Accept, SAMM renvoie un pool IPv6 WAN ainsi qu'un préfixe routé délégué au LAN de l'abonné, afin que le routeur du client (en mode route) le subdivise en /64 et exécute SLAAC pour ses appareils — le modèle standard de délégation de préfixe des ISP. Cela fonctionne avec PPPoE, Hotspot et IPoE, et un préfixe IPv6 statique peut être assigné par abonné pour les clients professionnels.
Fonctionnement
SAMM maintient le chemin critique à proximité de la base de données. FreeRADIUS gère chaque paquet d'authentification et de comptabilité ; à chaque Interim-Update de comptabilité, il appelle directement des fonctions PostgreSQL pour cumuler la consommation et évaluer les limites — il n'y a aucun aller-retour via Python pendant que les abonnés sont en ligne.
Quatre surfaces d'exécution coopèrent via une base de données unique :
FreeRADIUS (unlang + rlm_sql) — authenticates
every packet; on each Interim-Update it accumulates bytes/uptime and evaluates limits inside Postgres.
samm-radius — runs time-driven sweeps (expiry, daily reset, speed
windows) and is the only process that sends Change-of-Authorization packets.
samm-worker — pings routers and syncs MikroTik device metadata over the API.
samm-api — the admin & customer portals; admin actions are queued
to the database and applied by samm-radius, never sent as CoAs directly.
Les cinq services
Service
Rôle
samm-api
Portail administrateur + portail libre-service client + REST API
samm-radius
Vide la boîte d'envoi CoA ; exécute les balayages d'expiration / de réinitialisation quotidienne / de fenêtre de débit
samm-worker
Ping les routeurs ; synchronise les métadonnées des appareils MikroTik via l'API
samm-notification
Envoie des notifications par e-mail & Telegram via une file d'attente régulée
samm-telegram
Exécute le bot Telegram interactif de self-service
Rôle de SAMM
Cœur AAA
Authentification PPPoE & Hotspot, limitation de la vitesse par utilisateur, CoA hybride.
Forfaits & limites
Paliers de vitesse, ainsi que quatre limites indépendantes et des plages horaires de vitesse programmées.
Abonnés
Utilisateurs PPPoE, Hotspot et IPoE/DHCP, ainsi que des coupons hotspot prépayés avec PDF imprimables.
Facturation
Tarification par forfait, facturation automatique, un grand livre de recettes/paiements/dépenses en partie double.
Self-service
Un portail web client et un bot Telegram pour le suivi de la consommation, les factures et les tickets.
Opérations
Inventaire MikroTik en temps réel, administrateurs basés sur les rôles, sauvegarde & restauration, outils de traitement par lot.
Alertes de renouvellement, d'expiration, de quota et de reçu par e-mail et Telegram.
Le reste de ce manuel est un guide pratique pour chacun de ces domaines. Utilisez le menu à gauche, ou commencez par Installation.
Prise en main
Nouveautés
SAMM se met à jour automatiquement, donc chaque installation bénéficie de ces fonctionnalités lors de sa prochaine mise à jour. Chaque ligne renvoie vers la page expliquant comment les utiliser.
6.0
Modèles de cartes : concevez votre carte Hotspot imprimée (taille, arrière-plan, votre logo, un code QR qui connecte la carte en un seul scan), ou partez de dix modèles prêts à l'emploi. Chaque groupe garde un modèle pour l'impression et un pour l'impression rapide sur imprimante thermique (80 ou 58 mm). Cartes Hotspot
Ajouter une carte ou importer une liste : + Card ajoute une carte avec l'identifiant, le mot de passe et le nom de votre choix ; Import charge une liste CSV ou Excel, avec un aperçu. Cartes Hotspot
Temps et données restants sur le routeur : la page d'état Hotspot affiche ce qui reste sur une carte, et le routeur termine la session quand elle est épuisée. Cartes Hotspot
Un pool IP par utilisateur (par exemple un pool CGNAT), choisi parmi les pools de vos routeurs. CGNAT et pools IP
Tous les fuseaux horaires du monde, avec le Moyen-Orient en tête de liste.
Inspection approfondie : choisissez vos BNG MikroTik et la durée, puis lisez un rapport avec une note et ce qu’il faut faire en premier, dans votre langue, en page ou en PDF. Elle ne fait que lire le routeur. Inspection approfondie
SCOOP AI : un assistant en bas de chaque page. Posez vos questions avec vos mots sur vos utilisateurs, forfaits, factures et routeurs ; les montants, suppressions et modifications de routeur attendent votre Approve. SCOOP AI
Files d’attente utilisateurs plus rapides : garde les appels et les jeux fluides pendant qu’un utilisateur télécharge. L’assistant de routeur peut la configurer, et Health propose une correction en un clic.
Tableau de bord par rôle : choisissez si un rôle voit le tableau de bord. Un rôle sans lui s’ouvre sur sa première page autorisée.
Sham Cash : sur la connexion non officielle, un utilisateur qui a oublié le code peut confirmer le paiement avec le numéro de virement et sa propre adresse.
5.12
Conservation des données et Lookup : conservez les sessions pendant la durée exigée par la loi (deux ans par défaut), y compris pour les utilisateurs supprimés, et trouvez quel utilisateur avait une adresse publique et un port à un moment donné. Chaque recherche nécessite une référence de dossier et est consignée dans le journal Lookup ; un fichier chiffré quotidien peut être envoyé à votre NAS. Conservation des données & Lookup
CGNAT et pools IP : partagez des adresses publiques entre utilisateurs, chacun avec un bloc de ports, ou laissez SAMM attribuer lui-même l'adresse aux utilisateurs, par routeur et par forfait. CGNAT & pools IP
Cisco, Huawei, Nokia et ZTE comme NAS, avec débits, déconnexions, une page de configuration prête à l'emploi, le Data Log et le CGNAT sur Cisco. Autres marques de routeurs
FTTH : OLT de V-SOL, Huawei, ZTE et Nokia, chaque ONU avec son signal, ONU liées aux utilisateurs, et le verrouillage de la ligne d'abonné. FTTH & OLTs
Pages d'équipement pour chaque marque : CPU, mémoire, température, durée de fonctionnement et graphiques pour les OLT et autres routeurs, comme MikroTik ; le formulaire du routeur demande le bon identifiant pour chaque type. Autres marques de routeurs
VPN via SAMM par routeur : Via SAMM ou Via le routeur ; les paiements Sham Cash ne passent jamais par le VPN. VPN via SAMM
Consommation des utilisateurs : une carte Période sélectionnée (total, sessions, temps en ligne) et une bande avec forfait, statut, expiration, adresse et MAC ; le bot Telegram affiche ses commandes dans la langue de l'utilisateur. Utilisateurs
Nous configurons votre serveur : commandez un serveur SAMM prêt à l'emploi avec votre propre domaine .com depuis votre tableau de bord. Configurez votre serveur
5.11
Caissier : une page de caisse dans Comptabilité. Trouvez un utilisateur par nom, numéro de mobile ou partie du nom d'utilisateur pendant la saisie, puis encaissez son paiement, renouvelez-le, ajoutez du quota ou rechargez son portefeuille en espèces. Elle a sa propre permission à quatre cases, n'affiche ni bénéfices ni rapports et ne trouve que les utilisateurs de l'agence du caissier. Comptabilité, Administrateurs, agences et rôles
Échéance de facture à votre choix : « Facture due après (jours) » dans les paramètres de comptabilité. À 0, une facture est due dès son émission et un renouvellement automatique le jour où le forfait expire, donc le délai de grâce compte à partir de l'expiration. Comptabilité
Compensation de passage à un forfait moins cher : passer un utilisateur à un forfait moins cher peut lui rendre la partie inutilisée de la période, sur son portefeuille ou en espèces, avec le montant affiché avant d'enregistrer. Changer de forfait est aussi dans le menu de ligne de la liste Utilisateurs. Utilisateurs
Le renouvellement automatique se paie depuis le portefeuille, et le portefeuille d'un utilisateur en retard règle la dette avant la suspension du compte. Comptabilité
Notifications par canal : choisissez les canaux de chaque notification, envoyez sur tous, et rédigez un texte SMS distinct avec un compteur de caractères en direct. Notifications
VPN via SAMM sans tunnel pour les routeurs sur le même réseau que SAMM, et contrôle parental et VPN d'un utilisateur gérés depuis le panneau d'administration. VPN via SAMM
Quota d'interface qui se réinitialise correctement : Reset quota recompte à partir de zéro et remet l'interface en service aussitôt, à tout moment, avec la consommation depuis la dernière réinitialisation sur la page. Gestionnaire MikroTik
Listes Sites et applications par routeur : chaque routeur indique si sa liste est à jour, avec Appliquer et des constats sur la page Santé ; les valeurs de surveillance se rafraîchissent toutes les 5 secondes. Gestionnaire MikroTik
5.9
Fournisseurs VPN externes : ajoutez un compte NordVPN, Mullvad, IVPN ou AirVPN en une étape, choisissez le nombre de serveurs et le pays, ou importez des fichiers de n'importe quel fournisseur, comme ProtonVPN. Chaque utilisateur reste sur une seule connexion, les connexions se répartissent la charge selon leur poids et, si l'une s'arrête, ses utilisateurs gardent l'accès à Internet via la ligne propre de SAMM. VPN via SAMM
Quota supplémentaire en option : vendez davantage de données sans modifier le forfait ou l'échéance de l'utilisateur, sous forme de pack ou de prix au GB, depuis le panneau ou le portail utilisateur. Options
Secteurs sans fil : chaque radio utilisateur avec le secteur sur lequel elle se trouve, la durée de présence et chaque déplacement, conservés un an ; les switches derrière vos secteurs avec les utilisateurs de chacun ; et, sur la page utilisateur, la chaîne secteur › radio › switch › utilisateur avec le signal, la portée et la qualité. Réseau
Surveillez un utilisateur pendant 24, 48 ou 72 heures : temps de connexion, débit, signal, secteur et chaque déconnexion avec sa cause, puis un rapport imprimable avec graphiques et une brève conclusion. Utilisateurs
Carte du réseau sur OpenStreetMap : placez vos routeurs, secteurs et utilisateurs à leur emplacement réel, à côté du schéma. Réseau
Mises à jour de la liste d'applications : SAMM vérifie chaque jour la liste d'applications de SecuryTik ; choisissez « Me prévenir », « Appliquer automatiquement » ou « Désactivé », et rétablissez la liste précédente en un clic. Gestionnaire MikroTik
Dates « Du » et « Au » dans chaque recherche qui comporte une date, filtres « Contrôle parental » et VPN sur la liste des utilisateurs, et la même page ouverte dans autant de fenêtres que vous avez d'écrans. Utilisateurs, Tableau de bord
Migration depuis ADV Radius : importez utilisateurs et forfaits depuis son fichier de sauvegarde, avec les mots de passe, les dates d'échéance, les adresses statiques et les limites de forfait. Outils
5.8
VPN externe : les utilisateurs VPN sortent par NordVPN (avec un jeton d'accès) ou les fichiers WireGuard de n'importe quel fournisseur au lieu de la ligne de SAMM, même quand SAMM n'a pas d'adresse publique. VPN via SAMM
VPN via SAMM : les utilisateurs choisis font sortir tout leur trafic, ou seulement les applis qu'ils sélectionnent, par votre serveur SAMM au lieu de leur ligne locale. Autorisez-le par utilisateur ou vendez-le comme extension ; les utilisateurs l'activent dans le portail utilisateur. VPN via SAMM
SAMM sur deux écrans : ouvrez n'importe quelle page, ou un seul bloc du tableau de bord, dans sa propre fenêtre et gardez-la sur un second écran. Tableau de bord
Le contrôle parental en extension : vendez le contrôle parental pour une durée, comme toute autre extension. Extensions
Optimiseur Wi-Fi : une vue du spectre en temps réel de chaque radio, des réseaux détectés et du taux d'occupation de chaque canal, avec un planificateur de canaux qui recommande le canal le moins encombré ainsi que la largeur optimale, et peut modifier les canaux des radios automatiquement la nuit. Réseau
Appareils Ubiquiti : ajoutez des points d'accès UniFi et des radios airOS en tant qu'appareils surveillés. Les radios UniFi affichent leurs clients, les réseaux voisins et le spectre, et l'optimiseur les déplace réellement vers un meilleur canal et une largeur de bande optimisée. Gestionnaire MikroTik
Trois moniteurs pour chaque routeur sur chaque forfait : les points d'accès et les radios que vous surveillez uniquement ne consomment plus votre quota de routeurs. Gestionnaire MikroTik
Importez les utilisateurs déjà présents sur un routeur (PPP, Hotspot et User Manager, RouterOS 6 et 7) avec leurs mots de passe, forfaits, limites, noms, numéros de téléphone et dates d'expiration, en arrière-plan. Gestionnaire MikroTik
Annuler un renouvellement : la suppression de la facture d'un renouvellement peut rétablir la date d'expiration de l'utilisateur, l'action Renew Plan peut être annulée depuis la barre supérieure, et la liste des Invoices affiche les totaux de tous les éléments correspondant au filtre. Annulations & approbations
Sauvegardes vers votre propre Google Drive. Connectez Google Drive dans Backup & Restore à l'aide d'un code court ; chaque sauvegarde automatique est ensuite également copiée dans un dossier SAMM Backups de votre Drive, et toute copie peut être récupérée pour être restaurée. Outils
Heure de renouvellement fixe sur un forfait : chaque expiration survient à l'heure que vous choisissez, arrondie à la hausse pour qu'un utilisateur ne bénéficie jamais d'une période inférieure à celle prévue. Plans
Liste d'adresses par forfait : le routeur ajoute l'adresse de chaque utilisateur à une liste portant le nom de son forfait, pour vos propres règles de pare-feu, de file d'attente et de routage. Plans
Mode Collect Self Service : les invités saisissent leur nom et leur numéro de mobile et sont connectés instantanément, sans code d'accès ; chaque connexion est conservée pour l'exportation. Self Service
Un graphique de qualité de connexion plus lisible avec des axes, des lignes de téléchargement et d'envoi, des détails au survol et les données utilisées, ainsi que l'e-mail dans la recherche d'utilisateurs et n'importe quel port dans la recherche du Data Log. Users, Data Log
5.7
Les agences sont propriétaires de leurs appareils. Chaque routeur et point d'accès appartient à une agence ou au siège ; le personnel des agences gère ses propres appareils et ne peut visualiser que ceux situés au-dessus d'eux, et un paramètre permet aux utilisateurs de se connecter uniquement via les routeurs de leur agence. Administrateurs, agences & rôles
Limites de temps des rôles. Limitez le nombre de périodes ou de jours à l'avance qu'un rôle peut accorder, attribuez aux nouveaux utilisateurs une durée fixe (par exemple 2 heures), et séparez l'ajout de jours de la saisie d'une date d'expiration. Administrateurs, agences & rôles
SSTP VPN en plus de WireGuard et L2TP/IPsec, pour plusieurs routeurs derrière la même adresse publique. VPN
RouterOS 6 fonctionne partout : assistant, Auto-Complete, déploiement de configuration, actions groupées, sites Web & applications, QoS et liens VPN. RouterOS 6
Contrôle parental dans le portail utilisateur : bloquer des catégories, des applications et des sites web, en permanence ou via un calendrier hebdomadaire. Contrôle parental
Points & récompenses pour les renouvellements et le parrainage d'amis, utilisables pour augmenter le débit ou obtenir des jours gratuits. Points & récompenses
Votre marque sur le panneau administrateur, le portail utilisateur et les pages de connexion, avec un logo que vous recadrez dans le navigateur. Branding
Sélecteurs de langue, visibilité des forfaits dans le portail, mode des modèles SMS et installation de SAMM en une seule ligne sur un routeur MikroTik. Langues, Forfaits, Conteneur MikroTik
5.6
Livraison de config : chaque modification envoyée à vos routeurs est suivie avec un résultat par routeur, est transmise aux routeurs hors ligne dès leur reconnexion et fait l'objet de tentatives automatiques. Livraison de config
Un tableau de bord qui s'ouvre en environ une seconde, et une barre latérale qui reste fixe lors du changement de page.
5.5
Recherche dans le Data Log pour tous les utilisateurs : qui a accédé à une adresse, un port, un protocole ou une application, sur n'importe quelle période. Data Log
Permissions détaillées sous Modifier (supprimer des utilisateurs, prolonger, changer de forfait, payer des factures, exécuter des scripts de routeur…), et un aperçu de la nouvelle date d'expiration avant le renouvellement. Rôles
5.4
Finances par agence : chaque facture, paiement, dépense et compte de caisse est rattaché à une agence, avec un sélecteur d'agence, des transferts de caisse et un rapport par agence. Comptabilité & facturation
5.3
Sham Cash, un seul tunnel de paiement pour toutes les méthodes de paiement, une Page de paiement publique et le Renouvellement en ligne pour 1 à 12 périodes. Paiements en ligne
Remises sur facture, add-ons avec applications gratuites, rapport d'activations, modification du nom d'utilisateur et acomptes sur les renouvellements. Add-ons
5.2
Dynamic Speed Booster, actions du gestionnaire sur plusieurs routeurs simultanément, modules complémentaires, listes de prix par agence, fichiers utilisateur, champs personnalisés, la page Traffic et le nettoyeur d'historique. Speed Booster, actions du gestionnaire
Prise en main
Installation
SAMM installe tout ce dont il a besoin — FreeRADIUS, PostgreSQL, nginx, WireGuard,
cloudflared et les cinq services SAMM — en une seule étape. L'installateur est
idempotent : le relancer met à jour une installation existante sans modification destructive et
n'écrase jamais votre configuration ni ne régénère le mot de passe de votre base de données.
Manuel d'installation
Chaque étape avec captures d'écran : Windows (y compris l'activation de la virtualisation dans le BIOS), Ubuntu, un routeur MikroTik, un serveur prêt à l'emploi, la licence (payer, lier, renouveler), la connexion de vos routeurs par le VPN et les fonctions supplémentaires.
Un serveur vierge : Ubuntu 22.04 / 24.04 / 26.04 LTS, ou Debian 12 / 13.
Linux version serveur uniquement — les variantes desktop ne sont pas prises en charge.
Accès Root / sudo et connexion internet.
systemd, et un hôte sur lequel PostgreSQL peut être installé localement (l'un d'eux est déjà configuré pour vous).
Ce script de bootstrap télécharge le dernier bundle de version de SAMM depuis GitHub, l'extrait et exécute automatiquement l'installateur complet. L'opération est terminée en quelques minutes.
Si github.com est bloqué dans votre pays, utilisez plutôt le miroir hébergé par Cloudflare — même installateur, aucun élément n'est récupéré depuis GitHub. (La commande standard ci-dessus détecte également si GitHub est bloqué et bascule automatiquement vers ce miroir.)
Dans les deux cas, une fois l'installation terminée, ouvrez le portail administrateur et connectez-vous avec ces identifiants :
URL de connexionhttp://<your-server>/admin·Nom d'utilisateuradmin·Mot de passeadmin
Changez le mot de passe de l'administrateur immédiatement après votre première connexion.
Installation
Option B — installation sur Windows (Hyper-V)
SAMM s'exécute sur Windows au sein de sa propre petite machine virtuelle Ubuntu 24.04 sur Hyper-V, créée et gérée par un seul installateur. La VM rejoint votre réseau avec sa propre adresse IP, permettant ainsi à vos routeurs MikroTik de joindre SAMM directement — RADIUS voit l'adresse réelle de chaque routeur et les déconnexions CoA fonctionnent — exactement comme avec un serveur Linux.
Ouvrez PowerShell en tant qu'administrateur — et non l'invite de commande (cmd) :
faites un clic droit sur le bouton Démarrer, choisissez Terminal (Admin) ou Windows
PowerShell (Admin), répondez Oui. Exécutez ensuite :
Si samm.securytik.com est inaccessible depuis ce PC, utilisez plutôt le miroir hébergé par Cloudflare — il s'agit du même installateur. (L'installateur bascule lui-même vers le miroir lorsqu'un téléchargement échoue.)
Dans les deux cas, une fois l'installation terminée, ouvrez le portail administrateur et connectez-vous avec ces identifiants :
URL de connexionhttp://<SAMM IP>/admin·Nom d'utilisateuradmin·Mot de passeadmin
Connexion à l'OS (SSH)samm / samm·Root (console)root / samm
Les mêmes valeurs par défaut que l'ISO du serveur SAMM. Modifiez-les toutes après votre première connexion. Le raccourci SAMM Info sur le bureau les affiche à nouveau, ainsi que l'adresse IP de SAMM et la procédure pour accéder à la VM via SSH.
Ce qui est demandé
Quel réseau SAMM doit rejoindre lorsque le PC possède plus d'un adaptateur connecté. Appuyez sur Enter pour sélectionner le réseau recommandé (filaire avant Wi-Fi).
L'adresse IP de SAMM sur ce réseau. Une adresse libre est suggérée ;
appuyez sur Enter pour l'accepter, saisissez-en une autre ou tapez dhcp.
Si Hyper-V est désactivé, l'installateur l'active et demande de redémarrer Windows une fois ; après vous être reconnecté, il reprend l'installation automatiquement. Le reste — Multipass, le pont réseau, la VM et SAMM lui-même — prend 10 à 20 minutes, avec une barre de progression.
Prérequis
Windows 10 / 11 Pro, Enterprise ou Education, ou Windows Server 2019 et versions ultérieures (64 bits). Windows Home ne dispose pas de Hyper-V.
Virtualisation matérielle activée dans le BIOS/UEFI (Intel VT-x ou
AMD-V). L'installateur vérifie ce paramètre et s'interrompt avec un message explicite s'il est désactivé — voir
Activer la virtualisation.
Au moins 8 GB de mémoire, dont 4 GB libres pour la VM de SAMM (le minimum est de 3 GB ; les autres machines virtuelles — VMware, VirtualBox — sont décomptées de ce total), et 40 GB d'espace disque libre.
L'utilisation d'un câble réseau est fortement recommandée. De nombreux pilotes Wi-Fi ne permettent pas de ponter une machine virtuelle sur le réseau, ce qui fait que seul le PC lui-même peut accéder à SAMM.
Après l'installation
Ouvrez le panneau administrateur à l'adresse http://<SAMM IP>/admin/login (un raccourci SAMM Admin se trouve sur le bureau), connectez-vous avec admin / admin et changez immédiatement le mot de passe.
Configurez votre RADIUS MikroTik vers l'IP du SAMM (UDP 1812/1813) — l'assistant de routeur dans le panneau s'en charge pour vous.
SAMM démarre avec Windows, avant toute ouverture de session, et le PC est configuré pour ne jamais se mettre en veille. Sur un ordinateur portable, laissez le chargeur connecté et configurez la fermeture du capot sur « Ne rien faire ».
Pour le supprimer : exécutez la même ligne avec -Uninstall, ou
& ([scriptblock]::Create((irm https://samm.securytik.com/install-windows.ps1))) -Uninstall.
Installation
Activer la virtualisation dans le BIOS/UEFI
SAMM sur Windows s'exécute dans une machine virtuelle Hyper-V, laquelle nécessite la fonction de virtualisation du processeur : Intel Virtualization Technology (VT-x) sur Intel, ou AMD-V — généralement appelée SVM Mode — sur AMD. La plupart des PC sont livrés avec cette option activée ; certains l'ont désactivée. Chaque marque la place dans un menu différent, voici donc les étapes générales et l'endroit où elle se trouve habituellement.
Vérifiez d'abord s'il est déjà activé
Ouvrez le Gestionnaire des tâches (Ctrl+Maj+Échap) → Performance →
CPU. Sous le graphique, la mention Virtualisation : Activé confirme que l'opération est terminée.
(Si Hyper-V est déjà activé, Windows peut afficher à la place qu'un hyperviseur a été détecté —
cela signifie également qu'il est activé.)
Étapes générales
Enregistrez votre travail et redémarrez le PC.
Ouvrez la configuration BIOS/UEFI : appuyez plusieurs fois sur la touche de configuration dès que l'écran s'allume (voir le tableau). Sur Windows 10/11, vous pouvez également aller dans Paramètres → Système → Récupération → Démarrage avancé → Redémarrer maintenant, puis Dépannage → Options avancées → Paramètres du micrologiciel UEFI → Redémarrer.
Consultez le menu Advanced, Advanced CPU,
Processor, Chipset, Security ou
Virtualization pour trouver l'option Intel Virtualization Technology,
Intel VT-x, SVM Mode ou AMD-V, et réglez-la sur
Enabled. (Intel VT-d / AMD IOMMU n'est pas nécessaire.)
Enregistrer et quitter (généralement F10), laissez Windows démarrer, puis lancez à nouveau l'installateur SAMM.
Emplacement habituel
Marque
Clé de configuration
Emplacement habituel
Dell
F2
Assistance à la virtualisation → Virtualisation / Activer Intel Virtualization Technology
OC → CPU Features → Intel Virtualization Tech ou SVM Mode
Gigabyte
Del
Tweaker (ou Advanced) → Advanced CPU Settings → Intel Virtualization Technology ou SVM Mode
Serveurs (Dell iDRAC, HPE, Supermicro)
F2 / F9 / Del
Paramètres du processeur → Virtualization Technology — souvent déjà activée
Une machine virtuelle à l'intérieur d'une autre machine virtuelle (Windows s'exécutant lui-même dans VMware, Proxmox ou Hyper-V) nécessite l'activation de la virtualisation imbriquée dans l'hyperviseur externe — par exemple « Virtualize Intel VT-x/EPT » dans les paramètres CPU de VMware, lorsque la VM est éteinte.
Installation
Option C — installation manuelle à partir d'un bundle de version
Téléchargez le dernier samm-<version>.tar.gz depuis la page
GitHub Releases,
puis sur le serveur :
tar -xzf samm-<version>.tar.gz
cd samm-<version>
sudo bash install.sh
Vous pouvez également déployer à partir d'un fichier zip produit sur une autre machine — l'installateur utilise rsync pour copier la source dans /opt/samm :
Ou clonez le dépôt dans /opt/samm et exécutez sudo bash /opt/samm/install.sh.
Dans les deux cas, une fois l'installation terminée, ouvrez le portail administrateur et connectez-vous avec ces identifiants :
URL de connexionhttp://<your-server>/admin·Nom d'utilisateuradmin·Mot de passeadmin
Changez le mot de passe de l'administrateur immédiatement après votre première connexion.
Installation
Option D — installation avec Docker Compose
Si vous préférez exécuter SAMM via des conteneurs — même produit, packaging différent —
utilisez la distribution Docker Compose sur github.com/mhdhaidarah/samm-docker.
Sur tout hôte disposant de Docker :
Cela installe Docker s'il est absent, place un docker-compose.yml dans /opt/samm-docker/ avec un mot de passe de base de données aléatoire et robuste déjà renseigné, et démarre la pile. L'image mhdhaidarah/samm est construite à partir du même bundle compilé que l'installation bare-OS — source fermée par construction.
Multi-arch — le même tag est utilisé pour linux/amd64 et linux/arm64, et la variante appropriée est sélectionnée automatiquement à partir du tag : docker pull sur n'importe quel hôte Docker (Intel/AMD, serveur ARM, Mac Apple-silicon), et MikroTik RouterOS 7.23+ sur le routeur lui-même. Un seul fichier, toutes les plateformes.
Sur les hôtes où le piping de curl vers bash n'est pas autorisé (systèmes verrouillés, politiques de sortie strictes), vous pouvez récupérer directement le fichier compose prêt à l'emploi :
git clone https://github.com/mhdhaidarah/samm-docker.git
cd samm-docker
# optional: edit docker-compose.yml and replace change-me-strong-random-string
docker compose up -d
Certaines fonctionnalités ne sont pas encore disponibles dans la variante Docker (verrouillage progressif de la licence, rechargement dynamique de FreeRADIUS).
Les pages d'administrateur intégrées de WireGuard et Cloudflare Tunnel sont intentionnellement masquées dans la variante Docker — elles gèrent des services systemd au niveau de l'hôte qui ne sont pas accessibles depuis l'intérieur du conteneur. Choisissez l'Option A ou C ci-dessus si vous avez besoin de ces fonctions intégrées, ou exécutez cloudflared / wg-quick directement sur l'hôte Docker aux côtés de SAMM. Consultez le
README de la variante Docker pour l'ensemble des mises en garde de la v1 et le chemin d'installation manuelle.
Sur Windows (Docker Desktop) — évaluation uniquement
Non recommandé pour la production. La mise en veille, l'hibernation ou la fermeture du capot de Windows arrêtent les containers ; le redémarrage au boot ne se déclenche que lorsque WSL démarre (et non au démarrage de Windows) ; le cron de mise à jour automatique quotidienne ne s'exécute que lorsque WSL est actif. Utilisez cette configuration pour l'évaluation ou une démo, puis déployez l'environnement de production sur une VM Linux (Hyper-V, Proxmox, ESXi) ou un petit boîtier physique (par ex. un NUC sous Ubuntu Server).
Installez
Docker Desktop pour Windows (ceci permettra de configurer le backend WSL2 lors du premier lancement).
Ensuite, depuis PowerShell — sans avoir besoin d'un terminal WSL — récupérez le bundle compose et démarrez la stack :
mkdir C:\samm-docker
cd C:\samm-docker
curl.exe -fLO https://github.com/mhdhaidarah/samm-docker/releases/latest/download/docker-compose.yml
# optional: notepad docker-compose.yml — replace change-me-strong-random-string with your own password
docker compose pull
docker compose up -d
Observez le démarrage de la pile dans Docker Desktop → Containers — le groupe samm se déploie en 8 services. Une fois qu'ils sont tous au vert, ouvrez le portail administrateur et connectez-vous avec ces identifiants :
URL de connexionhttp://localhost:8000/admin·Nom d'utilisateuradmin·Mot de passeadmin
Changez le mot de passe de l'administrateur immédiatement après votre première connexion.
Si un véritable NAS MikroTik accède à cet hôte Windows pour RADIUS, autorisez UDP 1812 + 1813 à travers le pare-feu Windows :
Désinstallation : docker compose down -v depuis le répertoire d'installation
(l'option -v efface le volume postgres et la clé Fernet — sauvegardez-les au préalable si vous avez ajouté des données).
Installation
Option E — installer sur un routeur MikroTik (RouterOS 7.23+)
Même SAMM, aucun serveur Linux requis. Si votre appareil MikroTik prend en charge le package container et possède un lecteur USB ou une carte microSD, vous pouvez exécuter l'ensemble de la pile directement sur le routeur — avec le même docker-compose.yml utilisé partout ailleurs. RouterOS 7.23+ récupère automatiquement l'architecture CPU appropriée à partir des tags d'image multi-arch, il n'y a donc rien de spécifique au routeur à télécharger.
Pris en charge : tout routeur MikroTik compatible avec les containers — RB5009, hAP ax², CCR2004-1G-12S+2XS, CCR2116, CCR2216, L009 et similaires (arm64), ainsi que RouterOS x86 et CHR (amd64). Non pris en charge : appareils armv7 / mipsbe / smips / tile / ppc (hEX, RB750, anciens modèles RB) — absence de support des containers ou RAM/CPU insuffisants pour la pile SAMM. RouterOS 7.23 ou plus récent est requis (les versions plus anciennes ne permettent pas de sélectionner l'architecture à partir d'un tag multi-arch).
La méthode rapide : une seule ligne à coller
Ouvrez le terminal du routeur (WinBox → New Terminal, ou SSH) et collez cette ligne :
Il vérifie la version de RouterOS, le CPU et la mémoire du routeur, installe le paquet container, active le mode container, recherche un disque ext4 d'au moins 30 GB, télécharge SAMM avec un mot de passe de base de données aléatoire et robuste, le démarre et attend que le panneau réponde. Lorsqu'il vous le demande (après un redémarrage, après un cycle d'alimentation, après que vous ayez préparé le disque), collez à nouveau la même ligne : chaque étape vérifie ce qui a déjà été fait et poursuit l'opération. Il ne formate jamais un disque de lui-même et ne modifie jamais un élément déjà en cours d'exécution.
Vous préférez le faire manuellement ? Suivez les étapes ci-dessous.
1. Préparation du routeur
Installez le package container (depuis extra_packages.zip sur mikrotik.com/download — envoyez le container-*.npk correspondant via Files, puis redémarrez). Activez ensuite le mode container (une seule fois — il ne s'active qu'après un cycle d'alimentation complet, et non un redémarrage logiciel) :
/system device-mode update container=yes
# HARD reboot the router (unplug the power) — a soft /system reboot
# will NOT activate the container feature
2. Formater et monter le disque (ext4)
Insérez une clé USB ou une carte microSD (≥ 8 GB recommandé — Postgres + les couches d'image prennent de la place). Sur le routeur :
/disk print
# note the disk slot, e.g. "usb1-part1" or "disk1"
/disk format usb1-part1 file-system=ext4 label=samm
Après le formatage, vérifiez que le disque est monté et accessible en écriture :
/disk print detail
# look for "type=ext4" and a mount point like "/usb1-part1"
Indiquez ensuite au routeur où télécharger les images (Docker Hub) et où les extraire — sans cela, chaque conteneur SAMM échouera avec le message "download/extract error: no registry url set":
/container config set registry-url=https://registry-1.docker.io tmpdir=samm/tmp layer-dir=samm/layers
# "samm" = your disk's Mount Point (System > Disks > the disk > Mount Point)
# if layer-dir is refused on your RouterOS version, keep only tmpdir
/ip dns set servers=8.8.8.8,1.1.1.1
:put "ok"
Vous voyez « no registry url set » ou « not enough disk space to download layer » ? Exécutez les lignes ci-dessus — le dossier de téléchargement doit se trouver sur le disque USB/microSD (son point de montage), et non sur le petit stockage interne du routeur. Ensuite, dans App → samm, décochez Enabled, Appliquer, cochez-le à nouveau et Appliquer : le routeur télécharge à nouveau chaque partie de SAMM et le démarre.
3. Copier le fichier compose
Un fichier pour chaque plateforme. Remplacez change-me-strong-random-string (le mot de passe Postgres — utilisez la même valeur forte partout où elle apparaît) et change-me-random-token. Ensuite, dans WebFig/WinBox : Container → Apps → + New → YAML, collez, définissez le disque ext4 de l'étape 2 comme stockage, puis validez. RouterOS 7.23+ récupère automatiquement l'architecture CPU appropriée à partir des tags de l'image.
Bloqué sur "waiting for reverse proxy" ? Sur RouterOS 7.23+, décochez Use HTTPS dans la boîte de dialogue Apps et redéployez — cette option contrôle le proxy de l'interface web de l'app, pas le téléchargement des images.
Une fois que les conteneurs SAMM sont en cours d'exécution, ouvrez le portail administrateur dans un navigateur et connectez-vous avec ces identifiants :
URL de connexionhttp://<router-ip>:8000/admin·Nom d'utilisateuradmin·Mot de passeadmin
Changez immédiatement le mot de passe de l'administrateur. L'authentification et la comptabilité RADIUS sont exposées sur les ports UDP 1812 + 1813 du routeur lui-même ; le client RADIUS MikroTik peut donc pointer vers 127.0.0.1 en utilisant le secret partagé défini dans System → RADIUS.
Chemin de déploiement expérimental. La fonctionnalité de conteneur de RouterOS est plus légère que Docker Compose — le DNS par nom de service, l'ordre des dépendances (depends_on) et les redémarrages à chaud fonctionnent différemment. Si la pile se comporte mal sur votre matériel, revenez à l'exécution de Docker sur une petite machine Linux (NUC, Pi 4, VM Linux) à côté du MikroTik. Le même fichier compose y fonctionnera avec la sémantique complète de Compose.
Maintenir SAMM en cours d'exécution après un redémarrage ou un plantage
RouterOS crée les conteneurs de l'application sans démarrage automatique. Exécutez cette commande une fois après l'installation : chaque conteneur SAMM démarrera avec le routeur et redémarrera en cas d'arrêt, et un watchdog léger relancera tout conteneur arrêté toutes les minutes.
/container set [find where name~"^app-samm"] start-on-boot=yes restart-policy=always
/system scheduler remove [find name=samm-watchdog]
/system scheduler add name=samm-watchdog start-time=startup interval=1m on-event=":foreach c in=[/container find where name~\"^app-samm\" and stopped] do={/container start \$c}"
:put "ok"
5. Mise à jour — sauvegarde et restauration manuelles
La mise à jour d'une application container MikroTik supprime votre base de données.
RouterOS ne peut pas modifier la version d'une application installée sans la remplacer — la seule solution consiste à supprimer
l'application et à l'ajouter à nouveau. Sa suppression efface toutes les données stockées par l'application, y compris la
base de données de SAMM. Effectuez une sauvegarde et procédez au téléchargement sur votre ordinateur AVANT de supprimer l'
application. Une sauvegarde laissée sur le routeur est supprimée avec tout le reste.
Pour migrer l'installation d'un conteneur MikroTik vers une nouvelle version :
Dans SAMM, allez dans Tools → Backup, créez une sauvegarde et
téléchargez le fichier sur votre ordinateur.
Sur le routeur, supprimez l'application et ajoutez-la à nouveau avec la nouvelle version.
Ouvrez le nouveau SAMM, allez dans Tools → Backup et restaurez le fichier que vous avez téléchargé.
Ceci s'applique uniquement au container MikroTik. Sur Docker (Linux, Windows ou une VM Linux), une mise à jour s'effectue via docker compose pull puis docker compose up -d, et vos données restent intactes — les volumes résident en dehors des containers et sont conservés.
Installation
Option F — ISO du serveur SAMM (installation en tant qu'appliance)
L'ISO SAMM Server transforme n'importe quelle machine vide ou VM en serveur SAMM prêt à l'emploi : démarrez-la, choisissez DHCP ou une IP statique sur l'unique écran affiché, confirmez et laissez faire. Elle installe Ubuntu Server 24.04 LTS (minimized), nomme la machine samm-server, puis installe SAMM au premier démarrage depuis l'ISO elle-même, avec ou sans internet ; dès que le serveur est en ligne, il se met à jour une fois vers la dernière version. La console affiche un écran de démarrage SAMM et une bannière de connexion avec l'IP du serveur, l'adresse du panneau d'administration et les identifiants par défaut, et la commande samm-tools donne accès en une touche aux outils de maintenance (bilan de santé, sauvegarde/restauration de la base de données, réinitialisation du mot de passe administrateur).
L'ISO efface le premier disque de la machine. Ne démarrez dessus que sur un matériel ou une VM dédiés à SAMM. Aucun accès internet n'est nécessaire : SAMM est sur l'ISO et fonctionne sur un réseau fermé.
Écrivez-le sur une clé USB (Rufus, balenaEtcher ou dd) ou attachez-le à une VM, démarrez, et répondez à la question sur le réseau. Identifiants par défaut après l'installation — panneau : admin / admin, OS : samm / samm ou root / samm — changez-les tous.
L'installateur s'exécute avec un affichage de progression coloré en temps réel — une barre de pourcentage et une liste de contrôle par phase. La sortie brute de chaque phase est enregistrée dans /var/log/samm-install.log ; en cas d'échec, les 30 dernières lignes sont affichées.
Composant
Détails
FreeRADIUS 3
Configuré avec un backend PostgreSQL et des clients NAS dynamiques ; validé avec freeradius -CX
PostgreSQL
Base de données, schéma et toutes les migrations SQL appliquées — chaque fichier de migration est idempotent
Python venv
Toutes les dépendances sont installées à partir de requirements.txt ; les catalogues de traduction sont compilés. Si le Python de la distribution ne correspond pas au bundle compilé, l'installateur récupère automatiquement un interpréteur autonome compatible dans /opt/samm/runtime
nginx
Reverse proxy ajouté de manière additive — les sites existants ne sont jamais supprimés. Utilise le port 80 s'il est libre ; sinon, demande un port alternatif
5 services
samm-api, samm-radius, samm-worker, samm-notification, samm-telegram — tous activés en tant qu'unités systemd
WireGuard
Paquets installés ; à configurer ultérieurement via System → VPN
cloudflared
Le binaire est toujours installé ; le jeton du tunnel est facultatif lors de l'installation ou peut être ajouté ultérieurement via System → Cloudflare Tunnel
Tous les identifiants — le mot de passe de la base de données et les clés de signature de session — sont générés automatiquement lors de la première installation.
Invite interactives
Toutes les invites s'affichent au préalable, avant le début de l'installation :
Cloudflare token — collez un jeton de connecteur Zero Trust pour publier
SAMM en ligne sans ports ouverts, ou appuyez sur Entrée pour ignorer et le configurer plus tard.
Port HTTP — si le port 80 est déjà utilisé, l'installateur ne modifie pas ces sites et demande un port alternatif (par défaut 8080).
Résumé de l'installation
Une fois l'installation terminée, l'installateur affiche un résumé contenant l'URL de l'administrateur, l'identifiant de connexion par défaut, le port HTTP choisi, les identifiants de la base de données et les chemins des fichiers de configuration :
============================================================
SAMM is installed and running.
Admin portal : http://localhost/admin/login
Default login : admin / admin <- CHANGE AFTER FIRST LOGIN
Config files : /etc/samm/samm.yaml /etc/samm/api.env
============================================================
Mise à niveau
Pour mettre à jour, récupérez la nouvelle source et relancez l'installateur :
git -C /opt/samm pull # or unpack a newer release bundle
sudo bash /opt/samm/install.sh
Le nouvel exécutage resynchronise la source, met à jour le venv, réapplique toutes les migrations, recharge les configurations FreeRADIUS et nginx, et redémarre chaque service. Vos fichiers de configuration et le port HTTP choisi lors de la première installation sont préservés.
Conseil
SAMM peut également se mettre à jour — voir Licensing & updates.
Activez les mises à jour automatiques, ou appliquez-les à la demande, depuis System → License.
DB isolée & distante
SAMM ne fournit que SAMM — FreeRADIUS, PostgreSQL, nginx et les autres composants sont récupérés lors de l'installation depuis les dépôts apt sources ; les installations hors ligne (air-gapped) doivent donc pré-installer ces paquets. Pour un serveur PostgreSQL distant, définissez le DSN dans /etc/samm/samm.yaml après l'installation.
Prise en main
Premiers pas
Cinq étapes rapides permettent de passer d'une installation initiale au stade où les abonnés peuvent se connecter et être facturés.
1 · Première connexion
Ouvrez http://<your-server>/admin/ (utilisez le port HTTP indiqué dans le résumé d'installation s'il est différent du port 80), ou l'URL de votre tunnel Cloudflare.
Connectez-vous avec admin / admin.
Changez immédiatement le mot de passe via System → Admins,
ou depuis le menu du profil dans la barre supérieure.
2 · Ajoutez votre premier routeur
Allez dans MikroTik → NAS et cliquez sur Ajouter un routeur.
Saisissez l'IP du routeur, un nom court et un secret partagé RADIUS. Pour les appareils MikroTik, vous pouvez ajouter des identifiants API pour la synchronisation en direct de l'appareil.
Sur le MikroTik, ajoutez un serveur RADIUS pointant vers l'hôte SAMM (ports 1812/1813) avec le même secret partagé, et activez RADIUS pour PPP / Hotspot.
Aucun redémarrage de FreeRADIUS n'est nécessaire — SAMM résout dynamiquement les clients NAS à partir de la base de données. Consultez Routers (NAS) pour la procédure complète, ou laissez l' assistant de configuration configurer le MikroTik pour vous.
3 · Créer un forfait
Un forfait définit la vitesse, les limites et le prix de vente. Allez dans
Users → Plans → New plan. Référence complète des champs :
Plans & limits.
4 · Ajouter un abonné
Allez dans Users → New customer, renseignez les identifiants de connexion et choisissez un forfait. L'abonné peut se connecter immédiatement. Pour un accès hotspot prépayé, générez plutôt des cartes voucher.
5 · Activer votre licence
Une nouvelle installation s'exécute sans licence au niveau minimal. Ouvrez
System → License et activez-la pour lever les limites — voir
Licensing & tiers.
Rythme quotidien
Ajouter des routeurs → créer des forfaits → ajouter des abonnés ou des cartes → consulter le
tableau de bord → enregistrer les paiements dans
Comptabilité.
Prise en main
Migrer depuis un autre système
Vous utilisez déjà un autre système de facturation RADIUS ? SAMM lit ses données et recrée vos forfaits et abonnés, vous évitant ainsi toute saisie manuelle. Les abonnés conservent leur mot de passe de service et leur date d'expiration actuels, ce qui signifie qu'ils continuent de se connecter exactement comme auparavant.
Allez dans Tools → Export / Import et sélectionnez votre ancien système sous Migrate from another system. Comme pour le reste du menu Tools, l'accès est réservé au superadmin.
Éléments à envoyer
Ancien système
Fichier
Provenance
SAS4 / Radius Manager
.sql ou .sql.gz
Une sauvegarde MySQL de l'ancienne base de données
Super Speed Radius
.sql ou .sql.gz
Une sauvegarde MySQL de l'ancienne base de données
Pro Radius
.xlsx ou .csv
Sa liste d'abonnés exportée — ce système ne propose aucune exportation de sauvegarde
Les sauvegardes de base de données font souvent plusieurs gigaoctets ; c'est normal, envoyez le fichier tel quel. Les sauvegardes compressées n'ont pas besoin d'être décompressées au préalable.
Fonctionnement
Envoi du fichier. Rien n'est encore écrit.
Examinez l'aperçu. Il liste les forfaits et les abonnés qui seraient créés, signale tout élément ayant dû être ignoré ou corrigé, et vérifie le total par rapport à votre licence avant la validation.
Choisissez le traitement des noms d'utilisateur déjà existants dans SAMM — les ignorer et conserver l'enregistrement SAMM, ou mettre à jour son nom et son contact à partir de l'ancien système.
Importation. Chaque ligne est écrite indépendamment, ainsi, une seule ligne erronée n'annule jamais le reste.
Ce qui transite
Forfaits — nom, vitesses, prix, durée et quota de trafic
tels qu'enregistrés dans l'ancien système.
Abonnés — nom d'utilisateur, mot de passe du service, nom, coordonnées, date d'expiration, forfait, IP statique et MAC.
Les abonnés désactivés dans l'ancien système restent désactivés.
La facturation, les factures, les cartes prépayées, les tickets, la comptabilité et les journaux d'administrateur ne sont pas importés intentionnellement — ils appartiennent au modèle de données de l'ancien système et correspondent rarement de manière précise.
Valeurs ne correspondant pas à leur colonne
Les bases de données réelles sont désordonnées : une adresse saisie dans le champ e-mail, une note dans le champ mobile, un numéro de téléphone écrit au clavier arabe. SAMM vérifie chaque valeur au regard de ce que sa colonne est censée contenir. Tout ce qui ne convient pas est laissé en dehors de ce champ et enregistré à la place dans les notes internes de l'abonné, avec l'indication de sa provenance — ainsi rien n'est perdu et aucun champ n'est pollué. L'aperçu vous indique combien de valeurs sont concernées.
Pro Radius spécificités
Pro Radius exporte les abonnés mais pas les forfaits, donc SAMM déduit les forfaits à partir du niveau de service de chaque abonné, en extrayant la vitesse de son nom (un service appelé « 4MBPS » devient un forfait 4 Mbps). Trois éléments sont simplement absents de ce fichier et sont définis avec des valeurs par défaut raisonnables que vous devrez vérifier ultérieurement :
Durée — réglée sur 1 mois. La date d'expiration réelle de chaque abonné est importée sans modification ; cela n'affecte donc que les futurs renouvellements.
Vitesse d'envoi — réglez pour correspondre au débit de téléchargement.
Prix — régler à 0.
Vérifiez les forfaits avant la facturation
Après un import Pro RADIUS, ouvrez Forfaits et définissez le prix et la période réels pour chacun d'eux. Tant que ce n'est pas fait, ces forfaits sont facturés à zéro.
À savoir
Peut être exécuté plusieurs fois sans risque. La réimportation du même fichier ignore les utilisateurs déjà présents au lieu de les dupliquer.
Votre licence reste applicable. Si le fichier contient plus d'abonnés que votre forfait n'en autorise, l'aperçu vous en informe immédiatement et vous indique combien pourraient être importés — vous pouvez alors passer à un forfait supérieur ou importer un ensemble partiel.
Effectuez d'abord une sauvegarde si vous importez des données dans une installation qui en contient déjà.
Abonnés & forfaits
Forfaits & limites
Un forfait est la définition du service attribuée aux abonnés — il définit la vitesse, les limites et le prix. Créez des forfaits avant d'ajouter des utilisateurs.
Une nouvelle installation inclut déjà 9 forfaits prêts à l'emploi — huit paliers de vitesse mensuels et un forfait de limitation « Expired » — afin que vous puissiez vendre immédiatement ou créer vos propres forfaits. Le seeding s'exécute uniquement lors de la première installation et n'écrase jamais les forfaits que vous avez ajoutés.
Créer un forfait
Allez dans Utilisateurs → Forfaits.
Cliquez sur Nouveau forfait.
Remplissez le formulaire et cliquez sur Enregistrer le forfait.
Chaque limite est un interrupteur — activez uniquement celles dont vous avez besoin. La même fenêtre modale permet de modifier un forfait existant (ouvrez le menu ⋮ de la ligne → Modifier).
Champs du forfait
Champ
Signification
Nom
Nom de forfait unique, ex. Home-50M
Prix
Facturé par période de facturation lorsque la facturation est utilisée
Vitesse de téléchargement / envoi
par ex. 50M, 512K, 1G — appliqué comme limite de débit MikroTik
Sessions simultanées
Nombre d'appareils pouvant être connectés simultanément avec ce forfait. 1 par défaut — une seconde connexion est refusée tant que la première est toujours active. Réglez sur 0 pour un nombre illimité. Une session qui ne transmet plus d'informations est ignorée, ainsi une déconnexion ne bloque jamais l'accès de l'abonné
Limite : Expiration
L'abonnement expire après une période fixe suivant l'activation (jours/mois/heures/minutes)
Limite : Quota
Un plafond de données total (combiné, téléchargement uniquement ou envoi uniquement) pour l'ensemble de l'abonnement
Limite : Temps de fonctionnement
Un plafond de temps de connexion cumulé — la somme de toutes les durées de session
Limite : Utilisation quotidienne
Un quota de données qui se réinitialise chaque jour à l'heure de réinitialisation quotidienne configurée
Fenêtre illimitée
Ajout rapide d'une fenêtre de vitesse — l'éditeur complet se trouve sur la page Speed Windows du forfait
Pool IP
Nom du Framed-Pool RADIUS facultatif pour l'attribution d'adresses
Renouvellement automatique
Démarrer une nouvelle période à l'expiration au lieu de changer de forfait ou de déconnecter
Les quatre limites
Chaque limite est indépendante et facultative. Lorsque plusieurs sont définies, SAMM les vérifie selon un
ordre fixe — expiration → quota → uptime → daily — et la première
atteinte détermine l'action.
Limite
Suivis
À l'épuisement
Expiration
Temps calendaire depuis l'activation
Passer à un autre forfait, ou se déconnecter
Quota
Total d'octets utilisés
Passer à un autre forfait, ou se déconnecter
Temps de fonctionnement
Durée cumulée des sessions (secondes)
Passer à un autre forfait, ou se déconnecter
Quotidien
Octets depuis la dernière réinitialisation quotidienne
Limiter — aux vitesses saisies ou via un forfait plus lent — jusqu'à la prochaine réinitialisation quotidienne
Pour chaque limite, choisissez l'action à l'épuisement : sélectionnez un forfait suivant vers lequel basculer l'abonné, ou laissez — déconnecter —. La limite quotidienne bride la connexion au lieu de déconnecter : par défaut, vous saisissez les vitesses de bridage directement (champs téléchargement / envoi), ou choisissez un forfait « suivant » plus lent — dans les deux cas, l'abonné revient automatiquement au forfait d'origine lors de la prochaine réinitialisation quotidienne.
Fenêtres de débit
Une fenêtre de vitesse remplace la vitesse de base du forfait pour des heures définies — par exemple, une fenêtre de vitesse illimitée après minuit. Cliquez sur la ligne d'un forfait pour ouvrir son éditeur Vitesse Windows, qui ajoute un contrôle par jour de la semaine et prend en charge les fenêtres franchissant minuit. Lorsque plusieurs fenêtres correspondent, c'est celle avec la vitesse la plus élevée qui l'emporte.
Note
Les abonnés dont le débit est bridé ou dont le quota est épuisé sont exclus des fenêtres de vitesse — SAMM n'augmente jamais la vitesse tant qu'une limite est en vigueur.
Deux notions d'utilisation
SAMM suit l'utilisation à deux endroits distincts et ne les confond jamais :
Compteurs réinitialisables — l'état par limite. Remis à zéro par une réinitialisation de l'administrateur et par la réinitialisation quotidienne.
Compteurs de facturation — totaux cumulés non réinitialisables. Ils ne sont jamais remis à zéro, afin que les rapports et les factures restent exacts.
Gestion des forfaits
La liste des forfaits affiche la vitesse, le nombre d'abonnés, les limites actives et les fenêtres de vitesse de chaque forfait. Depuis le menu ⋮ d'une ligne, vous pouvez modifier le forfait, ouvrir ses fenêtres de vitesse, l'activer/le désactiver, accéder à ses abonnés ou le supprimer (uniquement s'il n'a pas d'abonnés). La modification du renouvellement automatique propose de propager le changement à tous les abonnés actuels.
Dupliquer copie exactement un forfait — vitesses, limites, plages horaires de vitesse et prix — sous un nouveau nom, ce qui est bien plus rapide que de reconstruire un tarif manuellement pour modifier une seule valeur. Si le nom choisi est déjà utilisé, le prochain numéro disponible est utilisé.
Forfaits visibles par les utilisateurs
L'interrupteur Users can see this plan sur chaque forfait (également disponible comme action groupée dans la liste des Plans) détermine quels forfaits les utilisateurs voient et peuvent choisir dans leur portail. Il est désactivé par défaut pour chaque forfait, donc rien n'est affiché tant que vous n'avez pas fait de choix ; un utilisateur voit toujours son propre forfait.
Abonnés & forfaits
Abonnés
Un abonné (client / utilisateur) est un compte PPPoE ou Hotspot qui s'authentifie auprès de SAMM. Chaque abonné se voit attribuer exactement un forfait.
Créer un abonné
Allez dans Users et cliquez sur New customer.
Remplissez le formulaire et enregistrez — l'abonné peut se connecter immédiatement.
Champ
Signification
Nom d'utilisateur *
Le nom d'utilisateur PPPoE / Hotspot doit être unique
Mot de passe *
Le mot de passe de connexion (stocké pour l'authentification RADIUS PAP/CHAP)
Prénom / Nom
Nom de l'abonné
Mobile / E-mail / Adresse
Coordonnées — utilisées pour les notifications et les factures
Forfait *
Le forfait de service à assigner
Ignorer l'expiration
Date d'expiration manuelle facultative au lieu de celle calculée pour le forfait
Renouvellement automatique
Renouvellement automatique du forfait à l'expiration
Créer plusieurs abonnés simultanément
Nouveaux utilisateurs par lot crée une série numérotée de comptes en une seule opération —
la méthode habituelle pour remettre un bloc d'identifiants lors d'un déploiement dans un village, un hôtel ou à un revendeur.
Choisissez le nombre de comptes, le numéro de départ et le nombre de chiffres pour le remplissage (3 donne
001, 002, …) ; tout le reste — forfait, expiration, renouvellement automatique — est
renseigné une seule fois et appliqué à tous. Ils partagent un mot de passe unique.
Le choix de la facture s'applique à chaque utilisateur du lot
séparément, ainsi un traitement de cinquante utilisateurs génère soit cinquante factures, soit aucune, et le
total est affiché avant la validation.
La liste des abonnés
La page Utilisateurs liste chaque abonné avec un indicateur d'état rapide, le forfait attribué et le solde de chaque limite — l'utilisation quotidienne avec une barre de progression, le quota restant, le temps de connexion restant et les jours restants. Filtrez par état (Tous / Actifs / Suspendus / Expirés / En ligne) ou recherchez par nom d'utilisateur, nom ou mobile.
Le badge de changement de forfait
Un seul badge correspond au forfait de l'abonné. Deux badges reliés par une flèche
signifient que l'abonné a atteint sa limite quotidienne et est temporairement basculé sur un
forfait restreint — il retrouvera son forfait d'origine lors de la prochaine réinitialisation quotidienne.
Gestion d'un abonné
Faites un clic droit sur une ligne — ou utilisez le menu ⋮ — pour accéder aux actions par abonné :
Action
Fonctionnement
Voir / Modifier
Ouvrez la page de détails, ou modifiez les coordonnées, le mot de passe et la date d'expiration
Activer / Désactiver
Suspendre le compte — les abonnés en ligne sont déconnectés
Renouveler le forfait
Ajoute la durée du forfait au temps restant ; génère une facture si le forfait a un prix. Un choix de forfait permet à un utilisateur dont l'abonnement a expiré de revenir avec un forfait différent lors de la même étape — laissez sur « Keep the current plan » pour renouveler comme auparavant
Réinitialiser le temps de connexion / Quota / Quotidien
Remettre à zéro le compteur de limite choisi
Utilisation
Ouvrir les graphiques d'utilisation et l'historique des sessions
Supprimer
Supprimer l'abonné et tout son historique — les sessions actives sont déconnectées en premier
Prise d'effet des actions
Les réinitialisations, les changements de forfait et les renouvellements sont mis en file d'attente dans un journal d'audit et appliqués par le tick samm-radius — généralement en quelques secondes. Si l'abonné est en ligne, SAMM envoie également une actualisation en direct. Voir CoA & changements en direct.
La page de détails peut également révéler le mot de passe de connexion de l'abonné via une icône d'œil (avec copie en un clic) — pratique lorsqu'un client demande ses identifiants.
Vue d'utilisation
L'action Usage ouvre une page de trafic détaillée pour un abonné, avec un sélecteur de période 7d / 14d / 30d / 90d. Elle affiche trois chiffres clés — le trafic d'aujourd'hui (avec la répartition envoi/téléchargement et les minutes en ligne), le trafic de ce mois, et le temps de connexion cumulé pour le mois. En dessous se trouvent un graphique de trafic quotidien comparant l'envoi et le téléchargement, ainsi qu'un tableau complet de l'historique des sessions : l'heure de début et de fin, la durée, les octets téléchargés et envoyés, le NAS, et la cause de terminaison de chaque session.
Opérations groupées
Pour modifier le propriétaire, l'expiration, le statut ou le renouvellement automatique de plusieurs abonnés à la fois — ou pour en supprimer plusieurs — utilisez les outils de modifications et de suppressions groupées. Pour créer des abonnés en masse à partir d'un tableur, utilisez Export / Import.
Restreindre un abonné à des routeurs spécifiques
Lorsque le paramètre de connexion d'agence est activé, un utilisateur se connecte via les routeurs de sa propre agence, des agences supérieures et du siège (voir Admins, branches & roles). Depuis le formulaire d'édition, vous pouvez restreindre davantage un utilisateur (ou un groupe de cartes entier) à des routeurs spécifiques : si aucun n'est sélectionné, les routeurs de l'agence s'appliquent ; si un ou plusieurs sont sélectionnés, la connexion est acceptée uniquement depuis ces routeurs, restriction appliquée au sein de RADIUS. La modification de cette sélection déconnecte toute session active sur un routeur qui n'est plus autorisé.
Modifier le nom d'utilisateur, renouveler avec un aperçu
Renommez un utilisateur depuis sa page (le bouton Username à côté de Modifier) ou depuis le menu de la liste des utilisateurs, après avoir saisi le nom d'utilisateur actuel pour confirmer. Les sessions, la consommation et les logs sont associés au nouveau nom ; la session active est déconnectée pour que le routeur oublie l'ancien identifiant, et l'utilisateur est informé de son nouveau nom d'utilisateur, sauf si vous décochez cette case. Lorsque vous renouvelez ou modifiez un forfait, choisissez si la nouvelle période débute à la date d'expiration ou aujourd'hui, puis vérifiez — et ajustez — la nouvelle date d'expiration avant d'enregistrer. Un renouvellement peut également inclure un acompte.
Lien sans fil
Pour un abonné sur un point d'accès MikroTik, la page utilisateur peut lire directement les informations de sa radio : signal (avec un indicateur simple de qualité), débit dans chaque direction, CCQ et uptime. Seules les radios MikroTik sont compatibles.
Fichiers utilisateur & champs personnalisés
Envoyez des cartes d'identité, des passeports, des contrats et des photos pour un utilisateur depuis sa page de détails ;
aperçu des fichiers sans téléchargement, avec possibilité de les afficher à l'abonné dans son propre
portail sous Files. Custom fields — définis une fois dans
Settings — ajoutent des champs de saisie de données supplémentaires aux utilisateurs, fichiers, forfaits, groupes de cartes, tickets et
add-ons.
Abonnés & forfaits
Cartes Hotspot
Pour l'accès Hotspot prépayé, générez un lot de cartes voucher plutôt que des abonnés individuels. Chaque carte correspond à un couple nom d'utilisateur/mot de passe avec sa propre vitesse et ses propres limites ; elles sont générées par milliers et imprimées pour être distribuées.
Créer un groupe de cartes
Allez dans Users → Hotspot Cards et cliquez sur Nouveau groupe.
Remplissez le formulaire ci-dessous et cliquez sur Créer le groupe — SAMM génère automatiquement les identifiants de chaque carte.
Section
Champs
Identité
Nom de groupe unique, description, préfixe de nom d'utilisateur facultatif, nombre de cartes à générer (jusqu'à 10 000)
Identifiants
Format et longueur du nom d'utilisateur et du mot de passe (chiffres / lettres / alphanumérique)
Limitation de débit
Vitesse de téléchargement et d'envoi — 256k, 6M, 1G; 0 = illimité
Limiter le transfert
Illimité, plafond combiné, ou plafonds de téléchargement/envoi distincts (MB / GB / TB)
Plages horaires limitées
Limite de temps de fonctionnement, expiration après la première connexion et une date de validité pour le groupe
L' expiration est comptée à partir de la première connexion de chaque carte, tandis que valide jusqu'au est une date d'expiration stricte — les cartes ne peuvent plus être utilisées après celle-ci, qu'elles aient été activées ou non.
Gestion d'un groupe
Ouvrez le menu ⋮ d'un groupe pour activer ou désactiver toutes les cartes à la fois,
prolonger la date de validité du groupe, ajouter d'autres cartes
au lot, ou modifier ses détails. Les cartes individuelles peuvent être réinitialisées (quota, uptime ou
expiration) ou désactivées depuis la page de détails de la carte.
Dupliquer le groupe copie exactement chaque paramètre et génère le même
nombre de cartes avec de nouveaux codes — un code de carte ne peut appartenir qu'à une seule carte,
donc une copie constitue un nouveau tirage et non un clone de l'ancien. C'est le moyen le plus rapide de recommander un
lot de coupons épuisé.
Ajouter une carte ou importer une liste
+ Card, dans la liste des cartes et sur la page d'un groupe, ajoute une carte avec l'identifiant, le mot de passe et le nom facultatif que vous saisissez, dans un groupe choisi dans une liste de recherche. Sur la page d'un groupe, Import cards charge un fichier CSV ou Excel (identifiant, mot de passe et nom facultatif) ; vous voyez ce qui sera ajouté et ce qui sera ignoré avant tout enregistrement.
Modèles de cartes
Ouvrez Hotspot Cards → Card designs pour concevoir la carte imprimée : sa taille, une image d'arrière-plan, votre logo, et l'emplacement de l'identifiant, du mot de passe, du prix, de la validité et d'un code QR. Le code QR connecte la carte au Hotspot en un seul scan. Dix modèles prêts à l'emploi servent de point de départ ; modifiez-les, copiez-les ou supprimez-les comme les vôtres.
Un modèle est soit une feuille A4 de cartes (Export), soit un ticket thermique de 80 ou 58 mm pour l'impression rapide. Chaque groupe garde son propre modèle pour chacun ; un groupe sans modèle imprime la carte intégrée, et l'impression rapide utilise le ticket prêt à l'emploi Thermal Pro.
États des cartes
État
Signification
Non utilisé
Généré mais jamais connecté
Actif
En cours d'utilisation, dans les limites définies
Épuisé
Une limite (quota, temps d'utilisation ou expiration) a été atteinte
Désactivé
Désactivé manuellement
Impression & suivi
Ouvrez un groupe pour voir ses cartes, imprimez-les au format PDF pour distribution
(la mise en page d'impression utilise le logo de votre ISP configuré dans les paramètres), et examinez l'utilisation par carte. Le
trafic des cartes apparaît également dans Reports sous l'
onglet Cards, et chaque groupe possède sa propre vue de comptabilisation.
Le routeur reçoit ce qui reste sur chaque carte : la page d'état Hotspot affiche le temps et les données restants, et le routeur termine la session quand la carte est épuisée.
Abonnés & forfaits
Libre-service — les invités s'inscrivent eux-mêmes
L'opposé d'un voucher : personne n'imprime rien et personne ne fait la queue à un guichet. Un visiteur se connecte à votre hotspot, clique sur Register sur la page de connexion, saisit son nom et son numéro de mobile, et SAMM lui envoie un code d'accès par SMS, WhatsApp ou e-mail. Il le saisit sur la même page et se retrouve en ligne — et vous conservez un registre nominatif et exportable de tous ceux qui ont utilisé le réseau invité.
Lieux typiques : restaurants et cafés, hôtels et maisons d'hôtes,
expositions et salons professionnels, conférences, centres commerciaux, cliniques et salles d'attente,
salles de sport, espaces de coworking, salons de beauté, salons d'aéroport, stades, campus, bibliothèques,
concessions automobiles, lieux de réception de mariage, complexes touristiques et campings.
Mise sous tension
Configurez d'abord un canal de diffusion.Notification Center → activez SMS ou WhatsApp et
envoyez-vous un message de test. Rien d'autre ne fonctionnera tant qu'au moins un canal n'est pas actif.
Self Service → Settings: cochez
Allow guests to register themselves, choisissez les canaux à
proposer, et définissez la durée de validité d'un code ainsi que le délai d'attente
avant qu'un invité puisse en demander un autre.
Laissez Passcodes come from tel quel dans le groupe de cartes Self Service, sauf si vous avez une raison de le modifier — ce groupe détermine la vitesse et le nombre d'appareils pouvant partager un seul code d'accès.
Activez l'onglet Register pour chaque modèle de connexion utilisé
— voir ci-dessous. C'est l'étape que les utilisateurs oublient souvent.
La page de connexion — l'étape souvent oubliée
L'onglet Register est défini par connexion et est désactivé par défaut. Allez dans MikroTik Manager → le routeur → Login Page, modifiez le design utilisé et cochez Allow Self Service. Vous pouvez reformuler chaque phrase qu'un invité voit sur le même écran — le libellé de l'onglet Register, la ligne d'introduction, les libellés des deux champs, le bouton et les cinq réponses (« votre code est en route », « vous en avez déjà un », « veuillez réessayer plus tard », « nous n'avons pas pu l'envoyer », « l'inscription n'est pas disponible »).
Appuyez ensuite sur Push — et appuyez à nouveau après chaque mise à jour SAMM.
Les pages de connexion Hotspot résident sur le stockage flash du routeur, et non sur SAMM. La mise à jour de SAMM ne les renvoie pas ; par conséquent, un routeur continue de diffuser son ancienne page — sans l'onglet Register — jusqu'à ce que vous les renvoyiez. SAMM vous avertit dans l'onglet Login Page lorsqu'un routeur diffuse des pages plus anciennes que votre version installée, et la page Self Service liste chaque routeur ne pouvant pas afficher l'onglet et propose de tous les corriger d'un coup.
Les règles pour empêcher les abus
Un seul code d'accès actif par numéro. Si une nouvelle demande est effectuée alors qu'un code est encore valide, l'invité est invité à consulter ses messages au lieu d'en recevoir un nouveau.
Ensuite, un délai d'attente que vous définissez, avant que ce numéro ne puisse en demander un nouveau.
La validité court à partir du moment où le code d'accès est envoyé,
et non à partir de la première connexion — ainsi, un code resté inutilisé pendant une semaine ne sera plus valide.
Un plafond quotidien défini par votre licence (voir ci-dessous). Une fois celui-ci atteint, les invités sont invités à réessayer plus tard et les codes d'accès déjà émis continuent de fonctionner.
Chaque tentative est enregistrée avec l'adresse MAC de l'appareil telle que rapportée par le routeur — ce qu'un invité ne peut pas falsifier depuis son navigateur.
La licence
Le Self Service est licencié
indépendamment de votre forfait, selon le nombre de codes d'accès qu'une installation
peut émettre par jour, et il se renouvelle à sa propre date — vous pouvez donc utiliser le forfait Free avec un module complémentaire payant,
ou le forfait Unlimited sans aucun. Chaque installation bénéficie de 10 par jour gratuitement ;
Light porte ce nombre à 50, Heavy à 200, et Max supprime la limite. Voir
les tarifs.
La page Self Service affiche le utilisé / autorisé pour aujourd'hui et indique clairement quand le quota est épuisé. Achetez ou renouvelez depuis votre tableau de bord sur securytik.com, ou faites une demande via System → License pour qu'un administrateur SecuryTik l'approuve. Un code d'accès qui n'a pas pu être délivré ne consomme pas votre quota.
Abonnés & forfaits
Extensions & vouchers
Un add-on est une option supplémentaire qu'un utilisateur achète en complément de son forfait pour un certain nombre de jours : un speed boost, des unmetered days ou un night boost pour des plages horaires choisies. Créez-les via le chemin Users → Add-ons.
Vendez un add-on depuis la page de l'utilisateur, permettez aux utilisateurs de l'acheter via le portail utilisateur ou le bot Telegram (paiement depuis le portefeuille), ou imprimez des codes de voucher à usage unique que les utilisateurs peuvent utiliser dans le portail ou le bot.
Applications gratuites : activez Unmetered et choisissez des applications par catégorie ; seul leur trafic ne sera plus décompté du quota de l'utilisateur. Désactivez toutes les applications pour que tout le trafic soit illimité. Cela nécessite le Data Log.
Contrôle parental et VPN : une extension peut activer le contrôle parental ou le VPN via SAMM pendant sa durée ; les deux se désactivent d'eux-mêmes à la fin. Indiquez la durée par une valeur et une unité (jours, semaines ou mois civils).
Les utilisateurs voient leurs add-ons actifs et leurs dates d'expiration sur leur page Forfaits. Un add-on attribué à l'utilisateur d'un agent est facturé à l'agent comme un renouvellement.
Chaque agence peut avoir ses propres tarifs d'options dans Accounting → Price Lists.
Remises sur facture
Accordez un pourcentage ou un montant fixe de remise sur une facture ouverte, avec un motif, à partir de la facture ou des factures de l'utilisateur. Une remise permanente peut s'appliquer lors des prochains renouvellements de l'utilisateur. Chaque rôle possède un montant maximal de remise qu'il peut accorder.
Abonnés & forfaits
Points & récompenses
Récompensez vos utilisateurs fidèles et permettez-leur d'inviter leurs amis. Les points sont désactivés jusqu'à ce que vous les activiez via le chemin Users → Points & rewards.
Activez les points et définissez, pour chaque forfait, combien de points procure un renouvellement payant et combien l'utilisateur invitant reçoit lorsqu'un ami parrainé règle sa première facture.
Créez des récompenses : vitesse accrue (la vitesse du forfait multipliée pendant quelques jours) ou jours gratuits, chacune avec un prix en points.
Les utilisateurs voient leur solde, leur lien d'invitation et les récompenses dans le portail utilisateur, et y dépensent leurs points. Un ami qui ouvre le lien d'invitation laisse ses coordonnées ; vous créez l'utilisateur et le parrainage est enregistré.
Les points sont comptabilisés à partir des factures payées, une seule fois. Si une facture est annulée, ses points sont déduits. Vous pouvez également ajouter ou retirer des points manuellement, et consulter les soldes les plus élevés ainsi que les demandes d'adhésion sur la même page.
Abonnés & forfaits
Contrôle parental
Les familles protègent leur propre ligne depuis le portail utilisateur. Cette option est désactivée pour chaque utilisateur jusqu'à ce que vous l'autorisiez : activez Parental control dans le formulaire d'ajout ou de modification de l'utilisateur (situé juste après Allow Password Change), ou pour plusieurs utilisateurs à la fois via les actions groupées de la liste Users.
Ce que l'utilisateur peut bloquer
Catégories : contenu pour adultes, drogues, jeux d'argent, rencontres, violence et haine, ainsi que les services proxy ou VPN utilisés pour contourner le filtre. Le blocage du contenu pour adultes active également SafeSearch sur les principaux moteurs de recherche et YouTube.
Applications et sites web provenant du même catalogue que Websites & Apps, affichés avec leurs logos officiels.
Quand : toujours, ou selon un calendrier hebdomadaire (par exemple les soirs de semaine après 22:00).
Voyant du routeur
SAMM n'écrit pas de règles par utilisateur. Chaque routeur reçoit quelques règles partagées, et les utilisateurs y sont inclus ou exclus selon le début et la fin de leurs plages horaires, afin que la charge du routeur reste faible même avec de nombreuses familles. Le routeur doit être géré par SAMM (accès API) pour le blocage d'applications.
Abonnés & forfaits
VPN via SAMM
Les utilisateurs choisis font sortir leur trafic par votre serveur SAMM au lieu de la ligne internet du routeur. Il passe par le tunnel que chaque routeur a déjà vers SAMM (WireGuard, L2TP/IPsec ou SSTP, voir VPN) : rien à installer sur le téléphone ou l'ordinateur de l'utilisateur.
L'autoriser
Par utilisateur : activez VPN via SAMM dans le formulaire d'ajout ou de modification de l'utilisateur, ou pour plusieurs utilisateurs à la fois avec les actions groupées de la liste Utilisateurs.
En extension : dans Utilisateurs → Extensions, activez le VPN dans une extension et vendez-la pour un nombre de jours, de semaines ou de mois. Il reste actif pendant la durée de l'extension et se désactive ensuite de lui-même.
Ce que l'utilisateur choisit
Les utilisateurs autorisés ont une page VPN dans le portail utilisateur, avec trois choix :
Désactivé — rien ne passe par le VPN.
Tout le trafic — chaque appli et chaque site passent par le VPN, ainsi que le DNS de l'utilisateur.
Applis choisies — seulement les applis et sites que l'utilisateur sélectionne, dans le même catalogue que Sites Web et Applications ; tout le reste reste sur la ligne locale.
Si le tunnel tombe
Les utilisateurs ne perdent jamais internet à cause du VPN : si le routeur ne joint plus SAMM, leur trafic repasse par la ligne du routeur jusqu'au retour du tunnel. Les adresses locales (votre LAN et les plages CGNAT) ne passent jamais par le VPN. Fonctionne sous RouterOS 6 et 7 ; le routeur doit être géré par SAMM.
VPN externe : sortir par un autre fournisseur
Dans System → VPN → External VPN, SAMM peut faire sortir les utilisateurs VPN par un VPN commercial au lieu de sa propre ligne : le VPN fonctionne même quand SAMM est sur votre réseau local sans adresse publique.
NordVPN : collez un jeton d'accès de votre compte NordVPN et choisissez combien de serveurs ouvrir (jusqu'à 10 par compte). SAMM récupère la clé et choisit les serveurs lui-même.
Tout autre fournisseur (ProtonVPN, Mullvad, Surfshark, votre propre serveur) : téléversez ses fichiers WireGuard .conf, une connexion par fichier. Les lignes de script d'un fichier sont ignorées et jamais exécutées.
Connexions montre chaque connexion en direct : état, dernière poignée de main, trafic et utilisateurs. Chaque utilisateur reste sur une connexion (la même adresse de sortie) ; un poids répartit les utilisateurs entre les connexions.
Si une connexion tombe, ses utilisateurs sortent par la ligne de SAMM jusqu'à son retour ; supprimer ou désactiver une connexion déplace ses utilisateurs vers les autres.
SAMM a besoin d'une adresse publique
Le VPN n'est utile que si votre serveur SAMM sort sur Internet depuis un autre endroit que les utilisateurs, par exemple un serveur dans un centre de données. Si SAMM est derrière un NAT sur le même réseau, le trafic sortirait par la même ligne : le formulaire utilisateur et celui de l'extension affichent donc un avertissement, sauf si une connexion VPN externe fonctionne.
Prise en main
Configurez votre serveur
Vous n'avez pas de serveur ? Nous en configurons un pour vous. Vous le commandez depuis votre tableau de bord SAMM, payez, et
recevez un serveur SAMM prêt sur votre propre domaine .com, à votre nom. Il n'y a rien à installer.
Contenu de l'offre
Un serveur cloud et un domaine .com, en trois tailles : 6 cœurs, 12 GB RAM, 200 GB SSD pour 100 $ par an ; 8 cœurs, 24 GB RAM, 300 GB SSD pour 200 $ ; 12 cœurs, 48 GB RAM, 400 GB SSD pour 300 $. Vous choisissez la taille à la première étape.
HTTPS sur votre domaine ; l'adresse propre du serveur n'est jamais publiée.
SAMM installé et personnalisé au nom de votre entreprise, avec votre licence liée et active dès la première connexion.
Un e-mail avec l'adresse de votre panneau (https://your-domain/admin) et un mot de passe administrateur robuste.
Commandez-le
Connectez-vous sur samm.securytik.com et ouvrez Dashboard → Get a server.
Choisissez un nom de serveur et le nombre d'utilisateurs, puis recherchez votre domaine .com ou choisissez l'une des suggestions.
Payez avec l'un des moyens affichés lors du paiement. La commande attend le paiement pendant deux heures ; ensuite elle est annulée et vous passez une nouvelle commande.
Après le paiement, tout est automatique. Lorsque le serveur est prêt, vous recevez l'e-mail avec votre adresse et vos identifiants.
Accès SSH
Depuis Dashboard → Servers, vous pouvez créer votre propre identifiant SSH avec un mot de passe, des clés publiques, ou les deux. Un guide SSH pas à pas pour Termius, Windows, Ubuntu et macOS se trouve sur la même page.
Renouvellement
Renouvelez au moins un jour avant la fin de l'année ; le renouvellement ouvre sept jours avant. Si le serveur n'est pas renouvelé, le serveur, le domaine et les données qu'il contient prennent fin. Conservez aussi vos propres sauvegardes.
Abonnés & forfaits
CGNAT & pools IP
Les deux se trouvent sous Plans, à côté des pools propres au routeur.
Pools CGNAT
Un pool CGNAT permet à plusieurs utilisateurs de partager une même adresse publique. Chaque utilisateur reçoit un bloc fixe de ports sur cette adresse, de sorte que chaque connexion peut être rattachée à un seul utilisateur.
Ouvrez Plans → CGNAT Pools et ajoutez un pool : les adresses publiques, le nombre d'utilisateurs partageant une adresse et le nombre de ports attribués à chaque utilisateur.
La ligne de capacité indique combien d'utilisateurs peuvent tenir avant l'enregistrement.
Transmettez-le au routeur. SAMM écrit les règles NAT et conserve l'historique des adresses et ports attribués à chaque utilisateur, que le Lookup consulte.
Pools IP
Avec un pool IP, SAMM attribue lui-même son adresse à chaque utilisateur, par routeur et par forfait, de sorte que le routeur n'a pas besoin de son propre pool d'adresses. L'adresse est libérée à la fin de la session. Lorsqu'un pool est plein, le pool propre au routeur prend le relais.
Opérations quotidiennes
Conservation des données & Lookup
De nombreux pays exigent d'un FAI qu'il conserve les journaux de connexion et qu'il indique quel abonné a utilisé une adresse à un moment donné. La conservation des données fait les deux. Elle est désactivée tant que vous ne l'activez pas.
Activez-la
Ouvrez System → Settings → Data retention et activez-la.
Définissez la durée de conservation des sessions (deux ans par défaut). Les sessions sont conservées pendant cette période, même pour les utilisateurs que vous supprimez.
Vous pouvez aussi envoyer chaque jour un fichier chiffré à votre NAS par SFTP, SMB ou NFS. Ouvrez-le avec gpg --decrypt.
Lookup : qui a utilisé cette adresse ?
Ouvrez Overview → Data Log → Data retention.
Saisissez l'adresse publique, le port et l'heure figurant dans la demande reçue.
Saisissez une référence de dossier (SAMM propose CASE-1, CASE-2…). Le résultat affiche l'utilisateur, l'adresse MAC, le routeur et la session ; il peut être recherché et exporté.
Journal Lookup
Chaque recherche est consignée dans le journal Lookup avec son auteur, la date et la référence de dossier, et elle ne peut pas être modifiée.
Avec le CGNAT, Lookup utilise les blocs de ports de vos pools CGNAT.
Réseaux & routeurs
Autres marques de routeurs
En plus de MikroTik, SAMM fonctionne avec les routeurs Cisco, Huawei, Nokia et ZTE comme NAS (BNG).
Ajoutez le routeur sous Devices → Manager et choisissez son type. Le formulaire demande le bon identifiant : l'API pour MikroTik, SSH pour les autres marques.
Page de configuration : SAMM génère les lignes de configuration de ce routeur, prêtes à être collées.
Débits et déconnexions utilisent les attributs RADIUS propres à chaque marque, de sorte que les changements de forfait atteignent le routeur.
Data Log à partir des enregistrements de trafic propres au routeur (NetFlow ou IPFIX).
CGNAT sur Cisco : SAMM transmet les règles par SSH et Lookup fonctionne comme sur MikroTik. Les routeurs Cisco peuvent aussi se connecter à SAMM par L2TP.
Page d'équipement : CPU, mémoire, température, durée de fonctionnement et graphiques, comme sur MikroTik.
Réseaux & routeurs
FTTH & OLTs
SAMM lit les OLT de V-SOL, Huawei (SmartAX), ZTE (C300 et C320) et Nokia (ISAM) par SSH.
Page FTTH sous Devices → FTTH : une liste d'OLT avec filtres, colonnes et export, comme pour Wireless.
Chaque ONU avec son signal optique, et les ONU en attente d'ajout.
ONU liées automatiquement à leurs utilisateurs.
Verrouillage de la ligne d'abonné : SAMM apprend la ligne par laquelle chaque utilisateur se connecte et peut réserver son identifiant à cette ligne.
Page d'équipement OLT : CPU, mémoire, température, durée de fonctionnement et graphiques.
Réseaux & routeurs
Routeurs (NAS)
Un NAS (Network Access Server) est un routeur qui authentifie les abonnés auprès de SAMM via RADIUS. Chaque routeur transportant le trafic des abonnés nécessite un enregistrement NAS.
Ajouter un routeur
Allez dans MikroTik → NAS et cliquez sur Ajouter un routeur.
Remplissez les champs ci-dessous et enregistrez.
Champ
Signification
IP / nom d'hôte du NAS
L'adresse du routeur, telle que vue par l'hôte SAMM
Nom court
Un label convivial affiché dans toute l'interface
Type
mikrotik active la synchronisation des appareils en temps réel et le push de configuration ; les autres types sont limités au RADIUS
Secret
Le secret partagé RADIUS — doit correspondre exactement à celui du routeur, sinon l'authentification échoue
Port CoA
Port UDP vers lequel SAMM envoie les paquets Change-of-Authorization (par défaut MikroTik 3799)
Port API / utilisateur / mot de passe
Identifiants API MikroTik utilisés par SAMM pour lire les informations de l'appareil et pousser la configuration
Aucun redémarrage requis
SAMM résout dynamiquement les clients NAS à partir de la base de données — l'ajout ou la suppression d'un routeur ne nécessite jamais le redémarrage de FreeRADIUS.
La liste des NAS
Tous les routeurs s'affichent dans un seul tableau — ID, IP NAS / nom d'hôte, nom court, type, un
secret masqué (cliquez sur la cellule pour l'afficher), les ports CoA et API, ainsi qu'un
résultat ping en temps réel avec le temps de trajet aller-retour. La zone de recherche filtre par IP,
nom court ou description.
Le menu ⋮ de chaque ligne contient les actions par routeur — Voir l'appareil et
Actualiser les infos (MikroTik uniquement), Modifier, Pousser la
config RADIUS (MikroTik uniquement), et Supprimer. L'ouverture d'une
ligne de type mikrotik mène directement à la
page de l'appareil.
Découvrir les voisins
Cliquez sur Discover neighbors pour scanner le réseau à la recherche d'appareils MikroTik (via le protocole de découverte de voisins de MikroTik) et les ajouter en tant qu'enregistrements NAS sans avoir à saisir chaque adresse manuellement. Un routeur découvert peut être ajouté par IP, ou via Auto-added — un bootstrap en un clic qui crée un utilisateur de gestion SAMM sur le routeur, configure une IP de gestion et supprime le bridge d'usine.
L'ajout automatique est destiné aux nouveaux routeurs
L'amorçage en un clic est destiné aux appareils neufs (ou réinitialisés) — sur un routeur possédant déjà une configuration, cela peut écraser ou corrompre la configuration existante.
Envoyer la configuration RADIUS vers le routeur
Pour les enregistrements MikroTik NAS, le menu ⋮ de la ligne propose Push RADIUS config
— SAMM configure le routeur pour vous via l'API pour vous éviter une saisie manuelle. Vous
confirmez l'IP du serveur SAMM (elle doit être accessible depuis le routeur) ainsi que les ports d'authentification,
de comptabilité (accounting) et de CoA ; SAMM crée ou remplace ensuite une entrée RADIUS sur le routeur :
Paramètre
Valeur
Commentaire
SAMM — le tag utilisé par SAMM pour rechercher et mettre à jour cette entrée ultérieurement
Service
hotspot, ppp
Adresse / secret
L'hôte SAMM, avec le secret partagé de cet enregistrement NAS
Délai d'expiration
3000 ms
CoA entrant
Accepté, sur le port CoA que vous avez confirmé
La boîte de dialogue affiche un journal des résultats une fois le push terminé.
Configuration du côté MikroTik
Si vous configurez le routeur manuellement à la place :
Ajoutez un serveur RADIUS pointant vers l'hôte SAMM, avec le même secret partagé, activé pour PPP / Hotspot.
Utilisez le port d'authentification 1812 et le port de comptabilité 1813.
Accepter les CoA entrants sur le port 3799.
Réglez l'intervalle Interim-Update de la comptabilité à environ 5 minutes
(valeur par défaut de l'assistant SAMM) — c'est la fréquence à laquelle SAMM accumule la consommation et évalue les limites ;
des intervalles plus courts réduisent la latence d'application des limites au prix d'un trafic de comptabilité plus important.
Appareils en mode surveillance uniquement
Un routeur ajouté en tant que monitor apparaît dans l'inventaire MikroTik et
est pingué et synchronisé, mais n'a aucun rôle RADIUS — il ne peut pas authentifier d'abonnés. Utilisez-le
pour surveiller les routeurs qui ne sont pas des NAS d'abonnés.
Repli SAMM
Si SAMM cesse de répondre, les routeurs que vous avez choisis continuent de connecter les abonnés de manière autonome — à partir d'une copie désactivée de chaque utilisateur actif que SAMM synchronise sur ceux-ci. Lorsque SAMM est de nouveau disponible, tout le monde se reconnecte via celui-ci. Désactivé par défaut ; activez cette option par routeur dans Settings → Advanced.
Le repli s'active après le délai que vous avez défini, ou manuellement, et le routeur le signale via Telegram. Un tableau d'état affiche l'état de synchronisation de chaque routeur, le nombre d'utilisateurs dont la synchronisation a échoué et la raison, et signale tout routeur dont la sauvegarde est obsolète ou qui ne peut pas joindre l'adresse de santé de SAMM.
Réseaux & routeurs
Gestionnaire MikroTik
Lorsqu'un routeur possède des identifiants API, SAMM le gère directement via l'API MikroTik — sans WinBox, sans SSH. La section MikroTik est un inventaire en temps réel de tous les routeurs, et chaque appareil ouvre une page de détails avec quinze onglets permettant de configurer presque toutes les fonctionnalités de RouterOS depuis votre navigateur.
MikroTik Monitor
MikroTik → Monitor affiche une carte par routeur, disposées sous forme de grille. Chaque carte indique — actualisée par samm-worker et interrogée en temps réel toutes les 30 secondes — le point de joignabilité, la version de RouterOS, la charge CPU et le nombre de cœurs, l'utilisation de la mémoire, le nombre de sessions actives, l'uptime et l'heure du dernier échantillonnage.
Une carte est étiquetée soit NAS (un routeur qui authentifie également les abonnés via RADIUS) soit surveillance (un appareil ajouté uniquement pour la surveillance). Ajouter MikroTik enregistre un nouvel appareil ; Actualiser maintenant force un sondage immédiat. Les cartes uniquement surveillance disposent d'un menu contextuel au clic droit — Ouvrir, Modifier, Actualiser les informations, Supprimer.
Appareils Ubiquiti
Lorsque vous ajoutez un moniteur, vous choisissez son type : MikroTik, Ubiquiti airOS
ou Ubiquiti UniFi access point. Les appareils Ubiquiti sont accessibles via SSH avec les identifiants de l'appareil ; une page Probe affiche les informations rapportées par l'appareil. Un point d'accès UniFi apparaît dans les pages Wireless avec une ligne par radio — son canal, sa largeur et ses SSIDs, les clients connectés avec le signal, le bruit et le débit, ainsi que les réseaux voisins détectés — et participe à l'optimiseur Wi-Fi et au planificateur de canaux.
Chaque forfait permet trois moniteurs pour chaque routeur (un forfait avec des routeurs illimités dispose de moniteurs illimités), ainsi la surveillance de vos points d'accès n'épuise jamais votre quota de routeurs.
Utilisateurs conservés sur un routeur
SAMM détecte les connexions PPP, les utilisateurs Hotspot et les utilisateurs User Manager conservés par un routeur (RouterOS 6 et 7) et les affiche sur la page du routeur. Avant toute action, chaque ligne indique ce que SAMM va créer : nom d'utilisateur, mot de passe, nom, mobile, forfait (marqué new lors de la création par SAMM), expiration, limites, MAC et IP. Les noms, numéros de téléphone et dates de fin inscrits dans les commentaires du routeur, en arabe ou en anglais, sont également lus. Cochez les utilisateurs et importez-les : l'opération s'exécute en arrière-plan et la liste des utilisateurs se remplit au fur et à mesure de leur arrivée.
La page de l'appareil — quinze onglets
Ouvrez n'importe quel appareil pour accéder à sa page de gestion complète. Les onglets sont répartis en quatre groupes.
Supervision
Onglet
Ce qu'il affiche
Vue d'ensemble
Informations sur l'appareil, informations système et graphiques d'historique des performances (CPU, mémoire, sessions au fil du temps)
Interfaces
Chaque interface avec son état en temps réel, ainsi que l'historique du trafic par interface
Sites Web & Apps
Trois sous-vues : Monitor (sites web & applications détectés sur le routeur avec historique du trafic), QoS (priorité basée sur les applications, ci-dessous), et App Filter (blocage de contenu basé sur le DNS à partir du catalogue)
Gestionnaire
L'onglet Manager → General est la page de maintenance de l'appareil :
Identity (le nom du routeur), Time (horloge, fuseau horaire et
NTP), et Tools (redémarrage, ping et autres actions du routeur en un clic).
Configuration réseau
Onglet
Ce que vous configurez
Bridge
Créez des ponts LAN et choisissez les interfaces physiques (ports) qui appartiennent à chacun d'eux
VLAN
Ajouter et gérer les interfaces VLAN
IP
Trois sous-onglets — Static (adresses statiques et dynamiques), DHCP client (récupérer une adresse en amont), DHCP server (attribuer des adresses, avec un tableau des baux en temps réel)
DNS
Serveurs DNS et cache (le filtre de contenu des applications/sites se trouve sous Websites & Apps)
WiFi / CAPsMAN
Interfaces Wi-Fi avec leurs configurations et profils de sécurité ; et le contrôleur CAPsMAN — configurations, règles de provisioning et CAPs distants
Maintenance des services &
Onglet
Ce que vous configurez
PPPoE
Serveurs PPPoE, profils PPP, pools IP et l'intervalle d'interim-update de la comptabilité RADIUS
Hotspot
Serveurs Hotspot, profils hotspot et profils utilisateur, pools DHCP/IP et page de connexion du portail captif
Internet
Liaisons montantes WAN — WAN gérés par SAMM et routes par défaut, avec tous les WAN non-SAMM existants affichés en lecture seule
Pare-feu
Règles de filtrage, analyse de la sécurité du routeur, connectivité & cibles, modules de sécurité et sauvegardes du pare-feu — Auto-Security prend un instantané du pare-feu avant l'application et peut activer un retour automatique programmé, afin qu'un ensemble de règles vous bloquant l'accès soit annulé automatiquement
Mettre à jour
Mises à jour de RouterOS — choisissez un canal de mise à jour, vérifiez et appliquez, puis examinez les paquets installés
Assistant
La configuration guidée initiale, ci-dessous
L'intervalle interim-update du PPPoE
Dans l'onglet PPPoE, Interim update définit la fréquence à laquelle le routeur envoie des paquets RADIUS accounting Interim-Update à SAMM. SAMM utilise ces paquets pour cumuler les compteurs d'octets et de temps de connexion, et pour évaluer le quota ainsi que les limites quotidiennes et de temps de connexion — sans eux, l'application des limites et les compteurs de session en temps réel s'arrêtent. La valeur recommandée est 5m.
La page de connexion Hotspot
Depuis l'onglet Hotspot, vous gérez la page de connexion du portail captif :
conservez les pages par défaut de MikroTik, appliquez l'un des modèles intégrés,
ou appliquez l'un de vos designs enregistrés. SAMM inclut un éditeur visuel
et une galerie de modèles — personnalisez une page de connexion et déployez-la directement sur le
hotspot du routeur.
QoS basée sur les applications
La vue QoS (un sous-onglet de Websites & Apps) transforme les applications et sites que SAMM détecte déjà sur le routeur en un forfait de priorité de téléchargement. Faites glisser chaque application depuis le pool vers l'un des huit emplacements de priorité — l'emplacement 1 est servi en premier en cas de congestion, l'emplacement 8 en dernier ; les applications restant dans le pool ne sont pas soumises au shaping. Vous pouvez optionnellement plafonner la vitesse de téléchargement de n'importe quelle application (par exemple 10M) et définir un plafond de téléchargement total pour lequel les priorités s'affrontent. Auto-distribute by category organise tout en un clic — la messagerie d'abord, puis les services AI, puis les boutiques, et tout le reste en dessous.
Lorsque vous l'envoyez, SAMM compile les emplacements en un arbre de files d'attente MikroTik
(étiqueté SAMM:qos, parent=global) avec des règles de pare-feu de marquage de paquets correspondantes,
la priorité la plus élevée en premier. Il repose sur le même catalogue Sites web et applications
qui alimente la surveillance, de sorte que seules les applications réellement vues sur le routeur apparaissent — et la suppression
de SAMM QoS retire du routeur tous les objets SAMM:qos, en laissant vos compteurs
intacts.
L'assistant de configuration
L'onglet Assistant regroupe tout en dix étapes rapides et envoie la configuration complète au routeur en un seul lot à la fin. Rien n'est envoyé tant que vous ne confirmez pas lors de l'étape de révision finale.
Bienvenue & détection — SAMM sonde le routeur et affiche ce qui est déjà configuré, vous permettant ainsi d'ignorer ces éléments lors du push.
Interface Bridge — nommez le bridge LAN.
Bridge ports — choisissez les interfaces physiques à ajouter au bridge.
DNS — définissez les résolveurs amont (préréglages en un clic pour Google, Cloudflare, Quad9 et d'autres), la taille du cache et, éventuellement, un filtre de contenu DNS.
NTP — définit la source d'horloge du routeur (client NTP et, optionnellement, serveur de temps pour le LAN).
Internet — ajoutez une ou plusieurs liaisons montantes WAN (Static / DHCP / PPPoE).
RADIUS vers SAMM — configurez le routeur pour qu'il pointe vers votre hôte SAMM pour l'authentification, la comptabilité et le CoA.
Services — choisissez si l'assistant crée un serveur PPPoE, un serveur Hotspot ou un service IPoE / DHCP, et activez éventuellement le IPv6 dual-stack (optionnel, désactivé par défaut) : sélectionnez la longueur du préfixe délégué (DHCPv6-PD) ainsi que les blocs IPv6, et l'assistant crée les pools et les associe au profil PPP.
Détails PPPoE / Hotspot & Pare-feu — pools, profils, durées de bail, règles de pare-feu & NAT, et un Pool d'expiration & blocage internet optionnel qui redirige les abonnés dont l'abonnement a expiré vers la page « abonnement expiré » de SAMM au lieu d'une connexion interrompue.
Réviser & envoyer — consultez la liste exacte des commandes qui seront envoyées, puis envoyez-les toutes au routeur.
Le débit par utilisateur provient de RADIUS
L'assistant crée un profil PPPoE / hotspot unique — il ne déploie pas de profils par palier. La vitesse de chaque abonné est transmise par SAMM dans la réponse RADIUS lors de la connexion, donc les changements de forfait ne nécessitent jamais de modification du routeur.
Réseaux & routeurs
Inspection approfondie
Quand un réseau semble lent, l’Inspection approfondie fait ce que ferait un ingénieur : elle observe un routeur un moment, lit tout ce qu’elle peut, et vous dit ce qui ne va pas et quoi faire en premier. Elle ne fait que lire : elle ne modifie jamais rien sur le routeur, et toute correction reste votre décision.
Lancer une inspection
Ouvrez Devices → Network Health et appuyez sur Inspection approfondie, ou faites un clic droit sur un routeur de la page.
Activez les routeurs à inspecter. Tous les interrupteurs démarrent désactivés. Seuls les BNG MikroTik avec une connexion enregistrée sont listés.
Choisissez la durée : 15 minutes, 30 minutes, 1 heure ou 2 heures. Une durée plus longue est plus fiable ; lancez-la aux heures de charge.
Appuyez sur Lancer l’inspection. Elle s’exécute en arrière-plan, vous pouvez donc fermer la page. Une inspection par routeur, deux au maximum en même temps.
Rapports, à côté du bouton, liste chaque inspection avec sa progression, son résultat et sa note. Vous pouvez en arrêter une tôt et garder ce qu’elle a mesuré jusque-là.
Ce qui est contrôlé
Liens internet : perte et délai vers internet et sur chaque lien, pics, et si les gros paquets passent.
Expérience utilisateur : messages de test vers un échantillon changeant d’utilisateurs connectés, et temps de réponse.
Files d’attente et débit : si les utilisateurs perdent des données quand leur forfait est plein, envoi et téléchargement, et règles qui peuvent contourner les limites de débit.
Réseau d’accès et ports : chaque côté d’accès, les antennes et les appareils derrière le routeur, erreurs de port, coupures, débit et signal fibre.
Équilibrage de charge : comment les liens se partagent le trafic, et si les règles d’équilibrage sont complètes et détectent un lien mort.
Santé du routeur : charge du processeur et de chaque cœur, mémoire, température, redémarrages, micrologiciel et journal du routeur.
Connexions et RADIUS : réponses à temps, connexions refusées, sessions qui se terminent tôt, et réglages de taille de paquets.
Sécurité : si le routeur est fermé à internet, l’ordre du pare-feu, les protections, les services supplémentaires et les connexions échouées.
Routage : sessions BGP, voisins OSPF et routes mortes.
Toutes les vérifications Network Health sont incluses. Une vérification qui n’a pas pu être lue est retirée du rapport, jamais comptée comme bonne.
Le rapport
Il commence par une note sur 100 et un verdict en termes simples, puis une fiche de résultats par domaine et une liste de ce qu’il faut faire, le plus important d’abord. Plus bas, les détails et les chiffres. Il suit la langue de votre panneau, et Export PDF l’enregistre avec le logo SAMM et « Prepared by SAMM » sur chaque page.
L’inspection est légère, et elle cesse de sonder les utilisateurs quand le processeur du routeur est très chargé. Si le routeur reste surchargé, elle se termine tôt et le signale.
Système
SCOOP AI
SCOOP AI est un assistant en bas de chaque page d’administration. Posez vos questions avec vos mots et votre langue sur vos utilisateurs, forfaits, cartes, factures, paiements et routeurs, et obtenez une réponse claire en quelques secondes. Il s’installe et s’active tout seul.
Connecter une IA
Dans Settings → SCOOP AI, connectez Google Gemini (clé gratuite), ChatGPT (connexion, sans clé), Claude, OpenAI, OpenRouter ou DeepSeek. Gardez plusieurs connexions enregistrées et basculez de l’une à l’autre, choisissez un modèle ou laissez sur Automatique. Une clé que l’IA refuse elle-même est arrêtée à l’enregistrement, et une page d’aide montre comment obtenir une clé pour chaque IA.
Ce qui le rend sûr
Il travaille avec les droits de chaque administrateur : un administrateur voit et modifie seulement ce que son rôle permet.
Les montants, suppressions et modifications de routeur sont retenus jusqu’à ce que vous appuyiez sur Approve.
Chaque modification de routeur garde une annulation sur le routeur lui-même et ne touche jamais au lien de SAMM avec le routeur.
Le journal SCOOP AI garde chaque question, réponse et approbation de chaque administrateur.
Ce que vous pouvez lui demander
Répondre à vos questions sur vos données, dans votre langue.
Répartir internet entre vos liens au pourcentage près, envoyer certaines applis ou un VPN par un lien choisi, et régler un DNS plus rapide.
Vous envoyer un rapport chaque lundi, ou vous rappeler à une heure donnée.
Les autorisations ont un bloc SCOOP AI : l’utiliser, voir le journal, modifier les réglages. Chaque administrateur peut le masquer pour lui-même depuis le menu du robot ou son Profil.
Réseaux & routeurs
Carte du réseau, état, Data Log & qualité de connexion
Carte du réseau
Devices → Network Map est généré à partir des informations que chaque routeur communique sur ses voisins — il n'y a aucun schéma à maintenir. Changez les couches pour afficher les ports, les adresses IP, les sous-réseaux et le CPU, ou affichez le chemin que chaque appareil emprunte vers internet. Glissez les nœuds pour les positionner et enregistrez la disposition ; Discover now analyse à nouveau les voisins.
Santé du réseau
Devices → Network Health liste tous les routeurs, les plus critiques en premier :
sain, avec des avertissements, répondant mais défectueux, ou injoignable. Chaque résultat indique le problème en
termes simples — CoA désactivé, secret RADIUS incorrect, horloge désynchronisée, Telnet ou FTP laissé ouvert. Les
vérifications se contentent de lire les données du routeur. Depuis la vue Diagnose d'un routeur, les résultats courants disposent d'un
correctif en un clic qui affiche d'abord un aperçu et peut être annulé. Les résultats non résolus déclenchent des alertes dans l'
Alert Center.
Pour un examen plus long d’un BNG MikroTik, avec un rapport complet, utilisez Inspection approfondie.
Les deux pages se trouvent sous un seul commutateur, Settings → Advanced → Network Health.
Lorsqu'il est désactivé, SAMM ne contacte pas les routeurs. Lorsqu'il est activé, vous choisissez également la fréquence de vérification de chaque routeur, le nombre de routeurs analysés par passage (les installations chargées sont réparties sur plusieurs passages) et si les voisins doivent être détectés pour la carte.
Un routeur qui est hors ligne depuis longtemps peut être mis en pause, afin qu'il cesse de générer des alertes jusqu'à ce qu'il réponde à nouveau.
Optimiseur Wi-Fi
Devices → Wireless → Wi-Fi optimizer affiche, pour chaque radio,
une vue du spectre de la bande utilisée (signal en dBm selon les fréquences, les réseaux
détectés et leurs chevauchements), une liste de ces réseaux, et un graphique des canaux qui indique si chaque
canal est Quiet, Busy ou Crowded. Survey now analyse l'ensemble de la bande, une radio à la fois afin qu'un
site avec plusieurs secteurs ne perde jamais tous ses clients simultanément ; le bouton indique l'impact avant de
commencer. Live sweep trace les dernières lectures, les pics et les moyennes en temps réel.
Le planificateur de canaux recommande le canal le moins encombré et la largeur de canal optimale pour chaque radio. Choisissez Off, Suggest ou Auto pour chaque radio, séparément pour son canal et sa largeur, ou laissez-la suivre son réseau ; configurez plusieurs radios simultanément depuis la liste Wireless. En mode Auto, SAMM déplace les radios à 04:00, une par une, et analyse à nouveau chaque radio sur son nouveau canal. Appliquer déplace une radio immédiatement et Annuler la replace. Cela fonctionne avec les radios MikroTik (paquets wifi et wireless, CAPsMAN) et les points d'accès Ubiquiti UniFi.
Journal des données
Ouvrez la fiche d'un utilisateur et choisissez Data Log pour voir où se dirige son trafic : destinations principales par hôte et application — YouTube, Facebook, WhatsApp — avec envoi, téléchargement et connexions, ou une chronologie. SAMM lit l'export de flux (IPFIX) du routeur, en revenant à sa table de connexions si nécessaire, et identifie les applications à partir du même catalogue que celui utilisé par l'App Filter. SAMM ne se place jamais sur le chemin du trafic.
L'option Record user Data Log l'active, sous Settings → Advanced → Data Log.
Le détail horaire est conservé pendant quelques jours, puis compacté en une ligne par site et par jour — soit environ un vingt-quatrième de la taille initiale. La page et l'exportation lisent les deux formats, donc aucune donnée ne disparaît de l'affichage.
Destinations par heure conserve les destinations les plus fréquentées de chaque utilisateur par heure et supprime la longue traîne d'adresses uniques ; 0 conserve tout.
Retention définit la durée de conservation des lignes avant qu'elles ne soient supprimées lors du nettoyage nocturne.
Une sauvegarde avec Skip usage exclut le Data Log, ce qui permet de limiter sa taille.
Désactivé jusqu'à ce que vous l'activiez
Un superadmin active le Data Log dans les paramètres et choisit sa durée de conservation. Les chiffres sont indicatifs ; la facturation s'appuie toujours sur la comptabilité RADIUS.
Qualité de la connexion
Tant qu'un utilisateur est en ligne, SAMM peut enregistrer sa vitesse moyenne toutes les quelques minutes, à partir des données de comptabilité qu'il reçoit déjà, et mesurer le délai et la perte via un test rapide depuis son routeur. La page utilisateur affiche une carte Qualité de connexion avec les derniers chiffres, un historique de vitesse par rapport au forfait et un bouton Tester maintenant ; la liste des utilisateurs dispose d'une colonne optionnelle et l'exportation peut inclure ces chiffres. L'historique est conservé pendant deux jours.
Désactivé jusqu'à ce que vous l'activiez
Activez-le dans Settings → Advanced → Connection Quality, où vous définissez également la fréquence d'échantillonnage des utilisateurs et le nombre d'utilisateurs qu'un routeur teste par cycle (les moins récemment mesurés en priorité). Il est conçu pour être léger : le test de débit ne consomme aucun trafic du routeur et la charge de test sur chaque routeur est plafonnée. Un appareil qui bloque le test n'affiche aucune réponse même si la ligne est opérationnelle. Test now fonctionne même lorsque la fonctionnalité est désactivée.
Réseaux & routeurs
CoA & modifications en temps réel
CoA (Change-of-Authorization) est le mécanisme par lequel SAMM modifie la session d'un abonné pendant qu'il est en ligne — pour augmenter ou réduire son débit, ou pour le déconnecter — sans attendre qu'il se reconnecte.
Comment un changement est appliqué à un abonné actif
SAMM n'applique jamais de modification de routeur directement via un clic sur un bouton. Chaque action de l'administrateur suit un seul chemin sécurisé :
Action de l'administrateur→Journal d'audit→samm-radius tick→Boîte d'envoi CoA→Routeur
L'action est enregistrée dans un journal d'audit en tant que commande mise en file d'attente.
Le service samm-radius vide la file d'attente lors de son prochain tick, applique le changement et — si l'abonné est en ligne — place un CoA dans la file d'attente.
La boîte d'envoi CoA est vidée et le paquet est envoyé au routeur.
Les événements basés sur le temps — expiration, limites de fenêtres de vitesse, réinitialisations quotidiennes — alimentent la même boîte d'envoi.
La limite supérieure de la latence est d'un tick samm-radius (30 s par défaut ; réduisez-la dans Paramètres pour une application plus stricte).
CoA hybride
SAMM envoie d'abord un CoA-Update pour modifier la session en cours. Si le routeur le rejette après le nombre de tentatives configuré, SAMM bascule automatiquement vers un Disconnect-Request — l'abonné se reconnecte et récupère les nouveaux paramètres. Cette stratégie hybride fonctionne sur toutes les versions du firmware MikroTik.
La page CoA Outbox
Users → CoA Outbox est la vue en temps réel de cette file d'attente.
samm-radius est l'unique expéditeur — le panneau administrateur n'envoie jamais de CoA
directement — et il vide la file d'attente à chaque cycle. La page s'actualise automatiquement toutes les
30 secondes.
Six compteurs figurent en haut de la page — Pending, Sent, NACK (retrying), Done,
Failed et Total. Filtrez le tableau par statut, par action
(update ou disconnect), ou effectuez une recherche par nom d'utilisateur, IP NAS ou
raison.
État
Signification
en attente
Mis en file d'attente, en attente du prochain tick samm-radius
envoyé
Expédié (transitoire — l'envoi et son résultat sont enregistrés lors du même tick, les lignes restent donc rarement dans cet état)
nack
Le routeur a rejeté le CoA-Update — SAMM effectue une nouvelle tentative, puis procède à une déconnexion
Terminé
Appliqué avec succès
échec
Échec après avoir atteint la limite de tentatives — survolez le badge pour afficher la dernière erreur
Chaque ligne affiche l'utilisateur, le routeur, l'action, le nombre de tentatives, le motif, ainsi que les heures de création et d'envoi. Les actions par ligne vous permettent de Réessayer l'envoi d'un paquet ayant échoué ou ayant reçu un NACK, d'en Annuler un encore en cours d'envoi, ou d'ouvrir les Attributs pour inspecter les attributs RADIUS exacts transportés par le paquet. Le badge de la barre latérale indique le nombre de lignes en attente ; le tableau de bord suit les échecs sur 24 heures. Un système sain maintient cette file d'attente presque vide.
Nettoyeur de sessions obsolètes
Si un routeur plante ou perd sa connectivité, ses paquets Accounting-Stop peuvent être perdus — et sur de nombreux systèmes, ces abonnés restent « en ligne » indéfiniment. SAMM recherche les sessions qui ont cessé d'envoyer des Interim-Updates et les ferme automatiquement (cause de terminaison Reaped-Stale), afin que la liste des sessions actives, le nombre d'utilisations simultanées et les chiffres de consommation restent exacts. Le délai d'expiration est défini par le paramètre stale_session_timeout_seconds (par défaut 900 s = 15 minutes ; régler sur 0 pour désactiver), et il s'applique instantanément — aucun redémarrage n'est nécessaire.
Opérations quotidiennes
Tableau de bord & sessions en direct
Les deux écrans sous Overview sont vos points de départ à chaque début de service — le tableau de bord pour l'état de santé de l'ensemble du système, et Live Sessions pour savoir exactement qui est connecté actuellement.
Deux écrans : ouvrir dans une nouvelle fenêtre
Chaque page a un bouton Ouvrir dans une nouvelle fenêtre dans la barre du haut : la page s'ouvre seule, sans barre latérale ni barre du haut, prête à être glissée sur un second écran. Les liens de cette fenêtre restent dans le même mode. Chaque bloc du tableau de bord a le même bouton dans son coin : le bloc remplit sa propre fenêtre et continue de s'actualiser avec le tableau de bord, pour garder les Sessions en direct, l'état des routeurs ou un graphique sous les yeux toute la journée sans changer la disposition de votre tableau de bord.
Tableau de bord
Overview → Dashboard est l'écran d'accueil de l'opérateur. Un sélecteur de période en haut — Today, 7d, 14d, 30d, 90d — définit la plage temporelle du graphique de tendance et des données chiffrées.
Les six tuiles KPI
Chaque tuile est un compteur en temps réel et un raccourci — cliquez dessus pour accéder directement à la liste filtrée correspondant au nombre.
Tuile
Affiche
Ouvrir
En ligne maintenant
Abonnés ayant actuellement une session RADIUS active
Utilisateurs filtrés sur Online
Abonnés actifs
Comptes actifs, avec le nombre total d'abonnés ci-dessous
Utilisateurs filtrés sur Active
Expiré
Abonnés dont l'abonnement a expiré sans forfait suivant défini
Utilisateurs filtrés sur Expired
Tickets ouverts
Tickets d'assistance non encore résolus (exclut terminé & fermé)
Utilisateurs → Tickets d'assistance
Routeurs
Nombre total d'enregistrements NAS, plus le nombre d'enregistrements actuellement injoignables
Le moniteur MikroTik
Factures impayées
Factures nécessitant encore une relance de paiement
Factures filtrées sur Unpaid
Graphique des utilisateurs & sessions actives
Un graphique linéaire d'instantanés quotidiens trace trois séries sur la période sélectionnée —
utilisateurs actifs, sessions en ligne et
utilisateurs expirés — afin que la croissance et l'attrition soient visibles d'un coup d'œil.
État du pipeline
Ce panneau est le cœur du moteur d'application. Sur un système sain, les files d'attente sont à zéro ou proches de zéro — un nombre qui reste élevé indique un service bloqué ou un routeur rejetant les modifications.
Métrique
Ce que cela signifie
samm-radius file d'attente
CoAs en attente du prochain tick — devraient être effacés d'ici quelques secondes
Échecs CoA (24h)
Zéro sur un système sain ; un nombre non nul signifie qu'un routeur rejette les CoA
Journal d'audit en attente
Actions d'administrateur en file d'attente non encore appliquées par samm-radius
Sessions bridées
Abonnés actuellement limités à une vitesse réduite par une limite — attendu, pas une erreur
Instantané des sessions
Le nombre de sessions actives — doit correspondre à Online now
Forfaits actifs
La taille de votre catalogue de forfaits
Le chemin d'application
Les actions de l'administrateur sont mises en file d'attente dans samm.audit_log ; le tick samm-radius les traite et émet des CoA vers samm.coa_outbox. Le chemin complet se trouve dans CoA & live changes.
Tableaux d'activité récente
Quatre tableaux sous le graphique offrent une vue actualisée des événements récents, chacun avec un lien View all vers sa page complète :
Boîte d'envoi CoA récente — action, utilisateur, statut (done / pending / nack / failed), nombre de tentatives, motif et heure.
Actions récentes de l'administrateur — action, cible, l'acteur qui l'a déclenchée, si elle est déjà appliquée et l'heure.
Abonnés récents — les comptes les plus récents, avec leur statut et l'heure de leur dernière authentification.
Routeurs — chaque NAS avec un indicateur d'état accessible / inaccessible / sans données.
Sessions en direct
Overview → Live Sessions liste tous les abonnés que les
routeurs signalent actuellement comme étant en ligne via le comptage RADIUS. La page
s'actualise automatiquement toutes les 30 secondes ; un bouton
Refresh manuel se trouve dans l'en-tête.
Filtrer la liste
Recherche — correspond au nom d'utilisateur, à l'IP framed ou à l'IP NAS, avec mise à jour en temps réel lors de la saisie.
Routeur — restreindre la liste aux sessions d'un seul NAS.
Uniquement bridés — afficher seulement les abonnés dont la vitesse est limitée.
Par page — 20, 50, 100 ou 200 lignes.
Signification de chaque ligne
Colonne
Signification
Utilisateur
Nom d'utilisateur — lien vers la page de détails de l'abonné
IP encadrée
L'adresse que le routeur a assignée à cette session
Routeur
Le nom court du NAS et son adresse IP
Forfait
Le forfait actuel de l'abonné
Débit effectif
La vitesse actuellement appliquée sur le routeur — la vitesse du forfait ajustée par toute fenêtre de vitesse active. Un badge throttled signifie qu'une limite bride l'abonné à une vitesse réduite.
Bas / Haut
Compteurs d'octets en temps réel pour la session
En ligne
Durée de la session active
Démarré
Au début de la session
Déconnexion d'une session
Le bouton Disconnect d'une ligne place un CoA-Disconnect en file d'attente
pour cette session précise (raison admin_manual) après une demande de confirmation.
L'abonné est immédiatement déconnecté ; si son compte est toujours actif, il peut
se reconnecter. Suivez le paquet dans la CoA Outbox.
Opérations quotidiennes
Rapports & analyses
Overview → Reports est la vue analytique — tendances des abonnés, trafic au fil du temps, ainsi que les utilisateurs et cartes les plus gourmands de votre réseau.
Choix de la plage
Chaque donnée de la page est liée à une plage de dates. Choisissez un préréglage —
7d, 14d, 30d, 90d — ou saisissez des dates de début et de
fin précises et cliquez sur Appliquer. Un indicateur de chargement couvre
la page pendant l'exécution d'une requête sur une longue période, telle que 90d.
Tendances des abonnés & sessions
Un graphique linéaire avec trois séries sur la plage choisie : abonnés Active, sessions Online et abonnés Expired. Utilisez-le pour identifier la croissance, l'attrition et les heures de pointe de votre réseau.
Trafic quotidien
Un graphique à barres empilées des octets d'envoi et de téléchargement par jour. Le survol d'un jour affiche les valeurs d'envoi et de téléchargement ainsi qu'un total combiné dans le pied de page de l'infobulle.
Les 10 meilleures listes
Quatre tableaux affichent vos comptes générant le trafic le plus important, chacun étant classé par volume en GB :
Liste
Rangs
Top 10 des téléchargements aujourd'hui
Téléchargement le plus volumineux depuis la dernière réinitialisation quotidienne
Top 10 des envois aujourd'hui
Envoi le plus important depuis la dernière réinitialisation quotidienne
Top 10 des téléchargements du mois
Téléchargement le plus volumineux de ce mois civil
Top 10 des envois du mois
Envoi le plus important de ce mois civil
Trafic par entité
Un tableau paginé et consultable du trafic par compte. Deux onglets permettent de modifier l'affichage :
Utilisateurs — chaque abonné avec son nom, son forfait, le volume d'envoi/téléchargement du jour en MB, et celui du mois en GB.
Cartes — chaque carte hotspot avec son groupe, son statut, et la même répartition du trafic journalier / mensuel.
Le champ de recherche filtre le tableau au fur et à mesure de la saisie ; le sélecteur par page permet de choisir entre 20 et 200 lignes. Chaque ligne renvoie vers la page de détails de l'abonné ou de la carte.
Exportation
Reports est une vue analytique intégrée. Pour obtenir des données brutes à traiter dans un tableur, utilisez Tools → Export / Import pour télécharger les utilisateurs, les forfaits ou les NAS au format CSV / XLSX.
Page Trafic en direct
Une vue en direct et distincte du débit actuel pour les utilisateurs, les routeurs et les interfaces, avec un rafraîchissement allant jusqu'à une fois par seconde. Ajoutez aux favoris les combinaisons que vous vérifiez souvent pour y accéder en un clic la prochaine fois.
Opérations quotidiennes
Comptabilité & facturation
SAMM intègre un système complet de comptabilité en partie double —
factures, dépenses, reçus, paiements, revendeurs, immobilisations et états financiers complets. Il n'y a aucun produit de facturation distinct à intégrer, et aucun comptable n'est nécessaire pour tenir la comptabilité à jour.
Vous ne devez jamais modifier les débits et les crédits
Chaque action — enregistrement d'un paiement, ajout d'une dépense, vente d'un groupe de cartes —
génère automatiquement une écriture comptable équilibrée dans le grand livre. Vous
travaillez avec des termes simples (factures, dépenses, reçus) ; SAMM gère la comptabilité en partie double en arrière-plan et prouve l'équilibre dans la Balance de vérification.
La page Accounting est organisée en onze onglets.
Vue d'ensemble
L'aperçu financier. Quatre chiffres clés figurent en haut :
Figure
Signification
Espèces disponibles
Solde total de tous les comptes de caisse & banque
Montants dus
Créances — factures clients et revendeurs impayées
Montant dû
Comptes fournisseurs — dépenses impayées
Bénéfice ce mois-ci
Revenus moins dépenses pour le mois en cours
Ci-dessous : un tableau de tous les comptes de caisse & banque avec leur solde, ainsi qu'un graphique revenus vs dépenses sur les 1, 2, 3, 6 ou 12 derniers mois.
Livres par agence
Chaque facture, paiement, dépense, actif et compte de trésorerie appartient à une agence ou à la société General. Une facture conserve l'agence de l'utilisateur au moment de son émission, même si l'utilisateur change d'agence ultérieurement. Un sélecteur d'Agence en haut de chaque onglet affiche l'ensemble de la société, la société General uniquement, ou une agence avec ses sous-agences, et les listes peuvent être filtrées, triées et groupées par agence. Un administrateur d'agence disposant de la permission Financial ne voit que la comptabilité de sa propre agence.
Remise d'espèces : une agence envoie des espèces de son propre compte de caisse vers un compte de caisse de l'entreprise ; l'opération est enregistrée lorsque l'entreprise confirme la réception. Rapports → Agences affiche chaque agence côte à côte : revenus, dépenses, net, encaissements, impayés, utilisateurs actifs et revenu par utilisateur.
Factures
Une facture est un document de paiement que vous émettez. Cliquez sur New invoice et remplissez :
Champ
Signification
Client
Recherche prédictive du compte à facturer
Catégorie de revenus
Compte de revenus utilisé pour l'enregistrement des ventes
Date d'émission / Date d'échéance
Date d'émission vide = aujourd'hui ; date d'échéance vide = date d'émission
Taux de taxe % / groupe de taxe
Par défaut, le taux est celui défini dans Paramètres → Facturation ; attribuez un groupe fiscal pour appliquer plusieurs taux (TVA/GST et plus) en même temps, chacun étant posté à son propre compte fiscal
Postes de ligne
Une ou plusieurs lignes de description / quantité / prix unitaire — le sous-total, la taxe et le total sont calculés en temps réel
Montant de la facturation — total, segmenté ou aucun
Chaque fois que SAMM s'apprête à facturer un abonné — activation, renouvellement, changement de forfait, extension de date d'expiration, ou l'une de ces actions en masse — le même sélecteur de facture apparaît, et il affiche le montant avant que vous ne validiez :
Choix
Frais appliqués
Facture complète
Périodes de forfait complètes uniquement — toute période partielle est arrondie à l'unité supérieure.
Facture segmentée
L'heure exacte, au prorata de la dernière période. Le total est arrondi à l'unité entière la plus proche, et la différence est enregistrée comme un ajustement d'arrondi afin que la comptabilité reste équilibrée.
Aucune facture
Modifier le service et ne rien facturer — un geste commercial, une migration, une correction.
Définissez la durée avec le multiplicateur de périodes pour des périodes de forfait complètes, ou saisissez une date exacte et laissez SAMM calculer le coût. Dans les deux cas, le panneau affiche les lignes de détail, la taxe et le total au fur et à mesure des modifications, et Paid enregistre immédiatement un paiement comptant pour le montant total.
"Pas de facture" est un droit, pas une case à cocher
Le fait de ne rien facturer est une décision financière, c'est pourquoi cette option est contrôlée par une permission par rôle dans
Paramètres → Administrateurs. Cela est particulièrement important pour les
agents : un agent dont les abonnés sont facturés sur leur propre solde prépayé
pourrait autrement renouveler, changer de forfait et prolonger les expirations sans cesse sans jamais
les payer. Pour les nouveaux rôles, ce droit est désactivé (off).
Relances & portefeuille prépayé
Au-delà des factures ponctuelles, SAMM automatise l'ensemble du cycle de recouvrement. Un calendrier de relance définit un jour de facturation, une date d'échéance et un jour de blocage automatique — avec des frais de retard optionnels — afin que les abonnés en retard soient relancés, puis coupés, sans que vous ayez à surveiller un tableur. Un mode portefeuille prépayé permet aux abonnés de disposer d'un solde qui règle automatiquement les factures lors du renouvellement ; ils le rechargent eux-mêmes depuis le portail client par carte ou crypto, et chaque recharge et déduction est enregistrée dans le grand livre.
Forfaits de grâce : facturation d'abord, renouvellement après paiement
Une configuration courante consiste en une chaîne de forfaits : le forfait payant expire et bascule vers un court forfait de grâce à pleine vitesse, puis vers un forfait lent, avant que l'utilisateur ne soit déconnecté. Activez Raise the renewal invoice when a paid plan expires into its next plan dans Accounting → Settings et SAMM émettra la facture de renouvellement au moment où l'utilisateur passe en période de grâce, avec une échéance à la fin de celle-ci. Dès qu'elle est payée — au comptoir, en ligne ou via le portefeuille — l'utilisateur retrouve son forfait, avec une date d'effet rétroactive au jour de l'expiration, afin que la date de facturation ne change jamais. Les utilisateurs n'ayant pas payé continuent simplement de descendre dans la chaîne.
Ne cliquez pas sur Renouveler le forfait pour ces utilisateurs
Le renouvellement du forfait rétablit immédiatement l'intégralité du service, qu'il soit payé ou non. Lorsque ce paramètre est activé, la facture et le paiement effectuent le renouvellement pour vous. Le paramètre est désactivé jusqu'à ce que vous l'activiez.
Les factures sont également générées automatiquement lors du renouvellement du forfait d'un abonné (via l'action Renew Expiration de l'utilisateur ou par renouvellement automatique), à condition que le forfait ait un prix. La liste peut être filtrée par statut — unpaid, partial, due, paid — et permet la recherche par numéro de facture ou par client. Ouvrez une facture pour accéder à sa page de détails et à un PDF imprimable ; les abonnés peuvent télécharger leurs propres copies depuis le portail client et le bot Telegram.
Dépenses
Une dépense correspond aux frais engagés pour l'exploitation de l'ISP. Nouvelle dépense enregistre
une catégorie (le compte de dépense), le constructeur payé, le montant, la date d'engagement et une
date d'échéance facultative. Chaque dépense suit le même cycle de vie unpaid / partial / due / paid
qu'une facture, possède une page de détails et un voucher PDF imprimable.
Recettes & Paiements
Ces deux onglets enregistrent les mouvements de fonds réels — distincts de la facture ou de la dépense qui en a été la cause.
Recettes — argent entrant : espèces reçues d'un client, d'un revendeur ou autres revenus, arrivant sur l'un de vos comptes de trésorerie. Une facture est la demande de paiement ; le reçu est l'argent reçu en règlement de celle-ci.
Paiements — flux sortant : sommes versées pour une dépense ou à un revendeur.
L'enregistrement d'un reçu ou d'un paiement fait passer la facture ou la dépense associée à l'état payé et comptabilise l'écriture correspondante dans le grand livre.
Clients & ventes de cartes
L'onglet Customers affiche le solde actuel de chaque utilisateur — ce qu'il vous doit. Card sales couvre les revenus des hotspots prépayés : il suit les groupes de cartes vendus et les resellers. Un reseller vous achète des groupes de cartes complets sur facture, puis revend les cartes individuelles aux utilisateurs finaux ; leur solde dû correspond au montant qu'ils doivent encore vous payer.
Agents — facturation de gros
Un agent revend votre service à des clients finaux selon un modèle de vente en gros prépayé — imaginez une franchise ou un sous-revendeur qui gère son propre portefeuille d'abonnés mais s'appuie sur votre réseau. C'est entièrement optionnel : si vous ne créez jamais d'agent, la facturation fonctionne exactement comme elle l'a toujours fait.
Deux dettes, nettement séparées
L'agent vous doit le prix de gros (dans votre comptabilité, il s'agit de votre revenu) ; le client doit à l'agent le prix de détail (hors comptabilité — la créance propre de l'agent). Votre commission est l'écart entre les deux, enregistrée comme une remise commerciale, et jamais comme une dépense.
Créez un agent dans Paramètres → Administrateurs en attribuant le rôle intégré Agent à un nouvel administrateur. Un agent est un identifiant administrateur à portée limitée avec :
Paramètre
Signification
Commission %
La commission de l'agent sur le prix de détail (ex. 40 % — vous conservez 60 % de revenus de gros). Modifiable par agent, à tout moment.
Limite de crédit
Seuil maximal de solde prépayé négatif autorisé pour l'agent avant que les renouvellements ne soient refusés. Réglez sur 0 pour un prépayé strict.
Solde prépayé
Rechargez-le lorsque l'agent vous paie ; chaque renouvellement y prélève le prix de gros.
Lorsqu'un des abonnés d'un agent renouvelle son abonnement, SAMM débite le solde de l'agent au prix de gros, enregistre vos revenus et émet une facture de détail réelle au client final, payable à l'agent et exclue de votre comptabilité. La relance côté agent — un commutateur dédié sous Paramètres → Facturation, activé par défaut, avec un délai de grâce modifiable — suspend automatiquement un client non payeur (en émettant une déconnexion CoA) ; lorsque l'agent enregistre le paiement du client, l'abonné est réactivé instantanément.
Un agent se connecte à une vue restreinte : son propre tableau de bord, une page de portefeuille My Balance, une liste My Customers avec les factures et les paiements de chaque client, et un My Statement — le tout limité à sa propre comptabilité. La comptabilité de votre entreprise, ainsi que les clients des autres agents et administrateurs, restent masqués.
Actifs & comptes de trésorerie
Assets — enregistrez les immobilisations (routeurs,
véhicules, équipements). SAMM suit leur valeur et leur amortissement au fil du temps.
Cash — gérez vos comptes bancaires & cash,
et vos comptes de capital : capitaux propres, où un apport est
de l'argent que le propriétaire injecte dans l'entreprise et un retrait est de l'argent retiré. Le capital
n'est pas un revenu et n'apparaît jamais dans le Profit & Loss.
Rapports — les états financiers
L'onglet Reports est la vue comptable. Cinq rapports, chacun avec une plage de dates et exportable en PDF :
Rapport
Réponses
Pertes & Profits
Revenus vs dépenses et bénéfice net sur une plage de dates. Comptabilité d'engagement — les revenus sont comptabilisés lors de la facturation et les dépenses lors de leur engagement, et non lors des flux de trésorerie.
Bilan
À une date donnée : vos actifs (ce que vous possédez) par rapport à vos passifs (ce que vous devez) plus les capitaux propres. Un badge équilibré confirme que les deux côtés concordent.
Flux de trésorerie
Par compte espèces — solde initial, entrées, sorties, solde final sur une période.
Expiration
Créances et dettes impayées classées par tranches d'ancienneté, pour vous permettre de relancer les factures échues et d'anticiper vos paiements.
Avancé
Les livres bruts : le Grand Livre (chaque ligne d'un compte avec un solde progressif), la Balance (le contrôle de l'équilibre des livres), le Journal et un journal d'activité.
La vérification de l'équilibrage
Dans la Balance de vérification, les totaux des colonnes débit et crédit de chaque compte doivent être égaux — c'est la preuve que la comptabilité est exacte. Si un déséquilibre apparaît, cela indique une erreur d'imputation qui mérite d'être examinée.
Export vers le logiciel de comptabilité
Sous Accounting → Reports → Export, téléchargez les journaux au format CSV pour
QuickBooks, Xero ou tout tableur : General Journal, Chart of Accounts, Invoices, Trial
Balance, Profit & Loss et Balance Sheet. General Journal, Invoices et P&L utilisent la
plage de dates ; les autres sont arrêtés à la date du jour. Les mêmes données sont disponibles via l'API via
GET /api/v1/accounting/export/{kind} (format=json|csv, scope
accounting:read) pour les pipelines BI et Zapier. Les exports excluent les écritures annulées, ainsi
qu'un téléchargement concorde toujours avec les rapports affichés à l'écran.
Opérations quotidiennes
Annulation & approbations
La plupart des erreurs dans un panneau ISP sont des erreurs financières : le renouvellement d'un mauvais abonné, un paiement enregistré deux fois, un forfait modifié sur le mauvais compte. SAMM vous offre une fenêtre d'annulation de cinq minutes pour ces actions et — lorsqu'une action implique un remboursement — une validation par le superadmin avant qu'elle ne prenne effet.
La fenêtre d'annulation
Chaque action de l'administrateur modifiant des fonds ou un état est enregistrée en temps réel. Pendant les cinq minutes suivantes, la barre supérieure affiche un bouton Annuler et une liste Historique des actions — cliquez sur la flèche pour annuler la dernière action, ou ouvrez l'historique pour revenir à n'importe quel point dans cet intervalle. Rétablir permet de rétablir l'action.
Pourquoi seulement cinq minutes
L'annulation n'est pas une machine à remonter le temps — c'est un filet de sécurité pour le clic que vous venez d'effectuer.
Après quelques minutes, la situation a évolué : l'abonné s'est connecté, une facture
a été payée, quelqu'un d'autre a modifié l'enregistrement. SAMM préfère refuser plutôt que de
réécrire l'historique en silence ; l'étape disparaît donc simplement de votre historique à la fermeture de la fenêtre.
Une annulation est refusée — avec la raison affichée à l'écran — lorsque son exécution détruirait un élément qu'elle n'a pas créé :
Refus
Ce que cela signifie
Cet enregistrement n'existe plus
L'abonné, la facture ou le paiement a été supprimé après votre action — il ne reste plus rien à restaurer.
Cet enregistrement existe déjà
Un élément a été recréé à sa place ; l'annulation écraserait l'enregistrement le plus récent.
Cet enregistrement a été modifié suite à votre action
L'annulation est une inversion, pas une suppression : l'action d'origine et son annulation restent toutes deux dans le Audit log, l'historique des événements n'est donc jamais perdu. Les actions qui créent un élément vous avertissent clairement — l'annulation de cette action supprimera l'élément créé — avant de s'exécuter.
Le point de validation de l'agent
Un agent paie pour un abonné via son propre solde prépayé au moment de l'activation. Par conséquent, l'annulation d'une action permet de récupérer des fonds — et peut être utilisée pour frauder : activer un abonné, le laisser utiliser le service tout le mois, puis le supprimer le dernier jour pour récupérer le paiement.
Ainsi, SAMM répartit les actions d'un agent selon le sens du flux financier :
Direction
Exemples
Comportement
Engendre des frais pour l'agent
Activer, renouveler, changer de forfait, encaisser un paiement client
Immédiat. Le travail quotidien d'un agent n'attend personne.
Remboursement
Annuler, supprimer un abonné, supprimer une facture, annuler un recouvrement
Mis en attente sous forme de demande. Rien ne change tant qu'un superadmin ne l'a pas approuvée.
Les actions soumises à validation ne sont jamais exécutées partiellement. La requête est stockée avec tous les éléments nécessaires à son exécution ultérieure, et l'approbation la rejoue via le même code que l'agent aurait exécuté — jamais une seconde implémentation qui pourrait diverger de la première. Le rejet laisse l'état du système exactement tel qu'il était, et l'agent conserve la charge.
Gestion de la file d'attente
Les demandes arrivent dans Accounting → Agents Approval avec l'agent, l'action, l'objet de la demande et le montant remboursé — le chiffre qui détermine la décision. Filtrez par agent ou statut, effectuez une recherche, cochez-en plusieurs et approuvez ou rejetez-les groupément ; un rejet peut être accompagné d'un motif court, visible par l'agent.
Déléguer
L'examen des agents tout au long de la journée est rarement la tâche du superadmin. Le droit Agents Approval peut être accordé à n'importe quel rôle dans Paramètres → Administrateurs, afin que la personne qui effectue réellement l'examen dispose précisément de ce pouvoir — et de rien d'autre. La création et la gestion des agents restent réservées au superadmin. Personne ne peut valider sa propre demande.
Ce que voit l'agent
Un agent dispose d'une page My Account → Pending Approvals
répertoriant toutes ses demandes : celles en attente, ainsi que celles approuvées ou
refusées — avec le motif du réviseur. Sans cela, un refus serait indiscernable
d'une demande ayant disparu, et l'agent renouvellerait simplement sa demande.
Ils peuvent retirer leurs propres demandes en attente — une par une ou
plusieurs à la fois — car demander quelque chose que l'on ne peut pas annuler est un piège en soi. Une demande
retirée n'a jamais été exécutée, donc rien ne change ; une demande traitée est définitive et demeure. Une facture
en attente de révision l'indique également sur sa propre page, ainsi un agent qui a cliqué sur Supprimer et
n'a constaté aucun changement comprend pourquoi.
Pour vos abonnés
Paiements en ligne
SAMM permet à vos abonnés de payer leurs factures en ligne — par carte bancaire
(Stripe ou PayPal), en cryptomonnaie (Binance),
ou avec Sham Cash en Syrie.
Lorsqu'un abonné
paie, SAMM marque la facture comme payée, l'enregistre dans votre comptabilité
et — s'il avait été coupé pour non-paiement — le reconnecte automatiquement.
Vous n'êtes jamais facturé : chaque passerelle utilise votre propre compte, l'argent vous revient donc directement.
L'activer (toute passerelle)
Allez dans Financial → Online payments (superadmin uniquement).
Cliquez sur une passerelle pour la développer — Stripe, PayPal ou Binance.
Remplissez les champs, cochez Enable this gateway et cliquez sur Save. SAMM ne vous permettra pas d'enregistrer tant que les champs obligatoires ne sont pas remplis.
Cliquez sur Run test pour confirmer que vos identifiants fonctionnent.
Terminé — vos abonnés voient désormais un bouton Payer sur leurs factures impayées dans le portail (et sur la page « abonnement expiré »).
Vous pouvez activer plusieurs passerelles — l'abonné choisit laquelle utiliser.
Stripe — cartes bancaires, monde entier
Créez un compte gratuit sur stripe.com. Laissez le Test mode activé pendant vos essais.
Allez dans Developers → API keys et copiez la Secret key (elle commence par sk_).
Dans SAMM, développez Stripe, collez la Secret key, choisissez la devise et le compte de caisse destinataire, puis Enregistrer et Lancer le test.
Recommandé : ajoutez un webhook pour que les paiements soient confirmés de manière fiable. Dans Stripe, allez dans Developers → Webhooks → Add endpoint, définissez l'URL sur https://YOUR-SAMM/pay/webhook/stripe, choisissez l'événement checkout.session.completed, puis copiez son secret de signature (whsec_…) dans le champ Webhook signing secret de SAMM.
Mise en service
Le mode test fonctionne partout. La réception de fonds réels via Stripe nécessite un pays pris en charge par Stripe et un compte bancaire lié.
PayPal — cartes & solde PayPal
Créez un compte PayPal Business, puis sur developer.paypal.com, créez une App REST et copiez son Client ID et son Secret.
Dans SAMM, développez PayPal, collez le Client ID et le Client secret, choisissez Sandbox (test) ou Live, puis Enregistrer et Lancer le test.
Recommandé : ajoutez un webhook sur developer.paypal.com → votre App → Webhooks, URL https://YOUR-SAMM/pay/webhook/paypal, abonnez-vous à CHECKOUT.ORDER.APPROVED et PAYMENT.CAPTURE.COMPLETED, puis collez le Webhook ID dans SAMM afin que les notifications entrantes soient vérifiées cryptographiquement.
Binance — crypto, fonctionne partout, sans banque nécessaire
C'est la meilleure option lorsque les cartes et PayPal ne sont pas disponibles. Vos abonnés paient en
crypto ; SAMM surveille votre compte Binance et marque automatiquement la facture comme payée.
Vous avez besoin de trois éléments : une API Key, un API Secret et un moyen de recevoir — une
adresse de portefeuille et/ou un Binance Pay ID.
Étape 1 — Créer une clé API en lecture seule
La sécurité avant tout
Créez la clé avec un accès en lecture seule. N'activez jamais Withdraw ou Trade —
SAMM a seulement besoin de lire vos paiements entrants, et ne doit jamais déplacer de fonds.
Connectez-vous à Binance → ouvrez Compte → Gestion des API (ou recherchez « Gestion des API »).
Cliquez sur Create API → choisissez System generated → nommez-la, par exemple « SAMM » → terminez la vérification de sécurité.
Binance affiche la API Key et la Secret Key — copiez les deux dès maintenant (la Secret Key n'est affichée qu'une seule fois).
Cliquez sur Edit restrictions et cochez uniquement "Enable Reading". Laissez Spot Trading et Withdrawals désactivés. (Facultatif : restreignez la clé à l'adresse IP de votre serveur.)
Collez l' API Key et l' API Secret dans la carte Binance de SAMM (la Key d'abord, puis le Secret — dans le même ordre que Binance les affiche).
Étape 2 — Obtenir l'adresse de votre portefeuille de réception
Dans Binance, allez dans Wallet → Spot → Deposit (Deposit Crypto).
Choisissez la cryptomonnaie USDT.
Choisissez le réseau — TRC20 est le moins cher et le plus courant ; BEP20 et ERC20 fonctionnent également. Utilisez le même que celui sélectionné dans SAMM.
Copiez l' Adresse de dépôt et collez-la dans le champ On-chain receiving wallet address de SAMM. Assurez-vous que le menu déroulant Network de SAMM correspond au réseau que vous avez choisi.
Étape 3 — (optionnel) Binance Pay ID
Pour les abonnés qui préfèrent Binance Pay (instantané, sans frais de réseau) : dans l'application Binance, ouvrez Pay et notez votre Pay ID (votre e-mail ou numéro de téléphone fonctionne également). Collez-le dans le champ Binance Pay ID de SAMM. Les abonnés peuvent ensuite payer via Pay ID ainsi qu'on-chain.
Enfin, cochez Enable, cliquez sur Save, puis sur Run test
(cela vérifie que la clé peut accéder à votre compte). Vous êtes opérationnel.
Montant exact, réseau correct
L'abonné doit envoyer le montant exact indiqué par SAMM (les derniers chiffres identifient sa facture) sur le réseau correct. Un montant différent ou un mauvais réseau retardera le traitement ou entraînera la perte du paiement.
Sham Cash — Syrie
Vos utilisateurs paient depuis leur application Sham Cash ou le site web Sham Cash, et SAMM est informé dès que le paiement est effectué. L'argent est versé sur votre propre compte commercial Sham Cash.
Ouvrez un compte commercial Sham Cash vérifié, puis demandez à l'assistance Sham Cash de créer un service de paiement électronique pour vous (ils vous demanderont l'adresse de votre logo et le nom que vos utilisateurs verront).
Sham Cash vous fournit trois valeurs : la Agent Key, la Secret Key et la
Base URL. Le service de test et le service réel possèdent chacun leurs propres trois valeurs.
Dans SAMM, ouvrez Finances → Paiements en ligne → Sham Cash, laissez Connexion sur Official API, collez les trois valeurs, choisissez la devise (USD ou SYP, la même que celle de SAMM), puis Enregistrer et Lancer le test.
SAMM doit être accessible depuis Internet pour que Sham Cash puisse confirmer chaque paiement. Si votre SAMM est publié sous une autre adresse, saisissez-la dans Public SAMM address for the callback. Aucune configuration n'est nécessaire du côté de Sham Cash : SAMM envoie sa propre adresse avec chaque paiement.
Service de test ou service réel
Avec les valeurs test, chaque paiement est une simulation : la page de paiement accepte le code 000000, SAMM affiche la facture comme payée et aucun fonds n'est versé sur aucun compte. Les paiements réels nécessitent les valeurs de votre service real fournies par l'assistance Sham Cash. Vérifiez l'URL de base que vous avez enregistrée : l'URL de test n'est pas l'URL réelle.
Ce que l'utilisateur fait : sur la carte de paiement, il appuie sur Open Sham Cash.
Sur un téléphone, cela ouvre l'application Sham Cash (version 2.2.5 ou plus récente), sinon le site web de Sham Cash ; il vérifie le
montant et confirme avec son code de confirmation de transfert (configuré dans son application Sham Cash). Sur un
ordinateur, la carte affiche également un code QR à scanner avec la caméra du téléphone. Chaque lien de paiement est valable
pendant 10 minutes ; la carte est confirmée automatiquement dès que Sham Cash valide l'opération.
L'application propre à Sham Cash peut également accepter des paiements pour vous : donnez-lui un jeton avec uniquement la permission Payment apps (voir la section REST API). Elle recherche un utilisateur par son nom d'utilisateur et enregistre le paiement effectué.
Sham Cash sans clés marchand (Non-official API)
Pas de service marchand chez Sham Cash ? SAMM peut encaisser les paiements Sham Cash via shamcash-api.com, un service indépendant (qui n'est pas Sham Cash) qui lit les virements arrivant sur votre propre compte Sham Cash. Il ne peut que lire : il ne peut pas envoyer d'argent.
Créez un compte sur shamcash-api.com et reliez votre compte Sham Cash : dans l'application Sham Cash, ouvrez Mon compte → Appareils liés et scannez leur QR code. Démarrez l'abonnement et créez une clé API en lecture seule.
Dans SAMM, ouvrez Finances → Paiements en ligne → Sham Cash, réglez Connexion sur Non-official API (shamcash-api.com), collez la clé API, choisissez la devise et Enregistrer. SAMM lit votre identifiant de compte et votre adresse Sham Cash à partir de la clé. Puis Lancer le test.
Ce que fait l'utilisateur : la carte de paiement affiche votre adresse Sham Cash (et son QR code), le montant et un code court comme SM-1234. L'utilisateur envoie le montant depuis son application Sham Cash et écrit le code dans la note du virement. SAMM confirme le paiement en une minute. Un virement sans le code, inférieur au montant ou dans une autre devise est gardé pour votre vérification au lieu d'être appliqué.
Page de paiement et renouvellement en ligne
Settings → Billing → Pay page active une page publique à l'adresse
/pay : un utilisateur saisit son nom d'utilisateur, consulte le montant dû et effectue le paiement, sans avoir à se connecter. Cette même
Pay page est disponible dans le portail utilisateur pour les utilisateurs connectés.
Renouveler : les utilisateurs peuvent renouveler leur forfait en ligne pour une durée de 1 à 12 périodes, avant ou après son expiration. Le paiement anticipé conserve le temps restant ; un utilisateur dont le forfait a expiré revient en ligne dès que le paiement est reçu. Deux commutateurs déterminent où cette option est proposée : Renouveler sur la page de paiement et Renouveler dans le portail utilisateur (les deux sont activés par défaut).
Rechercher des utilisateurs sans leur préfixe ou suffixe : pour des noms d'utilisateur comme 858000@inet, la saisie de 858000 (au moins 6 caractères) permet de trouver le compte. Si plusieurs comptes correspondent, le nom d'utilisateur complet est demandé à l'utilisateur. Désactivé par défaut.
Choisissez les informations du compte à afficher sur la page (nom masqué, forfait, date d'expiration, etc.) ; seul le nom masqué est affiché par défaut.
Ce que voit l'abonné
Connectez-vous au portail client → Mes factures.
Sur une facture impayée, cliquez sur Pay (ou « Pay · Stripe » / « Pay · Binance » si plusieurs sont activés).
Carte : ils sont redirigés vers la page sécurisée de la passerelle. Crypto : ils voient le montant exact, votre adresse avec un code QR et/ou votre Pay ID.
Une fois payée, la facture passe au statut Paid, elle est enregistrée dans votre comptabilité et, si les abonnements étaient expirés, ils sont rétablis automatiquement — les abonnés dont le forfait a expiré disposent même d'un bouton « Pay & reconnect » sur la page d'expiration.
Votre comptabilité reste exacte
Chaque paiement en ligne génère une écriture comptable équilibrée en partie double (Dr Cash / Cr Accounts Receivable) et enregistre le mode de paiement (Stripe / Binance) sur la facture, dans l'historique des paiements et sur le PDF — ainsi, vous savez toujours comment chaque paiement a été effectué.
Opérations quotidiennes
Tickets d'assistance
SAMM dispose d'un centre d'assistance intégré. Les abonnés ouvrent des tickets depuis le portail client ou le bot Telegram, un administrateur peut en ouvrir un au nom d'un abonné, et votre équipe les gère tous depuis Users → Support Tickets.
La file d'attente des tickets
La file d'attente liste chaque ticket — numéro, client, sujet, priorité, statut, dates d'ouverture et de dernière mise à jour, ainsi que le nombre de messages. Filtrez-la avec :
Pastilles de statut — une par statut de ticket, chacune affichant un décompte en temps réel, pour visualiser la charge de travail d'un coup d'œil.
Priorité — Normale, Modérée ou Critique.
Actif / Retiré — un client peut retirer un ticket dont il n'a plus besoin ; les tickets retirés sont grisés et masqués par défaut.
Recherche — par numéro de ticket, sujet ou client.
Le badge de la barre latérale indique le nombre de tickets ouverts pour ne rien manquer.
Ouverture d'un ticket
Nouveau ticket permet à un administrateur de créer un ticket pour un client choisi —
sélectionnez le client, puis définissez un objet, une priorité et une description. Les abonnés peuvent également ouvrir
leurs propres tickets depuis le portail client ou le bot Telegram.
Traitement d'un ticket
Ouvrez un ticket pour lire l'intégralité du fil de conversation. De là, vous pouvez :
Répondre au client — un message public que l'abonné voit sur son portail et via le bot Telegram.
Ajouter une note interne — un message réservé au personnel, masqué pour le client, pour les notes de transmission entre les membres de votre équipe.
Modifier le statut et la priorité du ticket.
Faites un clic droit sur n'importe quelle ligne — ou utilisez son bouton ⋮ — pour modifier le statut, la priorité, répondre ou ajouter une note interne sans quitter la file d'attente.
Opérations quotidiennes
Centre de notifications
SAMM informe automatiquement les abonnés — par email,
Telegram, SMS et WhatsApp — et vous permet de diffuser des messages. Le
service samm-notification achemine tout via une seule file d'attente régulée.
La page System → Notification Center comporte six onglets.
Vue d'ensemble
L'onglet d'accueil — compteurs en temps réel (en file d'attente, en cours d'envoi, envoyés aujourd'hui, échecs, ignorés, désinscrits), l'état de chaque canal de diffusion et un flux des notifications les plus récentes.
Canaux
Configurez la manière dont les messages sont envoyés depuis SAMM. Email utilise son propre compte de notification, distinct du SMTP de récupération de mot de passe configuré dans Paramètres. Telegram utilise un jeton de bot, SMS passe par une passerelle HTTP générique ou Twilio, et WhatsApp utilise l'API officielle Meta WhatsApp Cloud API (créée dans Meta for Developers), avec un pont non officiel optionnel lié par QR code à vos propres risques — ce pont s'installe en un clic sur un serveur bare-OS et est fourni sous forme de conteneur prêt à l'emploi sur Docker. Tous les secrets des canaux sont stockés avec un chiffrement Fernet. Chaque abonné, depuis le portail client, choisit les canaux souhaités et peut s'en désinscrire entièrement.
Les passerelles SMS peuvent également envoyer en mode template, pour les opérateurs qui n'acceptent que des templates approuvés : vous indiquez le nom du template et SAMM envoie les valeurs dans l'ordre attendu par celui-ci. Choisissez le format de numéro requis par chaque passerelle (international avec + ou 00, ou national avec ou sans le 0 initial). Collez un lien de passerelle fonctionnel fourni par votre prestataire et SAMM remplira pour vous les champs, le mode template et le format du numéro.
Messages
Les modèles de messages, un ensemble par événement. Modifiez la formulation de chaque notification — rappels de renouvellement, reçus et autres — afin que chaque message soit envoyé avec votre propre ton et dans votre langue.
Règles & Minuteurs
Cet onglet régit le moment et la manière dont les notifications automatiques se déclenchent. Pour chaque événement, vous contrôlez :
Indique si la règle est activée.
Ignorer le désabonnement — lorsqu'elle est activée, le message parvient à tous les abonnés même s'ils se sont désabonnés. Réservez cette option aux messages transactionnels importants.
Timing — par exemple, le nombre de jours avant l'expiration pour l'envoi d'un rappel de renouvellement.
Livraison & limitation — le worker vide la file d'attente d'un lot par tick ; la taille du lot et l'intervalle du tick cadencent ensemble la vitesse d'envoi des messages, afin qu'une diffusion massive ne sature jamais votre serveur de messagerie.
Les événements que SAMM peut émettre de lui-même incluent le rappel de renouvellement
(avant l'expiration d'un abonnement), l' avis d'expiration (lorsqu'il expire),
l' avertissement de quota (lorsqu'un plafond de données est presque atteint), le reçu de
paiement (lorsqu'un paiement est enregistré), et forfait renouvelé.
Diffusion
Envoyez un message ponctuel — une fenêtre de maintenance, un changement de prix — à un groupe d'abonnés sélectionnés. La diffusion passe par la même file d'attente limitée que les notifications automatiques.
Boîte d'envoi
Chaque message que SAMM a mis en file d'attente ou envoyé, avec son statut de livraison individuel, afin que vous puissiez confirmer qu'une notification a atteint l'abonné ou comprendre pourquoi elle n'a pas été livrée.
Système
VPN : WireGuard, L2TP/IPsec, SSTP
SAMM exécute son propre serveur VPN sur l'hôte SAMM afin que les routeurs, où qu'ils soient — derrière un NAT, sur une ligne mobile, dans une autre ville — puissent joindre SAMM pour RADIUS et la gestion. Tout se trouve sous System → VPN ; aucun shell n'est requis. Les nouvelles installations incluent les trois options prêtes, chacune désactivée jusqu'à ce que vous l'activiez.
Type
Utilisez-le pour
WireGuard
Routeurs RouterOS 7, téléphones et ordinateurs portables. Le plus rapide et le plus simple.
L2TP/IPsec
Les routeurs RouterOS 6 et 7, ainsi que les appareils ne disposant pas de WireGuard.
SSTP
Deux routeurs ou plus accédant à Internet via la même adresse publique, sur RouterOS 6 ou 7.
Onglet Serveur
Pour WireGuard, cliquez sur Generate Keys pour créer la paire de clés du serveur.
Vérifiez le port d'écoute, l'adresse du tunnel du serveur et la plage d'adresses clients, ou conservez les valeurs par défaut.
Allumez le serveur. Une fenêtre contextuelle confirme chaque modification.
Si l'hôte SAMM possède une adresse privée et que votre adresse publique lui est redirigée, SAMM trouve l'adresse publique (ou vous la saisissez une fois sur la page VPN) et la transmet à chaque client et routeur.
Ajouter un routeur en un seul collage
Cliquez sur Add Client et donnez-lui un nom. Pour un MikroTik, copiez le install link d'une seule ligne et collez-le dans le terminal du routeur : cela configure le tunnel, l'identifiant SAMM du routeur, sa configuration RADIUS et la page des utilisateurs expirés en une seule étape. Choisissez comment SAMM ajoute le routeur :
NAS géré — le routeur authentifie vos utilisateurs via SAMM et SAMM gère le NAS.
Surveillance uniquement — pour les points d'accès et autres appareils que vous souhaitez surveiller (état, carte, page Wireless) sans que des utilisateurs ne s'y connectent.
Un routeur ajouté par le personnel d'une agence appartient à cette agence. Des clients WireGuard peuvent également être ajoutés via un fichier de configuration ou un code QR pour l'application mobile. Les clients peuvent être renommés, désactivés ou supprimés ; leur couleur indique s'ils sont connectés, inactifs ou jamais vus.
La régénération des clés est destructive
Régénérer les clés modifie la paire de clés du serveur WireGuard. Chaque client déjà configuré cessera de se connecter jusqu'à ce qu'il reçoive la nouvelle configuration. Le panneau vous demande de saisir un mot pour confirmer.
Réseaux & routeurs
RouterOS 6 et 7
SAMM gère les routeurs sous RouterOS 6 et RouterOS 7 simultanément. Vous n'avez rien à modifier : SAMM détecte la version de chaque routeur et envoie les commandes compatibles avec celle-ci.
Tout fonctionne sur les deux : l'assistant de configuration, l'Auto-Complete, la livraison de configuration, les actions du gestionnaire, Websites & Apps, QoS, NTP, la page des utilisateurs expirés et les liens WireGuard (RouterOS 7), L2TP/IPsec et SSTP. Sur RouterOS 6, les listes Websites & Apps sont générées à partir des noms de domaine du catalogue, car la version 6 ne dispose pas de listes d'adresses DNS.
Anciens routeurs sans WireGuard
RouterOS 6 ne dispose pas de WireGuard. Connectez ces routeurs via L2TP/IPsec ou SSTP.
Réseaux & routeurs
Déploiement de la configuration
Chaque modification que SAMM envoie à vos routeurs — RADIUS, la page d'expiration, l'assistant, le filtre DNS,
Websites & Apps, QoS, Auto Security, DNS, NTP et le contrôle parental — constitue une livraison
que vous pouvez suivre via Devices → Config delivery.
Une barre de progression et le résultat pour chaque routeur, avec la raison exacte lorsqu'un routeur refuse une modification.
Un routeur hors ligne reçoit la modification dès qu'il revient en ligne ; les modifications ayant échoué sont retentées automatiquement, et Retry s'effectue en un clic.
Chaque modification est vérifiée sur le routeur après son application, et les champs RADIUS et QoS ne sont jamais laissés vides pendant l'opération.
Réseaux & routeurs
Actions du gestionnaire sur plusieurs routeurs
Dans Devices → Manager, cochez les routeurs et ouvrez
Actions pour exécuter une tâche sur tous les appareils sélectionnés : pousser Websites & Apps, pousser la
configuration RADIUS, configurer la page des utilisateurs expirés, Router Security, sauvegarde et export, mise à jour RouterOS, exécuter un
script ou redémarrer.
Chaque boîte de dialogue commence avec les paramètres les plus complets trouvés parmi les routeurs sélectionnés. Les tâches s'exécutent en arrière-plan : vous pouvez quitter la page, et une notification vous informe quand chaque routeur a terminé ou pourquoi l'opération a échoué. Les actions risquées vous demandent de saisir un mot pour confirmer. Le Gestionnaire affiche également l'agence de chaque routeur.
Réseaux & routeurs
Accélérateur de vitesse dynamique
Tant que la connexion Internet d'un routeur n'est pas utilisée, offrez plus de débit gratuitement à ses utilisateurs — et récupérez-le dès que la ligne devient saturée. Activez l'option sous Tools → Speed Boost → Dynamic (désactivée par défaut) et choisissez les forfaits concernés par l'accélération.
Tous les utilisateurs connectés à ce routeur bénéficient du même multiplicateur de leur vitesse de téléchargement, jusqu'à 3 fois par défaut.
Le booster apprend les heures de pointe et les heures creuses de chaque routeur (3 jours par défaut, les jours récents ayant le plus de poids), planifie toutes les 15 minutes, anticipe d'une heure et augmente le boost étape par étape.
Un garde vérifie chaque minute et met fin à un boost dès que le trafic revient. Les routeurs qui sont occupés la plupart du temps ne sont jamais boostés.
Les utilisateurs voient un badge Boosted dans leur portail ; la liste des utilisateurs dispose d'une colonne et d'un filtre Boosted.
Opérations quotidiennes
Activations & Journal des données
Activations
Overview → Activations affiche les forfaits les plus activés cette semaine, ce mois, cette année ou entre deux dates, par rapport à la période précédente : renouvellements, nouveaux utilisateurs et changements de forfait. Les listes By plan et By user disposent de fonctions de recherche, de filtres, de tri et d'exportation Excel ou CSV.
Journal des données
Overview → Data Log recherche simultanément dans le Data Log de chaque utilisateur : trouvez qui a accédé à une adresse ou une plage, un port, un protocole ou une application, sur n'importe quelle période. Groupez les résultats, enregistrez des vues et exportez vers CSV ou XLSX. La durée de conservation de l'historique est configurable dans le History cleaner.
Accepter le log
Le journal d'acceptation indique de quel routeur provient chaque tentative de connexion, avec des options de recherche, de regroupement, de tri et d'exportation par routeur.
Système
Branding : votre logo, votre nom et vos couleurs
Personnalisez SAMM aux couleurs de votre entreprise. Tout se trouve dans
System → Settings → ISP.
Votre logo
Appuyez sur la vignette du logo ou sur Envoi du logo et choisissez une image PNG, JPEG, WebP ou GIF (jusqu'à 5 MB).
Faites glisser l'image pour la positionner et utilisez le curseur pour zoomer. Un arrière-plan transparent reste transparent.
Cliquez sur Use logo : il est enregistré instantanément au format carré de 400×400 px. Remove le supprime.
Le logo est utilisé sur les factures, les reçus, les cartes hotspot imprimées, la page d'expiration et les pages de connexion affichées par vos routeurs.
Personnalisation des panneaux
Activez Use my brand on the panels et définissez le nom, la couleur et une ligne de pied de page (par exemple votre numéro d'assistance), puis cliquez sur Save dans l'onglet ISP. Votre marque remplace alors celle de SAMM sur le panneau administrateur, le portail utilisateur et les deux pages de connexion. Désactivez cette option pour revenir à l'apparence initiale.
Système
Cloudflare Tunnel
Un tunnel Cloudflare Zero Trust publie SAMM sur l'internet public
sans ouvrir aucun port du pare-feu — utile lorsque l'hôte SAMM se trouve
derrière un NAT. Il est géré depuis System → Cloudflare Tunnel.
État du service
La page s'ouvre sur une fiche d'état qui indique l'état du connecteur :
État
Signification
En cours
Le tunnel est actif et transfère le trafic
Arrêté
Configuré mais pas actif
Non configuré
Le binaire est présent — collez un jeton pour le configurer
Non installé
Exécutez à nouveau install.sh pour installer le binaire cloudflared
Il affiche également la version de cloudflared et si le connecteur est configuré pour démarrer automatiquement au démarrage.
Configurer le tunnel
Dans le tableau de bord Cloudflare Zero Trust
(one.dash.cloudflare.com), ouvrez Networks → Tunnels
et cliquez sur Create a tunnel.
Choisissez le connecteur Cloudflared, nommez le tunnel et enregistrez. À l'étape d'installation, copiez uniquement le jeton — la longue chaîne de caractères après --token.
Collez-le dans SAMM et cliquez sur Configure Tunnel. SAMM transmet le jeton à cloudflared et démarre le connecteur.
Dans Cloudflare, ajoutez un Public hostname : l'adresse choisie,
type HTTP, URL localhost:80 (via proxy nginx —
recommandé) ou localhost:8000 (directement vers l'API).
En quelques secondes, le badge de statut devient vert et SAMM est accessible via le nom d'hôte public. Une fois configuré, des actions en un clic vous permettent de Démarrer, Arrêter ou Redémarrer le connecteur, de Remplacer le jeton pour le renouveler, ou de Supprimer le tunnel (une action nécessitant de saisir REMOVE pour confirmer).
Aucun port ouvert, le jeton n'est jamais présent dans la base de données
Le tunnel établit une connexion sortante vers l'edge de Cloudflare — aucun port du pare-feu n'est jamais ouvert sur le serveur. Le jeton est transmis à cloudflared et stocké sous /etc/cloudflared/ ; SAMM ne le conserve jamais dans la base de données. Le TLS se termine à l'edge de Cloudflare, donc SAMM lui-même utilise le HTTP simple sur le loopback.
Système
Paramètres
System → Settings contient les paramètres modifiables à chaud. Les daemons les relisent lors de leur prochain cycle — aucun redémarrage du service n'est nécessaire. Les paramètres sont organisés en onglets.
Paramètres généraux
Paramètre
Par défaut
Commandes
samm-radius interval
30 s
Fréquence d'évaluation des événements temporels et d'envoi des CoA
samm-worker interval
5 s
Cadence du ping du routeur + synchronisation de l'API MikroTik
Intervalle intérimaire du compte
60 s
L'intervalle de comptabilisation envoyé aux routeurs
Heure de réinitialisation quotidienne
00:00
Lors de la réinitialisation des compteurs d'utilisation quotidienne
Fuseau horaire du serveur
UTC
Fuseau horaire pour les fenêtres de débit et la réinitialisation quotidienne
Port CoA par défaut
3799
Port UDP par défaut pour les paquets CoA
Nombre max de tentatives CoA
3
Nombre de tentatives avant le repli vers Disconnect-Request
Réduisez l'intervalle samm-radius pour un contrôle plus strict ; augmentez-le pour réduire la charge.
Identité de l'ISP, logo, facturation en & (l'onglet ISP)
Tout ce que la plupart des opérateurs cherchent à modifier (« où puis-je changer cela ? ») se trouve dans
System → Settings → ISP. Modifiez un champ et cliquez sur Enregistrer —
la modification est appliquée immédiatement (sans redémarrage) et se répercute sur les factures, les reçus, les PDF et le
portail client.
Modifications apportées
L'endroit où cela s'affiche
Nom de l'ISP
Factures, reçus, cartes hotspot, en-tête du portail
Assistance par téléphone & e-mail
Factures et cartes hotspot imprimées
Numéro de TVA / d'immatriculation
Imprimé sur les factures
Logo ISP (envoi PNG/JPEG/WebP/GIF)
Envoyez l'image, puis faites glisser et zoomez pour la recadrer dans le navigateur ; elle apparaît sur les PDF de factures/reçus, les cartes hotspot imprimées et les pages de connexion du routeur. Voir Branding.
Code devise (e.g. USD)
La devise ISO sur les factures et dans le grand livre
Symbole monétaire (e.g. $)
Chaque montant affiché dans l'interface admin, le portail client et les PDF
Taxes activées/désactivées, libellé & taux
Ajoute une ligne TVA/GST aux factures (p. ex. libellé VAT, taux 11 = 11 %)
Modifier le symbole monétaire
Pour modifier la devise affichée partout (par ex. de $ à £ ou un symbole local), définissez Currency symbol dans l'onglet ISP et cliquez sur Enregistrer — cela met à jour le panneau administrateur, le portail client et tous les PDF simultanément. Définissez également le Currency code (USD, EUR, …) pour le code ISO imprimé sur les factures.
Lorsque SAMM recherche des mises à jour, il peut envoyer à SecuryTik un ID d'installation aléatoire, la version de SAMM, votre niveau de forfait et un pays approximatif (déduit de votre IP via Cloudflare) — aucune donnée d'abonné ou de client. Cela nous aide uniquement à compter les installations actives et à prioriser l'assistance et les langues. Désactivez cette option à tout moment sous System → Settings → Privacy ; consultez la politique de confidentialité.
Onglet Email
Configurez le serveur SMTP utilisé pour les codes de récupération de mot de passe envoyés aux administrateurs et aux clients (hôte, port, SSL/STARTTLS, nom d'utilisateur, adresse d'expédition, mot de passe).
Cliquez sur Tester la connexion pour vérifier les identifiants sans envoyer d'e-mail.
Deux comptes e-mail
L'onglet Email ici sert uniquement à l'OTP / la récupération du mot de passe. Le compte utilisé pour les notifications client est configuré séparément dans le Centre de notifications.
Système
Administrateurs, agences & rôles
System → Admins est l'endroit où vous déterminez qui peut se connecter au portail administrateur, ce que chaque personne peut faire et quels utilisateurs elle peut voir. Depuis la version 5.1.0, les administrateurs forment un arbre d'agences et de personnel. La page comporte deux onglets : Admins et Roles.
Agences et personnel
Nœud
Présentation
Agence
Un lieu — une agence, une ville. Il regroupe les utilisateurs créés en son sein. Personne ne se connecte en tant qu'agence : elle n'a ni mot de passe ni rôle.
Administrateur (personnel)
Une personne qui se connecte. Placée sous une agence, elle fait partie de son personnel : chaque utilisateur et chaque carte qu'elle crée appartiennent à cette agence.
Superadmin
Toujours au sommet de l'arborescence, jamais sous une agence. Voit et peut tout faire.
Utilisez + Branch et + Admin pour construire l'arborescence, et glissez un nœud sur un autre pour le déplacer. Seule une agence peut avoir des administrateurs sous sa dépendance. Un agent est un administrateur qui vend et possède ce qu'il vend ; le personnel placé sous un agent utilise le portefeuille et les règles d'approbation de l'agent.
Qui voit quoi
La visibilité suit l'arbre. Une agence — et tous ceux qui y travaillent — voit ses propres utilisateurs et ceux des agences en dessous, jamais une agence sœur ni l'agence au-dessus. Le siège voit tout. Les droits d'un administrateur ne dépassent jamais ce que permettent ceux au-dessus de lui, et il ne peut accorder que ce qu'il possède.
Limites par agence
Limite
Éléments comptabilisés
Nombre maximal d'utilisateurs
Nombre d'utilisateurs que l'agence et les agences qui en dépendent peuvent accueillir. La suppression d'un utilisateur libère une place.
Nombre max de cartes
Combien de cartes hotspot peuvent être imprimées dans l'agence.
Un nouvel utilisateur ou une nouvelle carte est refusé lorsqu'une limite applicable à l'administrateur qui le crée (ou à un niveau supérieur) est atteinte, et le message indique quelle limite est concernée et le solde restant. Laissez un champ de limite vide pour qu'il n'y ait aucune limite. Les deux peuvent être modifiés ultérieurement depuis la boîte de dialogue Modifier.
Appareils d'une agence
Chaque routeur, points d'accès inclus, appartient à une agence ou au Siège.
Ouvrez le menu d'une agence et choisissez Appareils assignés pour cocher les appareils qui lui appartiennent ;
un appareil décoché retourne au Siège, que toutes les agences partagent. Un appareil ajouté par le personnel d'une agence
(depuis le gestionnaire, le formulaire de surveillance ou un lien d'installation VPN) arrive dans son agence ; un appareil ajouté par
le Siège commence au Siège.
Qui
Un appareil de l'agence
Le personnel de cette agence, des agences supérieures et du siège social
Le gérer
Personnel de ses agences rattachées
Voir, lecture seule
Autres agences
Ne le voyez pas
Les utilisateurs de cette agence et de ses agences enfants
Permet de s'y connecter
La carte, la page Wireless, ainsi que les listes d'état et de routeurs suivent la même règle. La partie connexion correspond au paramètre Users log in only through their branch's routers dans Settings → Authentication : activé pour les nouvelles installations ; pour une installation mise à jour dont les appareils ont été attribués aux agences, il est désactivé par défaut pour éviter toute coupure — activez-le une fois vos appareils assignés. Les utilisateurs de la société General peuvent utiliser n'importe quel routeur.
Destinataires des alertes par agence
Le menu d'une agence contient également Destinataires des alertes : adresses e-mail, numéros WhatsApp et SMS ainsi que des chats Telegram, un par ligne. Lorsqu'un appareil de cette agence (ou d'une agence subordonnée) tombe en panne, présente un défaut, bloque une attaque ou perd sa configuration, ils en sont informés. Le siège reçoit toujours toutes les alertes.
Listes de prix
Financial → Price Lists (superadmin uniquement) définit un prix pour chaque forfait et module complémentaire, par agence. Une sous-agence applique les prix de son agence parente à moins d'avoir les siens, et une nouvelle agence commence avec le prix catalogue du forfait. Modifiez plusieurs prix simultanément par un pourcentage ou un montant fixe, avec arrondi ; Reset All rétablit les prix d'une agence selon ceux de son parent, et la liste peut être exportée pour révision.
Rôles & permissions
Un rôle accorde un accès par zone. SAMM inclut quatre rôles prédéfinis que vous pouvez modifier ou supprimer — Gestionnaire (opérations quotidiennes), Reseller, Accountant (finances) et Monitor (lecture seule) — ainsi que deux rôles intégrés verrouillés : superadmin (accès complet) et Agent, qui transforme l'administrateur en revendeur en gros avec un solde prépayé et un partage de commission (voir Accounting & billing → Agents).
Pour chaque domaine de SAMM (utilisateurs, forfaits, routeurs, comptabilité, paramètres, et ainsi de suite), un rôle est défini selon l'un des trois niveaux suivants :
Niveau
Signification
Non autorisé
La zone est entièrement masquée dans la barre latérale
Afficher
Accès en lecture seule
Modifier
Accès complet — créer, modifier, supprimer
Administrateurs & rôles, Tools, API et
Payments restent sous le contrôle du HQ, quel que soit le rôle.
Deux droits figurent à côté des niveaux de zone, car chacun d'eux relève d'une décision financière plutôt que d'un affichage :
Droite
Fonctionnalités
Autoriser "No Invoice"
Modifier le service d'un utilisateur — renouveler, changer de forfait, prolonger — sans facturation. Désactivé par défaut pour chaque nouveau rôle.
Autoriser l'approbation des agents
Examinez et traitez les demandes des agents pour annuler un paiement. La création et la gestion des agents restent réservées au superadmin. Voir Annulations & approbations.
Permissions détaillées
Sous Edit, Users, Cards, Financial et Routers s'ouvrent sur des droits individuels —
par exemple supprimer des utilisateurs, renouveler, changer de forfait, payer des factures, accorder des remises, exécuter des scripts de routeur. Désactivez l'un d'entre eux pour un rôle ; les boutons correspondant aux droits dont le rôle ne dispose pas sont masqués.
Durée d'attribution du rôle
Empêchez le personnel d'attribuer plusieurs mois de service. Pour chaque rôle :
Paramètre
Effet
Périodes d'avance max.
La date d'expiration peut être fixée au maximum à ce nombre de périodes de forfait à partir de maintenant — lors de la création, du renouvellement, de l'ajout de jours, de la modification et des modifications groupées.
Jours d'avance max.
Idem, compté en jours.
Durée initiale pour les nouveaux utilisateurs (heures)
Un utilisateur créé avec ce rôle dispose exactement de ce temps (par exemple 2 heures) sans facture ; une personne autorisée à accorder plus de temps pourra prolonger ce délai ultérieurement.
Ajouter des jours et Saisir une date d'expiration sont des droits distincts sous Utilisateurs,
ainsi, un rôle peut effectuer un renouvellement sans pouvoir saisir la date de son choix. Laissez un champ vide pour ne définir aucune limite ; le
superadmin n'est jamais limité. Un changement groupé ignore les utilisateurs pour lesquels la limite serait dépassée et en indique
la raison.
Un rôle peut également être autorisé à voir chaque utilisateur & carte de l'installation, quelle que soit l'arborescence. Lorsqu'elle est désactivée, le rôle voit sa propre agence et les agences situées en dessous.
Le tableau de bord n'est jamais retiré
Quels que soient les accès refusés pour un rôle, chaque administrateur conserve son propre tableau de bord et son profil —
une connexion qui aboutit à une erreur de permission est une connexion défectueuse, et non une connexion sécurisée.
La licence est toujours accessible
La page System → License est un bloc de permissions classique — mais dès que l'appareil est dans un état de verrouillage (grace, soft ou hard), SAMM le rend accessible à tout administrateur connecté quel que soit son rôle, afin que le chemin de récupération ne soit jamais bloqué.
Système
Outils
La section Tools regroupe les utilitaires de maintenance et de traitement par lot. Elle agit sur l'ensemble du jeu de données et n'est donc accessible qu'aux superadmins.
Sauvegarde & Restauration
Créez un instantané complet de la base de données avant tout changement majeur. Une sauvegarde est une archive pg_dump compressée en gzip stockée sur le serveur, chacune comportant un en-tête SAMM.
Créer une sauvegarde — ajoutez éventuellement une note ; cochez Ignorer l'utilisation & l'historique pour un dump plus léger et plus rapide qui omet les tables de logs volumineuses.
Téléchargez une sauvegarde sur votre PC, ou envoyez une sauvegarde SAMM précédente vers le serveur.
Restaurer écrase la base de données actuelle — une boîte de dialogue de confirmation de type RESTORE est alors affichée.
Haute disponibilité
Pour un déploiement sans point de défaillance unique, exécutez SAMM sur deux nœuds :
la réplication en streaming PostgreSQL (un primaire avec un nœud de secours à chaud avec un léger retard) ainsi qu'un nœud AAA de secours, puis effectuez la promotion et le repointage en cas de panne. Le guide d'exploitation complet — configuration de la réplication, basculement planifié et non planifié, retour à la normale, un mode de réplication synchrone optionnel et une liste de vérification post-basculement — est fourni sous forme de docs/HA.md avec la source. Notez que la réplication n'est pas une sauvegarde (une suppression erronée est répliquée instantanément), maintenez donc également les sauvegardes planifiées mentionnées ci-dessus.
Nettoyage de l'historique
Supprimez définitivement les anciennes lignes de journaux et d'historique pour récupérer de l'espace dans la base de données. Choisissez un préréglage de rétention et confirmez. L'outil de nettoyage supprime les sessions RADIUS fermées, les enregistrements post-auth, les récapitulatifs d'utilisation quotidienne, l'historique des routeurs/interfaces, les journaux de limitation, les entrées d'audit appliquées et les lignes CoA terminées. Il ne touche jamais aux sessions actives, aux commandes en file d'attente, aux CoA en attente ou aux totaux d'utilisation à vie non réinitialisables.
Effectuez d'abord une sauvegarde
History Cleaner supprime définitivement les données. Effectuez une sauvegarde avant le nettoyage si vous souhaitez conserver ces données.
Exporter / Importer
Exportation et importation en masse pour utilisateurs, forfaits et NAS au format .csv ou .xlsx. Téléchargez un modèle (les colonnes requises et une ligne d'exemple) ou un instantané des données actuelles, remplissez-le et importez-le. Chaque ligne est validée et affichée sur un écran de prévisualisation — les doublons et les lignes invalides sont signalés, et vous choisissez d'ignorer les doublons ou de les mettre à jour — avant toute écriture.
Modifications groupées
Appliquez une modification — propriétaire, date d'expiration, statut, renouvellement automatique ou l'ensemble des périodes du forfait — à tous les abonnés correspondant à un filtre, en une seule opération. Choisissez la modification, créez le filtre (statut / forfait / propriétaire / recherche), examinez la liste correspondante et confirmez.
Ajouter des périodes de forfait complètes est l'option de renouvellement en masse : chaque abonné bénéficie d'autant de périodes de son propre forfait ; ainsi, un forfait de 7 jours gagne 7 jours par période et un forfait mensuel gagne un mois civil — en une seule opération, sans avoir à trier la liste par forfait au préalable. Les abonnés dont le forfait n'a pas de période d'expiration sont ignorés plutôt que traités par estimation. Ajouter des jours reste disponible lorsque vous souhaitez un nombre fixe de jours sans réinitialisation du compteur.
Speed Boost
Augmentez ou réduisez la vitesse de tous les forfaits à la fois selon un pourcentage —
une vitesse doublée pour un week-end prolongé, ou une limitation d'urgence lors d'une dégradation du backhaul.
L'effet est immédiat, pour les nouvelles connexions ainsi que pour les sessions déjà actives.
Contrôle
Fonctionnement
Pourcentage
Les valeurs positives multiplient, les valeurs négatives divisent : +100 % → vitesse doublée, −100 % → vitesse divisée par deux, −500 % → un sixième de la vitesse. La vitesse n'atteint jamais zéro.
Forfaits à booster
Cochez le nombre de forfaits souhaité ; chaque ligne affiche le tarif du forfait, le boost en vigueur et la vitesse effective actuelle.
Rétablir automatiquement après
Nombre d'heures avant que le boost n'expire automatiquement. La valeur 0 le maintient jusqu'à ce que vous le réinitialisiez manuellement.
Un boost prime sur une fenêtre de vitesse
L'accélération est mesurée à partir du débit du forfait et remplace toute fenêtre de vitesse pendant qu'elle est active — un forfait avec une fenêtre nocturne de 20M ne devient pas 40M, mais prend la valeur définie par l'accélération appliquée à son débit de forfait. Windows reprend dès que l'accélération expire.
Un abonné ayant épuisé une limite ne retrouve jamais sa pleine vitesse via un boost. Pour la même raison, un forfait utilisé comme cible de limitation est ignoré par Tout sélectionner et marqué comme tel — le booster accélérerait précisément les utilisateurs que vous limitez. Vous pouvez toujours le cocher manuellement si tel est votre objectif. Tout réinitialiser supprime tous les boosts et rétablit la vitesse du forfait pour les sessions actives.
Suppression groupée
Supprimer définitivement plusieurs abonnés ou cartes hotspot à la fois, sélectionnés via un filtre.
La suppression d'un abonné supprime également son historique d'utilisation, ses sessions, sa comptabilité RADIUS et ses factures, et déconnecte toute session active. L'action est protégée par une boîte de dialogue de confirmation de type DELETE.
Système
Langues & thèmes
Langues
Les portails administrateur et client sont entièrement traduisibles. Huit langues sont intégrées :
English, Arabic (de droite à gauche), Russian, Persian (de droite à gauche),
Turkish, French, Spanish et German. Chaque utilisateur choisit sa
langue dans la barre supérieure ou dans son profil ; le choix est mémorisé par compte.
Désactiver une langue
Dans System → Translations, chaque langue dispose d'un commutateur on/off (superadmin uniquement). Une langue désactivée ne peut être choisie par personne : elle n'est plus proposée dans les sélecteurs, les utilisateurs qui l'avaient choisie voient l'anglais, et les messages qui leur sont adressés sont écrits en anglais. L'anglais reste toujours activé. Une nouvelle installation commence avec toutes les langues activées.
L'éditeur de traduction
Un superadmin peut modifier les traductions en direct depuis
System → Translations — sans redémarrage ni modification de fichier.
L'éditeur permet également de créer de nouvelles langues et d'importer/exporter des classeurs de traduction
au format .xlsx, afin que vous puissiez localiser SAMM dans toutes les langues que vous proposez.
Thèmes
SAMM inclut 16 thèmes visuels, clairs et sombres. Chaque utilisateur choisit un thème dans la barre supérieure ; l'aperçu est mis à jour instantanément et le choix est enregistré par compte. La terminologie IT n'est jamais traduite, afin que les écrans techniques restent précis dans toutes les langues.
Système
Journal d'audit & activité
System → Audit Log répond à une seule question : que s'est-il passé et qui en est l'auteur. Une liste unique répertorie chaque modification effectuée par un administrateur, les actions automatiques du système (telles que les expirations), ainsi que les modifications apportées par les utilisateurs à leur propre compte via le portail ou sur Telegram — changements de forfait, renouvellements, paiements, modifications du profil et du mot de passe.
Colonne
Ce qu'il affiche
Lorsque
L'heure, selon votre fuseau horaire
Qui
L'administrateur, « ali, dans le portail », « ali, sur Telegram », un jeton API ou System
Que s'est-il passé
Une seule phrase, avec uniquement les champs modifiés, ancien → nouveau — par exemple « Utilisateur modifié : Expiration : 01 oct → 15 oct »
Filtrez par Qui et Période, ou saisissez un nom dans le champ de recherche.
Les connexions et les exports sont masqués sauf si vous cochez Afficher connexions & exports. Via,
Action, Catégorie, Sévérité et ID se trouvent dans le sélecteur de colonnes. Sélectionnez des lignes pour Exporter
ou Imprimer — le fichier contient les mêmes colonnes que l'affichage. Le bouton ⓘ d'une ligne
affiche le tableau complet avant et après.
Chronologie de l'utilisateur
Ouvrez un utilisateur et choisissez Timeline pour consulter l'historique complet de ce compte — création, renouvellement, changement de forfait, suspension, limites atteintes — avec les factures, les paiements, le portefeuille et les frais d'agent dans une colonne Montant. Filtrez par type, par période, ou uniquement par montant, et exportez vers CSV ou Excel. Les lignes de la Timeline ne sont jamais purgées et subsistent même après la suppression de l'utilisateur.
Journal d'acceptation et journal d'accès
Overview → Accept Log liste toutes les tentatives de connexion envoyées par les routeurs et la réponse de RADIUS, les plus récentes en premier, avec le motif de chaque refus. C'est la page à ouvrir lorsqu'un utilisateur ne peut pas se connecter. Un refus répétitif est affiché sur une seule ligne avec un compteur.
Overview → Access Log liste les sessions qui ont débuté, via l'accounting RADIUS.
Également une file d'attente de commandes
Les réinitialisations, les changements de forfait et les renouvellements mis en file d'attente via la CLI ou l'API sont inscrits dans la même table et appliqués par le service samm-radius lors de son prochain cycle, lequel actualise ensuite une session active via un CoA. Le badge de la barre latérale indique le nombre d'opérations encore en attente.
Licences
Licences & forfaits
Chaque installation de SAMM est sous licence par appareil — le forfait est lié à cette installation, vous pouvez donc exécuter plusieurs serveurs SAMM, chacun avec son propre niveau. Le niveau définit quatre limites numériques.
Niveau
Utilisateurs AAA
Cartes Hotspot
NAS / routeurs
Surveillance
Non enregistré
25
25
1
3
Gratuit
100
50
2
6
Lite
500
1,500
4
12
Plus
1,000
3,000
6
18
Pro
2,000
6,000
12
36
Mega
5,000
15,000
24
72
Max
10,000
30,000
illimité
illimité
Unlimited
illimité
illimité
illimité
illimité
Une nouvelle installation s'exécute en mode non enregistré au palier minimum. Chaque fonctionnalité est disponible à tous les paliers — le palier définit uniquement les limites. La création d'un abonné, d'une carte ou d'un NAS au-delà de la limite est bloquée jusqu'à ce que vous montiez en gamme ; aucune donnée n'est jamais perdue.
Monitors sont les points d'accès et les liens que SAMM surveille uniquement. Ils disposent de leur propre quota, trois par NAS, sehingga la surveillance d'un point d'accès n'utilise jamais d'emplacement de routeur.
Activer & mettre à niveau
Allez dans System → License.
Activez l'appareil en vous connectant avec votre compte SecuryTik — ou utilisez
Lier cet appareil, qui affiche un code à approuver sur
samm.securytik.com sans avoir à saisir
votre mot de passe sur le serveur. L'appareil s'active en mode Free.
Pour passer à un forfait supérieur, choisissez-en un sur la même page ou abonnez-vous depuis votre tableau de bord. Une demande effectuée depuis la page est examinée et approuvée par un administrateur SecuryTik.
La page Licence permet également de revérifier la licence à la demande et affiche votre utilisation actuelle par rapport à chaque limite. Délier l'appareil repasse l'installation au niveau non enregistré sans supprimer aucune donnée.
Si une licence payante expire
SAMM ne supprime jamais de données. Une licence expirée se désactive progressivement :
Étape
Que se passe-t-il
Avertissement
Une bannière de rappel ; tout continue de fonctionner
Délai de grâce
Une courte fenêtre de réactivation ; les abonnés restent en ligne
Verrouillage partiel
Les services d'arrière-plan s'arrêtent ; RADIUS continue d'authentifier pendant environ 7 jours
Verrouillage strict
Les services s'arrêtent, à l'exception de la page de réactivation
La réactivation à n'importe quelle étape redémarre automatiquement chaque service — toutes les données et l'historique des abonnés restent intacts.
Mises à jour automatiques
La mise à jour automatique est indépendante de la licence — tous les niveaux sont mis à jour, et une licence expirée ne la bloque jamais. SAMM vérifie quotidiennement la disponibilité d'une nouvelle version signée. Depuis System → License, vous pouvez basculer entre notify (par défaut — une bannière avec un bouton Appliquer maintenant) et auto (application automatique). Chaque mise à jour est vérifiée, sauvegardée et appliquée sur place. Vous pouvez également relancer l'installateur à tout moment — il effectue la mise à niveau de manière idempotente.
Pour vos abonnés
Portail client & bot
SAMM offre à chaque abonné deux interfaces en libre-service — un portail web et un bot Telegram — afin qu'il puisse vérifier sa consommation et payer sans vous contacter.
Le portail client
Les abonnés se connectent à la racine du site SAMM (/) avec leur nom d'utilisateur et mot de passe SAMM. Le portail comprend :
Page
Ce que voit l'abonné
Vue d'ensemble
Statut du compte, forfait, date d'expiration, consommation du jour et du mois, et toute facture impayée
Utilisation & sessions
Total téléchargé/téléversé, budget de temps de fonctionnement et historique complet des sessions
Mes forfaits
Le forfait actuel ainsi que le catalogue des forfaits disponibles
Mes factures
Historique de facturation avec téléchargement PDF en un clic
Tickets d'assistance
Ouvrir et suivre les tickets d'assistance
Profil
Modifier les coordonnées, changer le mot de passe, définir la langue & le thème, gérer les notifications
Depuis Profile, un abonné connecte son compte Telegram, choisit ses canaux de notification préférés ou désactive complètement les notifications. S'il oublie son mot de passe, un code OTP lui est envoyé par e-mail (cela nécessite que l' onglet Email soit configuré).
Le bot Telegram
Le service samm-telegram exécute un bot interactif en libre-service. Un abonné envoie /start, s'authentifie une fois avec son nom d'utilisateur et son mot de passe SAMM (le bot supprime immédiatement le message contenant le mot de passe), puis peut, entièrement depuis le chat :
Vérifiez leur forfait, leur quota, leur consommation et leur date d'expiration
Consulter et télécharger les factures au format PDF
Mettre à jour leur profil et modifier leur mot de passe
Ouvrir et suivre les tickets d'assistance
Le bot envoie également des notifications automatiques — rappels de renouvellement, avis d'expiration, alertes de quota et reçus — aux abonnés ayant connecté Telegram.
La page de redirection pour abonnés expirés
Lorsqu'un abonnement expire, le routeur (configuré via l'option « Expired pool & internet block » de l'assistant) redirige le navigateur de l'utilisateur vers une page abonnement
expiré conviviale servie par SAMM sur le port 81 — avec le logo de votre ISP et un bouton de connexion au portail — au lieu d'une connexion simplement interrompue.
Système
REST API
System → API gère l'interface publique /api/v1. L'API reste inactive jusqu'à ce que vous créiez le premier jeton ; ainsi, une installation qui ne l'utilise jamais n'expose rien. Tout ce qui suit est également disponible sous forme de documentation OpenAPI interactive — avec une console d'essai et les schémas complets de requête/réponse — sur votre propre installation via le chemin /api/v1/docs.
Documentation interactive (Swagger UI)
Chaque installation propose une console API interactive à l'adresse /api/v1/docs —
accessible directement depuis le panneau API du portail administrateur. Cliquez sur
Authorize, collez un jeton, et vous pourrez exécuter n'importe quel point de terminaison
sur vos propres données via Try it out ; chaque appel affiche la réponse réelle ainsi qu'une
commande curl prête à être copiée.
Chaque point de terminaison déclare un schéma typé complet — tant pour les corps de requête que pour les réponses — afin que les noms de champs, les types et les exemples soient visibles sans effectuer d'appel. Ce même schéma est fourni sous forme d'OpenAPI lisible par machine à l'adresse /api/v1/openapi.json, ce qui permet de générer un client entièrement typé dans le langage de votre choix :
Ouvrez System → API (superadmin uniquement), cliquez sur
New token, donnez-lui un nom, une date d'expiration et activez uniquement les permissions dont
l'intégration a besoin (Read ou Write, une ligne par zone).
Copiez le secret immédiatement — il n'est affiché qu'une seule fois et seul son hash est stocké sur le serveur.
Vérifiez que cela fonctionne et découvrez les capacités du jeton :
Chaque requête doit inclure Authorization: Bearer <token>. Un jeton contient un nom, une limite de débit par minute, une date d'expiration (30–360 jours ou jamais) et un ensemble de scopes — des autorisations de lecture/écriture par ressource ; un scope write inclut automatiquement le scope read correspondant. Le secret n'est affiché qu'une seule fois ; le serveur n'en stocke que le hash. Un jeton peut être révoqué (les appels échouent immédiatement, action réversible) ou supprimé définitivement.
Les réponses suivent un ensemble de conventions : les points de terminaison de liste acceptent limit/offset et renvoient {"total", "items"} ; les erreurs utilisent des codes d'état standard — 401 jeton manquant/invalide/expiré, 403 portée manquante, 404 non trouvé, 409 doublon, 422 erreur de validation, et 429 lorsque la limite de débit est atteinte (avec les en-têtes Retry-After et X-RateLimit-*).
Les montants dans les données de paiement, de portefeuille et de webhook sont des chaînes décimales telles que "12.50" ; les heures sont au format ISO 8601 avec le décalage de l'installation.
Référence du point de terminaison
Zone
Points de terminaison
Champ d'application
Token & commands
GET /commands · GET /me
any token
Users
GET /customers · POST /customers · POST /customers/bulk · GET /customers/{customer_id} · PATCH /customers/{customer_id} · DELETE /customers/{customer_id} · POST /customers/{customer_id}/activate · POST /customers/{customer_id}/assign-plan · PUT /customers/{customer_id}/custom-fields · GET /customers/{customer_id}/data-log · POST /customers/{customer_id}/disconnect · POST /customers/{customer_id}/renew · POST /customers/{customer_id}/reset-limit · POST /customers/{customer_id}/suspend · GET /customers/{customer_id}/timeline · GET /customers/{customer_id}/usage · GET /customers/{customer_id}/timeline/export.{fmt}
GET /plans · POST /plans · GET /plans/{plan_id} · PATCH /plans/{plan_id}
plans:readplans:write
Invoices
GET /invoices · POST /invoices · GET /invoices/{invoice_id} · DELETE /invoices/{invoice_id} · POST /invoices/{invoice_id}/pay · GET /invoices/{invoice_id}/pdf · POST /invoices/{invoice_id}/unpay
billing:readbilling:write
Payments, discounts & wallet
GET /cash-accounts · GET /customers/{customer_id}/wallet · GET /invoices/{invoice_id}/balance · POST /invoices/{invoice_id}/discounts · POST /invoices/{invoice_id}/payments · POST /customers/{customer_id}/wallet/pay-invoice · POST /customers/{customer_id}/wallet/topup · POST /customers/{customer_id}/wallet/withdraw · DELETE /invoices/{invoice_id}/discounts/{discount_id}
billing:readbilling:write
Payment apps (collect)
GET /collect/lookup · POST /collect/payments · GET /collect/payments/{channel}/{reference}
collect:readcollect:write
Accounting export
GET /accounting/export · GET /accounting/export/{kind}
accounting:read
Add-ons & price lists
GET /addons · GET /price-lists · DELETE /user-addons/{user_addon_id} · GET /customers/{customer_id}/addons · POST /customers/{customer_id}/addons
addons:readaddons:write
Hotspot cards
GET /cards/groups · POST /cards/groups · GET /cards/{card_id} · GET /cards/groups/{group_id} · POST /cards/{card_id}/disable · POST /cards/{card_id}/enable · GET /cards/groups/{group_id}/cards · POST /cards/groups/{group_id}/cards · POST /cards/groups/{group_id}/disable · POST /cards/groups/{group_id}/enable · POST /cards/groups/{group_id}/extend · GET /cards/groups/{group_id}/print.pdf · POST /cards/{card_id}/reset/{kind}
cards:readcards:write
Sessions & CoA
GET /coa-outbox · GET /sessions · POST /coa-outbox/cancel · POST /coa-outbox/retry · POST /sessions/disconnect · POST /sessions/reconnect
coa:writesessions:read
Webhooks
GET /webhooks · POST /webhooks · GET /webhooks/events · PATCH /webhooks/{endpoint_id} · DELETE /webhooks/{endpoint_id} · GET /webhooks/{endpoint_id}/deliveries · POST /webhooks/{endpoint_id}/disable · POST /webhooks/{endpoint_id}/enable · POST /webhooks/{endpoint_id}/roll-secret · POST /webhooks/{endpoint_id}/test · POST /webhooks/deliveries/{delivery_id}/resend
webhooks:manage
User files
GET /customers/{customer_id}/files · POST /customers/{customer_id}/files · GET /customers/{customer_id}/files/{file_id} · DELETE /customers/{customer_id}/files/{file_id}
customers:readcustomers:write
Branches
GET /branches · PUT /customers/{customer_id}/branch
admins:writecustomers:read
Admins
GET /admins
customers:read
Self Service (guests)
GET /self-service/handouts · GET /self-service/summary
guests:read
Statistics
GET /stats/overview
stats:read
Routers & router control
GET /routers · POST /routers/jobs · GET /routers/playbooks · GET /routers/{router_id} · GET /routers/jobs/kinds · GET /routers/jobs/prefill · GET /routers/jobs/{job_id} · GET /routers/{router_id}/log · POST /routers/{router_id}/probe · GET /routers/{router_id}/probes · GET /routers/{router_id}/radius · GET /routers/{router_id}/ros · POST /routers/{router_id}/ros · POST /routers/{router_id}/scoop-change · GET /routers/{router_id}/scoop-changes · POST /routers/{router_id}/script · GET /routers/{router_id}/test · GET /routers/{router_id}/traffic · POST /routers/jobs/{job_id}/cancel · GET /routers/wireless/by-user/{customer_id} · GET /routers/{router_id}/ppp/{username} · GET /routers/{router_id}/scoop-change/preview · POST /routers/{router_id}/scoop-change/{change_id}/undo
GET /network/findings · GET /network/health · GET /network/topology · PUT /customers/{customer_id}/features · GET /network/ftth/olts · GET /network/ftth/onus · GET /network/wireless/aps · GET /network/wireless/stations · GET /routers/{router_id}/reach · POST /routers/{router_id}/reach · DELETE /routers/{router_id}/reach/{reach_id}
customers:writerouters:read
Bulk import
POST /imports/users
imports:write
Backups
GET /backups · POST /backups · GET /backups/schedule · PUT /backups/schedule · DELETE /backups/{name} · GET /backups/{name}/download · POST /backups/{name}/restore
backups:readbackups:write
History cleaner
POST /history/clean · GET /history/schedule · PUT /history/schedule · GET /history/space
history:readhistory:write
VPN clients
GET /vpn/l2tp/clients · POST /vpn/l2tp/clients · GET /vpn/sstp/clients · POST /vpn/sstp/clients · GET /vpn/wireguard/clients · POST /vpn/wireguard/clients · PUT /vpn/l2tp/clients/{cid} · DELETE /vpn/l2tp/clients/{cid} · PUT /vpn/sstp/clients/{cid} · DELETE /vpn/sstp/clients/{cid} · PUT /vpn/wireguard/clients/{peer_id} · DELETE /vpn/wireguard/clients/{peer_id} · GET /vpn/l2tp/clients/{cid}/config · GET /vpn/l2tp/clients/{cid}/mikrotik · POST /vpn/l2tp/clients/{cid}/toggle · GET /vpn/sstp/clients/{cid}/config · GET /vpn/sstp/clients/{cid}/mikrotik · POST /vpn/sstp/clients/{cid}/toggle · GET /vpn/wireguard/clients/{peer_id}/config · GET /vpn/wireguard/clients/{peer_id}/mikrotik · POST /vpn/wireguard/clients/{peer_id}/toggle
vpn:readvpn:write
Diagnostics
GET /diagnostics
diagnostics:read
Support & logs
GET /audit · GET /auth-log · GET /audit/actors · GET /support/alerts · GET /support/backups · GET /support/database · GET /support/errors · GET /support/license · GET /support/logs · GET /support/notifications · GET /support/payments · GET /support/probe · GET /support/queues · GET /support/self-test · POST /support/service-restart · GET /support/services · GET /support/settings · PUT /support/settings · GET /support/system · GET /support/update · GET /customers/{customer_id}/why-blocked · GET /support/errors/{incident} · GET /support/payments/incoming
GET /reports/activations · GET /reports/financial · POST /retention/lookup · GET /customers/{customer_id}/statement
accounting:readcustomers:readretention:lookup
Scoop
GET /scoop/schedules · POST /scoop/schedules · DELETE /scoop/schedules/{schedule_id}
Factures, paiements, remises & portefeuille
Chaque transaction financière passe par la comptabilité en partie double de SAMM, exactement comme dans le panneau.
Le montant dû d'une facture est total − paid − discount ; son statut passe de unpaid/due
à partial puis paid (ou discounted lorsque seules des remises l'ont soldée).
# what an invoice still owes
curl -H "Authorization: Bearer $T" https://YOUR-SAMM/api/v1/invoices/501/balance
# a 10 percent discount (or "kind":"fixed","value":"2.00")
curl -X POST -H "Authorization: Bearer $T" -H "Content-Type: application/json" \
-d '{"kind":"percent","value":"10","reason":"Loyalty"}' \
https://YOUR-SAMM/api/v1/invoices/501/discounts
# a partial payment into a cash account (GET /cash-accounts)
curl -X POST -H "Authorization: Bearer $T" -H "Content-Type: application/json" \
-d '{"amount":"5.00","cash_account_id":1,"memo":"Counter"}' \
https://YOUR-SAMM/api/v1/invoices/501/payments
# prepaid wallet: top up (pays open invoices oldest first), then read it
curl -X POST -H "Authorization: Bearer $T" -H "Content-Type: application/json" \
-d '{"amount":"25.00","cash_account_id":1}' \
https://YOUR-SAMM/api/v1/customers/42/wallet/topup
curl -H "Authorization: Bearer $T" https://YOUR-SAMM/api/v1/customers/42/wallet
POST /invoices/{id}/unpay rouvre une facture payée et DELETE /invoices/{id}
en clôture une correctement (le solde restant d'un paiement partiel est annulé). L'exportation de la comptabilité au format JSON ou CSV s'effectue via
GET /accounting/export/{kind}.
Applications de paiement
Les applications de transfert d'argent et les agents de boutique (Wish Money, Sham Cash…) disposent de leurs propres scopes, collect:read et collect:write, et de trois appels : rechercher un utilisateur par nom d'utilisateur (nom masqué, montant dû, factures ouvertes), enregistrer un paiement et le consulter. Un paiement est idempotent sur sa référence : l'envoyer à nouveau renvoie la première réponse et n'enregistre rien.
Les mutations touchant l'état comptable actif — réinitialisations de limites, activation/désactivation de cartes et de groupes, extensions de validité — ne sont pas appliquées au sein de la requête. Elles sont placées dans la file d'attente des commandes auditées et appliquées par samm-radius en un tick (quelques secondes), exactement comme lors de clics identiques dans le portail administrateur. De tels points de terminaison répondent {"queued": true} ; interrogez GET /commands pour voir les commandes en attente de votre jeton passer à applied.
Webhooks
Enregistrez une URL de point de terminaison dans System → API → Webhooks ou via POST /webhooks, et sélectionnez les événements : des événements individuels, un groupe entier tel que invoice.* (incluant les événements futurs de ce groupe) ou * pour tout. Le secret de signature est affiché sur la page du point de terminaison et peut être renouvelé.
Chaque livraison est au format JSON avec id, type, api_version, created_at et data. L' id est identique pour chaque point de terminaison et chaque tentative : traitez chaque id une seule fois. Répondez par un code 2xx sous 10 secondes ; tout autre code fera l'objet de tentatives avec un délai exponentiel pendant environ deux heures, et un point de terminaison qui échoue systématiquement est désactivé automatiquement. Chaque livraison est enregistrée avec le code HTTP renvoyé par votre serveur et peut être renvoyée.
Vérifiez X-SAMM-Signature-256: t=<unix>,v1=<hex>, un HMAC-SHA256 de t.body, avant de valider une livraison :
import hmac, hashlib, time
def verify(raw: bytes, header: str, secret: bytes) -> bool:
p = dict(x.split("=", 1) for x in header.split(","))
if abs(time.time() - int(p["t"])) > 300: # replay window
return False
mac = hmac.new(secret, p["t"].encode() + b"." + raw,
hashlib.sha256).hexdigest()
return hmac.compare_digest(mac, p["v1"])
Événement
Lorsque
customer.created
A user account was created
customer.updated
A user account was updated
customer.renewed
A plan was renewed (expiration extended)
customer.plan_changed
A user moved to another plan
customer.expired
A user expired (expiration sweep)
customer.suspended
A user was suspended (by an admin or for not paying)
customer.restored
A suspended user was restored
customer.deleted
A user account was deleted
limit.exhausted
A usage limit was exhausted (quota / daily / uptime / expiration)
invoice.created
An invoice was created
invoice.updated
What an invoice owes changed (payment, discount, reversal, write-off)
invoice.paid
An invoice was marked paid
invoice.deleted
An invoice was deleted
payment.received
A payment was received and posted (online, payment app)
payment.reversed
A payment was voided or an invoice reopened
wallet.topup
Money was added to a user's prepaid wallet
addon.added
An add-on was given to or bought by a user
session.started
A user session started (off unless enabled in settings)
session.stopped
A user session stopped (off unless enabled in settings)
alert.opened
An alert opened (router down, service down, rogue DHCP server, new crash)
alert.resolved
An alert cleared on its own or was resolved
webhook.test
Manual test event (sent from the test button)
Mêmes règles que pour le portail
Les modifications via l'API passent par la même file de commandes auditée et la même couche de services que le portail d'administration — une réinitialisation ou un changement d'offre via l'API se comporte exactement comme un clic dans l'interface, CoA compris.
Le lien vers SAMM est verrouillé
Les jetons de contrôle du routeur ne peuvent pas affecter la liaison entre SAMM et le routeur lui-même — ses identifiants, son service API, ses paramètres RADIUS, les propres règles de sécurité de SAMM, ou l'adresse via laquelle SAMM le contacte. SAMM vérifie qu'il peut toujours se connecter après chaque modification, et chaque modification ou exécution de script est conservée dans l'Admin Log.
Référence
Utilisation de SAMM
Presque tout se fait depuis le portail administrateur. Cette page sert de référence pour le shell pour les rares cas où vous en aurez besoin.
Gestion des services
# Restart all SAMM services
systemctl restart samm-api samm-radius samm-worker samm-notification samm-telegram
# Live logs for one service
journalctl -u samm-api -f
journalctl -u samm-radius -f
# Validate the FreeRADIUS config after any change
freeradius -CX
# Port 8000 stuck after a crash (admin portal unreachable)
kill -9 $(lsof -ti:8000); systemctl restart samm-api
CLI administrateur
Pour des opérations rapides d'abonné depuis l'invite de commande. Chaque commande est mise en file d'attente dans le journal d'audit et appliquée lors du prochain samm-radius tick — exactement comme les actions de l'interface utilisateur.
CLI="sudo -u samm /opt/samm/venv/bin/python -m samm_radius.cli"
$CLI reset-quota alice # reset a limit counter
$CLI reset-daily alice
$CLI reset-uptime alice
$CLI reset-expiration alice
$CLI change-plan alice home-50M # switch a subscriber's plan
$CLI encrypt-pw # encrypt a router API password for the DB
Fichiers de configuration
Fichier
Mises en attente
/etc/samm/samm.yaml
Le DSN de la base de données, la taille du pool de connexions, le niveau de log
/etc/samm/api.env
Secrets de session du portail et paramètres SMTP de récupération de mot de passe
/etc/samm/secret.key
La clé de chiffrement des mots de passe API du routeur stockés
Ces fichiers sont conservés lors des mises à jour et ne sont jamais écrasés par une nouvelle exécution de l'installateur. Les paramètres d'exécution (cadences de boucle, heure de réinitialisation quotidienne, ports CoA) se trouvent plutôt dans Paramètres et s'appliquent sans redémarrage.
Mise à jour de SAMM
Laissez SAMM se mettre à jour via System → License,
ou relancez l'installateur — voir Installation →
Upgrading. Les deux chemins réappliquent les migrations et redémarrent les services ; votre configuration et
vos données restent inchangées.
Sauvegarde & récupération
Utilisez Tools → Backup & Restore pour effectuer un instantané complet de la base de données avant tout changement majeur. Pour une réinstallation sur un nouvel hôte, installez SAMM puis restaurez la sauvegarde.
Outils de maintenance (externes)
Certaines tâches de maintenance sont suffisamment destructrices pour ne pas figurer dans le panneau administrateur, où un clic accidentel pourrait paralyser une entreprise en production. SAMM les conserve sous forme de scripts autonomes, réservés à l'utilisateur root, que vous téléchargez et exécutez délibérément depuis le shell — jamais via un bouton. Ils se trouvent dans le dépôt de distribution public sous tools/.
Réinitialiser le mot de passe d'un administrateur bloqué
Accès au panneau administrateur bloqué ? Définissez un nouveau mot de passe pour un compte superadmin directement dans la base de données — aucun identifiant fonctionnel n'est requis. Cela réactive également le compte s'il était désactivé, sans modifier aucun autre paramètre.
curl -fsSL -o samm-reset-admin-password.sh \
https://raw.githubusercontent.com/mhdhaidarah/samm/main/tools/samm-reset-admin-password.sh
sudo bash samm-reset-admin-password.sh --list # list the superadmin accounts
sudo bash samm-reset-admin-password.sh # reset (prompts for the new password, twice)
Exécutez-le en tant que root sur le serveur SAMM. S'il y a plusieurs superadmins, utilisez --user <name> pour en choisir un.
Réinitialiser les comptes (effacer les données financières)
Efface toutes les transactions financières afin qu'un ISP puisse repartir de zéro pour sa comptabilité, tout en laissant intactes toutes les données des abonnés et AAA. Utile lors de la reprise d'une installation, ou après une période d'essai/test, lorsque les registres sont remplis de données que l'opérateur souhaite supprimer mais que la base de clients doit rester exactement telle quelle.
Danger — perte de données irréversibleCette opération supprime définitivement toutes les factures, tous les paiements, tous les reçus, les soldes de portefeuille et l'historique du grand livre. Cette action est irréversible. Le seul moyen de revenir en arrière est une sauvegarde de la base de données. Ne l'exécutez jamais sur une installation de production que vous n'avez pas préalablement sauvegardée et vérifiée.
Supprimé : factures et leurs lignes, le grand livre en partie double
(paiements, reçus, ajustements, recharges et retraits de portefeuille), transactions de
paiement en ligne, dépenses, immobilisations et le journal d'activité comptable. La numérotation
des factures est réinitialisée, la prochaine facture commence donc au #1.
Conservé : chaque abonné, forfait, fenêtre de vitesse, limite, compteur d'utilisation,
historique de forfait, carte hotspot, routeur, session et enregistrement de comptabilité RADIUS — ainsi que votre
configuration comptable (plan comptable, comptes de trésorerie, groupes de taxes, passerelles de paiement). Les soldes de trésorerie, de portefeuille et les créances sont dérivés du grand livre, ils affichent donc simplement zéro par la suite.
Téléchargez-le, lisez-le, puis exécutez-le. Effectuez toujours un essai à blanc au préalable :
curl -fsSL -o samm-wipe-financials.sh \
https://raw.githubusercontent.com/mhdhaidarah/samm/main/tools/samm-wipe-financials.sh
sudo bash samm-wipe-financials.sh --dry-run # show what would be deleted, change nothing
sudo bash samm-wipe-financials.sh # do it
Ne le redirigez pas directement vers un shell
N'exécutez jamais cette commande via curl … | sudo bash. Pour un script qui détruit des données, vous devez d'abord le lire ; un téléchargement tronqué ne doit pas pouvoir exécuter un effacement partiel. Téléchargez, inspectez, puis lancez.
Le script refuse de s'exécuter en tant qu'utilisateur non root, affiche exactement ce qu'il s'apprête à supprimer, puis vous demande de saisir YES pour confirmer que vous disposez d'une sauvegarde vérifiée et WIPE pour continuer. Il propose d'effectuer d'abord son propre dump de base de données (dans /var/backups/samm/) et s'interrompt si ce dump échoue. L'effacement s'exécute comme une transaction unique et indivisible, et RADIUS est délibérément laissé en cours d'exécution, afin que les abonnés restent en ligne pendant que les registres sont résolus.
Référence
FAQ & dépannage
Quels systèmes d'exploitation SAMM prend-il en charge ?
Ubuntu 22.04 / 24.04 / 26.04 LTS et Debian 12 / 13. Linux version serveur uniquement —
les variantes desktop ne sont pas prises en charge. L'installateur nécessite systemd, une
installation propre de PostgreSQL (une instance est configurée pour vous) et un accès root.
Une connexion internet est-elle nécessaire pour exécuter SAMM ?
Non. SAMM s'exécute entièrement sur votre propre serveur et authentifie les abonnés localement via RADIUS. Le seul trafic sortant est un signal périodique de licence vers le serveur de licence SecuryTik afin que votre forfait reste validé.
Puis-je exécuter SAMM dans le cloud, ou doit-il être installé sur site ?
Les deux options fonctionnent. La plupart des opérateurs l'installent sur site à côté de leurs routeurs cœur de réseau ; certains l'installent sur une petite VM cloud avec un tunnel Cloudflare Zero Trust pour le retour. La seule exigence est que les routeurs MikroTik puissent joindre le serveur SAMM sur les ports RADIUS (1812/1813 UDP) et que SAMM puisse joindre les routeurs via l'API MikroTik.
Dois-je redémarrer FreeRADIUS lorsque j'ajoute ou supprime un routeur ?
Non. SAMM résout dynamiquement les clients NAS à partir de la base de données ; ainsi, l'ajout, la modification ou la suppression d'un routeur dans MikroTik → NAS prend effet sans redémarrage.
Quel est le délai de prise d'effet d'un changement de forfait ou d'une réinitialisation de compteur ?
Les actions de l'administrateur sont mises en file d'attente et appliquées par le service samm-radius lors de son prochain cycle — dans un délai de 30 secondes par défaut. Si l'abonné est en ligne, SAMM envoie également un CoA en direct pour rafraîchir la session. Réduisez l'intervalle samm-radius dans System → Paramètres pour un délai plus court.
Qu'advient-il de mes données si une licence payante expire ?
Rien n'est jamais supprimé. Une licence expirée passe successivement par une phase d'avertissement, une période de grâce, un verrouillage partiel (RADIUS continue l'authentification pendant environ une semaine) et enfin un verrouillage complet. Une réactivation à n'importe quelle étape redémarre chaque service avec toutes les données intactes.
SAMM est-il gratuit ? Qu'apporte la version Pro ?
Le forfait Free est gratuit à vie et inclut toutes les fonctionnalités. Les forfaits payants ne débloquent pas de fonctionnalités — ils augmentent les plafonds d'utilisateurs AAA et de cartes hotspot, et suppriment la limite de routeurs. Voir Licensing & tiers.
Un abonné ne peut pas s'authentifier — par où commencer ?
Vérifiez que le secret partagé RADIUS du routeur correspond exactement à l'enregistrement NAS, que le routeur est activé pour PPP / Hotspot RADIUS, et que le compte de l'abonné est actif et n'est pas expiré. Surveillez journalctl -u samm-api -f et le journal FreeRADIUS, et confirmez que le routeur peut joindre l'hôte SAMM sur UDP 1812/1813.
Besoin d'aide supplémentaire ?
Envoyez un e-mail à samm@securytik.com pour signaler un bug ou demander une fonctionnalité.