Guards নির্ধারণ করে যে একটি অনুরোধ রুট হ্যান্ডলারে প্রবেশ করতে অনুমতিপ্রাপ্ত — এগুলি NestJS-এর authorization-এর জন্য নিবেদিত প্রক্রিয়া (এবং প্রায়শই মূলতন্ত্র পরীক্ষা)। একটি Guard অনুরোধ অনুমতি দিতে true প্রদান করে বা অবরুদ্ধ করতে false/ব্যতিক্রম ফেলে।
@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() বাস্তবায়ন করে, যা একটি boolean (বা তার Promise/Observable) প্রদান করে। false প্রদান করা একটি 403 সহ অনুরোধ অবরুদ্ধ করে; আপনি একটি নির্দিষ্ট ব্যতিক্রমও ফেলতে পারেন (যেমন 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 পদ্ধতি, নিয়ন্ত্রক, বা বৈশ্বিক স্তরে প্রয়োগ করা যেতে পারে।
@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 এর সাথে একত্রিত করা যা এটি পড়ে (Reflector এর মাধ্যমে) ভূমিকা-ভিত্তিক অ্যাক্সেস নিয়ন্ত্রণের জন্য মান প্যাটার্ন।
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 হল authorization-এর জন্য NestJS-এর নিবেদিত, প্রচলিত প্রক্রিয়া — মূলতন্ত্র এবং অনুমতির উপর ভিত্তি করে কোন অনুরোধ হ্যান্ডলারদের কাছে পৌঁছাতে অনুমোদিত তা নিয়ন্ত্রণ করা।
সেগুলি বোঝা অপরিহার্য কারণ প্রায় প্রতিটি বাস্তব অ্যাপ্লিকেশনকে রুটগুলি সুরক্ষিত করতে হয় (লগইন প্রয়োজন, ভূমিকা/অনুমতি পরীক্ষা করুন), এবং Guards এটির জন্য সঠিক সরঞ্জাম (middleware বা প্রতিটি হ্যান্ডলারে auth লজিক ঠেলে দেওয়ার চেয়ে অনেক বেশি পরিষ্কার)।
মান প্যাটার্নগুলি — একটি JWT/auth guard যা শংসাপত্র যাচাই করে এবং ব্যবহারকারীকে অনুরোধে সংযুক্ত করে, এবং ভূমিকা-ভিত্তিক guards যা @Roles() decorator এর সাথে একটি Reflector-পঠনকারী guard কে RBAC-এর জন্য একত্রিত করে — NestJS APIs সুরক্ষিত করার জন্য মৌলিক।
Guards-এর সমৃদ্ধ ExecutionContext-এ অ্যাক্সেস (লক্ষ্য হ্যান্ডলার, ক্লাস, এবং অনুরোধ জেনে) তাদের authorization সিদ্ধান্তের জন্য উপযুক্ত করে যা middleware পরিষ্কারভাবে নিতে পারে না।
কীভাবে guards লিখতে হয়, প্রয়োগ করতে হয় (method/controller/global), এবং metadata decorators-এর সাথে একত্রিত করতে হয় তা জানা নিরাপদ NestJS অ্যাপ্লিকেশন তৈরির মূল জ্ঞান এবং এই framework-এ একটি ঘন ঘন, স্থাপত্যগতভাবে গুরুত্বপূর্ণ বিষয়।