Abra a avaliação de um repositório
- 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.
- 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.
- 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.
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.