接入统一身份认证系统

## 接入统一身份认证系统
### 首先进入统一身份认证系统 https://maxid.demo2.jzkg.cn
#### （1）点击管理者控制台，登录
![](/media/202503/2025-03-12_193646_013083.png)
#### （2）进入统一身份认证系统，选择客户端管理，创建客户端
![](/media/202503/2025-03-13_093436_265893.png)
#### （3）在创建客户端处填写对应表单项，点击下一步
![](/media/202503/2025-03-12_200025_238379.png)
#### （4）配置能力配置，下一步
![](/media/202503/2025-03-12_194645_812241.png)
#### （5）配置登录设置，保存
![](/media/202503/2025-03-12_195043_448210.png)
#### （6）会跳转到详情页，点击凭证，记录客户端密码，后续会用到
![](/media/202503/2025-03-12_200227_519312.png)
**修改后端配置文件：application.yml**
**client-id：**客户端id，在第（3）步创建客户端时填写的 客户端ID
**client-secret：**客户端凭证，在第（6）步记录的客户端密码
**redirect-uri：**单点登录认证成功后跳转地址，请配置 /login 页面为登录成功的回调页面
**domain-prefix：**统一身份认证系统的主域地址
**pack-id：**统一身份认证系统中，平台所属的领域名称，可以在第（2）步创建客户端是看到注册时的领域
![](/media/202503/2025-03-13_093810_689571.png)
**修改前端配置文件位置：dist/config.js**

**注意：VITE_SSO_URL 的配置**
```javascript
'https://maxid.demo2.jzkg.cn/realms/master/protocol/openid-connect/auth?response_type=code&scope=openid&client_id=xxx&redirect_uri='
```
**VITE_SSO_URL：**需要根据实际情况配置相关信息，对此配置做出解释，主要修改的配置项就是client_id=xxx ，要与自己注册的客户端id相对应。
**https:maxid.demo2.jzkg.cn：** 统一身份认证系统的主域地址
**realms/master：**指定领域（realm），可以在第（2）步创建客户端时看到注册时的领域，一般默认是 master 领域
**protocol/openid-connect/auth：**使用OpenID Connect协议进行认证
**response_type=code：**请求是为获取授权码而发起的
**scope=openid：**定义了客户端请求的权限范围
**client_id=xxx：**xxx为统一身份认证平台配置的客户端id，在第（3）步创建客户端时填写的 客户端ID

**VITE_REDIRECT_URI、VITE_SSO_LOGOUT_REDIRECT_URI、VITE_SSO_CLIENTID** 可根据注释与自己部署的系统相对应
**VITE_REDIRECT_URI：**单点登录认证成功后跳转地址， 请配置 /login 页面为登录成功的回调页面
**VITE_LOGOUT_REDIRECT_URI：**单点登录退出成功后的跳转地址
**VITE_SSO_CLIENTID：**统一身份认证平台配置的客户端id，在第（3）步创建客户端时填写的 客户端ID
![](/media/202503/2025-03-12_181913_851767.png)
## 不接入统一身份认证系统
**修改前端配置文件位置：dist/config.js**将登录模式VITE_LOGIN_MODE改为 PWD：账号密码登录
![](/media/202503/2025-03-17_180744_264777.png)
**修改后端配置文件：application.yml**将融合门户配置oauth.KEYCLOAK以及oauth.KEYCLOAK所管理的配置进行注释
![](/media/202503/2025-03-17_180954_625524.png)