L exploitant : Icinga Web 2 permet nativement de gerer des comptes ; ce genre d intervention n est pertinente que pour integrer Icinga a Keycloak chez les tenants. Le mode locale posait un auth_basic nginx devant le backend external. Ca marchait, et ca reinventait une page de connexion devant une application qui en a une — en privant l exploitant de la gestion des comptes dans l interface. Un vestibule n a de sens que devant une application qui ne sait pas s authentifier ; le GUI de Set-OPS est dans ce cas, Icinga Web 2 non. Mode db : backend natif, groupes natifs, base a elle (les tables du moteur sont reecrites par ses migrations). Le moteur pose UN compte d amorcage et ne l ecrase jamais. D-66 redevient applicable sans annuaire, les groupes vivant en base. Deux pieges du renommage : une garde ecrite en negation a cesse de garder, et le bloc de la base pose apres le rendu des .ini a produit un echec CENSURE par no_log. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Crgis8CxCWkAGFA1ecBz3q |
||
|---|---|---|
| .. | ||
| defaults | ||
| handlers | ||
| meta | ||
| tasks | ||
| templates | ||
| README.md | ||
serveur_icingaweb2
Frontal de supervision : Icinga Web 2 + module IcingaDB + module Business Process,
co-localisé avec le moteur serveur_icinga. Application PHP servie par un nginx local
et php-fpm ; l'edge nginx proxifie par nom.
Rôle
- Résout sa base IcingaDB via
resoudre_base(même consommateur que le moteur) et l'annuaire viaresoudre_annuaire— aucun câblage en dur. - Installe
icingadb-web(qui tireicingaweb2), le module BPM, PHP 8.4 (fpm, pgsql, ldap, intl, gd, curl, xml, mbstring) et nginx. - Déploie la configuration
.ini(ressources, authentification, rôles, IcingaDB, Redis), active les modules, déploie le vhost nginx local et retire le site par défaut. - Processus métier (BPM) : peut en semer en IaC (
serveur_icingaweb2_bpm_processes), tout en laissant le répertoire éditable depuis l'UI.
Deux modes d'authentification
serveur_icingaweb2_auth |
Fonctionnement |
|---|---|
ldap (défaut) |
Connexion directe à OpenLDAP (LDAPS) — Icinga Web 2 n'a pas d'OIDC natif |
external |
L'utilisateur est fourni par une passerelle SSO devant (serveur_oauth2_proxy → Keycloak) ; nginx pose REMOTE_USER |
En mode external, restreindre l'écoute de nginx à la boucle locale
(serveur_icingaweb2_nginx_bind: "127.0.0.1:") — sinon l'application reste joignable en
contournant la passerelle.
Variables principales
| Variable | Défaut | Rôle |
|---|---|---|
serveur_icingaweb2_hostname |
icinga.{{ domaine_interne }} |
Nom servi |
serveur_icingaweb2_http_port |
8080 |
nginx local (l'edge proxifie ici) |
serveur_icingaweb2_auth |
ldap |
Backend d'authentification |
serveur_icingaweb2_remote_user |
$remote_user |
Variable nginx source de REMOTE_USER |
serveur_icingaweb2_nginx_bind |
"" |
"127.0.0.1:" derrière une passerelle |
serveur_icingaweb2_admins |
testmail |
uid recevant le rôle Administrateur (liste séparée par virgules) |
serveur_icingaweb2_redis_port |
6380 |
Redis IcingaDB local |
serveur_icingaweb2_modules |
[icingadb, businessprocess] |
Modules activés |
serveur_icingaweb2_bpm_processes |
{} |
Processus métier semés en IaC |
Flux (meta/flux.yml)
8080/tcp entrant depuis l'edge · 5432/tcp → PostgreSQL (IcingaDB, verify-full) ·
636/tcp → OpenLDAP. Icinga 2 (API 5665) et le Redis IcingaDB (6380) sont
co-localisés : consommés en localhost, donc absents du registre des flux.
Notes / limites
serveur_icingaweb2_adminsdoit désigner de vrais uid de l'annuaire — sinon plus personne n'est administrateur de l'interface.- Les versions PHP sont épinglées à 8.4 (Debian 13) dans les noms de paquets, de service et de socket : une montée de Debian demandera de les changer ensemble.
- Le Redis IcingaDB (
6380) est distinct du groupeserveur_redis(cache applicatif) et du Redis deserveur_rspamd. - Semer un processus BPM ici le met sous gestion Ansible : il sera réécrit à chaque passage, même modifié dans l'UI. Par défaut, le rôle n'en sème aucun.
Prérequis
serveur_icingaweb2 requiert serveur_icinga, serveur_postgresql, serveur_openldap actifs(docs/dependances-groupes.yml).client_pki(LDAPS + PostgreSQLverify-full). Couche apps.