GLPI - Connecter un GLPI externe

S'applique à: Medulla/GLPI
Version de Medulla: toutes
Version de GLPI: 10.0.x
Environnement: On-Premise
Categorie: Medulla

Cette documentation est utile pour les infrastructures avec Medulla déjà installée

Prérequis

Avant de configurer l’intégration entreGLPI avec Medulla, merci de suivre la FAQ dédiée :

 Votre GLPI et Medulla et– GLPI,Préparation assurez-vousde quel’intégration

Cette documentation couvre les éléments suivants sont disponibles et correctement configurés.:

Télécharger

le script ici : https://dl.medulla-tech.io/ma/change_itsm_parameters.py

1. Accès base

Création de données GLPI

Créer un l’utilisateur MySQL/MariaDB dédié pourà Medulla

avecOuverture des flux réseau (port SQL) 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 permissionsprérequis suivantesdécrits :dans cette FAQ doivent être réalisés avant l’exécution du script de configuration ITSM.

---

Utilisation du script de configuration ITSM

-Le Lecturescript seulechange_itsm_parameters.py (`READpermet ONLY`)de ouconfigurer lecture/écriture selonautomatiquement les besoins
- Accès à l’ensembleparamètres de la base de données GLPI

2. Connectivité réseau

Autoriser la communicationconnexion entre le serveur Medulla et levotre serveurenvironnement de base de données GLPI :GLPI.

-

Afficher Port `3306` ouvert (ou port personnalisé selon votre configuration)

3. Création d’un utilisateur API GLPI

Créer un utilisateur GLPI dédié aux appels API nommé comme vous le souhaitez :

Sur GLPI dans `Administration > Utilisateurs`

- Type : utilisateur standard (nom d'utilisateur / mot de passe)
- Profil recommandé :
  - `Read-Only` ou `Super-Admin`
- Affectation :
  - Entité racine
  - Mode récursif activé

Générer ensuite un jeton API utilisateur (`user_token`)

4. Création d’un client API GLPI

Créer un client API nommé `MMC`.

Sur GLPI dans `Configuration > Générale > API`

Générer ensuite le jeton d’application (`app_token`)

5. Importer des vues SQL sur votre base de donnée GLPI

Dans votre base de donnée GLPI vous devez importez le fichier téléchargé ici :

https://dl.medulla-tech.io/nc/glpi-100.sql

---

Utilisationl’aide du script

Commande d’aide

./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_PORT
 --db-name DB_NAME
 --db-user DB_USER
 --db-pass DB_PASS
 --api-url API_URL
 [--api-user API_USER]API_USER
 [--api-pass API_PASS]API_PASS
 [--readonlyapi-usertoken READONLY]API_USERTOKEN
 [--crypt-keyapi-apptoken CRYPT_KEY]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]

Update

Description ITSMdes parametersparamètres

options:

-h, --helpParamètre showDescription this help message and exit
  --url URL ITSMprincipale providerde URL
GLPI --db-host DB_HOSTAdresse ITSMdu providerserveur databaseMySQL/MariaDB host
GLPI --db-port DB_PORTPort ITSMSQL provider(par databasedéfaut port
: 3306) --db-name DB_NAMENom ITSMde providerla databasebase name
de données GLPI --db-user DB_USERUtilisateur ITSMMySQL/MariaDB providerdédié databaseà user
Medulla --db-pass DB_PASSMot ITSMde providerpasse databaseSQL password
--api-url API_URLURL ITSMde provider l’API URL
GLPI (/apirest.php/) --api-user API_USER   ITSM providerUtilisateur API user
GLPI --api-pass API_PASSMot ITSMde providerpasse de l’utilisateur API password
--readonlyapi-usertoken READONLYJeton Whether ITSM provider database is read-only for Medulla (optional)
  --crypt-key CRYPT_KEY
                        Decodedutilisateur GLPI crypt(user_token) key file --api-apptoken base64Jeton /etc/glpi/glpicrypt.keyd’application GLPI (optional)
app_token) --inv-forward INV_FORWARD
Active le Whethertransfert tod’inventaire forwardvers inventory data to ITSM providerGLPI (optional)
optionnel) --inv-forward-url INV_FORWARD_URL
                        URL tode forwardtransfert inventorydes data toinventaires (optional)
optionnel) --inv-plugin INV_PLUGIN
Plugin d’inventaire Inventory: pluginglpiinventory toou usefusioninventory - glpiinventory or fusioninventory(optional)
  --inv-agent INV_AGENT
Agent d’inventaire Inventorycôté agentposte to: useglpiagent onou clientfusioninventory machine - glpiagent or fusioninventory (optional, required if --inv-forward is true)
  --inv-agent-disabled INV_AGENT_DISABLED
Désactive l’intégration Whetherde to include inventory l’agent ind’inventaire dans l’agent Medulla agent (optional)

---

ExemplesExemple d'd’utilisation :

./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 :
Tester la connectivité SQL et API avant d’exécuter le script afin de valider les flux réseau et les permissions.