Skip to main content

GLPI - Conectar un GLPI externo

Aplicable a: Medulla / GLPI
Versión de Medulla: Todas
Versión de GLPI: 10.0.x
Entorno: On-Premise
Categoría: Integración con GLPI

Contexto

Este procedimiento permite configurar automáticamente la conexión entre Medulla y GLPI mediante el script:

change_itsm_parameters.py

Este script configura automáticamente los parámetros de conexión entre Medulla, la base de datos de GLPI y la API REST.

Importante:
Antes de ejecutar el script, debes cumplir varios requisitos previos en tu entorno GLPI.


1. Preparar su entorno GLPI

Antes de configurar Medulla con GLPI, sigue las instrucciones de la FAQ dedicada a este tema:

GLPI y Medulla: creación de accesos de usuario

Esta FAQ aborda los siguientes temas:

  • Creación del usuario de MySQL/MariaDB dedicado a Medulla
  • Apertura de los flujos de red entre Medulla y GLPI
  • Creación del usuario de la API de GLPI
  • Elección del perfil «Read-Only» o «Super-Administración»
  • Creación del cliente de la API MMC
  • Generación de los tokens user_token y app_token

Importante:
Todos los requisitos previos descritos en estas FAQ deben cumplirse antes de ejecutar el script de configuración de ITSM.


2. Descargar el script de configuración

Descargar el script:

change_itsm_parameters.py

A continuación, haz que el script sea ejecutable:

chmod +x change_itsm_parameters.py

3. Ver la ayuda del script

Para ver los parámetros disponibles:

./change_itsm_parameters.py --help

El script admite los siguientes parámetros:

uso: 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]

4. Descripción de los parámetros

Parámetro Obligatorio Descripción
--url URL principal de GLPI
--db-host Dirección del servidor MySQL/MariaDB de GLPI
--db-port No Puerto SQL (por defecto: 3306)
--db-name Nombre de la base de datos GLPI
--db-user Usuario de MySQL/MariaDB dedicado a Medulla
--db-pass Contraseña SQL
--api-url URL de la API de GLPI (/apirest.php/)
--api-user Condicional Usuario de la API de GLPI (obligatorio si --readonly=false)
--api-pass Condicional Contraseña de usuario de la API
--readonly No Modo de solo lectura: Medulla no podrá escribir en GLPI (por defecto: false)
--crypt-key Condicional Clave de GLPI codificada en base64: contenido de /etc/glpi/glpicrypt.key
--inv-forward No Activa la transferencia del inventario a GLPI (por defecto: true)
--inv-forward-url Condicional URL de transferencia de inventarios
--inv-plugin No Complemento de inventario: glpiinventory o fusioninventory
--inv-agent No Agente de inventario en el equipo: glpiagent o fusioninventory
--inv-agent-disabled No Desactiva la integración del agente de inventario en el agente Medulla

Nota:
El script recupera automáticamente los tokens app_token y user_token directamente de la base de datos de GLPI.

Por lo tanto, no es necesario proporcionar estos tokens como parámetros.

Si tu versión de GLPI cifra los tokens, deberás proporcionar:

--crypt-key

5. Ejemplo de uso

Ejemplo de configuración completa para un servidor GLPI externo:

./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

Caso de un GLPI con tokens cifrados

Si su servidor GLPI contiene el archivo:

/etc/glpi/glpicrypt.key

añade el siguiente parámetro:

--crypt-key $(base64 -w 0 /etc/glpi/glpicrypt.key)

Ejemplo:

./change_itsm_parameters.py \
--url https://glpi.mon-domaine.fr/ \
--db-host 10.10.0.101 \
--db-name GLPI \
--db-user medulla_glpi \
--db-pass contraseña \
--api-url https://glpi.mon-domaine.fr/apirest.php/ \
--api-user medulla_api \
--api-pass contraseña \
--crypt-key $(base64 -w 0 /etc/glpi/glpicrypt.key)

6. Comprobaciones recomendadas

Antes de ejecutar el script, comprueba lo siguiente:

  • La conectividad SQL con GLPI
  • La accesibilidad a la API REST de GLPI
  • Los permisos de la cuenta SQL de Medulla
  • Los permisos del usuario de la API de GLPI

Atención:
Un error de red o un problema de autenticación impedirá que Medulla finalice su configuración de ITSM.


Valores por defecto

Elemento Valor
Puerto SQL de GLPI 3306
API de cliente recomendada MMC
API de GLPI /apirest.php/
Modo de solo lectura false
Transferencia de inventario true
Complemento de inventario glpiinventory
Agente de inventario glpiagent
Versión de GLPI compatible 10.0.x