fix(security)!: 공개 경로 스냅숏이 profile 덮어쓰기와 모듈 chain의 permitAll까지 고정한다 #23

Closed
donghyeon.kang wants to merge 0 commits from claude/r9-public-surface into main
Owner

무엇을, 왜

round9 리뷰의 공개 표면 발견 넷(RR9-02-03·02-01·02-06, RR9-04-05, 모두 Medium)을 고친다.

  • 공개 경로 스냅숏이 기본값 한 줄만 봤다(RR9-02-03). publicPathSnapshotTest는 config/security.yml의 기본값만 읽었는데, 문서(docs/build.md, gates.md 「공개 경로·보안 체인」)는 보안 체인 전체를 지킨다고 했다. application-local.yml의 /api/healthcheck 덮어쓰기, web-notification callback chain의 /internal/notification/callbacks/** anyRequest().permitAll(), actuator chain이 검사를 지나갔다.
  • 승인 방법 문서가 없는 것을 가리켰다(RR9-04-05). docs/build.md가 지운 PublicPathSnapshotPlugin.java와 없는 updatePublicPathSnapshot을 적었다.
  • 관리 포트 문서·compose가 loopback 기본값과 갈렸다(RR9-02-01). 관리 포트가 컨테이너 loopback(MANAGEMENT_SERVER_ADDRESS 기본 127.0.0.1)에 묶인 뒤 compose의 127.0.0.1:9001 publish는 아무것도 답하지 않는 줄이 됐고, service-runtime README·Dockerfile은 Kubernetes 프로브가 닿는다고 적었다.
  • dev lane이 원격 JMX를 무인증으로 열었다(RR9-02-06). 9999를 인증·TLS 없이, jmxremote.host 없이 열었다(주석은 「localhost only」).

고른 방법과 버린 대안

  • 스냅숏에 두 절을 더했다: profile 파일이 public-paths를 리터럴로 덮은 값, 모든 leaf 운영 코드에서 Spring Security를 import한 파일의 permitAll·securityMatcher 문장(파일 경로와 함께 정렬). 그 소스와 baseline을 lane 입력으로 선언해 캐시가 변경을 놓치지 않게 했다.
  • 버린 안: 기동한 SecurityFilterChain의 matcher를 reflection으로 읽기. matcher가 Spring private 필드에 있어 버전마다 깨진다. 글자로 보므로 상수로 만든 matcher의 값은 못 본다. 그 한계를 docs/build.md에 적었다.
  • 관리 포트 publish 줄과 dev lane JMX를 지우고, 컨테이너 안에서 읽는 명령(docker compose exec app wget …, jcmd)을 주석에 적었다. Kubernetes는 MANAGEMENT_SERVER_ADDRESS를 바꾸거나 sidecar로 읽어야 한다고 service-runtime README·Dockerfile·docs/build.md에 적었다.

위험과 영향

  • 파생 서비스가 자기 chain이나 profile 덮어쓰기를 두었다면 merge 뒤 스냅숏이 실패한다. 읽고 승인하면 된다. dev lane에서 원격 JMX로 보던 사람은 jcmd로 바꾼다. 할 일은 docs/upgrade/2026-11-round9-public-surface.md.
  • docs/work/reference/gates.md:47의 스냅숏 설명이 이제 실제보다 좁다. 그 파일은 백엔드 CI 세션 몫이라 그쪽에 넘겼다.

검증

desktop, --no-build-cache, 로그 ~/r9-be-logs/b3-{red-probe,green2,mutation2}.log.

  • RED: 기준 a7e38c10에 permitAll chain을 더한 탐침 트리에서 기존 publicPathSnapshotTest가 통과(rc=0) — 틈이 있다.
  • GREEN: spotlessApply 뒤 :app-bootstrap:test --tests '*PublicPathSnapshotTest'(새 렌더링 시험 둘), :app-bootstrap:publicPathSnapshotTest, repositoryContractTest, spotlessCheck, :verifyComposeProfiles(18 lane) — 67건 실패 0, skip 1, rc=0.
  • 변이: 새 스냅숏을 커밋한 트리에서 callback chain의 securityMatcher를 "/internal/**"로 넓히면 publicPathSnapshotTest가 실패한다.
  • 노트북(main fe0f8141 병합 뒤): check-docs.py·check-work-docs.py·check-repo-layout.py rc=0.

리뷰어가 볼 곳

  • docs/security/public-paths-snapshot.txt에 새로 든 일곱 항목(profile 덮어쓰기 하나, chain 문장 여섯)이 의도한 공개인가(보안 리뷰).
  • PublicPathSnapshotTest.renderPermitAllSites: 주석 줄을 건너뛰고, .permitAll()로 시작하는 줄은 앞 줄과 붙여 matcher를 함께 남긴다.

관련

  • 리뷰 기록: PR #17 docs/reviews/2026-11-12-round9-review/ RR9-02-01·03·06, RR9-04-05.
## 무엇을, 왜 round9 리뷰의 공개 표면 발견 넷(RR9-02-03·02-01·02-06, RR9-04-05, 모두 Medium)을 고친다. - **공개 경로 스냅숏이 기본값 한 줄만 봤다(RR9-02-03).** `publicPathSnapshotTest`는 `config/security.yml`의 기본값만 읽었는데, 문서(`docs/build.md`, gates.md 「공개 경로·보안 체인」)는 보안 체인 전체를 지킨다고 했다. `application-local.yml`의 `/api/healthcheck` 덮어쓰기, web-notification callback chain의 `/internal/notification/callbacks/**` `anyRequest().permitAll()`, actuator chain이 검사를 지나갔다. - **승인 방법 문서가 없는 것을 가리켰다(RR9-04-05).** `docs/build.md`가 지운 `PublicPathSnapshotPlugin.java`와 없는 `updatePublicPathSnapshot`을 적었다. - **관리 포트 문서·compose가 loopback 기본값과 갈렸다(RR9-02-01).** 관리 포트가 컨테이너 loopback(`MANAGEMENT_SERVER_ADDRESS` 기본 `127.0.0.1`)에 묶인 뒤 compose의 `127.0.0.1:9001` publish는 아무것도 답하지 않는 줄이 됐고, service-runtime README·Dockerfile은 Kubernetes 프로브가 닿는다고 적었다. - **dev lane이 원격 JMX를 무인증으로 열었다(RR9-02-06).** 9999를 인증·TLS 없이, `jmxremote.host` 없이 열었다(주석은 「localhost only」). ## 고른 방법과 버린 대안 - 스냅숏에 두 절을 더했다: profile 파일이 `public-paths`를 리터럴로 덮은 값, 모든 leaf 운영 코드에서 Spring Security를 import한 파일의 `permitAll`·`securityMatcher` 문장(파일 경로와 함께 정렬). 그 소스와 baseline을 lane 입력으로 선언해 캐시가 변경을 놓치지 않게 했다. - 버린 안: 기동한 `SecurityFilterChain`의 matcher를 reflection으로 읽기. matcher가 Spring private 필드에 있어 버전마다 깨진다. 글자로 보므로 상수로 만든 matcher의 값은 못 본다. 그 한계를 `docs/build.md`에 적었다. - 관리 포트 publish 줄과 dev lane JMX를 지우고, 컨테이너 안에서 읽는 명령(`docker compose exec app wget …`, `jcmd`)을 주석에 적었다. Kubernetes는 `MANAGEMENT_SERVER_ADDRESS`를 바꾸거나 sidecar로 읽어야 한다고 service-runtime README·Dockerfile·`docs/build.md`에 적었다. ## 위험과 영향 - 파생 서비스가 자기 chain이나 profile 덮어쓰기를 두었다면 merge 뒤 스냅숏이 실패한다. 읽고 승인하면 된다. dev lane에서 원격 JMX로 보던 사람은 `jcmd`로 바꾼다. 할 일은 `docs/upgrade/2026-11-round9-public-surface.md`. - `docs/work/reference/gates.md:47`의 스냅숏 설명이 이제 실제보다 좁다. 그 파일은 백엔드 CI 세션 몫이라 그쪽에 넘겼다. ## 검증 desktop, `--no-build-cache`, 로그 `~/r9-be-logs/b3-{red-probe,green2,mutation2}.log`. - RED: 기준 `a7e38c10`에 permitAll chain을 더한 탐침 트리에서 기존 `publicPathSnapshotTest`가 통과(rc=0) — 틈이 있다. - GREEN: `spotlessApply` 뒤 `:app-bootstrap:test --tests '*PublicPathSnapshotTest'`(새 렌더링 시험 둘), `:app-bootstrap:publicPathSnapshotTest`, `repositoryContractTest`, `spotlessCheck`, `:verifyComposeProfiles`(18 lane) — 67건 실패 0, skip 1, rc=0. - 변이: 새 스냅숏을 커밋한 트리에서 callback chain의 `securityMatcher`를 `"/internal/**"`로 넓히면 `publicPathSnapshotTest`가 실패한다. - 노트북(main `fe0f8141` 병합 뒤): `check-docs.py`·`check-work-docs.py`·`check-repo-layout.py` rc=0. ## 리뷰어가 볼 곳 - `docs/security/public-paths-snapshot.txt`에 새로 든 일곱 항목(profile 덮어쓰기 하나, chain 문장 여섯)이 의도한 공개인가(보안 리뷰). - `PublicPathSnapshotTest.renderPermitAllSites`: 주석 줄을 건너뛰고, `.permitAll()`로 시작하는 줄은 앞 줄과 붙여 matcher를 함께 남긴다. ## 관련 - 리뷰 기록: PR #17 `docs/reviews/2026-11-12-round9-review/` RR9-02-01·03·06, RR9-04-05.
donghyeon.kang added 2 commits 2026-11-12 18:47:54 +00:00
문제: 공개 경로 스냅숏(publicPathSnapshotTest)은 config/security.yml의
기본값 한 줄만 읽었다. 문서(docs/build.md, gates.md 「공개 경로·보안 체인」)는
보안 체인 전체를 지킨다고 했다. 그래서 둘이 검사를 지나갔다.
- application-local.yml이 public-paths를 /api/healthcheck로 덮는다.
- web-notification의 callback chain이 /internal/notification/callbacks/**를
  anyRequest().permitAll()로 연다. actuator chain의 health·info·prometheus도
  같다.
docs/build.md는 지운 PublicPathSnapshotPlugin.java와 없는
updatePublicPathSnapshot 태스크를 승인 방법으로 적었다.

관리 포트도 문서와 compose가 갈렸다. 관리 포트가 컨테이너 loopback에 묶인
뒤(MANAGEMENT_SERVER_ADDRESS 기본 127.0.0.1) compose.yaml·dev lane의
127.0.0.1:9001 publish는 아무것도 답하지 않는 줄이 됐고, service-runtime
README·Dockerfile은 Kubernetes 프로브가 닿는다고 적었다. dev lane은 원격
JMX(9999)를 인증·TLS 없이, jmxremote.host 없이 열었다(주석은 「localhost
only」).

고른 방법:
- 스냅숏에 두 절을 더한다. profile 파일이 public-paths를 리터럴로 덮으면
  그 값, 모든 leaf 운영 코드에서 Spring Security를 import한 파일의
  permitAll·securityMatcher 문장(파일 경로와 함께, 정렬). 그 소스와 baseline을
  lane 입력으로 선언해 캐시가 변경을 놓치지 않게 했다.
- 기동한 SecurityFilterChain의 matcher를 reflection으로 읽는 안은 버렸다.
  matcher가 Spring의 private 필드에 있어 버전마다 깨진다. 문장 글자만 보므로
  상수로 만든 matcher의 값은 못 본다. 그 한계를 docs/build.md에 적었다.
- 관리 포트 publish 줄과 dev lane JMX를 지웠다. 컨테이너 안에서 읽는 명령
  (docker compose exec app wget …, jcmd)을 주석에 적었다. Kubernetes는
  MANAGEMENT_SERVER_ADDRESS를 바꾸거나 sidecar로 읽어야 한다고
  service-runtime README·Dockerfile·docs/build.md에 적었다.

위험·한계: 파생 서비스가 자기 chain이나 profile 덮어쓰기를 두었다면 merge 뒤
스냅숏이 실패한다. 읽고 승인하면 된다(upgrade 안내 1). dev lane에서 원격
JMX로 보던 사람은 jcmd로 바꾼다(안내 4).

검증(desktop, --no-build-cache):
- RED: 기준 a7e38c10에 permitAll chain을 더한 탐침 트리에서 기존
  publicPathSnapshotTest가 통과했다(rc=0) — 틈이 있다.
- GREEN: spotlessApply 뒤 :app-bootstrap:test --tests '*PublicPathSnapshotTest'
  (새 렌더링 시험 둘), :app-bootstrap:publicPathSnapshotTest,
  repositoryContractTest, spotlessCheck, :verifyComposeProfiles(18 lane) —
  67건 실패 0, skip 1, rc=0.
- 변이: 새 스냅숏을 커밋한 트리에서 callback chain의 securityMatcher를
  "/internal/**"로 넓히면 publicPathSnapshotTest가 실패한다.

BREAKING CHANGE: 공개 경로 스냅숏이 profile 덮어쓰기와 모든 모듈의
permitAll·securityMatcher 문장을 본다. compose가 관리 포트 9001과 dev lane
JMX 9999를 publish하지 않는다. 할 일은
docs/upgrade/2026-11-round9-public-surface.md.
donghyeon.kang added 1 commit 2026-11-12 18:59:08 +00:00
Merge branch 'main' into claude/r9-public-surface
pr / done (pull_request) Canceled after 0s
44f7203560
Author
Owner

#28로 병합됐다(main 3d31896a). 이 PR의 head 44f72035가 #28 브랜치에 merge 커밋으로 들어 있고, #28의 runner pr / done이 그 합친 트리로 초록이었다. runner 대기를 줄이려고 이번만 쓴 방식이다(소유자 승인, 2026-11-13).

#28로 병합됐다(main `3d31896a`). 이 PR의 head `44f72035`가 #28 브랜치에 merge 커밋으로 들어 있고, #28의 runner `pr / done`이 그 합친 트리로 초록이었다. runner 대기를 줄이려고 이번만 쓴 방식이다(소유자 승인, 2026-11-13).
donghyeon.kang closed this pull request 2026-11-12 23:28:32 +00:00

Pull request closed

Please reopen this pull request to perform a merge.
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: donghyeon.kang/clean-architecture-backend-template#23