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
- Hashing unidireccional con
bcrypt: Jamás almacenes contraseñas en texto plano. Usaawait bcrypt.hash(password, 10)al registrar yawait bcrypt.compare(plana, hash)al iniciar sesión. - 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.1ho1d). - Estrategia de Verificación (
JwtStrategy): Extrae el token Bearer del encabezado HTTP, verifica que la firma criptográfica coincida conJWT_SECRETy adjunta el usuario decodificado areq.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:
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ónEn 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.