Portal FR

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

• Certificates-FR — la page /certs/ et la chaîne de renouvellement
• NAC-FR — qui est sur le réseau
• WAF-FR — la protection affichée dans le bloc Protection
• Admin-Panels-Gallery-FR — le style commun Aurora des panneaux
• Architecture — la pile à six modules