👤 사용자 인증 미들웨어

클라이언트로부터 전달받은 쿠키 검증. 쿠키안에 세션이 담겨있거나 jwt담겨있으면 그걸 이용해 사용자 조회를 하여 검증하는 미들웨어.

// src/middlewares/auth.middleware.js
import jwt from 'jsonwebtoken';
import { prisma } from '../utils/prisma/index.js';

export default async function (req, res, next) {
  try {
    //1. 클라이언트 -> 서버 : 쿠키 전달
    const { authorization } = req.cookies;
    if (!authorization) throw new Error('토큰이 존재하지 않습니다.');

    //2. 쿠키 : Bearer토큰 형식인지 확인
    const [tokenType, token] = authorization.split(' ');

    if (tokenType !== 'Bearer')
      throw new Error('토큰 타입이 일치하지 않습니다.');

    //3. 서버에서 발급한 JWT 맞는지 검증
    const decodedToken = jwt.verify(token, 'secretKey');
    const userId = decodedToken.userId;

    //4. JWT의 userId 이용 -> 사용자 조회
    const user = await prisma.users.findFirst({
      where: { userId: Number(userId) },
    });
    if (!user) {
      //비정상적이니까 쿠키 인증에 실패하면 해당 클라이언트의 쿠키를 삭제해줘야함.
      res.clearCookie('authorization');
      throw new Error('토큰 사용자가 존재하지 않습니다.');
    }

    //5. req.user에 사용자 정보 할당
    req.user = user;

    //6. 미들웨어 실행
    next();
  } catch (error) {
    //쿠키 인증에 실패하면 해당 클라이언트의 쿠키를 삭제해줘야함.
    res.clearCookie('authorization');

    // 토큰이 만료되었거나, 조작되었을 때, 에러 메시지를 다르게 출력합니다.
    switch (error.name) {
      case 'TokenExpiredError':
        return res.status(401).json({ message: '토큰이 만료되었습니다.' });
      case 'JsonWebTokenError':
        return res.status(401).json({ message: '토큰이 조작되었습니다.' });
      default:
        return res
          .status(401)
          .json({ message: error.message ?? '비정상적인 요청입니다.' });
    }
  }
}

---

📃 로그처리 미들웨어

클라이언트의 모든 요청 사항을 기록 -> 서버의 상태 모니터링 하기 위한 미들웨어.
다양한 로그레벨을 이용하여 특정 상황에 따라 출력하는 레벨을 다르게 구현 가능.

5단계 : silly
4단계 : debug
3단계 : verbose
2단계 : info
1단계 : warn
0단계 : error

단계별로 자신뿐만 아니라 그 아래의 로그까지 표현한다. (예시: info단계를 설정한다고 info만 나오는게 아니라 info, warn, error까지 로그 표현이 가능함)

winston 라이브러리 이용.

❗❗app.use 중 가장 처음에 로그처리 미들웨어를 넣어줘야한다.❗❗

# yarn을 이용해 winston을 설치
yarn add winston

// 클라이언트의 요청을 터미널에 기록하는 간단한 로그 미들웨어
// src/middlewares/log.middleware.js

import winston from 'winston';

const logger = winston.createLogger({
  level: 'info', // 로그 레벨을 'info'로 설정
  format: winston.format.json(), // 로그 포맷을 JSON 형식으로 설정
  transports: [
    new winston.transports.Console(), // 로그를 콘솔에 출력
  ],
});

export default function (req, res, next) {
  // 클라이언트의 요청이 시작된 시간을 기록합니다.
  const start = new Date().getTime();

  // 응답이 완료되면 로그를 기록합니다.
  res.on('finish', () => {
    const duration = new Date().getTime() - start;
    logger.info(
      `Method: ${req.method}, URL: ${req.url}, Status: ${res.statusCode}, Duration: ${duration}ms`,
    );
  });

  next();
}

// src/app.js

import LogMiddleware from './middlewares/log.middleware.js';

app.use(LogMiddleware); //로그미들웨어는 다른 미들웨어보다 먼저 실행되어야함.

[참고자료] https://coding8.tistory.com/39 https://ivvve.github.io/2020/05/31/js/js/winston-02-logging-level/

---

🦹 에러처리 미들웨어

express.js에서 발생한 에어를 통합적으로 처리하기 위한 미들웨어

❗❗app.use 중 가장 마지막에 에러 미들웨어를 넣어줘야한다. 안그럼 에러가 중간에 발생할 수 있음❗❗

// src/middlewares/error-handling.middleware.js

export default function (err, req, res, next) {
  // 에러를 출력합니다.
  console.error(err);

  // 클라이언트에게 에러 메시지를 전달합니다.
  res.status(500).json({ errorMessage: '서버 내부 에러가 발생했습니다.' });
}

//API 파일 내 try catch문 중 err를 아래와 같이 next(err)로 넘겨준다.
} catch (err) {
    next(err);
  }
});

// src/app.js

import ErrorHandlingMiddleware from './middlewares/error-handling.middleware.js';

app.use(LogMiddleware);
app.use(express.json());
app.use(cookieParser());
app.use('/api', [UsersRouter]);
app.use(ErrorHandlingMiddleware); //에러미들웨어는 맨 마지막에 위치해야함!