> ## 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.

# Segurança de CI/CD

> Revise controles do pipeline, achados em workflows e mudanças nas regras de release no GitHub e no GitLab

Use a segurança de CI/CD para ver quais controles do pipeline a ZeroPath verificou na sua branch e onde faltam evidências. A ZeroPath lê as configurações do provedor e as definições de workflow dos repositórios importados do GitHub e do GitLab. Faça as alterações no provedor e confira o resultado na próxima avaliação. O monitoramento é somente leitura.

## Abra a avaliação de um repositório

1. Em **Assets**, abra **CI/CD security** e escolha um repositório. Você também pode abrir a aba **CI/CD** na página do repositório.
2. Confira a branch no cabeçalho. O ZeroPath usa a branch configurada para scans ou a branch padrão do provedor quando nenhuma está configurada. **Checked** mostra a última coleta bem-sucedida, quando disponível.
3. Comece por **Controls**. Abra **Findings** para revisar achados nos workflows ou **Coverage** para saber quais evidências o ZeroPath conseguiu coletar.

## Interprete os resultados

### Revise os controles e as regras de release

**Controls** é a aba inicial. Abra um controle para ver a evidência, a data da observação e a ação recomendada, quando disponível.

| Status | O que significa |
| - | - |
| **Needs attention** | A configuração observada falhou no controle. Revise a recomendação. |
| **Unavailable** | O ZeroPath não conseguiu determinar o resultado. Abra **Coverage** para ver os limites da coleta. |
| **Previous evidence** | O ZeroPath está exibindo uma observação salva. Confira a data antes de usar a evidência. |
| **Pass** ou **Not applicable** | O controle passou com as evidências observadas ou não se aplica ao repositório. |

A avaliação de release destaca um controle que precisa de revisão ou indica que há evidências pendentes, desatualizadas ou indisponíveis. Selecione **Review guardrail** para abrir o controle destacado ou **Review policy evidence** para consultar os controles de release. **Observed release guardrails** indica que o ZeroPath não encontrou lacunas nos controles revisados.

### Revise os achados e a cobertura

* **Findings** mostra a gravidade, a localização e as alterações sugeridas. **Workflows** mostra os arquivos inspecionados e as lacunas de análise por arquivo.
* **Coverage** mostra quantos arquivos foram analisados, os erros de coleta e a próxima verificação agendada, quando disponível. Uma coleta parcial pode deixar arquivos ou configurações sem verificação. Se houver falha na coleta, os resultados anteriores podem continuar visíveis.
* **Changes** mostra mudanças detectadas em configurações, achados de workflows e verificações obrigatórias do GitHub. Consulte o [histórico de alterações](#histórico-de-alterações).

Para revisar achados de CI/CD em scans de código, abra [**Issues → CI/CD** (em inglês)](https://zeropath.com/docs/platform/issues.md#export-findings) e selecione **Export** para baixar os achados no escopo selecionado. Consulte a avaliação do repositório para ver os controles de pipeline, a cobertura e as datas das observações. Para configurar os checks que o ZeroPath publica em pull requests, veja [Escaneamento de PR](https://zeropath.com/docs/pt/scanning/pr-scanning.md).

## Verifique uma alteração

Faça a correção no provedor e envie as mudanças de workflows para a branch monitorada. O ZeroPath coloca verificações na fila após pushes compatíveis e realiza verificações diárias. Para pedir uma verificação antes do próximo agendamento, abra **CI/CD actions** e selecione **Request reassessment**. A ação exige permissão para iniciar scans (`SCAN_START`). Limites e problemas de conexão com o provedor podem adiar os resultados.

**Reload results** exibe a avaliação salva mais recente. Confira a data da observação do controle que você alterou. As verificações de rulesets e ambientes no GitHub e de aprovações em ambientes protegidos no GitLab seguem uma programação semanal, inclusive após uma solicitação de reavaliação.

## Acesso e solução de problemas

| Quando aparecer | O que verificar |
| - | - |
| **Full source access required** | Você precisa de permissão para visualizar o repositório de origem inteiro. Se ele estiver dividido em aplicações, isso pode exigir acesso a todas as partições importadas. |
| **Enrollment queued** ou **First check queued** | As importações compatíveis são incluídas no monitoramento automaticamente. Consulte os resultados após a primeira coleta. Em uma instalação autogerenciada, use uma versão da distribuição que inclua o monitoramento de CI/CD e confirme que o worker está em execução. |
| **Collection needs attention** ou **Coverage is incomplete** | Verifique as lacunas da coleta em **Coverage**. Confira se a branch monitorada existe e se a conexão com o provedor tem permissão para lê-la. |
| **Unsupported provider** | O monitoramento contínuo usa conexões com o GitHub ou o GitLab. A aba do repositório pode indicar esse status para outros provedores, como o Bitbucket. |

**Conexões via GitHub App** usam a permissão de leitura em Contents para as definições dos workflows, em Actions para os metadados das execuções e em Administration para as configurações do Actions. Se sua organização gerencia o app, adicione as permissões necessárias no GitHub e aprove a atualização da instalação. Consulte a [configuração do app para GitHub Enterprise](https://zeropath.com/docs/pt/integrations/github-enterprise-server.md#what-the-app-can-access).

**Conexões com o GitLab** dependem do papel do token, da versão e do plano da instância. O ZeroPath usa a API estática CI Lint para expandir includes no commit monitorado, quando disponível. Os achados da configuração expandida usam os números de linha dessa configuração. Se a expansão falhar, o ZeroPath verifica a configuração raiz que consegue ler e informa que a cobertura foi parcial.

## O que o ZeroPath verifica

### GitHub Actions

* Nas **configurações do provedor**, a avaliação verifica proteção de branch, permissões do token do workflow, aprovação de PRs por workflows, actions permitidas e referências por SHA completo. As regras de release incluem aprovações de PRs e checks obrigatórios em rulesets ativos, revisores de ambientes e proteção contra autoaprovação de deploys.
* Nos **workflows**, a análise verifica referências mutáveis a actions e imagens, permissões amplas de token, herança de secrets, dados não confiáveis em scripts, configurações de runners e checkout, contêineres privilegiados, montagens do socket Docker e permissões de OIDC.

### GitLab CI/CD

* Nas **configurações do provedor**, a avaliação verifica proteção de branch, regras de push para o papel Developer, visibilidade de jobs, pushes com tokens de jobs, papéis autorizados a substituir variáveis, exigência de pipeline antes do merge, pipelines de forks no projeto pai e aprovações em ambientes protegidos.
* Nos **workflows**, a análise verifica imagens e includes mutáveis, logs de depuração, Docker-in-Docker sem TLS e declarações padrão de tokens OIDC.

O monitor lê os workflows sem executá-los e guarda os resultados da avaliação e os metadados das execuções. Verifique as regras efetivas de aprovação e exceção, o comportamento dos runners, as políticas de confiança da nuvem e a procedência de artefatos nos sistemas responsáveis.

## Histórico de alterações

O ZeroPath retém até 20 mudanças dos últimos 90 dias. O histórico registra mudanças relacionadas ao pipeline. Para rulesets do GitHub, **Changes** pode mostrar verificações obrigatórias adicionadas, removidas ou substituídas após duas coletas completas para a mesma branch. Consulte a proteção clássica de branch no GitHub para ver outras verificações exigidas.

Importações do mesmo repositório de origem e da mesma branch de scan configurada em uma organização compartilham um monitor. Alterar a branch de scan pode mudar o histórico exibido. Remover a última importação de um monitor exclui suas evidências e seu histórico.

## API e MCP

Consulte a [referência da API](https://zeropath.com/docs/api-reference/introduction.md#cicd-security) para ver as rotas REST ou a [referência de ferramentas MCP](https://zeropath.com/docs/pt/mcp/tools.md#seguranca-de-cicd) para ver as operações e permissões.


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