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

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

- 주소: https://copyandrun.com/blog/grype-sbom-vulnerability-scan/
- 분야: DevSecOps
- 발행일: 2026-10-28
- 태그: Grype, SBOM, 취약점 점검, 종료 코드

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

## 준비물

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

## 1. 점검 실행

<!-- files: scan_sbom.sh -->

```bash
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 열을 잘라 냈습니다.](https://copyandrun.com/img/grype-sbom-vulnerability-scan/01-grype-표.png)

## 2. 숫자로 집계

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

```bash
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. 고칠 수 있는 것만 보기

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

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

## 4. 종료 코드로 빌드 막기

```bash
... 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인 것을 확인합니다.](https://copyandrun.com/img/grype-sbom-vulnerability-scan/02-fail-on.png)

## 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`을 제외했습니다.

```yaml
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인 것을 확인합니다.](https://copyandrun.com/img/grype-sbom-vulnerability-scan/04-심화-결과.png)

## 전체 코드

아래 파일 하나가 이 글의 점검을 모두 실행합니다. 앞 글의 `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인 것을 확인합니다.](https://copyandrun.com/img/grype-sbom-vulnerability-scan/03-전체-스크립트-결과.png)

```bash
# 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`로 지웁니다.

```bash
#!/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
```

## 자주 막히는 곳

| 증상 | 원인과 해결 |
|---|---|
| 결과가 어제와 다릅니다 | 취약점 데이터베이스가 계속 갱신됩니다. 같은 SBOM도 날짜에 따라 건수가 달라집니다 |
| 표가 중간에서 끊깁니다 | `| head`로 자르면 앞부분만 보입니다. 파일로 저장해서 봅니다 |
| 너무 오래 걸립니다 | 첫 실행에는 데이터베이스를 내려받습니다. 이미지를 직접 지정해 점검하는 명령은 이 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건이라는 사실이 이 이미지를 쓰면 안 된다는 판단을 대신하지 않습니다.
