OpenIddict Core 6.3.0 版本发布：新增OAuth提供商与功能增强

项目简介

OpenIddict 是一个开源的 OpenID Connect 和 OAuth 2.0 框架，用于 ASP.NET Core 应用程序。它提供了一套完整的工具集，帮助开发者轻松实现身份验证和授权功能。OpenIddict Core 是该项目的核心组件，而 OpenIddict.Client.WebIntegration 包则专门用于简化与各种第三方OAuth提供商的集成。

6.3.0版本主要更新

新增OAuth提供商支持

本次更新为开发者带来了两个新的OAuth提供商集成：

1. Contentful提供商：Contentful是一个流行的无头内容管理系统(CMS)，新增的集成使得开发者可以轻松实现基于Contentful的身份验证流程。

2. Genesys Cloud提供商：Genesys Cloud是一个客户体验和联络中心解决方案，新的集成简化了与Genesys Cloud的身份验证集成。

静态设置常量优化

在之前的版本中，配置某些提供商时需要手动输入字符串值来指定特定选项（如区域、访问模式等）。6.3.0版本通过源代码生成器为这些静态设置生成了常量字符串，大大提高了代码的可读性和安全性。

例如，现在可以这样配置Shopify、Stripe Connect和Zoho提供商：

options.UseWebProviders()
       .AddShopify(options =>
       {
           options.SetClientId("[client identifier]")
                  .SetClientSecret("[client secret]")
                  .SetAccessMode(OpenIddictClientWebIntegrationConstants.Shopify.AccessModes.Online);
       })
       .AddStripeConnect(options =>
       {
           options.SetClientId("[client identifier]")
                  .SetClientSecret("[client secret]")
                  .SetAccountType(OpenIddictClientWebIntegrationConstants.StripeConnect.AccountTypes.Express);
       })
       .AddZoho(options =>
       {
           options.SetClientId("[client identifier]")
                  .SetClientSecret("[client secret]")
                  .SetRegion(OpenIddictClientWebIntegrationConstants.Zoho.Regions.EuropeanUnion);
       });

这种改进不仅减少了拼写错误的可能性，还使得可用选项一目了然，提升了开发体验。

X/Twitter提供商更新

随着Twitter品牌更名为X，OpenIddict也相应更新了其集成：

1. 端点已从twitter.com迁移到x.com，避免了用户在授权流程中需要先从twitter.com重定向到x.com的额外步骤。

2. 默认显示名称更改为"X (Twitter)"，开发者可以通过SetProviderDisplayName()方法自定义显示名称：

options.UseWebProviders()
       .AddTwitter(options =>
       {
           options.SetClientId("[client identifier]")
                  .SetRedirectUri("callback/login/twitter")
                  .SetProviderDisplayName("Twitter");
       });

区域验证增强

对于Alibaba、Battle.net、Cognito、Lark和Zoho等提供商，现在当配置了无效的区域时会抛出异常，而不是静默使用默认值。这一变化使得配置错误能够更早被发现，避免了潜在的运行时问题。

Zoho提供商新增区域支持

Zoho提供商现在新增了对英国区域(https://accounts.zoho.uk/)的支持，为英国用户提供了更好的本地化体验。

技术影响与最佳实践

1. 迁移建议：对于使用Twitter集成的应用，建议更新到6.3.0版本以获得更流畅的授权体验。虽然旧版本可能仍然工作，但新版本消除了额外的重定向步骤。

2. 常量使用：建议开发者充分利用新引入的常量字符串来配置提供商选项，这不仅能提高代码质量，还能在编译时捕获潜在的错误。

3. 错误处理：由于区域验证变得更加严格，开发者在升级后应检查相关配置，确保所有指定的区域值都是有效的。

4. 测试策略：在升级版本后，特别是当应用依赖多个OAuth提供商时，建议进行全面测试，验证所有身份验证流程是否按预期工作。

总结

OpenIddict Core 6.3.0版本通过新增提供商支持和多项功能优化，进一步简化了OAuth/OpenID Connect集成工作。特别是静态设置常量的引入，显著提升了开发体验和代码质量。这些改进使得OpenIddict继续保持其在.NET生态系统中作为身份验证解决方案的领先地位。