Chez EO Data Center, l’équipe d’exploitation travaillait déjà avec deux outils solides : Zabbix pour la supervision et GLPI pour les tickets et l’inventaire. Le problème n’était pas les outils, c’était le reste. Chaque outil avait ses propres comptes, ses propres droits, et un client qui signalait une panne sur une VM devait décrire lui-même ce que Zabbix savait déjà.
Avec EO Orbit, l’objectif était simple à énoncer : une seule connexion, et les données des deux outils au même endroit. Voici comment nous l’avons fait.
Zabbix : un jeton d’API, pas un mot de passe
Depuis la version 5.4, Zabbix permet de créer des jetons d’API rattachés à un utilisateur, avec une date d’expiration. On n’appelle plus user.login, on envoie le jeton à chaque requête. En version 7, il passe dans l’en-tête Authorization: Bearer.
Nous avons créé dans Zabbix un utilisateur de service, avec un rôle limité à la lecture sur les groupes d’hôtes du cloud. Son jeton est une variable d’environnement du service, jamais exposée au navigateur.
Un seul service parle à Zabbix : EO Watch, écrit en NestJS. Il expose quelques routes HTTP pour le débogage, et surtout des messages RabbitMQ que la passerelle consomme (watch.get.hosts, watch.get.problems…). Il est en lecture seule par construction : le client JSON-RPC refuse toute méthode qui ne se termine pas par .get.
const ALLOWED = /^[a-z]+\.get$/;
async call<T>(method: string, params: object): Promise<T> {
if (!ALLOWED.test(method)) throw new ForbiddenException(`${method} is not allowed`);
const res = await this.http.post('/api_jsonrpc.php',
{ jsonrpc: '2.0', method, params, id: Date.now() },
{ headers: { Authorization: `Bearer ${this.token}` } });
if (res.data.error) throw mapZabbixError(res.data.error);
return res.data.result;
}
Zabbix répond avec un code HTTP 200 même quand la requête échoue, l’erreur est dans le corps. Nous la convertissons en vraie erreur (401, 404, 502) avant qu’elle ne remonte, sinon la passerelle affiche un écran vide en croyant que tout va bien.
Chaque client a son groupe d’hôtes dans Zabbix. L’utilisateur ne choisit jamais le groupe : la passerelle le déduit de sa session et ajoute groupids à la requête. Un client ne peut donc pas demander les hôtes d’un autre, même en modifiant l’appel.
GLPI : App-Token, jeton utilisateur et session
L’API REST de GLPI fonctionne en deux temps. On envoie un App-Token (propre à l’application cliente) et un jeton utilisateur à initSession, qui renvoie un Session-Token à joindre à chaque appel suivant.
Créer une session à chaque requête est lent et remplit le serveur de sessions inutiles. Nous gardons donc la session en mémoire, nous la renouvelons quand GLPI répond 401, et nous appelons killSession à l’arrêt du service.
Le vrai gain est sur les tickets. Quand un client ouvre un ticket depuis une VM dans Orbit, le service ajoute au ticket l’inventaire de la machine et le dernier problème connu par Zabbix. Le technicien n’a plus à demander « quelle machine ? » ni « depuis quand ? ».
Un seul utilisateur pour trois systèmes
Orbit est la source de vérité pour l’identité. Les utilisateurs n’ont pas de compte Zabbix, et ils ne se connectent jamais à GLPI.
- Zabbix est lu uniquement par le compte de service. Les droits viennent du locataire de l’utilisateur, pas d’un compte Zabbix personnel.
- GLPI a besoin d’un demandeur pour chaque ticket. Nous gardons une table de correspondance entre l’utilisateur Orbit et son identifiant GLPI. Au premier ticket, si l’utilisateur n’existe pas encore dans GLPI, le service le crée par l’API avec la même adresse e-mail et enregistre le lien. Les tickets suivants sont créés avec
_users_id_requesterrenseigné, au nom de la bonne personne.
Conséquence pratique : désactiver un compte dans Orbit coupe l’accès à tout, puisque les deux outils ne sont jamais joints directement. Les techniciens, eux, continuent d’utiliser l’interface de GLPI quand ils en ont besoin.
Ce que je garderais pour le prochain projet
- Un service dédié par outil externe. Quand Zabbix change un détail de son API, un seul service bouge.
- Des jetons avec une date d’expiration, et un rappel dans le calendrier pour les renouveler.
- Une liste blanche des méthodes autorisées plutôt qu’une liste noire.
- Des journaux qui tracent chaque appel sans jamais écrire la valeur d’un jeton.
- Des tests qui simulent les réponses JSON-RPC, y compris les erreurs renvoyées avec un code 200.