Escolha o que escanear
Escaneie uma imagem construída
- Abra Containers e selecione Scan image. Se a página pedir que você configure os tipos de scan, ative Container Scanning em Full scans → Full Scan Issue Types.
-
Escolha como fornecer a imagem.
- Se quiser, vincule a imagem a um repositório de código. Selecione Scan image para abrir a página da imagem e acompanhar o scan. Quando o scan for concluído, consulte a aba Vulnerabilities.
Escaneie imagens de um repositório
Ative Container Scanning nas configurações de scan completo do repositório. Se a descoberta de imagens estiver habilitada na sua instalação, execute um scan completo na branch que você deseja verificar.- Abra Scans → Full Scans no repositório. Selecione o resumo de contêineres do scan para abrir Container coverage.
- Confira a branch e o commit. Expanda Image sources para ver os arquivos que declaram a imagem e selecione View container vulnerabilities para abrir os resultados de uma verificação concluída.
- Resolva problemas de acesso ou lacunas de cobertura antes de usar o scan para verificar uma correção. O scan de código pode terminar enquanto as verificações de imagens ainda estão em andamento.
Quais referências são descobertas
A descoberta usa o commit e o escopo da partição escaneada. Cada scan completo
verifica até 20 combinações distintas de imagem e plataforma. A plataforma padrão
é
linux/amd64. O scan pode usar uma plataforma que consiga resolver a partir
de um Dockerfile ou arquivo do Compose. Arquivos ilegíveis, valores de build ou
deploy não resolvidos e templates que precisam de uma ferramenta como o Helm
podem resultar em lacunas de cobertura.
A verificação de uma imagem base cobre a base declarada. Para verificar os
pacotes adicionados durante o build, escaneie a imagem final da aplicação.
Quando tentar novamente
Retry container checks exige permissão para iniciar scans de repositório.
A nova tentativa usa as referências salvas do mesmo commit e preserva os
resultados do scan de código e as decisões de triagem. Uma tag pode apontar para
outro digest na nova tentativa.
Revise as vulnerabilidades e a cobertura
Visão geral
Containers → Overview mostra o estado das imagens rastreadas e os achados em aberto nas imagens às quais você tem acesso. Uma falha no scan seguinte mantém visíveis os riscos identificados antes.Lista de imagens
Containers → Images agrupa as imagens rastreadas por repositório e reúne as imagens avulsas em um grupo separado. Use a busca e os filtros para abrir a imagem que você quer revisar.Detalhes da imagem
- Overview exibe o estado do scan, severidade, digest, camadas quando disponíveis e recomendações de atualização da base. Se uma tentativa falhar, use View successful results quando houver um scan anterior bem-sucedido.
- Vulnerabilities agrupa os achados por pacote. Busque pelo nome do pacote ou CVE, use Fixable para encontrar atualizações ou abra um achado para consultar as evidências e o status. Para revisar várias imagens, selecione a aba Containers em Issues.
- Settings permite configurar o monitoramento e o vínculo com o repositório.
O que o scanner verifica
O ZeroPath identifica os pacotes na imagem baixada ou enviada e os compara com vulnerabilidades conhecidas. Quando disponíveis, os dados de camada ajudam a distinguir pacotes da imagem base dos que foram adicionados durante o build. Para distribuições e versões de base compatíveis, o scanner pode sugerir uma base mais recente. Quando houver uma comparação, a redução indicada se refere às CVEs dos pacotes do sistema operacional dessa base. Reconstrua e escaneie a imagem da aplicação para confirmar o resultado.Monitore e gerencie imagens
Para uma imagem do registro, abra Settings e informe uma expressão cron em UTC em Monitoring. Selecione Enable para iniciar, Update para alterar ou Turn off para parar. Enviar a mesma imagem com o campo de agendamento vazio mantém o cronograma existente.- Re-scan now baixa e escaneia a imagem novamente. Os scans agendados também baixam a imagem e consultam os dados de vulnerabilidade disponíveis.
- Cada arquivo enviado é escaneado uma vez. Envie outro arquivo para verificar um build mais novo.
- Delete remove a imagem rastreada e o histórico de scans.
Conecte um registro
Abra Integrations → Registries → Container registries, escolha o provedor e salve credenciais com acesso de leitura às imagens. Para salvar a conexão, você precisa da permissão Create Integrations. Consulte os requisitos de cada provedor. Para uma imagem construída, escolha a conexão em Scan image → Connected registry. Para uma imagem descoberta no repositório, selecione a conexão em Container coverage. Se várias conexões forem compatíveis, escolha a que tem acesso à imagem e tente novamente. No ZeroPath Cloud, o registro precisa estar acessível pela internet. Em uma instalação autogerenciada, os workers podem acessar registros privados permitidos na sua rede. Se os workers não tiverem acesso à internet, configure espelhos acessíveis ou disponibilize cópias locais das bases do Trivy e do Grype.Use a CLI ou a API
containerCoverage.status saia de DISCOVERING ou CHECKING, quando o campo
estiver presente. INCOMPLETE indica que a verificação terminou com lacunas.
A CLI também aguarda as verificações de contêineres em andamento durante um
scan de repositório.
Checklist do primeiro scan
- Envie a imagem exata que você publica ou execute um scan completo para verificar as imagens declaradas.
- Confira se o scan da imagem terminou com sucesso e revise os achados em aberto.
- Configure um cronograma para as imagens que deseja monitorar.