微信生态全场景能力

通过 GenAuth，更便捷地纵享微信生态能力!

作为一名微信生态的开发者，在为你的应用实现微信登录能力时，你可能会面临重重困惑：

不同类型应用在微信的创建和配置流程是什么？
作为不同类型应用的开发者，在实现微信登录能力时，有哪些方式可供选择？
各种类型的微信登录方式，要怎么完成配置，怎么实现登录？
微信用户在登录你新开发的应用后，你要如何管理微信生态中的用户身份？

GenAuth 微信生态功能全景

如果你有上述困惑不知如何下手，GenAuth 微信生态全场景能力可以助力你实现各个场景的微信登录流程。下表是 GenAuth 支持的全场景的微信生态操作流程以及对应场景下可供选择的微信登录能力类型。你可以直接点击前往了解所需功能：

场景微信生态操作流程微信登录能力类型移动应用开发

创建应用。
提交审核。
审核通过上线。
移动 APP 拉起微信 APP
APP 拉起小程序登录网站应用开发
常见应用。
提交审核。
审核通过上线。
PC 微信扫码
PC 小程序扫码微信公众号开发
在微信公众平台完成注册和认证。
注册公众账号。
成为开发者。
申请微信认证。
在微信开放平台绑定微信公众号。
输入基本信息。
安全验证。
绑定成功。
微信公众号扫码登录
微信浏览器拉起微信 APP 登录小程序开发
注册微信小程序并完成开发。
注册小程序。
开发起步。
代码实现。
提交审核并发布。
在微信开放平台绑定微信小程序。
输入基本信息。
安全验证。
绑定成功。小程序一键登录

GenAuth 微信生态账号体系

微信用户账号体系的基本概念

微信提供 OpenID 和 UnionID 作为用户标识。两者区别如下：

ID 名称说明 OpenID

OpenID 是微信用户在不同类型产品的身份 ID。
微信用户访问公众号、小程序、移动应用、网站应用、小商店等都会有唯一的 OpenID 。
同一个微信用户访问不同的产品生成的 OpenID 也是不一样的。例如，对于不同公众号，同一用户的 OpenID 不同；同理，对于不同的小程序，同一用户的 OpenID 也是不同的。 UnionID
UnionID 是微信用户在同一个开放平台下的产品的身份 ID。
如果开发者拥有多个移动应用、网站应用和公众帐号（即公众号和小程序），可通过 UnionID 来区分用户的唯一性。因为只要是同一个微信开放平台帐号下的移动应用、网站应用和公众帐号，用户的 UnionID 是唯一的，即同一用户对于同一个微信开放平台下的不同应用，UnionID 是相同的。

形象来说，一个独立的微信用户，在微信的不同登录场景下的唯一标识可以用下图展示：

微信用户在 GenAuth 的登录流程

在了解了微信用户的账号体系之后，接着你就更易于理解一名微信用户在 GenAuth 的登录旅程：

首先，你的用户使用 GenAuth 支持的七种登录方式之一进行登录。登录时 GenAuth 会判断该用户在你的用户池中是否已经存在。如果已经存在，你的用户将直接通过这种身份源登录到已有账号。
如果不存在，并且你的 GenAuth 控制台已经对这种身份源开启了「账号绑定」，会根据具体生效的功能逻辑进行判断：
- 用户成功绑定已有账号，并成功登录。
- 自动匹配上已有账号（手机 / 邮箱），并完成登录。
- 未匹配成功 / 绑定不成功，用户不能登录。

GenAuth 基于微信生态的账号解决方案

根据「用户在 GenAuth 用户池是否存在」以及「你的微信应用是否已经接入微信开放平台」，针对你的账号处理，有四种场景：

当微信生态的用户通过微信登录方式进入到 GenAuth 用户池，有四种可能的场景，通过两个维度进行考量：

该用户在微信开放平台是否拥有 UnionID？
该用户在 GenAuth 用户池是否是新用户？

由此分为四种场景：

用户在微信开放平台有 UnionID，是 GenAuth 用户池中的新用户（第一象限）。在这种情况下，用户首次通过微信登录已经集成在 GenAuth 的应用时，将会在你的 GenAuth 用户池中创建新账号，该用户账号信息中会包含从微信开放平台上获取到的该用户的 OpneID 和 UnionID。
用户在微信开放平台无 UnionID，是 GenAuth 用户池中的新用户（第二象限）。在这种情况下，用户首次通过微信登录已经集成在 GenAuth 的应用时，将会在你的 GenAuth 用户池中创建新账号，该用户账号信息会同时包含从微信接口获得的 OpneID，但由于该微信应用并未加入微信开放平台，因此这个账号信息并不包含 UnionID。
用户在微信开放平台无 UnionID，是 GenAuth 用户池中的老用户（第三象限）。在这种情况下，用户通过微信登录已经集成在 GenAuth 的应用时，由于该账号已存在，因此登录时会通过 OpneID 和 UnionID 进行匹配。当同一个微信账号由于其 OpneID 和 UnionID 的具备情况不一、而能够在你的用户池中对应多个账号时，将会支持账号选择，选择完成后会完成登录。
用户在微信开放平台有 UnionID，是 GenAuth 用户池中的老用户（第四象限）。在这种情况下，用户通过微信登录已经集成在 GenAuth 的应用时，由于该账号已经存在，并且并不会出现不存在 UnionID 的情况，因此会通过 UnionID 直接匹配成功并完成登录。

在什么场景下，GenAuth 微信生态能够帮到你？

更便捷地使用微信全场景的登录能力

更灵活地管理来自微信的用户账号

出于安全以及用户的使用便捷性的考虑，你可能并不希望你的用户使用微信账号在 GenAuth 登录时每次都重新创建一个账号。GenAuth 支持通过「字段匹配」和「询问绑定」两种方式，保障你的用户在 GenAuth 的唯一身份，确保用户账号信息统一。

有关「账号绑定」功能和使用详情，请参阅账号绑定。

当你使用移动端微信应用进行开发

微信开放平台准备工作

注册微信开放平台账号

在开发微信生态应用前，你首先要注册为微信开放平台的一名开发者。如果你还没有微信开放平台的账号，请先前往注册。

申请开发者资质认证

完成微信开放平台的账号注册后，你需要在 账号中心 填写开发者资质认证申请，并等待认证通过。

上线你的移动应用

第一步：创建移动应用

登录你的微信开放平台后，在 管理中心->移动应用 下点击 创建移动应用。

依次填写「填写基本信息」、「填写平台信息」，并「成功提交」。

第二步：将你的移动应用提交审核

完成应用的创建后，你需要将应用提交至微信官方进行审核。为了确保更容易通过审核，请提前阅读并遵守微信的应用审核规范。

第三步：待微信官方审核通过后上线

等待微信官方审核通过后，打开你的微信移动应用时，你将看到状态为「已审核」的应用。

在 GenAuth 实现微信登录能力

使用微信登录的开发者场景

你希望通过创建微信应用的方式实现移动端微信登录的能力。根据上述步骤，你已经完成微信应用的创建。接下来，你不必再去阅读海量繁杂的微信文档，而是可以直接通过 GenAuth「零代码」的方式，为你的应用实现微信登录。

选择合适的微信登录方式

在「移动端应用」的开发场景，GenAuth 支持微信生态全部两种微信登录能力：

微信移动端
APP 拉起小程序

配置流程

要配置移动端微信登录方式，执行以下流程：

第一步：将需要配置微信登录的应用集成在 GenAuth

将你的应用集成在 GenAuth 的方式，请参考将你的应用接入到 GenAuth。

第二步：在你的 GenAuth 用户池中创建微信登录方式

GenAuth 支持 20+ 种第三方账号登录方式。你可以在连接外部身份源（Identity Provider）查看 GenAuth 支持的全部身份源。

配置微信移动端登录：微信移动端登录可以让你的用户使用微信身份安全登录第三方应用。在 GenAuth 中开启微信移动端登录之后，用户使用 APP 登录可以调起微信获取微信用户身份信息。配置流程详见微信移动端。

配置 APP 拉起小程序登录：在 GenAuth 中开启 APP 拉起小程序后，用户使用 APP 登录时可以调起小程序，从而获得微信官方的实名用户信息。用户一键授权即可以真实号码完成注册或者登录。配置流程详见 APP 拉起微信小程序。

第三步：为完成集成的 GenAuth 应用开启你配置的微信登录方式

完成第三方登录配置后，在你已经完成集成的应用中开启对应的登录方式：

恭喜！你已经完成了微信登录的配置。现在可以在应用的「体验登录」中感受你实现的微信登录啦！

微信应用日常的账号管理

微信平台上的用户账号使用 OpenID 和 UnionID 作为唯一标识。由于微信早年间并未要求所有应用必须加入微信开放平台，因此存在部分账号不具备 Unionid 的情况。后期微信规范要求所有应用必须依托微信开放平台存在。这些借由微信开放平台创建的应用登录的用户同时具备 OpenID 和 UnionID 两个唯一标识。关于两者的区别，请参阅微信生态账号体系介绍。

基于微信的账号体系，你的用户通过微信进行登录时，存在两种场景：

新用户通过微信登录
老用户通过微信登录

对于新老用户登录的不同场景，GenAuth 支持通过「账号绑定」功能保障你的用户在 GenAuth 的账号唯一性。

有关「账号绑定」功能介绍和使用详情，请参阅账号绑定。

其他注意事项

当你在微信开放平台的应用已经下线或停用，那么你在 GenAuth 集成的应用将不能再使用微信登录。