配置 Logto 身份验证
Logto 是一个开源的 Auth0 替代方案,专为现代应用和 SaaS 产品设计。
在 Logto 中创建应用
- 登录 Logto 控制台
- 前往 Applications,点击 Create application
- 选择 Traditional web 作为应用类型
- 填写应用名称:
LobeHub - 配置重定向 URI:
回调 URL 格式: https://your-domain.com/api/auth/callback/logto
- 创建后,记下 App ID 和 App Secret
获取 Issuer URL
Issuer URL 是 Logto 端点,通常为:
- 云版:
https://your-tenant.logto.app/oidc - 自托管:
https://your-logto-domain/oidc
配置环境变量
在部署 LobeHub 时,你需要配置以下环境变量:
| 环境变量 | 类型 | 描述 |
|---|---|---|
AUTH_SECRET | 必选 | 用于加密会话令牌的密钥。使用以下命令生成:openssl rand -base64 32 |
AUTH_SSO_PROVIDERS | 必选 | SSO 提供商。使用 Logto 请填写 logto |
AUTH_LOGTO_ID | 必选 | Logto 应用的 App ID |
AUTH_LOGTO_SECRET | 必选 | Logto 应用的 App Secret |
AUTH_LOGTO_ISSUER | 必选 | Logto Issuer URL(例如 https://your-tenant.logto.app/oidc) |
LOGTO_WEBHOOK_SIGNING_KEY | 可选 | 用于验证 Logto 发送的 Webhook 请求是否合法的密钥 |
前往 📘 环境变量 可查阅相关变量详情。
配置 Webhook(可选)
配置 Logto 的 Webhook,以便在用户信息更新时 LobeHub 可以接收到通知并同步数据。
- 前往 Logto 控制台的
Webhooks,创建一个 Webhook - 填写以下字段:
- 端点 URL:
https://your-domain.com/api/webhooks/logto - 事件:
User.Data.Updated:同步用户资料信息的更新User.SuspensionStatus.Updated:同步用户暂停状态
- 端点 URL:
- 创建后,复制
签名密钥填写到环境变量LOGTO_WEBHOOK_SIGNING_KEY
部署成功后,用户将可以通过 Logto 身份认证并使用 LobeHub。