@gapi/ ac 库是一个用于GraphQL应用程序的访问控制工具。 它帮助开发者管理不同用户角色的权限,例如GULT,USER,和ADMIN,跨越各种GraphQL动作,例如查询,突变,订阅和事件. 它允许开发者定义并强制执行规则,其中的角色可以访问或操纵系统中的特定资源.
关键特征包括:
基于角色权限:您可以根据用户角色定义访问控制(如GULT,USER,ADMIN),并控制他们可以执行的行动. GraphQL 聚焦:在 GraphQL 中为处理许可而专门构建,使其自然适合应用此API标准. 过滤数据 : 库允许根据用户角色过滤数据,因此不同角色只看到他们被授权访问的数据. 例如,管理员可以访问查询某个数据字段(状态),而普通用户可以部分访问,根据许可定义过滤出一些响应属性.
import { AccessControl, Union } from '@gapi/ac';
enum GraphqlActions {
query,
mutation,
subscription,
event,
}
enum Roles {
GUEST,
USER,
ADMIN,
}
interface IQuery {
status: {
status: number;
};
}
const Permissions: Union<typeof Roles, IQuery, typeof GraphqlActions> = {
GUEST: {
status: {
query: {
enabled: false,
},
},
},
USER: {
status: {
query: {
enabled: true,
attributes: {
status: false,
},
},
},
},
ADMIN: {
status: {
query: {
enabled: true,
},
},
},
};
const ac = new AccessControl<
typeof Roles,
IQuery & ISubscription & IMutation,
typeof GraphqlActions
>(Permissions);
const canAdminQueryStatus = ac.can('ADMIN', 'query', 'status');
const canAdminQueryStatus = ac.can('USER', 'query', 'status');
if (!canAdminQueryStatus) {
throw new Error('You are not authorized');
}
const data = { status: 200 };
const filteredData = await ac.filter('USER', 'query', 'status')(data);
filteredData; // { status: null }