amaranth.log
💻 개발

클라이언트(localStorage) 기반 인증에서 서버(httpOnly 쿠키) 기반 인증으로 개선하기(feat. Next.js+Supabase)

개요

기존의 인증 흐름

다음과 같이 요청이 들어오면 로그인을 수행해 그 결과로 인증 데이터를 반환하는 api를 만들고, 해당 api를 호출하여 얻은 인증 데이터를 local storage에 저장하게끔 구현하였다.
애플리케이션이 시작될 때마다 local storage로부터 인증 정보를 불러와 전역 상태에 저장한다.(sessionAtom)
사용자는 전역 상태로 저장된 인증 정보에서 사용자 정보(member id)를 가져와 api 요청에 사용한다. 이 때 대상 api는 member id의 존재 유무만 확인하고 별다른 인가 과정을 거치지 않는다.
// src/app/api/auth/login/route.ts import { supabase } from "@/lib/supabase"; import { NextRequest, NextResponse } from "next/server"; export async function POST(req: NextRequest) { const { email, password } = await req.json(); const { data, error } = await supabase.auth.signInWithPassword({ email, password, }); if (error) return NextResponse.json({ error: error.message }, { status: 401 }); if (!data.session || !data.user) return NextResponse.json( { error: "Session not returned" }, { status: 401 } ); // 이메일 인증 확인 if (!data.user.email_confirmed_at) { return NextResponse.json( { error: "이메일 인증이 필요합니다. 이메일을 확인해주세요." }, { status: 403 } ); } return NextResponse.json({ session: data.session }); }
// src/features/auth/auth-api.ts export const loginMemberApi = async (params: { email: string; password: string; }) => { const res = await fetch(`${API_BASE}/login`, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify(params), }); if (!res.ok) throw new Error("로그인 실패"); return res.json(); };
// 로그인 컴포넌트의 핸들러 ... const [, setSession] = useAtom(sessionAtom); ... const handleSubmit = async (e: FormEvent) => { e.preventDefault(); try { const { session } = await loginMemberApi({ email, password }); setSession(session); router.push("/"); } catch (err) { if (err instanceof Error) alert(err.message); } }; ...
// src/features/auth/store/sessionAtom.ts import { atom } from "jotai"; import { MemberSession } from "../types/auth"; const getInitialSession = (): MemberSession | null => { if (typeof window === "undefined") return null; const stored = localStorage.getItem("session"); return stored ? JSON.parse(stored) : null; }; // atom 생성 export const rawSessionAtom = atom<MemberSession | null>(getInitialSession()); // atom 구독해서 localStorage에 반영 export const sessionAtom = atom( (get) => get(rawSessionAtom), (get, set, update: MemberSession | null) => { set(rawSessionAtom, update); if (update) localStorage.setItem("session", JSON.stringify(update)); else localStorage.removeItem("session"); } );
추가) 로그인되지 않은 상태에서 일반 페이지에 접근하면 login 페이지로 리다이렉트하는 동작을 수행하는 HOC를 구현했다.
// src/feature/auth/components/ProtectedRoute.tsx "use client"; import { sessionAtom } from "@/features/auth/store/sessionAtom"; import { useAtomValue } from "jotai"; import { useRouter } from "next/navigation"; import { useEffect } from "react"; export function withProtectedRoute<P extends object>( WrappedComponent: React.ComponentType<P> ) { const Component = (props: P) => { const session = useAtomValue(sessionAtom); const router = useRouter(); useEffect(() => { if (!session) { router.replace("/login"); } }, [session, router]); if (!session) return null; // 로그인 전에는 렌더링 안 함 return <WrappedComponent {...props} />; }; return Component; }
// src/app/page.tsx "use client"; function MatrixPage() { ... return ( <div style={{ height }}> <TaskMatrix /> </div> ); } export default withProtectedRoute(MatrixPage);

기술 스택

  • Next.js(풀스택), React
  • Jotai
  • Supabase

문제 상황

변명을 해보자면 당시 next.js로 풀스택 서비스를 만드는 게 처음이었고, 일단 빠르게 MVP를 배포하는 것이 목적이었기 때문에 인증 구현에 시간을 많이 쏟지 않았다.
기존 로직에서 인증이 supabase.auth.signInWithPassword()를 활용해 이루어지지만, 인가 로직은 사실상 전무하여 보안상으로 바람직한 서비스 아키텍처라고 보기 어려웠다.
  • 보안이 사실상 없는 구조
    • 사용자 인증이 필요한 api(업무 목록 조회를 비롯한 대부분의 api 등)도 member id 데이터 유무만 확인하기 때문에, 타인의 member id만 가지고도 얼마든지 그 사람의 데이터를 조회하고 변조할 수 있다.
      게다가, localStorage는 자바스크립트 코드로 쉽게 접근할 수 있는 영역이라는 점에서도 위험하다.(XSS 공격으로 탈취 가능)
  • 세션 만료 및 로그아웃 제어 불가
    • localStorage는 영구 저장소이기 때문에 브라우저를 닫거나 재시작해도 데이터가 그대로 남는다. 인증을 수행하는 Supabase 측에서 세션이 만료되어도 클라이언트에서는 여전히 인증 정보를 가지고 있기 때문에 정상적으로 api 호출이 가능해서, 인증 서버와 클라이언트 간의 인증 상태 불일치가 발생한다.
  • 화면 깜빡임 현상 발생
    • local storage에서 데이터를 불러오는 데 시간이 소요되고, 그 동안 미인증 상태의 UI가 보였다가 사라지는 현상이 발생했다.
      새로고침 시 헤더 우측에 잠깐 동안 ‘로그인’ 버튼이 보였다가 바뀌는 모습을 볼 수 있다.
      새로고침 시 헤더 우측에 잠깐 동안 ‘로그인’ 버튼이 보였다가 바뀌는 모습을 볼 수 있다.
목표를 다음의 두 가지로 정했다.
  1. 신뢰할 수 있는 인증/인가 프로세스 구축
  1. 화면 깜빡임 현상 해결

인증/인가 프로세스 개선

여러 방안을 찾아보다, 인증 토큰을 httpOnly 쿠키에 저장하는 방식을 선택했다.
이 방법으로 크게 두 가지의 장점을 취할 수 있었는데, 이는 다음과 같다.
  1. 보안성 강화
    1. 토큰을 httpOnly 쿠키에 저장하면 브라우저 내 자바스크립트 코드(document.cookie)로 접근할 수 없다. 즉, XSS 공격으로부터 안전성을 확보할 수 있다.
  1. 서버 사이드에서 접근 가능
    1. 쿠키는 한 번 설정해두면 모든 요청에 포함되기 때문에, 서버 컴포넌트, middleware, API Route 등에서 일관되게 인증 상태를 검증할 수 있다.
      ⇒ 인증/인가 주체를 클라이언트(localStorage)에서 서버로 변경
먼저 Next.js의 핵심 기능 중 하나인 서버 사이드 렌더링을 적극 활용할 수 있는 방식이라는 점이 좋았다.

구현

1. httpOnly 쿠키에 액세스 토큰 저장

먼저 로그인 API에 쿠키에 토큰을 저장하는 로직을 추가했다.
// src/app/api/auth/login/route.ts import { supabase } from "@/lib/supabase/client"; import { NextRequest, NextResponse } from "next/server"; export async function POST(req: NextRequest) { const { email, password } = await req.json(); const { data, error } = await supabase.auth.signInWithPassword({ email, password, }); if (error) return NextResponse.json({ error: error.message }, { status: 401 }); if (!data.session || !data.user) return NextResponse.json( { error: "Session not returned" }, { status: 401 } ); if (!data.user.email_confirmed_at) { return NextResponse.json( { error: "이메일 인증이 필요합니다. 이메일을 확인해주세요." }, { status: 403 } ); } const response = NextResponse.json({ user: data.user }); response.cookies.set("sb-access-token", data.session.access_token, { httpOnly: true, path: "/", sameSite: "lax", }); return response; }
이렇게 하면 로그인 후 토큰 정보가 브라우저 쿠키에 추가된다.
notion image
이제 서버 사이드에서 해당 쿠키 값에 접근해 인증 상태를 확인할 수 있다.
 

2. 비로그인 상태로 페이지 접근 시 로그인 페이지로 리다이렉트시키는 미들웨어 구현

next.js 미들웨어를 활용해 기존의 withProtectedRoute 컴포넌트가 수행하던 리다이렉트 로직을 서버 사이드로 구현했다.
*기존 withProtectedRoute는 인증 상태를 토큰 존재 여부만으로 검증했는데, 이 점을 개선해 미들웨어에서는 인가 로직을 추가했다.(supabaseServer.auth.getUser(token))
// src/middleware.ts import { supabaseServer } from "@/lib/supabase/server"; import { NextRequest, NextResponse } from "next/server"; export async function middleware(req: NextRequest) { const res = NextResponse.next(); const { pathname } = req.nextUrl; res.headers.set("x-pathname", pathname); const excludePaths = ["/_next", "/favicon.ico"]; const unAuthedPath = [ "/login", "/register", ]; if (excludePaths.some((path) => pathname.startsWith(path))) { return res; } const token = req.cookies.get("sb-access-token")?.value; if (unAuthedPath.some((path) => pathname.startsWith(path))) { if (token) { const { data: { user }, } = await supabaseServer.auth.getUser(token); if (user) { return NextResponse.redirect(new URL("/", req.url)); } } return res; } if (!token) { return NextResponse.redirect(new URL("/login", req.url)); } const { data: { user }, error, } = await supabaseServer.auth.getUser(token); if (!user || error) { return NextResponse.redirect(new URL("/login", req.url)); } return res; } export const config = { matcher: [ "/api/:path*", "/((?!_next|favicon.ico).*)", ], };
 

3. API에 인가 로직 추가

인증 정보가 필요한 api에 대해 토큰 검증 & member id 추출 로직을 추가했다.
// src/lib/supabase/server.ts ... export async function authenticate(req: NextRequest) { // 쿠키에서 토큰 가져오기 const token = req.cookies.get("sb-access-token")?.value; if (!token) { throw new Error("No token"); } const { data: { user }, error, } = await supabaseServer.auth.getUser(token); if (error || !user) { throw new Error("Invalid token"); } return user; }
토큰 검증&사용자 정보를 불러오는 유틸 함수
// src/app/api/category/route.ts ... export async function GET(req: NextRequest) { try { const { id: memberId } = await authenticate(req); if (!memberId) { return NextResponse.json( { error: "unauthorized request" }, { status: 401 } ); } const categories = await prisma.category.findMany({ where: { memberId }, orderBy: { createdAt: "desc" }, }); return NextResponse.json(categories, { status: 200 }); } catch (error) { console.error("Error fetching categories:", error); return NextResponse.json( { error: "Failed to fetch categories" }, { status: 500 } ); } }
 

개선 전/후 비교

구분
기존 방식
개선 후
인증 주체
클라이언트(localStorage)
서버(httpOnly 쿠키 기반)
사용자 신원 검증
불가능 (memberId 신뢰)
토큰으로 검증 (Supabase 서버 검증)
SSR 지원
❌
✅ (middleware, 서버컴포넌트에서 세션 확인 가능)
보안성
XSS, 위조에 취약
httpOnly 쿠키로 보호
세션 만료 제어
불가능
Supabase 세션 만료 시간 관리

서버 사이드 렌더링(SSR)을 활용한 화면 깜빡임 현상 해결

앞서 인증/인가 프로세스를 httpOnly 쿠키 기반 방식으로 변경하면서, 서버 사이드에서 인증 상태를 확인할 수 있게 되었다. 이에 따라 헤더 컴포넌트를 서버 컴포넌트로 구현하고, 서버 사이드에서 인증 상태를 판별해 적절한 UI를 렌더링하도록 했다.
이제 인증 상태가 컴포넌트가 화면에 그려지기 전에 판별되므로 이전처럼 미인증 상태의 UI가 렌더링될 일이 없다.
import { Button } from "@/components/ui/button"; import MyButton from "@/features/shared/components/MyButton"; import { HEADER_HEIGHT } from "@/lib/data"; import { getServerUser } from "@/lib/supabase/server"; import { cn } from "@/lib/utils/utils"; import Link from "next/link"; import NavigationButton from "./NavigationButton"; export const dynamic = "force-dynamic"; export default async function Header() { const session = await getServerUser(); return ( <div className={cn("bg-black text-white flex p-2 items-center gap-4")} style={{ height: HEADER_HEIGHT }} > <div> <Link href="/">일을:하자</Link> </div> <div className="flex-1 rounded-3xl bg-gray-600 p-1 px-4">광고</div> <div> {session ? ( <div className="flex gap-1"> <NavigationButton /> <MyButton /> </div> ) : ( <Link href="/login"> <Button variant="outline" size="sm" className="text-white border-white/40" > 로그인 </Button> </Link> )} </div> </div> ); }
결과
결과
 
📚 일을:하자1 / 2
  1. 1편클라이언트(localStorage) 기반 인증에서 서버(httpOnly 쿠키) 기반 인증으로 개선하기(feat. Next.js+Supabase)2025년 11월 8일
  2. 2편프로젝트 일을:하자 - 1. 기획과 1차 MVP 배포2025년 11월 9일