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.

Bienvenida

ZeroKeyUSB es un gestor de contraseñas independiente y basado en hardware, diseñado para mantener tus credenciales completamente offline.
Se comporta como un teclado USB: teclea tus usuarios cifrados, contraseñas y códigos TOTP opcionales donde los necesites.
Sin apps. Sin nube. Sin suscripciones.
Todo lo que necesitas para montar el hardware, entender el firmware y mantener tu dispositivo seguro está organizado a continuación.

Empezar

Aprende cómo flashear el firmware, fijar tu PIN maestro y empezar a usar ZeroKeyUSB de forma segura.

Funciones principales

Cifrado offline

Protege tus datos con cifrado AES-128 CBC. La clave se genera con el TRNG del ATECC608A y permanece dentro del slot 8 del chip — el cifrado y descifrado se ejecutan en el motor AES hardware del elemento seguro, sin exponer nunca la clave al MCU.
El PIN se verifica vía SHA-256 y un contador monotónico hardware. No requiere conexión a Internet nunca.

Elemento seguro hardware

Un elemento seguro ATECC608A proporciona números aleatorios verdaderos de calidad hardware, un contador monotónico resistente a manipulación para el rate-limiting del PIN, y un serial único del chip usado como salt del PIN.

Simplicidad hardware

Construido alrededor de un microcontrolador SAMD21E18A y una EEPROM M24C64-WMN6TP, completamente alimentado por USB-C.
Sin baterías, sin chips wireless — verdaderamente air-gapped.

Salida de teclado universal

Actúa como un teclado HID USB estándar con soporte para 9 layouts de idioma (EN-US, DE, FR, ES, IT, PT, SV, DA, HU) para teclear credenciales en cualquier campo enfocado.
Funciona en todos los sistemas operativos importantes.

Pantalla OLED integrada

Navega las credenciales almacenadas y los códigos 2FA en una pantalla OLED SSD1306 de 128×32 píxeles con autoscroll para textos largos.

Contraseñas de un solo uso basadas en tiempo (TOTP)

Genera códigos 2FA de 6 dígitos localmente y offline.
Requiere una sincronización horaria única desde el host vía USB — nunca a través de Internet.

Open source y transparente

Cada línea de firmware y cada esquema de hardware es público.
Audita, verifica y contribuye para mejorar el dispositivo.

62 slots de credenciales

Almacena hasta 62 entradas de sitio/usuario/contraseña más secretos TOTP opcionales, todas cifradas con AES-128 CBC en reposo en la EEPROM externa.

Seguridad de un vistazo

CapaTecnologíaUbicación
CifradoAES-128 ECB (hardware, comando AES del ATECC608A) + encadenamiento CBC softwareATECC608A + MCU SAMD21
Clave de cifrado16 B aleatorios (TRNG del ATECC608A, escritos por el chip al primer arranque)Slot 8 del ATECC608A (IsSecret=1, nunca legible)
IV16 B aleatorios (TRNG del ATECC608A)EEPROM 0x0010
Hashing del PINSHA-256(PIN ∥ chip_serial)MCU (software)
Salt del PINSerial del chip de 9 bytesConfig Zone del ATECC608A
Rate-limit del PINCounter0 monotónico (hardware)ATECC608A
Presupuesto de PIN50 intentos antes de borradoUmbral en EEPROM 0x0020
Integridad de arranqueVerificación de firma ECDSA P-256Bootloader
Protección físicaEncapsulado en resina epoxy + fuse BOOTPROTPCB / fuses del SAMD21

Resumen de la documentación

Inicio rápido

Guía paso a paso para flashear el firmware, crear tu PIN maestro y almacenar tus primeras credenciales.

Hardware

Esquemas eléctricos, lista de componentes y mapa de memoria EEPROM para el M24C64-WMN6TP.

Firmware

Explora cómo interactúan los módulos: display, navegación por menús, almacenamiento EEPROM, salida de teclado y generación TOTP.

Seguridad

Entiende cómo el cifrado AES-128 CBC, la verificación de PIN asistida por el ATECC608A, la generación del IV y el rate-limiting hardware aseguran tus datos.

Cumplimiento y open source

Certificaciones, licencias y directrices de contribución de la comunidad.

Soporte

Preguntas frecuentes, pasos de resolución de problemas y cómo contactar con la comunidad de ZeroKeyUSB o solicitar ayuda profesional.

¿Necesitas ayuda?

Visita zerokeyusb.com

Encuentra guías de usuario, actualizaciones y recursos de la comunidad para ZeroKeyUSB.