骡子快跑提供四种secrets管理方案：一、原生vault集成；二、托管vault桥接器；三、嵌入式加密kv存储；四、第三方云kms直连，分别适配自建基础设施、轻量部署、离线合规及云原生场景。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您正在使用骡子快跑（MuleRun）构建需要安全访问敏感凭证的AI Agent工作流，但尚未配置可靠的密钥与证书管理机制，则可能面临凭据硬编码、权限过度开放或轮换困难等风险。以下是骡子快跑支持的secrets管理方案：
一、原生Vault集成方案
骡子快跑2.0版本起提供对HashiCorp Vault的官方适配能力，通过标准AppRole认证方式连接KV v2引擎，实现运行时动态拉取数据库密码、API密钥、TLS证书等敏感数据。该方案要求用户自行部署并维护Vault服务，适用于具备基础设施控制权的中大型团队。
1、在Vault中启用KV v2 secrets引擎，路径设为secret/mulerun/；
2、创建专用AppRole角色，绑定最小权限策略，仅允许读取secret/mulerun/*路径；
3、将AppRole的role_id与secret_id作为环境变量注入骡子快跑Agent容器；
4、在Agent配置文件中声明vault_enabled: true，并指定Vault地址与命名空间；
5、在任务逻辑中调用secrets.get("db_password")接口，自动完成token续期与后端KV读取。
二、骡子快跑托管Secrets Vault桥接器
针对无自建Vault能力的用户，骡子快跑提供轻量级桥接器组件，可将本地Vault实例注册为受信外部密钥源。该桥接器运行于用户侧网络边界，不上传任何密钥至骡子快跑云端，所有通信经双向mTLS加密，且仅响应来自已签名Agent请求。
1、下载mulerun-vault-bridge二进制包，适配Linux x86_64或ARM64架构；
2、配置bridge.yaml，填入本地Vault地址、TLS证书路径及白名单Agent ID列表；
3、启动桥接器服务，并确保其监听端口（默认9091）对骡子快跑Worker节点可达；
4、在骡子快跑控制台的“密钥源管理”页面，添加类型为Vault Bridge的新源，填写桥接器HTTP地址；
5、创建Agent时，在“安全上下文”中勾选该Vault Bridge源，并映射所需密钥路径到环境变量名。
三、嵌入式加密KV存储方案
对于离线或强合规场景，骡子快跑支持启用内置加密KV存储，所有密钥以AES-256-GCM加密后落盘于本地SQLite数据库。主密钥由用户通过助记词或硬件安全模块（HSM）注入，不经过网络传输，满足GDPR、等保三级对静态数据加密的要求。
1、在Agent初始化阶段调用secrets.init_local_encrypted_store()，传入助记词短语；
2、使用secrets.set("api_key", "sk-xxx", ttl=3600)写入带过期时间的密钥；
3、通过secrets.get("api_key")获取明文值，调用时自动完成解密与TTL校验；
4、执行secrets.rotate_master_key("new_mnemonic")可触发全量密钥重加密；
5、导出密钥备份需显式调用secrets.export_backup("backup.aes")，该文件仅能被原始助记词还原。
四、第三方云密钥服务直连模式
骡子快跑兼容主流云厂商密钥管理服务（KMS）的标准化接口，包括AWS Secrets Manager、Azure Key Vault与阿里云KMS。无需部署中间件，Agent可直接通过云平台IAM角色获取临时凭证，访问对应密钥版本。
1、为运行骡子快跑Worker的云主机或容器配置具备secretsmanager:GetSecretValue权限的IAM角色；
2、在Agent配置中设置secrets_provider: aws-secrets-manager，并指定区域与密钥ARN；
3、密钥名称须符合云平台命名规范，例如prod/mulerun/db-credentials；
4、启用自动轮换后，Agent每次调用get()均返回当前活跃版本，旧版本自动失效；
5、所有密钥访问行为将同步记录至云平台CloudTrail或ActionTrail审计日志，不可删除且保留至少180天。
