CAS协议

# CAS协议

流程图：

![](/media/202507//1753063488.3490875.png)

## 1\. 平台配置

### 1\.1\. CAS协议配置并启用

右上角点击“进入后台”，进入后台配置页面。在后台配置左侧导航栏中，点击“单点登录”，进入单点登录配置页面。

![](/media/202507//1753063488.354226.png)

点击“新增单点登录”按钮，进入CAS2\.0认证配置页面，如下图：

![](/media/202507//1753063488.3575616.png)

配置完成后，点击下方保存按钮，保存配置信息。

### 1\.2 使用CAS2\.0认证

配置CAS单点登录后，平台首页单点登录组件中，可查到到上一步所配置单点登录。

点击对应单点登录中的logo,系统自动生成ticket令牌，回调到应用服务地址。

![](/media/202507//1753063488.361182.png)

## 2\. 应用方

### 2\.1\. 提供回调地址（支持页面或接口）。平台生成ticket后，会携带ticket跳转到应用回调地址。

![](/media/202507//1753063488.3646095.png)

### 2\.2\. 第三方应用获取到ticket，通过ticket请求平台接口返回用户信息

支持版本：Java\-2\.0；Java\-3\.0;接口 Request(GET/POST)：http://{ip:port}/api/serviceValidate请求实体

| 参数名 | 参数位置 | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- | --- |
| ticket | RequestParam | string | 是 | 令牌，平台生成 |

**返回结果（XML结构）：**

示例：

```
<cas:serviceResponse
  xmlns:cas="http://www.yale.edu/tp/cas">
  <cas:authenticationSuccess>
    <cas:user>administrator</cas:user>
    <cas:attributes>
      <cas:birthday>1990-01-01 00:00:00</cas:birthday>
      <cas:uid>18f923a7-5a5e-426d-94ae-a55ad1a4b239</cas:uid>
      <cas:firstName>base64:57O757uf566h55CG5ZGY</cas:firstName>
      <cas:gender>0</cas:gender>
      <cas:displayName>base64:57O757uf566h55CG5ZGY</cas:displayName>
      <cas:mobile>18702742229</cas:mobile>
      <cas:username>administrator</cas:username>
      <cas:lastname>base64:57O757uf566h55CG5ZGY</cas:lastname>
    </cas:attributes>
  </cas:authenticationSuccess>
</cas:serviceResponse>
```