Saltar a contenido

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 hacia downloads.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 es https://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:

  1. 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.
  2. 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:

sudo installer -pkg "hodei-shield-<versión>-universal.pkg" -target /

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
platform_url = "https://<host de la plataforma>"
state_dir = "/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.log y .err.log
  • Empieza por Resolución de problemas: agente de endpoint.
  • hodei-shield diagnose genera 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).