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
pull from: claude/redteam-be-fixes
merge into: :claude/t2b-relayout-e435ee
:main
:fix/api-surface-silent-roots
:docs/ledger-fixed-by-49-50
:claude/be-main-red2-minio-2
:claude/be-main-red2-compose
:claude/be-main-red2-minio
:claude/r9-b-claim-tx
:claude/w2-be-ci-perf-4
:claude/r9-review-record
:claude/r9-c-tests-build
:claude/r9-c-docs-body
:claude/r9-c-contracts
:claude/r9-compose-ops
:claude/r9-public-surface
:claude/r9-stale-names
:claude/r9-tx-timeouts
:claude/r9-env-keys
:claude/r9-arch-rules
:claude/w2-be-ci-perf-2
:claude/w2-be-ci-perf-2-wip
:claude/redteam-be-fixes-main
:claude/w2-be-ci-perf-e89fe7
:claude/redteam-be-fixes
:claude/t2a-backend-ci-451e3b
:claude/x3-messaging-library-1aa3fa
:claude/x2-grpc-library-43dd09
:claude/h3-backend-harness-34fc23
:claude/v1-vuln-fix-e089b9
:claude/i2-docs-merge-02df15
:claude/d2c-ops-docs-1-c22c9f
:claude/d2a-entry-docs-12a342
:claude/d2b-src-adr-d46d23
:claude/d2d-ops-docs-2-e40938
:claude/i1-layout-docs-merge-217f1e
:refactor/maturity-review-2026-11
:claude/t1-backend-layout-46973e
:claude/d1-docs-system-fd4a0f
:claude/integration-r9-f1bc5c
:claude/r9-g1-inbound-456713
:claude/r9-g3-migration-7ce36d
:claude/r9-g2-stomp-interceptor-f5675d
:claude/r9-g4-idempotency-c669be
:claude/manual-gap-fix-2-9b0fe2
:claude/r8-review-a-3851a7
:claude/integration-r8-a4196a
:claude/r8-f1-transport-errors-b21ebf
:claude/r8-f5-small-fixes-f40412
:claude/r8-f3-persistence-9e8157
:claude/r8-f2-arch-rules-60140e
:claude/r8-f4-idempotency-3a6a0f
:claude/manual-gap-fix-1-824a41
:claude/t4-2-manual-history-ids-9ac57c
:claude/t1-r10-review-d0ecc6
:claude/integration-r7
:claude/t5-idempotency-operation-id-9bd973
:claude/t3-error-codes-loglevel-fcf427
:claude/t1-baseline-7d623a
:claude/t2-circuit-breaker-2ff8df
:claude/t4-manual-history-ids-51889f
:claude/b3-docs-work-34a1dd
:claude/perf-assertions-fail-closed-c09414
:claude/improvement-manual-6ae516
:refactor/review-followup
No Reviewers
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
donghyeon.kang (동현 강)
Clear assignees
No Assignees
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: donghyeon.kang/clean-architecture-backend-template#11
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
무엇을 왜
W4 red team(소유자 승인) Round 1에서 찾은 백엔드 발견을 고친다. 템플릿 보안 결함은 파생 서비스 전부로 복제되므로, 전부 약한 기본값/일관성을 닫는다. 전체 리뷰·기준표·방법은
docs/reviews/2026-11-11-redteam-security-review.md.고른 방법과 버린 대안
management.server.address가 비어 Spring이 actuator 커넥터를 모든 인터페이스에 바인딩했다. 동적 확인:ss가*:9001,/actuator/health·info·prometheus=200 무인증(build 정보·disk 경로·API 표면 유출). compose의127.0.0.1publish는 Docker 호스트만 막는다. →observability.yml에${MANAGEMENT_SERVER_ADDRESS:127.0.0.1}loopback 기본. 버린 대안: 하드코딩(override 불가·env 관례 위반), compose/NetworkPolicy 의존(앱 밖에 posture 맡김 = 발견 원인).@Valid누락: 다른 핸들러와 달리 빠져, 미래 제약이 조용히 무시될 함정. →@Valid추가 + 컨트롤러 전체@RequestBody⟹@Valid반사 시험.xmlRoundTrip시험이 고정), 검증 우회도 아니다. 코드는 올바르며 의도를 주석으로만 못 박았다.위험·영향
MANAGEMENT_SERVER_ADDRESS를 명시 설정하거나 loopback 사이드카로 긁는다. 노출 allowlist는 그대로.검증
desktop에서 세 수정 모두 RED→GREEN(또는 무회귀):
:app-bootstrap:testGREEN rc=0, build-logicEnvContractVerifierTestrc=0, address 빼면 계약 시험 rc=1.:adapter:inbound:web-fileserver:testGREEN rc=0,@Valid빼면 rc=1.: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).관련 문서
template-program/README.md§4 W4. 공유 노트w4-redteam*.md(도구 표·공격 표면·행렬).`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와 설정 정합).새 main 위로 rebase해 PR #12로 다시 열었다(base = main). 이 PR은 닫는다.
Pull request closed