Guards jiddeterminaw jekk it-talba tista' tprocedi lejn l-handler tar-rotta — huma s-sett dedikati ta' NestJS għal autorizzazzjoni (u ħafna drabi wkoll għall-iċċekkjar tal-awtentikazzjoni). Guard jirritorna true biex tippermetti t-talba jew false/itmexxi eċċezzjoni biex timblukkaha.
@Injectable()
export class AuthGuard implements CanActivate {
canActivate(context: ExecutionContext): boolean {
const request = context.switchToHttp().getRequest();
return !!request.headers.authorization; // true = allow, false = block (403)
}
}
Guard jimplimenta canActivate(), li jirritorna boolean (jew Promise/Observable tiegħu). Jekk tirritorna false t-talba tinblukkja bi 403; tista' wkoll titmexxi eċċezzjoni speċifika (eż. UnauthorizedException).
@UseGuards(AuthGuard) // on a single route
@Get("profile")
getProfile() {}
@UseGuards(AuthGuard) // on a whole controller (all routes)
@Controller("admin")
export class AdminController {}
app.useGlobalGuards(new AuthGuard()); // globally (all routes)
Guards jistgħu jiġu applikati fil-livell tal-metodu, controller, jew globali.
@Injectable()
export class JwtAuthGuard implements CanActivate {
constructor(private jwtService: JwtService) {}
async canActivate(context: ExecutionContext): Promise<boolean> {
const request = context.switchToHttp().getRequest();
const token = request.headers.authorization?.split(" ")[1];
if (!token) throw new UnauthorizedException();
try {
request.user = await this.jwtService.verifyAsync(token); // attach the user
return true;
} catch {
throw new UnauthorizedException("Invalid token");
}
}
}
// a @Roles decorator stores required roles as metadata
@Roles("admin")
@Get("users")
listUsers() {}
// the RolesGuard reads the metadata and checks the user's roles
@Injectable()
export class RolesGuard implements CanActivate {
constructor(private reflector: Reflector) {}
canActivate(ctx: ExecutionContext): boolean {
const roles = this.reflector.get<string[]>("roles", ctx.getHandler());
const { user } = ctx.switchToHttp().getRequest();
return roles.some(role => user.roles?.includes(role)); // allow if the user has a required role
}
}
L-għaqdis tad-dekorattur @Roles() (metadata) ma guard li jaqrahu (permezz ta' Reflector) huwa l-mudell standard għall-kontroll ta' aċċess ibbażat fuq ir-rwoli.
The ExecutionContext gives guards rich info (the handler, class, request) — more
than plain middleware — which is why guards (not middleware) are the right place
for authorization decisions.
Guards humu l-mekkaniżmu dedikati u idiomatiku ta' NestJS għall-autorizzazzjoni — jikkontrolla liema talbiet ippermisi jilħqu l-handlers bbażat fuq l-awtentikazzjoni u l-permessi.
Fhimu huwa essenzjali għax kull applikazzjoni vera ta' bosta għandhom bżonn jipprotezzaw ir-rotot (jeħtieġu login, iċċekkja r-rwoli/permessi), u guards humu l-għodda korretta għall-dan (ħafna aktar nadif milli jtiqu loġika ta' awtentikazzjoni fit-tmexxija jew f'kull handler).
Il-mudelli standard — guard ta' JWT/awtentikazzjoni li jivverrifika l-kredenzjali u jgħadd l-utent it-talba, u guards ibbażati fuq ir-rwoli li jġunxu d-dekorattur @Roles() ma guard li jaqra Reflector għal RBAC — huma fundamentali biex tissikulaw l-APIs ta' NestJS.
L-aċċess tal-guards għall-ExecutionContext għani (taf l-handler tal-mira, il-klassi, u t-talba) huwa preċiżament dak li jagħmilhom xierqa għad-deċiżjonijiet ta' autorizzazzjoni li l-middleware ma jista' jagħmel b'mod nadif.
Taf kif tiktib, tapplifka (metodu/controller/globali), u tgħadd guards ma dekoratturs ta' metadata huwa l-għarif essenzjali għall-kostruzzjoni ta' applikazzjonijiet siguri ta' NestJS u suġġett frekwenti, importanti mill-lat ta' l-arkitettura, fil-framework.