Saltar para o conteúdo principal
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. 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.
Para revisar achados de CI/CD em scans de código, abra Issues → CI/CD (em inglês) 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.

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

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. 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 para ver as rotas REST ou a referência de ferramentas MCP para ver as operações e permissões.