Exploiter Webserver-Front

Webserver-Front (FRONT) est une replique en lecture seule du Webserver que vous placez dans une DMZ ou tout reseau non fiable pour presenter les tableaux de bord et les rapports aux utilisateurs finaux — sans exposer le plan de controle interne, les sondes ni aucun secret. Cette page couvre l’exploitation au quotidien : le deploiement, la declaration du lien de replication, le demarrage et la verification de la fraicheur des donnees.

Dans cette page, ADMIN designe le Webserver normal (licencie, interne) et FRONT la replique en lecture seule. Pour l’architecture et le modele de confiance derriere FRONT, voir Webserver-Front (replique DMZ).

Quand deployer une replique FRONT

Deployez une replique FRONT lorsque vous devez publier des tableaux de bord a des personnes qui ne doivent pas atteindre le Webserver interne :

  • Pages de statut publiques ou destinees a des partenaires.
  • Tableaux de bord integres dans un portail d’entreprise situe hors de votre reseau d’administration.
  • Tout public sur un segment reseau auquel vous ne faites pas pleinement confiance.
FRONT est en lecture seule. Les utilisateurs finaux peuvent parcourir les applications, tableaux de bord, l’historique, les SLA et les cartes de decouverte, mais ne peuvent rien ajouter, modifier ou supprimer, ne peuvent pas pousser de configuration vers les composants, ni atteindre les sondes. Toute l’administration reste sur ADMIN.

Prerequis

Avant de commencer, assurez-vous de disposer de :

Prerequis Remarques
Un Webserver ADMIN licencie FRONT est alimente entierement par ADMIN ; FRONT lui-meme ne necessite aucune licence.
Un hote DMZ pour FRONT Linux ou Windows, joignable par vos utilisateurs finaux sur le port WEB.
Une route reseau ADMIN → FRONT ADMIN initie et pousse. FRONT ne se connecte jamais vers ADMIN.
Le materiel de replication Cle partagee et certificats, provisionnes hors bande (voir Configuration).

Deployer FRONT sur l’hote DMZ

  1. Placez le binaire FRONT et ses ressources d’interface sur l’hote DMZ. L’interface statique est servie depuis le disque dans le dossier ./web-front/ a cote du binaire (elle n’est pas embarquee) ; l’hote a donc besoin a la fois de l’executable et de ce dossier.

  2. Creez le fichier de configuration webserver.json a cote du binaire, puis installez-le comme service ou demon exactement comme un Webserver normal.

Linux :


# installer et demarrer le demon
./webserver_front install
./webserver_front start

Windows :


webserver_front.exe install
webserver_front.exe start

Vous pouvez l’executer au premier plan pour un premier test avec ./webserver_front run (Linux) ou webserver_front.exe run (Windows).

Configurer le lien de replication

La replication utilise deux canaux distincts ; deux reglages decrivent donc l’hote FRONT :

Reglage Signification
Point de terminaison de replication Le host:port du recepteur protege de FRONT. ADMIN y pousse les lots chiffres.
URL publique L’URL navigateur de l’interface web de FRONT (par exemple https://front.example.com:9090). Utilisee uniquement pour construire les liens d’integration qui pointent vers FRONT.

Le materiel cryptographique lui-meme (la cle partagee et les certificats) est provisionne hors bande dans webserver.json sur les deux hotes. Il ne transite jamais par le canal de replication et n’est jamais saisi dans l’interface des reglages. La liste exacte des champs figure sur la page du composant.

Declarer FRONT depuis la page Reglages d’ADMIN

Une fois le materiel de cle en place sur les deux hotes, activez et ciblez la replication depuis ADMIN :

  1. Connectez-vous a ADMIN en tant qu’administrateur et ouvrez la page Reglages.
  2. Dans la section replication Webserver-Front, activez la replication, puis renseignez :
    • le point de terminaison de replication (recepteur FRONT host:port),
    • l'URL publique de l’interface web FRONT,
    • l'intervalle de reconciliation (frequence a laquelle ADMIN pousse un instantane complet — 5 minutes par defaut),
    • la periode de grace facultative (voir ci-dessous).
  3. Cliquez sur enregistrer.
Page Reglages d'ADMIN : configuration de la replication Webserver-Front

Note :

L’activation ou la desactivation de la replication s’applique immediatement a l’ADMIN en cours d’execution, mais l’effet complet (demarrage ou arret propre du sous-systeme de push) est garanti apres le prochain redemarrage d’ADMIN. Le materiel de cle de replication n’est relu qu’au demarrage — modifiez-le sur les deux hotes et redemarrez les deux.

Verifier que FRONT est actif et a jour

  1. Naviguez vers l’URL publique de FRONT et connectez-vous avec un compte utilisateur normal. Les comptes utilisateurs (et leurs empreintes de mot de passe bcrypt) sont repliques depuis ADMIN ; les memes identifiants fonctionnent donc.
  2. Verifiez que les tableaux de bord s’affichent et que l'indicateur de fraicheur montre des donnees recentes. FRONT estampille chaque lot avec la cadence de reconciliation et signale le flux comme obsolete si aucun lot n’est arrive dans un multiple de cet intervalle.
Tableau de bord en lecture seule de Webserver-Front avec indicateur de fraicheur de replication

Ce que voient les utilisateurs finaux sur FRONT

FRONT affiche les memes tableaux de bord qu’ADMIN, avec deux differences que les exploitants doivent anticiper :

  • Lecture seule partout. Les actions d’administration sont masquees ou desactivees. Aucun chemin vers les sondes, les integrateurs ou les reglages.
  • Certains types de moniteurs en direct apparaissent en UNKNOWN. Le Webserver recupere le statut des moniteurs url, api, tcp, udp, ping, nslookup, db et sys en direct depuis la sonde a chaque requete. Ces types n’ont aucun statut stocke a repliquer ; ils apparaissent donc en UNKNOWN dans le graphe de dependances applicatives de FRONT. Le statut des equipements et de la decouverte est stocke et replique, et s’affiche normalement.
Graphe de dependances applicatives FRONT montrant les types de moniteurs en direct en UNKNOWN

Periode de grace du statut

Par defaut, FRONT affiche un changement de statut des qu’il est replique. Vous pouvez configurer une periode de grace facultative afin qu’un nouveau statut applicatif OK → non-OK soit retenu vis-a-vis des utilisateurs finaux de FRONT pendant quelques minutes apres la transition. Cela donne a l’equipe d’exploitation une courte fenetre pour reagir avant qu’une panne ne devienne visible sur un tableau de bord public.

La periode de grace n’affecte que ce que FRONT montre. Les vues temps reel propres a ADMIN, l’historique des statuts, les calculs de SLA et les alertes ne sont jamais retardes.

Exploitation au quotidien

Tache Comment
Mettre a jour l’interface FRONT (logos, ajustements de mise en page) Modifiez les fichiers sous ./web-front/ sur l’hote FRONT et rafraichissez le navigateur — aucune recompilation necessaire.
Redemarrer FRONT Utilisez les commandes service/demon (stop puis start). FRONT relit sa configuration et son materiel de cle au demarrage.
Renouveler les cles de replication Remplacez le materiel de cle sur les deux hotes hors bande, puis redemarrez les deux.
Verifier la sante du flux Surveillez l’indicateur de fraicheur sur FRONT et le statut de push sur ADMIN.

Depannage

Note :

Le flux apparait comme obsolete. ADMIN ne peut pas joindre FRONT, ou les push sont rejetes. Verifiez que la connectivite ADMIN → FRONT sur le point de terminaison de replication est ouverte, que le materiel de cle correspond sur les deux hotes et que FRONT n’a journalise aucun avertissement de demarrage signalant un materiel de replication manquant. Les push echoues sont mis en tampon sur disque cote ADMIN et reessayes automatiquement ; une breve panne se resorbe donc d’elle-meme des le retour de la connectivite.
  • FRONT journalise un avertissement marquant au demarrage. Le materiel de replication est manquant ou incomplet sur FRONT. Tant que ce n’est pas corrige, FRONT rejette chaque lot entrant et les tableaux de bord ne se mettent jamais a jour.
  • Tout apparait en UNKNOWN. Attendu pour les types de moniteurs en direct listes ci-dessus ; ce n’est pas une erreur. Le statut des equipements et de la decouverte doit toujours s’afficher normalement.
  • Un utilisateur ne peut pas se connecter sur FRONT. Les enregistrements utilisateurs se repliquent depuis ADMIN a chaque reconciliation. Verifiez que le compte existe sur ADMIN et qu’au moins une reconciliation a reussi depuis sa creation.

See also

Traductions