O que Assistente de Auditoria de Dependências faz?
Este skill ajuda a auditar as dependências de um projeto em busca de vulnerabilidades de segurança, pacotes desatualizados e problemas de conformidade de licenças.
Quando Usar Este Skill
- O usuário solicita uma auditoria de dependências ou verificação de segurança
- Antes de grandes lançamentos ou implantações
- O usuário pergunta sobre pacotes desatualizados ou vulnerabilidades
- Necessidade de revisão de conformidade de licenças
- O usuário menciona "npm audit", "segurança", "dependências" ou "vulnerabilidades"
Instruções
1. Detectar Gerenciador de Pacotes
Identifique qual(is) gerenciador(es) de pacotes o projeto utiliza:
JavaScript/Node.js:
- npm:
package.json+package-lock.json - Yarn:
package.json+yarn.lock - pnpm:
package.json+pnpm-lock.yaml
Python:
- pip:
requirements.txtousetup.py - Poetry:
pyproject.toml+poetry.lock - Pipenv:
Pipfile+Pipfile.lock
Ruby:
- Bundler:
Gemfile+Gemfile.lock
Java:
- Maven:
pom.xml - Gradle:
build.gradleoubuild.gradle.kts
Go:
- Go modules:
go.mod+go.sum
Rust:
- Cargo:
Cargo.toml+Cargo.lock
PHP:
- Composer:
composer.json+composer.lock
Use Glob para encontrar esses arquivos.
2. Executar Auditoria de Segurança
Execute o comando de auditoria apropriado com base no gerenciador de pacotes:
npm: npm audit --json ou npm audit
Yarn: yarn audit --json ou yarn audit
pnpm: pnpm audit --json
pip: pip-audit ou 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
Analise a saída para identificar:
- Número de vulnerabilidades por gravidade (crítica, alta, moderada, baixa)
- Pacotes e versões afetados
- Correções disponíveis (atualizações ou patches)
- Identificadores CVE
3. Verificar Pacotes Desatualizados
Identifique pacotes que possuem versões mais novas disponíveis:
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
Categorize as atualizações:
- Atualizações de patch (1.0.0 → 1.0.1): Correções de bugs, seguras para atualizar
- Atualizações menores (1.0.0 → 1.1.0): Novos recursos, geralmente seguras
- Atualizações principais (1.0.0 → 2.0.0): Mudanças que quebram compatibilidade, exigem testes
4. Verificação de Conformidade de Licenças
Revise as licenças de todas as dependências:
Passos:
- Extraia licenças dos metadados do pacote
- Identifique os tipos de licença (MIT, Apache-2.0, GPL, etc.)
- Sinalize licenças potencialmente problemáticas (GPL, AGPL em projetos comerciais)
- Verifique licenças ausentes ou desconhecidas
- Consulte a matriz de compatibilidade de licenças em
reference/licenses.md
Ferramentas:
- npm:
npx license-checker --jsonounpm-license-crawler - Python:
pip-licenses - Ruby:
license_finder - Go:
go-licenses
Categorias de licença:
- Permissivas: MIT, Apache-2.0, BSD - Geralmente seguras
- Copyleft fraco: LGPL, MPL - Requer revisão
- Copyleft forte: GPL, AGPL - Pode restringir uso comercial
- Desconhecida: Licenças ausentes ou personalizadas - Necessita investigação
5. Analisar Árvore de Dependências
Entenda a estrutura de dependências:
Diretas vs Transitivas:
- Diretas: Listadas em package.json/requirements.txt
- Transitivas: Dependências das dependências
Identifique problemas:
- Pacotes duplicados em versões diferentes
- Árvores de dependência profundas (potencial para conflitos)
- Pacotes abandonados (sem atualizações há mais de 2 anos)
- Dependências transitivas de alto risco
Comandos:
- npm:
npm ls --all - Yarn:
yarn why <pacote> - pip:
pipdeptree - Maven:
mvn dependency:tree
6. Priorizar Vulnerabilidades
Priorize vulnerabilidades com base em:
Níveis de gravidade:
- Crítica: Execução remota de código, escalonamento de privilégios
- Alta: SQL injection, XSS, bypass de autenticação
- Moderada: DoS, divulgação de informações
- Baixa: Problemas menores, casos de borda
Explorabilidade:
- Exploits conhecidos em circulação
- PoC (Prova de Conceito) disponível
- Requer condições especiais
Exposição:
- Dependências de produção vs dependências de desenvolvimento
- Dependências diretas vs dependências transitivas profundas
- Caminhos de código realmente utilizados na aplicação
7. Gerar Recomendações
Para cada problema encontrado, forneça:
Vulnerabilidades:
Pacote: [email protected]
Gravidade: Alta
CVE: CVE-2020-8203
Problema: Poluição de protótipo
Recomendação: Atualizar para [email protected] ou superior
Comando: npm install [email protected]
Pacotes desatualizados:
Pacote: [email protected]
Atual: 16.14.0
Última: 18.2.0
Tipo: Atualização principal
Recomendação: Testar minuciosamente antes de atualizar (mudanças que quebram compatibilidade)
Notas: Consulte o guia de migração em https://react.dev/blog/2022/03/08/react-18-upgrade-guide
Problemas de licença:
Pacote: [email protected]
Licença: GPL-3.0
Problema: Licença GPL pode conflitar com código proprietário
Recomendação: Encontrar alternativa com licença permissiva ou consultar jurídico
Alternativas: [lista de pacotes similares com licenças MIT/Apache]
8. Estratégia de Atualização
Sugira uma abordagem de atualização:
Atualizações seguras (automatizadas):
- Atualizações de patch sem mudanças que quebram compatibilidade
- Correções de segurança para vulnerabilidades
- Atualização:
npm updateounpm audit fix
Atualizações cuidadosas (testes manuais):
- Avanços de versão menor
- Atualizações principais de pacotes bem mantidos
- Atualizar individualmente e testar
Pesquisa necessária:
- Mudanças principais que quebram compatibilidade
- Pacotes abandonados (encontrar alternativas)
- Conflitos de licença
9. Gerar Relatório de Resumo
Forneça um resumo abrangente da auditoria:
Relatório de Auditoria de Dependências
=======================================
Visão Geral:
- Total de dependências: 150 (120 diretas, 30 transitivas)
- Vulnerabilidades: 5 (1 alta, 3 moderadas, 1 baixa)
- Pacotes desatualizados: 23
- Problemas de licença: 2
Vulnerabilidades de Segurança:
[Listar por gravidade com recomendações de correção]
Pacotes Desatualizados:
[Categorizados por tipo de atualização: patch/menor/principal]
Conformidade de Licenças:
[Listar licenças com quaisquer preocupações]
Ações Recomendadas:
1. [Imediato] Corrigir vulnerabilidades de alta gravidade
2. [Em breve] Atualizar pacotes com vulnerabilidades moderadas
3. [Revisar] Abordar problemas de conformidade de licenças
4. [Opcional] Atualizar pacotes desatualizados para a versão mais recente
Comandos para executar:
npm audit fix # Corrigir vulnerabilidades automaticamente
npm update # Atualizar para as versões compatíveis mais recentes
10. Monitoramento Contínuo
Sugira práticas contínuas:
- Auditorias automatizadas: Executar no pipeline CI/CD
- Dependabot/Renovate: Criar PRs automaticamente para atualizações
- Revisões regulares: Auditorias mensais ou trimestrais
- Alertas de segurança: Ativar alertas de segurança do GitHub/GitLab
- Arquivos de bloqueio: Commitar arquivos de bloqueio para builds reproduzíveis
Melhores Práticas
- Corrigir vulnerabilidades prontamente: Especialmente as de alta gravidade/críticas
- Testar atualizações: Mesmo atualizações de patch podem causar problemas
- Ler changelogs: Entender o que mudou antes de atualizar
- Usar arquivos de bloqueio: Garantir instalações consistentes em diferentes ambientes
- Minimizar dependências: Menos dependências = superfície de ataque menor
- Revisar novas adições: Auditar antes de adicionar novas dependências
- Manter-se atualizado: Atualizações regulares são mais fáceis que grandes saltos
- Documentar decisões: Por que certos pacotes estão fixados ou não atualizados
Melhores Práticas de Segurança
- Nunca commitar segredos em dependências ou arquivos de ambiente
- Revisar o código-fonte de dependências para pacotes populares/críticos
- Usar registros privados para pacotes internos
- Ativar 2FA em contas de registro de pacotes
- Usar SRI (Subresource Integrity) para recursos CDN
- Escanear imagens de contêiner se usar Docker
Arquivos de Suporte
scripts/check-licenses.sh: Extrair e verificar informações de licençareference/licenses.md: Matriz de compatibilidade de licençasreference/common-vulnerabilities.md: Padrões comuns de vulnerabilidade
Referência de Comandos Comuns
npm:
npm audit # Mostrar vulnerabilidades
npm audit fix # Corrigir automaticamente vulnerabilidades
npm audit fix --force # Forçar atualizações principais
npm outdated # Verificar pacotes desatualizados
npm update # Atualizar para a versão compatível mais recente
Yarn:
yarn audit # Mostrar vulnerabilidades
yarn upgrade-interactive # Atualização interativa
yarn outdated # Verificar desatualizados
pip:
pip-audit # Auditar vulnerabilidades
pip list --outdated # Verificar desatualizados
pip install --upgrade # Atualizar pacote
Poetry:
poetry check # Verificar arquivo de bloqueio
poetry show --outdated # Mostrar desatualizados
poetry update # Atualizar pacotes
Cargo:
cargo audit # Auditar vulnerabilidades
cargo outdated # Verificar desatualizados
cargo update # Atualizar pacotes