Connecter GLPI à Persyst : API, tickets et accès
Préparer l’API GLPI, connecter un compte technique et partager les tickets par entité et groupe depuis votre IA.
Persyst permet aux membres autorisés de consulter les tickets GLPI depuis ChatGPT, Claude ou un assistant compatible MCP. Un administrateur branche un compte technique commun et définit les périmètres et les outils accessibles à chaque bénéficiaire.
Le connecteur consulte GLPI 10 et 11 via l’API historique REST V1, en lecture seule. Il ne crée ni ne modifie de ticket et ne télécharge pas les pièces jointes. La connexion seule ne partage aucun ticket.
Préparer GLPI
Faites préparer ces éléments par la personne qui administre GLPI :
- Dans Configuration → Générale → API, activer l’API historique REST et l’authentification par jeton externe. Sur GLPI 11, il s’agit de la V1, pas de l’API V2 OAuth.
- Créer un client API dédié à Persyst et relever son App-Token. Si une restriction d’adresses IP est configurée, autoriser les adresses de sortie du déploiement Persyst auprès de son exploitant.
- Préparer un compte technique actif, avec un profil dédié à la lecture et les seules entités et données nécessaires. Récupérer son jeton API utilisateur depuis ses préférences personnelles ou sa fiche utilisateur, selon les droits disponibles.
- Relever le fuseau horaire configuré dans GLPI, par exemple
Europe/ParisouUTC.
Le compte et son profil GLPI limitent les données lisibles. Les droits Persyst définissent ensuite ce que chaque membre peut consulter avec cette connexion commune ; les lectures ne prennent pas l’identité GLPI personnelle du membre.
Références de l’éditeur : configuration de l’API et API historique REST V1.
Connecter le compte dans Persyst
- En tant qu’administrateur d’organisation, ouvrir Sources de données → Ajouter une source → GLPI.
- Renseigner l’URL HTTPS de l’instance, par exemple
https://glpi.example.org/support, le nom de la connexion, le fuseau et les deux jetons. Utiliser l’URL de l’instance ; Persyst gère le cheminapirest.php. - Cliquer sur Tester la connexion. Si plusieurs profils sont disponibles, sélectionner explicitement le profil de lecture, puis relancer le test pour vérifier les entités accessibles.
- Cliquer sur Connecter GLPI, puis choisir les périmètres à partager.
Les jetons sont chiffrés côté serveur. Saisissez-les uniquement dans le formulaire Persyst, jamais dans une conversation avec votre assistant. L’accès nécessite une URL HTTPS joignable depuis Persyst. Une instance sur réseau privé demande une configuration explicite de l’exploitant Persyst ; son URL seule ne suffit pas.
Choisir les périmètres et les accès
Un périmètre correspond à une entité précise, avec l’un de ces modes :
| Mode | Tickets inclus |
|---|---|
| Tickets assignés aux groupes sélectionnés | Tickets de cette entité assignés à au moins un des groupes choisis |
| Tous les tickets de cette entité, y compris non assignés | Tickets de cette entité que le compte technique peut lire |
Sélectionner l’entité, le mode et les groupes éventuels, nommer le périmètre, puis cliquer sur Ajouter un périmètre et Terminer. Les sous-entités et nouveaux groupes ne sont pas ajoutés automatiquement. Un groupe demandeur ou observateur n’est pas un groupe assigné.
Dans Gestion des accès, accorder ensuite les périmètres et les outils aux personnes, équipes ou clients concernés. Ajouter un périmètre ne crée aucun accès à lui seul. Le guide Membres et accès détaille cette étape.
Choisir les outils autorisés
| Outil | Usage |
|---|---|
list_glpi_sources | Identifier les périmètres et leurs identifiants Persyst autorisés |
search_glpi_tickets | Rechercher et filtrer les tickets dans ces périmètres |
read_glpi_ticket | Lire le contenu d’un ticket autorisé |
read_glpi_ticket_timeline | Lire les suivis et tâches publics, ainsi que les solutions accessibles |
read_glpi_ticket_private_timeline | Lire les suivis et tâches privés avec une autorisation distincte |
get_glpi_ticket_stats | Compter et répartir les tickets sur les résultats couverts |
La chronologie privée est désactivée par défaut. Elle nécessite une activation et un octroi explicites dans Persyst, ainsi que les droits correspondants du compte technique dans GLPI. Accorder la chronologie publique ne donne pas accès aux notes privées.
Poser une question depuis votre assistant
Après avoir connecté votre assistant, commencez par une question sur un périmètre accordé :
Dans GLPI, retrouve les tickets prioritaires encore ouverts du groupe Réseau sur les sept derniers jours. Donne leur référence et leur statut, puis résume le ticket que je choisirai.
L’assistant commence par list_glpi_sources, puis utilise les identifiants Persyst retournés pour rechercher et lire. Ils sont distincts des identifiants d’entité ou de ticket GLPI. Les recherches acceptent notamment le texte, les statuts, la priorité, les groupes assignés et une période avec fuseau horaire.
Une recherche renvoie au plus 50 tickets par page. Si un curseur de continuation est présent, poursuivre les pages nécessaires. Une réponse marquée partial, truncated ou une statistique avec exact: false ne constitue pas un total exhaustif. Une lecture longue peut aussi nécessiter une continuation. Le connecteur ne donne pas accès à un inventaire complet des équipements, aux pièces jointes ou à une API libre.
Vérifier et maintenir la connexion
- Vérifier un ticket connu avec un membre autorisé, puis vérifier qu’un membre sans accès ne voit pas le périmètre. Les appels d’outils sont tracés dans Persyst.
- Si aucun ticket n’apparaît, contrôler le profil et l’entité du compte GLPI, le mode du périmètre, les groupes assignés, puis l’octroi du périmètre et de l’outil dans Persyst.
- Si le test échoue, vérifier l’API historique, les deux jetons, le profil, le certificat HTTPS et les restrictions réseau ou IP.
- Pour renouveler les jetons, ouvrir Connexion de la source → Remplacer les jetons avec le même compte et le même profil. Les périmètres et accès sont conservés ; les secrets ne sont pas réaffichés.
- Pour changer d’instance, de compte, de profil ou de fuseau horaire, créer une nouvelle connexion, réattribuer ses accès puis retirer l’ancienne.