Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.zerokeyusb.com/llms.txt

Use this file to discover all available pages before exploring further.

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.