Manuel d'administration


Pour pouvoir utiliser le plugin GLPI, il faut :

activer l'API REST : Cela se fait dans l'écran configuration>Générale>API

  • URL de l'API, une URL spécifique peut être choisie. Cette URL n'est pas forcément l'URL php permettant d'accéder à la documentation de l'API (apirest.php)
  • Activer l'API Rest > Oui
  • Activer la connexion avec un jeton externe > Oui

  • Ajouter un client de l'API :  cliquer sur "Ajout un client API" 
    • Actif > Oui
    • Regénérer permet de génerer un identifiant qui constitue l'appToken à renseigner dans la configuration

Avoir un utilisateur autorisé à utiliser l'API : un utilisateur créé spécialement pour cette connexion est conseillé.

  • Créer un utilisateur dans Administration > Utilisateurs > ajouter un utilisateur
  • Une fois l'utilisateur créé, il faut générer son userToken en allant dans les préférences de l'utilisateur créé. Administration > Utilisateurs, effectuer une recherche de l'utilisateur créé et cliquer sur on identifiant. dans la partie Préférences, il y a la possibilité de générer ce token sous clé d'accès distant
  • Cet utilisateurs doit pouvoir chercher les utilisateurs et chercher tous les tickets.

Le jeton généré sous clé d'accès distant constitue le userToken à renseigner dans la configuration.

En fonction de la version de GLPI, vous pouvez avoir l'écran suivant, dans ce cas, le usertoken à utiliser est le jeton d'API 

 

Pour tester en ligne de commande les droits, voici quelques commandes :

curl -X GET -H 'Content-Type: application/json' -H "Authorization: user_token Ak1icAj6Ftm7RMfgRjICopBg9Py2aZmU5LzI" -H "App-Token: fxX7VU64iDgYwnqFk6uoVqd1tiNEIna7UTH" 'https://gpilurl/glpi/apirest.php/initSession' -> renvoit un sessionToken

curl -X GET -H 'Content-Type: application/json' -H "Session-Token: cjj6klc3ctv3an85ltttmmois9" -H "App-Token: fxX7VU64iDgYwnqFk6uoVqd1tiNEIna7UTH" 'https://gpilurl/glpi/apirest.php/search/user?range\=0-1\&forcedisplay\[0\]\=1\&forcedisplay\[1\]\=2\&criteria\[0\]\[field\]\=8\\&criteria\[0\]\[searchtype\]\=contains\\&criteria\[0\]\[value\]\=1\'

Retour en haut

GLPI