Node.js 로그인 시스템 구축과 인증 모듈 활용

안녕하세요! 이번 포스트에서는 Node.js를 이용하여 로그인 시스템을 구축하고, 인증을 위한 Passport 모듈의 활용 방법을 자세히 살펴보겠습니다. 웹 애플리케이션에서 사용자 인증은 필수적인 요소로, 이를 통해 사용자는 자신의 정보와 자원에 접근할 수 있게 됩니다. Passport는 이러한 과정을 단순화하고, 다양한 인증 전략을 지원하는 훌륭한 미들웨어입니다.

Node.js와 Passport 소개

Node.js는 비동기 이벤트 구동 환경을 기반으로 한 JavaScript 실행 플랫폼으로, 서버 사이드 애플리케이션 개발에 매우 유용합니다. Passport는 Node.js에서 사용하는 인증 미들웨어로, 로컬 로그인, 소셜 로그인 등 다양한 인증 방법을 지원합니다. 특히, Passport의 장점 중 하나는 사용자가 선호하는 전략을 쉽게 추가하고 설정할 수 있다는 점입니다.

Passport 설치하기

Node.js 프로젝트에서 Passport를 사용하기 위해서는 먼저 관련 패키지를 설치해야 합니다. 다음과 같은 명령어를 사용하여 설치할 수 있습니다:

npm install passport passport-local express-session

이제 필요한 모듈이 준비되었으니, 본격적으로 로그인 시스템을 구현해보겠습니다.

로그인 시스템 구현하기

우선, Node.js 애플리케이션을 설정합니다. 기본적인 Express 서버를 생성한 후, Passport를 설정하여 로그인 기능을 구현하는 과정입니다.

Express와 Passport 설정

Node.js 애플리케이션에서 Express와 Passport를 설정하는 방법은 다음과 같습니다:

const express = require('express');
const passport = require('passport');
const session = require('express-session');
const LocalStrategy = require('passport-local').Strategy;
const app = express();
// 세션 설정
app.use(session({ secret: 'yourSecretKey', resave: false, saveUninitialized: false }));
app.use(passport.initialize());
app.use(passport.session());

여기서 express-session을 통해 세션을 설정하고 초기화한 상태에서 Passport를 사용할 준비를 완료했습니다. 이 과정은 사용자가 로그인한 이후에도 세션을 유지하게 해줍니다.

사용자 인증 전략 설정

이제 Passport의 로컬 전략을 설정하여 사용자 인증 로직을 추가합니다. 예를 들어, 사용자 이름과 비밀번호를 활용하여 인증하는 전략을 다음과 같이 구현할 수 있습니다:

passport.use(new LocalStrategy({
  usernameField: 'email',
  passwordField: 'pwd'
 },
 function(email, password, done) {
  // 사용자 데이터베이스에서 사용자 찾기
  User.findOne({ email: email }, function(err, user) {
   if (err) {
    return done(err);
   }
   if (!user || !user.validPassword(password)) {
    return done(null, false, { message: '잘못된 사용자 이름 또는 비밀번호입니다.' });
   }
   return done(null, user);
  });
 }
));

로그인 및 로그아웃 처리

사용자가 로그인 요청을 할 때, Passport의 authenticate 메서드를 통해 인증 과정을 진행합니다. 예를 들어, 로그인 라우트를 다음과 같이 설정할 수 있습니다:

app.post('/auth/login', passport.authenticate('local', {
  successRedirect: '/',
  failureRedirect: '/auth/login'
}));

위 코드에서는 로그인 성공 시 메인 페이지로 리디렉션되고, 실패 시 로그인 페이지로 되돌아갑니다. 사용자가 로그인을 성공하면, 해당 사용자의 정보를 세션에 저장하게 됩니다.

로그아웃 처리 구현

로그아웃 기능은 사용자가 로그아웃 요청을 할 때 세션을 삭제하고, 메인 페이지로 리다이렉션하는 방식으로 구현할 수 있습니다:

app.post('/logout', function(req, res) {
  req.logout();
  res.redirect('/');
});

이 코드에서는 req.logout() 메서드를 호출하여 현재 사용자 세션을 종료하고, 사용자를 메인 페이지로 이동시킵니다.

세션 관리와 사용자 정보 저장

로그인 이후 사용자 정보를 세션으로 유지하기 위해 Passport는 serializeUser와 deserializeUser 메서드를 사용합니다. 이 두 메서드는 세션에 사용자 정보를 저장하고, 필요한 경우 해당 정보를 조회하는 역할을 합니다.

passport.serializeUser(function(user, done) {
  done(null, user.id); // 세션에 사용자 ID 저장
});
passport.deserializeUser(function(id, done) {
  User.findById(id, function(err, user) {
    done(err, user); // 사용자 정보를 가져와 요청에 추가
  });
});

이 과정을 통해 사용자는 세션 유지 및 관리가 가능하며, 로그인이 필요한 페이지에 접근할 수 있게 됩니다.

마무리

이번 포스팅에서는 Node.js와 Passport를 활용하여 로그인 시스템을 구축하는 방법을 살펴보았습니다. 인증 과정은 웹 애플리케이션 개발에 있어서 매우 중요한 요소이며, Passport는 이를 보다 간단하고 효율적으로 처리할 수 있도록 도와주는 훌륭한 도구입니다. 앞으로도 다양한 인증 방법과 전략을 활용하여 더 나은 사용자 경험을 제공할 수 있기를 바랍니다.

자주 묻는 질문 FAQ