跳转到主要内容
通过 Keycloak 的 SAML2.0 或 OIDC 协议登录 Flashduty。
本篇文章不涉及部署和讲解 Keycloak 相关内容,如需了解更多信息,请参考 官方文档。

协议配置

1. 获取 ACS 地址

登录 Flashduty 控制台,获取 ACS 地址(后续步骤会用到)。路径:平台管理 → 组织 → 单点登录 → Flashcat 服务提供商信息 → Assertion Consumer Service URL(在 协议与连接 中选择 SAML 2.0)获取 ACS 地址

2. 创建 Client

登录 Keycloak 控制台,路径:Clients → Create client
  • Client Type:选择 SAML 协议
  • Client ID:填写 flashcat.cloud(固定值,不可更改)
创建 ClientValid redirect URIs:填写从 Flashduty 获取的 ACS 地址配置 redirect

3. 配置 Client 相关信息

Name ID format 更改为 email 类型:Name ID formatClient signature required 设置为关闭状态:关闭签名
Keycloak 默认自带 OpenID Connect 协议的 email、phone scope,与下面要创建的 SAML scope 同名。请先在 Client scopes 中删除它们,再创建。
创建 Client scope:在 Client scopes → Create client scope 中依次创建 email、phone、username 三个 scope,每个的 Protocol 选择 SAML,Name 填 scope 名称,其余保持默认后保存。创建 scope创建完成的效果:scope 效果将三个 scope 添加到 Client:进入 Clients → 该 Client → Client scopes → Add client scope,勾选 email、phone、username,点击 Add → Default。添加 scope 1添加 scope 2为每个 scope 配置映射器:进入 scope → Mappers → Configure a new mapper,Mapper type 选择 User Attribute,按下表填写。以 email 为例,phone、username 同样配置:映射器 1映射器 2映射器 3

4. 下载 XML 文件

下载的文件是一个压缩包,在本地解压后会有两个 xml 文件,只需要 idp-metadata.xml 文件即可。
在 Client → Action 中下载到本地:下载 XML上传 XML 文件到 Flashduty 的单点登录配置中:

5. 创建用户并测试登录

创建用户(一定要绑定一个邮箱地址):创建用户登录测试:访问 console.flashcat.cloud,选择 SSO 登录。SSO 登录页默认使用 企业邮箱 方式,填写您的企业邮箱即可定位到所属组织并进入该组织的认证流程;如果只知道企业域名,点击 使用企业域名登录 切换到域名输入方式,再填写组织的登录域名(在 平台管理 → 组织 → 组织信息 → 组织资料 页面配置)。也可以直接访问 {域名}.sso.flashcat.cloud 发起单点登录。测试登录