Nginx-UI 集成 Casdoor SSO 登录的配置指南

背景介绍

Nginx-UI 是一个基于 Web 的 Nginx 配置管理工具，最新版本 2.0.0-beta.24 开始支持通过 Casdoor 实现单点登录(SSO)功能。Casdoor 是一个开源的身份认证和访问管理平台，可以与各种应用集成实现统一的登录体验。

配置步骤详解

1. 准备工作

在开始配置前，请确保您已经：

• 部署了可用的 Casdoor 服务
• 获取了 Nginx-UI 的最新版本(2.0.0-beta.24 或更高)

2. 配置文件修改

Nginx-UI 的 Casdoor 集成配置需要通过修改 app.ini 文件实现。以下是完整的配置模板：

[casdoor]
Endpoint     = http://your-casdoor-server:port  # Casdoor 服务的基础URL
ClientId     = your-client-id                  # 在Casdoor中注册应用时获取
ClientSecret = your-client-secret              # 在Casdoor中注册应用时获取
Certificate  = """                             # Casdoor服务的证书
-----BEGIN CERTIFICATE-----
证书内容
-----END CERTIFICATE-----
"""
Organization = built-in                        # Casdoor中的组织名称
Application  = nginx-ui                        # 在Casdoor中注册的应用名称
RedirectUri  = http://your-nginx-ui:port/#/login  # Nginx-UI的登录页面URL

3. 关键配置项说明

1. Endpoint：指向您的 Casdoor 服务地址，包括协议(http/https)、主机名/IP和端口。

2. ClientId 和 ClientSecret：这些凭证需要在 Casdoor 中为 Nginx-UI 创建应用时获取。

3. Certificate：Casdoor 服务的 TLS 证书，用于安全通信。如果 Casdoor 使用自签名证书，这里必须提供正确的证书内容。

4. RedirectUri：必须精确匹配 Nginx-UI 的登录页面完整 URL，包括协议、端口和路径。

4. 常见问题解决

4.1 登录后仍返回登录页面

这种情况通常由以下原因导致：

• RedirectUri 配置不正确，必须与 Nginx-UI 实际登录 URL 完全一致
• 证书配置错误，导致身份验证失败
• Casdoor 应用配置中的回调 URL 与 Nginx-UI 配置不匹配

4.2 证书相关问题

如果遇到证书验证问题：

• 确保证书内容完整，包括 BEGIN 和 END 标记
• 证书内容必须使用三重引号(""")包裹
• 如果 Casdoor 使用自签名证书，必须提供正确的证书内容

实现原理

Nginx-UI 的 Casdoor 集成基于 OAuth 2.0 协议实现：

1. 用户点击"SSO 登录"按钮
2. Nginx-UI 将用户重定向到 Casdoor 认证页面
3. 用户在 Casdoor 完成认证后，被重定向回 Nginx-UI
4. Nginx-UI 通过回调验证用户身份并建立会话

最佳实践建议

1. 生产环境建议使用 HTTPS 协议
2. 定期轮换 ClientSecret 增强安全性
3. 在 Casdoor 中配置适当的权限控制
4. 监控认证日志，及时发现异常登录行为

通过以上配置，您可以轻松实现 Nginx-UI 与 Casdoor 的单点登录集成，简化用户管理并提高安全性。