Casdoor 1.919.0版本发布：增强Nextcloud集成与用户名兼容性

Casdoor作为一款开源的身份和访问管理（IAM）解决方案，持续为开发者提供灵活的身份认证和授权功能。最新发布的1.919.0版本带来了两项重要改进，进一步提升了系统的兼容性和集成能力。

Nextcloud OAuth提供程序增强

新版本在Nextcloud OAuth提供程序中新增了Domain字段配置功能。这一改进使得Casdoor能够更好地与Nextcloud实例集成，特别是在企业级部署场景下。

Nextcloud作为流行的自托管文件同步和共享平台，其OAuth认证流程需要精确配置才能正常工作。Domain字段的加入允许管理员明确指定Nextcloud实例的域名，解决了在多租户环境或复杂网络架构中可能出现的认证问题。

技术实现上，Casdoor现在会在OAuth认证流程中正确传递Domain参数，确保Nextcloud能够准确识别请求来源并完成认证流程。这一改进特别适合以下场景：

• 企业内部分布式部署的Nextcloud实例
• 使用自定义域名的Nextcloud服务
• 需要跨多个Nextcloud实例进行统一认证的系统

用户名特殊字符支持增强

1.919.0版本还改进了/api/get-email-and-phone API对特殊字符的处理能力，特别是支持了用户名中包含"+"等特殊字符的情况。

在身份管理系统中，用户名常常会包含各种特殊字符，而"+"字符在电子邮件地址中尤为常见。之前的版本在处理这类用户名时可能会遇到问题，导致API无法正确返回关联的邮箱和电话号码信息。

新版本通过优化参数解析逻辑，确保特殊字符能够被正确传递和处理。这一改进带来了以下优势：

• 提高了系统对复杂用户名的兼容性
• 确保使用特殊字符作为用户名的用户能够正常使用相关API
• 减少了因字符编码问题导致的API调用失败

技术实现细节

在底层实现上，Casdoor团队对相关API的请求处理逻辑进行了重构，确保在URL参数解析阶段能够正确保留特殊字符的原始形式。同时，对数据库查询部分也进行了相应调整，保证特殊字符能够被准确匹配。

对于Nextcloud集成部分，新增的Domain字段被纳入OAuth配置模型，并在认证流程中作为必要参数传递给Nextcloud服务端。这一改动保持了向后兼容性，确保现有配置不会受到影响。

升级建议

对于正在使用Casdoor的管理员，建议在测试环境中先行验证1.919.0版本，特别是：

• 正在或计划集成Nextcloud的组织
• 用户系统中包含特殊字符用户名的实例
• 依赖get-email-and-phone API的应用程序

这两个改进虽然看似不大，但对于特定使用场景下的用户体验和系统稳定性有着显著提升，体现了Casdoor团队对细节的关注和对用户需求的快速响应能力。