Portal FR - CyberMind-FR/secubox-deb GitHub Wiki

Portal — page d'entrée et de session 🟠

EN | FR | 🟠 AUTH | la porte d'entrée de la box : services, session, protection

À quoi ça sert. secubox-portal fournit la connexion à la box et la page /portal/ : une vue en lecture seule des services, de l'identité et des sessions de la personne connectée, de l'état de la protection et des certificats. Elle ne décide de rien : elle affiche.

  • Paquet : secubox-portal · page /portal/ · API /api/v1/portal/ · configuration /etc/secubox/portal.toml
  • Les comptes sont lus dans /etc/secubox/users.json (même magasin que secubox-auth).

La page /portal/ — Services et session

Lecture seule. Sans session, la page affiche « Aucune mesure : session requise » avec un lien vers le formulaire de connexion ; une mesure absente s'affiche « — », jamais un zéro inventé. ?embed=1 l'intègre (elle annonce sa hauteur), ?demo=1 montre des données fictives sous un bandeau orange.

Bloc Contenu
Tuiles score de santé et durée de fonctionnement, services en ligne (WAF, HAProxy, nginx, système), sessions actives et comptes, connexions 24 h, bans actifs, certificats valides et prochain renouvellement
Services les quatre services suivis par le relevé de santé ; un lien n'est proposé que s'il existe
Accès rapides liens vers les principaux panneaux, ressources du système
Session et identité qui est connecté (/portal/verify)
Sessions ouvertes sessions d'administrateur
Protection activité du WAF aujourd'hui
Certificats synthèse du moniteur de certificats, voir Certificates-FR
Cookies · RGPD synthèse de l'audit des cookies
Sites les plus visités / réseaux d'origine 60 dernières minutes, par hôte et par AS
Derniers événements les 5 derniers événements du portail

Un champ de recherche filtre les services, les liens et les sites.

API

Méthode Chemin Garde Rôle
GET /health aucune vivacité
GET /status lecture version, nombre de sessions et de comptes
GET /summary lecture comptes, connexions 24 h, événements récents, webhooks
GET /verify lecture validité et identité de la session en cours
GET /theme, /branding lecture aspect de la page de connexion
POST /login, /logout, /recover connexion ouvrir et fermer une session ; récupération du mot de passe
GET/DELETE /sessions, /sessions/{user} session lister ou fermer des sessions
GET/POST/DELETE /users, /users/create, /users/{user}, /users/change-password session comptes
GET /history, /stats session événements et compteurs
GET/POST/DELETE /webhooks session notifications

Consigne d'exploitation — login.html est un chemin partagé

Le formulaire de connexion est le fichier /usr/share/secubox/www/login.html. Il est livré par secubox-portal seul (Replaces/Breaks: secubox-hub (<< 1.9.6~)). Il gère l'étape du mot de passe, le défi TOTP des comptes inscrits, l'inscription TOTP forcée de l'administrateur, le bon d'élévation d'une minute remis par le gestionnaire d'identité (#elevation=…) et ?deconnexion=1.

Pourquoi c'est important. Une ancienne version de secubox-hub livrait sa propre page login.html d'amorçage (sans TOTP) au même chemin. La réinstaller remplaçait la page TOTP : l'administrateur ne pouvait plus finir sa connexion, sessions.json restait vide et, comme les sessions échouent fermées, tous les modules rejetaient toutes les sessions — un verrouillage de toute la box.

  • Ne jamais livrer login.html depuis un autre paquet, ni en copier une ancienne à la main.
  • Après une réinstallation ou un retour arrière de secubox-hub ou secubox-portal, vérifier que le fichier est celui du portail (il doit contenir l'étape TOTP).
  • En cas de verrouillage, restaurer le login.html du paquet secubox-portal puis se reconnecter pour recréer les sessions.
  • La refonte de la page /portal/ (portail 2.4.0) ne touche pas à login.html.

Voir aussi