配置 Keycloak 身份验证
Keycloak 是一个开源的身份和访问管理解决方案。
在 Keycloak 中创建客户端
- 登录 Keycloak 管理控制台
- 选择你的 realm(或创建新的)
- 前往 Clients > Create client
- 配置客户端:
- Client type:
OpenID Connect - Client ID:
lobechat(或任意名称)
- Client type:
- 点击 Next
- 启用 Client authentication(On)
- 点击 Next 然后 Save
配置重定向 URI
在客户端 Settings 标签页中:
- 在 Valid redirect URIs 下添加重定向 URI
回调 URL 格式:
- 本地开发:
http://localhost:3210/api/auth/callback/keycloak - 生产环境:
https://your-domain.com/api/auth/callback/keycloak
获取客户端密钥
前往 Credentials 标签页复制 Client secret。
获取 Issuer URL
Issuer URL 格式:https://your-keycloak-domain/realms/your-realm
例如:https://keycloak.example.com/realms/master
配置环境变量
| 环境变量 | 类型 | 描述 |
|---|---|---|
AUTH_SECRET | 必选 | 会话加密密钥,使用 openssl rand -base64 32 生成 |
AUTH_SSO_PROVIDERS | 必选 | 填写 keycloak |
AUTH_KEYCLOAK_ID | 必选 | Client ID |
AUTH_KEYCLOAK_SECRET | 必选 | Client Secret |
AUTH_KEYCLOAK_ISSUER | 必选 | https://your-keycloak-domain/realms/your-realm |
前往 📘 环境变量 可查阅相关变量详情。
部署成功后,用户将可以通过 Keycloak 身份认证并使用 LobeHub。