Skip to main content
El repositorio del firmware de ZeroKeyUSB incluye una aplicación web ligera que corre localmente en tu navegador. Se conecta al dispositivo por WebUSB y envía el epoch actual para que los códigos TOTP se mantengan sincronizados.

​
Requisitos

  • Navegador basado en Chromium (Chrome, Edge, Brave) con WebUSB habilitado
  • ZeroKeyUSB desbloqueado y conectado vía USB-C
  • Copia local del directorio tools/web-time-sync servida vía npm run dev
No es necesario acceso a Internet una vez cargada la página.

​
Lanzar la herramienta

cd tools/web-time-sync
npm install
npm run dev
Abre la URL local impresa (típicamente http://localhost:5173) en tu navegador. Deberías ver el logo de ZeroKeyUSB y un botón “Connect”.

​
Enviar la hora

  1. Haz clic en Connect y selecciona tu ZeroKeyUSB en la lista de dispositivos (ZeroKeyUSB CDC).
  2. La página muestra el epoch Unix actual y una cuenta atrás hasta el siguiente límite de 30 segundos.
  3. Pulsa Sync now cuando el dispositivo pida la hora (muestra REQTIME).
  4. La herramienta envía SETTIME <epoch> automáticamente y confirma el éxito con una notificación toast.
Si el dispositivo ya estaba sincronizado, responde con OK y no se hacen cambios.

​
Características de seguridad

  • La herramienta solo se comunica con dispositivos USB cuyos IDs de vendor/producto coincidan con ZeroKeyUSB.
  • Todos los comandos son visibles en la consola en pantalla para auditabilidad.
  • Ningún dato sale de la pestaña del navegador; la telemetría y analíticas están deshabilitadas.

​
Resolución de problemas

ProblemaResolución
El navegador no puede acceder a USBAsegúrate de usar un navegador Chromium y haber concedido permisos al dispositivo.
Failed to send epochEl dispositivo puede estar bloqueado; desbloquéalo e inténtalo de nuevo.
La herramienta se cierra inesperadamenteComprueba la terminal que ejecuta npm run dev por errores y reinicia el dev server.
La herramienta web de sincronización ofrece una forma amigable para el usuario de mantener tu autenticador hardware alineado sin instalar software pesado.