wbsong111
9e5b6633db
실제 레포명은 hardened-containers인데 이관 커밋 이후 문서·워크플로·차트 주석에 잘못된 이름 security-images가 남아 있었다. 텍스트 참조 전체를 정정하고 doc/migrations/의 이관 핸드오프 문서도 파일명까지 리네임했다. env var/secret 이름(SECURITY_IMAGES_REPO, SECURITY_IMAGES_DISPATCH_TOKEN)은 GitHub Secret 재등록이 필요한 별도 운영 작업이라 이번 텍스트 정정 범위에서 제외했다. 덧붙여 scripts/build/patch-catalog-tag.py의 docstring이 삭제된 build-image.yml을 호출자로 여전히 가리키고 있던 것도 실제 호출 경로(check-rebuild-needed.py / apply-published-tags.py → catalog-tag-update.yml)로 고쳤다. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
53 lines
4.1 KiB
Markdown
53 lines
4.1 KiB
Markdown
---
|
|
name: cve-remediation
|
|
description: 게이트가 카탈로그 이미지에서 차단 CVE(CRITICAL/HIGH)를 잡았을 때 태그 교체·베이스 OS 교체·자체 빌드·예외 승인 중 어느 레버를 쓸지 판단할 때 사용한다. "이 CVE 어떻게 없애", "차단 CVE 뭐부터 해야 해", "자체 빌드 가야 하나 예외 가야 하나", "게이트 실패 다음 스텝" 같은 요청이 해당한다. sbom-cve-gate 로 게이트를 해석하는 것과 hardened-containers 레포에서 자체 빌드를 실행하는 것 사이의 결정 단계만 담당하며 둘의 절차는 복제하지 않는다.
|
|
---
|
|
|
|
# 차단 CVE 대응 절차
|
|
|
|
이 skill 은 실행하지 않는다 — 레버를 판단해 실행 skill로 넘긴다. 게이트 실행/해석은
|
|
`sbom-cve-gate`, 자체 빌드는 **별도 레포 `hardened-containers`**(그 레포의
|
|
`docs/image-authoring.md`가 단일 출처), 배포 검증은
|
|
[deploy-test-procedure.md](../../deploy-test-procedure.md)가 단일 출처다 — 여기 반복 안 한다.
|
|
|
|
## 흐름
|
|
|
|
1. `sbom-cve-gate`로 게이트 결과부터 본다. `CoverageProbe`가 `none`이면 레버 선택 전에
|
|
그것부터 해소한다 — 데이터 없는 0건은 판단 근거가 아니다.
|
|
2. 차단 CVE를 컴포넌트 단위로 나눈다. "N건"이 성격 다른 여러 그룹(OS 패키지 vs 앱이
|
|
번들/pin한 라이브러리)일 수 있고 그룹마다 레버가 다를 수 있다 — keycloak은 17건이
|
|
OS rpm 5건 + Quarkus BOM pin jar 12건으로 갈렸다.
|
|
3. **레버를 고르기 전에 "이 컴포넌트가 필요하긴 한가"를 먼저 묻는다.** 차트 기본값으로 켜져
|
|
있을 뿐 우리가 쓰지 않는 컴포넌트가 차단의 큰 몫을 만들고 있을 수 있다 — argo-cd 는
|
|
`configs.cm.oidc.config` 로 Keycloak 에 직접 붙는데 차트 기본값 `dex.enabled: true` 때문에
|
|
쓰이지도 않는 파드가 떠서 혼자 차단 57건(전체의 58%)을 만들고 있었다. 한 줄로 끝났다.
|
|
가장 값싼 레버이고, 아래 표에는 없다.
|
|
4. 그룹별로 위부터 먼저 맞는 것을 쓴다:
|
|
|
|
| 조건 | 레버 |
|
|
|---|---|
|
|
| 최신 상위 태그가 이미 고쳤다 | 태그 교체 |
|
|
| 베이스가 distroless/scratch, CVE가 정적 링크 바이너리(Go 모듈 등)에 있다 | 베이스 OS 교체 불가 → 자체 빌드 |
|
|
| 앱이 번들·직접 pin한 라이브러리(jar 등)에 있다(OS 패키지 아님) | 태그·베이스 OS 둘 다 무효 → 자체 빌드(overlay/재컴파일) |
|
|
| 다른 배포판이 backport로 이미 고쳤다 | 베이스 OS 교체 |
|
|
| 컴포넌트가 중복/오탐 의심 | 5번 검증 후 예외, 아니면 자체 빌드 |
|
|
|
|
5. 예외는 검증 후에만 — "위험이 낮아 보인다"는 근거가 아니다. InstalledVersion이
|
|
FixedVersion 이상인지, 같은 파일이 SBOM에서 컴포넌트 두 개로 잡히지 않는지(PkgPath
|
|
비교) 확인한다. 실례: keycloak `CVE-2025-59250`(mssql-jdbc jar 하나가 두 컴포넌트로
|
|
잡혀 잘린 쪽만 매칭된 오탐). 근거·만료일은 `doc/cve-exceptions.json`.
|
|
6. 자체 빌드는 별도 레포 `hardened-containers`에서 한다 — 그 레포의
|
|
`docs/image-authoring.md`가 절차 단일 출처다. 재빌드가 필요하면 그 레포의
|
|
`build-image.yml`을 `workflow_dispatch`로 부른다(`scripts/build/check-rebuild-needed.py`
|
|
가 배포 중인 이미지를 스캔해 대상을 판단한다). 태그/베이스 OS 교체는 카탈로그
|
|
values만 바꾸고 재게이트한다 — 별도 스크립트 없음.
|
|
7. 수정 후 반드시 재게이트하고 PASS라도 배포 검증까지 끝나야 종료다 — 1회로 끝난다고
|
|
가정하지 않는다(keycloak은 1차 수정 후 재스캔에서 micrometer 2건이 새로 잡혔다).
|
|
8. 착지는 브랜치 push까지다 — 조직 정책상 `GITHUB_TOKEN`으로 PR을 못 연다. 사람이 PR을
|
|
열고, 판단 근거는 PR 설명 + `MEMORY.md`에 남긴다.
|
|
|
|
## 참고
|
|
|
|
- 레버 실행: [sbom-cve-gate](../sbom-cve-gate/SKILL.md) · 자체 빌드는 별도 레포 `hardened-containers`
|
|
- 함정: [pitfalls.md](../../pitfalls.md) · 미결 사항: [MEMORY.md](../../../MEMORY.md)
|