Files
clean-architecture-backend-…/docs/security/public-paths-snapshot.txt
DongHyeonka fb7ca13b60
pr / done (pull_request) Successful in 3m28s
fix(build)!: 공개 경로 스냅숏 비교 lane이 기준선을 다시 쓰지 않는다
문제: :app-bootstrap:publicPathSnapshotTest(루트 verifyPublicPathSnapshot)는
빌드에 approvePublicPathChange가 있으면 publicpath.snapshot.write=true를
시험에 주었고, 시험은 기준선을 먼저 쓴 뒤 그 파일과 비교해 늘 통과했다.
project.hasProperty는 -P뿐 아니라 gradle.properties(저장소·GRADLE_USER_HOME),
ORG_GRADLE_PROJECT_ 환경 변수, GRADLE_OPTS의 -Dorg.gradle.project.에서도
참이라, 한 줄로 보안 기준선 게이트가 말없이 꺼졌다.

고른 방법: API surface 태스크와 같은 모양으로 나눈다. 비교 lane은 쓰기
스위치를 false로 고정하고, 실행 전(doFirst)에 셋 중 하나면 「read-only」로
실패한다. (1) 빌드에 승인 속성이 있다. (2) 시험 JVM이 받을
publicpath.snapshot.write가 false가 아니다. (3) 상속한 JAVA_TOOL_OPTIONS·
JDK_JAVA_OPTIONS·_JAVA_OPTIONS에 그 스위치가 있다. 고정값은 앞의 두
변수를 이긴다(JVM이 Gradle의 -D보다 먼저 읽는다). _JAVA_OPTIONS는 뒤에
읽혀 고정값을 이기므로(기준 main에서도 같은 빈틈) (3)이 막는다. main
단계 lane이라 up-to-date·캐시가 없어 mainCheck·releaseCheck마다 검사가
돈다. 쓰기는 새 Test 태스크 :app-bootstrap:publicPathSnapshotUpdate(루트
별칭 updatePublicPathSnapshot)가 같은 tag 시험을 쓰기 스위치를 켜고
돌린다. 승인 속성이 없으면 쓰기 전에 실패하고, 어떤 단계에도 들지
않으며, 매번 다시 돈다.

버린 대안: 쓴 뒤 「기준선을 다시 썼다, 커밋하라」로 실패시키기 — 한 lane
안에서 통과·실패의 뜻이 갈려 lane 결과 판정과 섞인다. update를
explicitOnly strict lane으로 두기 — TEST lane은 캐시되어 쓰기를 건너뛸 수
있고 집계 태스크마다 안내가 찍힌다.

위험·한계: 승인 명령이 verifyPublicPathSnapshot -P…에서
updatePublicPathSnapshot -P…로 바뀐다. 승인 속성을 상시로 둔 파생 서비스는
mainCheck·releaseCheck가 실패한다(docs/upgrade/2026-11-round9-public-surface.md
5행). 기준선 머리 주석의 명령 한 줄만 바뀌고 경로 내용은 그대로다.
갱신 명령을 적은 곳(docs/build.md, be-security 스킬, 제거 표
docs/capability-status.md·build-logic/README.md)도 함께 고친다.

검증: desktop 공유 잠금 아래 detached worktree, --no-build-cache.
변이 = gradle.properties의 approvePublicPathChange=true + SecurityConfig의
requestMatchers("/v1/admin/**").permitAll() 한 줄.
- RED(기준 96c0b4c7): 변이에서 verifyPublicPathSnapshot rc=0, 기준선에
  permitAll 줄이 덧붙었다. permitAll + _JAVA_OPTIONS로 쓰기 스위치를 준
  것도 rc=0(JAVA_TOOL_OPTIONS·JDK_JAVA_OPTIONS는 rc=1).
- GREEN(이 커밋 트리 3958ac3e):
  - 변이 없음 verifyPublicPathSnapshot rc=0.
  - 변이, -P, ORG_GRADLE_PROJECT_ 각각 rc=1 「is read-only」.
  - permitAll + 세 JVM 옵션 변수 각각 rc=1 「is read-only」.
  - 빌드 스크립트가 쓰기 스위치를 true로 덮으면 rc=1 「is read-only」.
  - permitAll만 rc=1 「surface changed」.
  - 승인 없는 updatePublicPathSnapshot rc=1, 기준선 그대로.
  - updatePublicPathSnapshot -PapprovePublicPathChange rc=0, 새 줄이
    들어가고 이어서 verifyPublicPathSnapshot rc=0.
  - scripts/ci/verify-configuration-cache.sh rc=0.
- scripts/verify.sh(트리 3958ac3e, 「HEAD 트리와 같음」): desktop leaf
  :app-bootstrap --no-cache rc=0(tests=330 failures=0), desktop pr
  --no-cache rc=0(tests=7329 failures=0), 노트북 docs rc=0.

BREAKING CHANGE: 공개 경로 스냅숏 갱신은 ./gradlew updatePublicPathSnapshot
-PapprovePublicPathChange다. verifyPublicPathSnapshot·mainCheck·releaseCheck는
approvePublicPathChange가 어디서든 켜져 있으면 실패한다.

Refs: REV-BE-0011
2026-11-21 15:56:02 +09:00

16 lines
1.7 KiB
Plaintext

# feature-security-operational-baseline D5 — deny-by-default public path snapshot.
# SSOT: app.security.public-paths default in src/bootstrap/app/src/main/resources/config/security.yml
# -> SecurityConfig permitAll(); anyRequest authenticated. An operator's own SECURITY_PUBLIC_PATHS
# overrides it at run time and is outside this snapshot.
# Update only after review with: ./gradlew updatePublicPathSnapshot -PapprovePublicPathChange
/v1/healthcheck
# Profile overrides of app.security.public-paths
profile local: /api/healthcheck
# Filter-chain statements that permit requests without authentication
src/adapter/inbound/web-notification/src/main/java/dev/caskeleton/adapter/inbound/web/notification/platform/callback/CallbackMvcSecurityConfiguration.java: .authorizeHttpRequests(requests -> requests.anyRequest().permitAll())
src/adapter/inbound/web-notification/src/main/java/dev/caskeleton/adapter/inbound/web/notification/platform/callback/CallbackMvcSecurityConfiguration.java: return http.securityMatcher("/internal/notification/callbacks/**")
src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/auth/SecurityConfig.java: auth.dispatcherTypeMatchers(DispatcherType.ERROR).permitAll();
src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/auth/SecurityConfig.java: auth.requestMatchers(publicPaths).permitAll();
src/bootstrap/service-runtime/src/main/java/dev/caskeleton/composition/runtime/management/security/ManagementSecurityConfig.java: .requestMatchers(EndpointRequest.to("health", "info", "prometheus")) .permitAll()
src/bootstrap/service-runtime/src/main/java/dev/caskeleton/composition/runtime/management/security/ManagementSecurityConfig.java: http.securityMatcher(EndpointRequest.toAnyEndpoint())