Coze私有化密钥托管需企业版支持，通过手动录入或环境变量注入添加密钥，Bot调用API时须从密钥管理库安全引用Bearer Token，禁用或轮换密钥可即时生效且保障安全。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在扣子（Coze）中配置私有化密钥托管，是为了让Bot调用外部API时避免硬编码敏感密钥，防止密钥泄露导致第三方服务被恶意调用或数据外泄。
确认工作区已启用企业版与密钥管理功能
进入Coze工作区设置 → 「安全与合规」→ 查看「密钥管理」模块是否可见。仅企业版及以上套餐支持该功能，免费版和专业版不可用。【未启用企业版将无法创建私有密钥条目，所有后续操作均无效】
若模块灰显或提示“请联系管理员开通”，需由工作区超级管理员前往「账户中心-订阅管理」升级至企业版，并完成实名认证与合同签署。
添加私有化密钥到密钥管理库
方法一：手动录入（适用于临时调试或低频更新）
点击「密钥管理」→ 「+ 新建密钥」→ 选择「自定义密钥」→ 输入密钥名称（如：notion_api_key_prod）、描述（如：用于同步客户CRM数据的Notion Integration Token）→ 在「密钥值」栏粘贴原始Token字符串 → 点击「保存」。
方法二：通过环境变量注入（推荐用于CI/CD集成）
在Bot开发页 → 「设置」→ 「环境变量」→ 添加键为COZE_SECRET_NOTION_TOKEN、值为实际密钥的条目 → 返回密钥管理页，点击「同步环境变量」按钮，系统会自动识别并创建同名密钥条目，状态标记为「来自环境变量」。
注意：手动录入的密钥值一旦保存即不可查看原文，仅显示为掩码；而环境变量方式可在部署流程中动态刷新，无需人工介入。
在Bot逻辑中安全引用密钥
第一步：打开目标Bot → 进入「Bot设置」→ 「插件与API」→ 点击「+ 添加API」→ 填写API基础信息（名称、请求地址、方法）。
第二步：在「认证方式」下拉菜单中选择「Bearer Token」→ 展开「Token来源」→ 选择「密钥管理库」→ 从列表中选中你刚创建的notion_api_key_prod条目。
第三步：保存API配置 → 返回Bot对话流编辑器，在需要调用该API的节点中，直接拖入此API插件即可。此时Bot运行时将自动从密钥管理库中安全提取Token，全程不暴露明文。
这一步不可跳过：若在API配置中误选「静态Token」并手动填写，密钥将被记录在Bot版本快照中，即使后续删除密钥条目，历史版本仍可被回溯还原出原始值。
轮换与禁用失效密钥
进入「密钥管理」列表 → 找到待操作密钥 → 点击右侧「⋯」→ 选择「轮换」：系统生成新密钥值并自动替换旧值，同时保留原名称与关联关系，Bot无需重新配置。
若密钥疑似泄露，立即点击「禁用」：所有引用该密钥的API调用将在10秒内中断，状态返回401 Unauthorized。禁用后不可恢复，需新建密钥并重新绑定API。
