安全与凭证管理说明

核心原则

Heicode 是 SaaS 产品，不能把凭证管理转嫁给用户，也不能让密钥散落在 Git、Markdown、日志或子Agent 长期状态中。

安全目标：

• 用户授权资源，平台托管凭证。
• Heicode 服务端数据库只保存元数据和 secret_ref 。
• 长期密钥进入密钥保管器。
• 子 Agent 只拿短期、最小权限、可审计凭证。
• 高危操作必须由客户端审批。

凭证分类

密钥保管器

用户可见名称：密钥保管器。

技术实现：Azure Key Vault（azkv:// 引用，VM Managed Identity 鉴权，不使用 OpenBao/HashiCorp Vault）。

用户不需要直接登录 Azure Key Vault，也不需要看到 Azure Key Vault 控制台。

Secret Broker 流程

用户按准备清单连接资源
-> Heicode 接收授权结果
-> Heicode Secret Broker 写入 Azure Key Vault
-> Azure Key Vault 返回或形成 secret_ref
-> Heicode DB 保存 secret_ref
-> 前端只展示脱敏引用和状态

Heicode 接口不得返回明文密钥。日志、错误信息、审计摘要也不得包含明文密钥。

子 Agent 访问凭证

子 Agent 不保存长期密钥。

推荐流程：

用户确认推荐摘要
-> Heicode 后台生成授权和运行时策略
-> Agent 平台启动子 Agent
-> Agent 平台绑定运行时身份
-> 子 Agent 请求使用资源
-> 高危操作先走客户端审批
-> 审批通过后派生短期凭证
-> 短期凭证注入运行时
-> TTL 到期或任务结束后失效

高危操作

高危操作包括：

• 生产环境部署。
• 云资源创建、删除、扩缩容。
• 数据库迁移或写入。
• 访问生产密钥。
• 大额模型预算消耗。

审批必须记录：

• 审批人。
• 审批时间。
• 操作类型。
• 资源范围。
• 风险等级。
• TTL。
• 对应 deployment 或任务。

禁止事项

• 禁止把 token 写入 Git。
• 禁止把密钥写入 Markdown。
• 禁止前端返回明文密钥。
• 禁止在日志中打印密钥。
• 禁止把长期云密钥注入子 Agent。
• 禁止把 Azure Key Vault 暴露为普通公网入口。
• 禁止把 CodeGW key 原文交给客户端长期保存。

用户侧解释

推荐文案：

Heicode 会把你的授权凭证存入密钥保管器。你只需要按准备清单连接资源并确认推荐范围，平台会在后台生成必要的授权和运行参数。密钥不会写入 Git、文档、日志或子 Agent 长期状态。

验收标准