管理策略

更新时间: 2022-03-11 11:21:01

Authing 的访问控制与权限管理模型核心围绕着两个点来设计：资源（Resource）和策略（Policy）。策略定义了对某个（类）资源的某个（些）操作权限，将策略授权给用户（或角色），就能知道用户（或角色）是否具备对某个资源的某个操作具备操作权限。

请使用以下方式使用该模块：

import { ManagementClient } from "authing-js-sdk";
const managementClient = new ManagementClient({
  userPoolId: "YOUR_USERPOOL_ID",
  secret: "YOUR_USERPOOL_SECRET",
});
managementClient.policies.list; // 获取策略列表
managementClient.policies.create; // 创建策略
managementClient.policies.listUsers; // 获取策略授权记录

添加策略

添加策略

PoliciesManagementClient().create({code,statements,description,namespace})

参数

• code <string> 策略唯一标志
• statements <PolicyStatement[]>
• description <string> 描述
• namespace <string> 权限分组

示例

import { PolicyEffect } from "authing-js-sdk";

const statements = [
  {
    resource: "books:123",
    effect: PolicyEffect.Allow,
    actions: ["books:edit"],
  },
];

const policy = await managementClient.policies.create(code, statements);

返回值

• Promise<DeepPartial<Policy>>

删除策略

删除策略，系统内置策略由 Authing 官方维护，不能修改和删除。

PoliciesManagementClient().delete(code)

参数

• code <string> 策略唯一标志

示例

const { code, message } = await managementClient.policies.delete("CODE"); // 通过 code 是否为 200 判断操作是否成功

返回值

• Promise<CommonMessage>

批量删除策略

批量删除策略，系统内置策略由 Authing 官方维护，不能修改和删除。

PoliciesManagementClient().deleteMany(codeList)

参数

• codeList <string> 策略唯一标志列表

示例

const { code, message } = await managementClient.policies.deleteMany(["CODE"]); // 通过 code 是否为 200 判断操作是否成功

返回值

• Promise<CommonMessage>

修改策略

修改策略，系统内置策略由 Authing 官方维护，不能修改和删除。

PoliciesManagementClient().update(code, updates)

参数

• code <string> 策略唯一标志
• updates <object>
• updates.description <string> 描述
• updates.statements <PolicyStatement[]>
• updates.newCode <string> 新的唯一标志，如果传入，需要保证其在用户池内是唯一的。

示例

const policy = await managementClient.policies.update("CODE", {
  newCode: "NEWCODE",
});

返回值

• Promise<DeepPartial<Policy>>

获取策略详情

获取策略详情

PoliciesManagementClient().detail(code)

参数

• code <string> 策略唯一标志

const policy = await managementClient.policies.detail('CODE');

示例

返回值

• Promise<DeepPartial<Policy>>

获取策略列表

获取策略列表

PoliciesManagementClient().list(options)

参数

• options <object>
• options.page <number> 默认值为 : 1。
• options.limit <number> 默认值为 : 10。
• options.excludeDefault <boolean> 是否排除系统默认资源 默认值为 : true。

示例

const { list, totalCount } = await managementClient.policies.list({
  excludeDefault: false, // 包含系统默认的策略
});

返回值

• Promise<DeepPartial<PaginatedPolicies>>

获取策略授权记录

获取策略授权记录

PoliciesManagementClient().listAssignments(code, page, limit)

参数

• code <string> 策略唯一标志
• page <number> 默认值为 : 1。
• limit <number> 默认值为 : 10。

示例

const { totalCount, list } = await managementClient.policies.listAssignments(
  "CODE"
);

// list 数据示例

[
  {
    code: "PolicyCode", // 策略唯一标志
    targetType: "USER", // 'USER' 表示用户, 'ROLE' 表示角色
    targetIdentifier: "5f8812866795cc0026352fc5", // 用户 ID 或者角色 code
  },
  {
    code: "PolicyCode", // 策略唯一标志
    targetType: "ROLE", // 'USER' 表示用户, 'ROLE' 表示角色
    targetIdentifier: "ROLE_CODE", // 用户 ID 或者角色 code
  },
];

返回值

• Promise<PaginatedPolicyAssignments>

将策略授权给用户、角色、分组、组织机构

将策略授权给用户、角色、分组、组织机构，可以将策略授权给用户和角色，授权给角色的策略会被该角色下的所有用户继承 。此接口可以进行批量操作。

PoliciesManagementClient().addAssignments(policies, targetType, targetIdentifiers)

参数

• policies <string[]> 策略 code 列表
• targetType <PolicyAssignmentTargetType> 可选值为 USER (用户) 和 ROLE (角色)
• targetIdentifiers <string[]> 用户 id 列表和角色 code 列表

示例

import { PolicyAssignmentTargetType } from "authing-js-sdk";

await managementClient.policies.addAssignments(
  ["code1", "code2"],
  PolicyAssignmentTargetType.User,
  ["USERID"]
);

await managementClient.policies.addAssignments(
  ["code1", "code2"],
  PolicyAssignmentTargetType.Role,
  ["ROLE_CODE"]
);

返回值

• Promise<CommonMessage>

撤销策略授权

撤销策略授权，此接口可以进行批量操作。

PoliciesManagementClient().removeAssignments(policies, targetType, targetIdentifiers)

参数

• policies <string[]> 策略 code 列表
• targetType <PolicyAssignmentTargetType> 可选值为 USER (用户) 和 ROLE (角色)
• targetIdentifiers <string[]> 用户 id 列表和角色 code 列表

示例

import { PolicyAssignmentTargetType } from "authing-js-sdk";

await managementClient.policies.removeAssignments(
  ["code1", "code2"],
  PolicyAssignmentTargetType.User,
  ["USERID"]
);

await managementClient.policies.removeAssignments(
  ["code1", "code2"],
  PolicyAssignmentTargetType.Role,
  ["ROLE_CODE"]
);

返回值

• Promise<CommonMessage>