@lobehub/chat 1.44.3 → 1.45.1

package/docs/self-hosting/advanced/auth/next-auth/github.mdx

@@ -19,79 +19,52 @@ tags:
 <Steps>
   ### Create a Github Provider
 
-Click [here][github-create-app] to create a new Github App.
-
-Fill in the Github App name, Homepage URL, and Callback URL.
-
-<Image
-  alt="Create a Github Provider"
-  inStep
-  src="https://github.com/lobehub/lobe-chat/assets/64475363/2f919f99-2aaa-4fa7-9938-169d3ed09db7"
-/>
-
-Set the webhook callback URL according to your needs.
-
-<Image
-  alt="Fill in other fields"
-  inStep
-  src="https://github.com/lobehub/lobe-chat/assets/64475363/d7ef5ad1-b1a3-435e-b1bc-4436d2b6fecd"
-/>
-
-Set the permission to read email addresses.
-
-<Image
-  alt="Set required permissions"
-  inStep
-  src="https://github.com/lobehub/lobe-chat/assets/64475363/23131ca1-9e84-4a89-a840-ef79c4bc0251"
-/>
-<Image
-  alt="Set permission to read email addresses"
-  inStep
-  src="https://github.com/lobehub/lobe-chat/assets/64475363/358bca8d-3d82-4e76-9a5e-90d16a39efde"
-/>
-
-Set whether it is accessible publicly or only accessible to yourself.
-
-<Image
-  alt="Set whether it is accessible publicly or only accessible to yourself"
-  inStep
-  src="https://github.com/lobehub/lobe-chat/assets/64475363/995780cb-9096-4a36-ab17-d422703ab970"
-/>
-
-Click "Create Github App".
-
-After successful creation, click "Generate a new client secret" to create a client secret.
-
-<Image
-  alt="Create a new client secret"
-  inStep
-  src="https://github.com/lobehub/lobe-chat/assets/64475363/6d69bdca-7d18-4cbc-b3e0-220d8815cd29"
-/>
-
-After successful creation, save the `Client ID` and `Client Secret`.
-
-<Image
-  alt="Create a new client secret"
-  inStep
-  src="https://github.com/lobehub/lobe-chat/assets/64475363/c6108133-a918-48b0-ab1a-e3fa607572a4"
-/>
-
-### Configure Environment Variables
-
-When deploying LobeChat, you need to configure the following environment variables:
-
-| Environment Variable | Type | Description |
-| --- | --- | --- |
-| `NEXT_AUTH_SECRET` | Required | Key used to encrypt Auth.js session tokens. You can generate the key using the command: `openssl rand -base64 32` |
-| `NEXT_AUTH_SSO_PROVIDERS` | Required | Select the Single Sign-On provider for LobeChat. Use `github` for Github. |
-| `AUTH_GITHUB_ID` | Required | Client ID in the Github App details page. |
-| `AUTH_GITHUB_SECRET` | Required | Client Secret in the Github App details page. |
-| `NEXTAUTH_URL` | Required | This URL is used to specify the callback address for Auth.js when performing OAuth authentication. Only set it if the default generated redirect address is incorrect. `https://example.com/api/auth` |
-
-<Callout type={'tip'}>
-  Go to [📘 Environment Variables](/docs/self-hosting/environment-variables/auth#github) for detailed
-  information on these variables.
-</Callout>
+  Click [here][github-create-app] to create a new Github App.
+
+  Fill in the Github App name, Homepage URL, and Callback URL.
+
+  <Image alt="Create a Github Provider" inStep src="https://github.com/lobehub/lobe-chat/assets/64475363/2f919f99-2aaa-4fa7-9938-169d3ed09db7" />
+
+  Set the webhook callback URL according to your needs.
+
+  <Image alt="Fill in other fields" inStep src="https://github.com/lobehub/lobe-chat/assets/64475363/d7ef5ad1-b1a3-435e-b1bc-4436d2b6fecd" />
+
+  Set the permission to read email addresses.
+
+  <Image alt="Set required permissions" inStep src="https://github.com/lobehub/lobe-chat/assets/64475363/23131ca1-9e84-4a89-a840-ef79c4bc0251" />
+
+  <Image alt="Set permission to read email addresses" inStep src="https://github.com/lobehub/lobe-chat/assets/64475363/358bca8d-3d82-4e76-9a5e-90d16a39efde" />
+
+  Set whether it is accessible publicly or only accessible to yourself.
+
+  <Image alt="Set whether it is accessible publicly or only accessible to yourself" inStep src="https://github.com/lobehub/lobe-chat/assets/64475363/995780cb-9096-4a36-ab17-d422703ab970" />
+
+  Click "Create Github App".
+
+  After successful creation, click "Generate a new client secret" to create a client secret.
+
+  <Image alt="Create a new client secret" inStep src="https://github.com/lobehub/lobe-chat/assets/64475363/6d69bdca-7d18-4cbc-b3e0-220d8815cd29" />
+
+  After successful creation, save the `Client ID` and `Client Secret`.
+
+  <Image alt="Create a new client secret" inStep src="https://github.com/lobehub/lobe-chat/assets/64475363/c6108133-a918-48b0-ab1a-e3fa607572a4" />
+
+  ### Configure Environment Variables
+
+  When deploying LobeChat, you need to configure the following environment variables:
+
+  | Environment Variable      | Type     | Description                                                                                                                                                                                           |
+  | ------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+  | `NEXT_AUTH_SECRET`        | Required | Key used to encrypt Auth.js session tokens. You can generate the key using the command: `openssl rand -base64 32`                                                                                     |
+  | `NEXT_AUTH_SSO_PROVIDERS` | Required | Select the Single Sign-On provider for LobeChat. Use `github` for Github.                                                                                                                             |
+  | `AUTH_GITHUB_ID`          | Required | Client ID in the Github App details page.                                                                                                                                                             |
+  | `AUTH_GITHUB_SECRET`      | Required | Client Secret in the Github App details page.                                                                                                                                                         |
+  | `NEXTAUTH_URL`            | Required | This URL is used to specify the callback address for Auth.js when performing OAuth authentication. Only set it if the default generated redirect address is incorrect. `https://example.com/api/auth` |
+
+  <Callout type={'tip'}>
+    Go to [📘 Environment Variables](/docs/self-hosting/environment-variables/auth#github) for detailed
+    information on these variables.
+  </Callout>
 </Steps>
 
 <Callout type={'info'}>

package/docs/self-hosting/advanced/auth/next-auth/github.zh-CN.mdx

@@ -16,78 +16,51 @@ tags:
 <Steps>
   ### 创建 Github 提供应用
 
-点击 [这里](https://github.com/settings/apps/new) 创建一个新的 Github App。
-
-填写 Github App name、Homepage URL、Callbak URL
-
-<Image
-  alt="创建 Github 提供程序"
-  inStep
-  src="https://github.com/lobehub/lobe-chat/assets/64475363/2f919f99-2aaa-4fa7-9938-169d3ed09db7"
-/>
-按照自己所需设置Webhook回调地址
-
-<Image
-  alt="填写其他字段"
-  inStep
-  src="https://github.com/lobehub/lobe-chat/assets/64475363/d7ef5ad1-b1a3-435e-b1bc-4436d2b6fecd"
-/>
-
-设置读取邮件地址权限
-
-<Image
-  alt="设置所需权限"
-  inStep
-  src="https://github.com/lobehub/lobe-chat/assets/64475363/23131ca1-9e84-4a89-a840-ef79c4bc0251"
-/>
-<Image
-  alt="设置读取邮件地址权限"
-  inStep
-  src="https://github.com/lobehub/lobe-chat/assets/64475363/358bca8d-3d82-4e76-9a5e-90d16a39efde"
-/>
-
-设置公开访问还是仅自己访问
-
-<Image
-  alt="设置公开访问还是仅自己访问"
-  inStep
-  src="https://github.com/lobehub/lobe-chat/assets/64475363/995780cb-9096-4a36-ab17-d422703ab970"
-/>
-
-点击「Create Github App」
-
-创建成功后，点击「Generate a new client secret」创建客户端Secret
-
-<Image
-  alt="创建新的客户端密钥"
-  inStep
-  src="https://github.com/lobehub/lobe-chat/assets/64475363/6d69bdca-7d18-4cbc-b3e0-220d8815cd29"
-/>
-
-创建成功后， 将 `客户端 ID` 和 `客户端 Secret` 保存下来。
-
-<Image
-  alt="创建新的客户端密钥"
-  inStep
-  src="https://github.com/lobehub/lobe-chat/assets/64475363/c6108133-a918-48b0-ab1a-e3fa607572a4"
-/>
-
-### 配置环境变量
-
-在部署 LobeChat 时，你需要配置以下环境变量：
-
-| 环境变量 | 类型 | 描述 |
-| --- | --- | --- |
-| `NEXT_AUTH_SECRET` | 必选 | 用于加密 Auth.js 会话令牌的密钥。您可以使用以下命令生成秘钥： `openssl rand -base64 32` |
-| `NEXT_AUTH_SSO_PROVIDERS` | 必选 | 选择 LoboChat 的单点登录提供商。使用 Github 请填写 `github`。 |
-| `AUTH_GITHUB_ID` | 必选 | Github App详情页的 客户端 ID |
-| `AUTH_GITHUB_SECRET` | 必选 | Github App详情页的 客户端 Secret |
-| `NEXTAUTH_URL` | 必选 | 该 URL 用于指定 Auth.js 在执行 OAuth 验证时的回调地址，当默认生成的重定向地址发生不正确时才需要设置。`https://example.com/api/auth` |
+  点击 [这里](https://github.com/settings/apps/new) 创建一个新的 Github App。
+
+  填写 Github App name、Homepage URL、Callbak URL
+
+  <Image alt="创建 Github 提供程序" inStep src="https://github.com/lobehub/lobe-chat/assets/64475363/2f919f99-2aaa-4fa7-9938-169d3ed09db7" />
+
+  按照自己所需设置 Webhook 回调地址
+
+  <Image alt="填写其他字段" inStep src="https://github.com/lobehub/lobe-chat/assets/64475363/d7ef5ad1-b1a3-435e-b1bc-4436d2b6fecd" />
+
+  设置读取邮件地址权限
+
+  <Image alt="设置所需权限" inStep src="https://github.com/lobehub/lobe-chat/assets/64475363/23131ca1-9e84-4a89-a840-ef79c4bc0251" />
+
+  <Image alt="设置读取邮件地址权限" inStep src="https://github.com/lobehub/lobe-chat/assets/64475363/358bca8d-3d82-4e76-9a5e-90d16a39efde" />
+
+  设置公开访问还是仅自己访问
+
+  <Image alt="设置公开访问还是仅自己访问" inStep src="https://github.com/lobehub/lobe-chat/assets/64475363/995780cb-9096-4a36-ab17-d422703ab970" />
+
+  点击「Create Github App」
+
+  创建成功后，点击「Generate a new client secret」创建客户端 Secret
+
+  <Image alt="创建新的客户端密钥" inStep src="https://github.com/lobehub/lobe-chat/assets/64475363/6d69bdca-7d18-4cbc-b3e0-220d8815cd29" />
+
+  创建成功后， 将 `客户端 ID` 和 `客户端 Secret` 保存下来。
+
+  <Image alt="创建新的客户端密钥" inStep src="https://github.com/lobehub/lobe-chat/assets/64475363/c6108133-a918-48b0-ab1a-e3fa607572a4" />
+
+  ### 配置环境变量
+
+  在部署 LobeChat 时，你需要配置以下环境变量：
+
+  | 环境变量                      | 类型 | 描述                                                                                          |
+  | ------------------------- | -- | ------------------------------------------------------------------------------------------- |
+  | `NEXT_AUTH_SECRET`        | 必选 | 用于加密 Auth.js 会话令牌的密钥。您可以使用以下命令生成秘钥： `openssl rand -base64 32`                               |
+  | `NEXT_AUTH_SSO_PROVIDERS` | 必选 | 选择 LoboChat 的单点登录提供商。使用 Github 请填写 `github`。                                                |
+  | `AUTH_GITHUB_ID`          | 必选 | Github App 详情页的 客户端 ID                                                                      |
+  | `AUTH_GITHUB_SECRET`      | 必选 | Github App 详情页的 客户端 Secret                                                                  |
+  | `NEXTAUTH_URL`            | 必选 | 该 URL 用于指定 Auth.js 在执行 OAuth 验证时的回调地址，当默认生成的重定向地址发生不正确时才需要设置。`https://example.com/api/auth` |
 
   <Callout type={'tip'}>
     前往 [📘 环境变量](/zh/docs/self-hosting/environment-variables/auth#github) 可查阅相关变量详情。
-
-</Callout>
+  </Callout>
 </Steps>
 
-<Callout type={'info'}>部署成功后，用户将可以通过Github身份认证并使用 LobeChat。</Callout>
+<Callout type={'info'}>部署成功后，用户将可以通过 Github 身份认证并使用 LobeChat。</Callout>

package/docs/self-hosting/advanced/auth/next-auth/logto.mdx

@@ -31,52 +31,43 @@ If you are using Logto Cloud, assume its endpoint domain is `https://example.log
 <Steps>
   ### Create Logto Application
 
-Access your privately deployed Logto WebUI or [Logto Cloud](http://cloud.logto.io/) to enter the console, and create a `Next.js (App Router)` application under `Applications` with any name.
+  Access your privately deployed Logto WebUI or [Logto Cloud](http://cloud.logto.io/) to enter the console, and create a `Next.js (App Router)` application under `Applications` with any name.
 
-### Configure Logto
+  ### Configure Logto
 
-Set the `Redirect URI` to `https://lobe.example.com/api/auth/callback/logto` and the `Post sign-out redirect URI` to `https://lobe.example.com/`.
+  Set the `Redirect URI` to `https://lobe.example.com/api/auth/callback/logto` and the `Post sign-out redirect URI` to `https://lobe.example.com/`.
 
-Set `CORS allowed origins` to `https://lobe.example.com`.
+  Set `CORS allowed origins` to `https://lobe.example.com`.
 
-<Image
-  alt="Configure Logto"
-  inStep
-  src="https://github.com/user-attachments/assets/5b816379-c07b-40ea-bde4-df16e2e4e523"
-/>
+  <Image alt="Configure Logto" inStep src="https://github.com/user-attachments/assets/5b816379-c07b-40ea-bde4-df16e2e4e523" />
 
-After successful creation, save the `Client ID` and `Client Secret`.
+  After successful creation, save the `Client ID` and `Client Secret`.
 
-### Configure Environment Variables
+  ### Configure Environment Variables
 
-<Image
-  alt="Configure Environment Variables"
-  inStep
-  src="https://github.com/user-attachments/assets/15af6d94-af4f-4aa9-bbab-7a46e9f9e837"
-/>
+  <Image alt="Configure Environment Variables" inStep src="https://github.com/user-attachments/assets/15af6d94-af4f-4aa9-bbab-7a46e9f9e837" />
 
-Set the obtained `Client ID` and `Client Secret` as `AUTH_LOGTO_ID` and `AUTH_LOGTO_SECRET` in the LobeChat environment variables.
+  Set the obtained `Client ID` and `Client Secret` as `AUTH_LOGTO_ID` and `AUTH_LOGTO_SECRET` in the LobeChat environment variables.
 
-Configure `AUTH_LOGTO_ISSUER` in the LobeChat environment variables as follows:
+  Configure `AUTH_LOGTO_ISSUER` in the LobeChat environment variables as follows:
 
-- `https://lobe-auth-api.example.com/oidc` if you are using a privately deployed Logto
-- `https://example.logto.app/oidc` if you are using Logto Cloud
+  - `https://lobe-auth-api.example.com/oidc` if you are using a privately deployed Logto
+  - `https://example.logto.app/oidc` if you are using Logto Cloud
 
-When deploying LobeChat, you need to configure the following environment variables:
+  When deploying LobeChat, you need to configure the following environment variables:
 
-| Environment Variable | Type | Description |
-| --- | --- | --- |
-| `NEXT_AUTH_SECRET` | Required | The key used to encrypt Auth.js session tokens. You can generate a key using the command: `openssl rand -base64 32` |
-| `NEXT_AUTH_SSO_PROVIDERS` | Required | Select the single sign-on provider for LobeChat. For Logto, enter `logto`. |
-| `AUTH_LOGTO_ID` | Required | The Client ID from the Logto App details page |
-| `AUTH_LOGTO_SECRET` | Required | The Client Secret from the Logto App details page |
-| `AUTH_LOGTO_ISSUER` | Required | OpenID Connect issuer of the Logto provider |
-| `NEXTAUTH_URL` | Required | This URL specifies the callback address for Auth.js during OAuth verification, needed only if the default generated redirect address is incorrect. `https://lobe.example.com/api/auth` |
+  | Environment Variable      | Type     | Description                                                                                                                                                                            |
+  | ------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+  | `NEXT_AUTH_SECRET`        | Required | The key used to encrypt Auth.js session tokens. You can generate a key using the command: `openssl rand -base64 32`                                                                    |
+  | `NEXT_AUTH_SSO_PROVIDERS` | Required | Select the single sign-on provider for LobeChat. For Logto, enter `logto`.                                                                                                             |
+  | `AUTH_LOGTO_ID`           | Required | The Client ID from the Logto App details page                                                                                                                                          |
+  | `AUTH_LOGTO_SECRET`       | Required | The Client Secret from the Logto App details page                                                                                                                                      |
+  | `AUTH_LOGTO_ISSUER`       | Required | OpenID Connect issuer of the Logto provider                                                                                                                                            |
+  | `NEXTAUTH_URL`            | Required | This URL specifies the callback address for Auth.js during OAuth verification, needed only if the default generated redirect address is incorrect. `https://lobe.example.com/api/auth` |
 
   <Callout type={'tip'}>
     Visit [📘 Environment Variables](/docs/self-hosting/environment-variables/auth#logto) for details on related variables.
-
-</Callout>
+  </Callout>
 </Steps>
 
 ### Troubleshooting
@@ -84,22 +75,22 @@ When deploying LobeChat, you need to configure the following environment variabl
 If you encounter issues during the Logto deployment process, refer to the following common problems:
 
 - `Only roles with the xxx attribute may create roles`:
-Check your database user's permissions and ensure that the user in your Logto database has the `admin` role to create roles.
+  Check your database user's permissions and ensure that the user in your Logto database has the `admin` role to create roles.
 
 - Error executing `logto db seed` on third-party databases like `Neon`:
-Try using the `logto db seed --encrypt-base-role` command.
+  Try using the `logto db seed --encrypt-base-role` command.
 
 - Database seeding failed:
-Try skipping the seeding process with the `--skip-seed` parameter.
+  Try skipping the seeding process with the `--skip-seed` parameter.
 
 - `Error: role xxx already exists`:
-Delete the existing role in the database.
+  Delete the existing role in the database.
 
 - Database migration failed after a version upgrade:
-Try using the command `npx @logto/cli db alteration deploy $version` (e.g., `npx @logto/cli db alteration deploy 1.22.0`).
+  Try using the command `npx @logto/cli db alteration deploy $version` (e.g., `npx @logto/cli db alteration deploy 1.22.0`).
 
 - I am using Docker deployment and want a one-click upgrade:
-Execute the custom command in the container: `sh -c "npm run cli db seed -- --swe --encrypt-base-role" && npx @logto/cli db alteration deploy $version && npm start`
+  Execute the custom command in the container: `sh -c "npm run cli db seed -- --swe --encrypt-base-role" && npx @logto/cli db alteration deploy $version && npm start`
 
 <Callout type={'info'}>
   After successful deployment, users will be able to authenticate via Logto and use LobeChat.

package/docs/self-hosting/advanced/auth/next-auth/logto.zh-CN.mdx

@@ -28,52 +28,43 @@ tags:
 <Steps>
   ### 创建 Logto 应用
 
-访问你私有部署的 Logto WebUI 或者 [Logto Cloud](http://cloud.logto.io/) 进入控制台，在 `Applications` 里创建一个 `Next.js (App Router)` 应用，名称随意
+  访问你私有部署的 Logto WebUI 或者 [Logto Cloud](http://cloud.logto.io/) 进入控制台，在 `Applications` 里创建一个 `Next.js (App Router)` 应用，名称随意
 
-### 配置 Logto
+  ### 配置 Logto
 
-配置 `Redirect URI` 为 `https://lobe.example.com/api/auth/callback/logto`，`Post sign-out redirect URI` 为 `https://lobe.example.com/`
+  配置 `Redirect URI` 为 `https://lobe.example.com/api/auth/callback/logto`，`Post sign-out redirect URI` 为 `https://lobe.example.com/`
 
-配置 `CORS allowed origins` 为 `https://lobe.example.com`
+  配置 `CORS allowed origins` 为 `https://lobe.example.com`
 
-<Image
-  alt="配置 Logto"
-  inStep
-  src="https://github.com/user-attachments/assets/5b816379-c07b-40ea-bde4-df16e2e4e523"
-/>
+  <Image alt="配置 Logto" inStep src="https://github.com/user-attachments/assets/5b816379-c07b-40ea-bde4-df16e2e4e523" />
 
-创建成功后， 将 `Client ID` 和 `Client Secret` 保存下来。
+  创建成功后， 将 `Client ID` 和 `Client Secret` 保存下来。
 
-### 配置环境变量
+  ### 配置环境变量
 
-<Image
-  alt="配置环境变量"
-  inStep
-  src="https://github.com/user-attachments/assets/15af6d94-af4f-4aa9-bbab-7a46e9f9e837"
-/>
+  <Image alt="配置环境变量" inStep src="https://github.com/user-attachments/assets/15af6d94-af4f-4aa9-bbab-7a46e9f9e837" />
 
-将获取到的 `Client ID` 和 `Client Secret`，设为 LobeChat 环境变量中的 `AUTH_LOGTO_ID` 和 `AUTH_LOGTO_SECRET`。
+  将获取到的 `Client ID` 和 `Client Secret`，设为 LobeChat 环境变量中的 `AUTH_LOGTO_ID` 和 `AUTH_LOGTO_SECRET`。
 
-配置 LobeChat 环境变量中 `AUTH_LOGTO_ISSUER` 为：
+  配置 LobeChat 环境变量中 `AUTH_LOGTO_ISSUER` 为：
 
-- `https://lobe-auth-api.example.com/oidc`，若你是私有部署的 Logto
-- `https://example.logto.app/oidc`，若你是使用的 Logto Cloud
+  - `https://lobe-auth-api.example.com/oidc`，若你是私有部署的 Logto
+  - `https://example.logto.app/oidc`，若你是使用的 Logto Cloud
 
-在部署 LobeChat 时，你需要配置以下环境变量：
+  在部署 LobeChat 时，你需要配置以下环境变量：
 
-| 环境变量 | 类型 | 描述 |
-| --- | --- | --- |
-| `NEXT_AUTH_SECRET` | 必选 | 用于加密 Auth.js 会话令牌的密钥。您可以使用以下命令生成秘钥： `openssl rand -base64 32` |
-| `NEXT_AUTH_SSO_PROVIDERS` | 必选 | 选择 LoboChat 的单点登录提供商。使用 Logto 请填写 `logto`。 |
-| `AUTH_LOGTO_ID` | 必选 | Logto App 详情页的 Client ID |
-| `AUTH_LOGTO_SECRET` | 必选 | Logto App 详情页的 Client Secret |
-| `AUTH_LOGTO_ISSUER` | 必选 | Logto 提供程序的 OpenID Connect 颁发者 |
-| `NEXTAUTH_URL` | 必选 | 该 URL 用于指定 Auth.js 在执行 OAuth 验证时的回调地址，当默认生成的重定向地址发生不正确时才需要设置。`https://lobe.example.com/api/auth` |
+  | 环境变量                      | 类型 | 描述                                                                                               |
+  | ------------------------- | -- | ------------------------------------------------------------------------------------------------ |
+  | `NEXT_AUTH_SECRET`        | 必选 | 用于加密 Auth.js 会话令牌的密钥。您可以使用以下命令生成秘钥： `openssl rand -base64 32`                                    |
+  | `NEXT_AUTH_SSO_PROVIDERS` | 必选 | 选择 LoboChat 的单点登录提供商。使用 Logto 请填写 `logto`。                                                       |
+  | `AUTH_LOGTO_ID`           | 必选 | Logto App 详情页的 Client ID                                                                         |
+  | `AUTH_LOGTO_SECRET`       | 必选 | Logto App 详情页的 Client Secret                                                                     |
+  | `AUTH_LOGTO_ISSUER`       | 必选 | Logto 提供程序的 OpenID Connect 颁发者                                                                   |
+  | `NEXTAUTH_URL`            | 必选 | 该 URL 用于指定 Auth.js 在执行 OAuth 验证时的回调地址，当默认生成的重定向地址发生不正确时才需要设置。`https://lobe.example.com/api/auth` |
 
   <Callout type={'tip'}>
     前往 [📘 环境变量](/zh/docs/self-hosting/environment-variables/auth#logto) 可查阅相关变量详情。
-
-</Callout>
+  </Callout>
 </Steps>
 
 ### 故障排除
@@ -81,21 +72,21 @@ tags:
 若你在部署 Logto 过程中遇到问题，可以参考以下常见问题：
 
 - `Only roles with the xxx attribute may create roles`：
-请检查你的数据库用户权限，确保你的 Logto 数据库中的用户具有 `admin` 角色，以便创建角色。
+  请检查你的数据库用户权限，确保你的 Logto 数据库中的用户具有 `admin` 角色，以便创建角色。
 
 - 在第三方数据库例如 `Neon` 上执行`logto db seed`出错:
-尝试使用`logto db seed --encrypt-base-role`命令。
+  尝试使用`logto db seed --encrypt-base-role`命令。
 
 - 数据库播种失败：
-请尝试使用`--skip-seed`参数跳过播种。
+  请尝试使用`--skip-seed`参数跳过播种。
 
 - `Error: role xxx already exists`：
-在数据库中删除已存在的角色即可。
+  在数据库中删除已存在的角色即可。
 
 - 版本升级后，数据库迁移失败：
-请尝试使用` npx @logto/cli db alteration deploy $version`命令(例如`npx @logto/cli db alteration deploy 1.22.0`)
+  请尝试使用` npx @logto/cli db alteration deploy $version`命令 (例如`npx @logto/cli db alteration deploy 1.22.0`)
 
 - 我使用 docker 部署 希望一键升级：
-在容器中执行自定义命令：`sh -c "npm run cli db seed -- --swe --encrypt-base-role" && npx @logto/cli db alteration deploy $version && npm start`
+  在容器中执行自定义命令：`sh -c "npm run cli db seed -- --swe --encrypt-base-role" && npx @logto/cli db alteration deploy $version && npm start`
 
 <Callout type={'info'}>部署成功后，用户将可以通过 Logto 身份认证并使用 LobeChat。</Callout>

package/docs/self-hosting/advanced/auth/next-auth/microsoft-entra-id.mdx

@@ -18,72 +18,59 @@ tags:
 <Steps>
   ### Create a Microsoft Entra ID Application
 
-In your [Microsoft Azure Portal][microsoft-azure-portal], go to Microsoft Entra ID -> App registrations -> New registration to create a new application.
+  In your [Microsoft Azure Portal][microsoft-azure-portal], go to Microsoft Entra ID -> App registrations -> New registration to create a new application.
 
-Fill in the desired application name to be displayed to organizational users, choose the account types you wish to support, and if only internal users are supported, select `Accounts in this organizational directory only (Default Directory only - Single tenant)`.
+  Fill in the desired application name to be displayed to organizational users, choose the account types you wish to support, and if only internal users are supported, select `Accounts in this organizational directory only (Default Directory only - Single tenant)`.
 
-In the `Redirect URI (optional)` section, for the application type, select `Web`, and in the Callback URL, enter:
+  In the `Redirect URI (optional)` section, for the application type, select `Web`, and in the Callback URL, enter:
 
-```bash
-https://your-domain/api/auth/callback/microsoft-entra-id
-```
+  ```bash
+  https://your-domain/api/auth/callback/microsoft-entra-id
+  ```
 
-<Callout type={'info'}>
-  - You can fill in or modify the Redirect URIs after registering, but make sure the URL you enter
-  matches the deployed URL. - Please replace "your-domain" with your own domain.
-</Callout>
-
-<Image
-  alt="App Register"
-  inStep
-  src="https://github.com/lobehub/lobe-chat/assets/13883964/4f9d83bd-b3fc-4abc-bcf4-ccbad65c219d"
-/>
+  <Callout type={'info'}>
+    - You can fill in or modify the Redirect URIs after registering, but make sure the URL you enter
+      matches the deployed URL. - Please replace "your-domain" with your own domain.
+  </Callout>
 
-Click on "Register".
+  <Image alt="App Register" inStep src="https://github.com/lobehub/lobe-chat/assets/13883964/4f9d83bd-b3fc-4abc-bcf4-ccbad65c219d" />
 
-After successfully creating the application, click on the corresponding application to enter the application details page, and switch to the "Overview" tab to view the corresponding configuration information.
+  Click on "Register".
 
-<Image
-  alt="App Overview"
-  inStep
-  src="https://github.com/lobehub/lobe-chat/assets/13883964/48a0b702-05bd-4ce4-a007-a8ad00a36e5a"
-/>
+  After successfully creating the application, click on the corresponding application to enter the application details page, and switch to the "Overview" tab to view the corresponding configuration information.
 
-Go to "Certificates & secrets", select the "Client secrets" tab, click on "New client secret", fill in the description, select the expiration time, and click on "Add" to create a new client secret.
+  <Image alt="App Overview" inStep src="https://github.com/lobehub/lobe-chat/assets/13883964/48a0b702-05bd-4ce4-a007-a8ad00a36e5a" />
 
-<Image
-  alt="Create App Client Secret"
-  inStep
-  src="https://github.com/lobehub/lobe-chat/assets/13883964/c9d66fa0-158c-4bd3-a1fa-969e638259d2"
-/>
+  Go to "Certificates & secrets", select the "Client secrets" tab, click on "New client secret", fill in the description, select the expiration time, and click on "Add" to create a new client secret.
 
-<Callout type={'important'}>
-  Please make sure to save your client secret as this is your only chance to view it.
-</Callout>
+  <Image alt="Create App Client Secret" inStep src="https://github.com/lobehub/lobe-chat/assets/13883964/c9d66fa0-158c-4bd3-a1fa-969e638259d2" />
 
-### Add Users
+  <Callout type={'important'}>
+    Please make sure to save your client secret as this is your only chance to view it.
+  </Callout>
 
-Go back to the "Microsoft Entra ID" interface, enter "Users", click on "New user", fill in the user information, and click on "Create" to create a user for using LobeChat.
+  ### Add Users
 
-### Configure Environment Variables
+  Go back to the "Microsoft Entra ID" interface, enter "Users", click on "New user", fill in the user information, and click on "Create" to create a user for using LobeChat.
 
-When deploying LobeChat, you need to configure the following environment variables:
+  ### Configure Environment Variables
 
-| Environment Variable | Type | Description |
-| --- | --- | --- |
-| `NEXT_AUTH_SECRET` | Required | Key used to encrypt Auth.js session tokens. You can generate the key using the following command: `openssl rand -base64 32` |
-| `NEXT_AUTH_SSO_PROVIDERS` | Required | Select the single sign-on provider for LoboChat. Use `microsoft-entra-id` for Microsoft Entra ID. |
-| `AUTH_MICROSOFT_ENTRA_ID_ID` | Required | Client ID of the Microsoft Entra ID application. |
-| `AUTH_MICROSOFT_ENTRA_ID_SECRET` | Required | Client Secret of the Microsoft Entra ID application. |
-| `AUTH_MICROSOFT_ENTRA_ID_TENANT_ID` | Required | Tenant ID of the Microsoft Entra ID application. |
-| `NEXTAUTH_URL` | Required | This URL is used to specify the callback address for Auth.js when performing OAuth authentication. It is only necessary to set it when the default generated redirect address is incorrect. `https://example.com/api/auth` |
+  When deploying LobeChat, you need to configure the following environment variables:
 
-<Callout type={'tip'}>
-  You can refer to [📘 environment
-  variables](/docs/self-hosting/environment-variable#microsoft-entra-id) for details on related
-  variables.
-</Callout>
+  | Environment Variable                | Type     | Description                                                                                                                                                                                                                |
+  | ----------------------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+  | `NEXT_AUTH_SECRET`                  | Required | Key used to encrypt Auth.js session tokens. You can generate the key using the following command: `openssl rand -base64 32`                                                                                                |
+  | `NEXT_AUTH_SSO_PROVIDERS`           | Required | Select the single sign-on provider for LoboChat. Use `microsoft-entra-id` for Microsoft Entra ID.                                                                                                                          |
+  | `AUTH_MICROSOFT_ENTRA_ID_ID`        | Required | Client ID of the Microsoft Entra ID application.                                                                                                                                                                           |
+  | `AUTH_MICROSOFT_ENTRA_ID_SECRET`    | Required | Client Secret of the Microsoft Entra ID application.                                                                                                                                                                       |
+  | `AUTH_MICROSOFT_ENTRA_ID_TENANT_ID` | Required | Tenant ID of the Microsoft Entra ID application.                                                                                                                                                                           |
+  | `NEXTAUTH_URL`                      | Required | This URL is used to specify the callback address for Auth.js when performing OAuth authentication. It is only necessary to set it when the default generated redirect address is incorrect. `https://example.com/api/auth` |
 
+  <Callout type={'tip'}>
+    You can refer to [📘 environment
+    variables](/docs/self-hosting/environment-variable#microsoft-entra-id) for details on related
+    variables.
+  </Callout>
 </Steps>
 
 <Callout>