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

공격 표면 목록·ASVS L2/API Top 10 행렬·정적/수동/동적 결과와 발견 3건
(BE-CONFIG-001 고침·BE-INPUT-002 고침·BE-INPUT-001 by-design 재분류)을
기록한다. 소유자 결정 칸에 BE-OBS-A(요청률 제한 기본 off)를 올린다.
This commit is contained in:
DongHyeonka
2026-11-11 23:55:19 +09:00
parent 3bb9f52f08
commit 50bb0c36e3
@@ -0,0 +1,41 @@
# 백엔드 템플릿 red team 보안 리뷰 (2026-11-11)
- 범위·승인: 소유자 승인(W4) 아래 desktop에 띄운 이 템플릿과 그 의존 컨테이너만 공격. 운영·Gitea·남의 서비스는 대상 아님. DoS 없음.
- 방법(반복 캠페인): 공격 표면 목록(전 capability) → OWASP API Security Top 10(2023)·Top 10(2021)·ASVS L2 × 진입점 행렬 → 정적(gitleaks·semgrep·trivy·checkov)·수동 코드 추적(inbound→sink)·동적(bootRunH2 + ss + actuator curl + ZAP baseline + nuclei) → 발견 → 막는 시험(RED→GREEN).
- 대상 커밋: main `66eaa982`(공격), 수정은 `claude/t2b-relayout-e435ee` 위.
## 요약
열린 발견 0. 두 매퍼·역직렬화·주입·SSRF·경로 traversal·JWT·GraphQL·헤더·CORS·에러 노출은 모두 단단함을 확인(정적 checkov 0·trivy HIGH/CRIT 0, 동적 ZAP 실제 경보 0·nuclei 0). 템플릿은 이미 여러 보안 리뷰를 거쳐 견고하며, 아래 발견은 **파생 서비스가 물려받는 약한 기본값/일관성** 중심이다.
| id | 심각도 | 분야 | 상태 |
|---|---|---|---|
| BE-CONFIG-001 | medium | config | **고침** |
| BE-INPUT-002 | info | input | **고침** |
| BE-INPUT-001 | info(재분류) | input | by-design(오탐) — 문서화 |
## 발견
### BE-CONFIG-001 (medium) — 관리 포트가 모든 인터페이스 바인딩 → actuator 무인증 노출
- **위치:** `src/bootstrap/app/src/main/resources/config/observability.yml`(관리 커넥터), `.../management/security/ManagementSecurityConfig.java`(health/info/prometheus permitAll).
- **재현:** `management.server.address` 미설정 → Spring이 관리 커넥터를 모든 인터페이스에 바인딩. 동적 확인(bootRunH2): `ss -tlnp`가 `*:9001`, `curl :9001/actuator/health·info·prometheus`=200 무인증(env·heapdump·beans=401). compose의 `127.0.0.1:9001` publish는 Docker 호스트만 막고, 같은 compose 네트워크 형제 컨테이너·NetworkPolicy 없는 k8s/bare는 못 막는다.
- **영향:** 컨테이너/파드 네트워크의 누구에게나 무인증 정보 노출. info가 build group/artifact/version·capabilities, prometheus가 disk 경로·free/total·JVM·http.server.requests uri 태그(API 표면 열거)를 유출. 쓰기/침해 경로는 없어 medium.
- **고침:** `management.server.address: ${MANAGEMENT_SERVER_ADDRESS:127.0.0.1}`로 loopback 기본. 원격 스크레이프는 명시 opt-in. env-keys 등록 + 막는 계약 시험 `actuator-contract:management-address-loopback`(RED: address 빼면 실패, GREEN: 통과). 커밋 `ad3d00c8`.
### BE-INPUT-002 (info) — admin reconcile의 @RequestBody에 @Valid 누락
- **위치:** `src/adapter/inbound/web-fileserver/.../admin/FileserverAdminController.java` `reconcileOrphans`.
- **재현/영향:** 다른 다섯 핸들러와 달리 @Valid 없음. 현재 OrphanReconcileHttpRequest에 제약이 없어 무해하나, 나중에 제약을 더하면 조용히 무시되는 잠재 함정(검증 우회 부류). admin 평면·/internal·게이트됨.
- **고침:** @Valid 추가 + 이 컨트롤러의 모든 @RequestBody가 @Valid를 갖는지 반사 막는 시험. RED→GREEN 확인. 커밋 `3ecddad0`.
### BE-INPUT-001 (재분류: by-design, 오탐)
- 초기 의심: XML 매퍼가 CBOR 매퍼의 scalar-coercion 잠금을 빠뜨려 표현별 엄격성 불일치.
- **검증 결과 오탐:** XML은 textual 포맷이라 숫자·불리언 필드도 String 토큰(`<count>5</count>`)으로 들어온다. CBOR의 `String→Fail` 잠금을 XML에 쓰면 모든 숫자/불리언 바인딩이 깨지며, 기존 시험 `WebCodecMapperTest.xmlRoundTripPreservesWireTypes`(int count 바인딩)가 그걸 고정해 순진한 fix는 이미 막혀 있다. @Valid 제약이 바인딩 뒤 모든 표현에 돌고 FAIL_ON_UNKNOWN_PROPERTIES·SecureXmlInputFactory도 적용되므로 검증 우회가 아니다.
- **처리:** 코드는 올바르다. 왜 CoercionConfig를 두지 않는지 주석으로 못 박아 미래의 잘못된 "parity fix"를 막음(커밋 `3bb9f52f`). 취약점 아님.
## 소유자 결정 칸
- **BE-OBS-A (API4 Unrestricted Resource Consumption):** 요청률 제한(`APP_RATE_LIMIT_ENABLED`)이 기본 OFF다. 구조적 bound(업로드/다운로드/메시지/GraphQL complexity/연결/deadline)는 많으나 요청 **빈도** 제한은 배포(ingress)에 의존한다. 결정: (a) 템플릿 기본을 안전하게(fail-closed redis provider 켬) 둘지, (b) "ingress/gateway에서 rate-limit 필수"를 운영 문서·게이트로 강제할지. red team 권장: 요청률은 ingress 책임이 맞으나, 그 요구를 운영 매뉴얼에 명시하고 릴리스 체크에 넣기를 권한다.
## 기준표 커버리지
OWASP API Top 10(2023)·Top 10(2021)·ASVS L2 핵심 장 × 진입점 행렬을 채웠다(방법/근거/결과). BE-CONFIG-001(API8/A05/V14) 외 전 항목 PASS. 동적 "전 capability"(graphql/grpc/websocket/fileserver 켠 조합)·schemathesis·역할별 인가 행렬은 Round 2에서 채운다(별도 기록).
## 회귀
세 수정 모두 막는 시험을 더했고 desktop에서 RED→GREEN·무회귀를 확인했다. red team 장치(plugins/redteam)를 다시 돌려 같은 발견이 다시 나오지 않음을 릴리스 전 확인한다.