From 3b71a3ca32e558ddad3c0a0081ee66b05c37ed54 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Fri, 13 Nov 2026 08:32:49 +0900 Subject: [PATCH] =?UTF-8?q?docs(security):=20=EA=B3=B5=EA=B0=9C=20?= =?UTF-8?q?=EA=B2=BD=EB=A1=9C=20=EC=8A=A4=EB=83=85=EC=88=8F=20=EA=B2=80?= =?UTF-8?q?=EC=82=AC=EC=9D=98=20=EC=84=A4=EB=AA=85=EC=9D=84=20=EB=84=93?= =?UTF-8?q?=EC=96=B4=EC=A7=84=20=EB=B2=94=EC=9C=84=EC=97=90=20=EB=A7=9E?= =?UTF-8?q?=EC=B6=98=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 공개 경로 스냅숏은 이제 기본 공개 경로만이 아니라 profile 덮어쓰기와 운영 코드 filter chain의 `permitAll`·`securityMatcher` 문장까지 고정한다 (`docs/security/public-paths-snapshot.txt`). 그런데 그 검사를 설명하는 세 곳은 아직 「기본 공개 경로」만 본다고 적는다. - gates.md 2절 `verifyPublicPathSnapshot` 행 - 루트 build.gradle `verifyPublicPathSnapshot` 태스크 description - app-bootstrap build.gradle `publicPathSnapshotTest` 레인 description 세 곳 모두 지금 범위(기본값, profile 덮어쓰기, filter chain 문장)로 고친다. 동작 변경 없음. 검증: scripts/verify.sh docs(노트북) rc=0. 이 문구를 고정하는 시험은 없다 (git grep 'shipped public path default' -- '*.java': 0건). Refs: round9 확인 리뷰(r9-be가 넘긴 Low, 공개 경로 범위 확장 뒤) --- build.gradle | 2 +- docs/work/reference/gates.md | 2 +- src/bootstrap/app/build.gradle | 2 +- 3 files changed, 3 insertions(+), 3 deletions(-) diff --git a/build.gradle b/build.gradle index c9cfd47e..4c5ba61a 100644 --- a/build.gradle +++ b/build.gradle @@ -275,7 +275,7 @@ strictLaneStages { // `-PapprovePublicPathChange` rewrites the baseline after review. tasks.register('verifyPublicPathSnapshot') { group = 'verification' - description = 'Fails when the shipped public path default drifts from docs/security/public-paths-snapshot.txt.' + description = 'Fails when the public path surface (default, profile overrides, filter-chain permitAll and securityMatcher statements) drifts from docs/security/public-paths-snapshot.txt.' dependsOn ':app-bootstrap:publicPathSnapshotTest' } diff --git a/docs/work/reference/gates.md b/docs/work/reference/gates.md index 2c0b5809..f6757859 100644 --- a/docs/work/reference/gates.md +++ b/docs/work/reference/gates.md @@ -45,7 +45,7 @@ workflow에만 있는 job: `pr.yml` `done`의 마지막 step과 `main.yml`의 `v | `performanceCheck` | 선언된 performance lane 전체(부하·종료·풀·자원 한계, 실 서버와 컨테이너). 상한을 매번 단언한다. 손으로 돌리든 workflow든 같은 상한이다 | nightly(다른 무거운 job 뒤: 파일 맨 끝 job이고 runner 하나가 job을 만든 순서대로 돈다. `needs`는 쓰지 않는다 — Gitea 1.27이 `needs`와 `if`를 함께 가진 job을 Blocked에 둔다) | `main.yml` `performance`. 5절 | | `releaseCheck` | 릴리스 provenance + 공개 경로 스냅숏. 커밋을 `GITHUB_SHA`·`GIT_SHA`·`-PgitRevision=`로 받고, 없으면 설계대로 실패한다 | 태그 | `release.yml` `release` | | `:app-bootstrap:verifyEnvKeys` | env 키 레지스트리와 profile YAML·`.env.example` | `mainCheck` 안(`configContractCheck`) | build-logic `ca.config-contract` | -| `verifyPublicPathSnapshot` | 기본 공개 경로가 `docs/security/public-paths-snapshot.txt`와 같은가 | `mainCheck`·`releaseCheck` 안 | `build.gradle` | +| `verifyPublicPathSnapshot` | 공개 경로 표면(기본값, profile 덮어쓰기, 운영 코드 filter chain의 `permitAll`·`securityMatcher` 문장)이 `docs/security/public-paths-snapshot.txt`와 같은가 | `mainCheck`·`releaseCheck` 안 | `build.gradle` | | `verifyDependencyLocks` | lockfile | PR(`prCheck` 안) | `build.gradle` | | `:app-bootstrap:documentContractTest` | 문서와 코드를 대조하는 lane(태그 `document-contract`) | main(`mainCheck` 안) | `src/bootstrap/app/build.gradle` | | `:app-bootstrap:repositoryContractTest` | 빌드 스크립트·workflow·compose를 읽는 계약(태그 `repository-contract`) | PR | `src/bootstrap/app/build.gradle` | diff --git a/src/bootstrap/app/build.gradle b/src/bootstrap/app/build.gradle index 4dd98ec8..3a451cea 100644 --- a/src/bootstrap/app/build.gradle +++ b/src/bootstrap/app/build.gradle @@ -452,7 +452,7 @@ springBoot { strictTestLanes { lane('publicPathSnapshotTest') { tag = 'public-path-snapshot' - description = 'Compares the shipped public path default with the reviewed baseline.' + description = 'Compares the public path surface (default, profile overrides, filter-chain permit statements) with the reviewed baseline.' rejectSkipped = true mainStage() systemProperty 'publicpath.snapshot.write', project.hasProperty('approvePublicPathChange') ? 'true' : 'false'