crypto-scanner

Escanea tu código base en busca de criptografía vulnerable a la computación cuántica antes de que sea demasiado tarde.

Inicio Rápido • ¿Por qué Prepararse para la Cuántica? • Uso • Niveles de Riesgo • CI/CD • Acerca de

---

Resumen

Crypto Scanner es una herramienta CLI que escanea tu código base en busca de algoritmos criptográficos y genera evaluaciones de riesgo de vulnerabilidad cuántica. Analiza código fuente, archivos de configuración y certificados X.509 para identificar criptografía que será quebrada por ordenadores cuánticos.

Desarrollado por Quantum Shield Labs — ayudando a las organizaciones a prepararse para la era post-cuántica.

---

¿Por qué Prepararse para la Cuántica?

La Amenaza Cuántica es Real

Se proyecta que los Ordenadores Cuánticos Criptográficamente Relevantes (CRQCs, por sus siglas en inglés) capaces de romper RSA y ECC surjan para el 2033. Esto no es ciencia ficción: es un cronograma para el que los principales gobiernos y empresas se están preparando activamente.

Cosecha Ahora, Descifra Después (HNDL)

Los adversarios ya están recopilando datos cifrados hoy con la intención de descifrarlos una vez que los ordenadores cuánticos estén disponibles. Si tus datos tienen valor a largo plazo (registros médicos, datos financieros, secretos comerciales, comunicaciones gubernamentales), ya están en riesgo.

Por Qué No Puedes Esperar

Desafío	Realidad
Complejidad de migración	Los códigos base grandes tardan de 3 a 5+ años en migrar
Profundidad en la cadena de suministro	Tus dependencias contienen criptografía vulnerable que no ves
Mandatos de cumplimiento	Los estándares PQC del NIST (ML-KEM, ML-DSA) ya están finalizados
Plazo CNSA 2.0	La NSA exige algoritmos resistentes a la cuántica para 2033

El Algoritmo de Shor: La Amenaza

El algoritmo de Shor, ejecutándose en un ordenador cuántico suficientemente potente, puede factorizar eficientemente números enteros grandes y calcular logaritmos discretos. Esto rompe:

• RSA (todos los tamaños de clave)
• ECDSA/ECC (todas las curvas)
• DH/ECDH (intercambio de claves)
• DSA (firmas digitales)

El Primer Paso: Inventario

No puedes migrar lo que no sabes que tienes. Crypto Scanner proporciona el inventario criptográfico que es el primer paso esencial en cualquier programa de preparación cuántica.

📘 Más información: Lee el Manual de Quantum Shield Labs para obtener una guía completa de migración.

---

Inicio Rápido

Obtén tu primer escaneo de vulnerabilidad cuántica en menos de 60 segundos:

# Instalar desde PyPI
pip install crypto-scanner

# Escanea tu proyecto
crypto-scanner scan .

# Genera un informe HTML ejecutivo
crypto-scanner scan . --html --output quantum-risk-report.html

Eso es todo. Ahora tienes un inventario criptográfico completo de tu código base.

---

Instalación

Desde PyPI (Recomendado)

pip install crypto-scanner

Desde el Código Fuente

git clone https://github.com/mbennett-labs/crypto-scanner.git
cd crypto-scanner
pip install -e .

Requisitos

• Python 3.10 o superior
• Funciona en Windows, macOS y Linux

---

Uso

Comandos Básicos

# Escanea un directorio (salida JSON a stdout)
crypto-scanner scan <directorio>

# Muestra los tipos de archivo compatibles y las clasificaciones de riesgo
crypto-scanner info

# Muestra la versión
crypto-scanner --version

Opciones de CLI

Opción	Corta	Descripción
--html		Generar informe HTML en lugar de JSON
--output	-o	Guardar informe en archivo (en lugar de stdout)
--verbose	-v	Mostrar progreso detallado del escaneo
--exclude	-e	Patrones de exclusión adicionales (repetible)
--version	-V	Mostrar versión y salir

Ejemplos

# Escanear con salida detallada
crypto-scanner scan ./src --verbose

# Guardar informe JSON en archivo
crypto-scanner scan . --output crypto-audit.json

# Generar informe HTML con marca para partes interesadas
crypto-scanner scan . --html --output quantum-assessment.html

# Excluir directorios específicos
crypto-scanner scan . --exclude vendor --exclude legacy

# Excluir patrones de archivo
crypto-scanner scan . --exclude "*.test.js" --exclude "*.spec.ts"

# Combinar opciones
crypto-scanner scan ./backend -v --exclude node_modules -o report.json

Exclusiones Predeterminadas

Las siguientes están excluidas automáticamente para evitar escanear dependencias:

.git, .svn, .hg          # Control de versiones
node_modules, vendor     # Dependencias de paquetes
__pycache__, .pytest_cache, .mypy_cache
.venv, venv, env         # Entornos virtuales
dist, build, out         # Salidas de compilación
.idea, .vscode           # Directorios de IDE
site-packages, third_party

---

Clasificación de Riesgo

Crítico — Vulnerable a la Cuántica

Algoritmos que serán completamente quebrados por el algoritmo de Shor:

Algoritmo	Tamaños de Clave	Impacto Cuántico	Acción Recomendada
RSA	Todos (1024-4096+)	Completamente roto	Migrar a ML-KEM + ML-DSA
ECDSA/ECC	Todas las curvas	Completamente roto	Migrar a ML-DSA
DH/ECDH	Todos	Intercambio de claves roto	Migrar a ML-KEM
DSA	Todos	Completamente roto	Migrar a ML-DSA

Alto — Obsoleto o Débil

Algoritmos con vulnerabilidades clásicas conocidas:

Algoritmo	Problema	Acción Recomendada
MD5	Ataques de colisión, completamente roto	Reemplazar por SHA-3 o SHA-256
SHA-1	Ataques de colisión demostrados	Reemplazar por SHA-256+
DES	Clave de 56 bits, trivialmente roto	Reemplazar por AES-256
3DES	Ataques meet-in-the-middle	Reemplazar por AES-256
AES-128	El algoritmo de Grover reduce la seguridad	Actualizar a AES-256

Medio — Monitorear

Algoritmos que actualmente son seguros pero deben ser monitoreados:

Algoritmo	Estado	Acción Recomendada
SHA-256	Seguro, Grover reduce a 128 bits	Planificar migración a SHA-3
SHA-384	Seguro	Monitorear desarrollos
SHA-512	Buena resistencia cuántica	Monitorear desarrollos
TLS 1.2	Seguro pero envejeciendo	Preferir TLS 1.3

Bajo — Adecuado o Resistente a la Cuántica

Algoritmos que proporcionan una protección adecuada: