要使用此插件,您需要访问付费的 Apple 开发者账户。
| 摘要 | Discourse Apple 认证 允许用户使用 Apple 认证登录。 | |
| 安装指南 | 此插件已随 Discourse 核心捆绑。无需单独安装插件。 |
要试用,请访问 try.discourse.org 并登录。以下是它在 iOS 上运行的演示:
要进行设置,您需要在 Apple 开发者控制台中配置多项内容:
-
访问 Sign In - Apple 并登录
-
设置 App ID
- 前往 “证书、标识符和配置文件”
- 点击左侧菜单中的“标识符”
- 点击 + 按钮创建新标识符
- 选择"App IDs",然后继续
- 选择"App",然后继续
- 输入描述(用户在其授权应用列表中可见)。例如"Awesome Community Login"
- 输入 Bundle ID。Apple 建议反转您的域名,例如
com.example.forum - 向下滚动并启用“使用 Apple 登录”
- 点击“继续”
- 记下稍后需要的 Team ID
- 点击“注册”
-
设置 Services ID
- 前往 “证书、标识符和配置文件”
- 点击 + 按钮创建新标识符
- 选择"Services ID",然后继续
- 输入描述。这将在用户登录时显示。例如"Awesome Discourse Community"
- 输入 Bundle ID。您可以使用与 App ID 相同的 ID,并在末尾添加
.login - 记下此 Bundle ID,稍后将用作 Client ID
- 继续并注册
- 在列表中找到该服务 ID 并打开它
- 启用“使用 Apple 登录”,然后点击“配置”
- 输入您的网站域名,如
forum.example.com,以及回调 URL,如https://forum.example.com/auth/apple/callback - 点击“下一步”、“完成”、“继续”并保存
-
设置密钥
- 点击左侧的“密钥”
- 点击 + 创建新密钥
- 输入名称,例如"Awesome Community Login"
- 启用“使用 Apple 登录”,然后点击“配置”
- 选择之前创建的 App ID
- 保存并继续
- 注册
- 记下稍后需要的 Key ID
- 下载密钥并妥善保管。它将作为 apple_pem 值
- 完成
-
进入您的 Discourse 站点设置
- 搜索
apple_ - 输入之前的 client id、team id 和 key id
- 在文本编辑器中打开密钥文件,全选内容,然后复制并粘贴到
apple pem站点设置中 - 启用
sign in with apple enabled
- 搜索
现在试试看——如果一切按计划进行,您应该会在登录屏幕上看到一个“使用 Apple 登录”按钮。
私人邮箱
如果用户在登录时选择“隐藏我的邮箱”,论坛将获得 Apple 提供的“私人中继”地址。为了让您的论坛能够与该地址通信,您需要向 Apple 验证该地址。
-
访问 Sign In - Apple 并登录
-
点击左侧的“更多”,然后在“用于电子邮件通信的 Apple 登录”下点击“配置”
-
在“邮件源”旁边点击 +
-
在“域名”下,输入您的网站发送邮件的域名。(对于 CDCK 托管客户,这是
discoursemail.com) -
保存,并确认该地址的 SPF 已验证
注意:在此处输入单个邮箱地址会破坏 Discourse 的“通过邮件回复”功能。您必须添加整个域名。
