Documentation

SAMM documentation

Le manuel d'utilisation complet — de la première installation aux opérations quotidiennes.

25 sujets 8 sections Installation 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.

Consultez le guide d'installation complet
Ubuntu / Debian — exécuter en tant que root
curl -fsSL https://samm.securytik.com/install.sh | sudo bash
Windows — exécuter dans PowerShell en tant qu'administrateur
irm https://samm.securytik.com/install-windows.ps1 | iex
Playlist Cours vidéo Découvrez SAMM, de l'installation aux opérations quotidiennes — un cours vidéo complet Une playlist YouTube gratuite, étape par étape, qui vous guide dans l'installation de SAMM et son utilisation quotidienne — le même contenu que ce manuel, en vidéo. Regarder sur YouTube

Prise en main

Vue d'ensemble & architecture

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

ServiceRôle
samm-apiPortail administrateur + portail libre-service client + REST API
samm-radiusVide la boîte d'envoi CoA ; exécute les balayages d'expiration / de réinitialisation quotidienne / de fenêtre de débit
samm-workerPing les routeurs ; synchronise les métadonnées des appareils MikroTik via l'API
samm-notificationEnvoie des notifications par e-mail & Telegram via une file d'attente régulée
samm-telegramExé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.

Système

VPN WireGuard intégré, tunnel Cloudflare , huit langues, interface utilisateur thématique.

Notifications

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.

SAMM s'exécute partout — choisissez le chemin d'installation qui convient à votre réseau :

Prérequis

  • 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).

Installation

Option A — installation via une seule commande

Sur le serveur, exécutez :

curl -fsSL https://samm.securytik.com/install.sh | sudo bash

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.)

curl -fsSL https://dl.securytik.com/install.sh | sudo bash

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 :

irm https://samm.securytik.com/install-windows.ps1 | iex

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.)

irm https://dl.securytik.com/install-windows.ps1 | iex

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é

  1. 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).
  2. 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

  1. Enregistrez votre travail et redémarrez le PC.
  2. 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.
  3. 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.)
  4. Enregistrer et quitter (généralement F10), laissez Windows démarrer, puis lancez à nouveau l'installateur SAMM.

Emplacement habituel

MarqueClé de configurationEmplacement habituel
DellF2Assistance à la virtualisation → Virtualisation / Activer Intel Virtualization Technology
HPF10 (ou Esc, puis F10)Avancé (ou Configuration Sécurité / Système) → Virtualization Technology (VTx)
LenovoF1 / F2 (ou le bouton Novo)Sécurité (ThinkPad) ou Configuration → Intel Virtualization Technology / AMD SVM Technology
ASUSF2 / DelMode Avancé (F7) → Avancé → Configuration du CPU → Intel Virtualization Technology ou SVM Mode
AcerF2Avancé (ou Principal) → Intel Virtualization Technology
MSIDelOC → CPU Features → Intel Virtualization Tech ou SVM Mode
GigabyteDelTweaker (ou Advanced) → Advanced CPU Settings → Intel Virtualization Technology ou SVM Mode
Serveurs (Dell iDRAC, HPE, Supermicro)F2 / F9 / DelParamè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 :

mkdir -p /opt/samm && unzip samm.zip -d /tmp/samm-bundle
sudo bash /tmp/samm-bundle/samm/install.sh

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 :

curl -fsSL https://github.com/mhdhaidarah/samm-docker/releases/latest/download/install.sh | sudo bash

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 :

New-NetFirewallRule -DisplayName "SAMM RADIUS" -Direction Inbound -Protocol UDP -LocalPort 1812,1813 -Action Allow

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 :

/tool fetch url="https://samm.securytik.com/install-routeros.rsc" dst-path=samm-install.rsc; /import samm-install.rsc

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.
docker-compose.yml
name: samm

services:
  postgres:
    image: postgres:16-alpine
    restart: unless-stopped
    environment:
      POSTGRES_DB: samm
      POSTGRES_USER: samm
      POSTGRES_PASSWORD: change-me-strong-random-string
      TZ: UTC
    volumes:
      - pgdata:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U samm -d samm"]
      interval: 10s
      timeout: 5s
      retries: 12

  samm-api:
    image: mhdhaidarah/samm:latest
    restart: unless-stopped
    command: ["api"]
    environment:
      SAMM_ROLE: api
      POSTGRES_HOST: postgres
      POSTGRES_PORT: 5432
      POSTGRES_DB: samm
      POSTGRES_USER: samm
      POSTGRES_PASSWORD: change-me-strong-random-string
      TZ: UTC
      SAMM_API_HOST: 0.0.0.0
      SAMM_API_PORT: 8000
      SAMM_API_WORKERS: 2
      WA_BRIDGE_URL: http://wa-bridge:8787
      WA_BRIDGE_TOKEN: change-me-random-token
      SAMM_SCOOP_URL: http://samm-scoop:4097
    depends_on:
      postgres:
        condition: service_healthy
    healthcheck:
      test: ["CMD-SHELL", "curl -fsS http://127.0.0.1:8000/health >/dev/null || exit 1"]
      interval: 10s
      timeout: 5s
      retries: 30
      start_period: 1800s
    ports:
      - "8000:8000"
    volumes:
      - etcsamm:/etc/samm
      - sammvar:/opt/samm/var
      - sammlogs:/var/log/samm
      - sammlocales:/opt/samm/app/locales

  samm-scoop:
    image: mhdhaidarah/samm:latest
    restart: unless-stopped
    command: ["scoop"]
    environment:
      SAMM_ROLE: scoop  # see samm-api notes — parser-agnostic role hint
      POSTGRES_HOST: postgres
      POSTGRES_PORT: 5432
      POSTGRES_DB: samm
      POSTGRES_USER: samm
      POSTGRES_PASSWORD: change-me-strong-random-string
      TZ: UTC
      SAMM_API_URL: http://samm-api:8000
    depends_on:
      samm-api:
        condition: service_healthy
    volumes:
      - etcsamm:/etc/samm
      - sammvar:/opt/samm/var
      - scoopengine:/opt/samm/runtime/scoop
      - scoophome:/var/lib/samm-scoop

  samm-radius:
    image: mhdhaidarah/samm:latest
    restart: unless-stopped
    command: ["radius"]
    environment:
      SAMM_ROLE: radius  # see samm-api notes — parser-agnostic role hint
      POSTGRES_HOST: postgres
      POSTGRES_PORT: 5432
      POSTGRES_DB: samm
      POSTGRES_USER: samm
      POSTGRES_PASSWORD: change-me-strong-random-string
      TZ: UTC
    depends_on:
      postgres:
        condition: service_healthy
      samm-api:
        condition: service_healthy
    volumes:
      - etcsamm:/etc/samm
      - sammvar:/opt/samm/var
      - sammlogs:/var/log/samm

  samm-worker:
    image: mhdhaidarah/samm:latest
    restart: unless-stopped
    command: ["worker"]
    environment:
      SAMM_ROLE: worker  # see samm-api notes — parser-agnostic role hint
      POSTGRES_HOST: postgres
      POSTGRES_PORT: 5432
      POSTGRES_DB: samm
      POSTGRES_USER: samm
      POSTGRES_PASSWORD: change-me-strong-random-string
      TZ: UTC
    depends_on:
      postgres:
        condition: service_healthy
      samm-api:
        condition: service_healthy
    cap_add:
      - NET_RAW
    sysctls:
      - net.ipv4.ping_group_range=0 2147483647
    volumes:
      - etcsamm:/etc/samm
      - sammvar:/opt/samm/var
      - sammlogs:/var/log/samm

  samm-notification:
    image: mhdhaidarah/samm:latest
    restart: unless-stopped
    command: ["notification"]
    environment:
      SAMM_ROLE: notification  # see samm-api notes — parser-agnostic role hint
      POSTGRES_HOST: postgres
      POSTGRES_PORT: 5432
      POSTGRES_DB: samm
      POSTGRES_USER: samm
      POSTGRES_PASSWORD: change-me-strong-random-string
      TZ: UTC
      WA_BRIDGE_URL: http://wa-bridge:8787
      WA_BRIDGE_TOKEN: change-me-random-token
    depends_on:
      postgres:
        condition: service_healthy
      samm-api:
        condition: service_healthy
    volumes:
      - etcsamm:/etc/samm
      - sammvar:/opt/samm/var
      - sammlogs:/var/log/samm

  samm-telegram:
    image: mhdhaidarah/samm:latest
    restart: unless-stopped
    command: ["telegram"]
    environment:
      SAMM_ROLE: telegram  # see samm-api notes — parser-agnostic role hint
      POSTGRES_HOST: postgres
      POSTGRES_PORT: 5432
      POSTGRES_DB: samm
      POSTGRES_USER: samm
      POSTGRES_PASSWORD: change-me-strong-random-string
      TZ: UTC
    depends_on:
      postgres:
        condition: service_healthy
      samm-api:
        condition: service_healthy
    volumes:
      - etcsamm:/etc/samm
      - sammvar:/opt/samm/var
      - sammlogs:/var/log/samm

  wa-bridge:
    image: mhdhaidarah/samm:wa-bridge-latest
    restart: unless-stopped
    environment:
      WA_BRIDGE_TOKEN: change-me-random-token
      TZ: UTC
    depends_on:
      - samm-api
    volumes:
      - wabridge_auth:/data/auth      # multi-device session — persists the QR link

  freeradius:
    image: mhdhaidarah/samm:freeradius-latest
    restart: unless-stopped
    environment:
      POSTGRES_HOST: postgres
      POSTGRES_PASSWORD: change-me-strong-random-string
      TZ: UTC
    depends_on:
      postgres:
        condition: service_healthy
      samm-api:
        condition: service_healthy
    ports:
      - "1812:1812/udp"
      - "1813:1813/udp"

volumes:
  pgdata: {}
  etcsamm: {}
  sammvar: {}
  sammlogs: {}
  sammlocales: {}
  wabridge_auth: {}      # WhatsApp bridge multi-device session
  scoopengine: {}        # SCOOP AI engine (OpenCode) and the previous one, for rollback
  scoophome: {}          # SCOOP AI's saved AI logins and conversations

4. Vérification et connexion de MikroTik à SAMM

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 :

  1. Dans SAMM, allez dans Tools → Backup, créez une sauvegarde et téléchargez le fichier sur votre ordinateur.
  2. Sur le routeur, supprimez l'application et ajoutez-la à nouveau avec la nouvelle version.
  3. 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.

Téléchargement de l'ISO du serveur SAMM 2.5 GB

SHA-2560aa7c06bea4aba8ce7f632aacf243639ac7f78359cc0aa72005d88735930e9be

Installation

Guide de référence de l'installateur

Options non interactives

Toutes les invites peuvent être pré-remplies via des variables d'environnement, afin que l'installateur puisse s'exécuter sans intervention :

VariableEffet
DB_PASSUtilisez ce mot de passe de base de données au lieu d'un mot de passe généré automatiquement (première installation uniquement)
CF_TOKENInstallez le connecteur Cloudflare Tunnel avec ce jeton Zero Trust
SAMM_HTTP_PORTForcer le port d'écoute nginx (ignore l'invite de détection du port 80)
SAMM_VERBOSE1 affiche le flux de sortie brute de la commande au lieu de la barre de progression
NO_COLOR1 désactive l'affichage en couleur
DB_PASS='strong_pw'   sudo bash /opt/samm/install.sh
CF_TOKEN='eyJ...'     sudo bash /opt/samm/install.sh
SAMM_HTTP_PORT=8080   sudo bash /opt/samm/install.sh

Ce que l'installateur configure

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.

ComposantDétails
FreeRADIUS 3Configuré avec un backend PostgreSQL et des clients NAS dynamiques ; validé avec freeradius -CX
PostgreSQLBase de données, schéma et toutes les migrations SQL appliquées — chaque fichier de migration est idempotent
Python venvToutes 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
nginxReverse 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 servicessamm-api, samm-radius, samm-worker, samm-notification, samm-telegram — tous activés en tant qu'unités systemd
WireGuardPaquets installés ; à configurer ultérieurement via System → VPN
cloudflaredLe 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

  1. 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.
  2. Connectez-vous avec admin / admin.
  3. 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

  1. Allez dans MikroTik → NAS et cliquez sur Ajouter un routeur.
  2. 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.
  3. 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èmeFichierProvenance
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

  1. Envoi du fichier. Rien n'est encore écrit.
  2. 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.
  3. 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.
  4. 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

  1. Allez dans Utilisateurs → Forfaits.
  2. Cliquez sur Nouveau forfait.
  3. 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

ChampSignification
NomNom de forfait unique, ex. Home-50M
PrixFacturé par période de facturation lorsque la facturation est utilisée
Vitesse de téléchargement / envoipar ex. 50M, 512K, 1G — appliqué comme limite de débit MikroTik
Sessions simultanéesNombre 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 : ExpirationL'abonnement expire après une période fixe suivant l'activation (jours/mois/heures/minutes)
Limite : QuotaUn plafond de données total (combiné, téléchargement uniquement ou envoi uniquement) pour l'ensemble de l'abonnement
Limite : Temps de fonctionnementUn plafond de temps de connexion cumulé — la somme de toutes les durées de session
Limite : Utilisation quotidienneUn quota de données qui se réinitialise chaque jour à l'heure de réinitialisation quotidienne configurée
Fenêtre illimitéeAjout rapide d'une fenêtre de vitesse — l'éditeur complet se trouve sur la page Speed Windows du forfait
Pool IPNom du Framed-Pool RADIUS facultatif pour l'attribution d'adresses
Renouvellement automatiqueDé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.

LimiteSuivisÀ l'épuisement
ExpirationTemps calendaire depuis l'activationPasser à un autre forfait, ou se déconnecter
QuotaTotal d'octets utilisésPasser à un autre forfait, ou se déconnecter
Temps de fonctionnementDurée cumulée des sessions (secondes)Passer à un autre forfait, ou se déconnecter
QuotidienOctets depuis la dernière réinitialisation quotidienneLimiter — 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é

  1. Allez dans Users et cliquez sur New customer.
  2. Remplissez le formulaire et enregistrez — l'abonné peut se connecter immédiatement.
ChampSignification
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 / NomNom de l'abonné
Mobile / E-mail / AdresseCoordonnées — utilisées pour les notifications et les factures
Forfait *Le forfait de service à assigner
Ignorer l'expirationDate d'expiration manuelle facultative au lieu de celle calculée pour le forfait
Renouvellement automatiqueRenouvellement 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é :

ActionFonctionnement
Voir / ModifierOuvrez la page de détails, ou modifiez les coordonnées, le mot de passe et la date d'expiration
Activer / DésactiverSuspendre le compte — les abonnés en ligne sont déconnectés
Renouveler le forfaitAjoute 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 / QuotidienRemettre à zéro le compteur de limite choisi
UtilisationOuvrir les graphiques d'utilisation et l'historique des sessions
SupprimerSupprimer 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

  1. Allez dans Users → Hotspot Cards et cliquez sur Nouveau groupe.
  2. Remplissez le formulaire ci-dessous et cliquez sur Créer le groupe — SAMM génère automatiquement les identifiants de chaque carte.
SectionChamps
IdentitéNom de groupe unique, description, préfixe de nom d'utilisateur facultatif, nombre de cartes à générer (jusqu'à 10 000)
IdentifiantsFormat et longueur du nom d'utilisateur et du mot de passe (chiffres / lettres / alphanumérique)
Limitation de débitVitesse de téléchargement et d'envoi — 256k, 6M, 1G; 0 = illimité
Limiter le transfertIllimité, plafond combiné, ou plafonds de téléchargement/envoi distincts (MB / GB / TB)
Plages horaires limitéesLimite 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

ÉtatSignification
Non utiliséGénéré mais jamais connecté
ActifEn 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

  1. 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.
  2. 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.
  3. 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.
  4. 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.

  1. 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.
  2. 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.
  3. 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

  1. Connectez-vous sur samm.securytik.com et ouvrez Dashboard → Get a server.
  2. Choisissez un nom de serveur et le nombre d'utilisateurs, puis recherchez votre domaine .com ou choisissez l'une des suggestions.
  3. 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.
  4. 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.

  1. 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.
  2. La ligne de capacité indique combien d'utilisateurs peuvent tenir avant l'enregistrement.
  3. 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

  1. Ouvrez System → Settings → Data retention et activez-la.
  2. 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.
  3. 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 ?

  1. Ouvrez Overview → Data Log → Data retention.
  2. Saisissez l'adresse publique, le port et l'heure figurant dans la demande reçue.
  3. 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

  1. Allez dans MikroTik → NAS et cliquez sur Ajouter un routeur.
  2. Remplissez les champs ci-dessous et enregistrez.
ChampSignification
IP / nom d'hôte du NASL'adresse du routeur, telle que vue par l'hôte SAMM
Nom courtUn label convivial affiché dans toute l'interface
Typemikrotik active la synchronisation des appareils en temps réel et le push de configuration ; les autres types sont limités au RADIUS
SecretLe secret partagé RADIUS — doit correspondre exactement à celui du routeur, sinon l'authentification échoue
Port CoAPort UDP vers lequel SAMM envoie les paquets Change-of-Authorization (par défaut MikroTik 3799)
Port API / utilisateur / mot de passeIdentifiants 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ètreValeur
CommentaireSAMM — le tag utilisé par SAMM pour rechercher et mettre à jour cette entrée ultérieurement
Servicehotspot, ppp
Adresse / secretL'hôte SAMM, avec le secret partagé de cet enregistrement NAS
Délai d'expiration3000 ms
CoA entrantAccepté, 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

OngletCe qu'il affiche
Vue d'ensembleInformations sur l'appareil, informations système et graphiques d'historique des performances (CPU, mémoire, sessions au fil du temps)
InterfacesChaque interface avec son état en temps réel, ainsi que l'historique du trafic par interface
Sites Web & AppsTrois 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

OngletCe que vous configurez
BridgeCréez des ponts LAN et choisissez les interfaces physiques (ports) qui appartiennent à chacun d'eux
VLANAjouter et gérer les interfaces VLAN
IPTrois 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)
DNSServeurs DNS et cache (le filtre de contenu des applications/sites se trouve sous Websites & Apps)
WiFi / CAPsMANInterfaces 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 &

OngletCe que vous configurez
PPPoEServeurs PPPoE, profils PPP, pools IP et l'intervalle d'interim-update de la comptabilité RADIUS
HotspotServeurs Hotspot, profils hotspot et profils utilisateur, pools DHCP/IP et page de connexion du portail captif
InternetLiaisons 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-feuRè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 à jourMises à jour de RouterOS — choisissez un canal de mise à jour, vérifiez et appliquez, puis examinez les paquets installés
AssistantLa 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.

  1. 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.
  2. Interface Bridge — nommez le bridge LAN.
  3. Bridge ports — choisissez les interfaces physiques à ajouter au bridge.
  4. 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.
  5. NTP — définit la source d'horloge du routeur (client NTP et, optionnellement, serveur de temps pour le LAN).
  6. Internet — ajoutez une ou plusieurs liaisons montantes WAN (Static / DHCP / PPPoE).
  7. RADIUS vers SAMM — configurez le routeur pour qu'il pointe vers votre hôte SAMM pour l'authentification, la comptabilité et le CoA.
  8. 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.
  9. 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.
  10. 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

  1. Ouvrez Devices → Network Health et appuyez sur Inspection approfondie, ou faites un clic droit sur un routeur de la page.
  2. Activez les routeurs à inspecter. Tous les interrupteurs démarrent désactivés. Seuls les BNG MikroTik avec une connexion enregistrée sont listés.
  3. 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.
  4. 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
  1. L'action est enregistrée dans un journal d'audit en tant que commande mise en file d'attente.
  2. 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.
  3. 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.

ÉtatSignification
en attenteMis 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)
nackLe 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.

TuileAfficheOuvrir
En ligne maintenantAbonnés ayant actuellement une session RADIUS activeUtilisateurs filtrés sur Online
Abonnés actifsComptes actifs, avec le nombre total d'abonnés ci-dessousUtilisateurs filtrés sur Active
ExpiréAbonnés dont l'abonnement a expiré sans forfait suivant définiUtilisateurs filtrés sur Expired
Tickets ouvertsTickets d'assistance non encore résolus (exclut terminé & fermé)Utilisateurs → Tickets d'assistance
RouteursNombre total d'enregistrements NAS, plus le nombre d'enregistrements actuellement injoignablesLe moniteur MikroTik
Factures impayéesFactures nécessitant encore une relance de paiementFactures 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étriqueCe que cela signifie
samm-radius file d'attenteCoAs 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 attenteActions d'administrateur en file d'attente non encore appliquées par samm-radius
Sessions bridéesAbonnés actuellement limités à une vitesse réduite par une limite — attendu, pas une erreur
Instantané des sessionsLe nombre de sessions actives — doit correspondre à Online now
Forfaits actifsLa 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

ColonneSignification
UtilisateurNom d'utilisateur — lien vers la page de détails de l'abonné
IP encadréeL'adresse que le routeur a assignée à cette session
RouteurLe nom court du NAS et son adresse IP
ForfaitLe forfait actuel de l'abonné
Débit effectifLa 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 / HautCompteurs d'octets en temps réel pour la session
En ligneDuré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 :

ListeRangs
Top 10 des téléchargements aujourd'huiTéléchargement le plus volumineux depuis la dernière réinitialisation quotidienne
Top 10 des envois aujourd'huiEnvoi le plus important depuis la dernière réinitialisation quotidienne
Top 10 des téléchargements du moisTéléchargement le plus volumineux de ce mois civil
Top 10 des envois du moisEnvoi 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 :

FigureSignification
Espèces disponiblesSolde total de tous les comptes de caisse & banque
Montants dusCréances — factures clients et revendeurs impayées
Montant dûComptes fournisseurs — dépenses impayées
Bénéfice ce mois-ciRevenus 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 :

ChampSignification
ClientRecherche prédictive du compte à facturer
Catégorie de revenusCompte de revenus utilisé pour l'enregistrement des ventes
Date d'émission / Date d'échéanceDate d'émission vide = aujourd'hui ; date d'échéance vide = date d'émission
Taux de taxe % / groupe de taxePar 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 ligneUne 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 :

ChoixFrais appliqués
Facture complètePériodes de forfait complètes uniquement — toute période partielle est arrondie à l'unité supérieure.
Facture segmentéeL'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 factureModifier 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ètreSignification
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éditSeuil 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 :

RapportRéponses
Pertes & ProfitsRevenus 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ésoreriePar compte espèces — solde initial, entrées, sorties, solde final sur une période.
ExpirationCré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éé :

RefusCe que cela signifie
Cet enregistrement n'existe plusL'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 actionQuelqu'un d'autre l'a modifié entre-temps — l'annulation supprimerait silencieusement sa modification.
Cette étape ne figure plus dans votre historiqueLe délai de cinq minutes est expiré.

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 :

DirectionExemplesComportement
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)

  1. Allez dans Financial → Online payments (superadmin uniquement).
  2. Cliquez sur une passerelle pour la développer — Stripe, PayPal ou Binance.
  3. 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.
  4. Cliquez sur Run test pour confirmer que vos identifiants fonctionnent.
  5. 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

  1. Créez un compte gratuit sur stripe.com. Laissez le Test mode activé pendant vos essais.
  2. Allez dans Developers → API keys et copiez la Secret key (elle commence par sk_).
  3. Dans SAMM, développez Stripe, collez la Secret key, choisissez la devise et le compte de caisse destinataire, puis Enregistrer et Lancer le test.
  4. 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

  1. Créez un compte PayPal Business, puis sur developer.paypal.com, créez une App REST et copiez son Client ID et son Secret.
  2. Dans SAMM, développez PayPal, collez le Client ID et le Client secret, choisissez Sandbox (test) ou Live, puis Enregistrer et Lancer le test.
  3. 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.
  1. Connectez-vous à Binance → ouvrez Compte → Gestion des API (ou recherchez « Gestion des API »).
  2. Cliquez sur Create API → choisissez System generated → nommez-la, par exemple « SAMM » → terminez la vérification de sécurité.
  3. 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).
  4. 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.)
  5. 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

  1. Dans Binance, allez dans Wallet → Spot → Deposit (Deposit Crypto).
  2. Choisissez la cryptomonnaie USDT.
  3. 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.
  4. 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.

  1. 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).
  2. 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.
  3. 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.
  4. 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.

  1. 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.
  2. 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é

  1. Connectez-vous au portail client → Mes factures.
  2. Sur une facture impayée, cliquez sur Pay (ou « Pay · Stripe » / « Pay · Binance » si plusieurs sont activés).
  3. 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.
  4. 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.

TypeUtilisez-le pour
WireGuardRouteurs RouterOS 7, téléphones et ordinateurs portables. Le plus rapide et le plus simple.
L2TP/IPsecLes routeurs RouterOS 6 et 7, ainsi que les appareils ne disposant pas de WireGuard.
SSTPDeux routeurs ou plus accédant à Internet via la même adresse publique, sur RouterOS 6 ou 7.

Onglet Serveur

  1. Pour WireGuard, cliquez sur Generate Keys pour créer la paire de clés du serveur.
  2. 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.
  3. 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

  1. Appuyez sur la vignette du logo ou sur Envoi du logo et choisissez une image PNG, JPEG, WebP ou GIF (jusqu'à 5 MB).
  2. Faites glisser l'image pour la positionner et utilisez le curseur pour zoomer. Un arrière-plan transparent reste transparent.
  3. 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 :

ÉtatSignification
En coursLe 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

  1. Dans le tableau de bord Cloudflare Zero Trust (one.dash.cloudflare.com), ouvrez Networks → Tunnels et cliquez sur Create a tunnel.
  2. 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.
  3. Collez-le dans SAMM et cliquez sur Configure Tunnel. SAMM transmet le jeton à cloudflared et démarre le connecteur.
  4. 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ètrePar défautCommandes
samm-radius interval30 sFréquence d'évaluation des événements temporels et d'envoi des CoA
samm-worker interval5 sCadence du ping du routeur + synchronisation de l'API MikroTik
Intervalle intérimaire du compte60 sL'intervalle de comptabilisation envoyé aux routeurs
Heure de réinitialisation quotidienne00:00Lors de la réinitialisation des compteurs d'utilisation quotidienne
Fuseau horaire du serveurUTCFuseau horaire pour les fenêtres de débit et la réinitialisation quotidienne
Port CoA par défaut3799Port UDP par défaut pour les paquets CoA
Nombre max de tentatives CoA3Nombre 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éesL'endroit où cela s'affiche
Nom de l'ISPFactures, reçus, cartes hotspot, en-tête du portail
Assistance par téléphone & e-mailFactures et cartes hotspot imprimées
Numéro de TVA / d'immatriculationImprimé 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é & tauxAjoute 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.

Confidentialité — statistiques d'installation anonymes

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œudPrésentation
AgenceUn 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.
SuperadminToujours 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'utilisateursNombre 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 cartesCombien 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.

QuiUn appareil de l'agence
Le personnel de cette agence, des agences supérieures et du siège socialLe gérer
Personnel de ses agences rattachéesVoir, lecture seule
Autres agencesNe le voyez pas
Les utilisateurs de cette agence et de ses agences enfantsPermet 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 :

NiveauSignification
Non autoriséLa zone est entièrement masquée dans la barre latérale
AfficherAccès en lecture seule
ModifierAccè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 :

DroiteFonctionnalité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ètreEffet
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ôleFonctionnement
PourcentageLes 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 à boosterCochez 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èsNombre 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.

ColonneCe qu'il affiche
LorsqueL'heure, selon votre fuseau horaire
QuiL'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 »
CibleModifications effectuées — Utilisateur · ali, Forfait · Gold 20M, Routeur · Hamra, Administrateur · rami

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.

NiveauUtilisateurs AAACartes HotspotNAS / routeursSurveillance
Non enregistré252513
Gratuit1005026
Lite5001,500412
Plus1,0003,000618
Pro2,0006,0001236
Mega5,00015,0002472
Max10,00030,000illimitéillimité
Unlimitedillimité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

  1. Allez dans System → License.
  2. 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.
  3. 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 :

ÉtapeQue se passe-t-il
AvertissementUne bannière de rappel ; tout continue de fonctionner
Délai de grâceUne courte fenêtre de réactivation ; les abonnés restent en ligne
Verrouillage partielLes services d'arrière-plan s'arrêtent ; RADIUS continue d'authentifier pendant environ 7 jours
Verrouillage strictLes 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 :

PageCe que voit l'abonné
Vue d'ensembleStatut du compte, forfait, date d'expiration, consommation du jour et du mois, et toute facture impayée
Utilisation & sessionsTotal téléchargé/téléversé, budget de temps de fonctionnement et historique complet des sessions
Mes forfaitsLe forfait actuel ainsi que le catalogue des forfaits disponibles
Mes facturesHistorique de facturation avec téléchargement PDF en un clic
Tickets d'assistanceOuvrir et suivre les tickets d'assistance
ProfilModifier 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 :

openapi-generator-cli generate \
  -i https://YOUR-SAMM/api/v1/openapi.json \
  -g python -o ./samm-client

samm-openapi.json · SAMM 6.0.0 · 187 points de terminaison

Guide de démarrage rapide

  1. 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).
  2. Copiez le secret immédiatement — il n'est affiché qu'une seule fois et seul son hash est stocké sur le serveur.
  3. Vérifiez que cela fonctionne et découvrez les capacités du jeton :
curl -H "Authorization: Bearer samm_YOUR_TOKEN" https://YOUR-SAMM/api/v1/me

Listez les abonnés actifs, puis créez-en un :

curl -H "Authorization: Bearer samm_YOUR_TOKEN" \
  "https://YOUR-SAMM/api/v1/customers?status=active&limit=20"

curl -X POST -H "Authorization: Bearer samm_YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"username":"john","password":"secret1","firstname":"John",
       "lastname":"Doe","plan_id":3}' \
  https://YOUR-SAMM/api/v1/customers

Authentification, jetons et scopes

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

ZonePoints de terminaisonChamp 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} coa:write customers:read customers:renew customers:write diagnostics:read
Plans GET /plans · POST /plans · GET /plans/{plan_id} · PATCH /plans/{plan_id} plans:read plans: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:read billing: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:read billing:write
Payment apps (collect) GET /collect/lookup · POST /collect/payments · GET /collect/payments/{channel}/{reference} collect:read collect: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:read addons: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:read cards:write
Sessions & CoA GET /coa-outbox · GET /sessions · POST /coa-outbox/cancel · POST /coa-outbox/retry · POST /sessions/disconnect · POST /sessions/reconnect coa:write sessions: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:read customers:write
Branches GET /branches · PUT /customers/{customer_id}/branch admins:write customers: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 routers:diagnose routers:jobs routers:read routers:write
Network map & health 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:write routers: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:read backups:write
History cleaner POST /history/clean · GET /history/schedule · PUT /history/schedule · GET /history/space history:read history: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:read vpn: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 customers:read diagnostics:read errors:read logs:read services:write settings:write
Reports GET /reports/activations · GET /reports/financial · POST /retention/lookup · GET /customers/{customer_id}/statement accounting:read customers:read retention: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.

curl -H "Authorization: Bearer $T" "https://YOUR-SAMM/api/v1/collect/lookup?username=ali"

curl -X POST -H "Authorization: Bearer $T" -H "Content-Type: application/json" \
  -d '{"username":"ali","amount":"20.00","reference":"WM-88213","channel":"wishmoney"}' \
  https://YOUR-SAMM/api/v1/collect/payments

Commandes mises en file d'attente

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énementLorsque
customer.createdA user account was created
customer.updatedA user account was updated
customer.renewedA plan was renewed (expiration extended)
customer.plan_changedA user moved to another plan
customer.expiredA user expired (expiration sweep)
customer.suspendedA user was suspended (by an admin or for not paying)
customer.restoredA suspended user was restored
customer.deletedA user account was deleted
limit.exhaustedA usage limit was exhausted (quota / daily / uptime / expiration)
invoice.createdAn invoice was created
invoice.updatedWhat an invoice owes changed (payment, discount, reversal, write-off)
invoice.paidAn invoice was marked paid
invoice.deletedAn invoice was deleted
payment.receivedA payment was received and posted (online, payment app)
payment.reversedA payment was voided or an invoice reopened
wallet.topupMoney was added to a user's prepaid wallet
addon.addedAn add-on was given to or bought by a user
session.startedA user session started (off unless enabled in settings)
session.stoppedA user session stopped (off unless enabled in settings)
alert.openedAn alert opened (router down, service down, rogue DHCP server, new crash)
alert.resolvedAn alert cleared on its own or was resolved
webhook.testManual 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

FichierMises en attente
/etc/samm/samm.yamlLe DSN de la base de données, la taille du pool de connexions, le niveau de log
/etc/samm/api.envSecrets de session du portail et paramètres SMTP de récupération de mot de passe
/etc/samm/secret.keyLa 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éversible Cette 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é.