🛡️ ¿Cómo integrar el análisis de vulnerabilidades, las pruebas automatizadas y el despliegue continuo en una aplicación web?
En este artículo comparto el desarrollo de EstadoSeguro, una aplicación web construida con Python y Flask que incorpora pruebas continuas con Pytest, análisis dinámico de seguridad mediante Nuclei, automatización con GitHub Actions y publicación en la nube utilizando Render.
🚀 1. Introducción
En el desarrollo de software actual, la seguridad no puede ser una fase tardía. No basta con entregar funcionalidades correctas; es necesario implementar verificaciones automáticas que detecten malas configuraciones y fallos de seguridad durante el desarrollo.
Aquí es donde entra el enfoque DevSecOps (Development, Security and Operations), integrando controles de seguridad en cada etapa del ciclo de vida del software mediante herramientas accesibles y repetibles.
Como parte del curso de Calidad de Software, desarrollé EstadoSeguro, una plataforma para monitorizar y visualizar incidencias de servicios. El objetivo principal fue demostrar que es totalmente viable aplicar DevSecOps en proyectos pequeños utilizando tecnologías libres y plataformas gratuitas.
📊 Resumen del proyecto
| Componente | Detalle |
|---|---|
| Aplicación | EstadoSeguro |
| Lenguaje | Python 3.12 |
| Framework | Flask |
| Pruebas automatizadas | 12 aprobadas |
| Herramienta de seguridad | Nuclei v3.11.1 |
| Integración continua | GitHub Actions |
| Plataforma Cloud | Render (Servicio web gratuito) |
| Estado | Aplicación pública y operativa |
🔗 Enlaces del proyecto
- Repositorio en GitHub: EstadoSeguro en GitHub
- Aplicación desplegada: EstadoSeguro en Render
- Integración continua: Workflow verificado en GitHub Actions -Video: https://www.youtube.com/watch?v=scA5TlUXVIA ## 🎯 2. Objetivos y herramientas utilizadas ### Objetivos del proyecto
- Desarrollar una aplicación funcional en Python y Flask.
- Crear pruebas automatizadas con Pytest para validar el comportamiento del sistema.
- Diseñar plantillas YAML en Nuclei para evaluar respuestas HTTP.
- Integrar el escaneo de seguridad dentro del flujo de GitHub Actions.
- Desplegar automáticamente en Render solo cuando las pruebas sean exitosas. ### Tecnologías seleccionadas
- Python & Flask: Construcción del backend y API REST.
- HTML, CSS & Jinja: Interfaz de usuario dinámica y adaptable.
- Pytest: Ejecución de pruebas unitarias y de integración.
- Nuclei: Comprobaciones dinámicas de seguridad HTTP.
- GitHub Actions: Orquestación de pruebas y escaneos automáticos.
- Render: Alojamiento y despliegue del servicio web.
-
Gunicorn: Servidor WSGI para producción.
### ¿Por qué Nuclei?
Nuclei (de ProjectDiscovery) permite definir peticiones HTTP y reglas lógicas en plantillas YAML sencillas. Se ejecuta en segundos dentro del pipeline de CI/CD y forma parte del catálogo comunitario de escáneres de OWASP. En este proyecto se crearon dos plantillas personalizadas para mantener un alcance controlado y no invasivo.
## 💻 3. La aplicación EstadoSeguro
EstadoSeguro permite consultar y filtrar incidencias técnicas. Para facilitar el despliegue y portabilidad, utiliza un conjunto de datos locales estructurados.
### Endpoints principales
| Método | Endpoint | Utilidad |
|---|---|---|
| GET |
/| Panel principal con lista de incidencias | | GET |/incidencias/<id>| Vista detallada de una incidencia | | GET |/api/incidencias| Consulta de incidencias en formato JSON | | GET |/api/incidencias/<id>| Consulta JSON de una incidencia puntual | | GET |/health| Verificación de estado del servidor | El endpoint/healthresponde con código200 OKy el JSON:
{ "servicio": "EstadoSeguro", "status": "ok" }
Esta ruta es utilizada tanto por GitHub Actions para confirmar que el servidor levantó antes de escanearlo, como por Render para verificar la salud del contenedor.
Controles de seguridad en el código
- Validación y corte de longitud en el parámetro de búsqueda
q(máximo 100 caracteres). - Verificación del filtro
estadocontra una lista blanca fija. - Cabeceras de protección HTTP activadas:
Content-Security-Policy,X-Content-Type-Options,X-Frame-Options,Referrer-PolicyyPermissions-Policy. - Modo debug deshabilitado y
SECRET_KEYconfigurada mediante variables de entorno. ## 🧪 4. Pruebas automatizadas con Pytest Antes de analizar la seguridad, se programaron 12 pruebas con Pytest para evaluar vistas, filtros, escape de contenido contra inyecciones HTML y respuestas de la API. Comando de ejecución:
python -m pytest -v
Resultados obtenidos
- Total de pruebas: 12
- Pruebas aprobadas: 12
- Pruebas fallidas: 0
-
Estado final: Satisfactorio tanto en local como en GitHub Actions.
## 🛡️ 5. Análisis de seguridad con Nuclei
Las pruebas de seguridad se guardan en
.nuclei/templates/y analizan el comportamiento HTTP: -
estadoseguro-health.yaml: Realiza una petición GET a/healthy confirma que devuelva código 200 y el JSON esperado. Es de severidad Informativa (Info). -
missing-security-headers.yaml: Comprueba la presencia de las cabeceras críticasContent-Security-Policy,X-Content-Type-OptionsyX-Frame-Options. Si falta alguna, genera un hallazgo de severidad Baja (Low). ### Comando del escaneo en el pipeline
-u http://127.0.0.1:5000 -t .nuclei/templates -rl 2 -c 1 -timeout 5 -retries 0 -no-interactsh -disable-update-check -jsonl -o artifacts/nuclei.jsonl
El análisis se ejecuta contra la instancia local en 127.0.0.1:5000 dentro del runner de GitHub Actions, sin realizar peticiones contra el dominio público de Render.
📊 6. Resultados del escaneo
-
Coincidencias informativas: 1 (
estadosseguro-healthcheck, confirmando que/healthresponde bien). - Ausencia de cabeceras: 0 hallazgos (todas las cabeceras requeridas están presentes).
-
Vulnerabilidades detectadas: 0.
> Nota: Que un escaneo no arroje vulnerabilidades significa que el sistema superó las pruebas configuradas, pero no reemplaza una auditoría integral de código o dependencias.
## ⚙️ 7. Pipeline CI/CD en GitHub Actions
En
.github/workflows/ci-security.ymlse automatiza el proceso completo en cada push a la ramamain: - Prepara el entorno con Python e instala librerías.
- Ejecuta los 12 tests con Pytest.
- Inicia la aplicación temporalmente en segundo plano (
127.0.0.1:5000). - Espera a que
/healthresponda correctamente. - Ejecuta Nuclei mediante la acción oficial
projectdiscovery/nuclei-action@v3. - Guarda los reportes JSONL como artefactos descargables de la ejecución.
## ☁️ 8. Despliegue en Render
El despliegue se gestiona como código mediante
render.yaml:
services:
- type: web
name: estadosseguro
runtime: python
plan: free
buildCommand: pip install -r requirements.txt
startCommand: gunicorn app:app --bind 0.0.0.0:$PORT --workers 2 --threads 4 --timeout 60
healthCheckPath: /health
autoDeployTrigger: checksPass
envVars:
- key: PYTHON_VERSION
value: 3.12.10
- key: SECRET_KEY
generateValue: true
La directiva autoDeployTrigger: checksPass asegura que Render solo publique la nueva versión si todas las comprobaciones de GitHub Actions concluyeron con éxito.
🏆 9. Conclusiones
- Aseguramiento continuo: La combinación de Pytest y GitHub Actions permite validar la funcionalidad sin depender de verificaciones manuales.
- Seguridad automatizada: Nuclei permite auditar cabeceras y respuestas HTTP de forma rápida y controlada en cada commit.
- Despliegues confiables: Vincular el despliegue en Render al éxito de las pruebas de CI garantiza que solo código validado llegue a producción.
- Cultura DevSecOps: Demostramos que es posible aplicar buenas prácticas de seguridad y automatización en proyectos universitarios sin incurrir en costos de infraestructura. ## 📚 10. Referencias
- OWASP Vulnerability Scanning Tools
- Documentación de Nuclei Scanner
- Documentación de GitHub Actions
- Documentación de Render Blueprints
- Documentación de Flask
- Documentación de Pytest
Top comments (0)