配置 Apple 身份验证
Apple 登录需要付费的 Apple Developer 账户($99 / 年),且不支持 localhost。开发和生产环境都必须使用 HTTPS 域名。
创建 App ID
- 前往 Apple Developer Portal
- 导航到 Certificates, Identifiers & Profiles > Identifiers
- 点击 + 注册新标识符
- 选择 App IDs > App 类型 > Continue
- 填写:
- Description: 如
LobeHub - Bundle ID: 如
com.yourcompany.lobechat
- Description: 如
- 启用 Sign In with Apple 功能
- 点击 Continue > Register
创建 Services ID
- 返回 Identifiers,点击 +
- 选择 Services IDs > Continue
- 填写:
- Description: 如
LobeHub Web - Identifier: 如
com.yourcompany.lobechat.web(这是你的 Client ID)
- Description: 如
- 点击 Continue > Register
配置 Services ID
- 点击已创建的 Services ID
- 启用 Sign In with Apple
- 点击 Configure
- 选择 Primary App ID
- 添加域名和回调 URL:
- Domains:
your-domain.com - Return URLs:
https://your-domain.com/api/auth/callback/apple
- Domains:
- 点击 Save > Continue > Save
回调 URL 格式:
- 生产环境:
https://your-domain.com/api/auth/callback/apple - Apple 不支持 localhost 或 HTTP URL
创建登录密钥
- 导航到 Keys,点击 +
- 填写密钥名称
- 启用 Sign In with Apple,点击 Configure
- 选择 Primary App ID
- 点击 Save > Continue > Register
- 下载密钥文件(
.p8)- 只能下载一次 - 记录:
- Key ID: 密钥页面显示
- Team ID: 开发者门户右上角显示
生成 Client Secret
Apple 要求使用 JWT 作为 client secret。使用 .p8 密钥文件生成:
JavaScript
JWT 最长有效期为 180 天。需要在过期前重新生成并更新。
配置环境变量
| 环境变量 | 类型 | 描述 |
|---|---|---|
AUTH_SECRET | 必选 | 会话加密密钥,使用 openssl rand -base64 32 生成 |
AUTH_SSO_PROVIDERS | 必选 | 填写 apple |
AUTH_APPLE_CLIENT_ID | 必选 | 你的 Services ID |
AUTH_APPLE_CLIENT_SECRET | 必选 | 生成的 JWT |
AUTH_APPLE_APP_BUNDLE_IDENTIFIER | 可选 | App Bundle ID(用于原生应用集成) |
前往 📘 环境变量 可查阅相关变量详情。
部署成功后,用户将可以通过 Apple 身份认证并使用 LobeHub。
常见问题
不支持 localhost
Apple 登录不支持 localhost 或非 HTTPS URL。本地开发请使用 ngrok 等隧道服务或部署到带有 HTTPS 的测试环境。
密钥过期
JWT client secret 最长有效期为 180 天。请设置提醒在过期前重新生成。