fix(security): W4 red team 백엔드 발견(관리포트 노출·admin @Valid)을 고친다 #11

Closed
donghyeon.kang wants to merge 5 commits from claude/redteam-be-fixes into claude/t2b-relayout-e435ee
Owner

⚠️ t2b 재배치 PR(claude/t2b-relayout-e435ee)이 main에 병합된 뒤에 병합한다. 이 PR은 그 브랜치 위에 쌓였다(base = t2b 브랜치). t2b가 병합되면 base를 main으로 바꾼다.

무엇을 왜

W4 red team(소유자 승인) Round 1에서 찾은 백엔드 발견을 고친다. 템플릿 보안 결함은 파생 서비스 전부로 복제되므로, 전부 약한 기본값/일관성을 닫는다. 전체 리뷰·기준표·방법은 docs/reviews/2026-11-11-redteam-security-review.md.

고른 방법과 버린 대안

  • BE-CONFIG-001 (medium) — 관리 포트 무인증 노출: management.server.address가 비어 Spring이 actuator 커넥터를 모든 인터페이스에 바인딩했다. 동적 확인: ss가 *:9001, /actuator/health·info·prometheus=200 무인증(build 정보·disk 경로·API 표면 유출). compose의 127.0.0.1 publish는 Docker 호스트만 막는다. → observability.yml에 ${MANAGEMENT_SERVER_ADDRESS:127.0.0.1} loopback 기본. 버린 대안: 하드코딩(override 불가·env 관례 위반), compose/NetworkPolicy 의존(앱 밖에 posture 맡김 = 발견 원인).
  • BE-INPUT-002 (info) — admin reconcile @Valid 누락: 다른 핸들러와 달리 빠져, 미래 제약이 조용히 무시될 함정. → @Valid 추가 + 컨트롤러 전체 @RequestBody⟹@Valid 반사 시험.
  • BE-INPUT-001 (재분류: by-design): XML 매퍼가 CBOR의 coercion 잠금을 안 쓰는 것은 오탐이었다. XML은 textual이라 그 잠금을 쓰면 숫자/불리언 바인딩이 깨지고(기존 xmlRoundTrip 시험이 고정), 검증 우회도 아니다. 코드는 올바르며 의도를 주석으로만 못 박았다.

위험·영향

  • BE-CONFIG-001: 원격 프로메테우스 스크레이프 배포는 MANAGEMENT_SERVER_ADDRESS를 명시 설정하거나 loopback 사이드카로 긁는다. 노출 allowlist는 그대로.
  • 동작 변경은 관리 커넥터 bind 주소 하나뿐. BE-INPUT-002는 현재 무해(제약 없음), BE-INPUT-001은 주석만.

검증

desktop에서 세 수정 모두 RED→GREEN(또는 무회귀):

  • BE-CONFIG-001: :app-bootstrap:test GREEN rc=0, build-logic EnvContractVerifierTest rc=0, address 빼면 계약 시험 rc=1.
  • BE-INPUT-002: :adapter:inbound:web-fileserver:test GREEN rc=0, @Valid 빼면 rc=1.
  • BE-INPUT-001: :adapter:inbound:web-advanced:test --tests '*WebCodecMapperTest*' rc=0(무회귀).

리뷰어가 볼 곳

  • src/bootstrap/app/src/main/resources/config/observability.yml(address) + docs/registries/env-keys.yaml(MANAGEMENT_SERVER_ADDRESS) + ManagementActuatorSecurityContractTest(막는 시험).
  • docs/reviews/2026-11-11-redteam-security-review.md — 발견·기준표·소유자 결정 칸(BE-OBS-A 요청률 제한 기본 off).

관련 문서

  • design-docs template-program/README.md §4 W4. 공유 노트 w4-redteam*.md(도구 표·공격 표면·행렬).
> ⚠️ **t2b 재배치 PR(`claude/t2b-relayout-e435ee`)이 main에 병합된 뒤에 병합한다.** 이 PR은 그 브랜치 위에 쌓였다(base = t2b 브랜치). t2b가 병합되면 base를 main으로 바꾼다. ## 무엇을 왜 W4 red team(소유자 승인) Round 1에서 찾은 백엔드 발견을 고친다. 템플릿 보안 결함은 파생 서비스 전부로 복제되므로, 전부 **약한 기본값/일관성**을 닫는다. 전체 리뷰·기준표·방법은 `docs/reviews/2026-11-11-redteam-security-review.md`. ## 고른 방법과 버린 대안 - **BE-CONFIG-001 (medium) — 관리 포트 무인증 노출:** `management.server.address`가 비어 Spring이 actuator 커넥터를 모든 인터페이스에 바인딩했다. 동적 확인: `ss`가 `*:9001`, `/actuator/health·info·prometheus`=200 무인증(build 정보·disk 경로·API 표면 유출). compose의 `127.0.0.1` publish는 Docker 호스트만 막는다. → `observability.yml`에 `${MANAGEMENT_SERVER_ADDRESS:127.0.0.1}` loopback 기본. 버린 대안: 하드코딩(override 불가·env 관례 위반), compose/NetworkPolicy 의존(앱 밖에 posture 맡김 = 발견 원인). - **BE-INPUT-002 (info) — admin reconcile `@Valid` 누락:** 다른 핸들러와 달리 빠져, 미래 제약이 조용히 무시될 함정. → `@Valid` 추가 + 컨트롤러 전체 `@RequestBody⟹@Valid` 반사 시험. - **BE-INPUT-001 (재분류: by-design):** XML 매퍼가 CBOR의 coercion 잠금을 안 쓰는 것은 오탐이었다. XML은 textual이라 그 잠금을 쓰면 숫자/불리언 바인딩이 깨지고(기존 `xmlRoundTrip` 시험이 고정), 검증 우회도 아니다. 코드는 올바르며 의도를 주석으로만 못 박았다. ## 위험·영향 - BE-CONFIG-001: 원격 프로메테우스 스크레이프 배포는 `MANAGEMENT_SERVER_ADDRESS`를 명시 설정하거나 loopback 사이드카로 긁는다. 노출 allowlist는 그대로. - 동작 변경은 관리 커넥터 bind 주소 하나뿐. BE-INPUT-002는 현재 무해(제약 없음), BE-INPUT-001은 주석만. ## 검증 desktop에서 세 수정 모두 RED→GREEN(또는 무회귀): - BE-CONFIG-001: `:app-bootstrap:test` GREEN rc=0, build-logic `EnvContractVerifierTest` rc=0, address 빼면 계약 시험 rc=1. - BE-INPUT-002: `:adapter:inbound:web-fileserver:test` GREEN rc=0, `@Valid` 빼면 rc=1. - BE-INPUT-001: `:adapter:inbound:web-advanced:test --tests '*WebCodecMapperTest*'` rc=0(무회귀). ## 리뷰어가 볼 곳 - `src/bootstrap/app/src/main/resources/config/observability.yml`(address) + `docs/registries/env-keys.yaml`(MANAGEMENT_SERVER_ADDRESS) + `ManagementActuatorSecurityContractTest`(막는 시험). - `docs/reviews/2026-11-11-redteam-security-review.md` — 발견·기준표·소유자 결정 칸(BE-OBS-A 요청률 제한 기본 off). ## 관련 문서 - design-docs `template-program/README.md` §4 W4. 공유 노트 `w4-redteam*.md`(도구 표·공격 표면·행렬).
donghyeon.kang added 4 commits 2026-11-11 14:55:55 +00:00
`management.server.address`가 비어 있어 Spring이 관리 커넥터를 모든 인터페이스
(0.0.0.0)에 바인딩했다. 별도 포트는 별도 네트워크가 아니다. 그 포트의
health·prometheus·info는 permitAll이고 actuator 체인에 인증 메커니즘이 없어,
파드/호스트 네트워크의 누구에게나 무인증으로 응답한다.

동적으로 확인했다(bootRunH2): `ss`가 `*:9001`, `curl :9001/actuator/health·info·
prometheus`=200. info는 build group/artifact/version·capabilities를, prometheus는
disk 경로·free/total·JVM·timing을 유출한다(API 표면·인프라 토폴로지). compose의
`127.0.0.1:9001` publish는 Docker 호스트만 막고 같은 compose 네트워크의 형제
컨테이너나 NetworkPolicy 없는 k8s/bare 배포는 막지 못한다. 선행 리뷰(07-13)는
compose publish만 확인했고 앱의 bind 주소는 보지 않았다.

observability.yml에 `management.server.address: ${MANAGEMENT_SERVER_ADDRESS:
127.0.0.1}`를 둬서 posture가 compose·NetworkPolicy에 의존하지 않고 앱 자체에서
loopback으로 닫히게 한다. 원격 스크레이프 배포는 그 env를 명시하거나 loopback
사이드카로 긁는다. 노출 allowlist는 그대로다.

버린 대안:
- 하드코딩 `127.0.0.1` → operator override 불가, env-driven 관례 위반.
- compose/NetworkPolicy에만 의존 → 앱 밖 설정에 보안 posture를 맡김(이 발견의 원인).

검증: 막는 계약 시험 `actuator-contract:management-address-loopback`를 더했다.
desktop에서 RED→GREEN 확인 — address 줄을 빼면 그 시험이 실패(rc=1,
ManagementActuatorSecurityContractTest.java:239 AssertionError), 넣으면
`:app-bootstrap:test` rc=0. build-logic `EnvContractVerifierTest` rc=0(env-keys와
설정 정합).
web-fileserver admin 평면에서 orphans:reconcile만 @RequestBody에 @Valid가 없었다.
다른 다섯 핸들러(relocate·force-delete·submit-notification 등)는 모두 @Valid다.
지금은 OrphanReconcileHttpRequest에 Bean Validation 제약이 없어 드러나지 않지만,
나중에 limit에 @Min, reason에 @NotBlank를 더하면 @Valid가 없어 조용히 무시된다 —
이 템플릿이 평소 막는 검증 우회 부류다.

reconcileOrphans 파라미터에 @Valid를 더하고, 이 컨트롤러의 모든 @RequestBody가
@Valid를 갖는지 반사로 확인하는 막는 시험을 더해 admin 평면 전체에 규약을 고정한다.

검증: RED→GREEN — @Valid를 빼면 FileserverAdminControllerRequestBodyValidationTest
가 실패(rc=1, 그 파일 41행 AssertionError: offenders 비지 않음), 넣으면
:adapter:inbound:web-fileserver:test rc=0.
red team 리뷰가 WebXmlMapperFactory를 WebCborMapperFactory의 scalar-coercion
잠금(withCoercionConfig String->Fail, Textual Integer->Fail)을 빠뜨린 것으로 보고
표현별 엄격성 불일치를 의심했다. 실제로는 by-design이다: XML은 textual 포맷이라
숫자·불리언 DTO 필드도 전부 String 토큰(<count>5</count>)으로 들어온다. 거기서
String 입력을 막으면 모든 숫자/불리언 바인딩이 깨지고, WebCodecMapperTest의
xmlRoundTripPreservesWireTypes(int count를 바인딩)가 바로 그걸 고정한다. CBOR과의
엄격성 차이는 검증 우회가 아니다 — FAIL_ON_UNKNOWN_PROPERTIES와 SecureXmlInputFactory
하드닝은 여기에도 적용되고, @Valid 제약은 바인딩 뒤 모든 표현에 돈다.

순진한 "parity fix"가 멀쩡한 XML 바인딩을 깨뜨리지 않도록, 왜 CoercionConfig를
두지 않는지 주석으로 못 박는다(동작 변경 없음).

검증: :adapter:inbound:web-advanced:test --tests '*WebCodecMapperTest*' rc=0(무회귀).
docs(reviews): W4 red team 보안 리뷰와 발견 처리를 남긴다
pr / gradle (pull_request) Canceled after 0s
pr / vulnerabilities (pull_request) Canceled after 0s
pr / done (pull_request) Canceled after 0s
50bb0c36e3
공격 표면 목록·ASVS L2/API Top 10 행렬·정적/수동/동적 결과와 발견 3건
(BE-CONFIG-001 고침·BE-INPUT-002 고침·BE-INPUT-001 by-design 재분류)을
기록한다. 소유자 결정 칸에 BE-OBS-A(요청률 제한 기본 off)를 올린다.
donghyeon.kang added 1 commit 2026-11-11 15:20:36 +00:00
docs(security): 요청률 제한은 기본 off·ingress 책임임을 명시한다
pr / gradle (pull_request) Failing after 2m20s
pr / vulnerabilities (pull_request) Successful in 1m2s
pr / done (pull_request) Failing after 1s
85f1530cd4
W4 red team BE-OBS-A 소유자 결정(2026-11-12): 요청 빈도 제한은 앱 기본 off로 두고
ingress/gateway 책임으로 명시한다. 앱은 크기/양 bound는 이미 강제하고, 빠진 축은
요청 빈도 하나이며 그것은 앞단이 서비스 전체 기준으로 보는 게 맞다.

docs/security/rate-limiting.md에 자세(기본 off·ingress 책임)와 앞단에서 안 거는
배포를 위한 앱 내 redis limiter 켜는 법(모듈·env·client-ip 주의)을 적는다. 운영
매뉴얼(docs/work/operate.md 파생 서비스 절)과 PR 체크리스트(docs/manual/
11-checklist.md inbound)에서 가리켜, 파생 서비스가 릴리스 전에 "요청률을 어디서
거는가"를 정하게 한다.

동작/코드 변경 없음(문서만).
Author
Owner

새 main 위로 rebase해 PR #12로 다시 열었다(base = main). 이 PR은 닫는다.

새 main 위로 rebase해 PR #12로 다시 열었다(base = main). 이 PR은 닫는다.
donghyeon.kang closed this pull request 2026-11-11 16:17:14 +00:00

Pull request closed

Please reopen this pull request to perform a merge.
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: donghyeon.kang/clean-architecture-backend-template#11