PHP-Casbin: 支援ACL、RBAC、ABAC多種模型的PHP許可權管理框架
前言
PHP-Casbin 是一個用 PHP 語言打造的輕量級開源訪問控制框架( ofollow,noindex" target="_blank">https://github.com/php-casbin/php-casbin ),目前在 GitHub 開源。PHP -Casbin 採用了元模型的設計思想,支援多種經典的訪問控制方案,如基於角色的訪問控制 RBAC、基於屬性的訪問控制 ABAC 等。
概述
PHP-Casbin 的主要特性包括:
支援自定義請求的格式,預設的請求格式為{subject, object, action};
具有訪問控制模型 model 和策略 policy 兩個核心概念;
支援 RBAC 中的多層角色繼承,不止主體可以有角色,資源也可以具有角色;
支援超級使用者,如 root 或 Administrator,超級使用者可以不受授權策略的約束訪問任意資源;
支援多種內建的操作符,如 keyMatch,方便對路徑式的資源進行管理,如 /foo/bar 可以對映到 /foo*;
PHP-Casbin 不做的事情:
身份認證 authentication (即驗證使用者的使用者名稱、密碼),PHP-Casbin 只負責訪問控制。應該有其他專門的元件負責身份認證,然後由 PHP-Casbin 進行訪問控制,二者是相互配合的關係;
管理使用者列表或角色列表。PHP -Casbin 認為由專案自身來管理使用者、角色列表更為合適,PHP -Casbin 假設所有策略和請求中出現的使用者、角色、資源都是合法有效的。
安裝
composer require casbin/casbin
HelloWorld 例子
1. 初始化一個 enforcer,傳入兩個引數:模型檔案路徑和策略檔案路徑;
$e = new Enforcer(__DIR__ . '/examples/modelandpolicy/basic_model.conf', __DIR__ . "/examples/modelandpolicy/basic_policy.csv");
2. 在你的程式碼需要進行訪問控制的位置,加入如下鉤子;
$sub = "alice"; // the user that wants to access a resource. $obj = "data1"; // the resource that is going to be accessed. $act = "read"; // the operation that the user performs on the resource. if ($e->enforce($sub, $obj, $act) === true) { // permit alice to read data1x } else { // deny the request, show an error }
3. 採用管理 API 進行許可權的管理,如獲取一個使用者所有的角色;
roles = $e->getRoles('alice');
請參考 test 目錄獲得更多的使用方法。
社群進展
PHP-Casbin 目前正在積極向社群進行推送,目前通過外掛的方式已經支援與Laravel 等 Web 框架進行整合,將來會推廣到更多 Web 框架以及社群。Casbin 已經有 Golang 版本、Java 版本、PHP 版本和 Node.js 版本。有跨語言需求的開發者可以只用 Casbin 這一套框架就實現多個不同語言的專案的許可權管理任務。
Casbin (Go): https://github.com/casbin/casbin
jCasbin (Java): https://github.com/casbin/jcasbin
PHP-Casbin (PHP): https://github.com/php-casbin/php-casbin
Node-Casbin (Node.js): https://github.com/casbin/node-casbin
協議
PHP-Casbin 採用 Apache 2.0 開源協議釋出。
聯絡作者
有問題請提交 Issues: https://github.com/php-casbin/php-casbin/issues
*本文作者:hsluoyz,轉載請註明來自FreeBuf.COM