跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

Keycloak (SAML)

最后更新 查看 MarkdownAgent 设置

Keycloak 是由 JBoss 构建的开源身份和访问管理解决方案。

设置 Keycloak (SAML)

将 Keycloak (SAML) 设置为身份提供商:

  1. 在 Keycloak 中,选择希望 Cloudflare Access 使用的 Realm。

  2. 前往 客户端 > 创建客户端。

  3. 在 客户端类型 中,选择 SAML。

  4. 在 客户端 ID 下,输入 Cloudflare Access 回调 URL:

    https://<your-team-name>.cloudflareaccess.com/cdn-cgi/access/callback

    您可以在 Cloudflare 仪表板 ↗ 的 Settings(设置)> Team name and domain(团队名称和域名)> Team name(团队名称) 下找到您的团队名称。

  5. 选择 Next(下一步)。

  6. 将 名称 ID 格式 更改为 email。

  7. 在 有效重定向 URI 中,输入 Cloudflare Access 回调 URL:

    https://<your-team-name>.cloudflareaccess.com/cdn-cgi/access/callback
  8. 在 主 SAML 处理 URL 中,输入 Keycloak Realm 的 SAML 端点:

    https://<keycloak_domain>/realms/<realm_name>/protocol/saml

    Keycloak v17 及更高版本默认使用 /realms/<realm_name>/protocol/saml。Keycloak v16 及更低版本可能改用 /auth/realms/<realm_name>/protocol/saml。

  9. 如果要启用客户端签名,请启用 要求客户端签名,然后选择 保存。

    1. 您需要按照此处的步骤获取证书并在 Cloudflare 仪表板中启用它。

    2. 将下载的 Access 证书导入 密钥 选项卡。格式选择 Certificate PEM。

  10. 为用户的电子邮件地址配置协议映射器。

    1. 前往 客户端 > 你的 Cloudflare Access SAML 客户端 > 客户端范围。
    2. 选择该客户端的专用客户端范围。
    3. 前往 映射器 > 添加映射器 > 按配置。
    4. 选择 用户属性。
    5. 将 属性 设为 email,将 SAML 属性名称 设为 email。

    接下来,您需要与 Cloudflare Access 集成。

  11. 在 Cloudflare 仪表板 ↗中,前往 Zero Trust > Integrations(集成) > Identity providers(身份提供商)。

  12. 在 Your identity providers(您的身份提供商) 下,选择 Add new identity provider(添加新的身份提供商)。

  13. 在下一页选择 SAML(SAML)。

    您需要手动输入 Keycloak 详细信息。以下示例应替换为 Keycloak 和 Cloudflare Access 使用的具体域。

    字段 示例
    单点登录 URL https://<keycloak_domain>/realms/<realm_name>/protocol/saml
    IdP 实体 ID 或颁发者 URL https://<unique_id>.cloudflareaccess.com/cdn-cgi/access/callback
    签名证书 使用 Keycloak Realm 密钥中的 X509 证书
  14. 选择 Save(保存)。

要测试连接是否正常,请前往 Integrations(集成)> Identity providers(身份提供商),然后选择要测试的登录方法旁的 Test(测试)。

这篇文档对您有帮助吗?