主题
社交登录
SYS-AUTH-05 | 模块
system| 用微信、钉钉、企业微信等平台身份登录,并把它绑定到系统账号。
1. 使用角色与场景
角色:终端用户、平台管理员
- 员工用企业微信扫码登录
- 运营在后台维护社交平台配置与绑定关系
2. 接口与权限点
| 方法 | 路径 | 权限点 | 摘要 | 代码行 |
|---|---|---|---|---|
| POST | /system/social-client/create | system:social-client:create | 创建社交客户端 | SocialClientController#L37 |
| PUT | /system/social-client/update | system:social-client:update | 更新社交客户端 | SocialClientController#L44 |
| DELETE | /system/social-client/delete | system:social-client:delete | 删除社交客户端 | SocialClientController#L52 |
| DELETE | /system/social-client/delete-list | system:social-client:delete | 批量删除社交客户端 | SocialClientController#L61 |
| GET | /system/social-client/get | system:social-client:query | 获得社交客户端 | SocialClientController#L70 |
| GET | /system/social-client/page | system:social-client:query | 获得社交客户端分页 | SocialClientController#L79 |
| POST | /system/social-client/send-subscribe-message | system: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/get | system:social-user:query | 获得社交用户 | SocialUserController#L65 |
| GET | /system/social-user/page | system:social-user:query | 获得社交用户分页 | SocialUserController#L74 |
3. 代码定位
| 层 | 位置 |
|---|---|
| Controller | modules/system/src/main/java/com/pmforge/module/system/controller/admin/socail/SocialClientController.java#L37 |
| Controller | modules/system/src/main/java/com/pmforge/module/system/controller/admin/socail/SocialUserController.java#L38 |
| DO | modules/system/src/main/java/com/pmforge/module/system/dal/dataobject/social/SocialClientDO.java |
| DO | modules/system/src/main/java/com/pmforge/module/system/dal/dataobject/social/SocialUserDO.java |
| DO | modules/system/src/main/java/com/pmforge/module/system/dal/dataobject/social/SocialUserBindDO.java |
4. 数据表
| 表 | DO |
|---|---|
system_social_client | SocialClientDO |
system_social_user | SocialUserDO |
system_social_user_bind | SocialUserBindDO |
5. 机制与配置
- JustAuth 适配各平台授权协议
- 绑定表把第三方 openid 映射到系统用户
6. 常见问题与排查
- 回调域名需在第三方平台白名单中登记
- 同一用户重复绑定时要注意唯一索引冲突
7. 关联
- 需求原件:01-01-认证授权
- 相关卡片:SYS-USER-01