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
- Selecione Conectar ao lado do scanner, Reconectar se a conexão tiver expirado ou Importar para usar uma conexão existente.
- 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.
- 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.
- 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.
- 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.