Fastify OAuth鉴权开发
依据RFC规范在Fastify服务中接入OAuth 2.0/2.1授权码与PKCE流程,生成路由守卫并实现安全Token生命周期管理。
功能与用途
该能力专为 Fastify 框架设计,指导并生成符合 RFC 6749/7636 等标准的 OAuth 2.0 与 OAuth 2.1 鉴权实现。涵盖 @fastify/oauth2 插件集成、PKCE(S256)防劫持配置、CSRF 状态校验、Authorization Code 换取 Token、JWT 校验拦截器(含 exp、iss、aud 声明校验)、Refresh Token 自动轮换机制,以及路由级认证中间件防护。同时提供反模式排查与安全合规核对清单,帮助开发者避免凭证泄漏和重放攻击。
适用场景
- 接入授权码与PKCE登录:在 Fastify 中集成 @fastify/oauth2 插件,实现带 PKCE 防劫持的授权码流,并完成 CSRF 状态码防伪校验。
- 构建JWT鉴权路由守卫:编写全局或作用域 onRequest 拦截器,校验访问令牌的签名、有效期及发行方受众声明,保护受限 API 接口。
- 配置刷新令牌自动轮换:实现 Refresh Token 生命周期维护与轮换管道,在访问凭据过期时安全换发新令牌,降低重放攻击风险。
- 排查OAuth流程安全漏洞:核对重定向白名单、Session 安全属性及凭证存储方式,消除弱签名、Implicit 废弃流程等安全隐患与兼容故障。
适用人群
- Node.js/TypeScript 后端工程师
- Fastify 框架开发者
- API 安全与身份验证架构师
使用步骤
- 安装 @fastify/oauth2、@fastify/cookie、@fastify/session 等必要依赖包
- 在 Fastify 实例中注册 OAuth 插件,配置授权与令牌端点、回调地址及 PKCE 和 state 生成校验函数
- 编写登录与回调路由,在回调处理中使用 getAccessTokenFromAuthorizationCodeFlow 换取令牌并持久化
- 配置 onRequest 鉴权钩子验证请求头中的 JWT 关键声明,并将其挂载至需要保护的业务路由
- 添加 Token 刷新机制并遵循安全清单排查潜在漏洞
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- main
- 最近更新
- 2026-09-23
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Implements OAuth 2.0/2.1 authorization flows in Fastify applications — configures authorization code with PKCE, client credentials, device flow, refresh token rotation, JWT validation, and token introspection/revocation endpoints. Use when setting up authentication, authorization, login flows, access tokens, API security, or securing Fastify routes with OAuth; also applies when troubleshooting token validation errors, mismatched redirect URIs, CSRF issues, scope problems, or RFC 6749/6750/7636/8252/8628 compliance questions.
依赖与权限
- CLIENT_SECRET
- 读取用户主动提供的内容