使用 Casbin 作為 ThinkPHP 的許可權控制中介軟體

techlee發表於2019-09-26

PHP-Casbin 是一個強大的、高效的開源訪問控制框架,它支援基於各種訪問控制模型的許可權管理。

Think-Casbin 是一個專為ThinkPHP5.1定製的Casbin的擴充套件包,使開發者更便捷的在thinkphp專案中使用Casbin。

安裝

  1. 建立thinkphp專案(如果沒有):
composer create-project topthink/think=5.1.* tp5
  1. ThinkPHP專案裡,安裝Think-Casbin擴充套件:
composer require casbin/think-adapter
  1. 釋出資源:
php think casbin:publish

這將自動建立model配置檔案config/casbin-basic-model.conf,和Casbin的配置檔案config/casbin.php

  1. 資料遷移:

由於Think-Casbin預設將Casbin的策略(Policy)儲存在資料庫中,所以需要初始化資料庫表資訊。

執行前,請確保資料庫連線資訊配置正確,如需單獨修改Casbin的資料庫連線資訊或表名,可以修改config/casbin.php裡的配置。

php think casbin:migrate

這將會自動建立Casbin的策略(Policy)表casbin_rule

中介軟體

ThinkPHP 從 5.1.6+ 版本開始,正式引入中介軟體的支援。

可以通過命令列指令快速生成中介軟體

php think make:middleware Authorization

這個指令會 application/http/middleware 目錄下面生成一個 Authorization 中介軟體。

在中介軟體中,獲取當前使用者名稱、URI、請求方法,通過 Casbin 驗證許可權:

<?php

namespace app\http\middleware;

use Casbin;
use think\facade\Session;

class Authorization
{
    public function handle($request, \Closure $next)
    {
        // 當前登入使用者名稱,這裡以session為例
        // $user = Session::get('user_name') ?: 'test_user';
        $user = Session::get('user_name');

        $url = $request->url();
        $action = $request->method();

        if (!$user){
            return response()->data('Unauthenticated.')->code(401);
        }

        if (!Casbin::enforce($user, $url, $action)) {
            return response()->data('Unauthorized.')->code(403);
        }

        return $next($request);
    }
}

Casbin Model配置

config\casbin-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 && keyMatch2(r.obj, p.obj) && r.act == p.act

驗證

在執行授權之前,先在資料庫 casbin_rule 表中新增一些預設的策略:

id ptype v0 v1 v2
1 p test_user /users GET
2 p test_user /users/:id GET

新增路由及其中介軟體:

Route::group('users', function () {

    Route::get('', function () {
        return 'Users data.';
    });

    Route::get('/:id', function ($id) {
        return 'User: '.$id;
    });

})->middleware(\app\http\middleware\Authorization::class);

先登入使用者儲存使用者名稱到 SESSION ,可以訪問 /users/users/1 驗證一下許可權。

更多API參考

相關文章