2.6 KiB
브라우저 보안 경계
브라우저 bundle은 공개된다. 그래서 다음은 기본으로 금지한다: 비밀값, 토큰 수명 주기 관리, raw HTML 주입, 동적 코드 실행, 믿을 수 없는 script URL, 공개된 production source map.
선언된 header 집합은 config/hosting/security-headers.json이다. hosting 검증은
이 선언과 실제 응답을 비교한다. CSP는 일부러 unsafe-inline과 unsafe-eval을
뺀다. production 코드와 빌드된 asset은 이 기준선에서도 동작해야 한다.
check:browser-security(FE-GATE-013)는 선언한 CSP가 'unsafe-inline',
'unsafe-eval', *, script의 scheme 통째 허용(https:)을 담으면 실패한다.
브라우저처럼 같은 지시어가 두 번이면 앞의 것을 읽고, 키워드의 대소문자를 가리지
않는다(scripts/lib/csp-policy.ts). hosting fixture
(tests/fixtures/hosting/response-headers.json)는 이 header를 복사하지 않는다.
fixture 모드는 선언을 그대로 답으로 쓰므로 CSP를 바꿀 때 선언 파일 하나만 고친다.
tests/e2e/production-csp.spec.ts(test:e2e의 일부, FE-GATE-008)는 이 header로
빌드를 서빙한다. 그리고 securitypolicyviolation 이벤트나 console 오류가 나면
실패한다(리뷰 0925/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의 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)나 검증을 대신하지 않는다.