Keycloak 是由 JBoss 构建的开源身份和访问管理解决方案。
将 Keycloak (SAML) 设置为身份提供商:
-
在 Keycloak 中,选择希望 Cloudflare Access 使用的 Realm。
-
前往 客户端 > 创建客户端。
-
在 客户端类型 中,选择 SAML。
-
在 客户端 ID 下,输入 Cloudflare Access 回调 URL:
https://<your-team-name>.cloudflareaccess.com/cdn-cgi/access/callback您可以在 Cloudflare 仪表板 ↗ 的 Settings(设置)> Team name and domain(团队名称和域名)> Team name(团队名称) 下找到您的团队名称。
-
选择 Next(下一步)。
-
将 名称 ID 格式 更改为 email。
-
在 有效重定向 URI 中,输入 Cloudflare Access 回调 URL:
https://<your-team-name>.cloudflareaccess.com/cdn-cgi/access/callback -
在 主 SAML 处理 URL 中,输入 Keycloak Realm 的 SAML 端点:
https://<keycloak_domain>/realms/<realm_name>/protocol/samlKeycloak v17 及更高版本默认使用
/realms/<realm_name>/protocol/saml。Keycloak v16 及更低版本可能改用/auth/realms/<realm_name>/protocol/saml。 -
如果要启用客户端签名,请启用 要求客户端签名,然后选择 保存。
-
将下载的 Access 证书导入 密钥 选项卡。格式选择 Certificate PEM。
-
为用户的电子邮件地址配置协议映射器。
- 前往 客户端 > 你的 Cloudflare Access SAML 客户端 > 客户端范围。
- 选择该客户端的专用客户端范围。
- 前往 映射器 > 添加映射器 > 按配置。
- 选择 用户属性。
- 将 属性 设为
email,将 SAML 属性名称 设为email。
接下来,您需要与 Cloudflare Access 集成。
-
在 Cloudflare 仪表板 ↗中,前往 Zero Trust > Integrations(集成) > Identity providers(身份提供商)。
-
在 Your identity providers(您的身份提供商) 下,选择 Add new identity provider(添加新的身份提供商)。
-
在下一页选择 SAML(SAML)。
您需要手动输入 Keycloak 详细信息。以下示例应替换为 Keycloak 和 Cloudflare Access 使用的具体域。
字段 示例 单点登录 URL https://<keycloak_domain>/realms/<realm_name>/protocol/samlIdP 实体 ID 或颁发者 URL https://<unique_id>.cloudflareaccess.com/cdn-cgi/access/callback签名证书 使用 Keycloak Realm 密钥中的 X509 证书 -
选择 Save(保存)。
要测试连接是否正常,请前往 Integrations(集成)> Identity providers(身份提供商),然后选择要测试的登录方法旁的 Test(测试)。