Para ver o índice completo da documentação, consulte llms.txt. Para acessar a versão em Markdown de uma página da documentação, acrescente .md ao final da URL da página.
Navegação principal
Tema

Importar achados de scanners para o Daybreak

Conecte o Wiz, o Snyk Open Source ou o Endor Labs, envie um relatório de scanner e escolha quais achados avaliados compartilhar.

Você pode importar achados para o Daybreak Defense Factory conectando um scanner ou enviando um relatório. O Daybreak pode avaliar esses achados com base no seu código e compartilhar os resultados elegíveis com sua equipe.

Abra Configurações → Integrações ou selecione Importar em Achados. As opções disponíveis dependem do seu espaço de trabalho. A avaliação requer acesso às evidências do scanner e ao commit do repositório. Para compartilhar os resultados, você também precisa de um ambiente em que tenha permissão para publicar achados.

Importar de um scanner conectado

  1. Selecione Conectar ao lado do scanner, Reconectar se a conexão tiver expirado ou Importar para usar uma conexão existente.
  2. Escolha a origem e os achados que deseja importar. Se a opção Importar todos os achados de um repositório estiver disponível para o Snyk ou o Endor, escolha um repositório conectado do GitHub para incluir todos os projetos correspondentes na organização ou no namespace selecionado. Caso contrário, escolha um projeto e selecione os achados. No Wiz, você também pode usar uma visualização salva compatível.
  3. Confira a quantidade de achados, o repositório e o commit. A contagem inclui os achados selecionados que o Daybreak não consegue avaliar e, por isso, pode superar o número de achados compartilhados ao final.
  4. Verifique o destino. Ao confirmar um destino compartilhado, você autoriza o Daybreak a avaliar os achados e a publicar nesse destino os resultados elegíveis com o status Reportável. Qualquer pessoa com acesso ao destino pode ler a avaliação publicada e as evidências de origem. Se houver apenas um ambiente elegível, o Daybreak o selecionará automaticamente. Se houver vários, escolha um. Se você optar por avaliar ou salvar os achados de forma privada, os resultados permanecerão privados.
  5. Confirme quando a quantidade e o destino estiverem corretos. Se a revisão expirar ou a origem mudar, confira os dados novamente. Depois que a importação começar, você poderá fechar as Configurações e acompanhar o andamento em Minhas importações recentes.

Escolher a origem

Scanner Conexão O que você pode selecionar
Wiz Entre na sua conta do Wiz e aprove a conexão. Vulnerabilidades de pacotes em um projeto ou uma visualização salva de achados de vulnerabilidade com filtros para um único repositório de contêineres e para imagens de contêiner. A opção Filtrar esta página pesquisa na página atual. Você pode selecionar achados em várias páginas.
Snyk Open Source Use um token da API do Snyk US-01 com acesso de leitura via REST à organização, aos projetos e às issues. Escolha a organização que monitora seu repositório. Manifestos distintos podem aparecer como projetos monitorados separados. Se você não tiver acesso via REST, use um arquivo CSV do relatório Issues Detail.
Endor Labs Informe seu namespace dos EUA, a chave de API e o segredo da API. Use uma chave somente leitura com data de expiração e escopo restrito ao namespace, com os namespaces filhos desabilitados. Escolha achados do contexto principal de um projeto ou use a importação por repositório, quando disponível.

O Daybreak usa a revisão informada pelo scanner quando consegue verificá-la. Se o Snyk não informar o commit, a tela de revisão poderá oferecer uma alternativa para esse repositório. Para um achado do Wiz que precise de checkout, escolha o repositório do GitHub e informe o SHA completo, com 40 caracteres, de um commit que sua conexão tenha permissão para ler. O Daybreak avaliará o código desse commit. Ele pode ser diferente do código usado para criar a imagem do contêiner. A importação preserva as evidências originais do scanner.

Respeitar os limites de importação de um scanner conectado

Scanner Limite por leitura da origem O que fazer se atingir o limite
Wiz 5.000 ocorrências correspondentes por projeto ou visualização salva com os filtros aplicados, em até 100 páginas de 50 ocorrências, com um limite de 32 MiB. Refine os filtros de gravidade, disponibilidade de correção ou CVE antes de gerar outra prévia.
Snyk Open Source 10.000 issues de pacotes por projeto monitorado, em até 100 páginas de 100 issues. As páginas originais codificadas e o relatório convertido devem somar no máximo 8 MiB. Escolha um projeto menor ou envie uma exportação filtrada. Mesmo que você selecione menos issues após a prévia, ainda é necessário ler o projeto inteiro.
Endor Labs 5.000 achados por prévia de projeto, em páginas de até 100 achados, com um limite de leitura de 32 MiB. Escolha um projeto menor ou envie uma exportação filtrada. Se o conjunto completo de evidências exceder o limite, selecione menos achados individuais.

Cada relatório capturado e suas evidências devem somar no máximo 32 MiB. Na importação por repositório, o Daybreak precisa terminar de ler todos os projetos correspondentes para confirmar a contagem de achados do repositório.

Cada seleção aceita até 10.000 ocorrências do scanner. Em uma revisão, o Daybreak pode avaliar até 10.000 linhas com alvos verificados. A lista de linhas e as respectivas revisões atribuídas também devem caber em 512 KiB. Por isso, talvez seja necessário dividir até mesmo uma seleção com menos linhas. No Wiz, o limite de checkout considera os achados aos quais você atribuiu um checkout, mesmo que vários usem o mesmo commit. Dependendo do seletor disponível no seu espaço de trabalho, você pode atribuir um checkout a até 16 ou 100 achados por revisão. Divida a seleção de acordo com o limite exibido. Uma confirmação pode autorizar até 100 ambientes de destino, um por conexão de repositório.

Enviar um relatório de scanner

Selecione Enviar arquivo ao lado do scanner. A tela de Configurações detecta o formato e mostra quais exportações seu espaço de trabalho aceita.

Scanner Arquivo aceito em Configurações
Wiz Um relatório completo de vulnerabilidades de pacotes em JSON detalhado ou um arquivo JSON Lines com um achado nativo por linha. Na seção Achados de vulnerabilidade do Wiz, filtre o relatório, selecione Salvar como → Relatório e escolha Branch do repositório, JSON e Detalhado para exportar os dados de um repositório. Quando solicitado, informe o ID do tenant do Wiz de onde o relatório foi exportado.
Snyk Open Source Um arquivo CSV do relatório Issues Detail de uma única organização. Confira a organização na prévia.
Endor Labs Um arquivo JSON de achados no formato nativo, exportado pelo endorctl para o namespace que você quer importar. Preserve os UUIDs originais dos achados e, se a exportação for paginada, inclua todas as páginas.

O limite de 32 MiB vale tanto para o arquivo enviado quanto para seu conteúdo descompactado, inclusive em envios com gzip. Para arquivos CSV do Snyk e JSON Lines do Wiz, a tela de Configurações reconhece até 10.000 linhas de dados por arquivo. Divida arquivos maiores antes de enviá-los. Um achado individual em JSON com mais de 1 MiB pode ser rejeitado. No CSV do Snyk, limite o cabeçalho a 32.768 caracteres, cada campo a 131.072 caracteres e cada linha lógica a 1.048.576 caracteres.

Escolher se deseja avaliar ou compartilhar os achados

Ao salvar o arquivo, você o envia para revisão. Antes de iniciar a importação, confira os repositórios e commits verificados, as linhas que ainda precisam de checkout e os dados de entrada rejeitados, se houver.

  • Para guardar as evidências para uso posterior, escolha Salvar sem avaliação se a tela de revisão oferecer a opção de avaliar. Caso contrário, escolha Salvar de forma privada.
  • Para avaliar as linhas elegíveis e manter todos os resultados privados, escolha Importar e avaliar de forma privada. Você pode escolher depois os alvos das linhas que ainda precisam de um. Se mais de 10.000 linhas tiverem alvos, divida o relatório ou salve-o sem avaliação.
  • Para compartilhar os resultados elegíveis, marque Também publicar achados reportáveis. Essa opção vem desmarcada. Confira o espaço de trabalho e os destinos. Se um repositório tiver vários ambientes elegíveis, escolha um deles ou selecione Manter privado. Confirme em Importar e publicar achados reportáveis.

O compartilhamento automático exige que a avaliação classifique o achado como Reportável, que o scanner informe a gravidade e que você tenha autorizado o destino. O relatório original permanece privado. Em Atividade, a opção Interromper compartilhamento automático impede novas publicações dessa importação.

Importar pela CLI

Você pode importar uma exportação salva do scanner com codex-security publish findings. Para gerar uma prévia local, use --to local --dry-run. Para gerar uma prévia de importação na nuvem, use --to cloud --dry-run --format json com um repositório conectado. Ao gerar uma prévia na nuvem, a CLI entra em contato com o Daybreak e exige que as credenciais de login do ChatGPT estejam armazenadas em arquivo.

Confira a prévia antes de remover --dry-run e confirmar. Uma entrada privateImport salva os achados na sua caixa de entrada privada. As entradas em requests publicam os achados nos ambientes de repositório listados ali. Consulte o comprovante da importação para verificar se houve exclusões, falhas ou linhas não processadas. Veja exemplos de importação local e na nuvem na referência da CLI e consulte os guias de importação de scanners para conhecer os formatos e comandos da CLI.

No AWS Continuum, colete as issues de código ou um achado individual. Em seguida, use a CLI para gerar uma prévia do relatório salvo. O Codex Security pode usar as evidências de validação obtidas no alvo testado para avaliar se um atacante consegue alcançar o código afetado.

Para varreduras de infraestrutura como código feitas com o CrowdStrike Falcon Cloud Security, importe o relatório JSON salvo para seu ambiente de trabalho local.

Reabrir uma importação

No espaço de trabalho em que você fez a importação, abra Minhas importações recentes em Configurações → Integrações ou em Achados → Importar. Você também pode reabrir uma importação privada pela linha correspondente em Varreduras. O resumo mostra o resultado de cada linha, inclusive os dados de entrada rejeitados e os motivos da rejeição. Abra uma linha aceita para ver o ID do achado no scanner e as evidências salvas, além da avaliação ou do achado publicado, se houver. Desconectar o scanner impede novas leituras por essa conexão. Você ainda pode reabrir as importações salvas.

Selecione Avaliar em um achado privado para verificar as evidências com base no commit selecionado. Leia o motivo ao lado do status Reportável, Adiado, Suprimido ou Não se aplica. Por exemplo, se o Daybreak não conseguir ler um commit, o achado poderá ficar com o status Adiado. Para compartilhar um resultado classificado como Reportável em uma avaliação privada, selecione um ambiente de destino autorizado e escolha Publicar nos achados compartilhados. Se o scanner não tiver informado um nível de gravidade reconhecido, escolha um antes de publicar.

Identificar importações repetidas

Se a confirmação tiver sido interrompida, reabra o comprovante original ou selecione Verificar importação original quando essa opção estiver disponível. Ao reenviar a solicitação original, você recupera a importação com as opções que já havia escolhido.

Quando você inicia uma nova importação, o Daybreak compara cada linha com as evidências que já tem.

  • No Endor, se a conexão e o projeto forem os mesmos, os IDs do scanner e as evidências podem apontar para a observação privada existente quando ambos permanecem inalterados. O mesmo vale para o Wiz quando você usa a mesma conexão e o mesmo projeto ou a mesma visualização salva do repositório. Uma nova importação por uma conexão do Snyk registra uma nova observação privada para cada issue. Se você solicitar outra avaliação, o Daybreak poderá avaliar até mesmo uma linha que não mudou.
  • Se você reenviar o mesmo CSV do Snyk para a mesma organização, o Daybreak reutilizará as linhas aceitas. Por exemplo, ao enviar novamente as mesmas cinco issues, você poderá ver cinco inalteradas e nenhuma nova. Se as evidências mudarem, o Daybreak criará uma nova versão. Uma avaliação anterior continua vinculada às evidências e ao commit que o Daybreak avaliou na ocasião.
  • Se um relatório contiver duas ocorrências do mesmo ID de achado do scanner, o Daybreak sinalizará ambas e poderá importar as demais linhas válidas. Mantenha um único registro correto e importe o relatório corrigido. IDs distintos podem identificar pacotes ou repositórios afetados diferentes, mesmo quando citam o mesmo CVE.

Após a publicação, o Daybreak verifica se já existe um achado compartilhado no mesmo repositório e ambiente. Se houver correspondência, o Daybreak adicionará as evidências publicadas à issue existente. Uma issue distinta pode gerar um novo achado. Assim, duas observações do scanner podem aparecer em um único achado compartilhado. Se você repetir a mesma publicação, o Daybreak não duplicará as evidências. Abra Observações no achado compartilhado para consultar as origens. Veja Revisar achados e correções.