登录认证

说明

登录方式

登录方式	说明
用户名密码登录	用户输入用户名和密码进行登录。
微信小程序登录	用户进入小程序后进行登录。
第三方Token登录	平台对接第三方系统或统一认证时使用已有的Token进行登录。

登录流程

用户名密码登录

用户访问平台，在登录页面输入用户名密码进行登录。

用户名可输入用户的账户名、手机号、邮箱中的任意一种。

用户登录前需添加到平台中，否则登录失败。

微信小程序登录

用户进入小程序后，通过微信分配的OpenId或UnionId进行登录。

登录失败时，可由前端唤起手机号使用授权组件来获取手机号，并使用OpenId或UnionId及手机号进行绑定，绑定成功后使用OpenId或UnionId再次登录即可。

💡注意

平台提供了根据code获取用户微信小程序OpenId/UnionId以及获取用户手机号的接口。 详细请参考微信小程序管理的说明。

三方Token登录

业务系统在获取到第三方发放的Token后，可使用该Token和用户信息(用户账户名、手机号、邮箱等)在平台内进行登录，平台将使用第三方发放的Token进行身份验证。

用户信息扩展

如果业务方有自己的用户体系，仅需要平台的登录功能，可通过实现接口UserIdentityLoader来返回业务方的用户信息。

• 登录认证实现，提供了用户信息扩展接口UserIdentityLoader。

<dependency>
    <groupId>com.ikingtech.framework</groupId>
    <artifactId>sdk-authenticate-embedded</artifactId>
</dependency>

• 登录认证服务。

<dependency>
    <groupId>com.ikingtech.platform</groupId>
    <artifactId>service-authentication</artifactId>
</dependency>

身份信息扩展

如果业务方希望在登录时，向用户身份信息中添加业务数据，可通过实现接口IdentityExtensionLoader 接口来返回业务方的数据（Map形式），平台在登录成功后会调用该接口，将业务方返回的数据添加到用户身份信息中。

💡注意

如需向用户身份信息中添加业务数据，需启身份信息扩展功能。

• 配置

iking:
  framework:
    auth:
      extension-enable: true

• 登录扩展，提供了用户信息扩展接口IdentityExtensionLoader。

<dependency>
    <groupId>com.ikingtech.framework</groupId>
    <artifactId>sdk-authenticate-extension</artifactId>
</dependency>