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

# UniFi Controller

> Conecta Ubiquiti UniFi a Myrmex con una API key de UniFi Site Manager: créala y agrega la integración.

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

Conecta tu parque de **Ubiquiti UniFi** para que Myrmex pueda leer en tiempo real tus sitios, consolas, dispositivos y clientes para inventario y análisis. Myrmex se conecta mediante la **API de UniFi Site Manager** (`api.ui.com`) usando una API key.

## Qué puede hacer Myrmex

<CardGroup cols={2}>
  <Card title="Leer el inventario" icon="boxes-stacked">
    Lista sitios, consolas, dispositivos UniFi y clientes conectados en todo tu parque, bajo demanda.
  </Card>

  <Card title="Salud y estado" icon="chart-line">
    Verifica el estado, la adopción y el tiempo de actividad de los dispositivos de los sitios que administras.
  </Card>

  <Card title="Auditoría de fortalecimiento" icon="shield-halved">
    Incorpora el inventario de UniFi a una revisión de [Security Posture](/es/documentation/security-posture/overview).
  </Card>

  <Card title="Pregunta en el Workspace" icon="magnifying-glass">
    Consulta tu entorno UniFi en lenguaje natural durante las investigaciones.
  </Card>
</CardGroup>

## Antes de comenzar

* Una **cuenta de UniFi Site Manager** (`unifi.ui.com`) con acceso a las consolas y los sitios que quieres conectar.
* Permiso para crear una **API key** en Site Manager.
* El **Console ID** y el **Site ID** de la consola/sitio que quieres que Myrmex lea.

## Paso 1 — Crear la API Key en UniFi Site Manager

<Steps>
  <Step title="Abre UniFi Site Manager">
    Inicia sesión en UniFi Site Manager en `unifi.ui.com`.
  </Step>

  <Step title="Crea una API key">
    Abre **Settings → API** (Control Plane) y crea una nueva **API Key**. Dale un nombre descriptivo.
  </Step>

  <Step title="Copia la key">
    Copia la key generada de inmediato y guárdala de forma segura: se muestra una sola vez. La pegarás en Myrmex.
  </Step>

  <Step title="Anota los IDs de consola y sitio">
    Anota el **Console ID** y el **Site ID** del entorno que quieres que Myrmex lea.
  </Step>
</Steps>

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

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

| Field           | Descripción                                                                                                        |
| --------------- | ------------------------------------------------------------------------------------------------------------------ |
| **Name**        | Un nombre único para este entorno UniFi.                                                                           |
| **Description** | Nota opcional para identificarlo.                                                                                  |
| **API Key**     | La API key de UniFi Site Manager del Paso 1, enviada como el encabezado `X-API-Key`.                               |
| **Host**        | El host de la API (por defecto `api.ui.com`).                                                                      |
| **Port**        | El puerto HTTPS (por defecto `443`).                                                                               |
| **Console ID**  | El identificador de la consola UniFi a leer.                                                                       |
| **Site ID**     | El identificador del sitio dentro de esa consola.                                                                  |
| **Collector**   | [Collector](/es/documentation/agent-endpoint-security/collector-mode) opcional para enrutar la conexión de la API. |

## Conectar

Haz clic en **Connect** para validar la API key y finalizar. UniFi aparecerá entonces en **Environment → Integrations**, listo para consultar en el Workspace.

<Note>
  Myrmex lee de UniFi en tiempo real mediante la API cada vez que lo solicitas: nada de tu entorno UniFi se almacena del lado de Myrmex.
</Note>