From cda9dc607d384ca855a697b6c9d3c5c6343115e8 Mon Sep 17 00:00:00 2001 From: wbsong111 Date: Thu, 27 Aug 2026 14:45:19 +0900 Subject: [PATCH] =?UTF-8?q?CVE=20=EB=8C=80=EC=9D=91=20=EB=A0=88=EB=B2=84?= =?UTF-8?q?=20=EC=A0=95=EC=B1=85=EC=9D=84=202=EB=8B=A8=EA=B3=84(=EB=AC=B4?= =?UTF-8?q?=EB=A3=8C=20=EC=B9=98=ED=99=98/=EC=9E=90=EC=B2=B4=20=EB=B9=8C?= =?UTF-8?q?=EB=93=9C)+=EC=98=88=EC=99=B8=EB=A1=9C=20=EC=A0=95=EB=A6=AC?= =?UTF-8?q?=ED=95=9C=EB=8B=A4=20(#58)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit "베이스 OS 교체"를 독립 레버로 두던 기존 표현을 없앤다 — 이 저장소의 베이스 교체 이력을 전부 찾아보면 예외 없이 hardened-containers 자체 빌드 커밋이다(argocd· keycloak·cnpg-postgresql/etcd·apisix). 다른 배포판의 backport를 실제로 쓰려면 그 배포판 위에 앱을 다시 얹어야 하므로 그 자체가 이미 자체 빌드다. 빌드 없이 끝나는 진짜 무료 치환은 태그 교체와, 관리가 끊긴 벤더 이미지(bitnamilegacy 등)를 활성 벤더의 기존 이미지로 바꾸는 것뿐이다. dip-catalog는 이제 이미지를 전혀 빌드하지 않는다(자체 빌드는 hardened-containers로 완전히 이관됨) — 이 사실을 CLAUDE.md·관련 skill에 명시한다. 유일한 예외인 apisix keycloak-authz는 빌드가 아니라 이미 private으로 빌드된 이미지의 태그 반영이라 원칙에 위배되지 않는다. Co-authored-by: Claude Sonnet 5 --- .claude/skills/cve-remediation/SKILL.md | 34 ++++++++++++++++++------- .claude/skills/sbom-cve-gate/SKILL.md | 11 +++++--- CLAUDE.md | 15 ++++++++--- doc/sbom-pipeline.md | 3 ++- 4 files changed, 45 insertions(+), 18 deletions(-) diff --git a/.claude/skills/cve-remediation/SKILL.md b/.claude/skills/cve-remediation/SKILL.md index e09304b..2696cba 100644 --- a/.claude/skills/cve-remediation/SKILL.md +++ b/.claude/skills/cve-remediation/SKILL.md @@ -1,10 +1,20 @@ --- name: cve-remediation -description: 게이트가 카탈로그 이미지에서 차단 CVE(CRITICAL/HIGH)를 잡았을 때 태그 교체·베이스 OS 교체·자체 빌드·예외 승인 중 어느 레버를 쓸지 판단할 때 사용한다. "이 CVE 어떻게 없애", "차단 CVE 뭐부터 해야 해", "자체 빌드 가야 하나 예외 가야 하나", "게이트 실패 다음 스텝" 같은 요청이 해당한다. sbom-cve-gate 로 게이트를 해석하는 것과 hardened-containers 레포에서 자체 빌드를 실행하는 것 사이의 결정 단계만 담당하며 둘의 절차는 복제하지 않는다. +description: 게이트가 카탈로그 이미지에서 차단 CVE(CRITICAL/HIGH)를 잡았을 때 무료 치환(태그·이미지 좌표 교체)으로 끝낼지 hardened-containers 자체 빌드로 이관할지 예외 승인할지 판단할 때 사용한다. "이 CVE 어떻게 없애", "차단 CVE 뭐부터 해야 해", "자체 빌드 가야 하나 예외 가야 하나", "게이트 실패 다음 스텝" 같은 요청이 해당한다. sbom-cve-gate 로 게이트를 해석하는 것과 hardened-containers 레포에서 자체 빌드를 실행하는 것 사이의 결정 단계만 담당하며 둘의 절차는 복제하지 않는다. --- # 차단 CVE 대응 절차 +**이 레포는 이미지를 빌드하지 않는다.** 자체 빌드는 전부 별도 레포 +`hardened-containers`로 이관됐다(그 레포의 `docs/image-authoring/README.md`가 단일 +출처). 유일한 예외는 apisix의 keycloak-authz 커스텀 플러그인 오버레이 — 이것도 +dip-catalog가 뭔가를 빌드하는 게 아니라 **이미 다른 곳에서 private으로 빌드된 +이미지의 태그를 찾아 반영하는 것**뿐이다(`catalog/image-map/README.md` 참고). 그래서 +이 skill이 하는 일은 "빌드 없이 끝나는가, 아니면 hardened-containers로 넘겨야 하는가" +를 가르는 것까지다 — 실제로 어떻게 빌드할지(reinstall vs 재컴파일, 베이스 OS 선택 등) +는 hardened-containers의 `docs/image-authoring/README.md` 체크리스트가 이미 갖고 +있으므로 여기서 중복하지 않는다. + 이 skill 은 실행하지 않는다 — 레버를 판단해 실행 skill로 넘긴다. 게이트 실행/해석은 `sbom-cve-gate`, 자체 빌드는 **별도 레포 `hardened-containers`**(그 레포의 `docs/image-authoring/README.md`가 단일 출처), 배포 검증은 @@ -22,15 +32,20 @@ description: 게이트가 카탈로그 이미지에서 차단 CVE(CRITICAL/HIGH) `configs.cm.oidc.config` 로 Keycloak 에 직접 붙는데 차트 기본값 `dex.enabled: true` 때문에 쓰이지도 않는 파드가 떠서 혼자 차단 57건(전체의 58%)을 만들고 있었다. 한 줄로 끝났다. 가장 값싼 레버이고, 아래 표에는 없다. -4. 그룹별로 위부터 먼저 맞는 것을 쓴다: +4. 그룹별로 위부터 먼저 맞는 것을 쓴다. 레버는 실질적으로 셋뿐이다 — **"베이스 OS + 교체"라는 이름의 독립된 레버는 없다.** 이 저장소의 "베이스 교체" 이력을 전부 + 찾아보면 예외 없이 hardened-containers 자체 빌드 커밋이다(argocd·keycloak· + cnpg-postgresql/etcd·apisix 등) — 다른 배포판의 backport를 실제로 쓰려면 그 + 배포판 위에 앱을 다시 얹어야 하므로 그 자체가 이미 자체 빌드다. 진짜로 빌드 없이 + 끝나는 유일한 "좌표 교체"는 관리가 끊긴 벤더 이미지(`bitnamilegacy/*` 등)를 다른 + 활성 유지 벤더의 기존 이미지로 포인터만 바꾸는 경우뿐이다 — 아래 표 1번 줄에 + 포함시켰다. | 조건 | 레버 | |---|---| - | 최신 상위 태그가 이미 고쳤다 | 태그 교체 | - | 베이스가 distroless/scratch, CVE가 정적 링크 바이너리(Go 모듈 등)에 있다 | 베이스 OS 교체 불가 → 자체 빌드 | - | 앱이 번들·직접 pin한 라이브러리(jar 등)에 있다(OS 패키지 아님) | 태그·베이스 OS 둘 다 무효 → 자체 빌드(overlay/재컴파일) | - | 다른 배포판이 backport로 이미 고쳤다 | 베이스 OS 교체 | - | 컴포넌트가 중복/오탐 의심 | 5번 검증 후 예외, 아니면 자체 빌드 | + | 최신 상위 태그가 이미 고쳤다 / 관리가 끊긴 벤더 이미지를 다른 활성 벤더의 기존 이미지로 바꾸면 된다 | **무료 치환** — 카탈로그 values만 바꾸고 재게이트, 빌드 없음 | + | 그 외 전부 — 베이스가 distroless/scratch라 정적 링크 바이너리(Go 모듈 등)에 CVE가 있다 / 앱이 번들·직접 pin한 라이브러리(jar 등)에 CVE가 있다 / 다른 배포판의 backport를 쓰려면 결국 우리가 다시 빌드해야 한다 | **hardened-containers로 이관** — 이 레포는 여기서 손을 뗀다 | + | 컴포넌트가 중복/오탐 의심 | 5번 검증 후 예외, 아니면 hardened-containers로 이관 | 5. 예외는 검증 후에만 — "위험이 낮아 보인다"는 근거가 아니다. InstalledVersion이 FixedVersion 이상인지, 같은 파일이 SBOM에서 컴포넌트 두 개로 잡히지 않는지(PkgPath @@ -39,8 +54,9 @@ description: 게이트가 카탈로그 이미지에서 차단 CVE(CRITICAL/HIGH) 6. 자체 빌드는 별도 레포 `hardened-containers`에서 한다 — 그 레포의 `docs/image-authoring/README.md`가 절차 단일 출처다. 재빌드는 그 레포가 `rescan.yml`로 매일 자율 수행한다 — dip-catalog는 트리거하지 않는다. `sbom.yml`이 배포 중인 자체 - 빌드 이미지의 CVE 드리프트를 다른 카탈로그 이미지와 동일하게 보고만 한다. 태그/베이스 - OS 교체는 카탈로그 values만 바꾸고 재게이트한다 — 별도 스크립트 없음. + 빌드 이미지의 CVE 드리프트를 다른 카탈로그 이미지와 동일하게 보고만 한다. 무료 + 치환(태그·이미지 좌표 교체)은 카탈로그 values만 바꾸고 재게이트한다 — 별도 스크립트 + 없음. 7. 수정 후 반드시 재게이트하고 PASS라도 배포 검증까지 끝나야 종료다 — 1회로 끝난다고 가정하지 않는다(keycloak은 1차 수정 후 재스캔에서 micrometer 2건이 새로 잡혔다). 8. 착지는 브랜치 push까지다 — 조직 정책상 `GITHUB_TOKEN`으로 PR을 못 연다. 사람이 PR을 diff --git a/.claude/skills/sbom-cve-gate/SKILL.md b/.claude/skills/sbom-cve-gate/SKILL.md index 07790e2..010641d 100644 --- a/.claude/skills/sbom-cve-gate/SKILL.md +++ b/.claude/skills/sbom-cve-gate/SKILL.md @@ -52,12 +52,15 @@ gh run watch --repo /dip-catalog ## 차단 CVE 대응 우선순위 ``` -상위 태그 교체 → 베이스 OS 교체 → 자체 빌드 → 예외 승인 +무료 치환(태그 교체 · 이미지 좌표 교체) → 자체 빌드(hardened-containers) → 예외 승인 ``` -자체 빌드로 가야 한다면 별도 레포 `hardened-containers`에서 한다 — 그 레포의 -`docs/image-authoring/README.md`가 절차 단일 출처다. 판정 로직 상세는 -`scripts/pipeline/cve-gate.py`의 모듈 docstring을 1차 출처로 본다. +"베이스 OS 교체"라는 독립 레버는 없다 — 실제로 해보면 항상 자체 빌드로 귀결된다. +레버 판단 상세는 [cve-remediation](../cve-remediation/SKILL.md) skill이 갖는다. 자체 +빌드로 가야 한다면 별도 레포 `hardened-containers`에서 한다 — 그 레포의 +`docs/image-authoring/README.md`가 절차 단일 출처다. 이 레포는 이미지를 빌드하지 +않는다. 판정 로직 상세는 `scripts/pipeline/cve-gate.py`의 모듈 docstring을 1차 +출처로 본다. ## 참고 diff --git a/CLAUDE.md b/CLAUDE.md index f570e35..64120fe 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -150,7 +150,7 @@ python3 agent/update_catalog/skills/helm_diff/scripts/run.py \ |-------|------| | [chart-to-cnpg](.claude/skills/chart-to-cnpg/SKILL.md) | 카탈로그 차트의 내장 bitnami postgresql 서브차트를 전용 cnpg-cluster로 전환 | | [catalog-update-pipeline](.claude/skills/catalog-update-pipeline/SKILL.md) | 차트 신규 버전 감지 → diff → breaking 판정 → 문서 생성 파이프라인 실행 (`agent/update_catalog`) | -| [cve-remediation](.claude/skills/cve-remediation/SKILL.md) | 차단 CVE 대응 레버(태그 교체/베이스 OS 교체/자체 빌드/예외) 결정 — `sbom-cve-gate` 실행 또는 별도 레포 `hardened-containers`(자체 빌드)로 위임 | +| [cve-remediation](.claude/skills/cve-remediation/SKILL.md) | 차단 CVE 대응 레버(무료 치환/자체 빌드/예외) 결정 — `sbom-cve-gate` 실행 또는 별도 레포 `hardened-containers`(자체 빌드)로 위임 | | [sbom-cve-gate](.claude/skills/sbom-cve-gate/SKILL.md) | SBOM 생성·CVE 스캔·게이트 판정 실행 및 결과 해석 (`scripts/pipeline`) | 자체 빌드 하드닝 이미지 추가·변경은 이 레포의 일이 아니다 — 별도 레포 `hardened-containers` @@ -182,9 +182,16 @@ python3 agent/update_catalog/skills/helm_diff/scripts/run.py \ 이 레포가 아니라 `hardened-containers` 레포가 돌린다). - **`cve-edge-post.yml` 은 게이트를 부르지 않는다** — 같은 스캔 데이터에 판정기가 두 벌이라는 뜻이다(승인 예외·실효 등급 미적용). 외부 엔드포인트로 집계를 POST 하는 용도다. -- **자체 빌드는 대응 우선순위 3번**(상위 태그 교체 → 베이스 OS 교체 → 자체 빌드 → 예외 승인). - 레버 판단은 [cve-remediation](.claude/skills/cve-remediation/SKILL.md) skill 이 갖는다. - 실행은 `hardened-containers` 레포에서 `workflow_dispatch` 로만 한다. +- **레버 우선순위**: 무료 치환(상위 태그 교체 · 관리가 끊긴 벤더 이미지를 활성 벤더의 + 기존 이미지로 교체 — 카탈로그 values만 바꾸고 빌드는 없음) → 자체 빌드 + (`hardened-containers` 전담, 이 레포는 이관만 함) → 예외 승인. "베이스 OS 교체"라는 + 이름의 독립 레버는 없다 — 실제로 해보면 항상 자체 빌드로 귀결된다(실측: 이 저장소의 + 베이스 교체 이력 전부가 hardened-containers 커밋). 레버 판단은 + [cve-remediation](.claude/skills/cve-remediation/SKILL.md) skill 이 갖는다. 실행은 + `hardened-containers` 레포에서 `workflow_dispatch` 로만 한다. +- **이 레포는 이미지를 빌드하지 않는다.** 유일한 예외는 apisix의 keycloak-authz + 커스텀 플러그인 오버레이 — 이것도 빌드가 아니라 이미 private으로 빌드된 이미지의 + 태그를 반영하는 것뿐이다(`catalog/image-map/README.md` 참고). - **이 레포는 "무엇을 배포 중인가"만 안다.** 어느 이미지를 자체 빌드하고 있는지는 `catalog/image-map/` 이 단일 출처다. 배포 중인 자체 빌드 이미지의 CVE 드리프트는 `sbom.yml` 이 다른 카탈로그 이미지와 동일하게 스캔·보고한다 — 재빌드 여부·시점은 diff --git a/doc/sbom-pipeline.md b/doc/sbom-pipeline.md index a38b5a9..72bbf3b 100644 --- a/doc/sbom-pipeline.md +++ b/doc/sbom-pipeline.md @@ -213,7 +213,8 @@ Repo Secret `CVE_API_KEY`). ## 자체 빌드 축은 이 문서가 다루지 않는다 -게이트가 상위 태그 교체·베이스 OS 교체로 해소되지 않는 차단 CVE 를 찾으면 자체 빌드로 간다. +게이트가 무료 치환(상위 태그 교체·관리가 끊긴 벤더 이미지 좌표 교체)으로 해소되지 않는 +차단 CVE 를 찾으면 자체 빌드로 간다. 그 축은 **별도 레포 `hardened-containers`** 가 갖는다 — 빌드·검증·게이트·push·드리프트 재빌드 전부 그 레포 안에서 이루어지고(`rescan.yml`이 매일 자율 재스캔·재빌드), 단일 출처는 그 레포의 `docs/image-authoring/README.md` 다. 이 카탈로그에는 "어느 차트가 그 이미지를