문제: docs/runbooks, docs/security, docs/styling/design-tokens.md, docs/accessibility, docs/contracts, docs/testing/taxonomy.md와 src/adapters/browser-transfer/image-cdn/README.md는 본문이 영어다. PRODUCT.md는 「~합니다」 체라 한 문서 안 문체 규칙(「~한다」)과 다르다. 고른 방법: 뜻을 바꾸지 않고 옮긴다. runbook 제목의 ID와 오류 code, 기록 양식의 영어 키(`Status:`, `M1 Keyboard:` 등, 코드 블록 안)는 그대로 둔다. PRODUCT.md는 디자인 도구가 읽는 제목(`## Users` 등)을 두고 문장 끝만 바꾼다. 위험: 이 커밋으로 문서 검사의 예외 목록이 빈다. 앞으로 영어 문서나 높임 문체를 더하면 verify:documentation이 실패한다. 검증: 백틱 span·링크 대상·코드 블록을 옮기기 전과 python으로 비교해 같다. 문서 검사 여섯이 모두 0건이고 예외 목록과 FROZEN이 비었다.
29 lines
2.1 KiB
Markdown
29 lines
2.1 KiB
Markdown
# 브라우저 보안 경계
|
|
|
|
브라우저 bundle은 공개된다. 그래서 다음은 기본으로 금지한다: 비밀값, 토큰 수명
|
|
주기 관리, raw HTML 주입, 동적 코드 실행, 믿을 수 없는 script URL, 공개된
|
|
production source map.
|
|
|
|
선언된 header 집합은 `config/hosting/security-headers.json`이다. hosting 검증은
|
|
이 선언과 실제 응답을 비교한다. CSP는 일부러 `unsafe-inline`과 `unsafe-eval`을
|
|
뺀다. production 코드와 빌드된 asset은 이 기준선에서도 동작해야 한다.
|
|
`tests/e2e/production-csp.spec.ts`(`test:e2e`의 일부, FE-GATE-008)는 이 header로
|
|
빌드를 서빙한다. 그리고 `securitypolicyviolation` 이벤트나 console 오류가 나면
|
|
실패한다(리뷰 13-08). zod는 첫 object schema에서 `Function("")`을 시험 삼아
|
|
실행한다. 그러면 정책이 부트할 때마다 이것을 위반으로 보고한다.
|
|
`src/contracts/zod.ts`는 `jitless`를 켜서 이 시험을 건너뛴다. schema를 만드는
|
|
모든 모듈은 `z`를 그 파일에서 import한다. 그래서 bundler가 chunk를 어떤 순서로
|
|
평가하든 이 설정이 첫 schema보다 먼저 적용된다. entry 모듈에서 `z.config`를
|
|
부르면 너무 늦다. 새 schema 코드에서는 `z`를 `zod`가 아니라
|
|
`src/contracts/zod.ts`에서 import한다. 기본으로 꺼진 기능은 프로젝트가 그 기능을
|
|
고를 때 CSP에 항목을 더해야 한다.
|
|
[선택형 adapter recipe](../architecture/optional-adapter-recipes.md)의 9단계를 본다.
|
|
`connect-src 'self' https:`는 script가 모든 HTTPS origin에 닿게 둔다. 이것을
|
|
runtime config의 `API_BASE_URL`과 `TELEMETRY_ENDPOINT` origin으로 좁히려면
|
|
배포할 때 환경마다 header를 만들어야 한다. 그 값들은 배포마다 정해지기
|
|
때문이다(`scripts/generate-runtime-config.ts`). 그런 header 생성기는 아직 없다.
|
|
배포하는 프로젝트는 provider adapter를 만들 때 함께 더해야 한다.
|
|
|
|
route guard는 UX 힌트일 뿐이다. 클라이언트 검증은 백엔드의 인가(authorization)나
|
|
검증을 대신하지 않는다.
|