¿Qué hace Asistente de Auditoría de Dependencias?
Este skill ayuda a auditar las dependencias del proyecto en busca de vulnerabilidades de seguridad, paquetes desactualizados y problemas de cumplimiento de licencias.
Cuándo usar este skill
- El usuario solicita una auditoría de dependencias o una verificación de seguridad
- Antes de lanzamientos o despliegues importantes
- El usuario pregunta sobre paquetes desactualizados o vulnerabilidades
- Se necesita una revisión de cumplimiento de licencias
- El usuario menciona "npm audit", "seguridad", "dependencias" o "vulnerabilidades"
Instrucciones
1. Detectar gestor de paquetes
Identifique qué gestor(es) de paquetes utiliza el proyecto:
JavaScript/Node.js:
- npm:
package.json+package-lock.json - Yarn:
package.json+yarn.lock - pnpm:
package.json+pnpm-lock.yaml
Python:
- pip:
requirements.txtosetup.py - Poetry:
pyproject.toml+poetry.lock - Pipenv:
Pipfile+Pipfile.lock
Ruby:
- Bundler:
Gemfile+Gemfile.lock
Java:
- Maven:
pom.xml - Gradle:
build.gradleobuild.gradle.kts
Go:
- Módulos Go:
go.mod+go.sum
Rust:
- Cargo:
Cargo.toml+Cargo.lock
PHP:
- Composer:
composer.json+composer.lock
Utilice Glob para encontrar estos archivos.
2. Ejecutar auditoría de seguridad
Ejecute el comando de auditoría correspondiente según el gestor de paquetes:
npm: npm audit --json o npm audit
Yarn: yarn audit --json o yarn audit
pnpm: pnpm audit --json
pip: pip-audit o safety check
Poetry: poetry check
Bundler: bundle audit check --update
Maven: mvn dependency:tree + OWASP Dependency Check
Go: go list -m all + govulncheck
Cargo: cargo audit
Composer: composer audit
Analice la salida para identificar:
- Número de vulnerabilidades por gravedad (crítica, alta, moderada, baja)
- Paquetes y versiones afectados
- Correcciones disponibles (actualizaciones o parches)
- Identificadores CVE
3. Buscar paquetes desactualizados
Identifique paquetes que tienen versiones más recientes disponibles:
npm: npm outdated --json
Yarn: yarn outdated --json
pip: pip list --outdated
Poetry: poetry show --outdated
Bundler: bundle outdated
Cargo: cargo outdated
Go: go list -u -m all
Categorice las actualizaciones:
- Actualizaciones de parche (1.0.0 → 1.0.1): Correcciones de errores, seguras de actualizar
- Actualizaciones menores (1.0.0 → 1.1.0): Nuevas funciones, generalmente seguras
- Actualizaciones mayores (1.0.0 → 2.0.0): Cambios importantes, requieren pruebas
4. Verificación de cumplimiento de licencias
Revise las licencias de todas las dependencias:
Pasos:
- Extraer licencias de los metadatos de los paquetes
- Identificar tipos de licencia (MIT, Apache-2.0, GPL, etc.)
- Marcar licencias potencialmente problemáticas (GPL, AGPL en proyectos comerciales)
- Verificar licencias faltantes o desconocidas
- Consultar la matriz de compatibilidad de licencias en
reference/licenses.md
Herramientas:
- npm:
npx license-checker --jsononpm-license-crawler - Python:
pip-licenses - Ruby:
license_finder - Go:
go-licenses
Categorías de licencias:
- Permisivas: MIT, Apache-2.0, BSD - Generalmente seguras
- Copyleft débil: LGPL, MPL - Requiere revisión
- Copyleft fuerte: GPL, AGPL - Puede restringir el uso comercial
- Desconocidas: Licencias faltantes o personalizadas - Necesita investigación
5. Analizar árbol de dependencias
Comprenda la estructura de dependencias:
Directas vs Transitivas:
- Directas: Enumeradas en package.json/requirements.txt
- Transitivas: Dependencias de las dependencias
Identificar problemas:
- Paquetes duplicados en diferentes versiones
- Árboles de dependencias profundos (potencial de conflictos)
- Paquetes abandonados (sin actualizaciones en >2 años)
- Dependencias transitivas de alto riesgo
Comandos:
- npm:
npm ls --all - Yarn:
yarn why <paquete> - pip:
pipdeptree - Maven:
mvn dependency:tree
6. Priorizar vulnerabilidades
Priorice las vulnerabilidades según:
Niveles de gravedad:
- Crítica: Ejecución remota de código, escalada de privilegios
- Alta: Inyección SQL, XSS, omisión de autenticación
- Moderada: DoS, divulgación de información
- Baja: Problemas menores, casos extremos
Explotabilidad:
- Exploits conocidos en circulación
- PoC (Prueba de Concepto) disponible
- Requiere condiciones especiales
Exposición:
- Dependencias de producción vs dependencias de desarrollo
- Dependencias directas vs dependencias transitivas profundas
- Rutas de código realmente utilizadas en la aplicación
7. Generar recomendaciones
Para cada problema encontrado, proporcione:
Vulnerabilidades:
Paquete: [email protected]
Gravedad: Alta
CVE: CVE-2020-8203
Problema: Contaminación de prototipos
Recomendación: Actualizar a [email protected] o superior
Comando: npm install [email protected]
Paquetes desactualizados:
Paquete: [email protected]
Actual: 16.14.0
Último: 18.2.0
Tipo: Actualización mayor
Recomendación: Probar a fondo antes de actualizar (cambios importantes)
Notas: Revisar la guía de migración en https://react.dev/blog/2022/03/08/react-18-upgrade-guide
Problemas de licencia:
Paquete: [email protected]
Licencia: GPL-3.0
Problema: La licencia GPL puede entrar en conflicto con código propietario
Recomendación: Buscar una alternativa con licencia permisiva o consultar con el departamento legal
Alternativas: [lista de paquetes similares con licencias MIT/Apache]
8. Estrategia de actualización
Sugiera un enfoque de actualización:
Actualizaciones seguras (automatizadas):
- Actualizaciones de parche sin cambios importantes
- Correcciones de seguridad para vulnerabilidades
- Actualización:
npm updateonpm audit fix
Actualizaciones cuidadosas (pruebas manuales):
- Incrementos de versión menor
- Actualizaciones mayores a paquetes bien mantenidos
- Actualizar individualmente y probar
Requiere investigación:
- Cambios mayores importantes
- Paquetes abandonados (buscar alternativas)
- Conflictos de licencias
9. Generar informe resumido
Proporcione un resumen completo de la auditoría:
Informe de Auditoría de Dependencias
======================================
Resumen:
- Total de dependencias: 150 (120 directas, 30 transitivas)
- Vulnerabilidades: 5 (1 alta, 3 moderadas, 1 baja)
- Paquetes desactualizados: 23
- Problemas de licencia: 2
Vulnerabilidades de seguridad:
[Lista por gravedad con recomendaciones de corrección]
Paquetes desactualizados:
[Categorizados por tipo de actualización: parche/menor/mayor]
Cumplimiento de licencias:
[Lista de licencias con cualquier inquietud]
Acciones recomendadas:
1. [Inmediato] Corregir vulnerabilidades de alta gravedad
2. [Próximamente] Actualizar paquetes con vulnerabilidades moderadas
3. [Revisar] Abordar problemas de cumplimiento de licencias
4. [Opcional] Actualizar paquetes desactualizados a las últimas versiones
Comandos a ejecutar:
npm audit fix # Corregir vulnerabilidades automáticamente
npm update # Actualizar a las últimas versiones compatibles
10. Monitoreo continuo
Sugiera prácticas continuas:
- Auditorías automatizadas: Ejecutar en el pipeline de CI/CD
- Dependabot/Renovate: Crear automáticamente PRs para actualizaciones
- Revisiones periódicas: Auditorías mensuales o trimestrales
- Alertas de seguridad: Habilitar alertas de seguridad de GitHub/GitLab
- Archivos de bloqueo: Confirmar archivos de bloqueo para compilaciones reproducibles
Mejores prácticas
- Corregir vulnerabilidades rápidamente: Especialmente las de gravedad alta/crítica
- Probar actualizaciones: Incluso las actualizaciones de parche pueden causar problemas
- Leer los registros de cambios: Comprender qué cambió antes de actualizar
- Usar archivos de bloqueo: Asegurar instalaciones consistentes en todos los entornos
- Minimizar dependencias: Menos dependencias = superficie de ataque más pequeña
- Revisar nuevas incorporaciones: Auditar antes de agregar nuevas dependencias
- Mantenerse actualizado: Las actualizaciones periódicas son más fáciles que los saltos grandes
- Documentar decisiones: Por qué ciertos paquetes están fijados o no se actualizan
Mejores prácticas de seguridad
- Nunca confirmar secretos en dependencias o archivos de entorno
- Revisar el código fuente de las dependencias para paquetes populares/críticos
- Usar registros privados para paquetes internos
- Habilitar 2FA en las cuentas del registro de paquetes
- Usar SRI (Integridad de Subrecursos) para recursos CDN
- Escanear imágenes de contenedores si se usa Docker
Archivos de apoyo
scripts/check-licenses.sh: Extraer y verificar información de licenciasreference/licenses.md: Matriz de compatibilidad de licenciasreference/common-vulnerabilities.md: Patrones de vulnerabilidades comunes
Referencia de comandos comunes
npm:
npm audit # Mostrar vulnerabilidades
npm audit fix # Corregir vulnerabilidades automáticamente
npm audit fix --force # Forzar actualizaciones mayores
npm outdated # Buscar paquetes desactualizados
npm update # Actualizar a las últimas versiones compatibles
Yarn:
yarn audit # Mostrar vulnerabilidades
yarn upgrade-interactive # Actualización interactiva
yarn outdated # Buscar paquetes desactualizados
pip:
pip-audit # Auditar vulnerabilidades
pip list --outdated # Buscar paquetes desactualizados
pip install --upgrade # Actualizar paquete
Poetry:
poetry check # Verificar archivo de bloqueo
poetry show --outdated # Mostrar paquetes desactualizados
poetry update # Actualizar paquetes
Cargo:
cargo audit # Auditar vulnerabilidades
cargo outdated # Buscar paquetes desactualizados
cargo update # Actualizar paquetes