Skip to content

社交登录 ​

SYS-AUTH-05 | 模块 system | 用微信、钉钉、企业微信等平台身份登录,并把它绑定到系统账号。

1. 使用角色与场景 ​

角色:终端用户、平台管理员

  • 员工用企业微信扫码登录
  • 运营在后台维护社交平台配置与绑定关系

2. 接口与权限点 ​

方法路径权限点摘要代码行
POST/system/social-client/createsystem:social-client:create创建社交客户端SocialClientController#L37
PUT/system/social-client/updatesystem:social-client:update更新社交客户端SocialClientController#L44
DELETE/system/social-client/deletesystem:social-client:delete删除社交客户端SocialClientController#L52
DELETE/system/social-client/delete-listsystem:social-client:delete批量删除社交客户端SocialClientController#L61
GET/system/social-client/getsystem:social-client:query获得社交客户端SocialClientController#L70
GET/system/social-client/pagesystem:social-client:query获得社交客户端分页SocialClientController#L79
POST/system/social-client/send-subscribe-messagesystem:social-client:query发送订阅消息SocialClientController#L87
POST/system/social-user/bind—社交绑定,使用 code 授权码SocialUserController#L38
DELETE/system/social-user/unbind—取消社交绑定SocialUserController#L47
GET/system/social-user/get-bind-list—获得绑定社交用户列表SocialUserController#L54
GET/system/social-user/getsystem:social-user:query获得社交用户SocialUserController#L65
GET/system/social-user/pagesystem:social-user:query获得社交用户分页SocialUserController#L74

3. 代码定位 ​

层位置
Controllermodules/system/src/main/java/com/pmforge/module/system/controller/admin/socail/SocialClientController.java#L37
Controllermodules/system/src/main/java/com/pmforge/module/system/controller/admin/socail/SocialUserController.java#L38
DOmodules/system/src/main/java/com/pmforge/module/system/dal/dataobject/social/SocialClientDO.java
DOmodules/system/src/main/java/com/pmforge/module/system/dal/dataobject/social/SocialUserDO.java
DOmodules/system/src/main/java/com/pmforge/module/system/dal/dataobject/social/SocialUserBindDO.java

4. 数据表 ​

表DO
system_social_clientSocialClientDO
system_social_userSocialUserDO
system_social_user_bindSocialUserBindDO

5. 机制与配置 ​

  • JustAuth 适配各平台授权协议
  • 绑定表把第三方 openid 映射到系统用户

6. 常见问题与排查 ​

  • 回调域名需在第三方平台白名单中登记
  • 同一用户重复绑定时要注意唯一索引冲突

7. 关联 ​