1,767
// 项目简介
此 TypeScript 库提供了一个强大的框架，用于直接在 Cloudflare Workers 中实现 OAuth 2.1 提供程序。它自动化了令牌管理和请求身份验证，使开发人员能够专注于构建 API 逻辑，而无需处理复杂的安全协议。该框架具有高度的灵活性，不依赖于特定的 UI 实现和用户管理系统，同时通过哈希密钥确保了存储的安全性。
// 技术分析
这个 TypeScript 库为 Cloudflare Workers 专门构建了一个强大的 OAuth 2.1 提供程序框架，将复杂的协议需求抽象为易于管理的包装器。通过自动处理令牌管理、PKCE 支持和符合 RFC 标准的元数据发现，它使开发人员能够专注于核心 API 逻辑，而不是安全样板代码。该设计优先考虑灵活性，不依赖于特定的 UI 框架和用户身份验证方法，同时利用 Cloudflare KV 对授权数据进行安全加密存储。
// 核心亮点
01
实现了核心 OAuth 2.1 标准，包括 PKCE 支持和 RFC 8414/9728 元数据发现。
02
通过在将请求传递给自定义处理程序之前自动验证访问令牌，简化了 API 开发。
03
支持动态客户端注册 (RFC 7591)，允许以编程方式管理 OAuth 客户端。
04
为上游令牌同步等高级场景提供了灵活的令牌交换回调系统。
05
通过对存储的属性进行端到端加密并仅存储密钥的哈希值，确保了数据安全。
06
包含内置的维护实用程序（如 purgeExpiredData），可通过 Cron Triggers 保持 KV 存储的整洁。
// 典型使用场景
01
为 API 端点提供自动化的 OAuth 2.1 令牌管理和验证
02
支持动态客户端注册和符合 RFC 标准的元数据发现
03
安全加密存储授权元数据和自定义用户属性
// 快速开始
首先，安装该软件包并配置一个名为 OAUTH_KV 的 Cloudflare Workers KV 命名空间。在您的 worker 入口点初始化 OAuthProvider，定义您的 API 路由、处理程序和端点 URL。最后，使用通过 env.OAUTH_PROVIDER 接口提供的辅助方法来实现授权 UI 和 API 逻辑。