Nginx UI单点登录配置：多系统统一身份验证终极指南

【免费下载链接】nginx-ui 项目地址: https://gitcode.com/gh_mirrors/ngi/nginx-ui

Nginx UI是一款功能强大的Nginx管理工具，支持通过单点登录实现多系统统一身份验证。本文将详细介绍如何在Nginx UI中配置Casdoor、OIDC和WebAuthn等单点登录方式，帮助管理员轻松管理用户访问权限，提升系统安全性与用户体验。

为什么需要单点登录？

单点登录（SSO）允许用户使用一组凭据访问多个应用系统，无需重复登录，显著提升用户体验并简化管理流程。Nginx UI通过支持多种SSO协议，帮助管理员构建安全高效的身份验证体系。

Nginx UI直观的管理界面，支持多种单点登录配置

支持的单点登录方式

Nginx UI提供三种主要单点登录方案，满足不同场景需求：

1. Casdoor集成

Casdoor是一款开源的身份管理平台，支持OAuth 2.0、OIDC等协议。通过api/user/casdoor.go实现的集成功能，可快速对接Casdoor实现统一身份验证。

核心配置项（定义于settings/casdoor.go）：

• Endpoint: Casdoor服务地址
• ClientId与ClientSecret: 应用凭证
• Organization与Application: 组织和应用标识
• RedirectUri: 认证后重定向地址

2. OIDC认证

基于OpenID Connect协议的身份验证方案，通过api/user/oidc.go实现。支持与Keycloak、Auth0等主流OIDC提供商集成。

必要配置（定义于settings/oidc.go）：

• ClientId与ClientSecret: OIDC客户端凭证
• Endpoint: OIDC提供商地址
• Scopes: 请求的用户信息范围（默认包含openid、profile、email）
• Identifier: 用户唯一标识字段（如username或email）

3. WebAuthn (Passkey)

现代无密码认证方案，通过internal/passkey/webauthn.go实现，支持Windows Hello、Apple Touch ID等设备级认证。

配置参数（定义于settings/webauthn.go）：

• RPDisplayName: 依赖方显示名称
• RPID: 依赖方标识符（通常是域名）
• RPOrigins: 允许的来源域名列表

快速配置步骤

准备工作

1. 确保Nginx UI已正确安装，版本不低于最新稳定版
2. 准备好SSO服务提供商的相关凭证（如Client ID、Secret等）
3. 配置正确的重定向URL（通常为https://your-nginx-ui-domain/api/user/callback）

Casdoor配置示例

1. 在Casdoor中创建应用，获取Client ID和Secret
2. 在Nginx UI设置页面填写Casdoor配置：

   端点: https://casdoor.example.com
   客户端ID: your-client-id
   客户端密钥: your-client-secret
   组织: your-organization
   应用: your-application
   重定向URI: https://nginx-ui.example.com/api/user/casdoor_callback
   

3. 保存配置并启用Casdoor认证

OIDC配置示例

以Keycloak为例：

1. 在Keycloak中创建客户端，设置有效的重定向URI
2. 在Nginx UI中配置OIDC参数：

   客户端ID: your-client-id
   客户端密钥: your-client-secret
   端点: https://keycloak.example.com/auth/realms/your-realm
   重定向URI: https://nginx-ui.example.com/api/user/oidc_callback
   作用域: openid profile email
   标识符: preferred_username
   

3. 启用OIDC认证并测试登录流程

WebAuthn配置示例

1. 在Nginx UI设置页面配置WebAuthn参数：

   显示名称: Nginx UI
   RPID: example.com
   来源: https://nginx-ui.example.com
   

2. 用户在个人设置中添加Passkey设备
3. 下次登录时即可使用生物识别或安全密钥登录

Nginx UI配置界面，可在此处设置各种单点登录参数

最佳实践与注意事项

1. 安全建议

   • 始终使用HTTPS保护认证流量
   • 定期轮换客户端密钥和凭证
   • 限制OIDC作用域，仅请求必要的用户信息

2. 故障排除

   • 检查重定向URI是否与SSO提供商配置一致
   • 查看Nginx UI日志定位认证错误
   • 确认系统时间同步，避免JWT令牌验证失败

3. 高可用性

   • 对于生产环境，建议部署多个认证节点
   • 使用Redis等共享存储保存认证会话

总结

Nginx UI提供了灵活强大的单点登录解决方案，通过Casdoor、OIDC和WebAuthn等多种方式，帮助管理员构建安全、便捷的统一身份验证系统。无论您是小型团队还是大型企业，都能找到适合的认证方案，提升管理效率并增强系统安全性。

如需更详细的配置指南，请参考项目官方文档或查看源代码中的相关实现：

• Casdoor集成: api/user/casdoor.go
• OIDC实现: api/user/oidc.go
• WebAuthn核心代码: internal/passkey/webauthn.go

【免费下载链接】nginx-ui 项目地址: https://gitcode.com/gh_mirrors/ngi/nginx-ui