GLPI
Configurez le connecteur GLPI API pour récupérer les informations via l'API GLPI
Ce document décrit la procédure pour configurer le connecteur GLPI API afin de récupérer les informations via l'API GLPI.
Objectif
Le but de ce connecteur est de fournir une méthode pour configurer l'API GLPI afin de récupérer les informations nécessaires en utilisant l'authentification par User Token et App-Token.
Prérequis
- Accès administrateur à GLPI
- API REST GLPI activée
Procédure
Activer l'API
- Accédez à la configuration de l'API :
- Naviguez vers Setup > General > API.
- Activez les options requises :
- Activez "External token" pour autoriser l'authentification par jeton externe.
- Activez "Credentials" pour autoriser l'authentification par nom d'utilisateur/mot de passe.
- Cliquez sur Save.
Créer un client API
- Accédez à la configuration du client API :
- Naviguez vers Setup > General > API.
- Ajoutez un client API :
- Cliquez sur Add API Client.
- Configurez le client API :
- Donnez un nom au client (ex: "OverView Integration").
- Définissez "Active" sur "YES".
- Configurez les restrictions IP (optionnel).
- Cliquez sur Add.
- Récupérez l'App-Token :
- L'App-Token s'affichera après la création.
- Copiez et stockez l'App-Token de manière sécurisée (sauvegardez-le immédiatement).
Obtenir le User-Token
- Générez le User API Token :
- Connectez-vous à GLPI avec l'utilisateur qui authentifiera les requêtes API.
- Cliquez sur votre User Profile (en haut à droite).
- Naviguez vers la section Remote access keys.
- Cliquez sur Regenerate pour générer un nouveau jeton API.
- Copiez et stockez le User-Token de manière sécurisée.
Permissions requises
Dans GLPI, accédez à Administration > Profils, puis sélectionnez le profil associé à l'utilisateur API. Le profil doit disposer du droit Lecture sur les éléments suivants :
- Administration > Agent (section Inventaire) : pour collecter les données des agents
- Configuration > Composants : pour collecter les données des processeurs
- Administration > Utilisateurs : pour collecter les données des utilisateurs et des emails
- Parc > Ordinateurs : pour collecter les devices et leurs antivirus
- Parc > Moniteurs : pour collecter les moniteurs
- Parc > Téléphones : pour collecter les téléphones
- Parc > Imprimantes : pour collecter les imprimantes
- Parc > Matériels réseau : pour collecter les équipements réseau, et les ports réseau de tous les assets
- Parc > Logiciels : pour collecter les logiciels installés sur un device
- Parc > Consommables : pour collecter les consommables, uniquement lorsque le paramètre Inclure les consommables est activé
- Gestion > Domaines : pour filtrer les actifs par domaine, uniquement lorsque le paramètre Domaines à importer est renseigné
Le profil doit également être affecté à l'utilisateur API sur l'entité racine avec l'option Récursif activée (Administration > Utilisateurs > l'utilisateur API > Habilitations). Sans cela, les assets et les utilisateurs rattachés à d'autres entités sont refusés et absents de l'import, même si les droits ci-dessus sont accordés.
Informations à fournir dans OverView
| Champ | Description |
|---|---|
| Jeton utilisateur | Récupéré depuis la section Remote access keys de l'utilisateur |
| Jeton applicatif | Récupéré depuis Setup > General > API (configuration du client) |
| URL de l'API | L'URL que vous utilisez pour ouvrir GLPI dans un navigateur, sans slash final — https://glpi.example.com si GLPI est servi à la racine du domaine, https://example.com/glpi s'il est servi depuis un sous-répertoire. Le connecteur ajoute /apirest.php/ lui-même, ne l'indiquez pas. |
Paramètres
Ces paramètres sont facultatifs. Conservez leur valeur par défaut sauf besoin particulier.
| Paramètre | Description | Défaut |
|---|---|---|
| Types d'actifs à exclure | Types d'actifs à exclure de l'import. Parmi : Ordinateur, Téléphone, Imprimante, Moniteur, Équipement réseau | — |
| Inclure les consommables | Importe les consommables GLPI : un actif par unité de consommable, avec son statut (Neuf ou Utilisé) et l'utilisateur à qui il a été attribué. Nécessite le droit Parc > Consommables | Désactivé |
| Domaines à importer | Seuls les actifs liés à l'un de ces domaines GLPI (onglet Domaines d'un actif) sont importés, sans tenir compte de la casse. Les actifs sans domaine ne sont pas importés : dans GLPI, il s'agit généralement des moniteurs, imprimantes, équipements réseau, consommables et appareils jamais inventoriés par un agent. L'import échoue si aucun des domaines n'existe dans GLPI. Nécessite le droit Gestion > Domaines | — |
Alternative : import par fichiers via DropPoint
L'accès API décrit plus haut est la méthode recommandée pour ce connecteur. Lorsqu'il n'est pas disponible (réseau cloisonné, version ou licence sans API, export déjà produit par ailleurs), OverView accepte des exports de fichiers, à déposer dans le bucket dédié à GLPI.
Bucket : s3://glpi/
Exemple : s3://glpi/export.csv
La procédure est décrite dans le guide OverView DropPoint : génération des credentials, configuration du client, puis envoi des fichiers depuis l'interface web OverView, l'AWS CLI ou un SDK. Les exemples y sont préremplis avec ce bucket lorsque vous suivez ce lien.
Documentation officielle
Pour plus d'informations, consultez la Documentation de l'API GLPI