wbsong111
f9a2d8400f
PR #18 이 카탈로그에 넣는 quay.io/keycloak/keycloak:26.6.4 가 게이트에서 차단 17건(실효 HIGH 17 / CRITICAL 0)이었다. sbom.yml 이 warn-only 라 PR 은 통과했지만 실제로는 게이트 실패 상태로 카탈로그에 들어간다. ## 상위 태그·베이스 OS 교체를 먼저 검토한 결과 차단 17건 중 12건이 배포본에 함께 실린 jar 다. keycloak 26.6.4 와 최신 26.7.1 의 quarkus.version 이 둘 다 3.33.2.1 이고 그 BOM 이 netty 4.1.135.Final / jackson-bom 2.21.2 를 고정한다(keycloak pom.xml 두 태그 + quarkus BOM 실측). 필요한 수정 버전은 netty 4.1.136.Final, jackson 2.21.4 라 **상위 태그로도 풀리지 않고**, CVE 가 OS 패키지가 아니라 jar 자체라 **베이스 OS 교체도 통하지 않는다.** jar 를 직접 교체하는 자체 빌드가 유일한 수단이다 — etcd 이미지의 `go.work replace golang.org/x/text` 와 같은 성격의 의존성 override. ## images/keycloak/ 업스트림 quarkus/container/Dockerfile 을 기준으로 하되 셋이 다르다. 1. 런타임 rootfs 가 SUSE BCI. bci-micro 파일시스템을 **씨앗으로 깔고** 그 위에 zypper --installroot 로 설치한다. 업스트림 ubi-null.sh 처럼 별도 installroot 를 micro 위에 덮으면 micro 의 rpmdb 가 가려져 micro 자체 패키지가 SBOM 에서 통째로 사라진다 — CVE 가 주는 게 아니라 스캔 사각지대가 생긴다. 씨앗 방식으로 OS 패키지 65종이 정상적으로 잡히는 것을 SBOM 으로 확인했다. 2. 취약 jar 오버레이(overlay-jars.sh). netty 17종 → 4.1.136.Final, jackson core/databind → 2.21.4, pgjdbc → 42.7.12. Quarkus fast-jar 의 클래스패스가 파일명을 그대로 참조하므로 **파일명은 유지하고 내용만** 바꾸고 sha1 로 검증한다. trivy 는 jar 내부 메타데이터를 읽으므로 SBOM 에 새 버전이 정확히 잡힌다. 3. bin/client 제거. keycloak-admin-cli 가 jackson 을 shade 로 품은 uber-jar 라 교체가 불가능하다. 서버 JVM 이 로드하지 않는 독립 CLI 라 제거했다 — 업스트림 대비 유일한 기능적 차이이며 CUSTOM-README 에 대안을 적었다. 버전은 26.7.1 로 올렸다. 26.6.4 는 26.7.1(및 26.6.5)에서만 패치된 keycloak-services HIGH 5건(CVE-2026-16102/16442/16443/15572/15573)에 취약하다. 차트(keycloakx 7.2.2)는 최신이고 그대로 둔다 — appVersion 26.6.4 는 codecentric 의 릴리스 캐던스 지연이다. ## 베이스 OS 정책 확정 (image-authoring.md 원칙 2 미결 해소) SUSE BCI 로 통일하되 **버전은 이미지마다 실측해서 고른다.** BCI 16.0 이 나와 있지만 SLE_BCI 의 java-21-openjdk-headless 가 15.7 은 21.0.12, 16.0 은 21.0.11 이라 최신 베이스로 가면 CVE-2026-41254·CVE-2026-47063 이 오히려 남는다. bci-micro 에 sed·grep·find 가 셋 다 없다는 것과 SLE 패키지명 차이(tzdata→timezone 등)도 함께 기록했다. ## 실측 결과 로컬 빌드(linux/amd64) → verify.sh → SBOM → 전 심각도 스캔 → 게이트: 차단 17건 → **0건** (커버리지 자가진단 ok, OS=sles 15.7) 남은 1건 CVE-2025-59250 은 예외 등록했다 — 트리비가 같은 mssql-jdbc jar 하나로 컴포넌트를 둘 만들어(pom.properties 의 13.2.1.jre11 / 파일명의 13.2.1) 접미사가 잘린 쪽이 매칭된 파싱 오탐이다. 설치본은 FixedVersion 목록에 있는 13.2.1.jre11 이다. dev 클러스터 격리 네임스페이스(kc-test-build)에 cnpg-cluster + keycloakx 로 실배포 검증: Pod Running, jdbc-postgresql 연결, liquibase 스키마 생성, admin 부트스트랩 (KC-SERVICES0077), apisix ingress 경유 OIDC discovery 200 / admin 토큰 발급 / realm·client 생성(201) 까지 확인. 정리 시 Longhorn Volume 까지 삭제했다. ## custom-values.yaml ingress 수정 path 가 exact "/" 였다. apisix 에서는 루트만 매치되어 /realms/*, /admin/* 이 전부 404 가 난다 — airflow·superset·mlflow·lakekeeper 에서 이미 실측된 문제로 카탈로그가 regex 방식으로 통일돼 있다. path: /.* + k8s.apisix.apache.org/use-regex 로 맞췄고, 배포 검증에서 이 경로들이 실제로 뜨는 것을 확인했다. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
111 lines
5.4 KiB
Docker
111 lines
5.4 KiB
Docker
# Keycloak — SUSE BCI 기반 자체 빌드 (+ 취약 jar 오버레이)
|
|
#
|
|
# 업스트림: https://github.com/keycloak/keycloak/blob/main/quarkus/container/Dockerfile
|
|
#
|
|
# 업스트림과의 대응 관계
|
|
# registry.access.redhat.com/ubi9 (빌더) → registry.suse.com/bci/bci-base:15.7
|
|
# ubi-null.sh (rootfs 구성 후 불필요 rpm erase) → bci-micro 파일시스템 씨앗 + zypper --installroot
|
|
# registry.access.redhat.com/ubi9-micro (최종) → FROM scratch + 위 rootfs
|
|
# ADD $KEYCLOAK_DIST → tar → /opt/keycloak → 동일
|
|
# keycloak:x:0:root / uid 1000 / ENTRYPOINT → 동일
|
|
# (없음) → 취약 jar 오버레이 + kc.sh build 재augmentation
|
|
#
|
|
# 왜 자체 빌드인가 (상위 태그·베이스 OS 교체로 안 풀리는 근거)
|
|
# 차단 17건 중 12건이 배포본에 정적으로 들어 있는 jar 다. keycloak 26.6.4 와 26.7.1 의
|
|
# quarkus.version 이 둘 다 3.33.2.1 이고 그 BOM 이 netty 4.1.135.Final / jackson-bom
|
|
# 2.21.2 를 고정한다 — 상위 태그로 올려도 그대로다. 베이스 OS 교체도 jar 에는 통하지
|
|
# 않는다. 그래서 jar 를 직접 교체하는 자체 빌드가 유일한 수단이다.
|
|
# (etcd 이미지의 `go.work replace golang.org/x/text` 와 같은 성격의 의존성 override)
|
|
#
|
|
# 왜 SUSE BCI 인가
|
|
# 기존 자체 빌드 3종(cloudnative-pg·cnpg-postgresql·etcd)이 전부 SUSE BCI 이고,
|
|
# trivy 의 SLES 15.7 커버리지는 양성 대조로 실측 확인돼 있다
|
|
# (doc/analysis/sles-oval-measurement.md). "업스트림과 최대한 동일하게" 원칙과
|
|
# 충돌하지만 카탈로그 내 일관성을 우선했다 — 근거는 README.md.
|
|
#
|
|
# ARG 는 반드시 첫 FROM 이전(전역 스코프)에 선언한다. 스테이지 내부에 두면 지역 변수가
|
|
# 되어 이후 FROM 의 이미지명 해석에 쓰이지 않는다 (.claude/image-authoring.md 원칙 3).
|
|
ARG BUILDER_BASE=registry.suse.com/bci/bci-base:15.7
|
|
ARG MICRO_BASE=registry.suse.com/bci/bci-micro:15.7
|
|
|
|
# 최종 런타임 rootfs 의 씨앗. 여기서 직접 빌드하지 않고 파일시스템만 가져다 쓴다.
|
|
FROM ${MICRO_BASE} AS micro
|
|
|
|
|
|
FROM ${BUILDER_BASE} AS builder
|
|
|
|
ARG KEYCLOAK_VERSION
|
|
ARG RUNTIME_PACKAGES
|
|
ARG NETTY_OLD
|
|
ARG NETTY_VERSION
|
|
ARG JACKSON_OLD
|
|
ARG JACKSON_VERSION
|
|
ARG PGJDBC_OLD
|
|
ARG PGJDBC_VERSION
|
|
|
|
# (a) 런타임 rootfs 구성.
|
|
#
|
|
# bci-micro 의 파일시스템을 씨앗으로 깔고 그 위에 zypper --installroot 로 설치한다.
|
|
# 별도 installroot 를 만들어 micro 위에 COPY 로 덮는 방식(업스트림 ubi-null.sh 가
|
|
# ubi9-micro 에 하는 것)을 쓰지 않는 이유: 그러면 micro 의 rpmdb 가 새 rpmdb 로 가려져
|
|
# micro 자체 패키지가 SBOM 에서 사라진다 — CVE 가 줄어드는 게 아니라 스캔 사각지대가
|
|
# 생기는 것이다. 씨앗 방식은 rpmdb 가 micro 것 위에 이어 써져 전부 보인다.
|
|
#
|
|
# rpm --import 를 먼저 한다. 안 하면 installroot 의 rpmdb 에 SUSE 키가 없어 설치되는
|
|
# 패키지마다 "Header V3 RSA/SHA256 Signature, key ID ...: NOKEY" 로 개별 서명 검증이
|
|
# 생략된다(저장소 메타데이터 서명은 zypper 가 확인하지만 패키지 단위 검증은 별개다).
|
|
COPY --from=micro / /rootfs
|
|
RUN set -eux; \
|
|
rpm --root /rootfs --import /usr/lib/rpm/gnupg/keys/*.asc; \
|
|
zypper --non-interactive --installroot /rootfs --gpg-auto-import-keys refresh; \
|
|
zypper --non-interactive --installroot /rootfs install -y --no-recommends \
|
|
${RUNTIME_PACKAGES}; \
|
|
zypper --non-interactive --installroot /rootfs clean --all; \
|
|
rm -rf /rootfs/var/log/zypp /rootfs/var/cache/zypp /rootfs/var/cache/zypper
|
|
|
|
# (b) 업스트림 배포본 전개 — 업스트림의 ADD $KEYCLOAK_DIST + tar 단계와 동일하다.
|
|
ADD https://github.com/keycloak/keycloak/releases/download/${KEYCLOAK_VERSION}/keycloak-${KEYCLOAK_VERSION}.tar.gz /tmp/keycloak/
|
|
RUN set -eux; \
|
|
cd /tmp/keycloak; \
|
|
tar -xf keycloak-*.tar.gz; \
|
|
rm keycloak-*.tar.gz; \
|
|
mv keycloak-* /opt/keycloak; \
|
|
mkdir -p /opt/keycloak/data; \
|
|
chmod -R g+rwX /opt/keycloak
|
|
|
|
# (c) 취약 jar 오버레이. 파일명은 그대로 두고 내용만 수정 버전으로 바꾼다 — 상세는
|
|
# overlay-jars.sh 주석. 대상 파일을 하나도 못 찾으면 스크립트가 실패한다.
|
|
COPY overlay-jars.sh /tmp/
|
|
RUN bash /tmp/overlay-jars.sh /opt/keycloak
|
|
|
|
|
|
FROM scratch AS final
|
|
|
|
COPY --from=builder /rootfs/ /
|
|
COPY --from=builder --chown=1000:0 /opt/keycloak /opt/keycloak
|
|
|
|
ENV LANG=en_US.UTF-8
|
|
# 업스트림과 동일 — 컨테이너 실행 여부 판별 플래그
|
|
ENV KC_RUN_IN_CONTAINER=true
|
|
|
|
RUN echo "keycloak:x:0:root" >> /etc/group && \
|
|
echo "keycloak:x:1000:0:keycloak user:/opt/keycloak:/sbin/nologin" >> /etc/passwd
|
|
|
|
# SUSE 는 java 를 update-alternatives 심볼릭 링크로 노출한다. chroot 설치라 이 링크가
|
|
# 안 만들어질 수 있어 빌드 시점에 단정한다 — 런타임에 "java: not found" 로 죽는 것보다
|
|
# 여기서 깨지는 게 낫다.
|
|
RUN java -version 2>&1 | head -1
|
|
|
|
# 오버레이한 jar 로 augmentation 이 실제로 통과하는지 빌드 시점에 확인한다.
|
|
# 옵션 없는 build 는 릴리스 tar 의 사전 augmentation 상태를 그대로 재현하므로
|
|
# 런타임 동작은 업스트림 이미지와 같다(최적화 이미지로 만드는 것이 아니다).
|
|
RUN /opt/keycloak/bin/kc.sh build && chown -R 1000:0 /opt/keycloak
|
|
|
|
USER 1000
|
|
|
|
EXPOSE 8080
|
|
EXPOSE 8443
|
|
EXPOSE 9000
|
|
|
|
ENTRYPOINT [ "/opt/keycloak/bin/kc.sh" ]
|