> ## 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

> Conecte o GLPI (ITSM) ao Myrmex — habilite a API REST, crie a conta de serviço e adicione a integração.

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

Conecte o **GLPI**, o service desk open-source, para que o Myrmex possa gerenciar o ciclo de vida dos tickets — abrir, atribuir, acompanhar, deixar pendente, resolver e fechar tickets, consultar usuários, grupos e categorias, e enriquecer um ticket com sua linha do tempo completa. O Myrmex opera a API REST do GLPI (`apirest.php`, GLPI 10.x/11) ao vivo através de um [Collector](/pt/documentation/agent-endpoint-security/collector-mode) na sua rede — lendo e atuando sob demanda, sem armazenar nada do lado do Myrmex.

## O Que o Myrmex Pode Fazer

<CardGroup cols={2}>
  <Card title="Gerenciar tickets" icon="ticket">
    Abra, atribua, acompanhe, deixe pendente, resolva e feche tickets — com aprovação para alterações.
  </Card>

  <Card title="Consultas ao diretório" icon="address-book">
    Resolva usuários, grupos e categorias ao vivo ao trabalhar em um ticket.
  </Card>

  <Card title="Enriquecer" icon="magnifying-glass">
    Puxe a linha do tempo completa de um ticket de uma só vez, sob demanda.
  </Card>

  <Card title="Correlacionar" icon="link">
    Abra ou atualize tickets a partir de descobertas de segurança, via [Hydra](/pt/documentation/multi-agent-system/integration-specialist-agent).
  </Card>
</CardGroup>

## Antes de Começar

* A **API REST habilitada** no GLPI: em **Setup → General → API**, ative a API REST (`enable_api`) e o login com credenciais (`enable_api_login_credentials`).
* Um **API client** cujo intervalo de IP cubra seu Collector — o client padrão é restrito ao localhost. Copie o **App Token** dele, se houver um definido.
* Um **usuário do GLPI** (usuário + senha) para a integração; seu perfil define as entidades e tickets que ele pode ver e alterar. Credenciais privadas são suportadas, então operadores podem conectar com sua própria conta GLPI e ter as ações auditadas em seu nome.
* Um **Collector** que consiga alcançar o host do GLPI.

## Passo 1 — Crie a Credencial no GLPI

<Steps>
  <Step title="Habilite a API REST">
    Em **Setup → General → API**, habilite a API REST e habilite o login com credenciais.
  </Step>

  <Step title="Configure um API client">
    Nas mesmas configurações de API, edite o client padrão (ou adicione um) e defina seu intervalo IPv4/IPv6 para incluir seu Collector. Se o client definir um **App Token**, copie-o.
  </Step>

  <Step title="Crie o usuário da integração">
    Adicione um usuário do GLPI com uma senha forte e atribua um perfil restrito às entidades e permissões de ticket corretas.
  </Step>

  <Step title="Registre os detalhes">
    Anote o **host**, o **username**, a **password** e (se definido) o **App Token**.
  </Step>
</Steps>

<Tip>
  Mantenha o perfil com menor privilégio. Use credenciais privadas quando quiser que cada ação seja auditada na própria conta GLPI do operador.
</Tip>

## Passo 2 — Adicione a Integração no Myrmex

No **Directory**, escolha **Add Integration → GLPI** e preencha:

| Field                      | Descrição                                                                                                                                                      |
| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**                   | Um nome único para esta instância do GLPI.                                                                                                                     |
| **Description**            | Nota opcional para identificá-la.                                                                                                                              |
| **Protocol**               | `https` (padrão) ou `http`.                                                                                                                                    |
| **GLPI Host**              | Host ou IP, opcionalmente com um caminho se o GLPI ficar sob um (por exemplo `suporte.acme.com.br/glpi`). Sem esquema — o Collector acrescenta `/apirest.php`. |
| **Port**                   | Porta da API (padrão `443`); uma porta no host (`host:8090`) tem precedência.                                                                                  |
| **Username**               | O login GLPI da conta da integração.                                                                                                                           |
| **Password**               | A senha dessa conta (requer login com credenciais no GLPI).                                                                                                    |
| **App Token (optional)**   | O App Token do API client; deixe vazio quando o client não tiver nenhum.                                                                                       |
| **Verify TLS Certificate** | Validar o certificado (padrão desligado — GLPI on-prem costuma usar certificado autoassinado).                                                                 |
| **Collectors**             | O [Collector](/pt/documentation/agent-endpoint-security/collector-mode) que alcança o GLPI.                                                                    |

## Conectar

Clique em **Connect** para validar a conexão e concluir. O GLPI então aparece em **Environment → Integrations**. Novo em integrações? Veja a [visão geral de Integrações](/pt/documentation/integrations/overview).