Intégrations¶

Utilisez la page Intégrations pour connecter KANAP à des outils tiers qui complètent les données que vous gérez déjà dans la plateforme. La connexion principale est votre centre de services GLPI. Cette connexion remplit deux fonctions à la fois : elle permet à Plaid (le chat interactif) de trouver et d'importer des tickets dans KANAP sous forme de tâches, et elle alimente les Agents IA qui surveillent votre centre de services et proposent ou réalisent le travail sur les tickets. La page héberge également la connexion Inventaire Netbox, qui n'a rien à voir avec l'IA. De nouvelles intégrations viendront s'ajouter ici au fil du temps.

Où la trouver¶

Espace de travail : Administration
Chemin : Administration → Intégrations
Route : /admin/integrations
Autorisation : ai_settings:admin ou infrastructure:admin. Chaque carte a son exigence propre : les connexions GLPI et supervision demandent ai_settings:admin, la connexion Netbox demande infrastructure:admin. Vous ne voyez que les cartes que vous avez le droit de configurer.
Indicateur de fonctionnalité : les cartes GLPI et supervision partagent la même surface ai_settings que la page de paramètres Plaid. Lorsque cette surface est désactivée, elles sont masquées. La carte Netbox n'a pas d'indicateur de fonctionnalité et reste disponible dans l'édition cloud comme dans l'édition on-premise.

Les identifiants que vous saisissez ici sont ceux que Plaid comme n'importe quel Agent IA utilisent pour atteindre GLPI — vous configurez la connexion une seule fois, à un seul endroit.

Intégration GLPI¶

GLPI est un outil populaire et open source de gestion des services informatiques. Cette page stocke les identifiants que KANAP utilise pour atteindre votre instance GLPI. Ce que KANAP fait de cette connexion dépend de la fonctionnalité que vous y raccordez.

Comment ça fonctionne¶

La connexion alimente deux workflows que vous activez et pilotez séparément.

1. Import via le chat Plaid (aperçu et approbation). Un utilisateur final demande à Plaid quelque chose comme « importe les tickets GLPI ouverts assignés à mon équipe ». Plaid interroge GLPI à l'aide des identifiants que vous configurez ici, renvoie les tickets candidats sous forme d'aperçu dans le chat, et ne crée une tâche par ticket qu'après que l'utilisateur a examiné l'aperçu et cliqué sur Approuver. Rien n'est écrit dans KANAP sans cette approbation explicite ; les administrateurs peuvent donc confier cette fonction aux utilisateurs finaux sans craindre une modification silencieuse des données.

2. Des Agents IA qui surveillent le centre de services. Une fois GLPI connecté ici, un administrateur peut y raccorder un agent Helpdesk et le laisser surveiller les tickets nouveaux et mis à jour, puis proposer le travail — réponses au demandeur, notes internes et mises à jour de la classification, du statut, de l'affectation, des participants et de la clôture/résolution. Chaque modification de l'agent est toujours proposée à votre approbation avant d'être envoyée à GLPI, et des limites de sécurité strictes, des budgets et des contrôles de fraîcheur s'appliquent en permanence. Cette page ne configure aucun comportement d'agent ; elle fournit uniquement la connexion utilisée par les agents.

Utilisé par les Agents IA¶

Après avoir enregistré ici une connexion fonctionnelle, un administrateur configure les agents dans la section Agents IA — voir Agents IA — Vue d'ensemble. Depuis Nouvel agent ou les Paramètres d'un agent existant, il choisit cette connexion GLPI comme centre de services surveillé par l'agent. L'agent la consulte et rédige à partir d'elle, mais par défaut il n'envoie jamais rien de lui-même : chaque réponse, note ou changement de statut proposé passe d'abord par la file d'approbation.

Prérequis¶

Le chat Plaid doit être activé sur votre tenant pour le workflow d'import via le chat. La page affiche une infobulle d'information à côté du titre de la section pour vous rappeler cette dépendance.
Les Agents IA doivent être activés sur l'instance pour le workflow d'agent, et l'agent doit être configuré par une personne disposant du niveau Administrateur des Agents IA (ai_agents:admin).
Une instance GLPI joignable depuis KANAP en HTTPS.
Un Jeton utilisateur pour un compte utilisateur GLPI disposant d'un accès en lecture aux tickets que vous souhaitez exposer.
Un Jeton d'application facultatif si votre instance GLPI exige une authentification au niveau applicatif.
Droits du profil pour les fonctions d'agent — le profil GLPI de ce compte a besoin d'un accès en lecture aux catégories ITIL et aux entités, que les agents utilisent pour leurs filtres de ciblage et pour la classification, ainsi que d'un accès en lecture aux groupes et aux utilisateurs pour qu'un agent puisse acheminer un ticket vers un groupe de techniciens ou vers un technicien nommé. L'acheminement exige également le droit d'attribuer les tickets. Enfin, accordez les droits de mise à jour sur les tickets pour les actions que vous laissez l'agent effectuer : suivis, classification, statut et attribution.

L'intégration se configure tenant par tenant ; les identifiants ci-dessous sont limités à votre tenant et n'en sortent jamais.

Champs¶

Le formulaire de configuration contient :

Activer l'import de tickets GLPI — interrupteur principal de la connexion. Lorsqu'il est désactivé, KANAP n'essaiera pas d'interroger GLPI même si des identifiants sont renseignés — ni les imports Plaid ni les contrôles d'agent n'atteindront votre centre de services.
URL GLPI — l'URL de base de votre instance GLPI, par exemple https://glpi.example.com.
Jeton utilisateur — le jeton d'API personnel du compte GLPI que KANAP utilisera. Les jetons existants sont masqués ; laissez le champ vide lors d'un enregistrement ou d'un test pour conserver la valeur stockée.
Jeton d'application — le jeton d'application GLPI facultatif. Même comportement « laisser vide pour conserver » que pour le jeton utilisateur.

Actions¶

Enregistrer les paramètres — enregistre le formulaire. Les jetons saisis dans le formulaire remplacent ceux qui sont stockés ; les champs de jeton laissés vides conservent la valeur déjà enregistrée.
Tester la connexion — effectue un aller-retour authentifié vers l'URL GLPI à l'aide des valeurs du formulaire (ou, lorsqu'elles sont vides, des valeurs stockées). La bannière de résultat indique la réussite ou l'erreur sous-jacente, ainsi que la latence.

Stockage des secrets¶

Si votre instance KANAP ne dispose pas d'un coffre à secrets configuré, un texte d'aide apparaît sous chaque champ de jeton pour vous avertir que les valeurs ne peuvent pas être conservées. Configurez le stockage des secrets au niveau de l'instance avant de vous appuyer sur cette intégration en production.

Inventaire Netbox¶

Netbox fait référence dans beaucoup d'équipes d'infrastructure : équipements, machines virtuelles, baies, sites, adresses. La carte Inventaire Netbox stocke l'adresse et le jeton d'API que KANAP utilise pour lire cet inventaire et maintenir ses actifs en phase avec lui. Netbox reste la référence pour les équipements qu'il décrit ; KANAP conserve la couche métier autour.

Cette connexion est indépendante des fonctionnalités d'IA. Elle demande infrastructure:admin, fonctionne dans l'édition cloud comme dans l'édition on-premise, et reste disponible quand l'IA est désactivée.

Configurez la connexion ici, puis rendez-vous dans Cartographie SI > Netbox pour choisir ce qui est importé et lancer la synchronisation. La procédure complète, les règles de rapprochement et le tableau de résolution des problèmes figurent sur Synchronisation Netbox.

Conseils¶

Utilisez un compte GLPI dédié : créez un compte de service dans GLPI avec juste assez d'autorisations pour lire les catégories de tickets que vous souhaitez exposer. Cela garde le journal d'audit propre et vous permet de révoquer l'accès sans affecter un utilisateur réel. Si les agents doivent envoyer des réponses et des changements de statut, accordez à ce même compte l'accès en écriture requis par ces actions.
Testez avant d'annoncer : lancez Tester la connexion après chaque modification de l'URL ou des jetons. Le message d'erreur est bien plus exploitable qu'un échec qui apparaît au sein de la conversation de chat d'un utilisateur ou dans un contrôle d'agent bloqué.
Associez les bonnes autorisations : seuls les utilisateurs disposant de ai_chat:reader peuvent demander à Plaid d'importer des tickets. Raccorder un agent à cette connexion nécessite le rôle Agents IA — ai_agents:reader pour consulter un agent, ai_agents:admin pour en configurer un — avec les Agents IA activés sur l'instance. Combinez cela avec un accès basé sur les rôles aux tâches si vous souhaitez limiter qui crée réellement des enregistrements de tâches à partir des imports.
Prévoyez la rotation des jetons : les jetons personnels GLPI peuvent être régénérés. Lorsque vous le faites, enregistrez la nouvelle valeur ici et lancez le test de connexion avant que les utilisateurs — ou les agents — ne sollicitent à nouveau l'intégration.