基于平台开发的应用接入统一认证中心

## 基于平台开发的应用接入统一认证中心

接入方式和统一门户一致

### 后端配置
后端配置统一认证地址、拉取待办信息的地址、跳转待办信息的地址、租户、clientid

```
# 设置门户的统一认证地址
fusion.auth.cas-server-url: http://172.16.5.191:9090/auth/cas # 不能以斜杠/结尾

# 设置h10后端地址，用于拉取待办信息(也可设置前端地址，前端有nginx转发到后端)
app.url.h10.backend: http://172.16.5.191:7001/

# 设置h10前端端地址，用于待办信息跳转
app.url.h10.frontend: http://172.16.5.191:7000/

# 租户ID（用于拉取待办信息）
app.url.h10.tenantid=621100

# client认证所需id和密钥，一般在h10的接口授权页面中配置
app.client-id: house
app.client-secret: house
如下图client配置
```

- client-id配置
![](/media/202507/2025-07-25_134004_1345520.9786635005952944.png)

### 前端配置

- 前端接入时，代码需稍做改造，可联系创新中心-技术研发部
- 前端.env文件中，需配置单点登录信息

>- VUE_APP_CAS_BASE_URL：统一认证中心地址
>- VUE_APP_CAS_SERVICEID：本应用接入统一认证中心后的ID
>- VUE_APP_LOGIN_BY_CAS：true为打开CAS单点登录功能,false为关闭

> **注意**，VUE_APP_LOGIN_BY_CAS设置为false，则不会再取系统参数中的`sys.login.sso`值。如果是注释掉，那么会去sys.login.sso的值，如果该值为cas，则会走单点登录。
.env配置参数优先级 高于 数据库系统参数配置

```
#统一认证前端.env配置文件
VUE_APP_LOGIN_BY_CAS=true
VUE_APP_CAS_BASE_URL=http://172.16.5.191:9090/auth/cas/
VUE_APP_CAS_SERVICEID=1745743151043
```

```
# 数据库系统参数配置
sys.login.sso（none,cas）
sys.login.sso.cas.serviceid（本应用接入统一认证中心后的ID）
sys.login.sso.cas.url（统一认证中心地址，http://172.16.5.191:9090/auth/cas/）
```

### 用户同步设置
- 如果应用开启租户，则服务地址需带租户，如`https://dingxi.xtzlonline.com/?x-tenant-id=621100`
- 如果接入的应用有子应用，如H10有子应用“综合业务”、“综合服务”等子应用，而用户希望在门户上直接跳转到子应用，可在服务地址上带上子应用编码appcode，
	- 带appcode地址示例：`https://dingxi.xtzlonline.com/?x-tenant-id=621100&appcode=IntegratedManagement`
	![](/media/202507/2025-07-29_141450_7162890.6943308092029552.png)
	
	- 主应用按需，可设置为不显示在门户/显示在门户
	![](/media/202507/2025-07-29_141931_7900290.007797440651169829.png)