Copy & Run

Grype로 SBOM 취약점 점검하기: 심각도 집계와 종료 코드 게이트

앞에서 만든 SBOM 파일을 Grype에 넣어 알려진 취약점 200건을 찾고, 심각도별로 집계합니다. 수정 버전이 있는 것만 추리는 옵션과 --fail-on 종료 코드로 빌드를 막는 방법을 실행해 확인합니다.

실습 노트 · 2026-10-28 발행 · 9분 · 2026-10 확인

앞 글에서 python:3.9-alpine의 SBOM을 sbom.json으로 저장했습니다. 이 글에서는 같은 회사의 오픈소스 도구 Grype로 그 파일을 점검합니다. 이미지를 다시 분석하지 않고 목록만으로 취약점을 찾을 수 있다는 점이 핵심입니다.

준비물

항목 확인한 값
Grype 0.121.0 (anchore/grype:latest)
입력 앞 글의 sbom.json (CycloneDX 1.7, 구성 요소 1,048개)

1. 점검 실행

MSYS_NO_PATHCONV=1 docker run --rm -v "$PWD:/w" anchore/grype:latest sbom:/w/sbom.json -o table
# 기대 출력(일부, 이 PC)
NAME        INSTALLED  FIXED IN  TYPE    VULNERABILITY   SEVERITY  EPSS          RISK
libcrypto3  3.5.4-r0   3.5.5-r0  apk     CVE-2025-15467  Critical  74.8% (99th)  70.3
python      3.9.25               binary  CVE-2023-36632  High      1.6% (75th)   1.2

표는 200줄 안팎이었습니다. FIXED IN이 비어 있는 python 3.9.25는 수정 버전이 아직 없습니다. EPSS는 실제로 악용될 가능성을 추정한 값이고 RISK는 심각도와 EPSS를 합친 점수입니다.

Grype 표의 앞 일곱 줄에서 libcrypto3와 libssl3가 같은 CVE 번호로 두 줄씩 나오고, 심각도가 Critical에서 High, Medium 순으로 보이는 것을 확인합니다. 이 캡처는 EPSS와 RISK 열을 잘라 냈습니다.
Grype 표의 앞 일곱 줄에서 libcrypto3와 libssl3가 같은 CVE 번호로 두 줄씩 나오고, 심각도가 Critical에서 High, Medium 순으로 보이는 것을 확인합니다. 이 캡처는 EPSS와 RISK 열을 잘라 냈습니다.

이 단계의 파일 내려받기:scan_sbom.sh

2. 숫자로 집계

표 대신 JSON으로 받아 센 결과입니다.

docker run --rm -v "$PWD:/w" anchore/grype:latest sbom:/w/sbom.json -o json
# 기대 출력
일치 200건
Counter({'High': 82, 'Medium': 79, 'Low': 25, 'Critical': 11, 'Unknown': 2, 'Negligible': 1})
고유 취약점 번호 133개, 해당 패키지 16개
종류별: apk 143, binary 45, python 12

200건이 곧 200개의 문제는 아닙니다. 같은 취약점 번호(CVE)가 libcrypto3와 libssl3처럼 묶여 있는 패키지마다 따로 세어져서, 고유 번호는 133개였습니다. 보고할 때는 "일치 건수"와 "고유 CVE 수"를 구분합니다.

3. 고칠 수 있는 것만 보기

... sbom:/w/sbom.json --only-fixed -o json

수정 버전이 있는 건은 167건이었습니다. 200건 중 33건은 지금 올릴 버전이 없습니다. 팀에 요청할 일은 167건 쪽이고, 나머지는 위험을 기록하고 추적하는 항목입니다.

4. 종료 코드로 빌드 막기

... sbom:/w/sbom.json --fail-on high ; echo $?
... sbom:/w/sbom.json --fail-on critical ; echo $?
# 기대 출력
2
2

두 경우 모두 종료 코드 2가 돌아왔습니다. 이 이미지에 High와 Critical이 모두 있기 때문입니다. CI에서 이 코드를 보고 단계를 실패시키면 게이트가 됩니다. 취약점이 없을 때 0이 나오는지는 이 글에서 확인하지 않았습니다.

grype에 --fail-on high를 주고 실행한 뒤 echo로 찍은 종료 코드가 2인 것을 확인합니다.
grype에 --fail-on high를 주고 실행한 뒤 echo로 찍은 종료 코드가 2인 것을 확인합니다.

5. 더 해 보기: 이미지 비교, 출력 형식, 예외 설정, 종료 코드 0

grype_more.sh로 다섯 가지를 더 확인했습니다. 데이터베이스는 도커 볼륨(grype_cache)에 한 번 받아 두고 이후 실행에서 재사용해, 첫 실행만 시간이 걸리게 했습니다. 이 PC에서 받은 데이터베이스는 스키마 v6.1.10, 빌드 시각 2026-10-28T06:23:30Z였습니다.

이미지 두 개 비교. 앞 글의 python:3.9-alpine과 최신 python:3.12-alpine의 SBOM을 같은 데이터베이스로 점검했습니다.

이미지 일치 건수 심각도별
python:3.9-alpine 200건 Critical 11, High 82, Medium 79, Low 25
python:3.12-alpine 16건 Medium 14, Low 1

오래된 이미지에서 최신 이미지로 올리는 것만으로 Critical 11건과 High 82건이 모두 사라졌습니다. 취약점 점검 결과를 보고할 때 "고치는 방법은 이미지를 올리는 것"이라고 말할 근거가 됩니다.

출력 형식. 같은 3.9 SBOM을 세 형식으로 저장했습니다.

형식 크기 쓰는 곳
json 890,595바이트 직접 집계(이 글 2절)
sarif 729,827바이트 코드 호스팅 서비스의 보안 화면에 올리는 표준 형식. 결과 200건, SARIF 버전 2.1.0
cyclonedx-json 753,615바이트 취약점을 SBOM 안에 붙여 다른 도구에 넘길 때

예외 설정. 영향이 없다고 판단한 취약점은 .grype.yaml에 적어 제외합니다. 여기서는 가장 앞의 Critical인 CVE-2025-15467을 제외했습니다.

ignore:
  - vulnerability: CVE-2025-15467

제외 전 200건(Critical 11)이 제외 후 198건(Critical 9)이 되었습니다. CVE 하나를 제외했는데 두 건이 빠진 것은 libcrypto3와 libssl3 두 패키지에 같은 CVE가 걸려 있었기 때문입니다(2절에서 본 "일치 건수와 고유 CVE 수가 다르다"와 같은 이유입니다). 아무 CVE나 제외하면 위험이 가려지므로, 실무에서는 제외하는 이유와 날짜를 함께 기록합니다.

종료 코드 0. 4절에서 확인하지 못했던 0이 나오는 경우입니다. --only-fixed --fail-on critical로 두 이미지를 점검했습니다.

이미지 종료 코드 뜻
python:3.9-alpine 2 수정 버전이 있는 Critical이 있음
python:3.12-alpine 0 수정 버전이 있는 Critical이 없음. 빌드가 통과함

종료 코드 0은 취약점이 없다는 뜻이 아닙니다. 3.12 이미지에도 Medium 14건이 남아 있고, 이 명령은 "고칠 수 있는 Critical"만 기준으로 막았을 뿐입니다. 어떤 심각도에서 막을지는 팀이 정합니다.

grype_more.sh 실행 결과에서 3.9는 200건에 Critical 11이고 3.12는 16건이며, 세 형식의 크기와 sarif 결과 200건이 나오고, CVE 하나를 제외하면 200건이 198건이 되며, 종료 코드가 3.9는 2이고 3.12는 0인 것을 확인합니다.
grype_more.sh 실행 결과에서 3.9는 200건에 Critical 11이고 3.12는 16건이며, 세 형식의 크기와 sarif 결과 200건이 나오고, CVE 하나를 제외하면 200건이 198건이 되며, 종료 코드가 3.9는 2이고 3.12는 0인 것을 확인합니다.

이 단계의 파일 내려받기:grype_more.sh

전체 코드

아래 파일 하나가 이 글의 점검을 모두 실행합니다. 앞 글의 make_sbom.sh로 만든 sbom.json과 같은 폴더에 scan_sbom.sh로 저장하고 bash scan_sbom.sh로 실행합니다. 이미지를 직접 지정하지 않고 SBOM 파일만 읽으며, 이 PC에서는 도커 실행이 다섯 번이라 약 5분이 걸렸습니다.

scan_sbom.sh 실행 결과에서 표의 앞 일곱 줄, 일치 200건과 심각도별 개수, 고유 CVE 133개, 수정 버전이 있는 167건, fail-on high와 critical의 종료 코드가 모두 2인 것을 확인합니다.
scan_sbom.sh 실행 결과에서 표의 앞 일곱 줄, 일치 200건과 심각도별 개수, 고유 CVE 133개, 수정 버전이 있는 167건, fail-on high와 critical의 종료 코드가 모두 2인 것을 확인합니다.

# scan_sbom.sh
#!/usr/bin/env bash
# 앞 글에서 만든 sbom.json 을 Grype 로 점검하고 심각도와 고유 CVE 수를 센다.
# 준비: Docker, 파이썬, 같은 폴더의 sbom.json (syft-sbom-container-image 글의 make_sbom.sh 로 만든다)
# 실행: bash scan_sbom.sh
set -u
export MSYS_NO_PATHCONV=1          # Git Bash 가 /w 같은 경로를 바꾸지 않게 한다
HERE="$(pwd -W 2>/dev/null || pwd)"  # 윈도우는 C:/... 경로, 리눅스는 그대로
GRYPE="docker run --rm -v $HERE:/w anchore/grype:latest sbom:/w/sbom.json"

echo "## 1. 표(앞 8줄, 폭 줄임)"
$GRYPE -o table 2>/dev/null | head -8 | cut -c1-110

echo "## 2. JSON 으로 받아 집계"
$GRYPE -o json 2>/dev/null | python -X utf8 -c "
import json, sys
from collections import Counter
d = json.load(sys.stdin); ms = d['matches']
print('일치', len(ms), '건', dict(Counter(m['vulnerability']['severity'] for m in ms)))
print('고유 CVE', len({m['vulnerability']['id'] for m in ms}), '개, 패키지', len({m['artifact']['name'] for m in ms}), '개')
"

echo "## 3. 고칠 수 있는 것만"
$GRYPE --only-fixed -o json 2>/dev/null | python -X utf8 -c "import json,sys; print('수정 버전 있는 일치', len(json.load(sys.stdin)['matches']), '건')"

echo "## 4. 종료 코드 게이트"
$GRYPE --fail-on high >/dev/null 2>&1; echo "--fail-on high 종료 코드: $?"
$GRYPE --fail-on critical >/dev/null 2>&1; echo "--fail-on critical 종료 코드: $?"

grype_more.sh는 scan_sbom.sh와 같은 폴더에서 실행하며 sbom.json이 있어야 합니다. 임시 파일은 끝에서 지우고 캐시 볼륨 grype_cache만 남깁니다. 필요 없으면 docker volume rm grype_cache로 지웁니다.

#!/usr/bin/env bash
# Grype 심화: 데이터베이스 캐시, 이미지 두 개 비교, 출력 형식, 예외 설정(.grype.yaml), 수정 가능한 것만 막기.
# 준비: Docker, 파이썬, 같은 폴더의 sbom.json(python:3.9-alpine 의 SBOM, syft-sbom-container-image 글의 make_sbom.sh 로 만든다)
# 실행(Git Bash): bash grype_more.sh   (약 5분, 첫 실행은 데이터베이스를 내려받는다)
set -u
export MSYS_NO_PATHCONV=1
HERE="$(pwd -W 2>/dev/null || pwd)"
GRYPE="docker run --rm -v grype_cache:/.cache/grype -v $HERE:/w anchore/grype:latest"
count() { python -X utf8 -c "
import json, sys
from collections import Counter
m = json.load(sys.stdin)['matches']
c = Counter(x['vulnerability']['severity'] for x in m)
print('일치', len(m), '건', {k: c[k] for k in ('Critical', 'High', 'Medium', 'Low') if c[k]})
"; }

echo "## 1. 데이터베이스를 캐시 볼륨에 받아 두기(이후 실행은 다시 받지 않는다)"
$GRYPE db update 2>&1 | tail -1
$GRYPE db status 2>&1 | grep -E 'Schema|Built|Status'

echo "## 2. 이미지 두 개 비교: python:3.9-alpine 과 python:3.12-alpine"
docker run --rm anchore/syft:latest python:3.12-alpine -o cyclonedx-json 2>/dev/null > sbom312.json
printf '3.9  '; $GRYPE sbom:/w/sbom.json -o json 2>/dev/null | count
printf '3.12 '; $GRYPE sbom:/w/sbom312.json -o json 2>/dev/null | count

echo "## 3. 출력 형식(3.9 SBOM): json, sarif, cyclonedx-json"
for f in json sarif cyclonedx-json; do
  $GRYPE sbom:/w/sbom.json -o $f 2>/dev/null > out-$f.json
  printf '%-15s %8s bytes\n' $f "$(wc -c < out-$f.json | tr -d ' ')"
done
python -X utf8 -c "
import json
s = json.load(open('out-sarif.json', encoding='utf-8'))
print('sarif 버전', s['version'], '결과', len(s['runs'][0]['results']), '건')
"

echo "## 4. 예외 설정: .grype.yaml 로 CVE 한 개 제외"
$GRYPE sbom:/w/sbom.json -o json 2>/dev/null | python -X utf8 -c "
import json, sys
m = json.load(sys.stdin)['matches']
top = sorted(m, key=lambda x: (x['vulnerability']['severity'] != 'Critical', x['vulnerability']['id']))[0]['vulnerability']['id']
open('top.txt', 'w').write(top)
print('가장 앞의 Critical:', top)
"
TOP=$(cat top.txt)
printf 'ignore:\n  - vulnerability: %s\n' "$TOP" > .grype.yaml
printf '제외 전 '; $GRYPE sbom:/w/sbom.json -o json 2>/dev/null | count
printf '제외 후 '; $GRYPE sbom:/w/sbom.json -c /w/.grype.yaml -o json 2>/dev/null | count

echo "## 5. 수정 버전이 있는 Critical 이 있을 때만 막기"
$GRYPE sbom:/w/sbom.json --only-fixed --fail-on critical >/dev/null 2>&1; echo "3.9  종료 코드: $?"
$GRYPE sbom:/w/sbom312.json --only-fixed --fail-on critical >/dev/null 2>&1; echo "3.12 종료 코드: $?"
rm -f out-*.json top.txt .grype.yaml sbom312.json
이 단계의 파일 내려받기:grype_more.shscan_sbom.sh

자주 막히는 곳

증상 원인과 해결
결과가 어제와 다릅니다 취약점 데이터베이스가 계속 갱신됩니다. 같은 SBOM도 날짜에 따라 건수가 달라집니다
표가 중간에서 끊깁니다 `
너무 오래 걸립니다 첫 실행에는 데이터베이스를 내려받습니다. 이미지를 직접 지정해 점검하는 명령은 이 PC에서 제한 시간 안에 끝나지 않아 글에서 뺐습니다

확인 범위

  • 해 본 것(심화 점검 포함): 2026-10-28과 29일, Windows 11 · Docker 29.5.3 · Grype 0.121.0으로 SBOM 파일을 표와 JSON으로 점검하고 --only-fixed, --fail-on high와 --fail-on critical을 실행했습니다. 29일에 전체 스크립트로 같은 건수(200건, 고유 CVE 133개, 수정 버전 있는 167건)가 나오는 것을 다시 확인했습니다.
  • 해 보지 않은 것: VEX 문서로 예외 처리, 다른 도구(Trivy)와의 결과 비교, SARIF를 실제 서비스에 올리는 것, 판정된 취약점이 실제로 악용 가능한지 확인.
  • 읽을 때 주의: 건수는 이 날짜의 데이터베이스와 이미지 기준이며 계속 변합니다. Critical이 11건이라는 사실이 이 이미지를 쓰면 안 된다는 판단을 대신하지 않습니다.

이 글의 다음 단계

  • npm audit --audit-level 사용법: 종료 코드로 배포 막기npm audit --audit-level은 지정한 심각도 이상의 취약점이 있을 때만 종료 코드 1을 돌려줍니다. low부터 critical까지 단계별 종료 코드와 --omit=dev를 붙였을 때의 차이를 실제 실행 결과로 확인합니다. npm script와 CI 단계에 넣는 방법도 정리합니다.
  • 컨테이너 이미지에 서명하고 서명 없는 이미지 거부하기(cosign)내 컴퓨터의 로컬 레지스트리에 작은 이미지를 올리고 cosign으로 서명해 검증합니다. SBOM 증명을 붙이고, 같은 태그로 다른 이미지를 덮어쓰면 검증이 실패하는 것과 서명 없는 이미지가 거부되는 것을 재현한 뒤, 다이제스트로 고정해 배포하는 게이트 스크립트로 마무리합니다.

이 내용을 팀 교육으로 진행하고 싶으신가요?

인원, 수준, 일정에 맞춰 실습 환경까지 준비해 진행합니다. 대상과 기간을 알려 주시면 구성을 제안해 드립니다.

교육 문의하기

교육 진행 순서와 자주 묻는 질문 보기

팀이나 교육 담당자에게 이 글 제안하기

메일로 보내실 수도 있습니다: fankh111@gmail.com

같은 카테고리의 글