# E10系统通过OAuth2集成接入 keyclock系统

来源快照：`result_data_new_260518.json`

- 来源 ID：`1176199063423189027`
- 模块：集成中心
- 目录：统一认证接入管理 - 配置示例 - 认证集成 keycloak系统
- space ID：`1158011075224911873`
- 原文链接：未提供
- 产品基线：未提供

## 正文

# 一、功能介绍

本文档旨在介绍如何通过CAS协议实现E10系统与keyclock的集成接入。完成集成后，用户访问E10系统时将直接跳转至keyclock的登录页面。一旦keyclock授权成功，系统将能够回调并登录到E10。

# 二、功能概述以及使用说明

## 1、考虑E10系统与keyclock系统人员对应关系

需要考虑与E10系统与keyclock系统人员对应关系。

目前的文档是基于E10系统人员的账号 与 keyclock系统人员的邮箱保持一致。

 

## 2、E10系统提供回调地址给到keyclock系统

登录E10系统，在认证接入管理页面中查看回调地址，将回调地址提供给keyclock。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1176199347140386822&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

 

## 3、keyclock系统注册E10系统Client

登录keyclock系统，进入对应Realm，在Clients中创建Client

![](https://weapp.eteams.cn/papi/file/preview?fileId=1176199338450288643&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

选择OpenID Connect， 设置Client ID，唯一标识，需要提供给E10系统。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1176199334219104277&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

启用Client authentication、Authorization，勾选Standard flow

![](https://weapp.eteams.cn/papi/file/preview?fileId=1176199338321133584&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

配置E10系统回调地址

![](https://weapp.eteams.cn/papi/file/preview?fileId=1176199334219104262&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

保存后，到Credentials中复制Client secret 与前面的Client ID 提供给E10系统。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1176199334204620804&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

在Realm settings 中点击OpenID Endpoint Configuration

![](https://weapp.eteams.cn/papi/file/preview?fileId=1176199342666432515&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

将打开的内容复制到（https://www.json.cn/）进行格式化，将里面的authorization_endpoint、token_endpoint、userinfo_endpoint、end_session_endpoint 的参数值 给到E10系统。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1176199342837030924&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

在Users 中添加人员。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1176199334037381123&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

## 4、E10系统OAuth2集成配置

E10系统，统一认证接入管理中选择OAuth2.0集成-keycloak集成进行配置，**只需要调整基本信息以及几个接口的接口地址，其他无需改动** 。

基本信息：配置keyclock提供的Client ID以及Client secret。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1176199342735835145&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

请求用户授权接口：

接口地址配置keyclock提供的authorization_endpoint

![](https://weapp.eteams.cn/papi/file/preview?fileId=1176199338450288649&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

获取授权Token接口：

接口地址配置keyclock提供的token_endpoint

 

![](https://weapp.eteams.cn/papi/file/preview?fileId=1176199338307182597&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

刷新Token接口：

接口地址配置keyclock提供的token_endpoint

![](https://weapp.eteams.cn/papi/file/preview?fileId=1176199342735835143&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

获取用户信息接口：

接口地址配置keyclock提供的userinfo_endpoint

![](https://weapp.eteams.cn/papi/file/preview?fileId=1176199346969788416&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

统一退出接口：

接口地址配置keyclock提供的end_session_endpoint

![](https://weapp.eteams.cn/papi/file/preview?fileId=1176199334214041604&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

## 5、E10系统维护人员

目前的文档是基于E10系统人员的账号 与 keyclock系统人员的邮箱保持一致。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1176199338321133592&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

## 6、E10系统自定义登录地址验证效果

可在登录页设置中设置 自定义登录地址 验证效果。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1176199342845919234&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

直接访问自定义登录地址，可跳转到keyclock系统认证登录页，keyclock系统登录后，可回调登录E10系统。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1176199338321133569&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

# 三、更多场景示例

 暂无。

# 四、常见问题

 待补充。
