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

# Descripción general de las integraciones

> Conecta tu stack de seguridad a Myrmex: cómo funcionan las integraciones, cómo se mantienen seguras las credenciales y cómo agregar una.

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

Las integraciones conectan Myrmex con las herramientas que ya utilizas: proveedores de nube, firewalls, equipos de red, EDR/XDR, SIEMs, bases de datos, gestión de tickets y más. Una vez conectadas, los agentes de IA (liderados por [Hydra](/es/documentation/multi-agent-system/integration-specialist-agent)) pueden leer datos de esos sistemas y actuar sobre ellos en tu nombre, directamente desde el [Workspace](/es/documentation/ai-workspace/overview).

## Cómo funcionan las integraciones

Cada integración es una **instancia** que creas a partir de un conector, acotada al [contexto](/es/documentation/get-started/concepts#how-your-account-is-organized) en el que trabajas. Según el sistema, Myrmex se conecta de una de estas formas:

<CardGroup cols={2}>
  <Card title="A través de un Collector" icon="server">
    Para dispositivos on-premises y de red, un **Myrmex Collector** (un dispositivo que ejecuta
    el agente en modo Collector) alcanza el sistema a través de SSH o su API desde
    dentro de tu red.
  </Card>

  <Card title="Directamente a la nube" icon="cloud">
    Para plataformas de nube y SaaS, Myrmex se conecta a través de la API del proveedor: mediante
    consentimiento OAuth o una credencial de servicio de privilegio mínimo.
  </Card>
</CardGroup>

<Note>
  **Tus credenciales nunca pasan por la IA.** Los agentes solo referencian
  una integración por su ID y le piden que ejecute una acción específica; los
  secretos reales se almacenan de forma segura y se resuelven del lado del servidor. Consulta
  [Protección de datos](/es/documentation/management/data-protection).
</Note>

## Credenciales compartidas vs. privadas

Por defecto una integración usa **una credencial compartida** para toda la organización — todos trabajan a través de la misma cuenta de servicio. Para integraciones donde cada persona debe actuar como ella misma, puedes cambiar la integración a **privada**: cada usuario vincula su **propia** credencial, y cualquier solicitud se ejecuta bajo la credencial del usuario que la realiza.

<CardGroup cols={2}>
  <Card title="Compartida (por defecto)" icon="users">
    Una credencial única para toda la organización. Cualquiera con acceso usa la
    misma cuenta de servicio — lo más simple para sistemas administrados
    centralmente.
  </Card>

  <Card title="Privada (por usuario)" icon="user-lock">
    Cada usuario vincula su propio login. Las acciones se atribuyen a — y usan
    los permisos de — la persona que las ejecuta. *"Exige que cada usuario use
    sus propias credenciales."*
  </Card>
</CardGroup>

**Activar el modo privado.** En la vista de detalle de la integración, un administrador (con la permission `integrations.update`) activa **Private integration**. Solo está disponible para tipos de conector que soportan credenciales privadas; una integración compartida sigue funcionando exactamente como antes.

**Vincular tu cuenta.** Cuando una integración es privada, cada usuario vincula una credencial personal una sola vez:

<Steps>
  <Step title="Crea una credencial personal">
    En **Settings → My Accounts**, agrega una cuenta — tu login personal para
    una integración privada (API key, basic auth, OAuth, SSH o credencial de
    base de datos).
  </Step>

  <Step title="Vincúlala a la integración">
    Abre la integración y ve a **Integration Details → Private credential → My
    credential**, elige tu cuenta y haz clic en **Link**. También puedes crear
    una nueva cuenta allí mismo.
  </Step>

  <Step title="Revisa el estado">
    Tu credencial vinculada aparece como **Valid**, **Invalid** o **Not tested**
    — un estado por usuario, independiente de la salud global de la integración.
  </Step>
</Steps>

<Note>
  Hasta que vincules una credencial válida, una integración privada aparece
  como **no disponible para ti** y la IA no puede actuar en tu nombre sobre
  ella — se te pedirá *"vincular tu cuenta en Integration Details → Private
  credential."* Los demás usuarios no se ven afectados; el acceso de cada
  persona es propio.
</Note>

## Qué puedes hacer con una integración

* **Leer y analizar**: incorpora alertas, inventario, configuración y métricas a tus investigaciones, en tiempo real y bajo demanda.
* **Actuar**: aplica reglas de firewall, aísla endpoints, ejecuta consultas, abre tickets y más, siempre con la salvaguarda de [la IA propone y tú apruebas](/es/documentation/get-started/concepts#ai-proposes-you-approve) para los cambios.
* **Medir la postura**: ejecuta auditorías de [Postura de seguridad](/es/documentation/security-posture/overview) continuas y bajo demanda contra el sistema conectado.

## Agregar una integración

<Steps>
  <Step title="Abre Add Integration">
    Desde el **Directory**, elige la acción rápida **Add Integration**.
  </Step>

  <Step title="Elige el conector">
    Elige del catálogo el sistema que quieres conectar.
  </Step>

  <Step title="Proporciona la credencial">
    Sigue la página de ese conector en esta sección para crear la credencial requerida
    (clave de API, cuenta de servicio, usuario SSH o consentimiento OAuth) y completa los campos.
  </Step>

  <Step title="Conecta">
    Guarda para validar la conexión. La integración aparecerá entonces en
    **Environment → Integrations**.
  </Step>
</Steps>

## El catálogo de conectores

Explora los conectores por categoría en la barra lateral. Cada conector tiene su propia página que describe exactamente qué credencial crear y cómo.

* **Nube y CSPM**: AWS, Google Cloud, Oracle Cloud, Prowler
* **Microsoft e identidad**: Entra ID, Intune, Microsoft 365, Sentinel, Google Workspace
* **Firewalls y WAF**: FortiGate, Palo Alto, Sophos, pfSense, WatchGuard, Cisco, Juniper, Barracuda, Cloudflare, Azion
* **Dispositivos de red**: Cisco, Huawei, Juniper, MikroTik, Dell, Aruba, D-Link, 3Com, Intelbras, Meraki, UniFi, Umbrella, NetBox
* **EDR y XDR**: CrowdStrike, SentinelOne, Trend Micro Vision One, Bitdefender
* **SIEM y monitoreo**: Wazuh, Elastic Security, IBM QRadar, Rapid7 InsightIDR, Zabbix, FortiAnalyzer
* **Vulnerabilidades e inteligencia de amenazas**: Tenable, Google Threat Intelligence, Shodan, Apura, Axur
* **ITSM y tickets**: GLPI, Jira
* **DevOps, automatización y notificaciones**: GitHub, Kubernetes, Grafana, n8n, SendGrid
* **Bases de datos**: PostgreSQL, MySQL/MariaDB, SQL Server, Oracle, Firebird, MongoDB, Redis, Cassandra, Elasticsearch

<Tip>
  ¿Necesitas algo que no está en la lista? Muchos dispositivos aún pueden alcanzarse a través de **SSH genérico**, y el catálogo de conectores se amplía constantemente. Pregunta en el Workspace qué está disponible para tu entorno.
</Tip>

## Conectar tus propias cuentas

Aparte de estas integraciones a nivel de organización, puedes vincular **conectores personales** —Gmail, Google Drive, Outlook y SharePoint— para que la IA pueda trabajar con documentos de tus propias cuentas. Estos actúan como tú, usando consentimiento por usuario.