Agente de Hodei-Shield — guía rápida para participantes de la beta¶
versiones difieren, manda la versión en inglés._
Una sola página: de cero a un equipo inscrito que informa. Los participantes de la beta pueden instalar el agente desde el 2026-11-02. Instala la versión 2.23.2.
Cuánto se ha probado cada parte¶
Léelo antes de empezar, porque los tres sistemas no están en el mismo estado. La
palabra MEASURED (medido) se usa solo cuando Hodeitek conserva la
prueba de una ejecución, y se indica dónde. NOT RUN (no ejecutado) significa
que nadie lo ha ejecutado todavía y que está escrito a partir del empaquetado.
| Sistema | Estado |
|---|---|
| Windows | El camino completo se ejecutó en equipos limpios con Windows 11 y Windows Server 2022 con 2.12.4 (2026-10-11 y 2026-10-12), y la instalación y la inscripción del conjunto 2.13.0 publicado y firmado en un Windows 11 recién instalado (2026-10-14). MEASURED 2026-11-17 en Windows 11 con el MSI 2.22.0 (firma Authenticode válida, «Hodeitek S.L.»): instalación, inscripción, un primer informe y desinstalación pasaron, y la decisión de autoactualización pasó de apply_unsupported a opt_out; no se ejecutaron una actualización real ni TELEMETRY=off, y fue con la 2.22.0, no con la 2.23.0. Los comandos, y el resultado medido de cada uno, están en la guía beta de Windows: sigue esa guía para los bloques exactos |
| Linux | Se ejecutó la comprobación de la descarga (MEASURED 2026-10-11, véase Verificar la descarga del agente). La inscripción del binario publicado 2.0.0 en un equipo Linux se hizo antes. MEASURED 2026-11-17 en Debian 13 (máquina virtual, instantánea limpia) con la versión 2.22.0 de downloads.hodeishield.com, siguiendo esta guía tal como está escrita: descarga, verificación de la firma y del checksum, instalación, inscripción contra la consola de producción, un primer informe enviado (resultado ok), la decisión de autoactualización mostrada en la consola (enabled, después opt_out con el marcador local) y desinstalación pasaron. NOT RUN: una actualización real (no había una versión más nueva) y TELEMETRY=off. Se midió con la 2.22.0, no con la 2.23.0 |
| macOS | Nada de esta página se ha ejecutado en un Mac. Todos los pasos de macOS están NOT RUN y salen del empaquetado. No consta ninguna inscripción correcta en macOS |
Si instalas en Linux o en macOS, estás entre los primeros en seguir estos caminos de principio a fin. Si un paso no se comporta como está escrito, para y avísanos (véase Ayuda); no improvises en el paso de inscripción, que gasta tu token.
Las guías completas por sistema son Linux, Windows y macOS. Esas guías están en inglés.
1. Requisitos¶
Necesitas, para cada máquina:
- Permisos de administrador (
root/ Administrador) y HTTPS saliente hacia hacia la URL de tu plataforma y haciadownloads.hodeishield.com. - Un token de inscripción, creado justo antes de usarlo. Sirve una sola vez: dos máquinas necesitan dos tokens. Quién lo crea: el administrador de tu organización, en la consola. Si participas a través de un MSSP (un proveedor de seguridad gestionada), lo crea el administrador del MSSP. Tú no lo creas, y nadie debería enviártelo por un canal que otros puedan leer.
- Un identificador de agente, elegido ahora: letras, dígitos y
. _ : -, empezando por una letra o un dígito. Pasa a ser el nombre permanente de la máquina en la consola. - La URL de la plataforma que muestra la consola (
https://…). En la beta eshttps://app.hodeishield.com(véase guía beta de Windows).
| SO | Compatible | Además, para verificar la descarga |
|---|---|---|
| Linux | x86_64 con systemd | OpenSSL 3 (openssl version) |
| Windows | x64, 2.13.0 o posterior |
OpenSSL 3 (Git for Windows incluye uno) y PowerShell |
| macOS | 13 o posterior, Apple Silicon o Intel | OpenSSL 3 (brew install openssl@3); el openssl del sistema es LibreSSL y no puede hacer la comprobación |
Desde la 2.13.0 no hace falta el redistribuible de Visual C++.
En Windows, la ventana de estado y la bandeja funcionan sin controlador gráfico (máquinas virtuales, VDI, servidores): la ventana usa DirectX 12 y recurre al renderizador por software WARP de Windows; el agente funciona e informa igual. MEASURED 2026-10-12 (según consta en guía beta de Windows).
2. Antes del primer arranque: qué envía y el interruptor de telemetría¶
Léelo antes de que el agente se ejecute por primera vez. Salen del equipo dos cosas:
- Los resultados de las comprobaciones de seguridad, hacia la plataforma de tu organización: qué comprobaciones se ejecutaron y si cada una pasó, unos pocos datos permitidos, el nombre del equipo, las direcciones IP enrutables y la versión del sistema operativo. Nunca ficheros, documentos, contraseñas, claves ni tokens. La lista completa, con el origen de cada afirmación, está en Qué sale de tu máquina. El aviso de privacidad de la consola está en https://app.hodeishield.com/privacy.
- Informes de errores (telemetría). En la beta, las compilaciones oficiales pueden informar de errores y cierres inesperados por tu consola (que los reenvía a nuestro servicio de seguimiento de errores) y solo mientras la consola haya enviado un «sí» firmado para tu organización: desactivados por defecto. Hoy ninguna consola los ofrece todavía, así que un agente de versión 2.23.0 o posterior no envía ninguno. Está declarada aquí y en Qué sale de tu máquina. Para que el instalador cree el marcador, y para equipos detrás de un proxy, véanse Instalar con los informes de error desactivados y Detrás de un proxy. Por diseño no contiene datos personales (ni nombre de equipo, ni dirección IP, ni nombre de usuario, ni resultados de comprobaciones; el texto libre se depura), y un agente sano no envía nada. Puedes forzar que no salga, máquina a máquina, con un solo fichero.
Para forzarlo, crea este fichero marcador antes del primer arranque. Su contenido se ignora; lo que cuenta es que exista. Sobrevive a las actualizaciones.
| SO | Cuándo | Comando |
|---|---|---|
| Linux | Después de que el paso 4 cree /etc/hodei-shield, antes de que el paso 6 arranque el servicio |
sudo mkdir -p /etc/hodei-shield && sudo touch /etc/hodei-shield/telemetry-off |
| macOS | Antes de instalar el .pkg (el paquete arranca el servicio por sí mismo) |
sudo mkdir -p /etc/hodei-shield && sudo touch /etc/hodei-shield/telemetry-off |
| Windows | Justo después de instalar el .msi, antes del paso 5 (el instalador crea y protege la carpeta él mismo, así que no la crees antes) |
New-Item -ItemType File -Force "$env:ProgramData\Hodei-Shield\telemetry-off" \| Out-Null; Restart-Service hodei-shield (PowerShell elevado) |
NOT RUN en Linux y macOS. En Windows el mismo comando consta como medido en
guía beta de Windows (2026-10-12).
El marcador se lee cuando arranca cada proceso: reinicia el servicio después de
crearlo o quitarlo. Para comprobarlo, ejecuta hodei-shield version; su segunda
línea dice telemetry for this process's environment: off (opt-out file …).
También funciona una variable de entorno (HODEI_SENTRY_DSN=off), pero para un
servicio conviene el fichero marcador. Detalles y límites:
Qué sale de tu máquina.
Si la máquina va a mostrar también la ventana de estado, lee además Qué sale de tu máquina: explica lo que ve una persona delante de la pantalla y quién lo controla.
Lo que puede ver una persona delante de la pantalla. Si tu organización pone los avisos de escritorio en Activo, el programa de la ventana de estado muestra un aviso breve, una sola vez, cuando un control empieza a fallar: «Hay algo que revisar / Abre la ventana de HodeiShield para verlo.» (en inglés: «Something to review / Open the HodeiShield window to see it.»). Nunca dice qué control, qué máquina ni qué gravedad, y nada de ello se envía a la plataforma. Lo decide tu organización desde la consola (Off, Discreto, Activo); sin decisión, el valor por defecto es Discreto (sin aviso). Sin medir: no se ha probado con un servicio de notificaciones real en ningún sistema; léelo como comportamiento previsto.
3. Descargar y verificar¶
Descarga el instalador, SHA256SUMS y SHA256SUMS.sig de la versión
2.23.2 desde https://downloads.hodeishield.com/agent/2.23.2/
(usa V=2.23.2; el campo version de https://downloads.hodeishield.com/agent/stable/agent-update-manifest.json indica la versión estable actual)
y verifica la firma de SHA256SUMS con la clave de versiones de Hodei-Shield
antes de instalar nada. La clave, su huella y los comandos exactos para
Linux, macOS y Windows están en
Verificar la descarga del agente, «What is signed, and how to check it».
La comprobación en Linux está MEASURED; la de macOS está NOT RUN; la de
Windows se ejecuta dentro del bloque de instalación de
guía beta de Windows.
No sigas si no ves Signature Verified Successfully y un OK para tu fichero.
Custodia de la clave: las versiones se firman con una clave dedicada y verificable (detalle).
4. Instalar¶
Linux, desde el tarball extraído (NOT RUN de principio a fin; los comandos son
los de la guía beta de Linux):
sudo useradd --system --no-create-home --shell /usr/sbin/nologin hodei-shield
sudo install -d -o root -g root -m 0755 /usr/lib/hodeishield /usr/lib/hodeishield/bin
sudo install -o root -g root -m 0755 hodei-shield /usr/lib/hodeishield/bin/hodei-shield
sudo ln -sfn /usr/lib/hodeishield/bin/hodei-shield /usr/local/bin/hodei-shield # solo para teclear
sudo install -o root -g root -m 0644 hodei-shield.service /etc/systemd/system/
sudo install -d -o root -g root -m 0755 /etc/hodei-shield
sudo install -o root -g hodei-shield -m 0640 platform-ca.pem /etc/hodei-shield/
sudo install -d -o hodei-shield -g hodei-shield -m 0700 /var/lib/hodei-shield
Windows: ejecuta el bloque verify-and-install de
guía beta de Windows
(comprueba el editor, la firma de la versión y la suma de verificación, e
instala solo si pasan las tres). Consta como medido con el conjunto 2.13.0
publicado y firmado (2026-10-14). No ejecutes un msiexec suelto.
macOS (NOT RUN), tras la verificación de la sección 3:
Los paquetes de Windows y macOS crean ellos mismos la cuenta de servicio y la
carpeta de estado. No pongas nunca el token en la línea de comandos de un
instalador. Actualizaciones posteriores: Linux las aplica solo, únicamente cuando la política
firmada de la consola aprueba la versión; Windows (estable) y macOS no tienen aplicador
operativo, así que instalas a mano el .msi o .pkg nuevo, sin token nuevo (véanse las guías).
5. Fichero de configuración¶
El fichero tiene dos líneas. Usa la URL de tu plataforma; la carpeta de estado es la de la tabla para tu sistema.
| SO | Fichero | state_dir |
|---|---|---|
| Linux | /var/lib/hodei-shield/hodei-shield.toml |
/var/lib/hodei-shield |
| Windows | C:\Program Files\Hodei-Shield\Agent\hodei-shield.toml |
C:\ProgramData\Hodei-Shield\state |
| macOS | /var/lib/hodei-shield/hodei-shield.toml |
/var/lib/hodei-shield |
NOT RUN en Linux y macOS. En Windows escribe el valor de state_dir entre
comillas simples ('C:\ProgramData\Hodei-Shield\state') para que las barras
invertidas sean literales; el bloque de Windows consta como medido en
guía beta de Windows (2026-10-12).
6. Inscribir¶
No escribas nunca el token en una línea de comandos: lo vería cualquier usuario
de la máquina y quedaría en el historial de tu consola. Guárdalo en un fichero
que solo un administrador pueda leer, pásalo con --token-stdin y bórralo.
Linux (NOT RUN; enroll se ejecuta una vez por máquina, y el servicio se
arranca solo después):
sudo sh -c 'umask 077; cat > /root/hodei-token' # pega el token y pulsa Ctrl-D
sudo sh -c 'cat /root/hodei-token' | sudo -u hodei-shield env \
HODEI_PLATFORM_URL="https://<host de la plataforma>" \
HODEI_STATE_DIR=/var/lib/hodei-shield \
/usr/lib/hodeishield/bin/hodei-shield enroll --token-stdin --agent-id '<id de esta máquina>'
sudo shred -u /root/hodei-token
sudo systemctl enable --now hodei-shield
Windows: usa los bloques w-token-file y w-enroll de
guía beta de Windows. Constan como
medidos el 2026-10-12 (el token se escribe en un aviso interactivo, nunca en una
línea de comandos). Ejecuta enroll desde la carpeta del agente
(C:\Program Files\Hodei-Shield\Agent).
macOS (NOT RUN):
sudo sh -c 'umask 077; cat > /var/root/hodei-token' # pega el token y pulsa Ctrl-D
sudo sh -c 'cat /var/root/hodei-token' | sudo -u _hodeishield env \
HODEI_PLATFORM_URL="https://<host de la plataforma>" \
HODEI_STATE_DIR=/var/lib/hodei-shield \
/usr/local/bin/hodei-shield enroll --token-stdin --agent-id '<id de esta máquina>'
sudo rm -P /var/root/hodei-token
sudo launchctl kickstart -k system/com.hodeitek.hodei-shield
Si todo va bien, imprime enrolled: producer=endpoint_agent:<id> public_key_id=… tenant_id=….
Si falla, no reintentes con el mismo token: un token rechazado nunca dice por
qué (desconocido, usado, caducado y revocado se ven igual). Pide a tu
administrador un token nuevo y consulta Token de inscripción rechazado.
Si ves un error de certificado o de TLS. No añadas un certificado al almacén
de confianza del sistema operativo ni desactives la verificación: el agente no
usa el almacén del sistema. Solo confía en el paquete de CA de la plataforma que
puso el instalador: /etc/hodei-shield/platform-ca.pem en Linux y macOS,
C:\ProgramData\Hodei-Shield\state\platform-ca.pem en Windows. Si ese fichero
falta, enroll nombra la ruta y se detiene. Envía la salida de hodei-shield diagnose a tu
administrador. Una línea platform [FAIL] con error TLS en
hodei-shield diagnose tiene la misma causa (Error de TLS o de certificado).
Otros fallos que puedes encontrar en la beta, y el paso de cada uno (los mensajes exactos, la causa y la solución están en Resolución de problemas: agente de endpoint):
| Lo que ves | Paso |
|---|---|
the platform rejected this enrollment token …, enrollment token is malformed …, enrollment rate-limited … |
Token de inscripción rechazado, mal formado o limitado por frecuencia |
this tenant already has a producer with this agent id |
Id de agente ya en uso |
diagnose indica clock [FAIL] |
Desfase del reloj |
El servicio no arranca, se reinicia en bucle o run sale con 75 |
El servicio no arranca, se reinicia en bucle o sale con 75 |
offline queue is full … |
Cola sin conexión llena o con retraso |
Se rechaza una actualización: version_not_approved, identity_unpinned, manifest_replayed |
Actualización rechazada |
7. Comprobar que funciona¶
| SO | Servicio en marcha | La identidad carga (salida 0; en Windows imprime además líneas INFO) |
|---|---|---|
| Linux | systemctl is-active hodei-shield responde active |
sudo -u hodei-shield sh -c 'cd /var/lib/hodei-shield && exec /usr/lib/hodeishield/bin/hodei-shield self-test' |
| Windows | Get-Service hodei-shield responde Running |
desde la carpeta del agente: & '.\hodei-shield.exe' self-test |
| macOS | sudo launchctl print system/com.hodeitek.hodei-shield \| head |
sudo -u _hodeishield sh -c 'cd /var/lib/hodei-shield && exec /usr/local/bin/hodei-shield self-test' |
Linux y macOS: NOT RUN. Windows: consta como medido en
guía beta de Windows.
La máquina aparece en la consola tras su primer ciclo (en Windows, el primer
envío se aceptó unos 2,5 minutos después del reinicio).
8. Desinstalación y borrado completo¶
Dos cosas, en este orden: parar y quitar el programa, y después decidir si destruyes lo que dejó. Desinstalar conserva la clave privada de la máquina, así que reinstalar no necesita una inscripción nueva. Borrar la carpeta de estado es irreversible: la máquina no podrá volver a informar con la misma identidad.
Revoca primero la máquina en la consola. El administrador de tu organización
(rol platform_admin, org_admin o tenant_admin) revoca allí el productor
(se llama endpoint_agent:<id del agente>); eso hace que la plataforma deje de
aceptar esa clave y libera el nombre. En la consola (v2.44.x): abre el menú
Endpoints, abre la página de detalle del endpoint, pulsa Revocar
enrolamiento y confirma en el diálogo Revocar este enrolamiento. Lo
inverso es Rehabilitar enrolamiento.
Revocar no borra por sí solo las observaciones ya recibidas: la
plataforma conserva, para un productor revocado, su fila y sus observaciones (un comportamiento de la plataforma que
el agente no pudo observar). La conservación y el borrado de los datos ya
recibidos corresponden al aviso de privacidad y a tu administrador, no a este
agente.
Todos los comandos siguientes están NOT RUN en un equipo real salvo que una
línea diga lo contrario.
Linux¶
Quita el programa (véase también Desinstalación en la guía beta de Linux):
sudo systemctl disable --now hodei-shield
sudo rm -f /etc/systemd/system/hodei-shield.service
sudo systemctl daemon-reload
sudo rm -f /usr/lib/hodeishield/bin/hodei-shield /usr/lib/hodeishield/bin/hodei-shield-gui
sudo rmdir /usr/lib/hodeishield/bin /usr/lib/hodeishield
# los enlaces de comodidad, o los ficheros reales de un equipo instalado antes del esquema /usr/lib/hodeishield
sudo rm -f /usr/local/bin/hodei-shield /usr/local/bin/hodei-shield-gui
# Antes de que userdel libere el uid del servicio, la clave que queda pasa a root:
# una cuenta creada después puede recibir ese uid y no debe poseerla.
# El find rechaza un fichero con un segundo enlace duro: con fs.protected_hardlinks=0
# la cuenta del servicio podría plantar uno a un fichero del sistema para que chown lo reasigne.
# pkill/pgrep y el chown/chmod no recursivo van antes, para que ningún proceso de ese uid
# pueda añadir uno entre el find y el chown -R (NOT RUN).
sudo pkill -KILL -u hodei-shield; ! pgrep -u hodei-shield \
&& sudo chown root:root /var/lib/hodei-shield /etc/hodei-shield && sudo chmod 0700 /var/lib/hodei-shield \
&& l="$(sudo find /var/lib/hodei-shield /etc/hodei-shield -xdev ! -type d -links +1 -print -quit)" && [ -z "$l" ] \
&& sudo chown -R root:root /var/lib/hodei-shield /etc/hodei-shield \
&& sudo chmod -R u=rwX,go= /var/lib/hodei-shield && sudo userdel hodei-shield
Lo que esto deja:
| Resto | Qué es |
|---|---|
/var/lib/hodei-shield |
la clave privada, la cola sin conexión cifrada, hodei-shield.toml, ficheros de estado; propiedad de root, 0700/0600, tras el paso anterior |
/etc/hodei-shield |
el paquete de CA y telemetry-off si lo creaste; propiedad de root |
| el diario del sistema | líneas de registro en journalctl -u hodei-shield; el agente no escribe fichero de registro en Linux. Caducan con la retención propia del diario |
/usr/share/applications/com.hodeitek.hodei-shield.desktop y /usr/share/icons/hicolor/*/apps/com.hodeitek.hodei-shield.png |
solo si instalaste la ventana de escritorio |
~/.config/hodei-shield (o $XDG_CONFIG_HOME/hodei-shield) de cada persona que usó la ventana |
las preferencias y el registro de avisos de la propia ventana |
Borrado completo (irreversible; hazlo solo después de revocar la máquina):
sudo rm -rf /var/lib/hodei-shield /etc/hodei-shield
sudo rm -f /usr/share/applications/com.hodeitek.hodei-shield.desktop
sudo rm -f /usr/share/icons/hicolor/*/apps/com.hodeitek.hodei-shield.png
rm -rf "${XDG_CONFIG_HOME:-$HOME/.config}/hodei-shield" # como cada usuario que usó la ventana
macOS¶
El .pkg trae un desinstalador, /usr/local/libexec/hodei-shield/uninstall.sh
(NOT RUN en un Mac; está escrito desde el empaquetado). Ejecútalo como root. Por defecto
conserva /var/lib/hodei-shield y /var/log/hodei-shield; --purge borra ambos, tras rechazar
un enlace simbólico, un propietario ajeno o un modo distinto de 0700 (lo comprueba todo antes de borrar nada):
sudo /usr/local/libexec/hodei-shield/uninstall.sh # conserva la clave y los registros
sudo /usr/local/libexec/hodei-shield/uninstall.sh --purge # borra también clave, cola, config, registros
Detiene los tres daemons y quita el binario, el ayudante de actualización, la app, el paquete de CA,
los avisos de licencias, la carpeta de estado, la cuenta _hodeishield (solo si la creó el paquete)
y el recibo. Lo que queda (sin --purge): /var/lib/hodei-shield, /var/log/hodei-shield y
/etc/hodei-shield si aún contiene telemetry-off (o un self-update.disabled que hayas creado; en
macOS ese fichero se crea con -g wheel, porque no existe el grupo root). Antes de borrar la
cuenta, una desinstalación simple pasa las carpetas que quedan a root (NOT RUN en un Mac);
una reinstalación devuelve el estado a la cuenta nueva. Los registros de
macOS los rota el propio agente (10 MiB, 5 archivos .0–.4, ficheros 0640). No se instala
ninguna regla de newsyslog; al actualizar se borra cualquier regla que dejara una versión anterior.
Para un .pkg anterior a 2.19.0 (sin desinstalador), quita a mano lo que dejó :
sudo launchctl unload -w /Library/LaunchDaemons/com.hodeitek.hodei-shield.plist
sudo launchctl unload -w /Library/LaunchDaemons/com.hodeitek.hodei-shield.runtime-dir.plist
sudo rm /Library/LaunchDaemons/com.hodeitek.hodei-shield.plist \
/Library/LaunchDaemons/com.hodeitek.hodei-shield.runtime-dir.plist
sudo launchctl bootout system/com.hodeitek.hodei-shield.update # root update job (2.16.0+); a no-op if it is not loaded
sudo rm -f /Library/LaunchDaemons/com.hodeitek.hodei-shield.update.plist /Library/PrivilegedHelperTools/com.hodeitek.hodei-shield.update
sudo rm -f /usr/local/bin/hodei-shield
sudo rm -rf /Applications/Hodei-Shield.app
# NOT RUN en un Mac. Antes de que dscl libere el uid del servicio, la clave
# que queda pasa a root: una cuenta creada después puede recibir ese uid. El find
# rechaza un fichero con un segundo enlace duro (macOS deja a la cuenta del servicio
# enlazar un fichero del sistema para que chown lo reasigne); pkill/pgrep y el chown/chmod
# no recursivo van antes, para que ningún proceso de ese uid añada uno entre el find y el
# chown -R. Si un paso falla, la
# cadena se para y la cuenta queda. ¿No hay /etc/hodei-shield? Quítalo del find y del chown.
# primero se descarga el dominio launchd por usuario de la cuenta; si no,
# launchd relanza su distnoted tras el pkill y pgrep nunca vuelve vacío.
sudo launchctl bootout user/"$(id -u _hodeishield)" 2>/dev/null
sudo pkill -KILL -u _hodeishield; ! pgrep -u _hodeishield \
&& sudo chown root:wheel /var/lib/hodei-shield /etc/hodei-shield && sudo chmod 0700 /var/lib/hodei-shield \
&& l="$(sudo find /var/lib/hodei-shield /etc/hodei-shield -xdev ! -type d -links +1 -print -quit)" && [ -z "$l" ] \
&& sudo chown -R root:wheel /var/lib/hodei-shield /etc/hodei-shield \
&& sudo chmod -R u=rwX,go= /var/lib/hodei-shield && sudo dscl . -delete /Users/_hodeishield \
&& sudo dscl . -delete /Groups/_hodeishield
sudo pkgutil --forget com.hodeitek.hodei-shield
Lo que esto deja:
| Resto | Qué es |
|---|---|
/var/lib/hodei-shield |
la clave privada, la cola sin conexión cifrada, hodei-shield.toml |
/etc/hodei-shield |
el paquete de CA y telemetry-off si lo creaste |
/var/log/hodei-shield |
los registros del agente (hodei-shield.log, .err.log) |
/usr/local/share/doc/hodei-shield |
los avisos de licencias de terceros |
/var/run/hodei-shield |
el fichero de estado; macOS vacía /var/run al reiniciar |
~/Library/Application Support/Hodei-Shield de cada persona que usó la ventana |
las preferencias y el registro de avisos de la propia ventana |
Borrado completo (irreversible; tras revocar; quita también lo de arriba):
sudo rm -rf /var/lib/hodei-shield /etc/hodei-shield /var/log/hodei-shield \
/usr/local/share/doc/hodei-shield /var/run/hodei-shield
rm -rf "$HOME/Library/Application Support/Hodei-Shield" # como cada usuario que usó la ventana
Borra la cuenta y el estado a la vez o ninguno de los dos: una carpeta de estado que sobrevive a la cuenta borrada pertenece a un identificador numérico que una cuenta futura puede no recibir.
Windows¶
La desinstalación del .msi consta como medida en
guía beta de Windows
(2026-10-12): quita el servicio y el programa, y conserva el estado a propósito.
# PowerShell elevado; apúntalo al .msi que guardaste
$msi = (Resolve-Path '<carpeta donde lo descargaste>\hodei-shield-<versión>-x86_64.msi').Path
(Start-Process msiexec.exe -ArgumentList '/x', "`"$msi`"", '/qn' -Wait -PassThru).ExitCode
Lo que esto deja:
| Resto | Qué es |
|---|---|
C:\Program Files\Hodei-Shield\Agent\hodei-shield.toml y Agent\logs\*.log |
la configuración y los registros del servicio |
C:\ProgramData\Hodei-Shield\state\ |
la clave privada, la cola sin conexión, platform-ca.pem, agent.lock |
C:\ProgramData\Hodei-Shield\telemetry-off |
solo si lo creaste |
C:\ProgramData\Hodei-Shield\THIRD-PARTY-NOTICES.txt |
avisos de licencias |
%APPDATA%\Hodei-Shield de cada persona que usó la ventana |
las preferencias y el registro de avisos de la propia ventana |
Borrado completo (irreversible; tras revocar; NOT RUN). La carpeta de
estado está protegida para que solo Administradores, SYSTEM y la cuenta de
servicio puedan abrirla, y una carpeta protegida puede negarse a borrarse
incluso desde una consola elevada hasta que tomes su propiedad. La guarda se
detiene si la carpeta ha sido sustituida por un enlace:
foreach ($p in 'C:\ProgramData\Hodei-Shield', 'C:\Program Files\Hodei-Shield') {
if (Test-Path -LiteralPath $p) {
if ((Get-Item -LiteralPath $p -Force).Attributes -band [IO.FileAttributes]::ReparsePoint) { throw "$p es un enlace: para y pide ayuda" }
Remove-Item -LiteralPath $p -Recurse -Force
}
}
Remove-Item -LiteralPath "$env:APPDATA\Hodei-Shield" -Recurse -Force -ErrorAction SilentlyContinue # por usuario
Si Remove-Item informa de acceso denegado en state, toma antes la propiedad
de esa carpeta (takeown /f 'C:\ProgramData\Hodei-Shield\state' /r /d y y
después icacls 'C:\ProgramData\Hodei-Shield\state' /grant Administrators:F /t)
y repite el borrado. Esas líneas no están cubiertas por ninguna ejecución
registrada.
Ayuda¶
- Registros:
- Linux:
journalctl -u hodei-shield -n 100 --no-pager - Windows:
C:\Program Files\Hodei-Shield\Agent\logs\(el fichero más reciente; léelo desde una consola elevada) - macOS:
/var/log/hodei-shield/hodei-shield.logy.err.log - Empieza por Resolución de problemas: agente de endpoint.
hodei-shield diagnosegenera un paquete de soporte depurado para adjuntar a una incidencia.- Para pedir ayuda o comunicar un problema: escribe a info@hodeitek.com o usa el botón «Beta» de la consola. Respondemos en un día laborable. Es un compromiso de responder, no de resolver.
- Para un token, o para revocar una máquina: el administrador de tu
organización (o el del MSSP) lo hace en la consola. Para revocar: menú
Endpoints, página de detalle del endpoint, Revocar enrolamiento
(consola v2.44.x; roles
platform_admin,org_admin,tenant_admin).