NestJS’de Özel Rol Tabanlı Erişim Kontrolü: Özel Koruyucular Kullanımı
NestJS’de güvenli bir şekilde uygulama geliştirmek için, **rol tabanlı erişim kontrolü (RBAC)** etkin bir şekilde kullanılmalıdır. RBAC, kullanıcıların veya rollerin sistemdeki belirli kaynaklara erişimini yönetmenizi sağlar. Bu makalede, NestJS’de özel rol tabanlı erişim kontrolü uygulamanın basit ve etkili bir yolunu, **özel koruyucular** kullanarak inceleyeceğiz.
Neden Özel Koruyucular?
NestJS’de **özel koruyucular**, belirli işlemlere veya rotalara erişim sağlamak için **yönetilen güvenlik mekanizmaları** olarak kullanılır. **Özel koruyucular** kullanarak, belirli bir role sahip kullanıcıların erişimine izin verilen veya engellenen rotaları tanımlayabilirsiniz. Bu, uygulama güvenliğinizi iyileştirmek için kullanılabilecek güçlü bir özelliktir.
Bir Özel Koruyucu Oluşturma
Özel bir koruyucu oluşturmak için, **@Injectable()** dekoratörünü kullanarak bir sınıf tanımlar ve **CanActivate** arayüzünü uygularız. **CanActivate** arayüzü, isteğin erişim izninin olup olmadığına dair bir boolean değer döndüren **canActivate()** metodunu tanımlar.
“`typescript
import { Injectable, CanActivate, ExecutionContext, SetMetadata } from ‘@nestjs/common’;
import { Reflector } from ‘@nestjs/core’;
@Injectable()
export class RolesGuard implements CanActivate {
constructor(private reflector: Reflector) {}
canActivate(context: ExecutionContext): boolean {
const requiredRoles = this.reflector.get
const user = context.switchToHttp().getRequest().user;
if (!user || !user.roles) {
return false;
}
return requiredRoles.some((role) => user.roles.includes(role));
}
}
“`
Bu örnekte, **RolesGuard** adlı bir koruyucu, isteğin hangi role sahip olması gerektiğini belirten **@Roles()** dekoratörünü kullanarak tanımlanmıştır. **canActivate()** metodu, isteğin roles meta verisini kontrol eder ve isteği gönderen kullanıcının ilgili role sahip olup olmadığını doğrular. İstek, isteğin role sahip olup olmadığına göre true veya false değeri döndürür.
Özel Koruyucuların Uygulamaya Eklenmesi
Bir özel koruyucunun bir rotaya uygulanması oldukça basittir. **@UseGuards()** dekoratörünü, koruyucu sınıfını parametre olarak kullanarak rotaya ekleyin. Bu, isteğin rotanın tanımladığı role sahip olduğundan emin olmak için, koruyucuyu kullanacak şekilde yapılandırır.
“`typescript
import { Controller, Get, UseGuards } from ‘@nestjs/common’;
import { RolesGuard } from ‘./roles.guard’;
import { Roles } from ‘./roles.decorator’;
@Controller(‘users’)
@UseGuards(RolesGuard)
export class UsersController {
@Get()
@Roles(‘admin’)
getUsers() {
// Kullanıcılar listesi döndür
}
}
“`
Yukarıdaki örnekte, **UsersController**’da bulunan **getUsers** metodu **admin** rolü gerektiren **@Roles** dekoratörünü kullanarak işaretlenir. Bu, **RolesGuard**’ın **getUsers** metoduna erişmeden önce çağrılacağı ve isteğin **admin** rolüne sahip olup olmadığını kontrol edeceği anlamına gelir.
Özet
NestJS’de özel koruyucular kullanarak, kullanıcıları veya rolleri sisteminizde güvenli bir şekilde yönetmek için güçlü bir rol tabanlı erişim kontrolü (RBAC) sistemi kurabilirsiniz. Bu makalede açıklanan adımları izleyerek, güvenlik gereksinimlerinizi karşılayan özelleştirilmiş bir RBAC sistemi oluşturabilirsiniz.
Eğer NestJS’de güvenlik ve erişim kontrolü hakkında daha fazla bilgi edinmek isterseniz, fatihsoysal.com web sitesini ziyaret edebilir ve diğer makalelerime göz atabilirsiniz.
Faydalı Kaynaklar
#Etiketler
NestJS, Özel Koruyucular, Rol Tabanlı Erişim Kontrolü, RBAC, Güvenlik, Erişim Kontrolü, NestJS Güvenliği