配置 Auth0 身份验证服务
NextAuth(Auth.js)已从 LobeHub 中完全移除。下文出现的 NEXT_AUTH_SSO_PROVIDERS 和 AUTH_URL 等变量现在会导致部署在构建 / 启动阶段失败。本页仅作历史参考保留,请改用 Better Auth 提供商指南 和 NextAuth 迁移至 Better Auth 指南。
创建 Auth0 应用
注册并登录 Auth0,点击左侧导航栏的「Applications」,切换到应用管理界面,点击右上角「Create Application」以创建应用。

填写你想向组织用户显示的应用名称,可选择任意应用类型,点击「Create」。

创建成功后,点击相应的应用,进入应用详情页,切换到「Settings」标签页,就可以看到相应的配置信息

在应用配置页面中,还需要配置 Allowed Callback URLs,在此处填写:

可以在部署后再填写或修改 Allowed Callback URLs,但是务必保证填写的 URL 与部署的 URL 一致
新增用户
点击左侧导航栏的「Users Management」,进入用户管理界面,可以为你的组织新建用户,用以登录 LobeHub

配置环境变量
在部署 LobeHub 时,你需要配置以下环境变量:
| 环境变量 | 类型 | 描述 |
|---|---|---|
AUTH_SECRET | 必选 | 用于加密 Auth.js 会话令牌的密钥。您可以使用以下命令生成秘钥: openssl rand -base64 32 |
NEXT_AUTH_SSO_PROVIDERS | 必选 | 选择 LoboChat 的单点登录提供商。使用 Auth0 请填写 auth0。 |
AUTH_AUTH0_ID | 必选 | Auth0 应用程序的 Client ID |
AUTH_AUTH0_SECRET | 必选 | Auth0 应用程序的 Client Secret |
AUTH_AUTH0_ISSUER | 必选 | Auth0 应用程序的 Domain,https://example.auth0.com |
AUTH_URL | 必选 | 该 URL 用于指定 Auth.js 在执行 OAuth 验证时的回调地址,当默认生成的重定向地址发生不正确时才需要设置。https://example.com/api/auth |
前往 📘 环境变量 可查阅相关变量详情。
部署成功后,用户将可以使用 Auth0 中配置的用户通过身份认证并使用 LobeHub。
进阶配置
连接现有的单点登录服务
如果你的企业或组织已有现有的统一身份认证设施,可在 Applications -> SSO Integrations 中,连接现有的单点登录服务。
Auth0 支持 Azure Active Directory / Slack / Google Workspace / Office 365 / Zoom 等单点登录服务,详细支持列表可参考 这里

配置社交登录
如果你的企业或组织需要支持外部人员登录,可以在 Authentication -> Social 中,配置社交登录服务。

配置社交登录服务默认会允许所有人通过认证,这可能会导致 LobeHub 被外部人员滥用。
如果你需要限制登录人员,务必配置 阻止策略: 请在打开社交登录选项后,参考 这篇文章 创建 Action 来设置阻止 / 允许列表。