NGX Ops Hub¶
Le Hub donne une vue globale, en lecture seule, de plusieurs dashboards NGX Ops (un par serveur ou par site), sans les remplacer. Il centralise aussi les sauvegardes de leur configuration.
C'est un conteneur Node.js autonome. Il stocke ses données dans SQLite (sans dépendance supplémentaire) ou, en option, dans PostgreSQL.
navigateur ──HTTPS──► Nginx (TLS) ──► Hub ──HTTPS (pull, lecture seule)──► dashboard A / B / C
│
├─ base : inventaire, jetons chiffrés, historique 30 jours
└─ /data/backups : archives des sauvegardes
Le Hub interroge les dashboards, jamais l'inverse : un dashboard n'a besoin de connaître ni l'adresse ni l'existence du Hub.
Installation¶
cp config/hub.sample.yml config/hub.yml # adapter public_base_url, allow_private_networks…
cp sample.env .env
cp docker-compose.example.yml docker-compose.yml
docker compose run --rm hub node bin/hub-admin.js generate-key # coller la valeur dans .env : HUB_SECRET_KEY=
docker compose up -d --build
docker compose logs hub # mot de passe du compte « admin », affiché une seule fois
Au premier démarrage, le Hub crée le compte admin avec un mot de passe aléatoire écrit dans les journaux du conteneur. À la première connexion :
- changement de mot de passe obligatoire ;
- enrôlement MFA par QR code (obligatoire par défaut) ;
- ajout d'une première instance.
Protéger les journaux de premier démarrage
Le mot de passe initial n'apparaît qu'une fois, mais si vos journaux Docker sont collectés ailleurs, purgez ou protégez ceux du premier démarrage.
Mot de passe initial perdu : docker compose exec hub node bin/hub-admin.js set-password admin --must-change. Pour imposer le mot de passe initial, utiliser HUB_BOOTSTRAP_ADMIN_PASSWORD ; security.bootstrap_admin: false désactive la création automatique (créer alors un compte avec create-user).
Clé maîtresse
HUB_SECRET_KEY (32 octets, en hexadécimal sur 64 caractères ou en base64) chiffre les jetons d'instances et les secrets MFA. Sauvegardez-la avec le volume /data : sans elle, ces données sont indéchiffrables. Elle peut aussi être fournie par HUB_SECRET_KEY_FILE (secret Docker).
Placez Nginx devant le Hub (un exemple, nginx/hub.conf.example, est fourni) avant de l'exposer. Le port du Hub est lié à 127.0.0.1.
Brancher un dashboard¶
- Dans le Hub, Ajouter une instance (nom et URL HTTPS) : le Hub affiche une seule fois un jeton et son empreinte SHA-256.
- Sur le dashboard, renseigner
HUB_TOKEN_SHA256=<empreinte>puis redémarrer. Il n'y a rien d'autre à installer. - Au cycle suivant (60 secondes au plus), l'instance passe « En ligne ».
Rotation du jeton : Modifier → Renouveler le jeton. Placer les deux empreintes, séparées par une virgule, côté dashboard le temps de la bascule.
Fonctionnement de la collecte : interrogation toutes les 60 secondes (8 en parallèle, délai de 5 secondes), instance « hors ligne » après 3 échecs consécutifs, historique conservé 30 jours.
Ce que le Hub affiche¶
- Vue d'ensemble et instances : état de chaque dashboard et historique.
- Alertes : globales, avec un onglet par instance.
- Virtual hosts : tous les vhosts de toutes les instances.
- Onglets de module sur la page d'une instance (trafic, sécurité, supervision, rapports…), chacun avec « Données brutes » pour voir exactement ce que le dashboard envoie. Un module absent est simplement masqué ; une partie en erreur est signalée, jamais comptée comme zéro. Les modules se règlent dans le bloc
modules:dehub.yml. - Indicateurs (administrateur) : une ligne par IP avec toutes les sources qui la connaissent.
- Journaux et Explorateur si le log store est branché (voir plus bas).
Adresses IP de visiteurs
Ce sont des données personnelles. Elles ne sont exposées que si le dashboard a expose_ips et que le Hub a modules.indicators.enabled: true. Elles ne sont visibles que des administrateurs et ne sont jamais journalisées.
Consulter le log store depuis le Hub¶
Désactivé par défaut. Pour l'activer, dans hub.yml : logstore.enabled: true et logstore.url: https://…. Le jeton read global (sans instance_id) du log store se place dans HUB_LOGSTORE_TOKEN ou HUB_LOGSTORE_TOKEN_FILE, jamais dans hub.yml.
- Onglet Journaux : visites par code de statut, sécurité, blocages et tops (sites, pays, règles, types de clients, sources), de 24 heures à 31 jours, par instance. Aucune IP, aucun chemin, aucun User-Agent ni journal brut n'est relayé par cette page.
- Corrélation par IP (option
logstore.indicators.enabled) : fusionne, dans les Indicateurs, l'activité par IP du log store. Une campagne probable est une IP vue par au moins 2 instances ou par au moins 3 types de signaux. - Explorateur (option
logstore.explorer.enabled, en plus de ce qui précède) : recherche de journaux bruts multi-instances, fiche IP, top des attaques et des sources, campagnes. Il manipule des données personnelles : réservé aux administrateurs, avec limitation de débit, sans aucun stockage dans le Hub. Le mode des IP du log store (clair, /24 ou pseudonymisé) est respecté.
Variables¶
Toute clé absente prend sa valeur par défaut. Les variables d'environnement l'emportent sur hub.yml.
| Variable | Clé de hub.yml |
Rôle |
|---|---|---|
HUB_SECRET_KEY / HUB_SECRET_KEY_FILE |
jamais dans le YAML | Clé maîtresse |
HUB_PUBLIC_BASE_URL |
server.public_base_url |
URL publique, affichée dans les URL d'envoi des sauvegardes |
HUB_PORT, HUB_HOST, HUB_DATA_DIR, HUB_COOKIE_SECURE, HUB_LOG_LEVEL, HUB_CONFIG |
server.*, log.level |
Serveur et journaux |
HUB_BOOTSTRAP_ADMIN_PASSWORD |
— | Mot de passe initial imposé (12 caractères minimum) |
HUB_LOGSTORE_ENABLED, HUB_LOGSTORE_URL |
logstore.enabled, logstore.url |
Lecture du log store |
HUB_LOGSTORE_TOKEN / _FILE |
jamais dans le YAML | Jeton read du log store |
HUB_DB_DRIVER, HUB_DB_HOST, HUB_DB_PORT, HUB_DB_NAME, HUB_DB_USER |
storage.* |
PostgreSQL |
HUB_DB_PASSWORD / _FILE |
jamais dans le YAML | Mot de passe PostgreSQL |
Sécurité¶
- Le Hub n'envoie qu'un
GETaux dashboards, qui n'exposent que des compteurs et des états (aucun secret, aucune IP de visiteur). - Jetons d'instance de 256 bits, chiffrés (AES-256-GCM) dans la base ; le dashboard ne garde que l'empreinte SHA-256.
- Protection contre les requêtes vers des destinations internes (SSRF) : HTTPS imposé, DNS validé à chaque connexion, adresses de métadonnées cloud toujours bloquées, réseaux privés autorisés seulement avec
allow_private_networksouallowed_cidrs, aucune redirection suivie, certificat toujours vérifié (autorité interne avecextra_ca_file). - Authentification : mots de passe hachés, verrouillage après 5 échecs (15 minutes), TOTP avec anti-rejeu, cookie
HttpOnly,Secure,SameSite=Strict, jeton CSRF, CSP stricte. - Journal d'audit des connexions, modifications et rotations, conservé 365 jours.
- Conteneur non-root, système de fichiers en lecture seule, capacités retirées.
À prévoir côté infrastructure : restreindre l'accès au vhost Nginx (VPN ou liste d'adresses autorisées) et ne laisser au Hub que la sortie vers les dashboards.
Langue¶
Un sélecteur FR / EN dans l'en-tête mémorise le choix par navigateur ; ui.default_language règle la valeur par défaut.