Seguridad — Visión general¶

qrsgen se diseña con defense-in-depth: ninguna capa es suficiente por sí sola, pero la combinación cubre los tres vectores más probables.

Modelo de amenaza¶

qrsgen vive en una overlay docker compartida con el downstream y, típicamente, un orquestador como n8n. Asumimos tres vectores principales:

Compromiso lateral en LAN — otro container del overlay queda vulnerado. ¿Qué puede hacer contra qrsgen?
Compromiso del propio qrsgen — un atacante gana RCE en el proceso. ¿Qué puede exfiltrar o usar como pivote?
MITM en el WebSocket WhatsApp — un atacante con acceso al host o a la red, ¿puede interceptar el tráfico hacia Meta?

Las siete capas mitigan estos vectores en distinta medida. Cada capa documenta qué hace, cómo configurarla, qué mitiga y cómo verificarla.

Capas¶

Material complementario¶

Glosario¶

Defense-in-depth: estrategia de seguridad donde se aplican varias capas independientes. Ninguna por sí sola es perfecta, pero juntas hacen muy difícil el compromiso completo.

Modelo de amenaza (threat model): análisis sistemático de qué ataques son realistas contra un sistema y qué defensas tiene contra cada uno.

Vector de ataque: vía concreta por la que un atacante puede causar daño (acceso lateral en LAN, RCE en el proceso, MITM en red, etc.).

Compromiso lateral: cuando un atacante ya está dentro del overlay (porque comprometió otro container) e intenta moverse hacia qrsgen.

RCE (Remote Code Execution): vulnerabilidad que permite a un atacante ejecutar código arbitrario en el proceso víctima. La worst-case en seguridad de aplicaciones.

MITM (Man In The Middle): ataque donde el atacante se interpone entre dos partes y lee/modifica el tráfico. TLS lo previene cuando el cert es válido.

Mitigar: reducir el impacto o la probabilidad de un vector. No elimina el riesgo, pero lo hace mucho menos práctico.