• 목차
• 🟥 Epic 1 — Task (Auth Extension)
  • 🧑‍💻 /me & /logout 구현
    • 📌 작업 개요
  • 🛠️ 1. JWT 인증 미들웨어 만들기
  • 🛠️ 2. /me API 구현
  • 🛠️ 3. /logout API 구현
  • 🧪 4. test_main.http 테스트

🟥 Epic 1 — Task (Auth Extension)¶

🧑‍💻 /me & /logout 구현¶

📌 작업 개요¶

로그인 기능을 확장하여

• 현재 로그인한 사용자 정보를 반환하는 /me

• 클라이언트 측에서 토큰을 폐기하는 /logout

  API를 구현한다.

이 두 기능은 DB 연결 없이도 JWT만으로 테스트 가능하다.

🛠️ 1. JWT 인증 미들웨어 만들기¶

📁 app/core/auth.py

from fastapi import Depends, HTTPException
from fastapi.security import OAuth2PasswordBearer
from jose import jwt, JWTError

from app.core.jwt import SECRET_KEY, ALGORITHM

oauth2_scheme = OAuth2PasswordBearer(tokenUrl="login")

def get_current_user(token: str = Depends(oauth2_scheme)):
    try:
        payload = jwt.decode(token, SECRET_KEY, algorithms=[ALGORITHM])
        username: str = payload.get("sub")

        if username is None:
            raise HTTPException(status_code=401, detail="Invalid token")

        return username

    except JWTError:
        raise HTTPException(status_code=401, detail="Invalid or expired token")

📌 DB 없이도 username을 JWT에서 바로 꺼낼 수 있음

🛠️ 2. /me API 구현¶

📁 app/routers/auth.py에 추가

@router.get("/me")
def me(current_user: str = Depends(get_current_user)):
    return {"username": current_user}

📌 JWT만 있으면 바로 테스트 가능
📌 DB 연결 필요 없음

🛠️ 3. /logout API 구현¶

FastAPI는 서버에서 JWT를 강제로 무효화할 수 없다.

JWT는 “서버가 기억하지 않는 토큰”이기 때문.

그래서 일반적인 방식은:

✔ 클라이언트가 토큰을 버리는 방식

→ /logout은 그냥 “성공”만 반환하면 됨.

@router.post("/logout")
def logout():
    return {"detail": "Logged out. Please delete your token on client side."}

📌 클라이언트(PWA, 앱, 웹)에서 토큰을 삭제하면 로그아웃 완료

📌 서버는 토큰을 저장하지 않기 때문에 “무효화”라는 개념이 없음

🧪 4. test_main.http 테스트¶

DB 없어도 바로 테스트 가능

### Login (DB 연결 후 테스트)
POST http://127.0.0.1:8000/login
Content-Type: application/json

{
  "username": "admin",
  "password": "1234"
}

### Me Test
GET http://127.0.0.1:8000/me
Authorization: Bearer {{token}}

### Logout Test
POST http://127.0.0.1:8000/logout

📌 산출물

• JWT 인증 미들웨어 (get_current_user)

• /me API 구현

• /logout API 구현

• DB 없이도 테스트 가능한 인증 흐름 완성