Blog
관점

Node.js Express 인증: 개념, 방법 및 예제

인증은 웹 애플리케이션 보안의 기본 요소로, 사용자가 허가된 자원과 데이터에만 접근할 수 있도록 보장합니다. Node.js 생태계에서 Express는 인증 구현을 간소화하는 인기 있는 프레임워크입니다.

Young-jae

Young-jae

10 June 2025

Node.js Express 인증: 개념, 방법 및 예제

인증은 웹 애플리케이션을 보호하는 데 있어 기본적인 측면으로, 사용자가 권한이 있는 리소스와 데이터에만 접근할 수 있도록 보장합니다. Node.js 생태계에서 Express는 인증 구현을 단순화하는 인기 있는 프레임워크입니다. 이 블로그에서는 주요 인증 개념, Node.js 및 Express 애플리케이션에서 사용되는 일반적인 방법을 다루고, 시작하는 데 도움이 될 실용적인 예제를 제공합니다.

Node.js Express 인증 소개

Node.js Express 인증은 Express 프레임워크로 구축된 Node.js 애플리케이션에 접근하는 사용자의 신원을 확인하는 데 사용되는 방법과 관행을 의미합니다. 인증은 권한이 있는 사용자만 특정 리소스에 접근할 수 있도록 하여 보안을 제공하고 민감한 데이터를 보호합니다.

💡
Apidog은 강력한 API 개발 및 테스트 플랫폼일 뿐만 아니라, 인증 처리에 대한 광범위한 지원도 제공합니다. 이 기능은 API가 안전하고 권한이 있는 사용자만 접근할 수 있도록 보장하는 데 중요합니다.
버튼

인증 vs. 권한 부여

무상태 vs. 상태 기반 인증

일반적인 Node.js Express 인증 방법

1. 기본 인증

2. 토큰 기반 인증 (JWT)

3. 세션 기반 인증

4. OAuth2

5. 소셜 로그인

6. 다중 요소 인증 (MFA)

7. API 키 인증

8. LDAP 인증

9. SAML 인증

Node.js Express 인증 방법 선택하기

Node.js Express 애플리케이션에 적합한 인증 방법을 선택하는 것은 보안 요구사항, 사용자 경험 및 애플리케이션의 특정 사용 사례를 포함한 여러 요인에 따라 달라집니다. 다음은 각 인증 방법을 사용할 시기를 안내하는 가이드입니다:

1. 기본 인증

사용 시기:

장점:

단점:

2. 토큰 기반 인증 (JWT)

사용 시기:

장점:

단점:

3. 세션 기반 인증

사용 시기:

장점:

단점:

4. OAuth2

사용 시기:

장점:

단점:

5. 소셜 로그인

사용 시기:

장점:

단점:

6. 다중 요소 인증 (MFA)

사용 시기:

장점:

단점:

7. API 키 인증

사용 시기:

장점:

단점:

8. LDAP 인증

사용 시기:

장점:

단점:

9. SAML 인증

사용 시기:

장점:

단점:

인증 방법 선택 요약

Node.js Express 애플리케이션에 적합한 인증 방법을 선택하는 것은 다양한 옵션을 이해하고 애플리케이션의 특정 요구조건에 대해 평가하는 것을 포함합니다.

기본 인증: 중요하지 않은 애플리케이션에 빠르고 간단합니다.

토큰 기반 인증 (JWT): SPA, 모바일 앱 및 마이크로서비스에 적합합니다.

세션 기반 인증: 전통적인 웹 애플리케이션에 적합합니다.

OAuth2: 제 3자 통합 및 위임된 접근에 가장 적합합니다.

소셜 로그인: 사용자 경험을 개선하기 위한 소비자 중심 애플리케이션에 이상적입니다.

다중 요소 인증 (MFA): 고 보안 애플리케이션에 필수적입니다.

API 키 인증: 서비스 간 통신 및 공개 API에 유용합니다.

LDAP 인증: 중앙 집중식 사용자 관리가 필요한 기업 애플리케이션에 적합합니다.

SAML 인증: 기업 SSO 및 연합 신원 시스템에 사용됩니다.

적합한 방법 선택은 애플리케이션의 특정 요구, 보안 요구사항 및 사용자 경험 고려 사항에 달려 있습니다.

Node.js Express 인증 예제

인증은 사용자가 리소스에 안전하게 접근할 수 있도록 보장하는 모든 웹 애플리케이션의 중요한 부분입니다. Node.js Express 애플리케이션에서 인증을 구현하는 다양한 예제를 살펴보겠습니다. 가장 일반적인 방법인 JWT( JSON 웹 토큰), 세션 기반 인증, OAuth2 및 API 키를 포함하겠습니다.

1. JWT (JSON 웹 토큰) 인증

JWT는 당사자 간에 정보를 JSON 객체로 안전하게 전송할 수 있는 무상태 인증 방법입니다. 이 정보는 디지털 서명 때문에 검증되고 신뢰할 수 있습니다.

구현 단계:

1단계: 프로젝트 설정

먼저, 새 프로젝트를 만들고 필요한 종속성을 설치합니다:

mkdir jwt-auth-example
cd jwt-auth-example
npm init -y
npm install express jsonwebtoken body-parser bcryptjs

2단계: Express 서버 생성

app.js 파일을 만들고 기본 Express 서버를 설정합니다:

const express = require('express');
const jwt = require('jsonwebtoken');
const bodyParser = require('body-parser');
const bcrypt = require('bcryptjs');

const app = express();
app.use(bodyParser.json());

const SECRET_KEY = 'your_jwt_secret';

// Mock User Data
const users = [{ id: 1, username: 'user1', password: bcrypt.hashSync('password1', 8) }];

app.post('/login', (req, res) => {
  const { username, password } = req.body;
  const user = users.find(u => u.username === username);
  if (user && bcrypt.compareSync(password, user.password)) {
    const token = jwt.sign({ id: user.id, username: user.username }, SECRET_KEY, { expiresIn: '1h' });
    res.json({ token });
  } else {
    res.status(401).send('잘못된 자격 증명');
  }
});

const authenticateJWT = (req, res, next) => {
  const token = req.headers.authorization;
  if (token) {
    jwt.verify(token, SECRET_KEY, (err, user) => {
      if (err) {
        return res.sendStatus(403);
      }
      req.user = user;
      next();
    });
  } else {
    res.sendStatus(401);
  }
};

app.get('/protected', authenticateJWT, (req, res) => {
  res.send(`안녕하세요 ${req.user.username}, 보호된 경로에 접근했습니다!`);
});

const PORT = process.env.PORT || 3000;
app.listen(PORT, () => {
  console.log(`서버가 ${PORT} 포트에서 실행 중입니다.`);
});

2. 세션 기반 인증

세션 기반 인증은 서버 측에 세션 데이터를 저장하는 데 의존합니다. 이 방법은 상태 유지 방식이며 전통적인 웹 애플리케이션에서 일반적으로 사용됩니다.

구현 단계:

1단계: 프로젝트 설정

새 프로젝트를 만들고 필요한 종속성을 설치합니다:

mkdir session-auth-example
cd session-auth-example
npm init -y
npm install express express-session body-parser bcryptjs

2단계: Express 서버 생성

app.js 파일을 만들고 기본 Express 서버를 설정합니다:

const express = require('express');
const session = require('express-session');
const bodyParser = require('body-parser');
const bcrypt = require('bcryptjs');

const app = express();
app.use(bodyParser.json());
app.use(session({ secret: 'your_session_secret', resave: false, saveUninitialized: true }));

const users = [{ id: 1, username: 'user1', password: bcrypt.hashSync('password1', 8) }];

app.post('/login', (req, res) => {
  const { username, password } = req.body;
  const user = users.find(u => u.username === username);
  if (user && bcrypt.compareSync(password, user.password)) {
    req.session.userId = user.id;
    res.send('로그인되었습니다');
  } else {
    res.status(401).send('잘못된 자격 증명');
  }
});

const authenticateSession = (req, res, next) => {
  if (req.session.userId) {
    next();
  } else {
    res.sendStatus(401);
  }
};

app.get('/protected', authenticateSession, (req, res) => {
  const user = users.find(u => u.id === req.session.userId);
  res.send(`안녕하세요 ${user.username}, 보호된 경로에 접근했습니다!`);
});

const PORT = process.env.PORT || 3000;
app.listen(PORT, () => {
  console.log(`서버가 ${PORT} 포트에서 실행 중입니다.`);
});

3. OAuth2 인증

OAuth2는 사용자의 자격 증명을 노출하지 않고 제 3자 애플리케이션이 사용자 리소스에 접근할 수 있도록 허용하는 보다 복잡한 인증 방법입니다. 일반적으로 소셜 로그인 및 다른 서비스와의 통합에 사용됩니다.

구현 단계:

OAuth2를 구현하는 것은 보통 OAuth2 흐름을 처리하는 라이브러리나 프레임워크를 사용합니다. 간단함을 위해 passport 라이브러리와 passport-google-oauth20와 같은 전략을 사용할 것입니다.

1단계: 프로젝트 설정

새 프로젝트를 만들고 필요한 종속성을 설치합니다:

mkdir oauth2-auth-example
cd oauth2-auth-example
npm init -y
npm install express passport passport-google-oauth20 express-session

2단계: Express 서버 생성

app.js 파일을 만들고 기본 Express 서버를 설정합니다:

const express = require('express');
const passport = require('passport');
const GoogleStrategy = require('passport-google-oauth20').Strategy;
const session = require('express-session');

const app = express();

app.use(session({ secret: 'your_session_secret', resave: false, saveUninitialized: true }));
app.use(passport.initialize());
app.use(passport.session());

passport.use(new GoogleStrategy({
  clientID: 'YOUR_GOOGLE_CLIENT_ID',
  clientSecret: 'YOUR_GOOGLE_CLIENT_SECRET',
  callbackURL: 'http://localhost:3000/auth/google/callback'
}, (accessToken, refreshToken, profile, done) => {
  // 실제 애플리케이션에서는 프로필 정보를 데이터베이스에 저장합니다.
  return done(null, profile);
}));

passport.serializeUser((user, done) => {
  done(null, user);
});

passport.deserializeUser((obj, done) => {
  done(null, obj);
});

app.get('/auth/google', passport.authenticate('google', { scope: ['https://www.googleapis.com/auth/plus.login'] }));

app.get('/auth/google/callback', passport.authenticate('google', { failureRedirect: '/' }), (req, res) => {
  res.redirect('/protected');
});

const ensureAuthenticated = (req, res, next) => {
  if (req.isAuthenticated()) {
    return next();
  }
  res.redirect('/');
};

app.get('/protected', ensureAuthenticated, (req, res) => {
  res.send(`안녕하세요 ${req.user.displayName}, 보호된 경로에 접근했습니다!`);
});

const PORT = process.env.PORT || 3000;
app.listen(PORT, () => {
  console.log(`서버가 ${PORT} 포트에서 실행 중입니다.`);
});

4. API 키 인증

API 키 인증은 간단하며 일반적으로 서버 간 통신에 사용됩니다. 각 요청과 함께 키를 전달하여 클라이언트를 확인하는 것입니다.

구현 단계

1단계: 프로젝트 설정

새 프로젝트를 만들고 필요한 종속성을 설치합니다:

mkdir api-key-auth-example
cd api-key-auth-example
npm init -y
npm install express

2단계: Express 서버 생성

app.js 파일을 만들고 기본 Express 서버를 설정합니다:

const express = require('express');
const app = express();

const API_KEY = 'your_api_key';

const authenticateApiKey = (req, res, next) => {
  const apiKey = req.headers['x-api-key'];
  if (apiKey && apiKey === API_KEY) {
    next();
  } else {
    res.sendStatus(401);
  }
};

app.get('/protected', authenticateApiKey, (req, res) => {
  res.send('보호된 경로에 대한 접근이 허용되었습니다');
});

const PORT = process.env.PORT || 3000;
app.listen(PORT, () => {
  console.log(`서버가 ${PORT} 포트에서 실행 중입니다.`);
});

무상태 JWT 인증부터 전통적인 세션 기반 인증 및 제 3자 통합을 위한 OAuth2까지, 애플리케이션의 요구사항에 따라 선택할 수 있는 다양한 방법이 있습니다. 이러한 방법을 이해하고 올바르게 구현하면 안전하고 확장 가능한 애플리케이션을 구축할 수 있습니다.

Node.js Express 인증을 위한 10가지 모범 사례

Node.js Express 애플리케이션에서 인증을 구현하는 것은 보안, 확장성 및 사용 용이성을 보장하기 위해 신중한 고려가 필요합니다. 다음은 Node.js Express 애플리케이션에서 인증을 처리할 때 따라야 할 몇 가지 모범 사례입니다:

1. 강력한 비밀번호 해싱 사용

const bcrypt = require('bcryptjs');

const hashPassword = async (password) => {
    const salt = await bcrypt.genSalt(10);
    return await bcrypt.hash(password, salt);
};

2. JWT 토큰 안전하게 유지

const jwt = require('jsonwebtoken');
const SECRET_KEY = process.env.SECRET_KEY;

const token = jwt.sign({ userId: user.id }, SECRET_KEY, { expiresIn: '1h' });

3. HTTPS 사용

4. 입력 검증

const { body, validationResult } = require('express-validator');

app.post('/register', [
    body('email').isEmail(),
    body('password').isLength({ min: 6 })
], (req, res) => {
    const errors = validationResult(req);
    if (!errors.isEmpty()) {
        return res.status(400).json({ errors: errors.array() });
    }
    // 등록 진행
});

5. 속도 제한 구현

const rateLimit = require('express-rate-limit');

const limiter = rateLimit({
    windowMs: 15 * 60 * 1000, // 15 분
    max: 100 // 각 IP에 대해 15 분마다 100 요청 제한
});

app.use('/login', limiter);

6. 토큰을 안전하게 저장

7. 적절한 세션 관리 구현

8. 보호된 경로에 대한 미들웨어 사용

const authenticateJWT = (req, res, next) => {
    const token = req.headers.authorization;

    if (!token) {
        return res.sendStatus(401);
    }

    jwt.verify(token, SECRET_KEY, (err, user) => {
        if (err) {
            return res.sendStatus(403);
        }

        req.user = user;
        next();
    });
};

app.get('/protected', authenticateJWT, (req, res) => {
    res.send('이것은 보호된 경로입니다');
});

9. 인증 이벤트 모니터링 및 로그 작성

10. 종속성 정기적으로 업데이트

Node.js Express 인증 방법으로 API를 테스트하는 Apidog 활용

Apidog은 전체 개발 프로세스를 간소화하는 종합적인 API 개발 플랫폼입니다. 다양한 방법으로 API 엔드포인트를 테스트할 수 있도록 강력한 내장 인증 옵션을 제공하며, API 키, 베어러 토큰, JWT, 기본 인증, 다이제스트 인증, OAuth 1.0, OAuth 2.0, Hawk 인증, NTLM 및 Akamai EdgeGrid를 포함합니다. 이는 API 개발자가 구현된 인증 전략을 철저하게 검증할 수 있도록 합니다.

API 용 인증 방법

결론

Node.js Express 애플리케이션에서 인증을 구현하는 것은 웹 애플리케이션의 보안과 무결성을 보장하는 데 중요합니다. 기본 인증, JWT, OAuth2 및 LDAP와 같은 다양한 인증 방법을 이해하고 강력한 비밀번호 해싱 사용, JWT 토큰 보안 및 입력 검증과 같은 모범 사례를 따르면 강력하고 안전한 인증 시스템을 만들 수 있습니다. Apidog와 같은 도구는 이러한 인증 방법을 테스트하고 검증하는 능력을 더욱 향상시켜 이러한 방법이 의도한 대로 작동하도록 보장합니다. 애플리케이션의 요구에 맞는 올바른 인증 전략을 신중하게 선택하고 구현함으로써 민감한 데이터와 리소스를 효과적으로 보호하면서 안전하고 원활한 사용자 경험을 제공할 수 있습니다.

Explore more

Ollama 사용법: Ollama를 이용한 로컬 LLM 완전 초보 가이드

Ollama 사용법: Ollama를 이용한 로컬 LLM 완전 초보 가이드

인공지능의 세계는 끊임없이 발전하고 있으며, 대규모 언어 모델(LLM)은 점점 더 강력해지고 접근성이 높아지고 있습니다. 많은 사람들이 클라우드 기반 서비스를 통해 이러한 모델과 상호작용하지만, 개인 컴퓨터에서 직접 실행하는 데 초점을 맞추는 움직임이 커지고 있습니다. 바로 여기서 Ollama가 등장합니다. Ollama는 Llama 3, Mistral, Gemma, Phi 등 최첨단 LLM을 로컬에서 다운로드, 설정 및 실행하는 복잡한 과정을 획기적으로 단순화하도록 설계된 강력하면서도 사용자 친화적인 도구입니다. 이 포괄적인 가이드는 설치 및 기본 사용법부터 고급 사용자 지정, API 사용 및 필수 문제 해결까지 Ollama를 시작하는 데 필요한 모든 것을 안내합니다. 로컬 LLM을 애플리케이션에 통합하려는 개발자, 다양한 아키텍처를 실험하려는 연구원, 또는 오프라인에서 AI를 실행하는 데 관심이 있는 애호가이든 관계없이 Ollama는 간소화되고 효율적인 플랫폼을 제공합니다. �

28 April 2025

Swagger UI 한국어 무료 다운로드 위치

Swagger UI 한국어 무료 다운로드 위치

Swagger UI 한국어 인터페이스를 얻는 것의 어려움을 탐색하고 Apidog이 API 개발을 위한 강력한 플랫폼 대안인 이유를 알아보세요.

23 April 2025

무료 한국어 Postman 다운로드 방법

무료 한국어 Postman 다운로드 방법

Postman 한국어 버전을 무료로 다운로드할 수 있나요? Postman은 한국어를 네이티브로 지원하지 않지만, 해결 방법은 있습니다. 이 방법들을 살펴보고 언어에 관계없이 전체 API 워크플로우를 간소화하도록 설계된 강력하고 통합된 Postman 대안인 Apidog을 발견하십시오.

22 April 2025

Apidog에서 API 설계-첫 번째 연습

API를 더 쉽게 구축하고 사용하는 방법을 발견하세요

무료 회원가입다운로드