Skip to content

访问权限与配置权威 ​

删除一个调用密钥后,另一个请求保存模型映射,不能让已删除的密钥重新出现。模桥把管理权限、调用权限和上游凭据分开,再让同一个持久化配置对象逐项处理修改,避免不同 Worker 实例拿旧快照相互覆盖。

三类凭据各自做什么 ​

凭据用途不能替代什么
管理员 Secret(ADMIN_PASSWORD)在登录入口换取管理员会话,管理账号、调用密钥和映射不作为模型接口的调用密钥
网关调用密钥(API Key)供客户端访问模型目录、聊天和向量接口不授予后台管理权限,不直接作为供应商凭据发送
上游凭据由选中的账号用于供应商请求;包括 API Key、Cloudflare Token、OAuth 刷新令牌不作为客户端调用密钥或管理员会话

远程状态部署中,三个平台通过独立服务令牌访问同一自建 SQLite 服务,不需要 KV/DO;原生 Cloudflare 兼容部署仍必须具备 KV、CONFIG_STORE 和管理员 Secret。第四类高权限服务凭据和部署范围见多平台入口。配置缺失会阻止正常服务;没有调用密钥或删除最后一个密钥时,模型入口也不会自动开放。具体设置见根 README(仓库文件:README.md)。

管理员登录后获得随机、不透明的会话令牌。浏览器通过 HttpOnly; Secure; SameSite=Strict Cookie 携带会话,服务端保存令牌哈希,并检查来源站点、密码指纹和 24 小时有效期。退出登录撤销服务端会话;更换管理员 Secret 会使对应来源的旧会话失效。密码哈希本身不是可用的管理员令牌。管理写入还会拒绝带有外站 Origin 的请求。

权限实现(仓库文件:_worker.js)可定位 checkProxyAuth / adminSessionRequest / handleAdminSessionOperation / handleDashboardApi;会话与页面安全断言(仓库文件:tests/security-hardening.test.mjs)检查撤销、过期、密码轮换和外站写入。

一次删除与一次保存怎样共存 ​

以下是由配置并发回归(仓库文件:tests/config-auth.test.mjs)约束的代表场景,不是线上观测:

顺序与状态处理结果
两个请求都曾读到密钥 K每个请求只能在自身范围内复用读取结果
请求 A 删除 K配置对象执行 key.delete,保存当前配置
请求 B 保存模型映射执行 models.replace,只替换映射,不提交旧的整份配置
后续请求使用 K从当前配置读取调用密钥,K 不会被旧快照复活

自建部署的配置权威是 SQLite state_records 表中的 config 记录;原生 DO 模式则是 app-config-v1 对象中的同名记录。账号增删、密钥增删和映射替换共享同一业务引擎,SQLite 用事务覆盖完整读改写,DO 在对象内串行执行。网关配置缓存只存在于单次请求中,不能跨请求延长已撤销权限;后端故障不会触发另一权威的回退。

原生 DO 只有在持久化配置尚不存在时,才读取旧 KV 的 config 进行一次迁移。自建服务从不读取 KV,只允许在尚无业务状态的数据库中显式导入配置。新安装初始化默认映射及空账号、空密钥列表;已有配置不会被旧快照覆盖。旧配置或权威配置损坏时拒绝加载,而不是恢复可能含已撤销密钥的快照。显式保存的空映射 {} 也不会被当作缺失配置重新填满。

账号保存可能先进行 OAuth 登录与项目查询。等待网络期间,其他请求仍可能更新或删除账号,因此写入前会比较账号版本;不一致返回 409,要求重新加载。该比较与串行配置操作一起保护持久化结果,不表示所有业务网络请求都被一个全局锁串行化。

配置实现(仓库文件:_worker.js)可定位 GatewayStateStore / AppConfigStore / configRequest / expectedAccountRevision;SQLite 实现(仓库文件:src/state/sqlite.mjs)及真实持久化断言(仓库文件:tests/sqlite-state.test.mjs)覆盖跨连接、跨进程事务与重启。请求间隔离断言(仓库文件:tests/config-scope-regressions.test.mjs)与异步验证冲突断言(仓库文件:tests/quota-project-regressions.test.mjs)补充检查网络等待边界。具体迁移、备份和单机运行约束见平台状态服务。

编辑账号时凭据怎样保留 ​

同一供应商内编辑账号,凭据留空或保留界面掩码可以沿用原凭据。更换供应商时必须重新输入真实的新凭据,旧地址、模型列表、账号身份和 OAuth 项目等设置不再作为默认值继承。

例如把已有 OpenAI 账号改成 Gemini:只修改类型、留下 ******** 会在连接测试或保存前返回 400;填写新 Gemini 凭据后,目标使用新类型的默认地址或本次显式填写的地址。旧 OpenAI 凭据不会被带往这个目标。账号列表读取只返回凭据掩码;这不代表凭据在存储中不存在,也不应把后台配置导出当作公开资料。

Antigravity 账号可手动填写邮箱和刷新令牌,不要求导入 auth.json。自动发现的项目与凭据身份关联,凭据改变后重新发现;显式填写的手动项目保留。登录刷新与连接测试的消耗边界见上游请求与配额。

账号归一化(仓库文件:_worker.js)可定位 normalizeProviderAccountInput;跨供应商编辑回归(仓库文件:tests/review-account-embedding-round2.test.mjs)检查保存、连接测试和表单清理。

接下来阅读模型路由与协议边界,理解通过鉴权后哪些账号能被选中;需要修改位置时使用代码地图。

证据状态:除特别标注外,本页基于当前源码已确认。