67 lines
2.9 KiB
Markdown
67 lines
2.9 KiB
Markdown
# Google OpenID Connect 部署说明
|
|
|
|
## 登录与绑定策略
|
|
|
|
- Google 身份只使用 OpenID Connect 的 `sub` 作为唯一标识,不以邮箱匹配本地用户。
|
|
- 未绑定的 Google 账号不能登录,也不会自动注册本地账号。
|
|
- 用户必须先通过账号密码登录,在“个人中心 -> 账号安全”中主动绑定 Google。
|
|
- 一个本地账号只能绑定一个 Google 身份,一个 Google 身份也只能绑定一个本地账号。
|
|
|
|
## 数据库升级
|
|
|
|
部署应用前执行:
|
|
|
|
```sql
|
|
SOURCE /path/to/myEpusdt/sql/google_oauth.sql;
|
|
```
|
|
|
|
脚本只新增 `sys_user_google_oauth` 表,不修改 `sys_user` 和现有登录数据。执行前仍应按生产规范备份数据库。
|
|
|
|
## Google Cloud 配置
|
|
|
|
1. 在 Google Auth Platform 创建 Web application 类型的 OAuth Client。
|
|
2. OAuth 同意屏幕只申请 `openid`、`email`、`profile`。
|
|
3. 将后端固定回调地址登记为 Authorized redirect URI,例如:
|
|
|
|
```text
|
|
https://api.example.com/auth/google/callback
|
|
```
|
|
|
|
登记值必须与 `GOOGLE_OAUTH_REDIRECT_URI` 完全一致。生产环境必须使用 HTTPS;仅本地开发允许 `http://localhost` 或 `http://127.0.0.1`。
|
|
|
|
## 环境变量
|
|
|
|
Linux 可在应用启动前设置:
|
|
|
|
```bash
|
|
export GOOGLE_OAUTH_ENABLED=true
|
|
export GOOGLE_OAUTH_CLIENT_ID='your-client-id.apps.googleusercontent.com'
|
|
export GOOGLE_OAUTH_CLIENT_SECRET='your-client-secret'
|
|
export GOOGLE_OAUTH_REDIRECT_URI='https://api.example.com/auth/google/callback'
|
|
export GOOGLE_OAUTH_FRONTEND_RESULT_URL='https://app.example.com/auth/google/result'
|
|
```
|
|
|
|
`GOOGLE_OAUTH_CLIENT_SECRET` 只能保存于服务器环境变量或密钥管理系统,不得写入前端、日志或版本库。修改环境变量后重启后端服务。
|
|
|
|
## 发布验证
|
|
|
|
本项目使用 `ruoyi-admin.jar + lib/` 的外置依赖方式发布。执行 Maven `package` 后,必须同时部署:
|
|
|
|
```text
|
|
ruoyi-admin/target/ruoyi-admin.jar
|
|
ruoyi-admin/target/lib/
|
|
```
|
|
|
|
不能只替换 `ruoyi-admin.jar`。Google OIDC 至少依赖 `google-api-client-1.34.1.jar`、`google-http-client-1.41.8.jar`、`google-http-client-gson-1.41.8.jar` 和 `google-oauth-client-1.33.2.jar`;缺少 `google-http-client` 会在启动时出现 `NoClassDefFoundError: com/google/api/client/json/JsonFactory`。
|
|
|
|
1. 使用本地账号密码登录,进入个人中心绑定 Google。
|
|
2. 退出系统,再从登录页使用已绑定的 Google 账号登录。
|
|
3. 使用未绑定的 Google 账号登录,确认页面提示先登录本地账号绑定。
|
|
4. 禁用一个已绑定的本地用户,确认 Google 登录被拒绝。
|
|
5. 确认重复回调、重复交换登录票据均被拒绝。
|
|
6. 确认原有账号密码登录、角色、菜单权限和退出登录不受影响。
|
|
|
|
## 回滚
|
|
|
|
设置 `GOOGLE_OAUTH_ENABLED=false` 并重启后端即可关闭登录入口。原有密码登录保持可用;关联表建议保留,避免重新发布后丢失既有绑定关系。
|