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:
- Elimina el agente de todas las copias de la máquina.
- Revoca el endpoint en la consola.
- Emite un token de inscripción nuevo (Endpoints) y vuelve a inscribir la máquina original con él
(
hodei-shield enroll --forcecon 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 usaHTTPS_PROXYdel entorno del propio servicio; si no hay, el ajuste de máquina del sistema operativo (WinHTTP en Windows,scutil --proxyen 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:puertoodirect. - 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.