LiteLLM Agent Control Plane 安全体系完全指南：Master Key、虚拟密钥与权限隔离的 3 层防护

【免费下载链接】litellm-agent-control-plane1 place to call all your agents - OpenCode, Hermes, Claude Managed Agents, Cursor Agents API, DeepAgents.项目地址https://gitcode.com/gh_mirrors/li/litellm-agent-control-plane点击查看免费下载LiteLLM Agent Control Plane又称 LAP是一个统一的 AI Agent 网关让你在一个地方调用 OpenCode、Hermes、Claude Managed Agents、Cursor Agents API、DeepAgents 等所有 Agent 运行时。而它的安全体系正是团队可以放心接入多模型、多 Agent 的关键Master Key 认证把关所有入口每用户虚拟密钥实现细粒度授权权限隔离的凭据金库Vault保证上游 API Key 绝不出库。本文带你一次看懂这 3 层防护的设计与落地细节。为什么 Agent 网关需要专门的安全体系当所有 Agent 调用都汇聚到同一个网关时你会面临 3 个经典问题谁可以访问—— 不能让团队成员共享同一把万能钥匙到处传上游密钥怎么办—— Anthropic / OpenAI 等 Provider Key 必须加密保管不能暴露给调用方密钥泄露了如何止损—— 需要能随时吊销单把密钥而不影响其他人LiteLLM Agent Control Plane 的答案是分层密钥体系Master Key 负责认证调用者虚拟密钥负责按人授权金库负责隔离上游凭据。第一层Master Key 认证 —— 网关的总开关一键配置 Master KeyMaster Key 在config.yaml的general_settings下配置实际值从环境变量读取避免明文写进配置文件general_settings: master_key: os.environ/LITELLM_MASTER_KEY本地开发用 compose.yaml 启动时默认 Master Key 是sk-local可以通过.env中的LITELLM_MASTER_KEY修改。配置示例见 config.yaml.example。两种请求头格式都支持网关支持 2 种密钥传递方式按优先级排序对 OpenAI / Anthropic 风格的客户端都很友好优先级请求头格式1AuthorizationBearer key2x-api-key原始密钥无前缀核心校验逻辑只有十几行非常直观配置了 Master Key 时请求头中的密钥必须完全匹配否则返回401 Unauthorized未配置则放行适合本地实验。实现见 src/proxy/auth/master_key.rs。第二层每用户虚拟密钥 —— 团队不再共享总钥匙三步创建专属虚拟密钥认证通过后管理员可以按需为每个成员发放虚拟密钥而不是把 Master Key 发出去打开管理界面的Keys页面对应 src/ui/src/app/keys/page.tsx点击New Key给密钥起个名字label比如成员姓名创建成功后仅显示一次完整密钥团队成员把它配置为自己的Authorization: Bearer virtual-key即可也可以用 API 完成curl -X POST $LAP_URL/api/keys \ -H Authorization: Bearer $MASTER_KEY \ -H Content-Type: application/json \ -d {label: alice}密钥生命周期生成、追踪、吊销虚拟密钥的设计值得细看源码见 src/proxy/auth/api_keys.rs高强度随机生成sk-前缀 两个 UUID v4碰撞概率可忽略使用追踪每次用虚拟密钥通过认证时自动记录last_used_at方便排查这把钥匙最近谁在用️随时吊销DELETE /api/keys/{id}立刻失效不影响其他成员密钥列表与吊销接口见 src/http/management/api_keys.rsUI 端对应的密钥管理面板在 src/ui/src/components/api-keys-dialog.tsx。第三层凭据金库 —— 上游 API Key 的保险箱加密存储密钥永不以明文落库调用上游 LLM 用的 Provider Key如ANTHROPIC_API_KEY与认证用的密钥彻底分离Provider Key 加密后存入 PostgreSQL永远不对调用方暴露。加密采用 XSalsa20Poly1305Sodium 认证加密实现见 src/proxy/credential_crypto.rs每次加密使用随机 nonce同一明文每次密文不同加密主密钥来自LITELLM_SALT_KEY环境变量推荐或回退到master_key两者都缺失时直接报错拒绝服务personal / global 作用域权限隔离落到数据库层金库把每条凭据标记为 2 种作用域迁移脚本 0007_vault_scope.sql作用域归属可见性global管理员配置所有用户可见personal用户自己仅属主可见查询时严格限定scope global OR (scope personal AND owner_id $1)且解析个人密钥时个人密钥优先于全局密钥——同名覆盖互不串扰。仓储层实现见 src/db/vault_keys.rs用户侧读写接口在 src/proxy/vault.rs。认证不拖后腿性能设计细节分层认证没有牺牲速度。require_any_gateway_key采用三级快慢路径src/proxy/auth/master_key.rs本地 Master Key 比对 —— 纯内存零开销本地虚拟密钥比对 —— 纯内存零开销慢路径转发给外部 LiteLLM 的/key/info校验结果缓存 60 秒避免每个请求都打一次远端认证本身在 Rust 中完成整个网关代理层的开销对比如下示意数据安全速查清单场景推荐做法本地实验默认sk-local或干脆不配置 Master Key生产部署用环境变量LITELLM_MASTER_KEY注入别写进配置文件团队接入每人一把虚拟密钥定期在 Keys 页面核对last_used_at人员离职立即吊销其虚拟密钥无需轮换 Master KeyProvider 密钥轮换更新金库中的加密条目调用方无感知更多细节可以阅读官方文档 docs/learn/auth.mdx 与 docs/learn/architecture.mdx。Master Key、虚拟密钥、加密金库——三层防护各司其职让 LiteLLM Agent Control Plane 既能一处调用所有 Agent又能在多用户协作中守好每一把钥匙。赞分享【免费下载链接】litellm-agent-control-plane1 place to call all your agents - OpenCode, Hermes, Claude Managed Agents, Cursor Agents API, DeepAgents.项目地址https://gitcode.com/gh_mirrors/li/litellm-agent-control-plane点击查看免费下载相关推荐Quickemu安全审计虚拟机环境的安全隔离与风险防护Quickemu安全审计虚拟机环境的安全隔离与风险防护 引言虚拟化安全的重要性 在当今数字化时代虚拟机VM已成为软件开发、测试和生产环境的核心组件。Q虚拟化CLIHoneydew作业生命周期详解从创建到完成的完整流程Honeydew作业生命周期详解从创建到完成的完整流程 Honeydew是一个基于Elixir/Erlang BEAM虚拟机的高性能分布式作业队列系统。这个强后端openJiuwen agent-core 安全评审清单全解析覆盖密钥管理、注入防护与沙箱隔离的 10 类检查体系openJiuwen agent core 安全评审清单全解析覆盖密钥管理、注入防护与沙箱隔离的 10 类检查体系 导读 本文面向在 openJiuwen a人工智能AI AgentAgent 框架大模型工具调用RAG提示工程强化学习创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考