DocumentaciónAjuda

Revisar as dependências das suas aplicações

Indique em quais pastas estão suas aplicações e o ARGUNIS verifica as bibliotecas dos lockfiles delas contra os avisos do OSV, com a versão para a qual atualizar.

Nesta página

Dependências de aplicações verifica as bibliotecas que suas aplicações usam (o que dizem os lockfiles delas) contra a base pública de vulnerabilidades OSV e diz quais estão afetadas e para qual versão atualizar. Cobre:

  • npm (Node.js): package-lock.json, npm-shrinkwrap.json, yarn.lock e pnpm-lock.yaml.

  • PyPI (Python): requirements.txt (só as linhas com ==), poetry.lock e Pipfile.lock.

  • Packagist (PHP): composer.lock.

  • Maven (Java): pom.xml (só dependências com versão escrita) e gradle.lockfile.

  • NuGet (.NET): packages.lock.json e os .csproj com versão exata.

  • Go: go.mod (ou go.sum se não houver go.mod).

  • RubyGems (Ruby): Gemfile.lock.

Antes de começar

  • Permissão Ver em Vulnerabilidades e os termos de uso aceitos.

  • Agente de servidor 3.9.0 ou posterior no host onde estão as aplicações.

  • Permissão para configurar o agente (Infraestrutura).

Indicar as pastas das suas aplicações

  1. Entre em Infraestrutura, abra o servidor e vá em Agente → Configurar plugins.

  2. Em Geral, escreva em Pastas de aplicações um caminho por linha, por exemplo /srv/tienda ou C:\inetpub\api.

  3. Salve. O agente procura os lockfiles nessas pastas em poucos minutos e depois a cada 6 horas.

O agente só lê essas pastas (até 8 níveis, sem entrar em node_modules, vendor nem .git) e envia o nome, a versão e o caminho de cada dependência. Ele nunca envia os arquivos. Ele não verifica o que está dentro dos contêineres Docker: indique a pasta do host onde está o código.

Revisar os avisos

  1. Entre em Segurança (SIEM) → Vulnerabilidades → Dependências de aplicações.

  2. Filtre por status (Abertos, Resolvidos ou Todos), ecossistema, severidade, servidor, caminho da aplicação ou marque Somente KEV.

  3. Confira cada linha: o servidor, o lockfile onde está, o pacote e a versão, o aviso (CVE ou id do OSV) com seu CVSS e o que fazer.

  4. Clique no aviso para ver o resumo, os outros nomes dele (CVE, GHSA) e os links.

  5. Atualize a dependência para a versão indicada em O que fazer e gere o lockfile de novo. Quando o agente informar a nova versão, o aviso passa sozinho a Resolvido.

Comece pelos marcados como KEV: são vulnerabilidades que já estão sendo exploradas.

Notificações automáticas

  • Um aviso KEV abre um incidente crítico (ou, se você tiver o SIEM, uma detecção crítica com seu caso).

  • Um aviso crítico (CVSS 9 ou mais) abre um incidente de advertência (ou uma detecção alta).

  • Chega uma única notificação por servidor, com a lista: por exemplo, «/srv/tienda/package-lock.json: lodash 4.17.15 (npm) — CVE-2021-23337 alta (CVSS 7.2) — atualize para 4.17.21».

  • Ela se fecha sozinha quando o servidor não tem mais essa versão nos lockfiles.

Você também vê esses avisos na ficha do servidor (Segurança).

O que levar em conta

  • Só são verificadas versões exatas: um intervalo como >=2.0 em requirements.txt ou [1.0,2.0) em um .csproj não pode ser verificado. Use um lockfile.

  • No pom.xml só contam as versões escritas no mesmo arquivo; para tudo o que o Maven resolve, use gradle.lockfile ou deixe o pom.xml com versões explícitas.

  • Se o OSV não indicar a versão que corrige, você verá Sem versão corrigida publicada.

  • As dependências são verificadas quando o agente informa uma mudança e uma vez por dia. Se a consulta ao OSV não responder, os avisos ficam como estavam até a próxima verificação.

Relacionado

Pesquisar em Argunis Monitoring

Digite pelo menos 2 letras para pesquisar em Argunis Monitoring.

↑↓ navegar · Enter abrir · Esc fechar