面向 Agent Skill 的 CLI/SSO 鉴权体系:安全、无感、可追溯
摘要
在智能体(Agent)通过 Skill 调用企业内部业务系统时,最大的阻碍往往不是接口能力,而是"鉴权"。
本文介绍一套面向 Agent 场景的 CLI/SSO 鉴权方案,围绕 sso-cli、业务 CLI 以及一个私有的 sso-sdk 包,构建起一套 token 不落盘、不对外暴露、多用户隔离、登录过程无感的安全鉴权体系。
文章会从安全痛点出发,逐层拆解 keychain 主密钥、密文文件、飞书 Hook 登录、Agent 轮询授权、临时环境变量等关键设计,并讨论各环节面临的卡点与解决策略。
1. 背景:为什么 Agent CLI 需要一套新的鉴权方案
2026年3月底,飞书开源了飞书CLI,一个多月时间狂揽 1w+ star,将 Agent CLI 这个概念带到了面前。
跟传统 CLI 面向人类不同,Agent CLI 是专门给 AI 使用的命令行工具:它输出结构化数据,拥有明确统一的退出码和错误语义,让大模型能像调用函数一样可靠地把它当成工具。飞书 CLI 把文档、审批、日历等业务能力封装成一个个可组合的命令,第一次系统性地展示了企业系统如何以「Agent 友好」的方式开放。在这个背景之下,企业内部也开始思考,并尝试将业务系统能力封装,通过 Agent CLI 的方式提供给到一众 Agent 框架。
然而,当真正动手把这些业务 CLI 接入 Openclaw、Claude Code 等 Agent 框架时,一个绕不开的障碍立刻出现了:鉴权。在这些框架下,用户通过自然语言驱动 Skill 调用企业内部的业务 CLI,而这些 CLI 最终依赖公司统一的 SSO 单点登录来访问 HTTP API。
在以往的 Web 时代,SSO 鉴权流程天然依赖"人在浏览器前":业务系统跳转至 SSO 平台,用户手动完成认证授权,后续请求携带 Token 进行鉴权。但 Agent 无法完成这一交互式登录,导致大量业务能力无法对智能体开放。
Before(接入前):
Now(接入后):
Agent CLI接入后,SSO鉴权面临三层递进式挑战:
1. 登录缺失 – 无浏览器交互能力,只能靠预置 Token,导致 Agent 无独立身份且 Token 大面积暴露; 早期实践中常采用"预先人工登录":开发者手动完成 SSO 登录,将长期 Token 写入环境变量、配置文件甚至硬编码,供 Agent 直接读取。
2. 隔离缺失 – 共享沙箱内用户身份互相覆盖,审计与权限控制失效; 想象一种情况:一个团队共享的智能体沙箱中,产品同事 A 刚完成登录,沙箱中存入了 A 的 Token。紧接着研发同事 B 在同一沙箱发起调用——如果没有用户隔离,B 的请求将沿用 A 的身份。审计日志显示为 A 的操作,而 B 可能越权访问了本无权限的数据。
3. 存储缺失 – 即便完成登录与隔离,明文 Token 仍使凭据极易被窃取,整体安全链路崩塌。
这些痛点指向同一个结论:必须为 Agent 设计一套原生的、脱离浏览器依赖的、多人隔离且防泄露的 SSO 鉴权体系——既要解决"Agent 如何登录",也要回答"Token 放在哪里才安全"以及"如何确保每一次调用都对应到真实的用户"。
针对这些痛点,我们设计了一套纵深防御的鉴权体系,核心原则只有几条,但它们贯穿了整个实现:
• 通过 Prompt 约束 Skill 行为:在 Skill 的安全准则中明确要求大模型不得在对话、日志、输出中暴露 Token 等敏感信息。 • Token 在任何常规载体中都不可见:不管是通过环境变量、文件系统、进程参数还是网络旁路,都拿不到明文 Token。 • 必须有 SSO 交互才能获得访问权:Agent 不具备直接获取 Token 的能力,必须触发用户交互,获取 Token 的能力内化在二进制业务 CLI 内部。 • 操作与用户身份强绑定:每次业务调用都携带当前真实用户的 SSO 凭证,做到可追溯。
下面我们分层阐述这套体系的具体架构。
2. 整体架构概览
整个鉴权体系由四个关键部分构成:
• sso-cli:一个独立的命令行工具,负责 SSO 登录流程的编排、凭证的安全存储、多用户隔离。它本身不提供 Token 直接读取的接口给外部。 • 业务 CLI:各个业务团队开发的命令行工具(比如 abtest-cli、trade-cli),它们是 Agent 实际调用的工具。这些 CLI 不直接处理 Token,而是依赖一个内部包来获取。• sso-sdk:一个内部私有的 SDK,只有被授权的模块才能引用。它封装了从本地安全存储中读取、解密 Token 的逻辑,对业务 CLI 暴露一个获取 Token 的渠道。当前提供了 GO 语言的 SDK。 • SSO 平台:公司内部的统一单点登录服务。在本次方案迭代中,SSO 平台新增了针对 Agent 场景的 poll 授权模式,支持下发一次性 code 并由客户端轮询换取 token,这是整套方案能够运转的基础通用能力。
整体架构图:
运行时,一次典型的调用流为:
1. Agent 根据用户意图,调用某个业务 CLI。 2. 业务 CLI 通过 sso-sdk包获取当前用户的 SSO Token。3. 若 Token 不存在或已过期,CLI 报错,Agent 感知到后触发 SSO 登录 Skill。 4. sso-cli启动登录流程,向 SSO 平台申请一次性 code,通过飞书卡片让用户授权,随后按间隔时间轮询 SSO 平台换取 Token。5. SSO 平台校验 code 并返回 token, sso-cli加密写入本地。6. 用户授权完成后,Agent 再次调用业务 CLI,此时 Token 已就绪,正常返回结果。
这套流程里最精妙的部分在于 sso-cli 的存储和交互设计,我们逐步拆解。
3. sso-cli:安全存储与无感登录的核心
sso-cli 的职责是:在极不安全假设(沙箱环境可能被任何人读取)下,安全地存储用户的 SSO Token,并支持多用户隔离。它的设计思想是"本地不留存可用明文,即使拿到密文和源码也难以解密"。
3.1 主密钥与 Keychain
sso-cli 首次运行时需要生成一个高熵的主密钥(Master Key),该密钥可以由密钥框架生成,常见的方式可以存储到各个操作系统的原生密钥链中:
• macOS:Keychain / File System / etc... • Linux:Secret Service / gnome-keyring / etc.. • Windows:Windows Credential Manager / DPAPI 加密 + HKCU 注册表…