Guards یہ طے کرتے ہیں کہ آیا ایک request کو route handler تک رسائی کی اجازت ہے — یہ NestJS کا authorization (اور اکثر authentication کی جانچ) کے لیے مخصوص طریقہ ہے۔ ایک guard true واپس کرتا ہے request کو منظور کرنے کے لیے یا false/exception پھینکتا ہے اسے روکنے کے لیے۔
@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 canActivate() کو implement کرتا ہے، جو ایک boolean (یا اس کا Promise/Observable) واپس کرتا ہے۔ false واپس کرنے سے request 403 کے ساتھ روک دی جاتی ہے؛ آپ ایک مخصوص exception بھی پھینک سکتے ہیں (مثال کے طور پر 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 کو method، controller، یا global level پر لاگو کیا جا سکتا ہے۔
@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
}
}
ایک @Roles() decorator (metadata) کو ایک guard کے ساتھ ملانا جو اسے پڑھتا ہے (via Reflector) role-based access control کے لیے معیاری pattern ہے۔
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 NestJS میں authorization کے لیے مخصوص، اصول پر عمل کرنے والا طریقہ ہیں — یہ کنٹرول کرتے ہیں کہ کون سی requests authentication اور permissions کی بنیاد پر handlers تک رسائی حاصل کرنے کی اجازت پائیں۔
ان کو سمجھنا ضروری ہے کیونکہ تقریباً ہر حقیقی application کو routes کو محفوظ رکھنے کی ضرورت ہے (login کی ضرورت، roles/permissions کی جانچ)، اور guards اس کے لیے صحیح tool ہیں (middleware یا ہر handler میں auth logic ڈالنے سے بہت بہتر)۔
معیاری patterns — ایک JWT/auth guard جو credentials کی تصدیق کرتا ہے اور user کو request سے منسلک کرتا ہے، اور role-based guards جو @Roles() decorator کو Reflector-reading guard کے ساتھ RBAC کے لیے ملاتے ہیں — NestJS APIs کو محفوظ کرنے کے لیے بنیادی ہیں۔
Guards کی ExecutionContext تک رسائی (target handler، class، اور request کو جاننا) وہی چیز ہے جو انہیں authorization decisions کے لیے موزوں بناتی ہے جو middleware صاف طریقے سے نہیں کر سکتا۔
Guards کو لکھنا، لاگو کرنا (method/controller/global)، اور انہیں metadata decorators کے ساتھ ملانا سیکھنا محفوظ NestJS applications بنانے کے لیے بنیادی علم ہے اور framework میں ایک بار بار آنے والا، architecturally-اہم موضوع ہے۔