mirror of
https://github.com/lobehub/lobehub.git
synced 2026-09-20 04:56:13 +08:00
YuTengjing
191f3fe776
* 📝 docs: fix outdated content across the docs site Audited docs/ against the current codebase and fixed stale content that drifted after major refactors (Clerk/NextAuth → Better Auth, src/server → apps/server, src/{config,envs,locales} → packages/*, model-bank updates). - self-hosting/auth: mark removed NextAuth/Clerk pages with deprecation warnings; fix microsoft/zitadel alias claims and the Logto callback path - environment-variables & advanced: correct wrong defaults (S3_SET_ACL, AI_IMAGE_DEFAULT_IMAGE_NUM, index/proxy URLs), drop non-existent env vars and fictional feature flags, fix OIDC config guidance - development: update refactored paths, Better Auth, .mjs configs, remove the MSW section (msw is not a dependency) - providers & model examples: replace retired model ids with in-bank ones; fix comfyui frontmatter corruption - usage: rename Moderator→Orchestrator, GTD→Task, correct shortcut keys, channel capability tables, Feishu/Lark WebSocket mode - platform/migration: fix dead links, docker service name, npx/npm → bun EN and zh-CN pairs updated together. * 📝 docs: fix Logto callback path and AUTH_SECRET deprecation guidance - Revert Logto/Sealos callback URLs to /api/auth/callback/logto to match the runtime SSO redirectURI override - Narrow legacy auth Callout: AUTH_SECRET remains required for Better Auth; mark NEXT_AUTH_SECRET as deprecated in zh-CN * 📝 docs: refresh agent skills for locales, env, auth, and agentRun paths Align OSS agent guidance with post-refactor layout: - packages/locales/src/default + bun run i18n - packages/env/src for env schemas (@/envs alias) - spa-auth shell + src/routes/auth segments - chat agentRun/transports/hetero instead of aiChat * 📝 docs: document APP_URL as required for Better Auth base URL Self-hosted auth uses appEnv.APP_URL as baseURL, not request-header auto-detection. NEXT_PUBLIC_AUTH_URL remains deprecated. * 📝 docs: note self-host search provider setup for web search Built-in lobe-web-browsing needs no client plugin, but self-hosted servers still require SEARCH_PROVIDERS / SEARXNG_URL (default SearXNG). * 📝 docs: point feature guide welcome UI at AgentHome Opening message/questions on the agent chat page live in src/features/AgentHome, not Onboarding WelcomeMessage.
110 lines
6.5 KiB
Plaintext
110 lines
6.5 KiB
Plaintext
---
|
|
title: Configure Auth0 Identity Verification Service for LobeHub
|
|
description: >-
|
|
Learn how to configure Auth0 Identity Verification Service for LobeHub for
|
|
your organization, including creating applications, adding users, and
|
|
configuring environment variables.
|
|
tags:
|
|
- Auth0
|
|
- Identity Verification
|
|
- Single Sign-On
|
|
- Environment Variables
|
|
- User Management
|
|
- SSO Integrations
|
|
- Social Login
|
|
---
|
|
|
|
# Configure Auth0 Identity Verification Service
|
|
|
|
<Callout type={'warning'}>
|
|
NextAuth (Auth.js) has been fully removed from LobeHub. The `NEXT_AUTH_SSO_PROVIDERS` and `AUTH_URL` variables shown below will now cause the deployment to fail at build/startup. This page is kept for historical reference only — use the [Better Auth provider guides](/docs/self-hosting/auth) and the [NextAuth to Better Auth migration guide](/docs/self-hosting/migration/v2/auth/nextauth-to-betterauth) instead.
|
|
</Callout>
|
|
|
|
<Steps>
|
|
### Create Auth0 Application
|
|
|
|
Register and log in to [Auth0][auth0-client-page], click on the "Applications" in the left navigation bar to switch to the application management interface, and click "Create Application" in the upper right corner to create an application.
|
|
|
|
<Image alt="Create Auth0 Application S1" inStep src="/blog/assets30863298/f068190f-0027-4d3b-8667-d632e43d5a86.webp" />
|
|
|
|
Fill in the application name you want to display to the organization users, choose any application type, and click "Create".
|
|
|
|
<Image alt="Create Auth0 Application S2" inStep src="/blog/assets30863298/3e0082df-9b6f-46f3-b67f-bdc79e1eb2cc.webp" />
|
|
|
|
After successful creation, click on the corresponding application to enter the application details page, switch to the "Settings" tab, and you can see the corresponding configuration information.
|
|
|
|
<Image alt="Create Auth0 Application S3" inStep src="/blog/assets30863298/df4cea85-616a-46f5-b2de-42725d9b82a6.webp" />
|
|
|
|
In the application configuration page, you also need to configure Allowed Callback URLs, where you should fill in:
|
|
|
|
```bash
|
|
http(s)://your-domain/api/auth/callback/auth0
|
|
```
|
|
|
|
<Image alt="Create Auth0 Application S4" inStep src="/blog/assets30863298/62fbd09f-a69a-4460-949b-0f6285fa65b9.webp" />
|
|
|
|
<Callout type={'important'}>
|
|
You can fill in or modify Allowed Callback URLs after deployment, but make sure the filled URL is
|
|
consistent with the deployed URL.
|
|
</Callout>
|
|
|
|
### Add Users
|
|
|
|
Click on the "Users Management" in the left navigation bar to enter the user management interface, where you can create users for your organization to log in to LobeHub.
|
|
|
|
<Image alt="Add Users" inStep src="/blog/assets30863298/0beda150-d0b6-43cf-a9f1-fce928b83a96.webp" />
|
|
|
|
### Configure Environment Variables
|
|
|
|
When deploying LobeHub, you need to configure the following environment variables:
|
|
|
|
| Environment Variable | Type | Description |
|
|
| ------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
| `AUTH_SECRET` | Required | Key used to encrypt Auth.js session tokens. You can generate a key using the following command: `openssl rand -base64 32` |
|
|
| `NEXT_AUTH_SSO_PROVIDERS` | Required | Select the single sign-on provider for LoboChat. Use `auth0` for Auth0. |
|
|
| `AUTH_AUTH0_ID` | Required | Client ID of the Auth0 application |
|
|
| `AUTH_AUTH0_SECRET` | Required | Client Secret of the Auth0 application |
|
|
| `AUTH_AUTH0_ISSUER` | Required | Domain of the Auth0 application, `https://example.auth0.com` |
|
|
| `AUTH_URL` | Required | The URL is used to specify the callback address for the execution of OAuth authentication in Auth.js. It needs to be set only when the default address is incorrect. `https://example.com/api/auth` |
|
|
|
|
<Callout type={'tip'}>
|
|
You can refer to the related variable details at [📘Environment Variables](/docs/self-hosting/environment-variable#auth0).
|
|
</Callout>
|
|
</Steps>
|
|
|
|
<Callout>
|
|
After successful deployment, users will be able to authenticate and use LobeHub using the users
|
|
configured in Auth0.
|
|
</Callout>
|
|
|
|
## Advanced Configuration
|
|
|
|
### Connecting to an Existing Single Sign-On Service
|
|
|
|
If your enterprise or organization already has a unified identity authentication infrastructure, you can connect to an existing single sign-on service in Applications -> SSO Integrations.
|
|
|
|
Auth0 supports single sign-on services such as Azure Active Directory, Slack, Google Workspace, Office 365, Zoom, and more. For a detailed list of supported services, please refer to [this link][auth0-sso-integrations].
|
|
|
|
<Image alt="Connecting to an Existing Single Sign-On Service" src="/blog/assets30863298/9891347e-a338-4aa9-8714-f16c8dbcfcec.webp" />
|
|
|
|
### Configuring Social Login
|
|
|
|
If your enterprise or organization needs to support external user logins, you can configure social login services in Authentication -> Social.
|
|
|
|
<Image alt="Configuring Social Login" src="/blog/assets30863298/880749a6-5ba4-4e20-a968-b583a54de7fa.webp" />
|
|
|
|
<Callout type={'warning'}>
|
|
Configuring social login services by default allows anyone to authenticate, which may lead to
|
|
LobeHub being abused by external users.
|
|
</Callout>
|
|
|
|
<Callout>
|
|
If you need to restrict login users, be sure to configure a **blocking policy**: After enabling
|
|
the social login option, refer to [this article][auth0-login-actions-manual] to create an Action
|
|
to set up a blocking/allow list.
|
|
</Callout>
|
|
|
|
[auth0-client-page]: https://manage.auth0.com/dashboard
|
|
[auth0-login-actions-manual]: https://auth0.com/blog/permit-or-deny-login-requests-using-auth0-actions/
|
|
[auth0-sso-integrations]: https://marketplace.auth0.com/features/sso-integrations
|