APEMIND / 安全架构与数据边界
ApeMind 安全架构、数据存放与权限边界
企业级 RAG 平台的安全评估取决于可核验的工程边界,而不是泛化的合规口号。下表逐条对照 ApeMind 部署架构、权限模型、连接管理与平台治理文档编写,包括当前已明确记录的限制与运维责任。
可验证的安全与架构事实表
| 审计维度 | 已核验的产品实现 | 明确边界与客户运维责任 | 核验依据 |
|---|---|---|---|
| 部署形态与故障域 | 提供 SaaS(apemind.ai)与两种正式私有化方案:单台标准 VM 的 Docker Compose,以及 3 台服务器起步的 Kubernetes + KubeBlocks Enterprise(前端、API 与索引工作器多副本部署)。 | Docker Compose 属于单机故障域;集群高可用方案的唯一正式交付组合为 ApeMind + KubeBlocks Enterprise,客户仍需负责底层集群、告警值班与变更审批。 | 通用部署架构 |
| 数据存放位置 | 原始文件存放于对象存储(新私有化安装默认使用主仓 standalone RustFS chart,显式启用时兼容 legacy KubeBlocks MinIO);业务元数据存放于 PostgreSQL;图谱存放于图 PostgreSQL;向量存放于 Qdrant;全文索引存放于 Elasticsearch;缓存与队列存放于 Redis。 | 私有化部署中,磁盘、备份策略、异地留存及定期恢复演练由客户运维团队按制度落地。 | 存储拓扑 |
| 网络与外联边界 | 私有化部署时核心应用与数据组件均运行在客户内网。语言模型、向量/重排模型、解析服务(MinerU / Mistral OCR / LlamaParse)、联网搜索与外部 MCP/HTTP 连接按部署与组织显式配置。 | 私有化部署不自动等于“零外联”:导入敏感资料前,需逐项核查模型服务、OCR 解析器、联网出口与外部 MCP/HTTP 连接的网络流向。 | 模型与路由配置 |
| 双层角色与权限隔离 | 站点角色(admin / rw / ro)负责用户、配额、限流与部署级治理;组织角色(Owner / Admin / Editor / Viewer 及按动作组合的自定义角色)负责组织内知识库、智能体、问答集与连接。 | 站点管理员不会自动获得组织知识库、文档或智能体的业务数据读取权限;访问组织数据仍需加入该组织并持有对应动作权限。 | 权限与数据边界 |
| 默认拒绝与存在性隐藏 | Web 界面、REST API、智能体、MCP 与分享链接共用同一个授权内核,并在每一次真实读取时重新判定;未列出的动作默认拒绝。 | 组织成员缺少动作时返回明确拒绝;与资料无关的调用方收到“不存在”,防止未授权方探测知识库或资源是否存在。 | 访问判定流程 |
| API Key 与机器身份 | 每把 API Key 创建时固定绑定到单个工作区,不会随持有者切换工作区漂移。提供普通 Key(支持 30/90/365 天过期)、智能体托管 Key(随智能体生命周期托管,防误删)与服务账号 Key(非人身份,明文仅签发时展示一次)。 | 数据 API Key 不提供平台管理权限;组织治理面可查看全部绑定本组织的 Key 并吊销非受保护 Key。 | 机器身份与密钥 |
| 外部连接凭据边界 | 连接凭据与上游 OAuth 令牌只写不读(不出现在接口响应、日志、审计或报错中),与非敏感配置分表存储;修改数据库地址、MCP URL、HTTP base_url 或鉴权方式时自动清空已存凭据。 | 已明确记录的限制:连接凭据与上游 OAuth 令牌在 PostgreSQL 中按明文存储,并非应用层静态加密,数据库备份会包含它们,请务必对数据库存储与备份加密并严格管控访问。 | 连接凭据说明 |
| 数据库连接防线 | PostgreSQL / MySQL 连接实施只读 SQL AST 校验(仅放行 SELECT / 只读 CTE / UNION,拦截 DML/DDL/多语句/COPY/EXPLAIN/SET/系统目录及 pg_sleep/dblink/LOAD_FILE 等函数),并在只读事务中执行(上限 200 行、256 KiB、30 秒)。 | 应用层校验不能替代数据库侧最小权限原则,仍须创建专用只读数据库账号;connection.create 具备内网端口测试能力,建议仅授予可信角色。 | 数据库连接边界 |
| 协议入口隔离(MCP / A2A) | MCP Server(/mcp/)逐层校验 workspace_access、collection_access 与 web_access,不回退到浏览器 Cookie 或服务端环境变量凭据。A2A 1.0 名片(/v1/a2a/bots/{bot_id}/agent-card.json)为私有接口,仅接受绑定组织的 API Key。 | 平台不公开 /.well-known/agent-card.json;无调用权限的 Key 访问 A2A 名片返回 HTTP 404。 | A2A 与 MCP 边界 |
| 配额、限流与审计 | 支持按组织设置资源配额(知识库数、文档总数、单库文档数、Bot 数),支持系统默认与单用户限流策略(带乐观锁防并发覆盖 409 REVISION_CONFLICT)、1–168 小时拒绝记录以及 API/工具调用审计日志。 | 资源配额仅按组织维度计算,不提供单用户配额;限流拒绝记录用于排查 429,不能替代完整的 API/MCP 调用审计账本。 | 平台配置与治理 |
| 开源与可审计范围 | 核心 RAG 引擎 ApeRAG 在 GitHub 公开开源(github.com/apecloud/ApeRAG),可公开审计核心检索与编排逻辑;ApeMind Enterprise 在此基础上提供企业治理、外部连接器与私有化交付能力。 | 采购与安全评审时,可按需核对具体功能归属开源 ApeRAG 还是商业发行版 ApeMind Enterprise。 | 认识 ApeMind |
上线前安全自检清单
- 梳理全部外联依赖(对话模型、向量/重排模型、OCR/解析服务、联网搜索及外部 MCP/HTTP 连接)并配置相应出口防火墙规则。
- 对 PostgreSQL、对象存储与持久化卷启用底层存储与备份加密(尤其注意外部连接凭据在 PostgreSQL 中以明文存储)。
- 使用两个不同组织的测试账号与工作区绑定 API Key 实测越权访问,确认无关主体收到“不存在”。
- 验证站点 admin 账号在未加入目标组织的情况下无法读取该组织的知识库与智能体数据。
- 在导入正式业务数据前,完成 PostgreSQL、图 PG、Qdrant、Elasticsearch 与 RustFS 的备份和恢复演练。
安全与架构常见问题
平台站点管理员能直接看到所有组织的私有知识库吗?
不能。ApeMind 将站点角色(admin / rw / ro)与组织角色(Owner / Admin / Editor / Viewer 及自定义角色)分开管理。站点管理员可以治理用户、配额和系统配置,但不会自动获得组织业务数据的读取权限,仍需成为该组织成员并具备对应动作授权。
私有化部署是否意味着数据绝对不会离开内网?
不能一概而论。私有化部署确保核心应用与数据库运行在客户网络内,但如果配置了公有云大模型 API、云端 OCR 解析器、公网搜索或远程 MCP/HTTP 连接,对应请求仍会发出内网。需将这些依赖全部指向内网自建服务或关闭外联功能,才能实现全离线运行。
外部连接(如数据库、飞书、MCP)的凭据是如何存储的?
凭据与上游 OAuth 令牌在界面和 API 上只写不读,不会写入日志、审计或错误信息,并与非敏感配置分表存放;修改目标地址或鉴权方式时会自动清空旧凭据。需要特别注意的是,这些凭据在 PostgreSQL 数据库中当前按明文存储而非应用层静态加密,因此必须妥善保护数据库与备份文件的访问和磁盘加密。
如何防止智能体在对话中越权读取无权限的文档?
所有检索和工具调用都在真实读取时经过统一的授权内核校验。对话中的提示词或选材参数永远不能扩大授权范围,API Key 也固定钉在创建时绑定的工作区,不会因切换上下文而越界。
ApeMind 是否开源可审计?
核心引擎 ApeRAG 在 GitHub 公开开源(github.com/apecloud/ApeRAG),支持公开代码审计;ApeMind Enterprise 为企业商业发行版,面向 SaaS 及私有化 Docker Compose / Kubernetes + KubeBlocks Enterprise 生产交付。
相关架构与选型页面
查看私有化部署资源估算
在启动 POC 或生产部署前,可参考官方资源配置文档估算 Docker Compose 或 Kubernetes + KubeBlocks Enterprise 的计算与存储规模。
查看资源配置建议