Skip to main content

GLPI - Connecter un GLPI externe

S'applique à : Medulla / GLPI
Version de Medulla : Toutes
Version de GLPI : 10.0.x
Environnement : On-Premise
Catégorie : Intégration GLPI

Contexte

Cette procédure permet de configurer automatiquement la connexion entre Medulla et GLPI via le script change_itsm_parameters.py.

Avant l’exécution du script, plusieurs prérequis doivent être mis en place sur votre environnement GLPI.

1. Préparer votre environnement GLPI

Avant de configurer Medulla avec GLPI, merci de suivre la FAQ dédiée :

Votre GLPI et Medulla – Préparation de l’intégration

Cette FAQ couvre les éléments suivants :

  • Création de l’utilisateur MySQL/MariaDB dédié à Medulla
  • Ouverture des flux réseau entre Medulla et GLPI
  • Création de l’utilisateur API GLPI
  • Choix du profil Read-Only ou Super-Admin
  • Création du client API MMC
  • Génération des jetons user_token et app_token

Important :
Tous les prérequis décrits dans cette FAQ doivent être réalisés avant l’exécution du script de configuration ITSM.

2. Utilisation du script de configuration ITSM

Le script change_itsm_parameters.py permet de configurer automatiquement les paramètres de connexion entre Medulla et votre environnement GLPI.

Afficher l’aide du script

./change_itsm_parameters.py --help

Le script supporte les paramètres suivants :

usage: change_itsm_parameters.py [-h]
 --url URL
 --db-host DB_HOST
 --db-port DB_PORT
 --db-name DB_NAME
 --db-user DB_USER
 --db-pass DB_PASS
 --api-url API_URL
 --api-user API_USER
 --api-pass API_PASS
 --api-usertoken API_USERTOKEN
 --api-apptoken API_APPTOKEN
 [--inv-forward INV_FORWARD]
 [--inv-forward-url INV_FORWARD_URL]
 [--inv-plugin INV_PLUGIN]
 [--inv-agent INV_AGENT]
 [--inv-agent-disabled INV_AGENT_DISABLED]

Description des paramètres

Paramètre Description
--url URL principale de GLPI
--db-host Adresse du serveur MySQL/MariaDB GLPI
--db-port Port SQL (par défaut : 3306)
--db-name Nom de la base de données GLPI
--db-user Utilisateur MySQL/MariaDB dédié à Medulla
--db-pass Mot de passe SQL
--api-url URL de l’API GLPI (/apirest.php/)
--api-user Utilisateur API GLPI
--api-pass Mot de passe de l’utilisateur API
--api-usertoken Jeton utilisateur GLPI (user_token)
--api-apptoken Jeton d’application GLPI (app_token)
--inv-forward Active le transfert d’inventaire vers GLPI (optionnel)
--inv-forward-url URL de transfert des inventaires (optionnel)
--inv-plugin Plugin d’inventaire : glpiinventory ou fusioninventory
--inv-agent Agent d’inventaire côté poste : glpiagent ou fusioninventory
--inv-agent-disabled Désactive l’intégration de l’agent d’inventaire dans l’agent Medulla

3. Exemple d’utilisation

Exemple de configuration complète vers un serveur GLPI :

./change_itsm_parameters.py \
--url https://glpi.mon-domaine.fr/ \
--db-host 10.10.0.101 \
--db-port 3306 \
--db-name GLPI \
--db-user medulla_glpi \
--db-pass yJxI40UzO8Jn7dd7K5Yaml \
--api-url https://glpi.mon-domaine.fr/apirest.php/ \
--api-user medulla_APIUSER \
--api-pass fLN1Zomh877obPhk \
--api-usertoken zX9kL2mP5nB8vR1tS4jY7wQ0gH3fD6sA9uI2eO5p \
--api-apptoken cM6vB1nN8mX2zZ9aQ3sW4dE5rF6tG7hY8jU9kI0l

Conseil :
Avant d’exécuter le script, vérifier la connectivité réseau vers la base SQL GLPI ainsi que l’accès à l’API REST afin d’éviter les erreurs de configuration.

Valeurs par défaut

Élément Valeur
Port SQL GLPI 3306
Client API recommandé MMC
API GLPI /apirest.php/
Version GLPI supportée 10.0.x
Back to top