JWT 기반 인증 시스템 구축

npm install @nestjs/jwt passport-jwt @types/passport-jwt

import { Module } from '@nestjs/common';
import { AuthService } from './auth.service';
import { LocalStrategy } from './strategies/local.strategy';
import { JwtStrategy } from './strategies/jwt.strategy'; // 새로 추가할 JWT 전략
import { UsersModule } from '../users/users.module';
import { PassportModule } from '@nestjs/passport';
import { JwtModule } from '@nestjs/jwt'; // JWT 모듈 임포트
import { AuthController } from './auth.controller';
import { ConfigModule, ConfigService } from '@nestjs/config'; // 환경 변수 사용을 위해 추가

@Module({
  imports: [
    UsersModule,
    PassportModule,
    ConfigModule, // 환경 변수 모듈 임포트
    JwtModule.registerAsync({ // JWT 모듈 비동기 등록 (ConfigService 사용 위함)
      imports: [ConfigModule],
      useFactory: async (configService: ConfigService) => ({
        secret: configService.get<string>('JWT_SECRET'), // 환경 변수에서 JWT 비밀 키 가져오기
        signOptions: { expiresIn: '60s' }, // 토큰 만료 시간 (예: 60초)
      }),
      inject: [ConfigService],
    }),
  ],
  providers: [AuthService, LocalStrategy, JwtStrategy], // JwtStrategy 추가
  controllers: [AuthController],
  exports: [AuthService], // AuthService를 다른 모듈에서 사용하려면 export
})
export class AuthModule {}

import { Injectable } from '@nestjs/common';
import { UsersService } from '../users/users.service';
import { JwtService } from '@nestjs/jwt'; // JwtService 임포트

@Injectable()
export class AuthService {
  constructor(
    private usersService: UsersService,
    private jwtService: JwtService, // JwtService 주입
  ) {}

  async validateUser(username: string, pass: string): Promise<any> {
    const user = await this.usersService.findOne(username);
    if (user && user.password === pass) {
      const { password, ...result } = user;
      return result;
    }
    return null;
  }

  // 사용자 정보를 기반으로 JWT를 발급하는 메서드
  async login(user: any) {
    const payload = { username: user.username, sub: user.userId, roles: user.roles }; // JWT에 포함할 페이로드
    return {
      access_token: this.jwtService.sign(payload), // 페이로드로 JWT 생성 및 반환
    };
  }
}

import { ExtractJwt, Strategy } from 'passport-jwt';
import { PassportStrategy } from '@nestjs/passport';
import { Injectable } from '@nestjs/common';
import { ConfigService } from '@nestjs/config'; // 환경 변수 사용을 위해 추가

@Injectable()
export class JwtStrategy extends PassportStrategy(Strategy) {
  constructor(private configService: ConfigService) { // ConfigService 주입
    super({
      jwtFromRequest: ExtractJwt.fromAuthHeaderAsBearerToken(), // Request 헤더의 Bearer 토큰에서 JWT 추출
      ignoreExpiration: false, // 만료된 토큰은 무시하지 않고 유효성 검사 실패 처리
      secretOrKey: configService.get<string>('JWT_SECRET'), // JWT 서명에 사용된 비밀 키
    });
  }

  // validate 메서드는 토큰이 유효하게 검증되면 호출됩니다.
  // 페이로드(payload)를 인자로 받아, 필요한 사용자 정보를 반환합니다.
  async validate(payload: any) {
    // 실제로는 payload.sub (userId)를 사용하여 데이터베이스에서 사용자 정보를 조회할 수 있습니다.
    // 여기서는 간단히 페이로드에 있는 정보를 그대로 반환합니다.
    return { userId: payload.sub, username: payload.username, roles: payload.roles };
  }
}

# .env
JWT_SECRET=super_secret_jwt_key_that_no_one_knows_but_me

import { Controller, Post, Request, UseGuards, Get } from '@nestjs/common';
import { AuthGuard } from '@nestjs/passport';
import { AuthService } from './auth.service';

@Controller('auth')
export class AuthController {
  constructor(private authService: AuthService) {}

  @UseGuards(AuthGuard('local')) // 로컬 전략을 사용하여 로그인 처리
  @Post('login')
  async login(@Request() req) {
    // req.user는 LocalStrategy.validate()에서 반환된 사용자 정보입니다.
    return this.authService.login(req.user); // JWT 발급
  }

  // 'jwt' 전략을 사용하여 보호된 리소스에 접근하는 예시
  @UseGuards(AuthGuard('jwt')) // JWT 전략을 사용하여 요청을 보호합니다.
  @Get('profile')
  getProfile(@Request() req) {
    // req.user는 JwtStrategy.validate()에서 반환된 사용자 정보입니다.
    return req.user;
  }
}