UniFi Network

Verificaciones automáticasSincronización de activosOn-premise

Infraestructura de red UniFi gestionada por consola local. Evidencia que los equipos de red están en línea y adoptados.

• Categoría: Seguridad de red (Network Security en el catálogo)
• Verificaciones: 1 (aporta evidencia a un control)
• Sincroniza como activos: equipos de red
• Documentación oficial: UniFi Network

Integración on-premise

UniFi Network vive dentro de tu red, no en internet. Al crear la conexión tendrás que indicar la dirección del sistema, y la plataforma debe poder alcanzarla: coordina con tu equipo de redes la habilitación correspondiente antes de configurarla.

Qué evidencia aporta

Cada ejecución de la conexión corre estas 1 verificación y deja el resultado como evidencia en tus auditorías, asociado al control que aparece en la última columna.

Verificación	Severidad si falla	Aporta al control
Equipos de red en línea	Alta	A.8.20 Seguridad de las redes

Los controles corresponden al Anexo A de la norma ISO/IEC 27001:2022. Si trabajas con otro marco, los cruces entre marcos trasladan el resultado a los requisitos equivalentes.

Qué te va a pedir la plataforma

Al crear la conexión completarás estos campos. Las credenciales se guardan cifradas y no vuelven a mostrarse.

Campo	Tipo	¿Obligatorio?
API Key (Settings → Control Plane → Integrations)	Secreto	Sí
IP o hostname de la consola UniFi (sin https://)	Dato de conexión	Sí
UUID del site (obtenlo con ‘Probar conexión’ → /sites, ver instrucciones)	Dato de conexión	Sí

Requisitos y permisos mínimos

Requisitos: consola con UniFi Network 9.0 o superior (la Integration API con API keys no existe en versiones anteriores).

Credencial: API Key creada en Settings → Control Plane → Integrations.

Site ID: es un UUID. Para obtenerlo: curl -k -H ‘X-API-KEY: <KEY>’ \ https://<consola>/proxy/network/integration/v1/sites y copia el campo id del site (por defecto hay uno solo).

Certificado: la consola usa self-signed salvo configuración — desmarca ‘Verificar certificado TLS’ si es el caso.

La integración solo lee: nunca reinicia ni reconfigura equipos.

Configuración paso a paso

Estos pasos se hacen en UniFi Network. Cuando termines, vuelve a Preceptix y crea la conexión con los datos obtenidos (ver Conecta tu primera integración).

1. Crea la API key

   Consola UniFi → Settings → Control Plane → Integrations → ‘Create API Key’. Cópiala (se muestra una sola vez).

2. Obtén el UUID del site

   Ejecuta el curl de los requerimientos y copia el id.

3. Completa esta pantalla

   • IP o hostname de la consola, UUID del site y API Key.
   • Desmarca TLS si usa certificado self-signed.
   • Dominio: donde aterrizarán los equipos y la evidencia.

   Pulsa ‘Probar conexión’ antes de guardar.

---

¿Falla la conexión o una verificación queda en rojo? Revisa Estado y cobertura.