localStorage의 httpOnly 쿠키 또는 JWT 세션: 웹 애플리케이션에 대해 선택할 항목
질문이 부정확하게 제기되었습니다.
쿠키와 JWT 논쟁은 두 가지 독립적인 솔루션을 혼동합니다.
- 1.클라이언트가 토큰을 저장하는 위치: 브라우저가 자체적으로 전송하는 httpOnly 쿠키 또는 JavaScript가 이를 읽고
Authorization헤더에 넣는localStorage쿠키입니다. - 2.이 토큰은 무엇입니까? 서버가 데이터베이스에서 항목을 찾는 데 사용하는 불투명 세션 식별자 또는 자체적으로 서명된 JWT입니다.
JWT는 httpOnly 쿠키와 localStorage의 세션 ID에 저장될 수 있습니다. 따라서 각 솔루션을 개별적으로 분석하겠습니다.
저장 위치: XSS 결과
페이지에서 다른 사람의 스크립트가 실행된 경우(취약한 종속성, 이스케이프되지 않은 사용자 입력, 손상된 분석 스크립트):
- `localStorage`의 토큰 스크립트가 읽고 해당 서버로 보냅니다. 공격자는 피해자가 탭을 닫은 후에도 토큰이 유효한 동안 자신의 컴퓨터에서 세션을 사용합니다.
- httpOnly 쿠키의 토큰은 스크립트에서 읽을 수 없습니다. 페이지가 열려 있는 동안 사용자를 대신하여 요청을 보낼 수 있습니다. XSS는 여전히 심각한 취약점입니다. 하지만 세션을 훔쳐서 가져갈 수는 없습니다.
차이점은 쿠키가 "XSS로부터 보호"하는지(그렇지 않음)가 아니라 손상 정도입니다. 프런트엔드와 API가 동일한 사이트에 있는 웹 애플리케이션의 경우 쿠키를 사용하여 문제를 해결합니다.
쿠키 가격: CSRF
브라우저는 다른 사이트에서 시작된 요청을 포함하여 쿠키를 자동으로 보냅니다. 여러 계층의 보호:
SameSite=Lax(Chromium 브라우저의 기본값이지만 명시적으로 설정됨)는 사이트 간 POST 요청과 함께 쿠키를 보내지 않습니다.- 요청을 수정하는 경우 서버는
Origin헤더를 확인하고 외부 원본의 요청을 거부합니다. - 상태 변경 - POST/PUT/PATCH/DELETE 메서드만 사용하고 GET은 사용하지 않습니다.
Next.js의 서버 작업은 Origin 자체를 확인합니다. 자신의 경로 처리기의 경우 수표를 작성합니다.
무엇을 저장할지: 세션 리콜
서버는 데이터베이스에 액세스하지 않고 서명된 JWT를 확인합니다. 단점: 만료일 이전에는 취소할 수 없습니다. 사용자가 "모든 장치에서 로그아웃"을 클릭했고 관리자가 계정을 차단했으며 도난당한 토큰이 감지되었습니다. JWT는 계속 작동합니다. 해결 방법(짧은 수명과 새로 고침 토큰, 취소된 목록)은 JWT가 누락된 것으로 선택된 스토리지에 대한 액세스를 반환합니다.
서버 세션은 테이블의 항목입니다. 취소 - 라인을 삭제하면 즉시 적용됩니다. 요청당 데이터베이스에 대한 한 번의 액세스는 대부분의 애플리케이션에서 보이지 않으며 필요한 경우 캐시됩니다.
서버 세션 구현
CREATE TABLE sessions ( id_hash bytea PRIMARY KEY, user_id uuid NOT NULL REFERENCES users(id) ON DELETE CASCADE, expires_at timestamptz NOT NULL, created_at timestamptz NOT NULL DEFAULT now(), user_agent text ); CREATE INDEX sessions_user_idx ON sessions (user_id);
// lib/auth/sessions.ts
import "server-only";
import { createHash, randomBytes } from "node:crypto";
import { cookies } from "next/headers";
import { db } from "@/lib/db";
const COOKIE = "__Host-session";
const TTL_DAYS = 30;
const sha256 = (s: string) => createHash("sha256").update(s).digest();
export async function createSession(userId: string, userAgent?: string) {
const token = randomBytes(32).toString("base64url");
const expires = new Date(Date.now() + TTL_DAYS * 86_400_000);
await db.query(
"INSERT INTO sessions (id_hash, user_id, expires_at, user_agent) VALUES ($1, $2, $3, $4)",
[sha256(token), userId, expires, userAgent?.slice(0, 200) ?? null]
);
const jar = await cookies();
jar.set(COOKIE, token, {
httpOnly: true, secure: true, sameSite: "lax", path: "/", expires,
});
}
export async function currentUserId(): Promise<string | null> {
const token = (await cookies()).get(COOKIE)?.value;
if (!token) return null;
const { rows } = await db.query(
"SELECT user_id FROM sessions WHERE id_hash = $1 AND expires_at > now()",
[sha256(token)]
);
return rows[0]?.user_id ?? null;
}
export async function destroySession() {
const jar = await cookies();
const token = jar.get(COOKIE)?.value;
if (token) await db.query("DELETE FROM sessions WHERE id_hash = $1", [sha256(token)]);
jar.set(COOKIE, "", { httpOnly: true, secure: true, sameSite: "lax", path: "/", maxAge: 0 });
}주요 세부정보:
- 데이터베이스에는 토큰이 아닌 해시가 있습니다. 테이블에 대한 덤프 또는 읽기 전용 액세스가 누출되면 준비된 세션이 제공되지 않습니다.
- 암호화 생성기의 임의의 32바이트 - 무차별 공격이 불가능하며 서명이 필요하지 않습니다.
- 로그인 시 새 세션, 이전 세션의 권한을 늘리는 대신. 그렇지 않으면 세션 고정이 가능합니다. 공격자는 로그인하기 전에 피해자에게 자신의 식별자를 알려줍니다.
- `cookies()`는 Next.js 15에서 비동기식이므로
await입니다. 서버 작업 및 경로 처리기에서 쿠키를 설정할 수 있지만 서버 구성 요소를 렌더링할 때는 설정할 수 없습니다.
"모든 장치에서 로그아웃" - DELETE FROM sessions WHERE user_id = $1. user_agent 및 날짜가 포함된 활성 세션 목록은 이 체계의 무료 보너스입니다.
헤더의 토큰이 정당화된 경우
- 모바일 애플리케이션 또는 CLI. 쿠키는 불편합니다. 토큰은
localStorage가 아닌 플랫폼의 보안 저장소(Keychain, Keystore)에 저장됩니다. - 타사 클라이언트를 위한 API. 제한된 권한을 가진 별도의 키 또는 OAuth 토큰이 발급됩니다.
- 서비스 간 호출. 서비스 간 단기 JWT는 공통 기반 없이 검증되기 때문에 편리합니다.
자주 발생하는 오류
- 액세스 토큰의 수명이 짧은 경우
localStorage에서 토큰을 새로 고칩니다. 도난당한 새로 고침 토큰은 장기적인 액세스를 제공하므로 모든 단기 혜택이 사라집니다. - 불필요하게 세션 쿠키에 대한
Domain=.example.com. 취약한 랜딩 페이지를 포함한 모든 하위 도메인이 이를 수신합니다.__Host-접두사는Domain속성을 비활성화하고 이 옵션을 닫습니다. - 서명 확인 없이 또는 토큰 헤더의 알고리즘을 사용하여 JWT에 대한
exp를 확인합니다. 서버에 알고리즘을 기록합니다.
요약
자체 백엔드가 있는 웹 애플리케이션의 경우: httpOnly 쿠키의 불투명 식별자, 데이터베이스의 세션 레코드, SameSite=Lax 및 Origin를 확인하세요. JWT 및 헤더 Authorization - 브라우저가 아닌 클라이언트 및 서비스 간 통신용입니다.