安全与授权流程

全链路鉴权场景

在整个调用过程中，一次调用从User、Agent、XingSKIl广场、开发者服务之间鉴权全流程入下

• 入站只做两件事：验签、判权限。
• 出站只做一件事：按声明的方式取凭证注入。
• 用户只在「用户级能力 + 首次调用」这一步出现，之后复用令牌(过期之前)，不再授权。

入站请求：Agent → 广场

入站的判定流程：三步放行，三种失败各有不同处置。

返回	含义	客户端动作
401	凭证无效或过期	换凭证重试
403	未装配或无权限	重试无用，去改配置
429	超出配额	按Retry-After 退避重试

用户请求--->智能体

1. 用户Oauth授权时机：装配不打扰，首次调用才授权，之后一路自动。

时点	动作
装技能	不授权
第一次真调用	弹授权，用户同意后按企业 + 应用 + 用户 + 服务 四个键存令牌
以后再调用	直接用存好的令牌
令牌过期	自动刷新，用户无感
刷新失败或被撤销	提示重新授权

首次授权就六步：调用 → 上游返 401 → 广场找到授权地址 → 引导用户登录同意 → 换令牌存库 → 重试成功，对于MCP使用场景，需要调用MCP服务时，header带入用户唯一标识，详细见MCP对接流程；

1. 其他方式：如用户自行填写 Access Token / API Key，则不需要授权同意，也不会弹窗授权；

出站：XingSKILL广场 → 开发者服务

三类能力差异：只有声明位置不同

能力	鉴权声明写哪
MCP	注册信息里（一个 server 一种方式）
SKILL	鉴权只写变量名（值通过环境变量注入）
A2A	AgentCard 的securitySchemes（一个 Agent 一种方式）

安全红线

1. 不硬编码密钥、令牌、连接串、内网地址。
2. 不信任自报身份，只信验签；不绕过广场直连上游。
3. 令牌不转发给上游，不跨用户跨租户复用。