今日 TL;DR
OAuth把有限访问权交给应用;模型只能提出工具意图,可信服务端决定令牌和资源权限,不能把用户身份作为可自由填写的工具参数。
- 令牌应绑定目标服务、必要scope和有限生命周期,不能跨服务透传。
- scope是能力范围,资源归属与当前授权仍需服务端检查。
- 撤销连接、删除已保存记忆、取消在途任务是不同操作,界面和状态分别说明。
为什么今天学这个
昨天讨论长期记忆与可删除性,删除后用版本拒绝旧任务写回。今天为同一个跨工具准备台连接外部资料:用户允许读取岗位文档,不代表允许发送邮件,也不代表允许读取同租户其他人的简历。明天周六项目会把资源、工具、检查点、记忆与授权接在一起,今天先把最容易越界的身份边界做清楚。
OAuth可理解成用户给应用一张有范围的访问票,而不是把账号密码交给应用。授权服务器负责在用户参与后发票,资源服务器提供文档或业务API,客户端拿票调用。Access token是访问票,refresh token用于换新票;它们都不是模型需要阅读的知识。令牌可能是JWT,也可能是不透明字符串,不能只解码JWT就宣称验证成功。
本课按实际访问的MCP HTTP授权规范、OAuth安全最佳实践RFC9700与PKCE标准RFC7636解释机制。规范链接固定到2025-11-25版本,适用于该版HTTP传输授权;本地stdio的凭证获取是另一条边界。示例只演示资源端决策,不实现认证服务器、浏览器登录或完整MCP客户端,不需要真实凭据。
一张图讲清楚
PKCE是在授权开始时生成随机verifier,提交其S256挑战,兑换授权码时再提交verifier以证明是原客户端;它不是令牌签名算法。state用于关联授权请求与回调,不能把两者当同一个字段。生产还要校验回调地址、授权服务器身份和元数据,不能跟随不可信网页提供的任意授权端点。模型负责决定“想读哪份资料”,不负责选择“用谁的身份”。
三个核心要点
- 给必要能力,限定目标服务。 只读场景请求
docs:read,等到需要写入再按业务规则增量授权;本课scope名是教学定义,并非MCP统一标准字段。资源服务器验证令牌受众、发行者、签名或内省结果、到期与撤权。发给文档服务的票不能被拿去调用邮件服务,工具网关也不能把收到的令牌不加区分透传给下游。 - 能力范围之外还要检查对象。
docs:read不等于所有文档可读。读取前检查服务端可信主体、租户和具体文档ACL;缓存与恢复同样检查。模型传来的tenant、owner、scope字符串都是不可信输入,不能让它们覆盖登录上下文。工具发现可以只展示允许的能力,但隐藏按钮不能代替调用时授权。 - 撤权与资料删除分开落地。 撤销后阻止新调用、终止或隔离在途任务;已拿到的资料按昨天的生命周期管理。短令牌能缩小窗口,但不能保证立即失效;需要选择可满足业务时效的内省、撤销或授权版本检查。用可查的连接状态和拒绝原因帮助用户恢复,不把令牌原文写进日志。
最小可运行示例
Python 3.10+标准库即可。保存为scoped_access.py,执行python3 scoped_access.py。输入是测试令牌ID、可信会话和文档ID;输出先成功,再分别显示受众、scope、资源、过期和撤权拒绝。字典代表受信令牌内省结果,没有网络请求、JWT签名或真实OAuth发票;不要拿这段程序作为公网鉴权服务。
from dataclasses import dataclass
@dataclass(frozen=True)
class Claims:
subject: str
tenant: str
audience: str
scopes: frozenset
expires: int
grant: str
NOW = 1000 # 注入时钟,便于确定性验证
SERVICE = 'https://docs.example.org'
claims = Claims('u1', 't1', SERVICE,
frozenset({'docs:read'}), 1100, 'g1')
tokens = {'good': claims}
grants = {'g1': True}
docs = {'own': ('t1', 'u1', '岗位准备清单'),
'other': ('t1', 'u2', '别人的简历')}
def read_document(token_id, session, document_id, now):
# 这里只模拟可信内省;生产验证由认证组件执行
c = tokens.get(token_id)
if c is None:
raise PermissionError('invalid token')
if c.audience != SERVICE:
raise PermissionError('wrong audience')
if c.expires <= now:
raise PermissionError('expired')
if not grants.get(c.grant, False):
raise PermissionError('revoked')
if 'docs:read' not in c.scopes:
raise PermissionError('insufficient scope')
if session != (c.tenant, c.subject):
raise PermissionError('wrong principal')
record = docs.get(document_id)
if record is None or record[:2] != session:
raise PermissionError('resource denied')
return record[2]
def expect_denied(label, token, session=('t1', 'u1'),
document='own', now=NOW):
try:
read_document(token, session, document, now)
except PermissionError as error:
assert str(error) == label, (label, str(error))
print(label)
else:
raise AssertionError('unexpected access')
from dataclasses import replace
tokens['wrong-service'] = replace(claims, audience='https://mail.example.org')
tokens['write-only'] = replace(claims, scopes=frozenset({'docs:write'}))
print(read_document('good', ('t1', 'u1'), 'own', NOW))
expect_denied('wrong audience', 'wrong-service')
expect_denied('insufficient scope', 'write-only')
expect_denied('resource denied', 'good', document='other')
expect_denied('expired', 'good', now=1100)
expect_denied('wrong principal', 'good', session=('t2', 'u1'))
grants['g1'] = False
expect_denied('revoked', 'good')
预期依次打印“岗位准备清单”、wrong audience、insufficient scope、resource denied、expired、wrong principal、revoked。没有把拒绝当异常吞掉:每次断言都确认具体拒绝理由,只有成功授权才返回正文。实际HTTP接口对外可按规范返回401或403与必要挑战,日志记录请求ID和错误类别,不把所有内部判断细节暴露给未认证调用者。
代码为了教学让grant每次本地可查,撤权因此立即生效。真实分布式缓存、签名令牌离线验证和跨区域复制会带来延迟,必须测量并说明撤权窗口。授权检查与资料返回间也可能有竞争,强时效要求需要版本或事务边界;大文件下载过程中撤权是否终止,要按真实能力说明。此例没有refresh token轮换、secret存储、CSRF或PKCE交互,已通过本地检查不代表真实第三方授权已验收。
生产环境会怎么翻车
- 症状:资料服务的票被其他API接受。 根因是只验证签名、不验受众,或网关透传用户令牌。处理:限定资源标识并逐服务校验,向下游取得其专用凭据;拒绝不匹配票据。
- 症状:模型改owner参数就能读他人简历。 根因是业务授权相信工具参数。处理:主体来自可信会话,按资源ACL核对;即使同租户也不能默认全员可读,缓存命中后仍核权限。
- 症状:断开连接后后台任务继续读资料。 根因是只删浏览器状态、后台持有长期票或旧授权快照。处理:撤销grant、按可承诺时效失效缓存,任务每次敏感调用重新授权;已取资料另行删除。
- 症状:回调成功但换到错误账号。 根因是没有绑定请求会话、state和预期授权服务器。处理:使用成熟OAuth组件校验请求关联、回调URI、PKCE与服务器元数据,界面展示当前连接账号供用户核对。
动手练习
用20分钟增加docs:write操作,但不让原只读令牌获得写能力。再为grant加单调版本:发票时记录版本,撤销或重新连接都提升版本,旧票和旧检查点不能借新连接复活。完成条件:合法读成功;读票写入、跨资源、跨租户、过期、撤销与重连旧票全部拒绝;拒绝不改变文档。写明生产还依赖哪些真实认证组件,并说明本地模拟无法证明第三方撤销传播时效。
面试表达
30 秒回答
OAuth解决应用怎样取得有限访问权,资源服务器仍要验证令牌和具体资料权限。我按服务限定audience和scope,主体从可信会话注入,模型只能传业务对象。撤权后新调用必须拒绝,已保存资料另按生命周期删除,恢复检查点不能绕过当前授权。
追问与 3 分钟回答
问“有scope为何还查文档”,我会把能力与对象分开:read表示允许执行读取类动作,ACL回答能读哪份。服务检查发行者、受众、有效期与撤权,再按主体、租户和对象判断;客户端隐藏工具只改善体验,攻击者仍可能直接调用接口。
问“PKCE保护什么”,我说明客户端先生成verifier并提交挑战,兑换码时用原verifier证明请求关联,降低授权码被截取后被他人兑换的风险。它不代替HTTPS、回调校验、服务器验证或业务ACL。生产应使用成熟SDK而不是自己实现整套协议。
问“断开连接是否删除所有资料”,答案是否。撤权约束后续访问,记忆、缓存、检查点和第三方副本有各自清理流程。面向用户给出连接失效、在途任务处理和资料删除状态,按实测时效承诺。作品集展示这些拒绝路径和不变的业务状态,比单张登录成功截图更有说服力。
今日自测
1. 基础理解
访问票audience不匹配,但scope正确,可以接受吗?
不能。scope不能跨越目标服务边界;资源服务器必须拒绝不属于自己的令牌。
2. 工程取舍
离线验证的JWT还没到期,怎样承诺撤权立即生效?
不能仅凭短有效期承诺立即生效。需要选择内省、撤销检查或当前授权版本机制,处理缓存和传播窗口,并按实际能力说明。
3. 场景应用
用户重连资料服务后,昨天检查点中的旧票可以继续用吗?
不能自动恢复旧授权。重新核验主体、资源和当前grant,拒绝旧版本票据;已经删除的记忆也不能随连接恢复。
市场雷达
本期无新增市场信号。官方规范用于机制核验,访问日期不等于最近30天的新发布,不编造JD、薪资或招聘公司的原话。
权威来源
- MCP HTTP授权规范2025-11-25 — 授权发现、资源标识、令牌受众及禁止不当透传的边界。
- RFC9700 OAuth 2.0安全最佳实践 — 授权码、PKCE、令牌限制和刷新令牌保护。
- RFC7636 PKCE — verifier、S256 challenge与授权码兑换校验。
三页于2026-10-30 09:01(Asia/Shanghai)实际读取HTTP200。scope名称、本地检查器与练习为本课教学设计,不冒充OAuth认证服务器实现。
明天会用到
明天完成跨工具准备台:以只读连接取得获准资料,用工具生成准备清单,保存检查点与可删除记忆。验收要覆盖撤权后恢复拒绝、旧记忆不复活,以及工具结果的真实回执;外部写入仍遵守上周的具体动作审批。