Gin框架 -- 權限管理

Casbin是用於Golang項目的功能強大且高效的開源訪問控制庫。

1. 特征

Casbin的作用：

1. 以經典{subject, object, action}形式或您定義的自定義形式實施策略，同時支持允許和拒絕授權。
2. 處理訪問控制模型及其策略的存儲。
3. 管理角色用戶映射和角色角色映射（RBAC中的角色層次結構）。
4. 支持內置的超級用戶，例如root或administrator。超級用戶可以在沒有顯式權限的情況下執行任何操作。
5. 多個內置運算符支持規則匹配。例如，keyMatch可以將資源鍵映射/foo/bar到模式/foo*。

Casbin不執行的操作：

1. 身份驗證（又名驗證username以及password用戶登錄時）
2. 管理用戶或角色列表。我相信項目本身管理這些實體會更方便。用戶通常具有其密碼，而Casbin並非設計為密碼容器。但是，Casbin存儲RBAC方案的用戶角色映射。

2. 怎么運行的

在Casbin中，基於PERM元模型（策略，效果，請求，匹配器）將訪問控制模型抽象為CONF文件。因此，切換或升級項目的授權機制就像修改配置一樣簡單。您可以通過組合可用的模型來定制自己的訪問控制模型。例如，您可以在一個模型中同時獲得RBAC角色和ABAC屬性，並共享一組策略規則。

Casbin中最基本，最簡單的模型是ACL。ACL的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

ACL模型的示例策略如下：

p, alice, data1, read
p, bob, data2, write

3. 安裝

go get github.com/casbin/casbin

4. 示例代碼

package main

import (
    "fmt"
    "log"

    "github.com/casbin/casbin"
    xormadapter "github.com/casbin/xorm-adapter"
    "github.com/gin-gonic/gin"
    _ "github.com/go-sql-driver/mysql"
)

func main() {
    // 要使用自己定義的數據庫rbac_db,最后的true很重要.默認為false,使用缺省的數據庫名casbin,不存在則創建
    a, err := xormadapter.NewAdapter("mysql", "root:root@tcp(127.0.0.1:3306)/goblog?charset=utf8", true)
    if err != nil {
        log.Printf("連接數據庫錯誤: %v", err)
        return
    }
    e, err := casbin.NewEnforcer("./rbac_models.conf", a)
    if err != nil {
        log.Printf("初始化casbin錯誤: %v", err)
        return
    }
    //從DB加載策略
    e.LoadPolicy()

    //獲取router路由對象
    r := gin.New()

    r.POST("/api/v1/add", func(c *gin.Context) {
        fmt.Println("增加Policy")
        if ok, _ := e.AddPolicy("admin", "/api/v1/hello", "GET"); !ok {
            fmt.Println("Policy已經存在")
        } else {
            fmt.Println("增加成功")
        }
    })
    //刪除policy
    r.DELETE("/api/v1/delete", func(c *gin.Context) {
        fmt.Println("刪除Policy")
        if ok, _ := e.RemovePolicy("admin", "/api/v1/hello", "GET"); !ok {
            fmt.Println("Policy不存在")
        } else {
            fmt.Println("刪除成功")
        }
    })
    //獲取policy
    r.GET("/api/v1/get", func(c *gin.Context) {
        fmt.Println("查看policy")
        list := e.GetPolicy()
        for _, vlist := range list {
            for _, v := range vlist {
                fmt.Printf("value: %s, ", v)
            }
        }
    })
    //使用自定義攔截器中間件
    r.Use(Authorize(e))
    //創建請求
    r.GET("/api/v1/hello", func(c *gin.Context) {
        fmt.Println("Hello 接收到GET請求..")
    })

    r.Run(":9000") //參數為空 默認監聽8080端口
}

//攔截器
func Authorize(e *casbin.Enforcer) gin.HandlerFunc {

    return func(c *gin.Context) {

        //獲取請求的URI
        obj := c.Request.URL.RequestURI()
        //獲取請求方法
        act := c.Request.Method
        //獲取用戶的角色
        sub := "admin"

        //判斷策略中是否存在
        if ok, _ := e.Enforce(sub, obj, act); ok {
            fmt.Println("恭喜您,權限驗證通過")
            c.Next()
        } else {
            fmt.Println("很遺憾,權限驗證沒有通過")
            c.Abort()
        }
    }
}

rbac_models.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

配置鏈接數據庫不需要手動創建數據庫，系統自動創建casbin_rule表

使用postman請求http://localhost:9000/api/v1/hello

運行解決結果顯示為很遺憾,權限驗證沒有通過

下面我在數據表中添加數據在演示的時候可以直接手動按照圖片的格式直接添加數據表，或者使用postman POST方式請求http://localhost:9000/api/v1/add

然后繼續請求http://localhost:9000/api/v1/hello