第13章 创建和管理 drawDB API 密钥
## 第13章 创建和管理 drawDB API 密钥 创建、重命名、轮换、设置过期以及撤销 drawDB Pro API 密钥,适用于 MCP 客户端及其他集成场景。API 密钥允许脚本和集成系统以你的 drawDB 账户身份执行操作。当前仅读的 API 用于 drawDB MCP 服务器。
像对待密码一样对待密钥 密钥可以访问你所在团队的所有云端图表元数据,并读取通过最新访问权限检查的架构。切勿将密钥提交到版本控制系统、粘贴到聊天记录中,或分享给他人。
创建密钥
打开 drawDB 编辑器并登录。 点击头像,然后选择“管理账户”(Manage account)。 打开“API 密钥”(API keys)。 选择“创建密钥”(Create key)。 赋予其易识别的名称,例如“工作笔记本上的 MCP”(MCP on work laptop)。 选择过期时间:30 天、60 天、90 天;一年;或永不过期。 创建密钥,并立即复制完整的令牌(token)。
新密钥默认 30 天过期。名称最多可包含 80 个字符。 令牌仅显示一次 drawDB 存储的是哈希值而非完整令牌。如果在关闭创建对话框前未保存令牌,需创建替代密钥;原始值无法恢复。
密钥以 ddb_ 开头。API 密钥表后续仅显示短前缀、过期日期和最后使用时间,以便你在不暴露完整密钥的情况下进行识别。 重命名密钥 使用密钥旁边的操作菜单,选择“编辑”(Edit)。重命名仅更改标签,不会轮换令牌或更改过期时间。 轮换密钥 使用以下步骤在不中断集成系统的情况下替换密钥:
创建替代密钥。 更新使用旧密钥的所有客户端。 确认替代密钥可以正常连接。 删除旧密钥。
撤销密钥
打开密钥的操作菜单,选择“删除”(Delete)。 在确认对话框中输入 DELETE。 选择“删除密钥”(Delete key)。
删除立即生效。所有仍配置该密钥的客户端都将停止身份验证。 了解密钥访问权限 API 密钥绑定到用户账户,而非编辑器中的活动工作区。
list_diagrams 可能暴露你所属所有团队的 ID、名称、方言和更新时间。在当前版本中,该列表可能包含后来因“仅限受邀者”(Invite-only)或“无访问权限”(No-access)规则而拒绝读取架构的图表。 更改活动工作区不会将密钥的范围限制在该工作区。 每次架构请求都会执行全新的权限检查;移除访问权限会阻止架构读取,即使其摘要仍显示在列表中。 仅限本地的 OSS 图表无法通过 API 访问。 创建或重命名密钥需要具有云存储的有效套餐。 套餐或试用结束后,你仍可以删除密钥。
为实现最小权限访问,请使用专用 drawDB 账户,该账户仅属于集成系统所需的工作区。 选择过期时间 优先选择实际可行的最短生命周期。永不过期的密钥能减少维护工作,但会加剧未察觉泄露的影响。“最后使用”(Last used)值可在撤销前帮助识别废弃密钥。
继续使用 通过 MCP 将 drawDB 连接到 AI 工具。 在 GitHub 上编辑 最后更新于 套餐、试用、席位和计费 比较 drawDB Pro Solo 和 Team 功能,管理 Paddle 计费,理解团队席位,取消订阅,并恢复过期的访问权限。 通过 MCP 将 drawDB 连接到 AI 工具 配置只读的 drawDB MCP 服务器,使 Claude Desktop、Cursor、Cline、Goose、Windsurf 及兼容客户端能够检查云端架构。