본문으로 건너뛰기

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

6. 런타임 중 역할 변경​

역할과 권한은 데이터이므로 서버가 실행 중일 때도 변경할 수 있습니다:

e.AddRoleForUser("dave", "editor") // dave becomes an editor
e.DeleteRoleForUser("bob", "editor") // bob is no longer an editor
e.AddPolicy("editor", "/api/comments", "POST") // editors may now post comments

roles, _ := e.GetRolesForUser("alice") // [admin]

전체 목록은 RBAC API 및 Management API에 있습니다.

다음 단계​

  • 정책을 데이터베이스에 저장하기. policy.csv 대신 MySQL, PostgreSQL, MongoDB, Redis 등을 위한 어댑터를 사용하세요. API를 통해 이루어진 정책 변경 사항이 자동으로 저장됩니다.
  • 여러 인스턴스 실행하기. 워처를 사용하여 한 인스턴스에서 정책을 변경하면 모든 인스턴스가 정책을 다시 로드하도록 하세요.
  • 멀티 테넌트 애플리케이션. 도메인이 포함된 RBAC를 사용하면 사용자가 서로 다른 테넌트에서 서로 다른 역할을 가질 수 있습니다.
  • 속성 기반 규칙. 역할과 ABAC를 조합하여, 예를 들어 "편집자는 자신의 기사만 업데이트할 수 있음"과 같은 규칙을 만듭니다. ABAC 튜토리얼에서 단계별로 빌드하는 방법을 확인할 수 있습니다.
  • 기성품 미들웨어. 미들웨어 목록에는 Gin, Echo, Fiber, Chi 및 기타 프레임워크용 플러그인이 포함되어 있습니다.
  • 브라우저에서 실험하기. 모델과 정책을 온라인 에디터에 붙여넣어 코드 실행 없이 요청을 테스트하세요.

Comments are powered by giscus and GitHub Discussions. They load from giscus.app and GitHub only after you click the button below.