Guía para principiantes — Setup inicial

Esta guía explica cómo pasar de un SOC recién instalado a tener un PC de campo con VPN + SIEM + Monitoring + DNS Filter funcionando. Está pensada para administradores y técnicos sin experiencia previa en QCoreTShield.

Resumen en 30 segundos

Una vez en el servidor (SOC): crear una Setup Key VPN y anotar la password de enrollment SIEM.

En cada PC: ejecutar QCoreTShield-Setup.exe con esos datos + un nombre de agente.

No hace falta registrar cada PC manualmente en el portal — el instalador lo hace solo.

En el portal SOC puedes usar Tours guiados (botón en el menú lateral) para recorridos interactivos según tu rol.

A. Preparar el SOC (solo la primera vez)

Entra al portal
Abre https://TU-DOMINIO/dashboard/ e inicia sesión como administrador.

Completa el asistente VPN (si aparece)
Pestaña VPN → si ves un wizard de NetBird, elige Skip to Dashboard (el SOC ya está desplegado).

Crea una Setup Key para PCs Windows
En VPN → Setup Keys → Create → nombre: Agentes Windows → grupo All (hereda DNS Filter).
Copia la key — la usarás en todos los instaladores de PC.

Anota la password enrollment SIEM
Está en el servidor: archivo /opt/qcoret/.env → variable WAZUH_AGENT_ENROLLMENT_PASSWORD.
También aparece en el archivo de credenciales si el SOC fue provisionado por QCoreT Cloud.
Es una sola contraseña para todos los PCs — no se genera una por equipo.

Descarga el instalador Windows
Overview → tarjeta Cliente Windows → Descargar instalador.

Checklist SOC listo

Portal abre con HTTPS
Setup Key VPN creada y copiada
Password enrollment SIEM anotada
QCoreTShield-Setup.exe descargado

B. Antes de instalar cada PC

Recomendado: renombra el equipo Windows antes de instalar (Configuración → Sistema → Nombre del dispositivo), por ejemplo RECEPCION-01, CONTABILIDAD-LAPTOP.

En el instalador v1.9+ puedes escribir un nombre de agente personalizado — ese nombre aparecerá igual en VPN, SIEM y Monitoring.

Ten a mano esta tabla:

Dato	Ejemplo	¿Igual en todos los PCs?
Servidor SOC	`globalshield.qcoret.com`	Sí
Setup Key VPN	`URb4WKK3G…`	Sí
Password enrollment SIEM	del .env del servidor	Sí
Nombre del agente	`RECEPCION-01`	No — uno por PC
Password VNC (Monitoring)	la que elijas	Por PC (o misma política)

C. Instalar el cliente en un PC

Clic derecho en QCoreTShield-Setup.exe → Ejecutar como administrador.

Tipo de instalación: Agente de campo (VPN + SIEM + Monitoring).

Completa el wizard:

Servidor SOC = tu dominio
Setup Key VPN = la del paso A.3
Password enrollment SIEM = la del paso A.4
Nombre del agente = identificador claro del PC
Password VNC = para supervisión remota

Espera 2–5 minutos. El instalador:

Instala y conecta VPN (peer en el mesh)
Instala y registra agente SIEM en el manager
Instala TightVNC y registra la conexión en Monitoring

DNS Filter no se instala en el PC — se aplica automáticamente vía VPN cuando el peer está en el grupo All con DNS del SOC configurado.

D. Verificar los 4 servicios

Desde el portal SOC del administrador:

1. VPN

VPN → Peers → busca el nombre del agente → estado Connected.

2. SIEM

SIEM → menú Server management → Endpoints Summary → agente Active.

3. Monitoring

Monitoring → conexión con el mismo nombre → abrir pantalla (requiere VPN conectada en tu portátil).

4. DNS Filter

DNS Filter → Query log → navega en el PC agente con VPN encendida → deben aparecer consultas DNS.

Checklist PC OK

Peer VPN conectado
Agente SIEM Active
Conexión Monitoring visible
Consultas DNS en Query log

Problemas frecuentes

Peer VPN no conecta — Revisa firewall del servidor (UDP 3478, TCP 443). Setup Key correcta y no revocada.

Agente SIEM no aparece — Password enrollment incorrecta. Puertos 1514/1515 abiertos. Reinstala componente SIEM.

Monitoring vacío — El PC necesita VPN + VNC instalados. Espera 1–2 min tras conectar VPN.

Pestañas negras en el portal — Recarga con Ctrl+F5. Si persiste, contacta soporte (bootstrap de módulos).

Guías por módulo: VPN · SIEM · Monitoring · DNS Filter