Azure Auth 是一个专为现代 Web 应用设计的身份验证解决方案，专注于为 React 单页应用（SPA）和 Cloudflare Workers 后端提供 Microsoft Entra ID（原 Azure AD）集成支持。该工具通过结合使用 MSAL.js 前端库与 jose 纯 JavaScript JWT 验证库，实现了端到端的微软 SSO 认证流程。其核心架构采用授权码流 + PKCE 模式，有效规避了包括 AADSTS50058 循环登录、AADSTS700084 刷新令牌过期等常见认证陷阱。特别值得注意的是，由于 MSAL.js 依赖浏览器环境 API，在 Cloudflare Workers 中无法直接使用，因此本方案创新性地引入 jose 库进行服务端令牌校验，解决了无服务器环境下 JWT 验证的技术难题。整个系统已在生产环境中经过验证，支持从本地开发到云部署的全场景覆盖。
核心功能特点
- 基于 MSAL.js v5 和 jose 库的混合架构，同时支持 React SPA 前端认证与 Cloudflare Workers 后端 JWT 校验
- 完整实现授权码流 + PKCE 安全流程，防范中间人攻击并符合 OAuth 2.1 最佳实践
- 深度集成 Microsoft Entra ID 多租户能力，支持企业内网及跨组织用户统一登录
- 内置 JWKS 缓存机制与 OpenID Connect 配置自动发现，避免每次请求都拉取公钥
- 全面覆盖常见错误场景的修复策略，如 iOS Safari 会话丢失、React Router 重定向冲突、NextJS 动态路由初始化问题
- 提供完整的环境变量管理与 wrangler.jsonc 配置模板，简化 CI/CD 集成
适用场景
Azure Auth 特别适合需要快速接入企业级身份认证的现代 Web 项目。对于初创公司或中大型企业的内部管理系统，它可帮助团队在数小时内完成微软账户的统一登录集成，无需从零构建 OAuth 逻辑。典型用例包括员工门户、SaaS 产品客户平台以及需要合规审计的企业级应用。在后端服务方面，Cloudflare Workers 作为边缘计算平台，常需验证来自前端传递的 Entra ID 令牌以保障 API 安全。本方案通过 jose 库实现了轻量级、高性能的 JWT 校验中间件，适用于高并发场景下的身份鉴权需求。此外，针对已使用 Azure AD B2C 的客户，该工具提供了清晰的迁移路径指南，帮助平滑过渡至 Microsoft Entra External ID。无论是解决现有项目的 AADSTS50058 循环登录故障，还是预防未来因 ADAL 退役带来的兼容性问题，Azure Auth 都能提供可靠的技术支撑。