¶ 账号绑定

Authing 支持通过各种不同的方式登录：

• 常规方法是，你的用户使用账号密码、短信 / 邮箱验证码的方式完成登录。

• 另有一种便捷方式，如果你配置了第三方账号登录，那么你的用户可以直接通过自己的第三方账号实现一键登录。

¶ 在什么情况下你需要账号绑定功能？

我们来设想一种常见的场景：

你准备开始使用 Authing 的用户池。由于你的业务已经在正式运行中，已经积累了一些存量用户。于是首先你将存量用户导入到了你的 Authing 用户池：

这时，你的用户列表中用户信息可能已经包含了相应用户的手机号、邮箱、用户名等信息：

在这种情况下，你希望通过 Authing 提供的第三方账号登录能力，让你的用户不必每次登录时都必须输入账号密码，而是可以直接一键登录。

此时你可能会产生疑问：通过第三方账号登录至你集成在 Authing 的应用，如何保证用户通过不同登录方式到达同一个账号？

¶ 用户旅程

在开始详细介绍账号绑定功能之前，我们首先以「PC 微信扫码」身份源登录方式为例介绍 Authing 的账号绑定功能在你的用户登录全旅程中的作用，详见下图：

¶ 功能概要

当你在 Authing 配置第三方身份源时，可以通过「账号绑定」功能确保你的用户无论使用任何一种方式登录，最终都会登录到同一个账号，从而确保每个用户在 Authing 的账号唯一性。

Authing 支持通过两种方式实现账号绑定：

• 询问绑定

• 字段匹配

以 Github 为例：

你可以根据使用的身份源类型以及期望的用户旅程选择更适用的账号绑定模式。

¶ 字段匹配

「字段匹配」适用于能够获取到 Authing 用户账号的唯一性字段的身份源。

¶ 功能作用

开启「字段匹配」后，当你的用户首次通过这个身份源登录时，我们会使用从该身份源拉取到的、你所配置的字段，在 Authing 用户池中进行对应字段的匹配。匹配有两种可能的结果：

1. 匹配成功：用户将会直接成功登录至匹配到的账号，并完成该账号与该身份信息的绑定；
2. 匹配失败：将会在你的用户池自动创建新账号，该用户后续再次使用这种方式登录时，将会登录至本次创建的新账号。特别的，如果你的应用禁止注册，那么在匹配失败时该用户将会被禁止创建新账号，他将无法登录，保障你的应用访问安全。

¶ 用户使用旅程

按照上述步骤开启字段匹配后，当你的用户首次通过这个身份源进行登录时，会经历以下路径（以 Github 为例）：

第一步：使用 Github 登录

第二步：从 Github 获取到用户邮箱，在你的用户池中与存量用户进行邮箱匹配

第三步：

• 匹配成功：登录至已有账号
• 匹配失败：创建用户/禁止注册

¶ 管理员配置步骤

1. 在你要使用的身份源配置区找到「账号绑定」，并打开开关
2. 选择「字段匹配」
3. 选择匹配时使用的字段（手机号/邮箱/其他字段）

以 Github 为例：

¶ 询问绑定

「字段匹配」适用于能够获取到 Authing 用户账号的唯一性字段的身份源。对于其他由于第三方账号本身限制导致无法获取到关键性用户信息的身份源，你可以使用「询问绑定」的方式实现用户账号绑定的目的。

¶ 功能作用

你为你的用户配置了通过第三方账号登录的方式，同时你的用户池中已经有一些存量的用户账号。当你完成第三方账号配置后，用户可以通过第三方账号实现更加便捷的登录，你希望确保老用户使用新的登录方式仍旧可以登录到原有的账号上。

¶ 用户使用旅程

按照上述步骤开启询问绑定后，当你的用户首次通过这个身份源进行登录时，会经历以下路径（以微信公众号扫码登录为例）：

第一步：使用微信公众号扫码

第二步：选择「创建新账号」或者「绑定已有账号」

如果用户选择「创建新账号」，则会跳过账号绑定流程，登录成功直接在 Authing 用户池创建新的独立的用户账号；

如果用户选择「绑定已有账号」，则会进入第三步。

第三步：输入需绑定的账号

输入 Authing 用户池中已存在的、未绑定其他同种第三方账号（在本例中，即未绑定其他微信），用户即完成账号绑定旅程。

除了在登录时绑定账号之外，你的用户也可以直接在**个人中心 (opens new window)**（无论你使用的是 Authing 的个人中心或者使用你独立开发的个人中心）进行第三方账号的绑定（也可以自行解绑）。完成绑定后，即可以通过任何一种登录方式（常规的账号密码、第三方账号）登录至同一个账号。

¶ 管理员配置步骤

1. 在你要使用的身份源配置区找到「账号绑定」，并打开开关
2. 选择「询问绑定」
3. 选择支持进行绑定的方式（手机验证码、邮箱验证码、账号密码、手机号密码、邮箱密码）

以 Github 为例：

¶ 全身份源账号绑定功能支持状态

基于各第三方身份源的限制，当前 Authing 的账号绑定的功能实现情况如下表，你可以通过全局搜索的方式找到对应的身份源，以查看当前账号绑定功能的支持状态。