核心概念
Agentbase 的资源层级为 账号 → Organization → Project。API Key、数据库、存储、函数、消息、站点等资源都归属 Project;成员通过 Organization 与 Project 两级角色协作。
Organization 与成员
截图未公开:原图可能包含账号或资源标识。
- Organization 是项目与成员的容器,提供组织级用量视图与成员治理。
- Organization Owner 负责成员管理与组织治理;账号管理、MFA 与成员角色的操作步骤见组织与账号中心。
- Account / Organization / Project 三级均提供最近 30 个 UTC 日的用量聚合,数据区分 0、缺失与不完整。
Project
- 创建 Project 时选择区域;区域决定资源放置位置(见项目总览)。
- Project 携带项目上下文(区域、服务开关、认证提供方、配额);Function 执行时注入项目上下文。
- 项目内的页面导航结构见界面与路由速查。
权限、安全与项目上下文
权限模型
- 层级:账号 → Organization(成员与角色)→ Project(按角色显示导航与操作)。
- 组织角色:Owner、Admin、Developer、Editor、Billing、Analyst。Console 写操作要求具备写角色(owner / admin / developer / editor),Billing / Analyst 只读。
- 资源级权限:数据库、存储、函数等资源支持细粒度权限配置,角色格式如
user:{id}、team:{id}/{role}。 - 服务端访问使用 API Key;前端使用受限的客户端 SDK 面。密钥与凭据只保存在服务端、不回显(如自定义 OAuth2 的 Client Secret、内容审核凭据、模型 Provider 密钥)。
项目上下文
- Project 携带区域、服务开关、认证提供方与配额;Function 执行时注入项目上下文(变量、权限)。
- 项目间数据天然隔离:跨项目访问需要各自项目的凭据与显式授权。
安全默认值
| 领域 | 默认行为 |
|---|---|
| 外部 URL | 拒绝本机、私网与云元数据地址(SSRF 防护) |
| Function / Site | 使用受限身份运行;不满足安全条件时直接失败,不回退为高权限执行 |
| Console SQL | 不向浏览器展示 MySQL wire 直连信息 |
| Schema 变更 | 激活前校验物理结构,失败保留当前生效版本继续服务 |
| 连接恢复 | 非事务请求可自动恢复;事务不自动重放,调用方需先确认结果再按幂等策略处理 |
| 存储审核 | 私有图片审核 fail closed,失败清理上传 |
| 登录 state | 一次性使用,绑定项目 / 浏览器 / callback / Client ID / state revision |
| 测试会话 | OAuth 登录测试产生的会话与 Console 会话隔离,退出测试不退出 Console |
| Function API Key | 不再接受 query string 传递,使用受保护 header 或平台注入的运行时认证路径 |
数据边界
- 内容审核日志只记录文件名预览,不记录原始图片字节或 Base64 内容。
- 已配置的密钥与凭据(API Key secret、OAuth Client Secret、Provider 密钥)在 Console 中掩码展示,读取边界由服务端强制。