Table des matières

Configuration du système de ticketing de GLPI

Créer une clé API dans GLPI

Cette documentation vous guide pas à pas pour générer une clé API dans GLPI (Gestionnaire Libre de Parc Informatique).

Connectez-vous à l'interface web de votre instance GLPI avec un compte ayant les droits d'administration.

Activer l'API REST

  1. Dans le menu principal, cliquez sur Configuration → Générale.
  2. Allez dans l’onglet API.
  3. Séléctionner «Oui» pour Activer l’API REST.
  4. Cliquez sur Sauvegarder.

 Activer l'API REST

Générer un jeton d'application (app_token)

Si vous n’avez pas encore d’utilisateur pour l’API :

  1. Dans le menu principal, cliquez sur Configuration → Générale.

  2. Allez dans l’onglet API.

  3. Cliquez sur Ajouter un client de l'API.

     Ajouter une clé API

  4. Donnez un nom au client API

  5. Séléctionner «Oui» pour Actif.

  6. Ajouter l'IP du serveur Esia dans Début de plage d'adresse IPv4 et Fin de plage d'adresse IPv4 pour limiter l'accès.

     Générer une clé API

  7. Cliquez sur Ajouter.

  8. Revenez sur la page précédente (Configuration → Générale → API) et cliquez sur le client API (esia) dans la liste.

     Voir une clé API - Liste

  9. La clé API générée s’affiche : copiez-la et stockez-la en lieu sûr.

     Voir une clé API

Générer un jeton d'API utilisateur (user_token)

  1. Dans le menu principal, cliquez sur Administration → Utilisateurs.

  2. Cliquez sur l'action : Ajouter utilisateur.

     Ajouter un utilisateur

  3. Remplissez les données de l'utilisateur en veillant à bien sélectionner «Oui» pour Actif

    L'habilitation Hotliner est suffisante pour créer les tickets.

     Créer un utilisateur

  4. Cliquez sur Ajouter pour créer l’utilisateur.

  5. Revenez sur la page précédente (Administration → Utilisateurs) et cliquez sur le nouvel utilisateur (esia) dans la liste.

     Voir un utilisateur

  6. En bas de la page, dans Clefs d'accès distant → Jeton d'API, cocher la case Regénérer, puis cliquez sur Sauvegarder.

     Générer un jeton utilisateur

  7. La clé utilisateur générée s’affiche : copiez-la et stockez-la en lieu sûr.

     Voir le jeton utilisateur

Configuration dans Esia

Créer/Modifier le fichier de configuration

En ligne de commande sur le serveur, éditer le fichier /etc/esia/glpi.conf (Une fois que vous aurez terminé avec nano, taper ctrl+x puis y pour sauvegarder le fichier)

copy
nano /etc/esia/glpi.conf

Son contenu doit ressembler à ceci :

/etc/esia/glpi.conf
host="https://monserveurglpi.com/glpi"
app_token="vrFkHRcPTYt4Dt79zD78oPuiGKRYlAJGqsYr9kjv"
user_token="YjJC9qCUHSK8JKY1BSsJ2wDfg8IgBid1c1okKsrM"
user_name="esia"
tpl_title="( %node.group.name ) %node.name:%service.name"

Le fichier contient les paires clés=valeurs suivantes :

Configurer les services pour créer des tickets

La configuration se fait via l'interface web d'Esia. De la même manière que pour configurer des alertes mails. Voir gestion des alertes.

Deux programmes d'alertes permettent d'envoyer des tickets vers GLPI Programmes d'alerte GLPI

Configurer les ticket par service Programmes d'alerte GLPI - configuration Comme pour les autres programmes d'alerte :

  1. Cochez les services pour lesquels vous souhaitez configurer un ticket.

    Vous pouvez configurer les services un par un ou utiliser la section « Actions Groupées » pour paramétrer tous les services sélectionnés en même temps.

  2. Choisissez le programme d'alerte :

    • Ticket GLPI (SEND_TICKET_GLPI)

    • Ticket GLPI & Mail (SEND_TICKET_GLPI_MAIL)

      L'adresse mail de votre utilisateur s'ajoute automatiquement, mais vous pouvez la modifier.

  3. Ensuite, cochez le type d'alerte pour lequel vous désirez être averti.

    • Alerte, Critique, Inconnu ⇒ À la première erreur sur le service, un nouveau ticket est créé dans GLPI. Les changements de statut suivants modifient la priorité (en fonction du type d'erreur) et affiche un message de changement de statut sur le ticket. ⇐ TODO (priorité change ou pas finalement ?)

    • OK ⇒ Considère que l'erreur a été corrigée et que le ticket est terminé. Affiche un message sur le ticket et lorsqu'une prochaine erreur surviendra, un nouveau ticket sera créé.

      Attention Attention : Si le status « OK » n'est pas coché, il n'y aura que des changements de statut de service sur le ticket et jamais de nouveau ticket pour ce service.

    • Acquittement ⇒ À venir (Esia 3.6.0) Préviens dans les messages du ticket que l'erreur a été acquittée ou dés-acquittée.

  4. N'oubliez pas de cliquer sur « Mettre à jour ».

Lorsqu'un nouveau ticket est créé, une note de noeud s'affiche avec le lien vers le ticket Note nouveau ticket

Une autre note s'affiche lorsqu'un ticket est terminé (Il faut que le statut OK soit coché dans la configuration du programme d'alerte) Note fin de ticket