MCP授权:身份、受众与资源范围分别校验
MCP授权:身份、受众与资源范围分别校验,从执行机制、错误边界与可运行例子理解工程取舍。
一个token可以访问服务A,不能因此原样转发给服务B。服务端如果不验证token的受众,就可能接受本来签发给别处的凭证;如果再代用户调用高权限下游,就会形成混淆代理问题。接通MCP只建立通信,授权仍需单独设计。
远端HTTP与本地stdio边界
本页对照2025-11-25授权规范。远端HTTP服务作为受保护资源,客户端发现相应资源和授权服务器元数据,按受支持流程获得面向目标资源的访问token,再带token调用服务。授权服务器、资源服务器与客户端承担不同职责,不能把授权服务器返回的任意JSON当作已经认证的用户。
stdio场景通常从运行环境取得凭证,而非照搬HTTP授权流程。本地并不天然安全:子进程可能读取继承的环境变量、文件和网络。为其提供最少环境和权限,审查启动程序与来源,不把所有云密钥都继承进去。远端凭证同样不能被放入模型上下文或日志。
以授权码流程说明实际顺序:Client通过受保护资源元数据定位授权服务器,读取其端点和PKCE能力;生成仅本次流程使用的随机verifier及S256 challenge,跳转用户授权时带challenge、注册的回调地址、state与目标resource。回调收到code后先核state与回调上下文,再向token端点提交code、原verifier及同一resource;授权服务器核验配对后签发token,Client才用Bearer头调用MCP资源。这里resource在授权与换token两次请求中都指向目标MCP服务,不能只在本地日志里记录受众。
PKCE使截获code而不知道verifier的一方不能正常换取token;它不代替用户授权、TLS、回调地址检查或资源端验权。按本页固定规范,发现元数据缺少PKCE支持声明时应停止授权,不能静默降级。故障对照可以保持同一code却换verifier,或把resource从A改成B,分别检查换token与资源验证边界;本文只讲协议情境,没有真实签发或兑换token。具体要求见固定版授权规范。
token验证的几个独立问题
若采用JWT等可本地验证的结构化token,先通过可信库验证签名、算法、密钥来源和必要声明,再验证issuer、audience、有效期、scope与资源范围。MCP并不要求访问token一定是JWT;不透明token应按签发方约定由资源端查询可信状态,例如使用受保护的OAuth Token Introspection端点取得active和授权元数据,再做资源范围检查,不能对随机字符串强行解JWT。签名有效只说明某个签发方签过,不保证当前服务应接受;audience正确也不保证用户能读租户B的文件。身份、动作权限和对象范围需要同时满足。
授权码流程还要正确处理PKCE、重定向地址和客户端状态等约束,避免截获或错误回跳。对缺少权限的请求给出明确可恢复错误,按规范触发必要的授权提升;不能让模型替用户批准新增权限。
服务端调用下游时,不应把收到的token不加区分透传。应使用适合目标资源的委托凭证或服务身份,并保留用户范围限制。访问URL的工具还要限制目标和重定向,防止通过服务端请求访问内网地址;允许HTTPS不等于防住SSRF。
跟做:已验证claims仍要逐项判断
保存为token_boundary.py,运行python -X utf8 token_boundary.py。程序接收人工字典,明确假设签名等前置验证已经完成;它不解析或验签JWT,也不实现OAuth。只把此函数放到生产接口会让伪造字典通过,不能这样使用。
"""只验证已经过验签的claims决策,不能验证JWT真实性。"""
def authorize(claims,now,tenant):
if claims.get('iss')!='https://issuer.example':return 'wrong_issuer'
if claims.get('aud')!='https://mcp.example':return 'wrong_audience'
if claims.get('exp',0)<=now:return 'expired'
if claims.get('tenant')!=tenant:return 'wrong_tenant'
if 'policy:read' not in claims.get('scope','').split():return 'missing_scope'
return 'allowed'
if __name__=='__main__':
valid={'iss':'https://issuer.example','aud':'https://mcp.example','exp':200,'tenant':'A','scope':'policy:read'}
for change in [{},{'aud':'https://other.example'},{'exp':99},{'tenant':'B'},{'scope':''}]:
print(authorize(valid|change,100,'A'))实际运行输出:
allowed
wrong_audience
expired
wrong_tenant
missing_scope正确样本通过,错误受众、过期、跨租户和缺scope分别拒绝。将now改为200时,原样本也过期,因为有效期边界使用小于等于。生产还需按库和协议考虑时钟偏差、撤销策略与密钥轮换,不应自己手写密码学。
Server与Client开发的最小分工
Server负责验证凭证、资源授权、参数与业务限制、输出脱敏及审计;Client负责安全存储凭证、授权交互、请求配对、错误恢复和权限展示。双方协商能力不能代替其中任一项。开发测试至少覆盖错受众、过期、权限撤销、跨租户、错误重定向和不允许的网络目标。
本地机制测试之后,还需要用固定版本官方SDK和真实授权测试环境验证完整流,核对HTTP头、错误挑战和恢复路径。本页未运行远端授权服务器,因此不会把claims检查说成完整MCP安全验收。
综合追问:签名有效、会话存在,跨租户读取为何仍必须拒绝?
这是给定条件下的机制推演;数值用于解释判断,不是新增线上或模型实测。先独立回答,再核对下面的推理。
展开推理、取舍与排错路径
远端HTTP先通过资源/授权服务器发现与受支持授权流取得面向目标资源的token;本地stdio通常依赖运行环境凭证,两者不能照搬。服务端可信库验签后仍查issuer、audience、有效期、scope和对象租户。给服务A的凭证不应被服务B接受,协议会话定位也不代表用户已认证。
Client负责凭证保护、授权交互、重定向/PKCE等流程与恢复;Server负责身份、资源范围、业务限制和审计。便利地透传token给下游可能形成混淆代理,应换用目标适用委托/服务凭证并保留用户范围。调试分别构造错受众、过期、撤权和跨租户请求,核对在哪层拒绝;不把手工claims字典通过当验签/OAuth成功。本地子进程只给必要环境秘密,远端访问URL还需SSRF控制。
课后练习展开习题收起习题
先独立作答,再展开参考思路。检查自己的解释是否包含机制、条件和反例。
签名正确为什么还会拒绝?
参考思路与常见误区
token可能给其他受众、已过期、scope不足或不属于当前资源范围;密码学真实性不等于业务授权。
常见误区:只验签就放行。
MCP会话身份和用户身份一样吗?
参考思路与常见误区
会话标识用于协议状态定位,用户权限需要认证上下文与资源授权独立保证。
常见误区:会话ID就是权限。
本地stdio如何处理凭证?
参考思路与常见误区
按运行环境提供最少必要凭证并限制子进程权限,不照搬HTTP授权流程也不继承所有秘密。
常见误区:本地服务无需权限控制。
能直接把token转发到下游吗?
参考思路与常见误区
不能无条件透传,应验证受众并使用目标资源适用的委托或服务凭证,同时保留用户范围约束。
常见误区:任何签名token都通用。
示例检查通过能证明OAuth安全吗?
参考思路与常见误区
不能,它只检查预验证claims,完整签名、发现、授权交互与网络安全仍需集成测试。
常见误区:把字典判断当完整认证。
协议与接口细节请对照:官方资料1。