Facebook 登录（可选）

[English Version]

终端用户可能希望使用 Facebook 账号来登录 RainMaker 移动应用。 本节将介绍如何为终端用户配置 Facebook 登录。

前提条件

---

1. 已创建 Facebook 开发者账号，请参考 FBDev。
2. 已部署 ESP-RainMaker-Core。
3. 已创建自定义域，请参考 配置自定义域名。

配置 Facebook 登录

创建 Facebook 登录应用

---

1. 登录 FBDev。
2. 在 My Apps 菜单中，选择 Create App。
3. 选择一种应用类型 (App Type)。
4. 输入应用名称，点击 Create App。
5. 在左侧导航栏，选择 Settings > Basic。
   
6. 请记下 App ID 和 App Secret 两个字段，下节中将会用到。
7. 在页面底部，点击 + Add Platform。
8. 选择 Website。
9. 在 Website > Site URL 一栏中，输入您的应用登录页面的路径： https://<your_user_pool_domain>/login?response_type=code&client_id=<your_client_id>&redirect_uri=https://www.example.com
10. 点击 Save changes。
11. 在 App Domains 一栏中，输入您的用户池域的根路径： https://<your_user_pool_domain>。
12. 在导航栏中，点击 Add Product，在 Facebook Login 下点击 Set up。
13. 在导航栏中，点击 Facebook Login > Settings。
14. 在 Valid OAuth Redirect URIs 一栏中，输入您的用户池域通向 /oauth2/idpresponse 端点的路径： https://<your_user_pool_domain>/oauth2/idpresponse
15. 点击 Save changes。

在 RainMaker 管理面板中将 Facebook 配置为身份供应商

1. 用您的管理员账号登录 RainMaker 管理面板，打开 Deployment Settings。
2. 打开 Identity Providers。
3. 点击 + 图标，添加身份供应商配置。
4. 从 Identity Provider 下拉菜单中选择 Facebook。
5. 将上一小节中记下的 App ID 和 App Secret 中的内容分别填入 Client ID 和 Client Secret 两栏。

配置回调 URL（重定向 URI）

---

回调 URL 指明了用户使用第三方认证成功登录后将被重定向的网页。用户使用第三方认证服务成功注册后，将被重定向至这些网页之一。

如果需要用户重定向至手机应用，您应为该应用设置回调 URL。为手机应用设置回调 URL（重定向 URI），请参考以下小节：

• 为安卓应用获取重定向 URI
• 为 iOS 应用获取重定向 URI

在 RainMaker 管理面板中配置回调 URL，请参考 配置 Cognito 回调 URL。

验证 Facebook 登录

---

本节将介绍如何验证 Facebook 登录是否已配置成功。

1. 登录 AWS 控制台，打开 Cognito 服务，点击 rainmaker-user-email-mobile-pool。
2. 在左侧菜单栏中选择 App Client Settings。
3. 找到应用客户端 rainmaker-user-email-mobile-pool-client。
4. 在 Enable Identity Providers 中勾选 Facebook。
5. 向下滚动页面并点击 Launch Hosted UI。
6. 在跳出的窗口中，您可以看到以下选项：
7. 点击 Continue with Facebook。
8. 完成 Facebook 登录。
9. 点击 Next，您将被重定向到您在 Cognito 应用客户端中配置的回调 URL。在浏览器网址栏中，您可以找到您的验证码。
   注意 - 本示例已将回调 URL 设置为乐鑫官网主页网址，因此会被重定向至该页面。