Agente para macOS

Cómo instalar y verificar el agente NESS HQ en un equipo Mac con macOS 12 Monterey o superior (tanto Intel como Apple Silicon M1/M2/M3/M4/M5).

1. ¿Qué se instala en mi Mac?

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

• Copia los binarios del agente a una carpeta del sistema.
• Crea unos LaunchDaemons (servicios que corren en segundo plano, incluso si no has iniciado sesión).
• Configura la extensión del navegador para DLP.
• No agrega íconos visibles al usuario.

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

2. Requisitos

Requisito	Detalle
macOS	12 Monterey o superior (incluye Ventura, Sonoma, Sequoia, Tahoe).
Mac	Intel o Apple Silicon.
Permisos	Usuario administrador (debes poder usar sudo).
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.
Opcional	Homebrew (si quieres gestionar software desde el portal).

3. Instalación paso a paso

3.1 Método rápido (recomendado)

1. Abre la aplicación Terminal (Aplicaciones → Utilidades → Terminal, o búscala con Spotlight Cmd + Espacio).

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

   NESS_TOKEN='TU_TOKEN' NESS_TIME='15' \
   sudo -E bash -c "$(curl -fsSL https://storage.googleapis.com/repo.nesshq.com/scripts/install-macos.sh)"

3. Te pedirá tu contraseña de Mac (es la que usas para desbloquear el equipo). Escríbela y presiona Enter.

   Al escribir la contraseña no se ven caracteres en la terminal; es normal.

4. Verás el logo NESS y una lista de pasos con marcas verdes al completarse.

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

Captura pendiente: 01 - Abrir Terminal

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 no tienes buena conexión o quieres instalarlo desde un archivo local:

1. Pide al administrador el archivo install-macos.sh.

2. Cópialo al escritorio o a tu carpeta de Descargas.

3. Abre Terminal.

4. Ejecuta:

   cd ~/Downloads
   chmod +x install-macos.sh
   sudo ./install-macos.sh --token "TU_TOKEN"

3.3 Parámetros que puedes usar

Parámetro	Para qué sirve	Ejemplo
--token "<TOKEN>" (o -t)	Token de tu organización (obligatorio).	--token "<TOKEN>"
--time 15 (o -i)	Cada cuántos minutos el agente reporta. Valores: 5, 15, 30 o 60. Default: 15.	--time 30
--services "a,b,c" (o -s)	Servicios adicionales a monitorear (LaunchDaemons), separados por coma.	--services "com.docker.helper"
--silent	No muestra el banner (para distribuir con MDM).	--silent
--help (o -h)	Muestra la ayuda.	--help

Variables de entorno equivalentes (útiles para automatizar):

export NESS_TOKEN="<TOKEN>"
export NESS_TIME="15"
export NESS_SERVICES="com.docker.helper,com.vmware.vmware-fusion"
sudo -E ./install-macos.sh

4. Permisos del sistema (importante la primera vez)

La primera vez que el agente arranca, macOS te va a pedir permisos especiales. Debes aprobarlos para que el agente funcione bien:

1. Acceso completo al disco (Full Disk Access):
   • Abre Ajustes del Sistema → Privacidad y Seguridad → Acceso completo al disco.
   • Busca el ícono + y agrega ness-core-service y ness-configurator.
2. Accesibilidad (Accessibility):
   • En la misma sección Privacidad y Seguridad → Accesibilidad.
   • Agrega también ness-core-service.

Si rechazas los permisos, el agente sigue funcionando pero algunas detecciones avanzadas no estarán disponibles.

Captura pendiente: 04 - Permiso de acceso completo al disco

Imagen pendiente de incorporar.

Captura pendiente: 05 - Permiso de accesibilidad

Imagen pendiente de incorporar.

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

5.1 Desde el portal NESS HQ

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

Si todo está bien, el equipo aparece antes de 5 minutos.

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

Imagen pendiente de incorporar.

5.2 Desde la Terminal

Abre Terminal y ejecuta:

sudo ness-core-service --doctor

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

Captura pendiente: 07 - Diagnóstico doctor

Imagen pendiente de incorporar.

5.3 Ver los registros (logs)

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

• Logs del agente: /Library/Logs/NessHQ/ness-core.log
• Logs de protección (si aplica): registro de ness-protection en la carpeta /Library/Logs/NessHQ/

Para verlos en vivo, abre Terminal y ejecuta:

tail -f /Library/Logs/NessHQ/ness-core.log

(Presiona Ctrl + C para dejar de verlos.)

También puedes verlos con la app Consola (Aplicaciones → Utilidades → Consola) y filtrar por "nesshq".

6. ¿Qué hago si algo falla?

Síntoma	Causa probable	Solución
"Command not found" después de instalar	El instalador no terminó bien	Vuelve a ejecutar el comando de instalación.
El agente no aparece en el portal	Aún no pasaron 5 minutos	Espera unos minutos y refresca la página.
El portal dice que mi Mac está Offline	Sin red, Mac apagada, o permisos no otorgados	Verifica la red y revisa los permisos de Privacidad y Seguridad.
El navegador bloquea páginas y no debería	El Web Filter está bloqueando la página	Habla con el administrador para ajustar la política.
Mi Mac pide permisos repetidamente	Cambió la firma del binario	Re-aprobar en Privacidad y Seguridad.

Si el problema persiste, contacta al administrador de tu cuenta NESS.

7. ¿Cómo actualizo el agente?

No tienes que hacer nada. Las actualizaciones se descargan e instalan automáticamente (suele ser una vez al día).

Si quieres forzar una actualización:

sudo ness-updater --update

8. ¿Cómo desinstalo el agente?

8.1 Desde el portal (recomendado)

Pide al administrador que desinstale el agente remotamente:

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

El agente se quitará solo en los siguientes minutos.

Captura pendiente: 08 - Desinstalar desde el portal

Imagen pendiente de incorporar.

8.2 Desde la Terminal

sudo /usr/local/bin/uninstall-macos.sh

Durante la desinstalación se quitan los servicios, los archivos, y cualquier regla de filtrado web que haya dejado.

9. Gestión de software (si tu organización lo permite)

Dependiendo de las políticas que tenga configuradas tu organización, la plataforma puede instalar, actualizar o desinstalar software en tu Mac, especialmente si fue instalado con Homebrew. Esta gestión es silenciosa y no muestra ventanas en tu sesión.

Si notas que se instala o actualiza software automáticamente, es porque tu organización lo configuró así. Si tienes dudas, contacta al administrador.

Los apps del Mac App Store y las instaladas como .dmg no se pueden actualizar automáticamente (limitación de Apple).

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