Golang RBAC 튜토리얼: Gin에서의 역할 기반 접근 제어
이 튜토리얼에서는 Gin으로 작성된 Go 기반 REST API에 역할 기반 접근 제어(RBAC)를 추가합니다. 최종적으로 세 가지 역할(admin, editor, viewer)이 서로 다른 라우트에서 서로 다른 HTTP 메서드를 허용하도록 설정되며, 이 규칙들은 핸들러 코드를 수정하지 않고도 변경할 수 있는 정책 파일에 저장됩니다.
동일한 모델과 정책은 모든 Casbin 구현체에서 작동하므로, 이 튜토리얼의 Node.js, Python, Java 및 Rust 버전에서도 재사용할 수 있습니다. gRPC 서비스의 경우 Go에서의 gRPC 인증을 참조하세요.
1. 설치
go mod init example.com/rbac
go get github.com/casbin/casbin/v3 github.com/gin-gonic/gin
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를 사용하면 하나의 규칙으로 여러 메서드를 나열할 수 있습니다. 기타 기본 제공 매처는 함수를 참조하세요.
3. 정책 작성
이를 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로 시작하는 줄은 사용자에게 역할을 할당합니다.
4. 미들웨어 추가
미들웨어는 사용자, 경로 및 메서드를 인자로 Enforce를 호출하며, Casbin이 거부 응답을 반환하면 요청을 403 Forbidden으로 거절합니다.
main.go
package main
import (
"log"
"net/http"
"github.com/casbin/casbin/v3"
"github.com/gin-gonic/gin"
)
// Authorize asks Casbin whether the current user may call this route.
func Authorize(e *casbin.Enforcer) gin.HandlerFunc {
return func(c *gin.Context) {
// Replace this with the user from your session or JWT.
user := c.GetHeader("X-User")
allowed, err := e.Enforce(user, c.Request.URL.Path, c.Request.Method)
if err != nil {
c.AbortWithStatusJSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
return
}
if !allowed {
c.AbortWithStatusJSON(http.StatusForbidden, gin.H{"error": "forbidden"})
return
}
c.Next()
}
}
func main() {
e, err := casbin.NewEnforcer("model.conf", "policy.csv")
if err != nil {
log.Fatal(err)
}
r := gin.Default()
api := r.Group("/api", Authorize(e))
api.GET("/articles", func(c *gin.Context) { c.JSON(http.StatusOK, gin.H{"articles": []string{}}) })
api.POST("/articles", func(c *gin.Context) { c.JSON(http.StatusCreated, gin.H{"created": true}) })
api.PUT("/articles/:id", func(c *gin.Context) { c.JSON(http.StatusOK, gin.H{"updated": c.Param("id")}) })
api.DELETE("/articles/:id", func(c *gin.Context) { c.JSON(http.StatusOK, gin.H{"deleted": c.Param("id")}) })
log.Fatal(r.Run(":8080"))
}
노트
예제를 간결하게 유지하기 위해 X-User 헤더를 사용합니다. Casbin은 인증(authorization)만 처리합니다. 실제 애플리케이션에서는 검증된 JWT나 세션과 같은 인증 계층에서 사용자 이름을 가져옵니다.
5. 테스트 실행
go run .
curl -i -X POST -H "X-User: bob" http://localhost:8080/api/articles # 201, editors can create
curl -i -X DELETE -H "X-User: bob" http://localhost:8080/api/articles/1 # 403, editors cannot delete
curl -i -X DELETE -H "X-User: alice" http://localhost:8080/api/articles/1 # 200, admins can
curl -i -X POST -H "X-User: carol" http://localhost:8080/api/articles # 403, viewers are read-only