社交登录配置
Forge Admin 支持集成第三方社交平台的 OAuth2.0 登录,用户可直接使用微信、钉钉、GitHub 等账号登录系统,无需单独注册。
功能入口
登录管理后台后,点击左侧菜单 系统管理 > 社交登录配置,进入第三方登录管理页面。页面以 Tab 页形式展示各平台配置项。
支持的平台
Forge Admin 通过 forge-starter-social 模块支持以下第三方登录:
| 平台 | 说明 | 典型场景 |
|---|---|---|
| 微信 | 微信公众号/开放平台扫码登录 | 企业内部系统 |
| 钉钉 | 钉钉扫码登录 | 企业协同办公 |
| GitHub | GitHub OAuth 登录 | 开发者社区 |
微信登录配置
第一步:获取应用凭证
- 登录微信开放平台,创建网站应用
- 获取 AppID 和 AppSecret
- 配置回调域名为系统访问域名
第二步:系统内配置
- 切换到 微信配置 Tab
- 填写以下信息:
- AppID:从微信开放平台获取
- AppSecret:从微信开放平台获取
- 回调地址:系统自动生成,需确保与开放平台一致
- 启用状态:勾选以开启微信登录
- 点击 保存
钉钉登录配置
第一步:获取应用凭证
- 登录钉钉开放平台,创建企业内部应用
- 获取 AppKey 和 AppSecret
第二步:系统内配置
- 切换到 钉钉配置 Tab
- 填写 AppKey、AppSecret 和回调地址
- 勾选启用状态,保存配置
GitHub 登录配置
第一步:获取 OAuth App
- 登录 GitHub,进入 Settings > Developer settings > OAuth Apps
- 点击 New OAuth App,填写应用名称和回调 URL
- 创建后获取 Client ID 和 Client Secret
第二步:系统内配置
- 切换到 GitHub 配置 Tab
- 填写 Client ID 和 Client Secret
- 配置回调地址
- 勾选启用,保存
登录效果
配置完成后,系统登录页面会自动出现对应平台的登录按钮:
- 用户点击平台图标(微信/钉钉/GitHub)
- 跳转到第三方授权页面进行确认
- 授权成功后,系统自动创建或绑定用户账号
- 首次登录用户默认使用社交平台昵称作为系统昵称
注意事项
- 回调地址必须与第三方平台配置完全一致
- AppSecret 等敏感信息保存后脱敏显示,需妥善保管
- 社交登录用户的权限需通过角色管理手动配置
- 可同时启用多个平台的登录方式
