---
title: 在 AiPMChat 中配置 ZITADEL 身份验证服务
description: 学习如何在 AiPMChat 中配置 ZITADEL 身份验证服务，包括创建应用、配置环境变量等步骤。
tags:
  - ZITADEL
  - 身份验证服务
  - 环境变量配置
  - 单点登录
  - AiPMChat
---

# 配置 ZITADEL 身份验证服务

<Steps>
  ### 创建 ZITADEL 应用

使用具有 [`Project Owner` 角色](https://zitadel.com/docs/guides/manage/console/managers#roles)的账户登录到 ZITADEL 实例控制台，进入（或[创建](https://zitadel.com/docs/guides/manage/console/projects#create-a-project)）该应用所属的项目，点击「创建」按钮创建应用。

<Image
  alt="创建 ZITADEL 应用 1"
  inStep
  src="https://github.com/aipmhub/aipm-chat/assets/8692892/3564110d-bef9-47f3-b775-e5f28b4275b2"
/>

填写应用名称，应用类型选择「Web」，点击「继续」。

<Image
  alt="创建 ZITADEL 应用 2"
  inStep
  src="https://github.com/aipmhub/aipm-chat/assets/8692892/12451b47-8dcd-40a9-b18d-2806b07efecc"
/>

选择「Code」作为身份验证方式。

<Image
  alt="创建 ZITADEL 应用 3"
  inStep
  src="https://github.com/aipmhub/aipm-chat/assets/8692892/9d5cb651-ad10-47c7-8c8b-2256163c5521"
/>

在「重定向 URLs」字段中填写：

```
http(s)://your-domain/api/auth/callback/zitadel
```

<Image
  alt="创建 ZITADEL 应用 4"
  inStep
  src="https://github.com/aipmhub/aipm-chat/assets/8692892/1699bf46-0c8d-4238-9eb5-34282bfe529a"
/>

<Callout type={'important'}>
  - 可以创建应用后再填写或修改重定向 URL，但请确保填写的 URL 与部署的 URL 一致。

- 请将 `http(s)://your-domain` 替换为 AiPMChat 部署的实际 URL。

</Callout>

确认配置并点击「创建」。

<Image
  alt="创建 ZITADEL 应用 5"
  inStep
  src="https://github.com/aipmhub/aipm-chat/assets/8692892/375b3d73-6796-465c-9063-f2762093f763"
/>

记录下「ClientId」和「ClientSecret」备用。

<Image
  alt="创建 ZITADEL 应用 6"
  inStep
  src="https://github.com/aipmhub/aipm-chat/assets/8692892/40bb6b4c-18e0-4ae5-abae-ae0cf202cf08"
/>

在应用设置页面中，切换到「令牌设置」选项卡，勾选「在 ID Token 中包含用户信息」选项，点击「保存」。

<Image
  alt="创建 ZITADEL 应用 7"
  inStep
  src="https://github.com/aipmhub/aipm-chat/assets/8692892/20a257b5-d086-46f3-b5c2-f76394b11f55"
/>

切换到「URLs」选项卡，记录下「issuer」URL。

<Image
  alt="创建 ZITADEL 应用 8"
  inStep
  src="https://github.com/aipmhub/aipm-chat/assets/8692892/79c55d44-8dcb-429c-a072-d3eb014bbceb"
/>

### 配置环境变量

部署 AiPMChat 时，您需要配置以下环境变量：

| 环境变量 | 类型 | 描述 |
| --- | --- | --- |
| `NEXT_AUTH_SECRET` | 必选 | 用于加密 Auth.js 会话令牌的密钥。您可以使用以下命令生成密钥：`openssl rand -base64 32` |
| `NEXT_AUTH_SSO_PROVIDERS` | 可选 | 为 AiPMChat 选择单点登录提供程序。对于 ZITADEL，请填写 `zitadel`。 |
| `ZITADEL_CLIENT_ID` | 必选 | ZITADEL 应用的 Client ID（`ClientId`）。 |
| `ZITADEL_CLIENT_SECRET` | 必选 | ZITADEL 应用的 Client Secret（`ClientSecret`）。 |
| `ZITADEL_ISSUER` | 必选 | ZITADEL 应用的 OpenID Connect 颁发者（issuer）URL。 |
| `ACCESS_CODE` | 必选 | 添加访问此服务的代码。您可以设置一个足够长的随机密码以「禁用」访问码授权。 |
| `NEXTAUTH_URL` | 可选 | 该 URL 用于指定 Auth.js 中执行 OAuth 认证的回调地址。仅当默认地址不正确时才需要设置。`https://example.com/api/auth` |

  <Callout type={'tip'}>
    您可以在 [📘 环境变量](/docs/self-hosting/environment-variables/auth#zitadel) 中查看相关变量的详细信息。

</Callout>
</Steps>

<Callout>部署成功后，用户将能够通过 ZITADEL 中配置的用户进行身份验证并使用 AiPMChat。</Callout>