Permify权限系统从v1.0升级到v1.1的全面指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00698/article/details/148505407

Permify权限系统从v1.0升级到v1.1的全面指南

permify Permify is an open-source authorization service inspired by Google Zanzibar. 项目地址: https://gitcode.com/gh_mirrors/pe/permify

Permify是一个现代化的权限服务系统，它使用声明式的权限语言来定义和管理复杂的权限模型。在v1.1版本中，Permify引入了一些重要的语法和API变更，本文将详细介绍这些变化，帮助开发者顺利完成版本升级。

一、DSL上下文访问方式变更

在权限规则中访问上下文数据的方式发生了重要变化，这是v1.1最显著的语法改进。

v1.0的上下文访问方式

在v1.0版本中，开发者需要通过request.field_name的方式访问传入的上下文数据：

entity account {
    permission withdraw = check_balance(request.amount, balance) and owner
}

这种方式需要显式地将参数传递给规则函数，增加了代码冗余。

v1.1的新访问方式

v1.1引入了更简洁的context.data对象来访问上下文数据：

entity account {
    permission withdraw = check_balance(balance) and owner
}

rule check_balance(balance double) {
    (balance >= context.data.amount) && (context.data.amount <= 5000)
}

这种改进带来了以下优势：

减少了参数传递，使规则定义更加简洁
上下文数据集中管理，提高了代码可读性
更符合现代编程语言的访问习惯

二、查询实体范围的新特性

v1.1为实体查询API引入了scope字段，这是一个强大的过滤机制。

范围限定功能详解

scope字段允许开发者对查询结果进行精细控制，例如：

"scope": {
    "repository": {
        "data": ["r1", "r2"]
    },
    "organization": {
        "data": ["o2"]
    }
}

这个特性特别适用于以下场景：

多租户系统中限制查询范围
大型系统中提高查询性能
实现基于数据分区的权限检查

完整请求示例

{
    "metadata": {
        "snap_token": "your_token",
        "schema_version": "1.1",
        "depth": 100
    },
    "entity_type": "repository",
    "permission": "edit",
    "subject": {
        "type": "user",
        "id": "u1",
        "relation": ""
    },
    "scope": {
        "repository": {
            "data": ["r1", "r2"]
        },
        "organization": {
            "data": ["o2"]
        }
    },
    "page_size": 20,
    "continuous_token": ""
}