> ## Documentation Index
> Fetch the complete documentation index at: https://zeropath.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Supply Chain Intel

> Identifique versões de risco de pacotes npm e PyPI nos seus repositórios e verifique mudanças de dependências antes do merge no GitHub.

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](https://zeropath.com/docs/pt/sca/ai-inventory.md) de uma branch, abra a aba
**Inventory** do repositório. Consulte a
[Análise de Composição de Software](https://zeropath.com/docs/pt/sca/overview.md) 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](https://zeropath.com/docs/pt/sca/overview.md#how-dependency-data-gets-in)
   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](https://zeropath.com/docs/pt/sca/coverage.md).

Você pode assinar o evento
[`SUPPLY_CHAIN_MALWARE_DETECTED`](https://zeropath.com/docs/pt/webhook/introduction#supported-event-types)
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](https://zeropath.com/docs/pt/webhook/introduction.md#configuring-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](https://zeropath.com/docs/pt/scanning/pr-scanning.md) 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.

| Ação | Efeito na verificação de PR |
| - | - |
| **Block** | Faz a verificação falhar. |
| **Warn** | Sinaliza a ocorrência. Uma verificação que só tem avisos usa o resultado configurado, **Success** ou **Neutral**. |
| **Monitor** | Registra a ocorrência sem alterar o resultado. |
| **Off** | Desativa a regra. |

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](https://zeropath.com/docs/pt/scanning/bot-commands.md#supply-chain-intel-check-exceptions).
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**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.