FerrisKey MCP 授权服务器:为 AI Agent 提供 OAuth 2.0 认证的创新实践
FerrisKey MCP 授权服务器:为 AI Agent 提供 OAuth 2.0 认证的创新实践
FerrisKey 是一款用 Rust 编写的高性能开源 IAM(身份与访问管理)方案。它的 MCP 授权服务器让 AI Agent 能够通过标准 OAuth 2.0 授权码流程安全地访问 MCP 资源服务器——用户身份、同意授权、令牌吊销,全部由身份提供方统一管理,AI 生态不再需要各自为战的密钥。
为什么 AI Agent 需要专门的 MCP 授权服务器
传统的 API 调用用一个静态 API Key 就够了,但 AI Agent 场景完全不同:
- Agent 代表用户行事:它访问的是"我的日历""我的数据库",必须逐次征得用户同意,而不是一张全局通行证;
- Agent 是公共客户端:没有安全的地方存放 client_secret,必须依赖 PKCE 这类防重放机制;
- 令牌要精准:发给 Agent 的 access token 只能用于指定的 MCP 资源,不能越权访问其他服务。
FerrisKey 的 MCP 授权服务器就是围绕这三个诉求设计的,核心能力可以概括为四件事:自动发现、精准受众、零密钥注册、委托交换。
一键发现端点:RFC 8414 授权服务器元数据
AI 客户端框架不需要手工配置一堆端点。访问 realm 级别的元数据地址即可:
GET /.well-known/oauth-authorization-server/realms/{realm}
返回的文档自动列出 authorization_endpoint、token_endpoint、jwks_uri、revocation_endpoint、introspection_endpoint,以及支持的授权类型(authorization_code、refresh_token、device_code、token-exchange 等)和 S256 PKCE 校验方法。动态注册(DCR)和元数据文档注册(CIMD)开启后,文档中会自动出现对应的 registration_endpoint 与 client_id_metadata_document_supported 字段,让客户端"看一眼就知道怎么用"。
实现位于 authorization_server_metadata.rs,完整的字段行为由 mcp_protocol_test.rs 中的集成测试逐项守护。
令牌受众精准绑定:Resource Indicators 实战
MCP 协议的关键约定是"令牌只对该 MCP 服务器有效"。FerrisKey 通过 OAuth 2.0 Resource Indicators(resource 参数)落地了这一点:
- 授权请求携带
resource=https://mcp.example.com/mcp; - 换取的 access token 中
aud恰好等于请求的资源 URI,不多不少; - refresh token 被绑定到同一资源,刷新时换资源会被拒绝,返回
invalid_target错误; - 资源不在 realm 允许列表(
allowed_resources)内时,直接拒绝,且错误重定向同样携带iss参数防止 CSRF。
相关数据库改动见 20261009120000_mcp_authorization_server.up.sql,行为验证见 mcp_protocol_test.rs。
零密钥注册:CIMD 与动态客户端注册(DCR)
AI 应用经常是"临时"的,让开发者去管理后台建 client 太重了。FerrisKey 提供了两条自动化通道,均在 realm 级别开关控制:
动态客户端注册(RFC 7591)
匿名 POST /realms/{realm}/clients/register 即可拿 client_id。FerrisKey 做了严格加固:按 IP 限流(超限返回 429)、响应头强制 no-store 防缓存泄露、confidential 客户端生成 43 字符长密钥、拒绝 password 这类不安全的 grant。实现见 register_client.rs。
Client ID Metadata Documents(CIMD)
client_id 可以直接是一个 JSON 文档 URL——文档即身份。FerrisKey 在 mcp_cimd_dcr_test.rs 中覆盖了大量攻击面:主机白名单(cimd_allowed_hosts)在拉取文档之前就拦截请求、文档过大/响应过慢/非 JSON 一律拒绝、private_key_jwt 认证方式不被接受,且元数据文档客户端永远会经过同意页面,同意界面还会展示文档宿主信息,让用户知道"是谁"在请求授权。
Resource Owner 与令牌交换:让 AI Agent 之间安全委托
多个 Agent 协作时(例如前端 Agent 拿到的令牌要交给后端 Agent 使用),FerrisKey 引入了 Resource Owner 机制:每个 MCP 资源 URI 可以绑定一个"属主"客户端,只有属主才能通过 token exchange 把用户令牌换成面向目标 client 的令牌,且令牌中保留 act 声明记录委托链,便于审计。
- 属主必须是 confidential 的管理端客户端,公共/动态客户端不能成为属主;
- 资源从
allowed_resources移除后,属主关系随之失效,交换立即停止; - 动态注册的客户端永远无法使用或获得令牌交换权限。
核心策略逻辑在 resource_owner_services.rs,端到端场景由 mcp_resource_owner_test.rs 验证。
快速体验:三步跑起 MCP 授权服务器
git clone https://gitcode.com/gh_mirrors/fe/ferriskey
cd ferriskey && docker compose --profile registry up -d
控制台默认在 http://localhost:5555,账号 admin / admin。进入 realm 设置后打开 dcr_enabled / cimd_enabled 开关、配置 allowed_resources 资源白名单,你的 AI Agent 就可以通过标准 OAuth 2.0 授权码 + PKCE 流程接入。本地开发细节可参阅 DEVELOPMENT.md 与 justfile。
小结
FerrisKey 的 MCP 授权服务器把 AI 时代的身份难题拆解成四个可组合的机制:RFC 8414 自动发现、Resource Indicators 受众绑定、CIMD/DCR 零密钥注册、Resource Owner 委托交换。全部能力以 Rust 实现、以 PostgreSQL 迁移脚本(core/migrations/)版本化、以 70+ 集成测试(api/tests/)守住安全边界——这正是"为现代云原生环境设计的高性能开源 IAM"应有的样子。如果你的产品正在接入 MCP 生态,不妨把它作为 AI Agent 的身份中枢来评估。
