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

# PostgreSQL

> Conecta una base de datos PostgreSQL a Myrmex: crea un rol de auditoría de solo lectura y agrega la integración.

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

Conecta tu base de datos **PostgreSQL** para que Myrmex pueda auditar su endurecimiento y cumplimiento, verificar su estado operativo, explorar su esquema y —con tu aprobación— ejecutar SQL por ti. Myrmex accede a la base de datos mediante el protocolo nativo a través de un [Collector](/es/documentation/agent-endpoint-security/collector-mode) en tu red. Las operaciones se ejecutan en vivo y bajo demanda a través del agente [Integration Specialist](/es/documentation/multi-agent-system/integration-specialist-agent): Myrmex lee únicamente lo que le pides y no conserva ninguno de tus datos del lado de Myrmex.

## Qué puede hacer Myrmex

<CardGroup cols={2}>
  <Card title="Auditoría de cumplimiento" icon="shield-halved">
    Ejecuta una auditoría de [Security Posture](/es/documentation/security-posture/overview) y asigna los hallazgos a los [frameworks](/es/documentation/security-posture/frameworks) CIS, ISO 27001, NIST CSF y BACEN.
  </Card>

  <Card title="Comprobaciones de estado" icon="heart-pulse">
    Revisa las conexiones, las tasas de aciertos de caché (cache hit ratios), el retraso de replicación (replication lag) y el hinchamiento de tablas (table bloat).
  </Card>

  <Card title="Explorar tablas" icon="table">
    Enumera esquemas y tablas para que veas lo que contiene la base de datos.
  </Card>

  <Card title="Describir la estructura" icon="sitemap">
    Inspecciona las columnas, tipos, índices y restricciones de cualquier tabla.
  </Card>

  <Card title="Análisis de datos sensibles" icon="user-secret">
    Analiza tablas y columnas en busca de datos personales o sensibles que requieran protección.
  </Card>

  <Card title="Run SQL" icon="terminal">
    Ejecuta consultas de lectura en cualquier momento; las sentencias de escritura (DDL/DML) requieren tu confirmación.
  </Card>
</CardGroup>

## Antes de comenzar

* Un **Collector** en una red que pueda alcanzar el host de PostgreSQL en su puerto TCP (por defecto `5432`). Consulta el [modo Collector](/es/documentation/agent-endpoint-security/collector-mode).
* Un **login de base de datos dedicado** para Myrmex (créalo en el Paso 1).
* Se recomienda **TLS**. Establece SSL Mode en `require` para cifrar la conexión; los servidores sin TLS usan `disable` (la auditoría marca la falta de cifrado).

## Paso 1 — Crear la credencial en PostgreSQL

Crea un rol dedicado y de mínimo privilegio para la auditoría. `pg_monitor` otorga acceso de lectura a las vistas de estadísticas y configuración de las que depende la auditoría.

```sql theme={null}
-- As a superuser (e.g. postgres)
CREATE ROLE myrmex_audit LOGIN PASSWORD 'a-strong-password';
GRANT pg_monitor TO myrmex_audit;

-- Optional: lets the audit check host-based authentication (pg_hba) rules
GRANT SELECT ON pg_hba_file_rules TO myrmex_audit;
GRANT EXECUTE ON FUNCTION pg_hba_file_rules() TO myrmex_audit;
```

<Tip>
  Mantén la cuenta de solo lectura para la auditoría. Otorga un rol con capacidad de escritura solo si quieres que los agentes ejecuten sentencias de escritura (DDL/DML) mediante **Run SQL**.
</Tip>

## Paso 2 — Agregar la integración en Myrmex

Desde el **Directory**, elige **Add Integration → PostgreSQL** y luego completa:

| Field           | Descripción                                                                                                             |
| --------------- | ----------------------------------------------------------------------------------------------------------------------- |
| **Name**        | Un nombre único para esta base de datos.                                                                                |
| **Description** | Nota opcional para identificar la instancia.                                                                            |
| **Host**        | Host o IP de PostgreSQL (por ejemplo, 10.0.0.10 o db.corp.local).                                                       |
| **Port**        | Puerto TCP (por defecto `5432`).                                                                                        |
| **Database**    | Base de datos a la que conectarse (por defecto `postgres`).                                                             |
| **Username**    | Rol de auditoría (solo lectura, `pg_monitor`) o un usuario con capacidad de escritura para operaciones.                 |
| **Password**    | Contraseña (se almacena cifrada).                                                                                       |
| **SSL Mode**    | Postura de TLS: `require` cifra, `verify-full` / `verify-ca` validan el certificado, `disable` para servidores sin TLS. |
| **Collectors**  | El o los [Collector](/es/documentation/agent-endpoint-security/collector-mode) que pueden alcanzar esta base de datos.  |

## Conectar

Haz clic en **Connect** para validar el inicio de sesión y la configuración de TLS. La base de datos aparecerá entonces en **Environment → Integrations** junto con tus otras [integraciones](/es/documentation/integrations/overview), y podrás empezar a preguntarle a la IA sobre ella en el Workspace.

## Notas

* **Solo lectura por defecto.** La auditoría, el estado, la exploración del esquema y los análisis de datos sensibles solo necesitan el rol de solo lectura `pg_monitor`. Proporciona un usuario con capacidad de escritura solo si quieres escrituras con **Run SQL** sujetas a confirmación.
* **No se almacena nada.** Cada operación se ejecuta en tiempo real a través del Collector; los resultados regresan a tu Workspace y no se retiene ningún dato de la base de datos del lado de Myrmex.
* **TLS.** `require` cifra la sesión; `verify-ca` / `verify-full` también validan el certificado del servidor. Prefiere un modo de verificación cuando gestiones el certificado del servidor.