Saltar a contenido

Agente de endpoint

El agente de endpoint HodeiShield es un programa ligero que instalas en un portátil o servidor para comprobar su postura de seguridad y alimentar el módulo Endpoints de la consola. No sustituye a tu EDR ni a tu antivirus: los observa, junto con el resto de la configuración de seguridad del sistema, y envía el resultado a tu inquilino.

Qué comprueba

El contrato del agente con la plataforma enumera 172 comprobaciones (medido el 2026-10-01): 29 comprobaciones puntuales, agrupadas por área en la tabla siguiente, y 143 de líneas base abiertas (137 códigos por regla y 6 por perfil, descritas en la sección siguiente). Cada comprobación se registra sólo en los sistemas operativos a los que aplica. Cada comprobación responde cumple / no cumple / no aplica / error, sin enviar el dato crudo que la originó:

Área Qué mira
Cuentas y autenticación Política de contraseña, bloqueo de cuenta tras intentos fallidos
EDR y antimalware Si hay protección activa y sus firmas están actualizadas
Cifrado de disco Si el volumen del sistema está cifrado
Firewall Si el firewall del sistema operativo está activo
Arranque seguro Integridad de arranque (Secure Boot / UEFI)
Auditoría Si el registro de auditoría del sistema está activo y persiste
Acceso remoto (SSH) Cifrados admitidos, acceso de root, autenticación por contraseña
Endurecimiento de red Reenvío de paquetes, redirecciones ICMP
Actualizaciones Si las actualizaciones automáticas de seguridad están activas
Integridad del sistema Protecciones nativas del sistema operativo (SIP en macOS, control de acceso obligatorio en Linux)
Reloj del sistema Si el reloj está sincronizado

Estas comprobaciones alimentan la puntuación de postura del endpoint que ves en Endpoints en la consola.

Líneas base de configuración abiertas

Estado de esta sección: el registro de comprobaciones del agente (el contrato del agente 2.17.0, sin ningún código retenido) registra 173 códigos de comprobación. Un equipo muestra "sin datos" en una línea base hasta que el agente instalado en él la reporta, nunca un porcentaje inventado. El resultado de cada endpoint depende de la versión del agente que ejecute.

Además de las comprobaciones puntuales de la tabla anterior, el agente evalúa líneas base de configuración completas, por sistema operativo, contra fuentes de referencia abiertas:

Familia Fuente Sistemas cubiertos
SSG ComplianceAsCode / SCAP Security Guide Ubuntu 22.04, Ubuntu 24.04
mSCP NIST macOS Security Compliance Project macOS 14, macOS 15
STIG DISA STIG Windows 11, Windows Server 2022

Sólo se evalúa el nivel 1 (L1) — el nivel base, pensado para no interrumpir el uso normal del equipo. Estas líneas base son distintas de un benchmark comercial: son estándares públicos, mantenidos por sus propios proyectos, y HodeiShield no reproduce su texto ni afirma certificar contra una marca registrada de terceros.

Controles en «Error» en esta beta: algunos controles pueden aparecer como «Error» en sistemas cuyo idioma no es el inglés, o porque el agente se ejecuta sin permisos de administrador. No significa que el control esté fallando: el agente no pudo leerlo con fiabilidad y no lo cuenta como cumplido. La próxima versión beta lo corrige.

Cómo leer el porcentaje por endpoint

Cada línea base aplicable a un equipo se muestra en su ficha de Endpoints como un porcentaje de cumplimiento: cuántas reglas del perfil de referencia pasan sobre el total de reglas que aplican a ese sistema concreto. Una regla que no aplica a tu configuración (por ejemplo, una regla sobre un servicio que no tienes instalado) no cuenta ni a favor ni en contra.

El porcentaje se calcula en el propio equipo y viaja firmado junto con el resto de la evidencia del agente — igual que cualquier otra comprobación. La consola no vuelve a ejecutar el escaneo por su cuenta: muestra lo que el agente ha reportado.

Qué NO se mide todavía

  • El nivel 2 (L2), más estricto, no está cubierto en esta fase.
  • El desglose regla a regla (qué comprobación exacta ha fallado) no viaja dentro del propio resultado agregado — depende de un formato de evidencia adicional que el agente todavía no publica.
  • Estas líneas base no están mapeadas a CIS Controls ni a CIS Benchmarks, y no se afirma ninguna cobertura de CIS. CIS queda fuera del alcance de la beta.
  • Ningún benchmark comercial (de pago) está cubierto por esta función.

Instalación

Hay un instalador por sistema operativo:

Sistema Formato
Windows (x64) .msi, se instala como servicio de Windows
macOS (Apple Silicon e Intel) .pkg universal, se instala como LaunchDaemon
Linux (x86_64) archivo comprimido, se instala como servicio systemd

Descarga el instalador para tu sistema desde Endpoints en la consola y ejecútalo con privilegios de administrador. Durante la instalación se te pedirá el token de enrolamiento: una credencial de un solo uso, generada por tu administrador desde la misma pantalla, que identifica la máquina ante tu inquilino. El agente arranca automáticamente al iniciar el sistema.

Antes de instalar, verifica la firma de la descarga.

Corregido en 2.14.2: instalación nueva en macOS

En un Mac donde nunca se instaló el agente, el .pkg de las versiones 2.14.0 y 2.14.1 del agente terminaba con «Error durante la instalación» y el servicio no arrancaba. El agente 2.14.2 y los posteriores incluyen la corrección. Si usas una versión anterior, actualiza; si tienes problemas para instalar en un Mac, escribe a info@hodeitek.com.

El paquete de certificados de la plataforma. El agente no usa el almacén de confianza del sistema operativo: sólo confía en el paquete de certificados de la plataforma HodeiShield, un fichero PEM, y el comando enroll exige que le indiques ese fichero con --ca-root. No añades nada al Llavero de macOS ni al almacén de certificados de Windows, pero el fichero tiene que estar en la máquina antes de enrolar. Los pasos de instalación que muestra la consola en Endpoints lo descargan de tu consola, comprueban su huella SHA-256 y se lo pasan a enroll. Copia esos pasos en lugar de montar los tuyos: ya llevan las opciones correctas. El archivo de Linux también contiene el paquete como platform-ca.pem. La ubicación por defecto de la consola es:

Sistema Ruta por defecto del paquete
Linux /etc/hodei-shield/platform-ca.pem
macOS /etc/hodei-shield/platform-ca.pem
Windows C:\ProgramData\Hodei-Shield\state\platform-ca.pem

Pasa el token por la entrada estándar, no por la línea de comandos

Si enrolas a mano, entrega el token al agente por la entrada estándar para que no quede en el historial del intérprete ni en la lista de procesos:

```sh
printf '%s' "$HODEI_TOKEN" | sudo -u hodei-shield \
  HODEI_PLATFORM_URL='https://<host-de-la-plataforma>' HODEI_STATE_DIR=/var/lib/hodei-shield \
  /usr/local/bin/hodei-shield enroll --token-stdin --ca-root /etc/hodei-shield/platform-ca.pem
```

o la misma línea de `enroll` con `< fichero_token` en lugar de la tubería con `printf`, con
el fichero en modo `0600`. Requiere un agente con `--token-stdin` (versión 2.12.0 o
posterior), que es la forma que propone la consola. No uses `enroll --token <valor>`. Las
dos variables hacen que el comando no dependa del directorio desde el que lo lanzas, y
`--ca-root` es obligatorio: sin él `enroll` se detiene con un error de uso. En macOS la
cuenta de servicio es `_hodeishield`, y en Windows la consola te da el equivalente en
PowerShell.
flowchart LR
    A[Administrador<br/>genera token de un solo uso] --> B[Descarga el instalador<br/>para su sistema]
    B --> C[Ejecuta el instalador<br/>con privilegios de administrador]
    C --> D{Introduce el<br/>token de enrolamiento}
    D -->|token válido| E[Endpoint activo<br/>en el inquilino]
    D -->|token inválido o caducado| F[Enrolamiento rechazado]
    E --> G[Envía comprobaciones firmadas<br/>cada ciclo]
    E -.revocar desde la consola.-> H[Identidad revocada]

El token se genera y se consume una sola vez; revocar es un acto explícito en la consola, no automático al desinstalar (ver «Límites honestos» más abajo).

Posible host clonado y nueva inscripción

Un agente que lo admite vincula su inscripción a la máquina en la que se hizo, con un hash con clave del identificador de máquina del sistema operativo que la plataforma no puede revertir. Si después los informes firmados de un endpoint presentan el vínculo de otra máquina (por ejemplo, una máquina virtual copiada o una imagen de disco restaurada que ejecuta el mismo agente), la consola marca el endpoint como posible host clonado y envía una alerta. Su evidencia se sigue aceptando, pero esos informes ya no actualizan su último contacto ni su inventario, y se rechaza la rotación de clave.

Para resolverlo:

  1. Elimina el agente de todas las copias de la máquina.
  2. Revoca el endpoint en la consola.
  3. Emite un token de inscripción nuevo (Endpoints) y vuelve a inscribir la máquina original con él (hodei-shield enroll --force con el token nuevo). La nueva inscripción es un endpoint distinto, vinculado a esa máquina.

Un endpoint revocado mientras estaba marcado como posible host clonado no se puede rehabilitar: rehabilitarlo podría entregar su identidad a la copia. Volver a inscribirlo es la única vía. Un endpoint que aparece como «sin vincular a su equipo» se inscribió con un agente sin este vínculo; al volver a inscribirlo con un agente actual queda vinculado.

Qué NO recoge

El agente está diseñado para observar postura de seguridad, no actividad del usuario. No recoge:

  • Contenido de ficheros ni historial de navegación.
  • Procesos en ejecución, ni el consumo de CPU o memoria.
  • Contraseñas ni ningún tipo de credencial.
  • La dirección MAC del dispositivo.

Qué sí envía

Además del resultado de cada comprobación, el agente envía identificación mínima de la máquina: nombre de host, direcciones IP públicas y la familia, nombre y versión del sistema operativo. Cada envío va firmado criptográficamente con la identidad del agente, para que la plataforma sepa que viene de la máquina que dice ser.

Informes de error (desactivados por defecto)

Desde el agente 2.23.0, los informes de error van solo por tu consola de Hodei-Shield, nunca directamente al servicio de seguimiento de errores: cada informe se firma con la clave del equipo y se envía a tu consola, que lo reenvía desde su propia dirección, de modo que el servicio no ve la IP del equipo. Están desactivados por defecto en cada inquilino: el agente solo envía uno mientras tiene un «sí» firmado de la consola que no ha caducado. Hoy ninguna consola los ofrece todavía, así que un agente 2.23.0 o posterior no envía ninguno. Un agente sano no envía nada, no hay tráfico periódico, y un informe nunca lleva resultados de comprobaciones, el nombre del equipo, el usuario ni datos personales.

Los agentes hasta la 2.22 se comportan de otro modo: envían los informes de error directamente al servicio, activados por defecto desde el 2026-10-06, y el fichero marcador de abajo es la forma de excluir un equipo.

Para forzar que no salgan informes de error en un equipo, diga lo que diga la consola, crea el fichero marcador antes de instalar (o, si el servicio ya está en marcha, créalo y reinicia el servicio; se lee al arrancar el proceso):

SO Marcador
Linux, macOS /etc/hodei-shield/telemetry-off
Windows %ProgramData%\Hodei-Shield\telemetry-off

La lista completa de lo que sale del equipo está en Qué sale de tu equipo.

Instalar con los informes de error desactivados

En vez de crear el marcador a mano, puedes pedirle al instalador que lo cree. Solo puede hacer que el agente envíe menos: cualquier otro valor, o ninguno, no hace nada, y un marcador existente nunca se borra.

Paquete Cómo Qué hace
.deb sudo TELEMETRY=off apt-get install ./<paquete>.deb crea /etc/hodei-shield/telemetry-off
.rpm sudo TELEMETRY=off rpm -i <paquete>.rpm (o sudo TELEMETRY=off dnf install ./<paquete>.rpm) crea /etc/hodei-shield/telemetry-off
.msi msiexec /i <paquete>.msi TELEMETRY=off crea %ProgramData%\Hodei-Shield\telemetry-off
.pkg (macOS) el instalador no admite parámetros: fija la clave Telemetry a off en un perfil de configuración de com.hodeitek.hodei-shield antes de instalar crea /etc/hodei-shield/telemetry-off

En Linux la variable debe llegar a los scripts del paquete, así que déjala dentro del comando sudo como se muestra. Si se pide off y el instalador no puede crear el marcador (por ejemplo, la carpeta no es de root), se detiene y el paquete queda sin configurar en vez de instalarse con los informes activos; en macOS la instalación falla. No todas las combinaciones se han ejecutado en todos los sistemas; compruébalo con hodei-shield version (véase arriba).

Detrás de un proxy

El agente puede enviar su tráfico (inscripción, resultados de las comprobaciones y consulta de actualizaciones) a través de un proxy HTTP.

Ajuste Significado
proxy en hodei-shield.toml, o HODEI_PROXY system (por defecto), none, o http://host:puerto / https://host:puerto
no_proxy, o HODEI_NO_PROXY hosts que van directos: sufijos como .corp.example o redes como 10.0.0.0/8 (una lista, o una cadena separada por comas)
  • Con system, el agente usa HTTPS_PROXY del entorno del propio servicio; si no hay, el ajuste de máquina del sistema operativo (WinHTTP en Windows, scutil --proxy en macOS, nada en Linux).
  • La dirección necesita un puerto explícito y ninguna ruta.
  • Se rechazan las credenciales en la dirección del proxy, desde cualquier origen: el proxy debe aceptar al agente sin usuario ni contraseña.
  • No se admiten scripts PAC ni WPAD, ni NTLM ni Kerberos. Un equipo que solo tiene un ajuste PAC conecta directamente y el agente registra un aviso.
  • Un valor de proxy ilegible es un error, nunca una conexión directa en silencio.
  • La decisión se toma una vez por proceso y se registra como proxy: host:puerto o direct.
  • Un proxy que inspecciona TLS necesita que se confíe en su CA: véase la página de solución de problemas para los errores de certificado.

Cuánto tiempo se conserva

Los plazos los aplica automáticamente la tarea diaria de retención de la consola, inquilino a inquilino:

Dato Plazo
Resultados de las comprobaciones (observaciones) 365 días desde que la plataforma los recibe; después se borran.
Estado de cada control derivado de esos resultados Mientras tu organización mantenga el servicio.
Nombre de host, direcciones IP y sistema operativo del equipo Sólo el último valor, y se borra al revocar el endpoint.
Identidad de un endpoint revocado y sus registros de alta (tokens de enrolamiento) 365 días desde la revocación; después se borran.
Registro de las actualizaciones que se autorizó instalar al agente 90 días.

Un endpoint que lleva 90 días sin comunicarse con la plataforma se revoca automáticamente, y al revocarlo se borra su inventario (la identidad revocada se conserva 365 días y luego se borra). Si lo retiras antes, revócalo tú desde Endpoints. Tratamos estos datos por cuenta de tu organización (art. 28.3 RGPD); al terminar el servicio se devuelven o se borran según sus instrucciones.

Límites honestos

  • Actualización: el agente incluye un mecanismo de actualización automática (descarga un manifiesto firmado, verifica firma y hash, prueba el binario nuevo y revierte si falla), pero no cuentes con él: en la versión estable actual (2.23.2) solo los equipos Linux aplican actualizaciones por sí solos; los equipos Windows y macOS no, así que actualízalos a mano. Para pasar a una versión nueva, descarga el instalador más reciente y repite la instalación — tu enrolamiento se conserva, no hace falta un nuevo token.
  • Periodo de soporte: cada versión MAYOR del agente tiene 5 años de soporte, contados desde la 1.0.0. El fin del soporte se anuncia con 12 meses de antelación. Las actualizaciones de seguridad siguen disponibles cuando una suscripción caduca; las funciones nuevas requieren una suscripción activa.
  • Revocación: para retirar un endpoint, desinstala el agente en la máquina (o detén su servicio) y revócalo desde Endpoints en la consola. La identidad de un endpoint no revocado permanece activa aunque el agente ya no esté instalado, hasta que la revocación automática de los 90 días sin comunicación la cierre.
  • Este agente no toma ninguna acción de remediación automática sobre el sistema: sólo observa y reporta.