Saltar para o conteúdo principal
Verifique se a imagem de contêiner que você publica tem vulnerabilidades conhecidas em pacotes do sistema operacional e dependências embutidas. Com a descoberta habilitada, o scan completo também pode verificar imagens declaradas no repositório. Consulte os resultados na página Containers, marcada como Early access.

Escolha o que escanear

Escaneie uma imagem construída

  1. 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.
  2. Escolha como fornecer a imagem.
  3. 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.
Use um digest para escanear uma imagem publicada específica. A tag é resolvida no momento do download e pode apontar para outro build no próximo scan.

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.
  1. Abra Scans → Full Scans no repositório. Selecione o resumo de contêineres do scan para abrir Container coverage.
  2. 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.
  3. 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.
Para compartilhar achados de vulnerabilidades, abra Issues → Containers (em inglês), defina o escopo e selecione Export. O arquivo contém os achados da página Issues. Se precisar identificar a imagem revisada, registre também o digest e o estado do scan exibidos nos detalhes da imagem.

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.
Excluir um repositório interrompe o monitoramento e desvincula as conexões de registro salvas nas imagens associadas. O histórico dessas imagens é removido quando o repositório é excluído permanentemente.

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

Consulte o guia da CLI para ver as opções e a referência da API para o envio de imagens e de arquivos em partes. Ao acompanhar um scan de repositório pela API, aguarde até que 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

  1. Envie a imagem exata que você publica ou execute um scan completo para verificar as imagens declaradas.
  2. Confira se o scan da imagem terminou com sucesso e revise os achados em aberto.
  3. Configure um cronograma para as imagens que deseja monitorar.