• 목차
• 🟥 Epic 1 — Task (Login)
  • 🔐 FastAPI 로그인 기능 설계 및 구현
    • 📌 작업 개요
    • 🎯 작업 목적
    • 🛠️ 진행 내용
      • 🗂️ 1. 사용자 모델 생성 (app/models/user.py)
      • 🗂️ 2. 비밀번호 해시 유틸 생성 (app/core/security.py)
      • 🗂️ 3. JWT 토큰 발급 기능 생성 (app/core/jwt.py)
      • 🗂️ 4. 로그인 API 생성 (app/routers/auth.py)
      • 🗂️ 5. main.py에 라우터 등록
      • 🗂️ 6. test_main.http로 로그인 테스트
    • 📌 산출물

🟥 Epic 1 — Task (Login)¶

🔐 FastAPI 로그인 기능 설계 및 구현¶

📌 작업 개요¶

mgmt 서버에 접근하는 모든 기능(서버 상태 조회, 제어, reverse SSH 등)은

인증된 사용자만 사용할 수 있어야 한다.

따라서 FastAPI 기반의 JWT 로그인 시스템을 구축하여

API 접근을 안전하게 보호하는 인증 레이어를 만든다.

이 작업은 전체 시스템의 보안 기반이 되는 핵심 단계이다.

🎯 작업 목적¶

• FastAPI에서 JWT 기반 로그인 기능을 구현한다.

• /login 엔드포인트를 생성하여 사용자 인증을 처리한다.

• 비밀번호는 해시(SHA256 또는 bcrypt)로 저장한다.

• 로그인 성공 시 Access Token(JWT)을 발급한다.

• 이후 모든 API에서 Authorization: Bearer 방식으로 인증을 적용한다.

🛠️ 진행 내용¶

🗂️ 1. 사용자 모델 생성 (app/models/user.py)¶

로그인 기능을 위해 사용자 테이블을 생성한다.

# app/models/user.py

from sqlalchemy import Column, String
from app.db import Base

class User(Base):
    __tablename__ = "user"

    username = Column(String(50), primary_key=True)
    password_hash = Column(String(200))

📌 설계 포인트

• 비밀번호는 절대 평문 저장 금지

• username을 PK로 설정하여 간단한 인증 구조 유지

🗂️ 2. 비밀번호 해시 유틸 생성 (app/core/security.py)¶

# app/core/security.py

import hashlib

def hash_password(password: str) -> str:
    return hashlib.sha256(password.encode()).hexdigest()

def verify_password(password: str, hashed: str) -> bool:
    return hash_password(password) == hashed

📌 bcrypt로 바꿀 수도 있지만

Park mgmt 서버는 내부용이라 SHA256도 충분함.

🗂️ 3. JWT 토큰 발급 기능 생성 (app/core/jwt.py)¶

# app/core/jwt.py

from datetime import datetime, timedelta
from jose import jwt

SECRET_KEY = "park-secret-key"
ALGORITHM = "HS256"

def create_access_token(username: str):
    expire = datetime.utcnow() + timedelta(hours=12)
    payload = {"sub": username, "exp": expire}
    return jwt.encode(payload, SECRET_KEY, algorithm=ALGORITHM)

📌 12시간 토큰

📌 HS256

📌 jose 라이브러리 사용

🗂️ 4. 로그인 API 생성 (app/routers/auth.py)¶

# app/routers/auth.py

from fastapi import APIRouter, HTTPException, Depends
from sqlalchemy.orm import Session

from app.db import SessionLocal
from app.models.user import User
from app.core.security import verify_password
from app.core.jwt import create_access_token

router = APIRouter()

def get_db():
    db = SessionLocal()
    try:
        yield db
    finally:
        db.close()

@router.post("/login")
def login(username: str, password: str, db: Session = Depends(get_db)):
    user = db.query(User).filter(User.username == username).first()

    if not user or not verify_password(password, user.password_hash):
        raise HTTPException(status_code=401, detail="Invalid credentials")

    token = create_access_token(username)
    return {"access_token": token, "token_type": "bearer"}

🗂️ 5. main.py에 라우터 등록¶

from fastapi import FastAPI
from app.routers import auth

app = FastAPI()
app.include_router(auth.router)

🗂️ 6. test_main.http로 로그인 테스트¶

### Login Test
POST http://127.0.0.1:8000/login
Content-Type: application/json

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

📌 산출물¶

• 사용자 모델 생성 (user.py)

• 비밀번호 해시 기능 (security.py)

• JWT 발급 기능 (jwt.py)

• /login API 구현

• test_main.http로 로그인 테스트 완료

• 인증 기반 구축 완료