@dokieli/web-access-control

中文文档
1.1.0发布于 2026/10/09Apache-2.0TypeScriptES Module构建来源已验证近 30 天下载 2104

Web Access Control(WAC)客户端库:WAC-Allow头解释,有效的ACL资源发现,授权查询,以及纯ACL补丁规划. 库允许客户端使用自己的RDF解析器和HTTP堆栈.

中文使用文档
文档目录9 节
  1. 许可证
  2. 安装
  3. 文档
  4. 特征
  5. 规格
  6. 遵约
  7. 捐款
  8. 由
  9. 支持项目

dokieli 网络访问控制

网络访问控制 (WAC)让客户阅读并更改资源访问控制的执行. 支持检查授权规则,规划授权,补丁资源,并允许客户端使用自己的RDF解析器和HTTP堆栈.

许可证

安装

npm install @dokieli/web-access-control

或者说

yarn install @dokieli/web-access-control
import { findEffectiveACL, isPublic, modesFor } from '@dokieli/web-access-control';

const ctx = await findEffectiveACL('https://example.org/article', { fetch });

modesFor(ctx, 'https://example.org/giuseppina#i');
isPublic(ctx);
import { applyPlan, planGrant, planRevoke, Public } from '@dokieli/web-access-control';

const plan = planGrant(ctx, { type: 'agent', iri: 'https://example.org/liliano#i' }, ['Read', 'Write']);

await applyPlan(plan, { fetch });

await applyPlan(planRevoke(ctx, Public), { fetch });

文档

见 API 参考 财务报告和审定财务报表 实例。 。 。 .

特征

  • 有效通过 Link rel="acl"。 。 。 .
  • 口译 WAC-Allow 头曰.
  • 查询管理资源的授权 .
  • 纯粹的补丁规划者,用于授予和取消访问,复制所继承的容器ACL.
  • 支持客户端和发行者 获取条件。 。 。 .
  • 适应服务器可接受性 PATCH 媒体类型(N3补丁或SPARQL 1.1更新).
  • 通过注射给呼叫者的认证 fetch。 。 。 .
  • 将Turtle从盒子中读出,或者通过调用方提供发回RDF/JS四相机进行任何序列化.

规格

遵约

图书馆执行WAC的东西 编辑草稿数字 :

  • 西非航:通过 Link rel=acl; 确定 有效的ACL资源; 数据 acl 词汇· ; WAC-Allow 组合和模式.
  • N3 补丁: 每个文档中, 包含一个空白的节点主题, 公式中没有空白的节点, 每个被绑入的变量 solid:where。 。 。 .
  • SPARQL 1.1 更新编号:地面 DELETE DATA编号 :INSERT DATA,则 DELETE {} INSERT {} WHERE {} 计划执行时的表格 where 模式.

规格不动的地方,图书馆有意见. WAC不需要特定的方式来写入ACL资源. 这么说吧, PATCH 与 Accept-Patch 协商是图书馆的选择 也是尝试 HEAD 在此之前 GET 为发现。 所有规划人员的行为都是政策:在访问被继承时复制并写,拆分多主体规则,重新编写模式到位,跳过一个补丁无法解决的规则,以及没有模式暗示(Write 并不意味着 Read) (中文(简体) ).

库根据 RFC 3986 的概念确定母容器 /s代表等级结合公约。 其他方法,例如:, rel="up",为 考虑。 。 。 .

有条件的授权 执行正在进行的工作。 其安全考虑塑造了规划者:一个没有条件支持的服务器评价一项授权时,其条件被忽略,给予的超过说明,因此只有在ACL资源发布支持广告时,条件才会自动附加,明确要求将条件写给一个不被拒绝的服务器,被克隆的授权总是保持其条件.

捐款

见 贡献指南 (c) 发展机制、测试和承诺.

由

支持项目

通过赞助项目,帮助项目发展 开放集体 或者联系我们.

版本与发布记录

@dokieli/web-access-control 共发布 2 个版本,首次发布于 2026/08/19;过去 12 个月发布了 2 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.1.0latest2026/10/091 个月前
1.0.02026/08/192 个月前

关于 @dokieli/web-access-control 的常见问题

@dokieli/web-access-control 是什么?

Web Access Control(WAC)客户端库:WAC-Allow头解释,有效的ACL资源发现,授权查询,以及纯ACL补丁规划. 库允许客户端使用自己的RDF解析器和HTTP堆栈.

如何安装 @dokieli/web-access-control?

在项目目录运行 npm install @dokieli/web-access-control,或使用 pnpm add / yarn add / bun add。

@dokieli/web-access-control 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@dokieli/web-access-control 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@dokieli/web-access-control 可以商用吗?

@dokieli/web-access-control 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@dokieli/web-access-control 的下载量有多少?

根据 npm 官方下载统计,@dokieli/web-access-control 在 2026/10/13 – 2026/11/11 这 30 天内被下载 2,104 次,日均约 70 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@dokieli/web-access-control 还在维护吗?

最新版本 1.1.0 发布于 2026/10/09(1 个月前);至今共发布 2 个版本,其中过去 12 个月发布了 2 个;首次发布于 2026/08/19。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。