配置 ZITADEL 身份验证
ZITADEL 是一个开源的身份基础设施,内置多租户支持。
在 ZITADEL 中创建应用
- 登录 ZITADEL 控制台
- 前往你的项目(或创建新项目)
- 点击 New 创建新应用
- 选择 Web 作为应用类型
- 配置:
- Name:
LobeHub - Authentication Method:
CODE(用于机密客户端)
- Name:
- 添加重定向 URI:
回调 URL 格式: https://your-domain.com/api/auth/callback/zitadel
- 创建后,记下 Client ID 并生成 Client Secret
获取 Issuer URL
Issuer URL 是 ZITADEL 实例 URL,通常为:
- 云版:
https://your-instance.zitadel.cloud - 自托管:
https://your-zitadel-domain
配置环境变量
在部署 LobeHub 时,你需要配置以下环境变量:
| 环境变量 | 类型 | 描述 |
|---|---|---|
AUTH_SECRET | 必选 | 用于加密会话令牌的密钥。使用以下命令生成:openssl rand -base64 32 |
AUTH_SSO_PROVIDERS | 必选 | SSO 提供商。使用 ZITADEL 请填写 zitadel |
AUTH_ZITADEL_ID | 必选 | ZITADEL 应用的 Client ID |
AUTH_ZITADEL_SECRET | 必选 | ZITADEL 应用的 Client Secret |
AUTH_ZITADEL_ISSUER | 必选 | ZITADEL Issuer URL(例如 https://your-instance.zitadel.cloud) |
已废弃的环境变量:ZITADEL_CLIENT_ID / ZITADEL_CLIENT_SECRET / ZITADEL_ISSUER 已不再支持,设置其中任意一个都会导致部署在构建 / 启动阶段失败,请改用 AUTH_ZITADEL_ID / AUTH_ZITADEL_SECRET / AUTH_ZITADEL_ISSUER。
前往 📘 环境变量 可查阅相关变量详情。
部署成功后,用户将可以通过 ZITADEL 身份认证并使用 LobeHub。