t2b 재배치 PR #10이 main에 병합돼(841a176f), 이 변경을 새 main 위로 rebase하고 base를 main으로 열었다. 이전 PR #11(base = t2b 브랜치)은 닫는다.
무엇을 왜
W4 red team(소유자 승인) 발견을 고친다. 템플릿 보안 결함은 파생 서비스로 복제되므로 약한 기본값/일관성을 닫는다. 전체 리뷰·기준표·방법은 docs/reviews/2026-11-11-redteam-security-review.md.
고친 것
BE-CONFIG-001 (medium) — 관리 포트 무인증 노출:management.server.address가 비어 actuator 커넥터가 모든 인터페이스에 바인딩됐다. 동적: ss*:9001, /actuator/health·info·prometheus=200 무인증(build 정보·disk 경로·API 표면 유출). → observability.yml에 ${MANAGEMENT_SERVER_ADDRESS:127.0.0.1} loopback 기본. 수정 뒤 동적 재확인: ss127.0.0.1:9001.
BE-INPUT-002 (info) — admin reconcile @Valid 누락: 미래 제약이 조용히 무시될 함정. → @Valid + 컨트롤러 전체 @RequestBody⟹@Valid 반사 시험.
BE-INPUT-001 (by-design): XML 매퍼가 CBOR coercion 잠금을 안 쓰는 것은 오탐(XML은 textual, 쓰면 숫자 바인딩 깨짐, 기존 시험이 고정). 주석만.
BE-OBS-A 문서: 요청률 제한 기본 off·ingress 책임을 docs/security/rate-limiting.md에 명시, 운영 매뉴얼·체크리스트에서 가리킴.
위험·영향
관리 커넥터 bind 주소 하나만 동작 변경. 원격 스크레이프는 MANAGEMENT_SERVER_ADDRESS 명시. BE-INPUT-002는 현재 무해, BE-INPUT-001은 주석만.
검증
세 수정 모두 RED→GREEN(또는 무회귀): :app-bootstrap:test(ManagementActuatorSecurityContractTest) + build-logic EnvContractVerifierTest, :adapter:inbound:web-fileserver:test(RequestBodyValidationTest), :adapter:inbound:web-advanced:test(WebCodecMapperTest). 새 main 위 rebase 뒤 desktop에서 바뀐 모듈 시험 재실행 + runner pr / done 초록.
docs/reviews/2026-11-11-redteam-security-review.md — 발견·기준표·소유자 결정 칸(BE-OBS-A).
> t2b 재배치 PR #10이 main에 병합돼(841a176f), 이 변경을 새 main 위로 rebase하고 base를 main으로 열었다. 이전 PR #11(base = t2b 브랜치)은 닫는다.
## 무엇을 왜
W4 red team(소유자 승인) 발견을 고친다. 템플릿 보안 결함은 파생 서비스로 복제되므로 **약한 기본값/일관성**을 닫는다. 전체 리뷰·기준표·방법은 `docs/reviews/2026-11-11-redteam-security-review.md`.
## 고친 것
- **BE-CONFIG-001 (medium) — 관리 포트 무인증 노출:** `management.server.address`가 비어 actuator 커넥터가 모든 인터페이스에 바인딩됐다. 동적: `ss` `*:9001`, `/actuator/health·info·prometheus`=200 무인증(build 정보·disk 경로·API 표면 유출). → `observability.yml`에 `${MANAGEMENT_SERVER_ADDRESS:127.0.0.1}` loopback 기본. 수정 뒤 동적 재확인: `ss` `127.0.0.1:9001`.
- **BE-INPUT-002 (info) — admin reconcile `@Valid` 누락:** 미래 제약이 조용히 무시될 함정. → `@Valid` + 컨트롤러 전체 `@RequestBody⟹@Valid` 반사 시험.
- **BE-INPUT-001 (by-design):** XML 매퍼가 CBOR coercion 잠금을 안 쓰는 것은 오탐(XML은 textual, 쓰면 숫자 바인딩 깨짐, 기존 시험이 고정). 주석만.
- **BE-OBS-A 문서:** 요청률 제한 기본 off·ingress 책임을 `docs/security/rate-limiting.md`에 명시, 운영 매뉴얼·체크리스트에서 가리킴.
## 위험·영향
관리 커넥터 bind 주소 하나만 동작 변경. 원격 스크레이프는 `MANAGEMENT_SERVER_ADDRESS` 명시. BE-INPUT-002는 현재 무해, BE-INPUT-001은 주석만.
## 검증
세 수정 모두 RED→GREEN(또는 무회귀): `:app-bootstrap:test`(ManagementActuatorSecurityContractTest) + build-logic `EnvContractVerifierTest`, `:adapter:inbound:web-fileserver:test`(RequestBodyValidationTest), `:adapter:inbound:web-advanced:test`(WebCodecMapperTest). 새 main 위 rebase 뒤 desktop에서 바뀐 모듈 시험 재실행 + runner `pr / done` 초록.
## 리뷰어가 볼 곳
- `observability.yml`(address) + `docs/registries/env-keys.yaml`(MANAGEMENT_SERVER_ADDRESS) + `ManagementActuatorSecurityContractTest`(막는 시험).
- `docs/reviews/2026-11-11-redteam-security-review.md` — 발견·기준표·소유자 결정 칸(BE-OBS-A).
`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(무회귀).
공격 표면 목록·ASVS L2/API Top 10 행렬·정적/수동/동적 결과와 발견 3건
(BE-CONFIG-001 고침·BE-INPUT-002 고침·BE-INPUT-001 by-design 재분류)을
기록한다. 소유자 결정 칸에 BE-OBS-A(요청률 제한 기본 off)를 올린다.
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)에서 가리켜, 파생 서비스가 릴리스 전에 "요청률을 어디서
거는가"를 정하게 한다.
동작/코드 변경 없음(문서만).
PR #12의 액추에이터·fileserver·web-advanced 수정 커밋이 긴 주석과
assertion 메시지에 포맷 드리프트를 남겨, runner pr / gradle의
:app-bootstrap:spotlessJavaCheck가 깨졌다. 모듈 시험만 돌리고 포맷
게이트(spotlessCheck)를 건너뛴 탓이다.
./gradlew spotlessApply로 바뀐 3개 파일만 재포맷했다. 이미 push된
커밋이라 force push 금지 → squash 대신 새 커밋으로 올린다.
위험·한계: 포맷만 바뀐다(긴 줄의 줄바꿈). 동작·의미 변화 없음.
검증: spotlessCheck rc=0. 바뀐 3개 모듈 시험 재실행 —
ManagementActuatorSecurityContractTest·FileserverAdminControllerRequestBodyValidationTest·WebCodecMapperTest
BUILD SUCCESSFUL (1m8s).
env-keys.yaml에서 MANAGEMENT_SERVER_ADDRESS를 MANAGEMENT_SERVER_PORT 항목
중간에 끼워 넣어, PORT의 compatibility_impact와 required_test
(actuator-contract:management-port-separated) 두 줄이 ADDRESS로 넘어갔다.
PORT는 두 칸을 잃어 스키마상 불완전해졌고, ADDRESS의 required_test는 제
시험이 아니라 포트 분리 시험을 가리켰다.
PORT에 두 줄을 되돌리고, ADDRESS의 required_test를
actuator-contract:management-address-loopback로 바꾼다. 이 id는
ManagementActuatorSecurityContractTest의 loopback 기본값 시험 마커로 이미
존재한다(실제 시험을 가리킨다). validation: host_or_ip_address는 env-keys의
자유 서술 규약에 맞는 신규 서술자다(닫힌 집합 강제 없음).
위험·한계: 데이터 수정만. 동작 변화 없음.
검증(desktop): :app-bootstrap:verifyEnvKeys rc=0,
documentContractTest(ContractRegistrySchemaGovernanceTest) rc=0.
ContractRegistrySchemaGovernanceTest(모든 레지스트리 행에 legal
compatibility_impact + non-blank required_test 강제)는 @Tag(document-contract)
라 main 스테이지에서만 돈다. PR 레인은 repository-contract이고 그 입력에
docs/**가 빠져 있어, 잘못된 env-keys가 prCheck를 통과하고 병합 뒤 mainCheck
에서야 깨졌다(BE-CONFIG-001이 그렇게 새어 나갔다). 또 필드가 아예 빠지면
Set.of(...).contains(null)이 NPE를 던져 어느 행이 문제인지 알 수 없었다.
- RegistrySchemaPullRequestGateTest(@Tag repository-contract): 같은
RegistryGovernanceCatalog.validate를 PR 레인에서 돌려 위반이 병합 전에
막히게 한다.
- app build.gradle repositoryContractInputs에 docs/registries/**를 더해
레지스트리가 바뀌면 PR 레인이 재실행된다.
- RegistryGovernanceCatalog: compatibility_impact가 null이면 "... must be one
of [...], but was null"로 또렷이 실패한다(NPE 대신). 누락-필드 음성 사례를
ContractRegistrySchemaGovernanceTest에 더했다.
- ManagementActuatorSecurityContractTest javadoc에
actuator-contract:management-address-loopback 항목을 더해 열거를 맞춘다.
버린 대안: required_test가 실제 시험을 가리키는지 범용 강제는 안 넣었다 —
env-keys의 distinct required_test 193개 중 테스트 소스에 literal로 있는 건
7개뿐이라(나머지는 문서적 식별자), 범용 강제는 기존 186행을 깨뜨린다.
위험·한계: PR 레인이 docs/registries 변경에도 재실행된다(의도).
검증(desktop, 고친 env-keys): spotlessCheck·verifyEnvKeys·build-logic test·
documentContractTest·repositoryContractTest(새 게이트)·
ManagementActuatorSecurityContractTest·web-fileserver·web-advanced 모두 rc=0.
RED 재현: 고치기 전 새 게이트가 "env-keys.yaml row MANAGEMENT_SERVER_PORT
compatibility_impact must be one of [...], but was null"로 실패.
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(소유자 승인) 발견을 고친다. 템플릿 보안 결함은 파생 서비스로 복제되므로 약한 기본값/일관성을 닫는다. 전체 리뷰·기준표·방법은
docs/reviews/2026-11-11-redteam-security-review.md.고친 것
management.server.address가 비어 actuator 커넥터가 모든 인터페이스에 바인딩됐다. 동적:ss*:9001,/actuator/health·info·prometheus=200 무인증(build 정보·disk 경로·API 표면 유출). →observability.yml에${MANAGEMENT_SERVER_ADDRESS:127.0.0.1}loopback 기본. 수정 뒤 동적 재확인:ss127.0.0.1:9001.@Valid누락: 미래 제약이 조용히 무시될 함정. →@Valid+ 컨트롤러 전체@RequestBody⟹@Valid반사 시험.docs/security/rate-limiting.md에 명시, 운영 매뉴얼·체크리스트에서 가리킴.위험·영향
관리 커넥터 bind 주소 하나만 동작 변경. 원격 스크레이프는
MANAGEMENT_SERVER_ADDRESS명시. BE-INPUT-002는 현재 무해, BE-INPUT-001은 주석만.검증
세 수정 모두 RED→GREEN(또는 무회귀):
:app-bootstrap:test(ManagementActuatorSecurityContractTest) + build-logicEnvContractVerifierTest,:adapter:inbound:web-fileserver:test(RequestBodyValidationTest),:adapter:inbound:web-advanced:test(WebCodecMapperTest). 새 main 위 rebase 뒤 desktop에서 바뀐 모듈 시험 재실행 + runnerpr / done초록.리뷰어가 볼 곳
observability.yml(address) +docs/registries/env-keys.yaml(MANAGEMENT_SERVER_ADDRESS) +ManagementActuatorSecurityContractTest(막는 시험).docs/reviews/2026-11-11-redteam-security-review.md— 발견·기준표·소유자 결정 칸(BE-OBS-A).`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와 설정 정합).27a18b4f, #14 전문가 스킬·docs·scripts/tests) into PR #12 브랜치e7be517e, #13 NegotiatedProtocol flake 고침 등) into PR #12 브랜치