Go Casbin 入门

Go Casbin 入门

Go Casbin 是一个强大的、高效的访问控制框架，可以处理基于角色的访问控制 (RBAC)、访问控制列表 (ACL)、节点属性访问控制 (ABAC) 和多租户数据的访问控制等各种访问控制模型。它是 Casbin 的 Go 语言实现版本，可以方便地与 Go 应用程序集成。

安装

使用 Go 命令行工具安装 Go Casbin：

go get github.com/casbin/casbin/v2

快速入门

以下是一个简单的示例，演示了如何在 Go 应用程序中使用 Casbin 进行访问控制。

首先，我们需要创建一个 Enforcer，它是 Casbin 中最重要的组件。它在内部维护了一个访问控制模型，并提供了一些方便的方法来进行访问控制决策（如 Enforce() 方法）。

import (
    "github.com/casbin/casbin/v2"
)

e, err := casbin.NewEnforcer("examples/basic_model.conf", "examples/basic_policy.csv")
if err != nil {
    panic(err)
}

在上面的示例中，我们使用 casbin.NewEnforcer() 方法创建了一个 Enforcer。它需要两个参数：模型文件的路径和策略文件的路径。这里我们使用的是 Casbin 提供的示例模型和策略。

接下来，我们可以使用 Enforce() 方法来检查某个主体是否被允许执行某个操作：

allowed, err := e.Enforce("alice", "data1", "read")
if err != nil {
    panic(err)
}
if allowed {
    fmt.Println("Alice is allowed to read data1")
} else {
    fmt.Println("Alice is not allowed to read data1")
}

在上面的示例中，我们检查主体 “alice” 是否被允许读取资源 “data1”。如果允许，将输出 “Alice is allowed to read data1”，否则将输出 “Alice is not allowed to read data1”。

我们还可以使用 AddPolicy() 方法来动态添加策略：

ok, err := e.AddPolicy("alice", "data1", "write")
if err != nil {
    panic(err)
}
if ok {
    fmt.Println("Policy added successfully")
} else {
    fmt.Println("Policy already exists")
}

在上面的示例中，我们添加了一个允许主体 “alice” 写入资源 “data1” 的策略。如果策略已经存在，则输出 “Policy already exists”，否则输出 “Policy added successfully”。

模型和策略

Casbin 支持多种访问控制模型，如 RBAC、ACL 和 ABAC 等。您可以根据自己的需求选择合适的模型。

模型文件通常是一个 .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

此模型定义了一些基本的请求、策略和角色的定义。在此基础上，您可以定义自己的访问控制规则。

策略文件通常是一个 .csv 文件，它定义了访问控制策略。以下是一个简单的策略文件示例：

alice, data1, read
bob, data2, write

此策略定义了两个访问控制规则：允许主体 “alice” 读取资源 “data1”，允许主体 “bob” 写入资源 “data2”。

配置

Go Casbin 支持多种配置选项，您可以根据需要进行配置。例如，您可以设置模型和策略文件的路径、日志记录级别、存储类型等。

以下是一个简单的配置示例：

import (
    "github.com/casbin/casbin/v2"
    "github.com/casbin/casbin/v2/persist/file-adapter"
)

a, err := fileadapter.NewAdapter("examples/basic_policy.csv")
if err != nil {
    panic(err)
}

e, err := casbin.NewEnforcer("examples/basic_model.conf", a)
if err != nil {
    panic(err)
}

e.EnableLog(true)
e.EnableAutoSave(true)

在上面的示例中，我们使用 fileadapter.NewAdapter() 方法创建了一个文件适配器，用于将策略存储在文件中。然后我们使用 casbin.NewEnforcer() 方法创建了一个 Enforcer，并将其与适配器相关联。最后，我们启用了日志记录和自动保存选项。

总结

Go Casbin 是一个非常强大和灵活的访问控制框架，它可以帮助您轻松实现各种访问控制模型。在本文中，我们介绍了 Go Casbin 的一些基本概念和用法，希望对您有所帮助。如果您想深入了解 Go Casbin，请访问 Casbin 的官方网站或查看其文档。