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

JumpCloud (SAML)

最后更新 查看 MarkdownAgent 设置

JumpCloud ↗ 提供 SSO 身份管理。Cloudflare Access 与 JumpCloud 集成作为 SAML 身份提供程序。

以下步骤专门用于使用 Cloudflare Access 设置 JumpCloud。有关配置 JumpCloud SSO 应用程序的更多信息,请参阅 JumpCloud 文档 ↗。

将 Jumpcloud 设置为 SAML 提供程序

1. 在 JumpCloud 中创建 SSO 应用程序

  1. 在 JumpCloud 管理门户 ↗中,转到 SSO Applications(SSO 应用程序)。

  2. 选择 Add New Application(添加新应用程序)。

  3. 在搜索栏中输入 Cloudflare,然后选择 Cloudflare Access 应用。

  4. 选择 Next(下一步)。

  5. 在 显示标签 中,输入应用名称。

  6. 选择 Save Application(保存应用程序)。

  7. 审查应用程序摘要并选择 Configure Application(配置应用程序)。

  8. 在 SSO 选项卡中,配置以下设置:

    1. 在 IdP 实体 ID 中,输入你的 Cloudflare 团队域名:

      https://<your-team-name>.cloudflareaccess.com/

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

    2. 将 SP 实体 ID 和 ACS URL 均设为以下回调 URL:

      https://<your-team-name>.cloudflareaccess.com/cdn-cgi/access/callback
    3. (可选) 配置您希望发送到 Cloudflare Access 的 SAML 属性。

    4. 向上滚动到 JumpCloud 元数据,然后选择 导出元数据。保存此 XML 文件,以便在后续步骤中使用。

  9. 在 用户组 选项卡中,为此应用分配用户组 ↗。

  10. 选择 Save(保存)。

2. 将 JumpCloud 添加到 Cloudflare One

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

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

  3. 选择 SAML(SAML)。

  4. 上传您的 JumpCloud XML 元数据文件。

  5. (可选) 要启用 SCIM,请参阅同步用户和组。

  6. (可选)在 Optional configurations(可选配置) 下,配置其他 SAML 选项。

  7. 选择 Save(保存)。

您现在可以基于配置的登录方法和 SAML 属性测试您的连接并创建 Access 策略。

同步用户和组

JumpCloud 集成允许您使用 SCIM 同步用户组并自动停用用户。

SCIM 对 Access 和 Gateway 策略评估的影响不同。

Access 根据身份提供商在身份验证期间返回的 SAML 断言或 OIDC token 评估用户身份和组成员关系。SCIM 在 Access 策略构建器中提供可读的组名称,但 Access 不会使用 SCIM 组成员关系评估登录。如果启用 Enable user deprovisioning(启用用户取消预配),从 SCIM 应用中移除用户会撤销其活跃的 Access 会话。你还可以配置 SCIM,在组成员关系变更后撤销会话。当用户再次进行身份验证时,Access 会评估更新后的身份提供商数据。

Gateway 根据用户注册表身份评估基于身份的策略。当用户或组成员关系发生变更时,SCIM 会更新此身份,无需等待用户再次进行身份验证。Cloudflare One Client 设备配置文件使用相同的同步身份。

1. 在 Cloudflare One 中启用 SCIM

  1. 在 Cloudflare 仪表板 ↗中,前往 Zero Trust > Integrations(集成) > Identity providers。

  2. 找到 JumpCloud 集成,然后选择 Edit(编辑)。

  3. 启用 Enable SCIM(启用 SCIM)。

  4. (可选)配置以下设置:

  • Enable user deprovisioning(启用用户取消预配):当用户从 JumpCloud 中的 SCIM 应用程序中移除时,撤销用户的活动会话。这将使所有活动 Access 会话失效,并提示对任何 Cloudflare One Client 会话策略重新进行身份验证。
  • Remove user seat on deprovision(取消预配时移除用户席位):当用户从 JumpCloud 中的 SCIM 应用程序中移除时,从您的 Cloudflare One 账户中移除用户席位。
  • SCIM identity update behavior(SCIM 身份更新行为):选择当用户身份在 JumpCloud 中更新时,Cloudflare One 中发生的情况。
    • Automatic identity updates:当 JumpCloud 通过 SCIM 发送更新的身份或组成员资格时,自动更新用户注册表身份。此身份用于 Gateway 策略和 Cloudflare One Client 设备配置文件;Access 将在用户重新进行身份验证时读取其更新的身份。
    • Group membership change reauthentication:当用户的组成员资格在 JumpCloud 中更改时,撤销用户的活动会话。这将使所有活动 Access 会话失效,并提示对任何 Cloudflare One Client 会话策略重新进行身份验证。Access 将在用户重新进行身份验证时读取其更新的组成员资格。
    • No action:在用户下次对 Access 或 Cloudflare One Client 重新进行身份验证时更新用户身份。
  1. 选择 Regenerate Secret(重新生成密钥)。复制 SCIM Endpoint(SCIM 终结点) 和 SCIM Secret(SCIM 密钥)。您需要将这些值输入到 JumpCloud 中。

  2. 选择 Save(保存)。

SCIM 密钥永不过期,但您可以随时手动重新生成密钥。

2. 在 JumpCloud 中配置 SCIM

  1. 在 JumpCloud 管理门户 ↗中,转到 SSO Applications(SSO 应用程序)。
  2. 选择在您将 JumpCloud 设置为 SAML 提供程序时创建的 Cloudflare 应用程序。
  3. 选择 SSO 选项卡。
  4. 要预配用户组,请选择 包含组属性 并输入 groups。组属性名称必须与 groups 完全一致,否则它将作为 SAML 属性发送。
  5. 选择 身份管理 选项卡。
  6. 确保开启了 Enable management of User Groups and Group Membership in this application(启用此应用程序中的用户组和组成员资格管理)。
  7. 选择 Configure(配置)。
  8. 在 基础 URL 字段中,输入从 Cloudflare One 获取的 SCIM 端点。
  9. 在 令牌密钥 字段中,输入从 Cloudflare One 获取的 SCIM 密钥。
  10. 选择 Activate(激活)。您将收到身份管理集成已成功验证的确认。
  11. 选择 Save(保存)。

要检查用户身份是否已在 Cloudflare One 中更新,请查看您的 SCIM 配置日志。

配置属性

配置属性定义了 JumpCloud 将与 Cloudflare Access 同步的用户和组属性。默认情况下,JumpCloud 将在 SCIM 更新事件期间发送以下属性:

JumpCloud 用户属性 Cloudflare Access 属性
email email
firstname givenName
lastname surname
JumpCloud 组属性 Cloudflare Access 属性
name groups

示例 API 配置

{
	"config": {
		"issuer_url": "jumpcloud",
		"sso_target_url": "https://sso.myexample.jumpcloud.com/saml2/cloudflareaccess",
		"attributes": ["email", "name", "username"],
		"email_attribute_name": "",
		"sign_request": false,
		"idp_public_cert": "MIIDpDCCAoygAwIBAgIGAV2ka+55MA0GCSqGSIb3DQEBCwUAMIGSMQswCQYDVQQGEwJVUzETMBEG\nA1UEC.....GF/Q2/MHadws97cZg\nuTnQyuOqPuHbnN83d/2l1NSYKCbHt24o"
	},
	"type": "saml",
	"name": "jumpcloud saml example"
}

这篇文档对您有帮助吗?