跳到主要内容

服务账号与 API Key

服务账号和 API Key 用于系统集成、连接器、MCP 客户端、自动化任务和 AI Agent 工作流。这类身份没有人在键盘前操作,但应按生产身份管理,明确归属、scope、轮换和审计要求。

身份流程​

适用场景​

场景用途
数据连接器使用受控凭据从批准的数据源拉取或推送数据。
MCP 客户端让 AI 客户端只发现并调用该 endpoint 切片允许的 FactVerse 工具。
AI Agent 工作流检索授权上下文、运行受治理工具,并用可追溯身份记录动作。
企业自动化执行计划导入、导出、报表刷新或维修交接任务。
系统集成连接 EAM、CMMS、BMS、ERP、数据湖、文件服务或客户门户。

申请信息​

字段示例
业务负责人对集成结果负责的团队。
技术负责人对凭据存储、轮换和事件响应负责的团队。
租户和环境生产、预发布、私有云或本地部署。
endpoint 或产品区域DFS 连接器、ECM 导入、MCP 切片、AI Agent 工作流或产品 API。
所需 scope读取、写入、计算、动作草稿、审批或产品专用 scope。
数据范围租户、站点、资产组、文件夹、数据集或工作流范围。
轮换策略定期轮换和紧急撤销流程。

Scope 设计​

从能完成集成目标的最小 scope 开始。不要在无关系统或租户之间共享同一个 Key。

决策项建议
租户范围一个 Key 对应一个租户或部署范围。
产品范围DFS、ECM、MCP、AI 工作流归属不同时,使用独立 Key。
动作范围只读 Key 与可写入、审批、触发动作或改配置的 Key 分开。
生命周期按计划轮换;负责人变化或疑似泄露后立即轮换。
存储只存放在批准的密钥管理或部署配置系统中。

验证清单​

  1. 确认集成只能认证到目标环境。
  2. 确认工具发现或 API 访问只返回预期能力。
  3. 启用写入或动作 scope 前,先完成只读测试。
  4. 确认写入或动作测试能产生预期审计记录。
  5. 确认 Key 负责人、轮换负责人和撤销路径已记录。
  6. 确认 Key 被移除或过期时,集成会安全失败。

相关页面​