Tema 13 · Autenticación JWT

13. Autenticación Profesional con @nestjs/jwt, Passport Strategies y Hashing con bcrypt

Construye un módulo Auth completo: hash seguro de contraseñas con bcrypt, emisión de Access Tokens JWT y estrategia de validación JwtStrategy.

Arquitectura de Autenticación Stateless con JWT en NestJS

En APIs modernas, la autenticación sin estado (Stateless) se implementa mediante JSON Web Tokens (JWT) firmados criptográficamente. NestJS integra los paquetes oficiales @nestjs/jwt y @nestjs/passport para estandarizar tanto la emisión del token en el login como la verificación de la cabecera Authorization: Bearer <token> en cada ruta privada.

npm i @nestjs/jwt @nestjs/passport passport passport-jwt bcrypt
npm i -D @types/passport-jwt @types/bcrypt

Los 3 Pilares del Módulo Auth

  1. Hashing unidireccional con bcrypt: Jamás almacenes contraseñas en texto plano. Usa await bcrypt.hash(password, 10) al registrar y await bcrypt.compare(plana, hash) al iniciar sesión.
  2. Emisión de Token (JwtService.signAsync): Al validar las credenciales, firmas un payload ligero (sub: usuario.id, email, rol) con tiempo de expiración corto (ej. 1h o 1d).
  3. Estrategia de Verificación (JwtStrategy): Extrae el token Bearer del encabezado HTTP, verifica que la firma criptográfica coincida con JWT_SECRET y adjunta el usuario decodificado a req.user.

⚡ Servicio de Autenticación y Estrategia Passport JWT

Validación de contraseña con bcrypt, firma del token JWT y extracción automática en req.user:

src/auth/auth.service.ts
Solo lectura
import { Injectable, UnauthorizedException } from '@nestjs/common';
import { JwtService } from '@nestjs/jwt';
import { PassportStrategy } from '@nestjs/passport';
import { ExtractJwt, Strategy } from 'passport-jwt';
import { ConfigService } from '@nestjs/config';
import * as bcrypt from 'bcrypt';

export interface JwtPayload {
  sub: number;
  email: string;
  rol: 'student' | 'instructor' | 'admin';
}

@Injectable()
export class AuthService {
  constructor(private readonly jwtService: JwtService) {}

  async iniciarSesion(
    email: string,
    clavePlana: string,
    usuarioDb: { id: number; email: string; passwordHash: string; rol: 'student' | 'instructor' | 'admin' },
  ) {
    const coincide = await bcrypt.compare(clavePlana, usuarioDb.passwordHash);
    if (!coincide) {
      throw new UnauthorizedException('Credenciales de acceso inválidas.');
    }

    const payload: JwtPayload = {
      sub: usuarioDb.id,
      email: usuarioDb.email,
      rol: usuarioDb.rol,
    };

    return {
      accessToken: await this.jwtService.signAsync(payload),
      usuario: { id: usuarioDb.id, email: usuarioDb.email, rol: usuarioDb.rol },
    };
  }
}

@Injectable()
export class JwtStrategy extends PassportStrategy(Strategy) {
  constructor(config: ConfigService) {
    super({
      jwtFromRequest: ExtractJwt.fromAuthHeaderAsBearerToken(),
      ignoreExpiration: false,
      secretOrKey: config.getOrThrow<string>('JWT_SECRET'),
    });
  }

  // Lo que retorna validate() se inyecta automáticamente en request.user
  validate(payload: JwtPayload) {
    return { userId: payload.sub, email: payload.email, rol: payload.rol };
  }
}
🧠
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección
1 Pregunta
Pregunta 1
En una estrategia que extiende PassportStrategy(Strategy) de passport-jwt en NestJS, ¿qué hace el framework con el objeto que retornas dentro del método validate(payload)?
🦉
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.

🚀 ¿Quieres dominar NestJS Framework Profesional y crear proyectos reales?

Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.