NestJS RBAC 튜토리얼: 가드(Guard)를 사용한 역할 기반 접근 제어
이 튜토리얼에서는 node-casbin을 사용하여 NestJS API에 역할 기반 접근 제어(RBAC)를 추가합니다. 각 라우트는 데코레이터로 필요한 권한을 선언하고, 전역 가드는 현재 사용자가 해당 권한을 가지고 있는지 Casbin에 문의하며, 역할은 서로 상속되므로 admin은 자동으로 editor가 할 수 있는 모든 작업을 수행할 수 있습니다.
권한은 URL 경로 대신 리소스와 액션(articles, delete)으로 명명되며, 이는 NestJS 컨트롤러와 잘 맞습니다. 경로 기반 규칙의 경우 Express 버전을 참조하세요.
1. 설치
NestJS 프로젝트(nest new my-app)에서 시작하여 Casbin을 추가합니다:
npm install casbin
2. 모델 작성
프로젝트 루트에 model.conf로 저장합니다:
[request_definition]
r = sub, obj, act
[policy_definition]
p = sub, obj, act
[role_definition]
g = _, _
[policy_effect]
e = some(where (p.eft == allow))
[matchers]
m = g(r.sub, p.sub) && r.obj == p.obj && r.act == p.act
r = sub, obj, act: 각 요청은 사용자, 리소스 및 액션으로 구성됩니다.g = _, _: 사용자는 역할에 할당될 수 있으며, 역할은 다른 역할에 할당될 수 있습니다.g(r.sub, p.sub)는 사용자가 정책 규칙의 역할을 직접 또는 상속된 역할을 통해 가지고 있을 때 true입니다.
3. 정책 작성
policy.csv로 저장합니다:
p, viewer, articles, read
p, editor, articles, create
p, editor, articles, update
p, admin, articles, delete
g, editor, viewer
g, admin, editor
g, alice, admin
g, bob, editor
g, carol, viewer
첫 번째 블록은 각 레벨에서 새로 추가되는 사항만 역할에 부여합니다. 두 번째 블록은 계층 구조를 구축합니다: editor는 또한 viewer이며, admin은 또한 editor입니다. 마지막 블록은 사용자를 역할에 할당합니다. 결과적으로:
| 사용자 | 역할 | 읽기 | 생성 | 업데이트 | 삭제 |
|---|---|---|---|---|---|
| alice | admin | yes | yes | yes | yes |
| bob | editor | yes | yes | yes | no |
| carol | viewer | yes | no | no | no |
| dave | (없음) | no | no | no | no |
4. 권한 데코레이터 추가
src/permission.decorator.ts
import { SetMetadata } from '@nestjs/common';
export const PERMISSION_KEY = 'permission';
export interface Permission {
resource: string;
action: string;
}
// Declares which permission a route needs, for example @RequirePermission('articles', 'delete').
export const RequirePermission = (resource: string, action: string) =>
SetMetadata(PERMISSION_KEY, { resource, action } as Permission);