@fungi.computer/veil

中文文档
0.7.4发布于 2026/11/14MITTypeScriptES Module近 30 天下载 7790

团队授权的证书保管和提供方准入

中文使用文档
文档目录8 节
  1. 安装
  2. 设置
  3. 南戈适配器
  4. 公共网门
  5. 关键路线和制裁门
  6. 证书范本和故障处理
  7. 打开API 门
  8. 贡献

韦尔(@fungi.computer/veil(中文(简体) )

Veil将提供商的资质 远离代理。 主机存储 API 密钥, OAuth 连接和模型键在信任的主人门后,一个代理接收到一个 授权操作,绝不是提供者的标志或它居住的地方。 它拥有 共享连接核心( MCP, OpenAPI 和一个寄存器的 git 端点), 模型钥匙 和代理的匿名 公共网络检索.

安装

npm install @fungi.computer/veil

设置

宿主提供主人的 SQLite, a CustodyAdapter 及其生活状况 授权 createConnections (单位:千美元)@fungi.computer/veil/connections) (中文(简体) ). 监护是 sealed 默认; 南戈是可选适配器 (单位:千美元)@fungi.computer/veil/connections/nango) (中文(简体) ). 模型输入不能选择 连接、寄存器或私人定位器。 没有监护权配置,请报告 不可用,而不是制造连接.

GitHub REST 是一个普通 openapi 关系 oauth 证书 : 通过操作员注册的提供商使用监护适配器,或通过 南果融会. 托管人-管理一体化由东道主负责 (单位:千美元)configuredCustodyIntegrations)到一地表类型和一地源 核心拒绝 begin 在每一次派遣之前,他都是信使 坚守不动 GitHub REST 被固定为 api.github.com。 。 。 .

电脑的基特不是这个核心的连接. @fungi.computer/veil/github-app 包着南戈的 github-app 融合 (单位:千美元)NANGO_GITHUB_APP_INTEGRATION_ID,永远与 NANGO_GITHUB_INTEGRATION_ID:它打开安装协议,验证 签名补全, 找到丢失的, 删除连接并读取当前 安装标志 。 中心在向 github.com 财务报告和审定财务报表 没有别的地方.

南戈适配器

createNangoCustody 使用 Nango 服务器来源、 API 密钥、 单独的 Webhook 签名密钥, 用于粘贴证书的 API 密钥集成, 以及公众 连接 UI 基础和公共 API URL 。 这些是主机配置, 从不浏览器 或模型输入. connect 返回打开的连接文档浏览器:南戈 已发布链接, 限制在配置的连接 UI 上, 并锁定在公共 API 上 与 apiURL。 。 。 . verifyCompletion 验证原始召回体 @nangohq/node 在解码之前 核心只能解决 主人开始了。 未配置主机必须报告不可用而不是替换 假的监护.

inject 通过南戈的代理,它连接和刷新 证书; 绑定的删除端点返回 200 {success:true} 之后 删除和 400 {error:{code:"unknown_connection"}} 当连接是 没有,只有那些清扫。 一个代理 404 不再是保管人 保持连接并标记它重新连接的要求. find 问南戈 一个连接,一个尝试的状态,演员和团队, 所以一个登录 签了字的工事仍无法解决 取消会停止呼叫 等待;它没有证明上游工作停止或倒退.

configuredComputerGitIntegration(env) 命名集成 计算机的基特符号 英寸NANGO_GITHUB_APP_INTEGRATION_ID(三); NANGO_GITHUB_INTEGRATION_ID 加入所有者可能签名的集成 用于 REST 连接 .

公共网门

@fungi.computer/veil/public-fetch 被批准为特工的进取者 web.fetch。 。 。 . configuredPublicFetch({ connect, fetch }) 返回时 get,一个 匿名者得到的,没有证书 并且只有 Accept 财务报告和审定财务报表 User-Agent 请求标题。 每次调用都会解决名称一次( DNS- over- HTTPS 通过 fetch如果答案不是公开的,则拒绝全名(IPv4和 IPv6,包括回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回回, 6to4和Teredo表格,只将那些已检查的地址传给东道主 套接字原生( r)cloudflare:sockets connect (原始内容存档于2018-09-29). In the Hub. URL 的自有名称 保留 Host 页眉和 TLS 服务器名称, 因此第二个查询无法移动 连接. get 从不遵循方向; 呼叫者下一个跳是新的 调用它再次解决和检查。 答复由 http-parser-js· ; 被压缩,分层编码和超长头的反应被拒绝.

员工的 startTls({ expectedServerHostname }) 验证证书 对照该名称;它报告第1行的核查失败 门类型为 unavailable。 。 。 .

关键路线和制裁门

configuredProviderEgress(env, { keyed }) 还服务于主机的路线 登记册。 A 类 KeyedRoute 名称 2 工人绑定, 无证书的 HTTPS 根数( e)urlBinding和一个秘密(keyBinding),加 (中文(简体) ) accepts(root) 针入 配置了 root, 即秘密旅行的地方({ in: "query", name } 或者说 { in: "path" }),以及一个Zod body jSON POST 设定路径的策略 可能发送。 Veil自己看两本书,所以主机的名字 从来没有看到 他们的价值观。 主机路由可能不会阴影 Veil 路由, 重复使用 1 绑定 两者兼有,或称Veil自有的监护权约束;建筑拒绝.

就像现有的Hub搜索呼叫器(apps/hub/src/agent-web-search.ts, (中文(简体) ), configuredWebSearch),呼叫者获得 baseUrl(route) 和通过 通过证书自由请求 providerFetch(egress, route)请求 准确的被钉入的根作为单 POST 其JSON 身体 宿主计划接受; 不转发调用信头、查询和替代路径。 这个 无法返回具有证书的 URL baseUrl。丢失、无效或 拒绝未接受的约束 unavailable 在取回之前; 其他目的地, 拒绝的方法或机构 denied. 拒绝指示和非-2xx回复 unavailable;没有返回上游错误正文、信头或 URL。 成功 尸体被绑定在64个MiB并被证书回音拒绝(raw, JSON- escaped) 或%- 编码); 请求机构被绑定在64 KiB. 运输故障, 包括终止,仅曝光固定 VeilError 密码 在已有的密钥中保留密钥 私人工人秘密监管,绝不是团队存储,公开配置,遥测或 木头。 最后的传输查看了授权的URL,不得登录.

Veil还拥有一扇匿名门:

路线目标/ 允许的呼叫私人约束
sanctions-screen准确点 https://sanctionslistservice.ofac.treas.gov/api/PublicationPreview/exports/SDN.XMLSANCTIONS_SDN_URL (准确的URL,选入)

单枪匹马就能被制裁 1个HTTP 302 准确的外国资产管制处 导出为 https://wc2h-sls-prod-public-published.s3.us-gov-west-1.amazonaws.com,带有 路径开始 /Published/ 结束 /SDN.XML。外国资产管制处的签名查询是: 保留;不转发呼叫信头/证书和上游饼干。 这个 位置字符串上限为 8,192 个代码单位,必须没有用户信息或 部件,不能更改 HTTPS 或端口 443 。 Veil 取消重定向体 在第二个 GET 之前, 使用原始的中止信号( 包括任何呼叫者) 截止时间,从未重新启动),并保持相同的64 MiB 下载绑定. 又一个 主机/路径、缺失/无效位置、第二次方向调整或任何其他方向调整 拒绝状态 unavailable直接输入S3和非GET制裁请求 仍然拒绝。 外国资产管制处的公开名单要求 无证书,所以没有 制裁 API 密钥绑定 。 呼叫者解析 XML 并判定匹配 表示; 此门只获取已公布的列表 .

供应商合同来源: 外国资产管制处的数据格式 以及上面准确的官方出口。 单元固定装置证明保管和路线 政策,而不是提供钥匙或生活在上游.

证书范本和故障处理

src/model-credentials.ts 选择哪个密钥类可用于推论 请求。 个人密钥不会成为 App 的证书; App 起源 请求使用团队授权的拘留或拒绝。 保管人处理提供者 相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相去相相去相去相去相去相去相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相相 授权的团队演员可以断开连接; a 失败的刷新标记, 它需要重新连接 。 逾期完成或被取代的完成是 没有静静地激活。 请求被取消后, 呼叫者将停止等待, 但是 无法证明提供者已经允许停止工作 .

没有供应商证书、服务启动、主机部署或备份恢复 通过安装或测试此适配器而建立。 验证配置的服务 和团队主人分开。 清单宣布麻省理工学院 捐款说明.

打开API 门

@fungi.computer/veil/openapi 揭发私人 createOpenApiDoor 答应 外相为相. ./openapi-effect 拥有相同的打出效果程序。 只有小组 连接器所有者在检查当前附件修改后, 拨打这个门, 选中的操作和读/写效果 。 这不是一个客人原始请求工具.

匿名、 API 密钥头/ query 和无记名请求共享公共比对 套接字执行:仅公用 HTTPS, 一个已检查的 DNS 分辨率, 固定 地址为原始主机/TLS名称,之后没有方向。 车主 通过被绑定的基础 URL 和选定操作的已声明标题名称 . 门拒绝保留头部, 认证覆盖和基地外的目标 路径。 请求和响应机构上限为256KiB,整个行动地点为 30秒后,HTTP解析出64 KiB的响应头. 答复正在进行 仅文本/ JSON 及其介质类型; 上游 cookie 和其他标题不是 已经返回。 非-2xxx答复曝光 upstream_status 和数字状况, 没有上游错误文本。 常见的信用回声被编辑.

configuredOpenApiDoor 读取 OPENAPI_CREDENTIAL_MASTER_KEY 仅在 守门人. 这个32字节的基数64 工人秘密封印证书 与 WebCrypto AES-GCM相通. 主办方提供 OpenApiCredentialStore 那个 仅由团队和连接器键入的持续密码文本。 认证数据绑定 它的主人, 固定基础和认证政策。 商店必须取消 在写作之前; 密码文本留在私人所有者那里, 从来不是特工的事实, 浏览器 DTO 或日志 。 驱出是一等能. 改变基准或授权政策 需要重封; 复制的密码文本不能授权另一个所有者或主机. 主机拥有持久的清理和关键供给/恢复;此套件确实存在 期间不安装秘密、 坚持简写或联系远程服务 测试。 遗失的监护权或证书是一种打字拒绝,不是匿名的 倒计时.

OAuth 仅限于主机配置 OpenApiOAuthProvider 端口,由 现有的南戈代理。 提供者修正其基础; spec 无法选择 另一个目的地。 南戈保留了OAuth的监护权和自己的侵略政策. 没有 采用了通用 OAuth 提供者或新的南戈实例。 未配置 提供者拒绝 oauth_not_configured. API 密钥/接发器 交通从未使用 南果相会.

C4的打出拒绝是 denied, (中文(简体) ), invalid_input, (中文(简体) ), invalid_response, (中文(简体) ), too_large, (中文(简体) ), timeout, (中文(简体) ), cancelled, (中文(简体) ), unavailable, (中文(简体) ), credentials_missing, (中文(简体) ), oauth_not_configured 财务报告和审定财务报表 upstream_status (带有数字) status。错误 从未携带请求 URL、 证书字节、 原始响应文本或传送 事业.

东道方用品 networkPolicy.extraPorts (默认为空), deniedHostSuffixes (确切姓名加儿童姓名),以及 deniedCidrs 联合国 拥有基础设施。 没有部署地址是硬码 。 OpenAPI 允许 HTTPS 除非主机明确添加了端口。 相同的被钉住的 HTTP 适配器 对照 URL 主机和 每个 检查 DNS 答案; 一个被拒绝 回答拒绝整个电话。 CIDR解析和匹配属于ipaddr.js, 包括已映射的IPv4. 更古老的匿名公共网站 获得合同也许可 普通 HTTP 端口 80; 任意端口需要主机配置. 这些 策略来自信任的主机配置,从不连接器数据.

保管用途 keys: { activeKeyId, keys },带有32字节基数64url 密钥以非密钥索引。 信封载有第1版和密钥代号; 密钥 ID 与 Team 、 Connector 、 Base 和 认证 政策 一同 认证 。 打开 旋转,保留用于读取的旧密钥,而所有新的封条都使用活性密钥. 只有在其剩余记录被重新封存或被去除后,才将旧钥匙退役. configuredOpenApiDoor 用途 OPENAPI_CREDENTIAL_KEY_ID (默认) primary用于 OPENAPI_CREDENTIAL_MASTER_KEY外加提供主机 previousCredentialKeys。 。 。 . 关键材料从不离开私人保管港 未知的密钥 ID 和 复制/ 替换的ids 拒绝; 没有旧信封 shim .

原始反应、 JSON 逃避反应、%编码、基数64和基数64url 在送还一具尸体之前 信任的回声 答复信头仍限于 媒体类型,拒绝敏感媒体类型; 上游错误仍然存在 只有数字状态。 OAuth 端口现已接收 teamId 以及私人事务 定位器;适配器必须验证连接属于该团队. C7级 必须完全从团队拥有的连接器记录中获取定位器 崩溃 连接 - 不可用/ 超时到一个代理创建代码 .

贡献

运行 pnpm --filter @fungi.computer/veil test 用于包的合成 监管,签名-webhook 和公开检查。 单位测试不能证明 南戈服务或供应商账户.

见 LICENSE。 。 。 .

版本与发布记录

@fungi.computer/veil 共发布 20 个版本,首次发布于 2026/10/17;过去 12 个月发布了 20 个版本。

版本发布日期距今
0.7.4latest2026/11/141 天前
0.7.32026/11/141 天前
0.7.22026/11/142 天前
0.7.12026/11/132 天前
0.7.02026/11/133 天前
0.6.62026/11/105 天前

关于 @fungi.computer/veil 的常见问题

@fungi.computer/veil 是什么?

团队授权的证书保管和提供方准入

如何安装 @fungi.computer/veil?

在项目目录运行 npm install @fungi.computer/veil,或使用 pnpm add / yarn add / bun add。

@fungi.computer/veil 支持 TypeScript 吗?

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

@fungi.computer/veil 支持 ESM 还是 CommonJS?

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

@fungi.computer/veil 可以商用吗?

@fungi.computer/veil 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@fungi.computer/veil 的下载量有多少?

根据 npm 官方下载统计,@fungi.computer/veil 在 2026/10/16 – 2026/11/14 这 30 天内被下载 7,790 次,日均约 260 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@fungi.computer/veil 还在维护吗?

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