系统对接国内多个第三方平台，实现三方登录的功能。例如说：

• 管理后台：企业微信、阿里钉钉
• 用户 App：微信公众号、微信小程序

# 1. 表结构

① 三方登录完成时，系统会将三方用户存储到 system_social_user (opens new window) 表中，通过 type (opens new window) 标记对应的第三方平台。

② 【未】关联本系统 User 的三方用户，需要在三方登录完成后，使用账号密码进行「绑定登录」，成功后记录到 system_social_user_bind (opens new window) 表中。

【已】关联本系统 User 的三方用户，在三方登录完成后，直接进入系统，即「快捷登录」。

# 2. 绑定登录

① 使用浏览器访问 http://127.0.0.1:1024/login (opens new window) 地址，点击 [钉钉] 或者 [企业微信] 进行三方登录。此时，会调用 /admin-api/system/auth/social-auth-redirect (opens new window) 接口，获得第三方平台的登录地址，并进行跳转。

然后，使用 [钉钉] 或者 [企业微信] 进行扫码，完成三方登录。

② 三方登录成功后，跳转回 http://127.0.0.1:1024/social-login (opens new window) 地址。此时，会调用 /admin-api/system/auth/social-login (opens new window) 接口，尝试「快捷登录」。由于该三方用户【未】关联管理后台的 AdminUser 用户，所以会看到 “未绑定账号，需要进行绑定” 报错。

③ 输入账号密码，点击 [提交] 按钮，进行「绑定登录」。此时，会调用 /admin-api/system/auth/login (opens new window) 接口（在账号密码登录的基础上，额外带上 socialType + socialCode + socialState 参数）。成功后，即可进入系统的首页。

# 3. 快捷登录

【相同】① 使用浏览器访问 http://127.0.0.1:1024/login (opens new window) 地址，点击 [钉钉] 或者 [企业微信] 进行三方登录。此时，会调用 /admin-api/system/auth/social-auth-redirect (opens new window) 接口，获得第三方平台的登录地址，并进行跳转。

【不同】② 三方登录成功后，跳转回 http://127.0.0.1:1024/social-login (opens new window) 地址。此时，会调用 /admin-api/system/auth/social-login (opens new window) 接口，尝试「快捷登录」。由于该三方用户【已】关联管理后台的 AdminUser 用户，所以直接进入系统的首页。

# 4. 绑定与解绑

访问 http://127.0.0.1:1024/user/profile (opens new window) 地址，选择 [社交信息] 选项，可以三方用户的绑定与解绑。

# 5. 配置文件

在 application-{env}.yaml (opens new window) 配置文件中，对应 justauth 配置项，填写你的第三方平台的配置信息。

系统使用 justauth-spring-boot-starter (opens new window) JustAuth (opens new window) 组件，想要对接其它第三方平台，只需要新增对应的配置信息即可。

# 6. 第三方平台的申请

• 阿里钉钉：https://justauth.wiki/guide/oauth/dingtalk/ (opens new window)
• 企业微信：https://justauth.wiki/guide/oauth/wechat_enterprise_qrcode/ (opens new window)
• 微信开放平台：https://justauth.wiki/guide/oauth/wechat_open/ (opens new window)

注意，如果第三方平台如果需要配置具体的授信地址，需要添加 /social-login 用于三方登录回调页、/user/profile 用于三方用户的绑定与解绑。