전체 문서 색인은 llms.txt를 참조하세요. 문서 페이지 URL 끝에 .md 를 추가하면 해당 페이지의 Markdown 버전을 볼 수 있습니다.
기본 탐색 메뉴

Daybreak로 스캐너 보안 이슈 가져오기

Wiz, Snyk Open Source 또는 Endor Labs를 연결하거나 스캐너 보고서를 업로드한 다음, 평가를 마친 보안 이슈 중에서 공유할 항목을 선택하세요.

스캐너를 연결하거나 보고서를 업로드하면 Daybreak Defense Factory로 보안 이슈를 가져올 수 있습니다. Daybreak는 보안 이슈를 코드와 대조해 평가하고, 공유 조건을 충족하는 결과를 팀과 공유할 수 있습니다.

설정 → 통합을 열거나 보안 이슈에서 가져오기를 선택하세요. 사용할 수 있는 옵션은 워크스페이스에 따라 다릅니다. 평가하려면 스캐너의 근거 자료와 리포지터리 커밋에 접근할 수 있어야 합니다. 공유하려면 보안 이슈를 게시할 권한이 있는 환경도 필요합니다.

연결된 스캐너에서 가져오기

  1. 스캐너 옆에서 연결을 선택하세요. 연결이 만료되었다면 다시 연결을, 기존 연결을 사용하려면 가져오기를 선택하세요.
  2. 가져올 소스와 보안 이슈를 선택하세요. Snyk 또는 Endor에서 리포지터리의 모든 보안 이슈 가져오기를 사용할 수 있다면 연결된 GitHub 리포지터리를 선택하세요. 선택한 조직 또는 네임스페이스에서 해당 리포지터리와 일치하는 프로젝트가 모두 포함됩니다. 이 옵션이 없으면 프로젝트를 선택한 다음 보안 이슈를 선택하세요. Wiz에서는 지원되는 저장된 보기도 사용할 수 있습니다.
  3. 보안 이슈 수와 리포지터리, 커밋을 검토하세요. 선택한 보안 이슈 중 평가할 수 없는 항목도 집계하므로 표시된 수가 최종적으로 공유되는 보안 이슈 수보다 클 수 있습니다.
  4. 게시 대상을 확인하세요. 공유 대상을 확정하면 Daybreak에 보안 이슈를 평가하고 게시 조건을 충족하는 보고 가능 결과를 해당 대상에 게시할 권한을 부여합니다. 해당 대상에 접근할 수 있는 사람은 누구나 게시된 평가와 원본 근거 자료를 읽을 수 있습니다. 게시 가능한 환경이 하나뿐이면 Daybreak가 자동으로 선택합니다. 여러 개라면 하나를 선택하세요. 비공개로 평가하거나 저장하면 결과는 비공개로 유지됩니다.
  5. 보안 이슈 수와 게시 대상이 맞으면 가져오기를 확정하세요. 검토가 만료되거나 소스가 변경되면 다시 검토하세요. 가져오기를 시작한 후에는 설정을 닫고 내 최근 가져오기에서 진행 상황을 확인할 수 있습니다.

소스 선택

스캐너 연결 방법 선택할 수 있는 항목
Wiz Wiz 계정에 로그인하고 연결을 승인하세요. 프로젝트의 패키지 취약점을 선택하거나, 컨테이너 리포지터리 하나와 컨테이너 이미지로 필터링한 저장된 취약점 보기를 선택할 수 있습니다. 이 페이지 필터링은 현재 페이지에서만 검색합니다. 여러 페이지에 걸쳐 보안 이슈를 선택할 수 있습니다.
Snyk Open Source 조직, 프로젝트 및 이슈에 대한 REST 읽기 권한이 있는 Snyk US-01 API 토큰을 사용하세요. 리포지터리를 모니터링하는 조직을 선택하세요. 매니페스트가 여러 개이면 각각 별도의 모니터링 대상 프로젝트로 표시될 수 있습니다. REST 접근 권한이 없으면 Issues Detail CSV를 사용하세요.
Endor Labs 미국 리전의 네임스페이스, API 키, API 시크릿을 입력하세요. 만료 기한이 있는 읽기 전용 키를 사용하세요. 키의 범위를 해당 네임스페이스로 제한하고 하위 네임스페이스는 비활성화하세요. 프로젝트의 기본 컨텍스트에서 보안 이슈를 선택하거나, 리포지터리 단위로 가져오는 옵션이 있으면 해당 옵션을 사용하세요.

Daybreak는 스캐너가 보고한 리비전을 검증할 수 있으면 해당 리비전을 사용합니다. Snyk가 커밋을 제공하지 않으면 검토 화면에 해당 리포지터리에서 대신 사용할 수 있는 옵션이 표시될 수 있습니다. 체크아웃이 필요한 Wiz 보안 이슈의 경우 GitHub 리포지터리를 선택하고, 현재 연결로 읽을 수 있는 커밋의 SHA 40자를 모두 입력하세요. Daybreak는 이 커밋의 코드를 평가합니다. 이 코드는 컨테이너 이미지를 빌드할 때 사용한 코드와 다를 수 있습니다. 가져올 때 스캐너의 원본 근거 자료는 그대로 보존됩니다.

연결된 스캐너에서 한도 내로 가져오기

스캐너 소스를 한 번 읽을 때의 한도 한도에 도달한 경우
Wiz 필터를 적용한 프로젝트 또는 저장된 보기 하나당 조건에 맞는 항목 5,000건까지 읽을 수 있습니다. 페이지당 50건씩 최대 100페이지이며, 전체 크기는 32 MiB 이하여야 합니다. 심각도, 수정 가능 여부 또는 CVE 필터로 범위를 좁힌 다음 다시 미리 보세요.
Snyk Open Source 모니터링 대상 프로젝트 하나당 패키지 이슈 10,000건까지, 페이지당 100건씩 최대 100페이지를 읽을 수 있습니다. 인코딩된 원본 페이지와 변환된 보고서의 합계는 8 MiB 이하여야 합니다. 더 작은 프로젝트를 선택하거나 필터를 적용해 내보낸 파일을 업로드하세요. 미리 본 후에 이슈를 적게 선택하더라도 프로젝트 전체를 읽어야 합니다.
Endor Labs 프로젝트 하나를 미리 볼 때 보안 이슈 5,000개까지 읽을 수 있습니다. 페이지당 최대 100개이며, 읽는 데이터의 총량은 32 MiB 이하여야 합니다. 더 작은 프로젝트를 선택하거나 필터를 적용해 내보낸 파일을 업로드하세요. 전체 근거 자료가 한도를 초과하면 개별 보안 이슈를 더 적게 선택하세요.

수집한 보고서 한 건과 그 근거 자료를 합한 크기는 32 MiB 이하여야 합니다. 리포지터리 단위로 가져올 때는 조건에 맞는 프로젝트를 모두 읽은 후에야 해당 리포지터리의 보안 이슈 수를 확정할 수 있습니다.

한 번에 선택할 수 있는 스캐너 탐지 항목은 최대 10,000건입니다. 한 번의 검토에서는 대상이 검증된 행을 최대 10,000개까지 평가할 수 있습니다. 행과 각 행에 할당된 리비전을 담은 목록도 512 KiB 이하여야 하므로, 선택한 항목이 더 적더라도 여러 번으로 나눠야 할 수 있습니다. Wiz의 체크아웃 한도는 체크아웃이 할당된 보안 이슈의 수를 기준으로 합니다. 여러 보안 이슈가 같은 커밋을 사용해도 각각 집계합니다. 워크스페이스에서 제공하는 선택 화면에 따라 검토 한 번에 보안 이슈를 최대 16개 또는 100개까지 선택해 체크아웃을 할당할 수 있습니다. 화면에 표시된 한도에 맞춰 나누어 선택하세요. 한 번의 확인으로 리포지터리 연결당 하나씩, 최대 100개의 게시 대상 환경을 승인할 수 있습니다.

스캐너 보고서 업로드

스캐너 옆에서 파일 업로드를 선택하세요. 설정 화면에서 파일 형식을 자동으로 감지하고 워크스페이스에서 허용하는 내보내기 형식을 표시합니다.

스캐너 설정에서 업로드할 파일
Wiz Detailed JSON 형식의 전체 패키지 취약점 보고서 또는 한 줄에 Wiz 원본 보안 이슈 하나가 들어 있는 JSON Lines 파일을 사용하세요. Wiz의 Vulnerability Findings에서 보고서를 필터링하고 Save as → Report를 선택한 다음, 리포지터리 내보내기 옵션으로 Repository Branch, JSON, Detailed를 선택하세요. 입력하라는 메시지가 표시되면 보고서를 내보낸 Wiz 테넌트의 ID를 입력하세요.
Snyk Open Source 단일 조직에서 내보낸 Issues Detail CSV를 사용하세요. 미리 보기에서 조직을 확인하세요.
Endor Labs 가져올 네임스페이스에 대해 endorctl로 내보낸 Endor Labs 기본 형식의 Finding JSON을 사용하세요. 원래 보안 이슈 UUID를 유지하고, 여러 페이지로 나뉘는 경우 모든 페이지를 내보내세요.

업로드하는 파일과 압축을 푼 내용은 각각 32 MiB 이하여야 합니다. gzip 파일을 업로드할 때도 마찬가지입니다. Snyk CSV와 Wiz JSON Lines의 경우 설정에서 파일당 최대 10,000개의 데이터 행을 인식합니다. 이보다 큰 파일은 나눠서 업로드하세요. JSON 보안 이슈 하나의 크기가 1 MiB를 초과하면 해당 항목이 거부될 수 있습니다. Snyk CSV의 헤더는 32,768자 이하, 각 필드는 131,072자 이하, 각 논리적 행은 1,048,576자 이하여야 합니다.

평가 및 공유 여부 선택

파일을 저장하면 검토할 수 있도록 파일이 업로드됩니다. 가져오기를 시작하기 전에 검증된 리포지터리와 커밋, 아직 체크아웃이 필요한 행, 거부된 입력을 확인하세요.

  • 근거 자료를 나중에 사용할 수 있도록 보관하려면 검토 화면에서 평가 옵션이 제공될 때 평가하지 않고 저장을 선택하세요. 평가 옵션이 없으면 비공개로 저장을 선택하세요.
  • 평가 가능한 행을 평가하고 모든 결과를 비공개로 유지하려면 가져와서 비공개로 평가를 선택하세요. 아직 대상이 지정되지 않은 행은 나중에 대상을 선택할 수 있습니다. 대상이 지정된 행이 10,000개를 초과하면 보고서를 나누거나 평가하지 않고 저장하세요.
  • 조건을 충족하는 결과를 공유하려면 기본적으로 선택 해제되어 있는 보고 가능한 보안 이슈도 게시를 선택하세요. 워크스페이스와 게시 대상을 검토하세요. 리포지터리에 게시 가능한 환경이 여러 개 있으면 하나를 선택하거나 비공개 유지를 선택하세요. 가져와서 보고 가능한 보안 이슈 게시를 선택해 확정하세요.

자동으로 공유하려면 평가 결과가 보고 가능 상태이고, 스캐너가 심각도를 제공했으며, 사용자가 게시 대상을 승인해야 합니다. 원본 보고서는 비공개로 유지됩니다. 활동에서 자동 공유 중지를 선택하면 해당 가져오기에서 더 이상 결과를 자동으로 게시하지 않습니다.

CLI에서 가져오기

codex-security publish findings로 스캐너에서 내보내 저장한 파일을 가져올 수 있습니다. 로컬에서 미리 보려면 --to local --dry-run을 사용하세요. 클라우드 가져오기를 미리 보려면 연결된 리포지터리에서 --to cloud --dry-run --format json을 사용하세요. 클라우드 미리 보기는 Daybreak에 접속하며, 파일 기반 ChatGPT 로그인이 필요합니다.

--dry-run을 제거하고 가져오기를 확정하기 전에 미리 보기 내용을 확인하세요. privateImport 항목은 보안 이슈를 비공개 수신함에 저장합니다. requests의 항목은 각 항목에 명시된 리포지터리 환경에 보안 이슈를 게시합니다. 처리 내역에서 제외된 항목, 실패한 항목 및 처리되지 않은 행을 확인하세요. 로컬 및 클라우드 가져오기 예시는 CLI 레퍼런스를, CLI 형식과 명령어는 스캐너 가져오기 가이드를 참고하세요.

AWS Continuum에서는 코드 이슈 또는 개별 보안 이슈를 수집한 다음 CLI에서 저장된 보고서를 미리 보세요. Codex Security는 테스트 대상에서 얻은 검증 자료를 바탕으로 공격자가 영향을 받는 코드에 도달할 수 있는지 평가할 수 있습니다.

CrowdStrike Falcon Cloud Security로 코드형 인프라를 스캔한 경우 저장된 JSON 보고서를 로컬 워크벤치로 가져오세요.

가져오기 내역 다시 열기

가져오기를 수행한 워크스페이스의 설정 → 통합 또는 보안 이슈 → 가져오기에서 내 최근 가져오기를 여세요. 비공개 가져오기 내역은 스캔의 해당 행에서도 다시 열 수 있습니다. 요약에는 모든 행의 처리 결과가 표시되며 거부된 입력과 그 사유도 포함됩니다. 수락된 행을 열면 스캐너 ID와 저장된 근거 자료를 볼 수 있으며, 평가 결과나 게시된 보안 이슈가 있으면 함께 확인할 수 있습니다. 스캐너 연결을 해제하면 해당 연결을 통한 새 데이터 읽기가 중지됩니다. 저장된 가져오기 내역은 계속 열어 볼 수 있습니다.

비공개 보안 이슈에서 평가를 선택해 근거 자료를 선택한 커밋과 대조하세요. 보고 가능, 보류, 표시 안 함 또는 해당 없음 상태 옆에 표시된 사유를 확인하세요. 예를 들어 Daybreak가 커밋을 읽을 수 없으면 보안 이슈가 보류 상태로 남을 수 있습니다. 비공개 평가에서 보고 가능 판정을 받은 결과를 공유하려면 게시 권한이 있는 대상 환경을 선택한 다음 공유 보안 이슈에 게시를 선택하세요. 스캐너가 인식 가능한 심각도를 제공하지 않았다면 게시하기 전에 심각도를 선택하세요.

반복해서 가져온 항목 식별하기

확인 도중 작업이 중단되었다면 원래 처리 내역을 다시 열거나 원래 가져오기 확인 옵션이 표시될 때 해당 옵션을 선택하세요. 원래 요청을 다시 시도하면 앞서 선택한 내용을 그대로 사용해 해당 가져오기를 복구합니다.

새 가져오기를 시작하면 Daybreak는 각 행을 이미 보유한 근거 자료와 비교합니다.

  • Endor에서 같은 연결과 프로젝트를 사용하거나, Wiz에서 같은 연결로 동일한 프로젝트 또는 저장된 리포지터리 보기를 사용한 경우, 스캐너 ID와 근거 자료가 그대로이면 기존 비공개 관찰 기록을 참조할 수 있습니다. 연결된 Snyk에서 새로 가져오면 이슈마다 새 비공개 관찰 기록이 생성됩니다. 평가를 다시 요청하면 변경되지 않은 행도 다시 평가할 수 있습니다.
  • 같은 조직에 대해 동일한 Snyk CSV를 업로드하면 이전에 수락된 행을 재사용합니다. 예를 들어 같은 이슈 5개를 다시 업로드하면 변경 없음 5개, 신규 0개로 표시될 수 있습니다. 근거 자료가 변경되면 새 버전이 생성됩니다. 이전 평가 결과는 해당 평가에서 검토한 근거 자료와 커밋을 계속 참조합니다.
  • 보고서 하나에 동일한 스캐너 보안 이슈 ID가 두 번 나오면 Daybreak는 두 항목을 모두 중복으로 표시하며, 나머지 유효한 행은 가져올 수 있습니다. 올바른 레코드 하나만 남기고 수정한 보고서를 가져오세요. 같은 CVE를 인용해도 ID가 다르면 영향을 받은 패키지나 리포지터리가 다를 수 있습니다.

게시 후 Daybreak는 같은 리포지터리와 환경에 일치하는 공유 보안 이슈가 있는지 확인합니다. 일치하는 이슈가 있으면 게시된 근거 자료를 해당 이슈에 추가합니다. 별개의 이슈라면 새 보안 이슈가 생성될 수 있습니다. 따라서 스캐너 관찰 기록 두 건이 하나의 공유 보안 이슈에 표시될 수 있습니다. 같은 게시 작업을 다시 시도해도 근거 자료가 중복으로 추가되지 않습니다. 출처를 확인하려면 공유 보안 이슈에서 관찰 기록을 여세요. 보안 이슈 및 수정 사항 검토를 참고하세요.