Facebook

RootAuth 支持接入 Facebook 登录。开启后，用户可以在登录/注册页选择「Facebook」，通过 Facebook 授权完成登录或注册。

路径：登录 RootAuth 控制台 → 进入目标应用 → 点击顶部导航栏的「配置」→「应用管理-认证配置」→ 选择「提供方」

 

1. 开始前准备

配置 Facebook 登录前，请先完成以下准备：

1. 拥有一个 Facebook 开发者账号。
2. 已在 Facebook 开发者平台创建应用。
3. 已获取 Facebook 应用编号和应用密钥。
4. 已准备好应用域名，用于配置 OAuth 回调地址。

Facebook 会校验 OAuth 跳转 URI。请确保 Facebook 应用后台配置的回调地址，与 RootAuth 后台展示的「有效OAuth跳转URI」一致。

 

2. 在 RootAuth 后台开启 Facebook

在「提供方」列表中找到 Facebook，点击右侧「启用」。

打开配置弹窗后，开启 Facebook 登录开关，并填写以下信息：

填写完成后，点击「保存」。

保存成功后，Facebook 会显示为「已启用」和「自定义凭证」，右侧按钮变为「管理」。后续如需修改配置，可点击「管理」重新编辑。

 

3. 账号绑定设置

Facebook 登录支持设置是否自动关联已有账号。

• 开启「账号绑定」后，如果 Facebook 返回的邮箱与系统内已有账号邮箱一致，RootAuth 会自动关联到该账号并完成登录。若没有匹配到邮箱，则会创建新账号。
• 关闭「账号绑定」后，Facebook 登录不会自动关联已有邮箱账号。即使 Facebook 邮箱与系统中已有账号邮箱一致，也会按照 Facebook 登录入口创建或登录独立账号。

如果历史上已存在不同入口创建的账号，开启账号绑定后，系统会根据当前登录入口和账号关联关系判断登录到哪个账号。

 

4. 用户如何使用 Facebook 登录

开启后，登录/注册页会展示 Facebook 登录按钮。

如果同时开启了 Google、Telegram 和 Facebook，第三方登录按钮会按配置显示在登录/注册页中。用户点击「Facebook」后，会跳转到 Facebook 授权页面。

用户确认授权后，RootAuth 会自动完成以下操作：

1. 获取 Facebook 返回的用户信息。
2. 根据账号绑定设置判断是否关联已有账号。
3. 如果可以关联已有账号，直接登录该账号。
4. 如果没有可关联账号，自动创建新账号并完成登录。

 

5. 查看用户的 Facebook 认证方式

用户通过 Facebook 登录或注册后，可以在用户详情中查看认证记录。

进入「用户管理」，打开对应用户详情，在「认证方式」区域查看。

Facebook 认证方式会展示：

如果应用通过 API 解绑了用户的 Facebook账号，该认证方式会从用户详情中移除。

 

6.接入方式

Facebook 登录支持两种接入方式：

具体的接入指引，请参考开发集成文档

 

7. 关闭 Facebook 登录

如需关闭 Facebook 登录，进入 Facebook 管理弹窗，关闭开关并保存。

关闭后：

1. 登录/注册页不再展示 Facebook 登录按钮。
2. 已保存的 Facebook 凭证会保留。
3. 已有用户的 Facebook 绑定记录不会被删除。
4. 后续重新开启时，可继续使用原有配置。

如果用户看到缓存中的旧登录页并继续点击 Facebook 登录，系统会拦截请求并提示登录失败。用户刷新页面后，即可获取最新登录配置。