Next.js 보안
우선순위: P0 (중요)
구조
app/
├── lib/
│ └── validation.ts # 공유 Zod 스키마
└── middleware.ts # 인증 및 헤더
구현 가이드라인
- Next.js 미들웨어: **
middleware.ts**를 사용하여 엣지 수준 인증, 역할 기반 접근 제어(RBAC) 및 보안 헤더(예: Content-Security-Policy (CSP), X-XSS-Protection)를 적용합니다.
- 서버 액션:
FormData 또는 JSON의 모든 입력을 Zod를 사용하여 항상 검증합니다. 모든 액션 내에서 호출자를 확인하기 위해 인증 검사(await auth())를 수행합니다.
- 데이터 오염 방지:
experimental_taint API(taintObjectReference)를 사용하여 민감한 서버 객체(예: passwordHash가 포함된 사용자)가 클라이언트 컴포넌트로 절대 유출되지 않도록 합니다.
- 라우트 핸들러 (
route.ts): 무차별 대입 공격이나 DoS 공격을 방지하기 위해 속도 제한을 구현합니다. CSRF(교차 사이트 요청 위조)를 완화하기 위해 Origin/Referer 헤더를 확인합니다.
- 인증 토큰: 세션 관리에는
HttpOnly, Secure 쿠키를 **SameSite: 'Lax'**와 함께 엄격히 사용합니다. localStorage에 토큰을 절대 저장하지 마십시오.
- 로직 격리:
server-only 패키지를 사용하여 백엔드 특정 로직이 클라이언트 번들에 포함되지 않도록 방지합니다.
- 컴포넌트 순수성: 컴포넌트에서 렌더링되는 모든 사용자 제공 콘텐츠를 이스케이프합니다. **
DOMPurify**와 같은 살균기 없이 **dangerouslySetInnerHTML**을 절대 사용하지 마십시오.
안티패턴
- 클라이언트로 DB 필드 유출 금지: DTO를 사용하십시오. 원시 모델 객체를 절대 전달하지 마십시오.
- 클라이언트 번들에
process.env 사용 금지: 노출해도 안전한 경우에만 NEXT_PUBLIC_으로 표시하십시오.
- 검증되지 않은 서버 액션 입력 금지: 항상 Zod 스키마로 검증하십시오.
- 공유 레이아웃에서 인증 검사 금지: 레이아웃에서의 인증은 안전하지 않습니다. 미들웨어를 사용하십시오.
참고 자료