Casbin.NET 使用教程

Casbin.NET 使用教程

Casbin.NET 项目地址: https://gitcode.com/gh_mirrors/cas/Casbin.NET

1. 项目介绍

Casbin.NET 是一个强大且高效的 .NET (C#) 访问控制库，支持多种访问控制模型，如 ACL、RBAC、ABAC 等。它提供了灵活的授权机制，适用于各种需要权限管理的项目。Casbin.NET 是 Casbin 生态系统的一部分，支持多种编程语言，如 Python、Java、Node.js 等。

2. 项目快速启动

安装

首先，通过 NuGet 安装 Casbin.NET：

dotnet add package Casbin.NET

初始化 Enforcer

创建一个 Casbin Enforcer 实例，使用模型文件和策略文件：

var e = new Enforcer("path/to/model.conf", "path/to/policy.csv");

权限检查

在代码中添加权限检查逻辑：

var sub = "alice"; // 用户
var obj = "data1"; // 资源
var act = "read";  // 操作

if (e.Enforce(sub, obj, act))
{
    // 允许访问
}
else
{
    // 拒绝访问，显示错误信息
}

3. 应用案例和最佳实践

案例1：基于角色的访问控制 (RBAC)

在 RBAC 模型中，用户通过角色与权限关联。以下是一个简单的 RBAC 配置示例：

模型文件 (rbac_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) && r.obj == p.obj && r.act == p.act

策略文件 (rbac_policy.csv):

p, admin, data1, read
p, admin, data1, write
g, alice, admin

案例2：基于属性的访问控制 (ABAC)

在 ABAC 模型中，权限基于对象的属性。以下是一个简单的 ABAC 配置示例：

模型文件 (abac_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.Owner == r.obj.Owner

策略文件 (abac_policy.csv):

p, alice, data1, read

4. 典型生态项目

Casbin.NET 生态系统

Casbin.NET 是 Casbin 生态系统的一部分，支持多种编程语言和平台。以下是一些典型的生态项目：

• Casbin (Go): Casbin 的原始实现，支持 Go 语言。
• PyCasbin (Python): Casbin 的 Python 实现。
• jCasbin (Java): Casbin 的 Java 实现。
• Node-Casbin (Node.js): Casbin 的 Node.js 实现。

这些项目共同构成了一个强大的访问控制生态系统，支持多种编程语言和平台，满足不同项目的需求。

Casbin.NET 项目地址: https://gitcode.com/gh_mirrors/cas/Casbin.NET