Agente para Windows

Cómo instalar y verificar el agente NESS HQ en un equipo Windows 10, 11, o Windows Server 2016 en adelante.

1. ¿Qué se instala en mi Windows?

Al instalar el agente, el equipo queda protegido y monitoreado por NESS HQ. El instalador:

• Crea una carpeta del programa donde guarda sus archivos.
• Registra un servicio de Windows (aparece en services.msc).
• Agrega una tarea programada que actualiza el agente solo.
• (Opcional, en equipos con funciones avanzadas) Carga un driver de protección que actúa a nivel del sistema operativo.

El usuario no ve ventanas emergentes ni íconos en el escritorio; todo el agente corre en segundo plano.

2. Requisitos

Requisito	Detalle
Windows	10 (21H2+), 11, Server 2016, 2019, 2022, 2025.
Permisos	Administrador local durante la instalación.
Red	Acceso HTTPS (puerto 443) hacia cloud.nesshq.com.
RAM	1 GB mínimo libre (el agente consume menos de 100 MB).
Disco	600 MB libres. Ver requisitos: disco por confirmar.
Antivirus	Si tienes uno distinto a Microsoft Defender, el administrador te dará las exclusiones.

3. Instalación paso a paso

3.1 Método rápido (recomendado)

1. Abre el menú Inicio y escribe PowerShell.

2. Clic derecho en Windows PowerShell → "Ejecutar como administrador".

3. Confirma el diálogo "Control de cuentas de usuario" con Sí.

4. Copia y pega este comando (reemplaza TU_TOKEN por el token que te dio el administrador):

   $env:NESS_TOKEN = "TU_TOKEN"
   $env:NESS_TIME  = "15"
   iex ((New-Object System.Net.WebClient).DownloadString('https://storage.googleapis.com/repo.nesshq.com/scripts/install.ps1'))

5. Verás una pantalla con el logo NESS y una lista de verificaciones (color verde = correcto, amarillo = advertencia, rojo = error).

6. Al final debe decir "INSTALADO" o un mensaje de éxito.

Si no tienes el token, pídelo al administrador de tu cuenta NESS. No uses tokens de otros tenants (organizaciones), no funcionará.

Captura pendiente: 01 - Abrir PowerShell como administrador

Imagen pendiente de incorporar.

Captura pendiente: 02 - Comando de instalación

Imagen pendiente de incorporar.

Captura pendiente: 03 - Instalación exitosa

Imagen pendiente de incorporar.

3.2 Método con instalador descargado

Si tu empresa no tiene buena conexión a internet, o quieres distribuir el agente desde un archivo local:

1. Pide al administrador el archivo install.ps1 (o el paquete .zip).

2. Cópialo al equipo, por ejemplo en C:\Install\ness\.

3. Abre PowerShell como Administrador en esa carpeta.

4. Ejecuta:

   cd C:\Install\ness
   .\install.ps1 -Token "TU_TOKEN"

3.3 Parámetros que puedes usar

Parámetro	Para qué sirve	Ejemplo
-Token "<TOKEN>"	Token de tu organización (obligatorio).	-Token "<TOKEN>"
-Time 15	Cada cuántos minutos el agente reporta. Valores: 5, 15, 30 o 60. Default: 15.	-Time 30
-Services "Postgres,SQLServer"	Servicios de Windows adicionales a monitorear, separados por coma.	-Services "Spooler,W3SVC"
-Silent	No muestra el banner (para distribuir con Intune, SCCM, GPO).	-Silent
-Help	Muestra la ayuda.	-Help

Ejemplo completo:

.\install.ps1 -Token "<TOKEN>" -Time 30 -Services "Postgres,SQLServer,Apache"

Alternativa interactiva: ness-configurator

Si prefiere un asistente en pantalla para elegir los servicios a monitorear, el token y el intervalo, abra PowerShell como administrador y ejecute ness-configurator. Ver la guía de ness-configurator.

Captura pendiente: 09 a 12 - ness-configurator

Ver las capturas en la guía de ness-configurator.

3.4 Instalación masiva (empresas grandes)

Si necesitas instalar el agente en decenas o cientos de equipos al mismo tiempo, el administrador puede usar:

• Microsoft Intune: distribución de script.
• SCCM (Configuration Manager): paquete + despliegue.
• GPO (Directiva de Grupo): script de inicio de sesión.

En estos casos se usa el modo silencioso (-Silent). Si el agente ya está en el equipo, también puede usar la instalación silenciosa de ness-core-service (PowerShell como administrador):

ness-core-service --silent --token <TOKEN> --time 15

Ver ness-core-service.

4. ¿Cómo verifico que está funcionando?

4.1 Revisar el servicio de Windows

1. Abre Servicios (presiona Win + R, escribe services.msc y presiona Enter).
2. Busca NESSProtectionService (o un nombre similar que empieza con "NESS").
3. El Estado debe ser "En ejecución" y el Tipo de inicio debe ser "Automático".

Captura pendiente: 04 - Servicio en services.msc

Imagen pendiente de incorporar.

4.2 Diagnóstico desde línea de comandos

Abre PowerShell como Administrador y ejecuta:

ness-core-service --doctor

Verás un reporte con 5 verificaciones. Todas deben decir OK.

Captura pendiente: 05 - Diagnóstico doctor

Imagen pendiente de incorporar.

4.3 Revisar en el portal NESS HQ

1. Entra a https://cloud.nesshq.com.
2. Ve a Hosts o Inventario.
3. Busca tu equipo por nombre.
4. Debe aparecer con un punto verde verde.

Si todo está bien, el equipo aparece antes de 5 minutos después de instalar.

Captura pendiente: 06 - Equipo en línea en el portal

Imagen pendiente de incorporar.

4.4 Ver los registros (logs)

Si algo no funciona, puedes ver lo que el agente está haciendo:

• Logs del agente: C:\Program Files\NESS Core\logs\ness-core.log
• Logs de protección (si aplica): registro de ness-protection en la carpeta C:\Program Files\NESS Core\logs\

Para abrirlos rápido, pégalos en la barra de direcciones del Explorador de archivos.

5. ¿Qué hago si algo falla?

Síntoma	Causa probable	Solución
El instalador dice "permiso denegado"	No abriste PowerShell como Administrador	Cierra y vuelve a abrir como Administrador.
El servicio no arranca	Token inválido, sin red, driver bloqueado	Ejecuta --doctor y revisa el log.
Mi antivirus borró los archivos	Falta agregar exclusiones	Pide al administrador la lista oficial de exclusiones.
El equipo no aparece en el portal	Aún no pasaron 5 minutos	Espera unos minutos y refresca la página.
El equipo aparece rojo Offline	Sin red, equipo apagado, o el servicio se detuvo	Verifica la conexión a internet y el servicio de Windows.

Si después de estos pasos el problema persiste, contacta al administrador de la cuenta NESS.

6. ¿Cómo actualizo el agente?

No tienes que hacer nada. La plataforma descarga e instala actualizaciones automáticamente (suele ser una vez al día). El equipo no se reinicia ni interrumpe tu trabajo.

Si quieres forzar una actualización manual:

ness-updater --update

7. ¿Cómo desinstalo el agente?

7.1 Desde el portal (recomendado)

Pide al administrador que desinstale el agente remotamente:

1. Hosts → selecciona tu equipo.
2. Acciones → Desinstalar agente.

El agente se quitará solo en los siguientes minutos.

Captura pendiente: 07 - Desinstalar desde el portal

Imagen pendiente de incorporar.

7.2 Desde el equipo (PowerShell como Administrador)

1. Abre PowerShell como Administrador.

2. Ve a la carpeta del agente:

   cd "C:\Program Files\NESS Core"

3. Ejecuta:

   .\uninstall.ps1

Si el equipo tiene el driver de protección activo, el equipo puede perder conectividad a internet durante la desinstalación. Es normal y se restaura al finalizar.

8. ¿Cómo simulo un ataque para validar que funciona? (opcional)

Si quieres comprobar que la plataforma detecta correctamente amenazas reales, el agente incluye un script de validación que ejecuta técnicas de ataque reversibles y seguras (no causa daño).

1. Abre PowerShell como Administrador.

2. Ejecuta:

   cd "C:\Program Files\NESS Core"
   .\ness_adversary.ps1

3. El script ejecuta varias técnicas (PowerShell sospechoso, persistencia, deshabilitar firewall, etc.) y al finalizar muestra un resumen.

4. En los siguientes minutos, esas detecciones deben aparecer en el portal como alertas en la sección XDR.

Útil para validar que tu agente está reportando correctamente. Se recomienda correrlo una vez después de la instalación.

Captura pendiente: 08 - Alertas de la simulación en XDR

Imagen pendiente de incorporar.

9. Soporte

¿Problemas con la instalación o el agente? Contacta al administrador de tu cuenta NESS o al equipo de soporte:

• Web: https://nesshq.com
• Email: soporte@nesshq.com

Ruta completa

El instalador agrega los binarios de NESS al PATH, así que los comandos se usan por su nombre. También puedes usar la ruta completa, p. ej. & "C:\Program Files\NESS Core\ness-updater.exe" --update

Fuente

Guías para el cliente NESS HQ (2026). Ver Fuentes.