# GLPI - Connecter un GLPI externe

<p class="callout info">**S'applique à**: Medulla/GLPI  
**Version de Medulla**: toutes  
**Version de GLPI**: 10.0.x  
**Environnement**: On-Premise  
**Categorie**: Medulla</p>

#### Prérequis

Avant de configurer l’intégration entre Medulla et GLPI, assurez-vous que 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](https://dl.medulla-tech.io/ma/change_itsm_parameters.py)

##### 1. Accès base de données GLPI

<span style="color: rgb(45, 194, 107);">Créer un utilisateur MySQL/MariaDB dédié pour Medulla avec les permissions suivantes :</span>

\- Lecture seule (`READ ONLY`) ou lecture/écriture selon les besoins  
\- Accès à l’ensemble de la base de données GLPI

##### 2. Connectivité réseau

Autoriser la communication entre le serveur Medulla et le serveur de base de données GLPI :

<span style="color: rgb(185, 106, 217);">- Port `3306` ouvert (ou port personnalisé selon votre configuration)</span>

##### 3. Création d’un utilisateur API GLPI

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

<p class="callout info">Sur GLPI dans `Administration &gt; Utilisateurs`</p>

<span style="color: rgb(230, 126, 35);">- Type : utilisateur standard (nom d'utilisateur / mot de passe)</span>  
\- 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`.

<p class="callout info">Sur GLPI dans `Configuration &gt; Générale &gt; API`</p>

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](https://dl.medulla-tech.io/nc/glpi-100.sql)

\---

#### Utilisation du script

##### Commande d’aide

> ./change\_itsm\_parameters.py --help
> 
> 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\] \[--readonly READONLY\] \[--crypt-key CRYPT\_KEY\] \[--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 ITSM parameters
> 
> options:  
>  -h, --help show this help message and exit  
> \--url URL ITSM provider URL  
> \--db-host DB\_HOST ITSM provider database host  
> \--db-port DB\_PORT ITSM provider database port  
> \--db-name DB\_NAME ITSM provider database name  
> \--db-user DB\_USER ITSM provider database user  
> \--db-pass DB\_PASS ITSM provider database password  
> \--api-url API\_URL ITSM provider API URL  
> \--api-user API\_USER ITSM provider API user  
> \--api-pass API\_PASS ITSM provider API password  
> \--readonly READONLY Whether ITSM provider database is read-only for Medulla (optional)  
> \--crypt-key CRYPT\_KEY  
>  Decoded GLPI crypt key file - base64 /etc/glpi/glpicrypt.key (optional)  
> \--inv-forward INV\_FORWARD  
>  Whether to forward inventory data to ITSM provider (optional)  
> \--inv-forward-url INV\_FORWARD\_URL  
>  URL to forward inventory data to (optional)  
> \--inv-plugin INV\_PLUGIN  
>  Inventory plugin to use - glpiinventory or fusioninventory(optional)  
> \--inv-agent INV\_AGENT  
>  Inventory agent to use on client machine - glpiagent or fusioninventory (optional, required if --inv-forward is true)  
> \--inv-agent-disabled INV\_AGENT\_DISABLED  
>  Whether to include inventory agent in Medulla agent (optional)

##### Exemples d'utilisation :

> ./change\_itsm\_parameters.py \\  
> \--url https://glpi.mon-domaine.fr/ \\  
> \--db-host 10.10.0.101 \\  
>  <span style="color: rgb(185, 106, 217);">--db-port 3306 \\</span>  
> \--db-name GLPI \\  
> <span style="color: rgb(45, 194, 107);"> --db-user medulla\_glpi \\</span>  
> <span style="color: rgb(45, 194, 107);"> --db-pass yJxI40UzO8Jn7dd7K5Yaml \\</span>  
> \--api-url https://glpi.mon-domaine.fr/apirest.php/ \\  
> <span style="color: rgb(230, 126, 35);"> --api-user medulla\_APIUSER \\</span>  
> <span style="color: rgb(230, 126, 35);"> --api-pass fLN1Zomh877obPhk \\</span>