fix(security): 선언한 CSP를 검사하고 hosting fixture가 선언을 복사하지 않는다 #31

Closed
donghyeon.kang wants to merge 0 commits from donghyeon.kang/fix/r9-security-config AGit into main
Owner

무엇을, 왜

  • pnpm-workspace.yaml의 minimumReleaseAgeExclude 넷(@playwright/test, playwright, playwright-core 1.62.0, eslint 10.8.0)은 2026-07-25에 그 버전이 최소 공개 경과 기간보다 어릴 때 더했다. 주석이 적은 제거 조건(「설정한 최소 경과 기간보다 오래되면 지운다」)을 몇 달 전에 넘겼다. 남은 예외는 같은 버전의 다른 출처가 생겨도 지연 검사를 건너뛰게 한다(1112/07-02).
  • config/hosting/security-headers.json의 CSP가 무엇을 허용하는지 보는 검사가 없다. script-src에 'unsafe-inline'을 넣은 선언도 모든 게이트를 지난다. hosting fixture는 선언한 보안 header 일곱을 표면 넷에 그대로 복사해, CSP를 바꾸면 다섯 곳을 고쳐야 한다(0929/13-04).

고른 방법과 버린 대안

  • 예외 넷과 그 주석을 지운다. 버전 고정(package.json exact pin)은 그대로다.
  • scripts/lib/csp-policy.ts:
    • cspPolicyProblems가 code 지시어(default-src, script-src*, style-src*, object-src)의 'unsafe-inline'·'unsafe-eval'·*와, script 계열의 scheme 통째 허용(https:)을 거절한다. script-src와 default-src가 둘 다 없는 정책도 거절한다.
    • 브라우저처럼 읽는다(CSP3): 이름과 키워드는 대소문자를 가리지 않고, 같은 지시어가 두 번이면 앞의 것만 본다.
    • declaredCspProblems가 선언 문서를 읽고, check:browser-security(FE-GATE-013)가 그것을 부른다.
  • check:security:fixtures(FE-GATE-029)가 거절 fixture(tests/fixtures/security/csp/, 대소문자를 바꾼 'unsafe-inline'이 앞 script-src에 있음)를 거절하고 선언을 받는지 본다. 새 검사에 거절 fixture를 함께 둔다는 규칙대로다.
  • hosting fixture에서 보안 header를 지운다. verify-hosting-headers의 fixture 모드는 보안 header가 필요한 표면에 선언을 답으로 채운다. fixture가 적은 값은 그대로 host의 답으로 비교한다.
  • 버린 안:
    • fixture를 선언에서 만들기: 대조 검사가 이미 같은 값을 지키고, 허용 내용은 여전히 안 본다.
    • fixture 생성 스크립트: 생성물이 하나 더 생기고 대조할 것은 같다.

위험과 영향

  • 이 버전들을 다시 받을 때 pnpm이 지연 검사를 한다. 이미 기간을 넘긴 버전이라 설치는 바뀌지 않는다.
  • 제품이 인라인 스크립트가 필요한 CSP로 바꾸면 FE-GATE-013이 막는다. 그때는 nonce·hash로 바꾼다. connect-src의 https:는 보지 않는다(스크립트 실행이 아니다).
  • fixture 모드의 보안 header 비교는 선언끼리의 비교가 된다. 전에도 fixture 모드는 UNVERIFIED였다(live 모드만 host를 본다).
  • 다운스트림: CSP를 바꿀 때 config/hosting/security-headers.json 하나만 고친다. 자기 hosting fixture에 보안 header를 복사해 두었다면 지워도 된다(round9 마지막 CHANGELOG에 적는다).

검증

desktop, CI env, scripts/verify.sh(flock).

  • RED(첫 커밋): tests/unit/csp-policy.test.ts 모듈이 없어 실패. 로그 /tmp/claude-gates/r9f13-red/. GREEN csp-policy·pnpm-install-policy 10 passed.
  • RED(PR 전 자체 리뷰 보강, 커밋 afcd2487의 시험만): 브라우저식 읽기 여섯, declaredCspProblems 넷, 「선언만 바꾼 뒤 fixture 통과」가 실패(11건). 「fixture가 적은 header는 비교」는 대조군으로 통과. 로그 /tmp/claude-gates/r9f13b-red/.
  • GREEN(head): csp-policy·hosting-probe·service-worker-build-output·cache-policy 72 passed. 로그 /tmp/claude-gates/r9f13b-green/.
  • check:security:fixtures(FE-GATE-029의 명령): rc=0.
  • 게이트(트리 73c84839 = head 트리): FE-GATE-002·003·005 rc=0. parts FE-GATE-013은 test:system만 rc=1(desktop 호스트의 user namespace 사전 점검, 결정 D8)이고 뒤 명령 넷(verify:reproducible-build, build:release-candidate, verify:local-evidence, check:browser-security)은 rc=0. FE-GATE-001(lockfile)은 첫 커밋 트리에서 rc=0.

리뷰어가 볼 곳

  • scripts/lib/csp-policy.ts의 directivesOf(앞 지시어만, 소문자).
  • scripts/verify-hosting-headers.ts의 fixture 모드(선언을 답으로 채우는 곳).

관련

  • 발견: docs/reviews/2026-11-round9-07-security.md 07-02, 이월 0929/13-04(docs/reviews/2026-11-round9-11-prior-findings-b.md 3.29절)(PR #23)
  • Refs: 1112/07-02, 0929/13-04
## 무엇을, 왜 - `pnpm-workspace.yaml`의 `minimumReleaseAgeExclude` 넷(@playwright/test, playwright, playwright-core 1.62.0, eslint 10.8.0)은 2026-07-25에 그 버전이 최소 공개 경과 기간보다 어릴 때 더했다. 주석이 적은 제거 조건(「설정한 최소 경과 기간보다 오래되면 지운다」)을 몇 달 전에 넘겼다. 남은 예외는 같은 버전의 다른 출처가 생겨도 지연 검사를 건너뛰게 한다(1112/07-02). - `config/hosting/security-headers.json`의 CSP가 무엇을 허용하는지 보는 검사가 없다. `script-src`에 `'unsafe-inline'`을 넣은 선언도 모든 게이트를 지난다. hosting fixture는 선언한 보안 header 일곱을 표면 넷에 그대로 복사해, CSP를 바꾸면 다섯 곳을 고쳐야 한다(0929/13-04). ## 고른 방법과 버린 대안 - 예외 넷과 그 주석을 지운다. 버전 고정(package.json exact pin)은 그대로다. - `scripts/lib/csp-policy.ts`: - `cspPolicyProblems`가 code 지시어(`default-src`, `script-src*`, `style-src*`, `object-src`)의 `'unsafe-inline'`·`'unsafe-eval'`·`*`와, script 계열의 scheme 통째 허용(`https:`)을 거절한다. `script-src`와 `default-src`가 둘 다 없는 정책도 거절한다. - 브라우저처럼 읽는다(CSP3): 이름과 키워드는 대소문자를 가리지 않고, 같은 지시어가 두 번이면 앞의 것만 본다. - `declaredCspProblems`가 선언 문서를 읽고, `check:browser-security`(FE-GATE-013)가 그것을 부른다. - `check:security:fixtures`(FE-GATE-029)가 거절 fixture(`tests/fixtures/security/csp/`, 대소문자를 바꾼 `'unsafe-inline'`이 앞 `script-src`에 있음)를 거절하고 선언을 받는지 본다. 새 검사에 거절 fixture를 함께 둔다는 규칙대로다. - hosting fixture에서 보안 header를 지운다. `verify-hosting-headers`의 fixture 모드는 보안 header가 필요한 표면에 선언을 답으로 채운다. fixture가 적은 값은 그대로 host의 답으로 비교한다. - 버린 안: - fixture를 선언에서 만들기: 대조 검사가 이미 같은 값을 지키고, 허용 내용은 여전히 안 본다. - fixture 생성 스크립트: 생성물이 하나 더 생기고 대조할 것은 같다. ## 위험과 영향 - 이 버전들을 다시 받을 때 pnpm이 지연 검사를 한다. 이미 기간을 넘긴 버전이라 설치는 바뀌지 않는다. - 제품이 인라인 스크립트가 필요한 CSP로 바꾸면 FE-GATE-013이 막는다. 그때는 nonce·hash로 바꾼다. `connect-src`의 `https:`는 보지 않는다(스크립트 실행이 아니다). - fixture 모드의 보안 header 비교는 선언끼리의 비교가 된다. 전에도 fixture 모드는 UNVERIFIED였다(live 모드만 host를 본다). - 다운스트림: CSP를 바꿀 때 `config/hosting/security-headers.json` 하나만 고친다. 자기 hosting fixture에 보안 header를 복사해 두었다면 지워도 된다(round9 마지막 CHANGELOG에 적는다). ## 검증 desktop, CI env, `scripts/verify.sh`(flock). - RED(첫 커밋): `tests/unit/csp-policy.test.ts` 모듈이 없어 실패. 로그 `/tmp/claude-gates/r9f13-red/`. GREEN `csp-policy`·`pnpm-install-policy` 10 passed. - RED(PR 전 자체 리뷰 보강, 커밋 `afcd2487`의 시험만): 브라우저식 읽기 여섯, `declaredCspProblems` 넷, 「선언만 바꾼 뒤 fixture 통과」가 실패(11건). 「fixture가 적은 header는 비교」는 대조군으로 통과. 로그 `/tmp/claude-gates/r9f13b-red/`. - GREEN(head): `csp-policy`·`hosting-probe`·`service-worker-build-output`·`cache-policy` 72 passed. 로그 `/tmp/claude-gates/r9f13b-green/`. - `check:security:fixtures`(FE-GATE-029의 명령): rc=0. - 게이트(트리 `73c84839` = head 트리): FE-GATE-002·003·005 rc=0. `parts FE-GATE-013`은 `test:system`만 rc=1(desktop 호스트의 user namespace 사전 점검, 결정 D8)이고 뒤 명령 넷(`verify:reproducible-build`, `build:release-candidate`, `verify:local-evidence`, `check:browser-security`)은 rc=0. FE-GATE-001(lockfile)은 첫 커밋 트리에서 rc=0. ## 리뷰어가 볼 곳 - `scripts/lib/csp-policy.ts`의 `directivesOf`(앞 지시어만, 소문자). - `scripts/verify-hosting-headers.ts`의 fixture 모드(선언을 답으로 채우는 곳). ## 관련 - 발견: `docs/reviews/2026-11-round9-07-security.md` 07-02, 이월 0929/13-04(`docs/reviews/2026-11-round9-11-prior-findings-b.md` 3.29절)(PR #23) - Refs: 1112/07-02, 0929/13-04
donghyeon.kang added 3 commits 2026-11-12 18:52:36 +00:00
pnpm-workspace.yaml의 minimumReleaseAgeExclude 넷(@playwright/test,
playwright, playwright-core 1.62.0, eslint 10.8.0)은 2026-07-25에 그 버전이
최소 공개 경과 기간보다 어릴 때 더했다. 주석이 적은 제거 조건("설정한
최소 경과 기간보다 오래되면 지운다")을 몇 달 전에 넘겼다. 남은 예외는
같은 버전의 다른 출처가 생겨도 지연 검사를 건너뛰게 한다.

고른 방법: 넷과 그 주석을 지운다. 버전 고정(package.json exact pin)은
그대로다. 버린 대안: 주석만 고치기(예외가 할 일이 없다).

위험·한계: 이 버전들을 다시 받을 때 pnpm이 지연 검사를 한다. 이미 하루
넘게 지난 버전이라 설치는 바뀌지 않는다.

검증: FE-GATE-001(verify:lockfile)과 tests/unit/pnpm-install-policy.test.ts,
desktop의 frozen-lockfile 오프라인 설치(PR 본문). RED 없음 — 설정 정리라
동작이 바뀌지 않는다.

Refs: 1112/07-02
config/hosting/security-headers.json의 Content-Security-Policy는 hosting
fixture가 복사하고 verify-hosting-headers가 둘을 대조한다. 그러나 정책이
무엇을 허용하는지 보는 검사는 없다. script-src에 'unsafe-inline'을 넣은
선언도 모든 게이트를 지난다.

고른 방법: scripts/lib/csp-policy.ts의 cspPolicyProblems가 code 지시어
(default-src, script-src*, style-src*, object-src)의 'unsafe-inline'·
'unsafe-eval'·*와 script 계열의 scheme 통째 허용(https:)을 거절하고,
script-src·default-src가 없는 정책도 거절한다. check:browser-security
(FE-GATE-013)가 선언 파일에 부른다. 버린 대안: fixture를 선언에서 만들기
(대조 검사가 이미 같은 값을 지킨다. 허용 내용은 여전히 안 본다).

위험·한계: 제품이 인라인 스크립트가 필요한 CSP로 바꾸면 이 검사가
막는다. 그때는 nonce·hash로 바꾼다. connect-src의 https:는 보지 않는다
(스크립트 실행이 아니다).

검증: tests/unit/csp-policy.test.ts가 고치기 전에는 모듈이 없어 실패하고
고친 뒤 통과한다(desktop, PR 본문). check:browser-security는
`parts FE-GATE-013` 뒤 명령으로 돈다.

Refs: 0929/13-04
fix(security): CSP 검사가 브라우저처럼 읽고 hosting fixture가 선언을 복사하지 않는다
frontend-quality-gates / merge / tests (pull_request) Canceled after 0s
frontend-quality-gates / merge / browser tests (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Canceled after 0s
frontend-quality-gates / external-vulnerability-provider (pull_request) Canceled after 0s
frontend-quality-gates / external-provenance-provider (pull_request) Canceled after 0s
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Canceled after 0s
frontend-quality-gates / deploy-promoted-release (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Canceled after 0s
frontend-quality-gates / main / checker self-tests (pull_request) Canceled after 0s
frontend-quality-gates / merge / static checks (pull_request) Canceled after 51s
afcd248780
앞 커밋 뒤 확인 리뷰가 셋을 찾았다.

- 같은 지시어가 두 번이면 검사는 뒤 값을, 브라우저는 앞 값을 쓴다(CSP3).
  키워드도 대소문자를 가려 비교한다. 그래서 `script-src 'self' 'unsafe-inline';
  script-src 'self'`와 `'Unsafe-Inline'`이 통과한다.
- 0929/13-04 완료 기준 「CSP를 바꿀 때 한 파일만 고친다」가 안 됐다. hosting
  fixture가 선언한 보안 header 일곱을 표면 넷에 그대로 복사한다.
- check:browser-security가 검사를 부르는 연결을 지키는 시험이 없다.

고른 방법: 지시어는 첫 것만, 이름과 키워드는 소문자로 읽는다. 선언 문서를
읽는 declaredCspProblems를 두고 check:browser-security가 그것을 부른다.
check:security:fixtures(FE-GATE-029)가 거절 fixture(대소문자를 바꾼
'unsafe-inline'이 앞 script-src에 있음)를 거절하고 선언을 받는지 본다. hosting
fixture에서 보안 header를 지우고, verify-hosting-headers의 fixture 모드는
보안 header가 필요한 표면에 선언을 답으로 채운다. fixture가 적은 값은 그대로
host의 답으로 비교한다. 버린 대안: fixture를 선언에서 생성하는 스크립트(생성물이
하나 더 생기고 대조할 것은 같다).

위험·한계: fixture 모드의 보안 header 비교는 선언끼리의 비교가 된다. 전에도
fixture 모드는 UNVERIFIED였다(live 모드만 host를 본다).

검증: csp-policy.test.ts 새 시험(브라우저처럼 읽기 다섯, 뒤 지시어 무시,
declaredCspProblems 넷)과 hosting-probe.test.ts 새 시험 둘(선언만 바꾼 뒤
fixture 통과, fixture가 적은 header는 비교)을 고치기 전 코드에서 RED로 보고
desktop에서 GREEN·FE-GATE-029를 돌린다(PR 본문).

Refs: 0929/13-04
donghyeon.kang added 1 commit 2026-11-12 19:29:36 +00:00
Merge remote-tracking branch 'origin/main' into fix/r9-security-config
frontend-quality-gates / merge / static checks (pull_request) Canceled after 0s
frontend-quality-gates / merge / tests (pull_request) Canceled after 0s
frontend-quality-gates / merge / browser tests (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Canceled after 0s
frontend-quality-gates / external-vulnerability-provider (pull_request) Canceled after 0s
frontend-quality-gates / external-provenance-provider (pull_request) Canceled after 0s
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Canceled after 0s
frontend-quality-gates / deploy-promoted-release (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Canceled after 0s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Canceled after 0s
frontend-quality-gates / main / self-tests and removal drills (pull_request) Canceled after 0s
e941c3dfb1
Author
Owner

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

#40으로 병합됐다(main `ee47480c`). 이 PR의 head `e941c3df`가 #40 브랜치에 merge 커밋으로 들어 있고, #40의 runner merge job 셋이 그 합친 트리로 초록이었다. runner 대기를 줄이려고 이번만 쓴 방식이다(소유자 승인, 2026-11-13).
donghyeon.kang closed this pull request 2026-11-12 23:43:42 +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-frontend-template#31