콘텐츠로 이동

로컬 우선 설계

분석 대상은 기기 밖으로 나가지 않습니다

Section titled “분석 대상은 기기 밖으로 나가지 않습니다”

BomLens는 SaaS 없이 로컬에서 동작합니다. 소스 코드, 펌웨어, SBOM, 스캔 결과를 이 프로젝트의 서버로 보내지 않으며 텔레메트리도 없습니다. 스캔은 로컬 Docker 컨테이너 안에서 끝나며, 산출물은 실행한 디렉터리에만 남습니다. 다만 기본으로 공개 서비스에 하는 요청이 있습니다. ghcr.io에서 스캐너 이미지 내려받기, 보안 보고서를 위한 Trivy 취약점 데이터베이스 내려받기, 찾은 CVE 식별자를 FIRST.org(EPSS)와 CISA(KEV)에 조회하기, 그리고 데스크톱 앱이 GitHub releases API로 새 버전 확인하기입니다. 이 요청에는 소스 코드나 SBOM이 담기지 않습니다. osv.dev에 묻는 웹 UI의 CVE·패키지 조회는 누군가 그 화면을 쓸 때만 동작합니다. 컴포넌트 식별자를 보내는 옵션은 직접 켜지 않으면 동작하지 않습니다. --identify-vendored는 파일 원본이 아니라 파일 지문(해시)만 SCANOSS OSSKB 서비스로 보내고, --license-registry와 --resolve-purl은 패키지 식별자를 deps.dev로 보냅니다. 첫 옵션이 무엇을 보내는지와 자체 엔드포인트를 지정하는 방법은 내장 오픈소스 식별 (C/C++)에, 모든 요청의 목록은 코드 서명 정책에 있습니다.

폐쇄망과 오프라인에서 쓸 수 있습니다

Section titled “폐쇄망과 오프라인에서 쓸 수 있습니다”

BomLens는 폐쇄망과 오프라인 환경에서 동작합니다. 외부 조회가 필요한 일부 기능은 끄면 되고, 나머지는 그대로 생성됩니다. 대표적으로 보안 보고서의 EPSS와 CISA KEV 보강은 SECURITY_ENRICH=false로 끄면 생략되고 나머지 보고서는 그대로 만들어집니다. 라이선스 조회도 FETCH_LICENSE=false로 생략할 수 있습니다. 소스 스캔은 cdxgen 이미지를 ghcr.io에서 받으므로, 레지스트리 미러에만 접속할 수 있는 네트워크에서는 CDXGEN_IMAGE_PREFIX를 그 미러로 지정합니다. 웹 UI의 CVE·패키지 조회 화면은 성격이 다릅니다. 스캔 중엔 아무것도 안 하고, 누군가 그 화면에 들어가 식별자나 패키지 이름을 입력했을 때만 그 값을 osv.dev로 즉석 전송합니다(패키지 조회는 패키지 이름도 함께 나가므로, 사내 전용 이름을 입력하기 전에 알아 두는 편이 좋습니다). EXTERNAL_LOOKUP=false로 설정하면 화면과 그리로 가는 링크가 전부 사라지고, 직접 요청을 보내도 서버가 거부합니다. 보안 보고서는 오프라인에서 한 가지가 더 필요합니다. 이미지에는 Trivy 취약점 DB가 들어 있지 않아서 네트워크가 없으면 Trivy 단계가 DB를 내려받지 못하고, 보고서는 발견 항목이 없는 상태로 나오며 실패 사실을 적은 ScanError 항목이 함께 남습니다. 취약점이 없다는 결과가 아닙니다. 스캔의 나머지 산출물은 그대로 만들어집니다. 반대로 네트워크가 필요할 것 같지만 그렇지 않은 검사도 셋 있습니다. 지원 종료(EOL) 표시, 악성 패키지 검사, 배포 라이선스 충돌 검사는 모두 이미지 빌드 때 담아 둔 데이터를 읽으므로 연결이 없어도 그대로 동작합니다.

산출물은 표준 포맷을 씁니다. SBOM은 기본이 CycloneDX 1.6이고, --spec-version 1.7을 주면 1.7입니다. 특정 벤더에 묶이지 않으므로 어디서든 검증하고 재사용할 수 있습니다. 같은 입력에 대해 바이트 단위로 동일한 SBOM이 필요하면 --byte-stable을 쓰세요.

진입점이 달라도 스캐너는 하나입니다

Section titled “진입점이 달라도 스캐너는 하나입니다”

세 가지 진입점인 CLI, 웹 UI, 데스크톱 앱은 모두 같은 로컬 스캐너 컨테이너를 씁니다. 도구를 쓰는 방식만 다를 뿐 동작과 산출물은 동일합니다.

BomLens는 생성에 집중합니다. 전사 프로젝트 관리, 취약점 분류, 라이선스 정책 게이트 같은 거버넌스는 자매 프로젝트 TRUSCA(구 TrustedOSS Portal, https://github.com/trustedoss/trusca)에 위임합니다. 두 도구는 CycloneDX 산출물을 그대로 주고받습니다.

2단계 파이프라인 동작은 BomLens 동작 원리를, 산출물 종류는 산출물 레퍼런스를 참고하세요.