Saltar para o conteúdo principal
Use o Supply Chain Intel para descobrir se uma versão de risco de um pacote npm ou PyPI já está em um repositório ou está entrando em um pull request no GitHub. Se o recurso estiver habilitado na sua instância e você tiver acesso aos repositórios, abra Supply chain → Intel. A aba Overview reúne exposições, campanhas, detecções recentes e mudanças nos registros de pacotes que afetam as versões em uso. Para ver o inventário completo de dependências, vulnerabilidades conhecidas ou componentes de IA de uma branch, abra a aba Inventory do repositório. Consulte a Análise de Composição de Software para ver como executar os scans.

Identifique e trate exposições

  1. Abra Exposure e procure a versão que deseja investigar. A lista principal reúne versões sinalizadas por malware ou retiradas do registro por motivos de segurança. Ajuste o escopo para incluir os repositórios que você precisa revisar.
  2. Use Impact para ver onde uma versão afetada aparece em scans indexados ou PRs abertos. Confira a versão, a branch ou o PR e o link para a evidência. Selecione What to do na exposição para abrir a página do pacote na versão correspondente.
  3. Substitua ou remova a versão afetada, gere e faça commit do lockfile atualizado e execute um novo scan de dependências na branch afetada. Confira novamente o inventário e a exposição depois que o novo scan for indexado.
Use Detections para investigar sinais individuais do ZeroPath, de fontes de avisos e de registros de pacotes. Confira a fonte e as evidências antes de agir sobre um sinal não confirmado. Use Changes para ver eventos nos registros de pacotes para versões encontradas em branches padrão indexadas ou introduzidas em PRs abertos. O Intel cruza as versões dos repositórios que você pode visualizar com dados de scans indexados e verificações de pull requests. Se um resultado esperado estiver ausente, confira a branch, o escopo de repositórios e a cobertura dos scans. Você pode assinar o evento SUPPLY_CHAIN_MALWARE_DETECTED para receber alertas de exposição a malware nas suas ferramentas.

Investigue uma campanha de malware

Abra Campaigns para ver pacotes e versões relacionados a campanhas de malware conhecidas. A lista mostra se versões afetadas aparecem em repositórios que você pode visualizar ou fizeram a verificação do Supply Chain Intel falhar em um pull request.
  1. Abra uma campanha e consulte Your exposure, quando disponível, para identificar os repositórios afetados e acessar as evidências das verificações de PR.
  2. Revise os pacotes ou versões da campanha. Abra um pacote e selecione a versão afetada para ver as evidências e as orientações de correção.
  3. Priorize versões em branches ativas e revise os PRs sinalizados antes do merge.
Use SUPPLY_CHAIN_CAMPAIGN_VALIDATED para campanhas recém-validadas pela ZeroPath e SUPPLY_CHAIN_CAMPAIGN_IMPACT para versões de uma campanha encontradas em scans da branch padrão. Consulte a configuração de webhooks.

Consulte uma versão de pacote

Em Intel, informe um pacote e a versão no campo Package or advisory ID e pressione Enter. Por exemplo, busque npm:lodash@4.17.21 ou pypi:requests@2.32.3. Confirme a versão no cabeçalho do pacote antes de ler o resultado. Abra Analysis ou Advisories para ver as evidências e consulte Way out em Overview, quando disponível. Abra Your usage para ver as versões do pacote encontradas nos seus repositórios e PRs. Busque pelo ID de um aviso de malware para abrir Impact. Consulte Where it is para identificar os repositórios e as versões correspondentes. Use Export CSV para compartilhar os resultados encontrados.

Verifique mudanças de dependências no GitHub

A verificação ZeroPath Supply Chain Intel avalia as versões introduzidas em arquivos de dependências npm e PyPI suportados. Ela é executada em paralelo com o scan de PR habitual, para que os revisores vejam qual versão correspondeu a uma regra da política antes do merge.
  1. Nas configurações de pull requests do repositório, ative Pull Request Scanning e Post Check Status. As verificações do provedor Git também precisam estar habilitadas para o repositório.
  2. Em Supply chain → Policy → Pull request check, ative Check pull requests. Ative Bot pull requests para verificar atualizações de dependências propostas por serviços como Dependabot e Renovate.
  3. Abra ou atualize um PR no GitHub. Encontre o resultado no GitHub ou em Intel → Pull requests. Abra os detalhes da verificação para ver a regra aplicada e os arquivos de dependências que ela não conseguiu resolver.
  4. Para exigir o resultado antes do merge, adicione o nome da verificação publicada ao ruleset do GitHub ou às configurações de proteção de branch.
Os lockfiles suportados incluem package-lock.json, npm-shrinkwrap.json, pnpm-lock.yaml, yarn.lock, Pipfile.lock, poetry.lock e uv.lock. Quando um manifesto suportado não tem lockfile, a verificação pode ler as versões fixadas no manifesto. Faça commit do lockfile para fornecer as versões resolvidas das dependências diretas e transitivas.

Configure a política e revise exceções

Abra Supply chain → Policy → Rules para escolher uma predefinição da organização (Low noise, Default ou Strict) e configurar regras. Use Tag overrides ou Repository overrides para aplicar regras a um subconjunto de repositórios. Para alterar a política, você precisa de permissão para editar as configurações do scanner da organização. Se mais de uma regra corresponder a uma versão, prevalece a ação mais restritiva entre as ocorrências sem exceção aplicável. Use Pull request check para configurar como a verificação trata dados de inteligência desatualizados e avisos. Use Internal sources para identificar nomes de pacotes privados ou registros da sua organização. Se precisar usar uma versão sinalizada, siga as instruções de exceção no GitHub. As regras aplicadas determinam se é possível criar uma exceção e se ela exige aprovação. Consulte solicitações, exceções ativas e datas de expiração em Intel → Exceptions.