Keycloack集成指引

快速了解#

基于SAML2.0协议#

1.登录OncallBox控制台#

1.1 从OncallBox获取Redirect URL地址（第2步会用到）#

1.2 路径：账号配置=>单点登录=>设置=>SAML协议=>OncallBox服务提供商信息=>Redirect URL#

2.登录Keycloak控制台新建一个Client#

2.1 路径：Clients => Create client#

2.2 Client Type：选择SAML协议#

2.3 Client ID填写：oncallbox.com（固定值，不可更改）#

2.4 Valid redirect URIs： 填写从OncallBox获取的Redirect URL地址#

3.配置Client相关信息#

3.1 Name ID format更改为email类型#

3.2 Client signature required设置为关闭状态#

3.3 创建Client scope#

3.3.1 参考下图依次创建email/phone/username三种类型#

3.3.2 创建完成的效果#

3.4 将添加的用户加入到Client中#

3.5 配置email/phone/username映射器 (以email为例，其他按照下面步骤配置即可)#

4.下载XML文件#

4.1 在Clients > Action中下载到本地#

4.2 上传XML文件到Oncallbox的单点登录配置中#

5. 在Keycloak创建用户并测试登录#

5.1 创建用户（一定要绑定一个邮箱地址）#

5.2 登录测试#

基于OIDC协议#

1. 登录OncallBox平台#

1.1 从OncallBox获取Redirect URL（第2步会用到）#

2.2 路径：账号配置=>单点登录=>设置=>OIDC协议=>OncallBox服务提供商信息==>Redirect URL#

2.登录Keycloak控制台新建一个Client#

2.1 Client Type：选择OpenID Connect协议#

2.2 Clinet ID：没有特殊要求#

2.3 Client authentication：保持开启状态#

2.4 Valid redirect URIs：填写第1步获取的Redirect URL地址#

3.获取Client的相关信息#

3.1 Client ID：创建Client时填写的ID#

3.2 Client Secret：Client 详情=>Credentials卡片中即可看到#

3.3 Issuer：Realm settings=>Endpoints=>OpenID Endpoint Configuration#

4. OncallBox单点登录配置样式#