Spring Boot RBAC Tutorial: Role-Based Access Control with jCasbin
이 튜토리얼은 Spring Boot와 jCasbin으로 구축된 REST API에 역할 기반 접근 제어(RBAC)를 추가합니다. 최종적으로 세 가지 역할(admin, editor, viewer)이 서로 다른 경로에서 서로 다른 HTTP 메서드를 허용받으며, 규칙은 컨트롤러를 수정하지 않고 변경할 수 있는 정책 파일에 저장됩니다.
동일한 모델과 정책은 모든 Casbin 구현체에서 작동하므로, 이 튜토리얼의 Go, Node.js, Python 및 Rust 버전에서도 재사용할 수 있습니다.
1. 의존성 추가
이미 spring-boot-starter-web이 포함된 Spring Boot 3 프로젝트에서 pom.xml에 jCasbin을 추가하세요. 최신 버전은 Maven Central에서 확인하세요.
<dependency>
<groupId>org.casbin</groupId>
<artifactId>jcasbin</artifactId>
<version>1.81.0</version>
</dependency>
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) && keyMatch2(r.obj, p.obj) && regexMatch(r.act, p.act)
r = sub, obj, act: 각 요청은 사용자, URL 경로 및 HTTP 메서드로 구성됩니다.g = _, _: 사용자는 역할에 할당될 수 있습니다.g(r.sub, p.sub): 요청의 사용자는 정책 규칙에 명시된 역할을 보유해야 합니다.keyMatch2는/api/articles/:id와 같은 경로를 매칭하며,regexMatch를 사용하면 하나의 규칙으로 여러 메서드를 나열할 수 있습니다. 다른 내장 매처는 Functions를 참조하세요.
3. 정책 작성
model.conf 옆에 policy.csv로 저장합니다:
p, admin, /api/*, (GET)|(POST)|(PUT)|(DELETE)
p, editor, /api/articles, (GET)|(POST)
p, editor, /api/articles/:id, (GET)|(PUT)
p, viewer, /api/articles, GET
p, viewer, /api/articles/:id, GET
g, alice, admin
g, bob, editor
g, carol, viewer
p로 시작하는 줄은 역할이 특정 경로와 메서드 집합에 접근할 수 있도록 권한을 부여합니다. g로 시작하는 줄은 사용자를 역할에 할당합니다.