运行时依赖
无特殊依赖
安装命令
点击复制官方npx clawhub@latest install auth0-fastify-api
镜像加速npx clawhub@latest install auth0-fastify-api --registry https://cn.longxiaskill.com
技能文档
概述
此技能用于在 Fastify API 中集成 Auth0 身份认证和授权功能。
功能特性
- JWT Bearer 令牌验证
- Scope/Permission 权限检查
- 无状态认证支持
- 与 @auth0/auth0-fastify-api 集成
使用场景
当需要：
- 保护 Fastify API 端点
- 验证用户身份
- 实施基于角色的访问控制
快速开始
npm install @auth0/auth0-fastify-api
配置
在 Fastify 应用中配置 Auth0 插件：
import { auth } from '@auth0/auth0-fastify-api';
await fastify.register(auth, { domain: process.env.AUTH0_DOMAIN, audience: process.env.AUTH0_AUDIENCE });
保护路由
使用 auth 装饰器保护特定路由：
fastify.get('/protected', {
preHandler: [fastify.auth]
}, async (request, reply) => {
return { message: 'Protected route', user: request.user };
});
权限检查
验证用户的 scope：
fastify.get('/admin', {
preHandler: [fastify.auth, fastify.requireScope('admin:access')]
}, async (request, reply) => {
return { message: 'Admin only' };
});
环境变量
AUTH0_DOMAIN=your-tenant.auth0.com
AUTH0_AUDIENCE=https://api.example.com
更多信息
请参阅 Auth0 Fastify API 文档 获取完整的使用说明。