jCasbin: 強大的訪問控制、許可權管理框架，支援 ACL, RBAC, ABAC

tldyl發表於2020-08-12
框架

轉自本人的csdn部落格：blog.csdn.net/qq_17792831/article/...

jcasbin 是一個用 Java 語言打造的輕量級開源訪問控制框架github.com/casbin/jcasbin，是Casbin的Java語言版本。目前在 GitHub 開源。jcasbin 採用了元模型的設計思想，支援多種經典的訪問控制方案，如基於角色的訪問控制 RBAC、基於屬性的訪問控制 ABAC 等。

jcasbin 的主要特性包括：

  1. 支援自定義請求的格式，預設的請求格式為{subject, object, action}；
  2. 具有訪問控制模型 model 和策略 policy 兩個核心概念；
  3. 支援 RBAC 中的多層角色繼承，不止主體可以有角色，資源也可以具有角色；
  4. 支援超級使用者，如 root 或 Administrator，超級使用者可以不受授權策略的約束訪問任意資源；
  5. 支援多種內建的操作符，如 keyMatch，方便對路徑式的資源進行管理，如 /foo/bar 可以對映到 /foo*；

jcasbin 不做的事情：

  1. 身份認證 authentication （即驗證使用者的使用者名稱、密碼），jcasbin 只負責訪問控制。應該有其他專門的元件負責身份認證，然後由 jcasbin 進行訪問控制，二者是相互配合的關係；
  2. 管理使用者列表或角色列表。jcasbin 認為由專案自身來管理使用者、角色列表更為合適，jcasbin 假設所有策略和請求中出現的使用者、角色、資源都是合法有效的。

在Maven中引用

<dependency>
    <groupId>org.casbin</groupId>
    <artifactId>jcasbin</artifactId>
    <version>1.5.0</version>
</dependency>

HelloWorld 例子

初始化一個 enforcer，傳入兩個引數：模型檔案路徑和策略檔案路徑；

Enforcer enforcer = new Enforcer("examples/model.conf", "examples/policy.csv");

在你的程式碼需要進行訪問控制的位置，加入如下鉤子；

String sub = "alice";
String obj = "data1";
String act = "read";

if (enforcer.enforce(sub, obj, act) == true) {
    // permit alice to read data1
} else {
    // deny the request, show an error
}

採用管理 API 進行許可權的管理，如獲取一個使用者所有的角色；

roles = enforcer.getRoles("alice");

請參考test目錄下的測試類獲得更多的使用方法。

社群進展

jcasbin 目前正在積極向社群進行推送，已經聯絡的社群包括 etcd、tango，將來有可能推送到 docker 社群。

協議

jcasbin 採用 Apache 2.0 開源協議釋出。

聯絡作者

有問題請提交 Issues: github.com/casbin/jcasbin/issues
或者聯絡作者 QQ: 515964173

本作品採用《CC 協議》，轉載必須註明作者和本文連結

相關文章