TK-FB-Project/api.hyungi.net/config/middleware.js

/**
 * 미들웨어 설정
 *
 * Express 애플리케이션의 모든 미들웨어를 등록하는 중앙화된 설정 파일
 *
 * @author TK-FB-Project
 * @since 2025-12-11
 */

const express = require('express');
const cors = require('cors');
const helmet = require('helmet');
const compression = require('compression');
const path = require('path');
const helmetOptions = require('./security');
const corsOptions = require('./cors');
const { responseMiddleware } = require('../utils/responseFormatter');
const logger = require('../utils/logger');

/**
 * 모든 미들웨어를 Express 앱에 등록
 * @param {Express.Application} app - Express 애플리케이션 인스턴스
 */
function setupMiddlewares(app) {
  // 보안 헤더 설정 (Helmet)
  app.use(helmet(helmetOptions));

  // 성능 최적화 - Compression
  app.use(compression({
    filter: (req, res) => {
      if (req.headers['x-no-compression']) {
        return false;
      }
      return compression.filter(req, res);
    },
    level: 6, // 압축 레벨 (1-9, 6이 기본값)
    threshold: 1024 // 1KB 이상만 압축
  }));

  // 요청 바디 파싱 - 용량 제한 확장
  app.use(express.urlencoded({ extended: true, limit: '50mb' }));
  app.use(express.json({ limit: '50mb' }));

  // 응답 포맷터 미들웨어
  app.use(responseMiddleware);

  // CORS 설정
  app.use(cors(corsOptions));

  // 정적 파일 서빙
  app.use(express.static(path.join(__dirname, '../public')));
  app.use('/uploads', express.static(path.join(__dirname, '../uploads')));

  // Rate Limiting - API 요청 제한
  const rateLimit = require('express-rate-limit');

  // 일반 API 요청 제한
  const apiLimiter = rateLimit({
    windowMs: 15 * 60 * 1000, // 15분
    max: 1000, // IP당 최대 1000 요청 (일괄 처리 지원)
    message: {
      success: false,
      error: '너무 많은 요청입니다. 잠시 후 다시 시도해주세요.',
      code: 'RATE_LIMIT_EXCEEDED'
    },
    standardHeaders: true,
    legacyHeaders: false,
    // 인증된 사용자는 더 많은 요청 허용
    skip: (req) => {
      // Authorization 헤더가 있으면 Rate Limit 완화
      return req.headers.authorization && req.headers.authorization.startsWith('Bearer ');
    }
  });

  // 로그인 시도 제한 (브루트포스 방지)
  const loginLimiter = rateLimit({
    windowMs: 15 * 60 * 1000, // 15분
    max: 10, // IP당 최대 10회 로그인 시도
    message: {
      success: false,
      error: '로그인 시도 횟수를 초과했습니다. 15분 후 다시 시도해주세요.',
      code: 'LOGIN_RATE_LIMIT_EXCEEDED'
    },
    standardHeaders: true,
    legacyHeaders: false
  });

  // Rate limiter 적용
  app.use('/api/', apiLimiter);
  app.use('/api/auth/login', loginLimiter);

  logger.info('Rate Limiting 설정 완료');

  // CSRF Protection (선택적 - 필요 시 주석 해제)
  // const { verifyCsrfToken, getCsrfToken } = require('../middlewares/csrf');
  //
  // CSRF 토큰 발급 엔드포인트
  // app.get('/api/csrf-token', getCsrfToken);
  //
  // CSRF 검증 미들웨어 (로그인 등 일부 경로 제외)
  // app.use('/api/', verifyCsrfToken({
  //   ignorePaths: [
  //     '/api/auth/login',
  //     '/api/auth/register',
  //     '/api/health',
  //     '/api/csrf-token'
  //   ]
  // }));
  //
  // logger.info('CSRF Protection 설정 완료');

  logger.info('미들웨어 설정 완료');
}

module.exports = setupMiddlewares;