> ## Documentation Index
> Fetch the complete documentation index at: https://docs.myrmex.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# GLPI

> Connect GLPI (ITSM) to Myrmex — enable the REST API, create the service account, and add the integration.

import { Note, Steps, Step, CardGroup, Card, Tip } from '@mintlify/components';

Connect **GLPI**, the open-source service desk, so Myrmex can manage the ticket lifecycle — open, assign, follow up, pend, solve, and close tickets, look up users, groups, and categories, and enrich a ticket with its full timeline. Myrmex operates the GLPI REST API (`apirest.php`, GLPI 10.x/11) live through a [Collector](/documentation/agent-endpoint-security/collector-mode) on your network — reading and acting on demand, with nothing stored on the Myrmex side.

## What Myrmex Can Do

<CardGroup cols={2}>
  <Card title="Manage tickets" icon="ticket">
    Open, assign, follow up, pend, solve, and close tickets — with approval for changes.
  </Card>

  <Card title="Directory lookups" icon="address-book">
    Resolve users, groups, and categories live when working a ticket.
  </Card>

  <Card title="Enrich" icon="magnifying-glass">
    Pull a ticket's full timeline in one shot, on demand.
  </Card>

  <Card title="Correlate" icon="link">
    Open or update tickets from security findings, via [Hydra](/documentation/multi-agent-system/integration-specialist-agent).
  </Card>
</CardGroup>

## Before You Start

* The **REST API enabled** in GLPI: in **Setup → General → API**, turn on the REST API (`enable_api`) and login with credentials (`enable_api_login_credentials`).
* An **API client** whose IP range covers your Collector — the default client is restricted to localhost. Copy its **App Token** if it defines one.
* A **GLPI user** (username + password) for the integration; its profile defines the entities and tickets it can see and change. Private credentials are supported, so operators can connect with their own GLPI account and have actions audited under their name.
* A **Collector** that can reach the GLPI host.

## Step 1 — Create the Credential in GLPI

<Steps>
  <Step title="Enable the REST API">
    In **Setup → General → API**, enable the REST API and enable login with credentials.
  </Step>

  <Step title="Configure an API client">
    In the same API settings, edit the default client (or add one) and set its IPv4/IPv6 range to include your Collector. If the client defines an **App Token**, copy it.
  </Step>

  <Step title="Create the integration user">
    Add a GLPI user with a strong password and assign a profile scoped to the right entities and ticket permissions.
  </Step>

  <Step title="Record the details">
    Note the **host**, **username**, **password**, and (if set) the **App Token**.
  </Step>
</Steps>

<Tip>
  Keep the profile least-privilege. Use private credentials when you want each action audited under the operator's own GLPI account.
</Tip>

## Step 2 — Add the Integration in Myrmex

From the **Directory**, choose **Add Integration → GLPI**, then fill in:

| Field                      | Description                                                                                                                                            |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Name**                   | A unique name for this GLPI instance.                                                                                                                  |
| **Description**            | Optional note to identify it.                                                                                                                          |
| **Protocol**               | `https` (default) or `http`.                                                                                                                           |
| **GLPI Host**              | Host or IP, optionally with a path if GLPI lives under one (for example `suporte.acme.com.br/glpi`). No scheme — the Collector appends `/apirest.php`. |
| **Port**                   | API port (default `443`); a port in the host (`host:8090`) takes precedence.                                                                           |
| **Username**               | The integration account's GLPI login.                                                                                                                  |
| **Password**               | That account's password (requires login with credentials on GLPI).                                                                                     |
| **App Token (optional)**   | The API client's App Token; leave empty when the client has none.                                                                                      |
| **Verify TLS Certificate** | Validate the certificate (default off — on-prem GLPI often uses a self-signed cert).                                                                   |
| **Collectors**             | The [Collector](/documentation/agent-endpoint-security/collector-mode) that reaches GLPI.                                                              |

## Connect

Click **Connect** to validate the connection and finish. GLPI then appears under **Environment → Integrations**. New to integrations? See the [Integrations overview](/documentation/integrations/overview).