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
: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
5
Commits
| Author | SHA1 | Message | Date | |
|---|---|---|---|---|
|
|
85f1530cd4 |
docs(security): 요청률 제한은 기본 off·ingress 책임임을 명시한다
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)에서 가리켜, 파생 서비스가 릴리스 전에 "요청률을 어디서 거는가"를 정하게 한다. 동작/코드 변경 없음(문서만). |
||
|
|
50bb0c36e3 |
docs(reviews): W4 red team 보안 리뷰와 발견 처리를 남긴다
공격 표면 목록·ASVS L2/API Top 10 행렬·정적/수동/동적 결과와 발견 3건 (BE-CONFIG-001 고침·BE-INPUT-002 고침·BE-INPUT-001 by-design 재분류)을 기록한다. 소유자 결정 칸에 BE-OBS-A(요청률 제한 기본 off)를 올린다. |
||
|
|
3bb9f52f08 |
docs(web-advanced): XML 매퍼가 CBOR의 coercion 잠금을 안 쓰는 이유를 적는다
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(무회귀). |
||
|
|
3ecddad05e |
fix(fileserver): admin reconcile의 @RequestBody에 @Valid를 더한다
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. |
||
|
|
ad3d00c8c1 |
fix(actuator): 관리 포트를 loopback에 고정해 무인증 노출을 막는다
`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와
설정 정합).
|