Gin-contrib Authz 开源项目教程

Gin-contrib Authz 开源项目教程

authzgin-authz is an authorization middleware for Gin项目地址:https://gitcode.com/gh_mirrors/au/authz

1. 项目的目录结构及介绍

gin-contrib/authz/
├── LICENSE
├── README.md
├── authz.go
├── authz_test.go
├── examples/
│   ├── basic/
│   │   ├── main.go
│   │   └── README.md
│   └── rbac/
│       ├── main.go
│       └── README.md
└── vendor/
    └── ...

• LICENSE: 项目的许可证文件。
• README.md: 项目的基本介绍和使用说明。
• authz.go: 核心文件，包含授权中间件的实现。
• authz_test.go: 测试文件，包含授权中间件的单元测试。
• examples/: 示例目录，包含基本和RBAC授权的示例。
  • basic/: 基本授权示例。
  • rbac/: RBAC授权示例。
• vendor/: 依赖包目录，包含项目依赖的所有第三方包。

2. 项目的启动文件介绍

在 examples/basic/main.go 和 examples/rbac/main.go 中，我们可以找到项目的启动文件。以下是 examples/basic/main.go 的示例代码：

package main

import (
    "github.com/gin-gonic/gin"
    "github.com/gin-contrib/authz"
    "github.com/casbin/casbin"
)

func main() {
    r := gin.Default()

    // 初始化Casbin enforcer
    enforcer := casbin.NewEnforcer("path/to/model.conf", "path/to/policy.csv")

    // 使用authz中间件
    r.Use(authz.NewAuthorizer(enforcer))

    r.GET("/", func(c *gin.Context) {
        c.String(200, "Hello, world!")
    })

    r.Run()
}

在这个启动文件中，我们首先导入了必要的包，然后初始化了一个Casbin enforcer，并使用 authz.NewAuthorizer 中间件来保护路由。最后，我们定义了一个简单的路由并启动了Gin服务器。

3. 项目的配置文件介绍

在 examples/basic/ 和 examples/rbac/ 目录中，我们可以找到项目的配置文件。以下是 examples/basic/ 目录中的配置文件示例：

model.conf

[request_definition]
r = sub, obj, act

[policy_definition]
p = sub, obj, act

[policy_effect]
e = some(where (p.eft == allow))

[matchers]
m = r.sub == p.sub && r.obj == p.obj && r.act == p.act

policy.csv

p, alice, /, GET
p, bob, /admin, POST

• model.conf: 定义了请求和策略的格式，以及匹配规则和策略效果。
• policy.csv: 定义了具体的授权策略，例如 alice 可以访问 / 路径的 GET 请求，bob 可以访问 /admin 路径的 POST 请求。

通过这些配置文件，我们可以灵活地定义和调整授权策略，以满足不同的需求。

authzgin-authz is an authorization middleware for Gin项目地址:https://gitcode.com/gh_mirrors/au/authz