Skip to content

非公式本サイトは非公式の日本語ドキュメントであり、Cloudflare 公式サイトではありません。最新情報はdevelopers.cloudflare.comをご確認ください。

JumpCloud (SAML)

最終更新 Markdown で表示Agent セットアップ

JumpCloud ↗ は SSO のアイデンティティ管理を提供します。Cloudflare Access は、JumpCloud を SAML アイデンティティプロバイダーとして連携できます。

次の手順は、JumpCloud を Cloudflare Access とセットアップする場合に特化した内容です。JumpCloud の SSO アプリケーション設定の詳細は、JumpCloud のドキュメント ↗ を参照してください。

JumpCloud を SAML プロバイダーとしてセットアップする

1. JumpCloud で SSO アプリケーションを作成する

  1. JumpCloud Admin Portal ↗ で SSO Applications を開きます。

  2. Add New Application を選びます。

  3. 検索バーに Cloudflare と入力し、Cloudflare Access アプリケーションを選びます。

  4. Next を選びます。

  5. Display Label にアプリケーション名を入力します。

  6. Save Application を選びます。

  7. アプリケーションの概要を確認し、Configure Application を選びます。

  8. SSO タブで、次の設定を行います。

    1. IdP Entity ID に、Cloudflare のチームドメインを入力します。

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

      チーム名は、Cloudflare ダッシュボード ↗ の Settings > Team name and domain > Team name で確認できます。

    2. SP Entity ID と ACS URL の両方に、次のコールバック URL を設定します。

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

    3. （任意）Cloudflare Access に送信する SAML 属性を設定します。

    4. JumpCloud Metadata までスクロールし、Export Metadata を選びます。この XML ファイルは、後の手順 で使います。

  9. User Groups タブで、このアプリケーションに ユーザーグループを割り当てます ↗。

  10. Save を選びます。

2. Cloudflare One に JumpCloud を追加する

  1. Cloudflare ダッシュボード ↗ で Zero Trust > Integrations > Identity providers を開きます。

  2. Your identity providers で Add new identity provider を選びます。

  3. SAML を選びます。

  4. JumpCloud の XML メタデータファイルをアップロードします。

  5. （任意）SCIM を有効にする場合は、ユーザーとグループを同期する を参照してください。

  6. （任意）Optional configurations で、追加の SAML オプション を設定します。

  7. Save を選びます。

これで 接続をテスト し、設定したログイン方法と SAML 属性をもとに Access ポリシー を作成できます。

ユーザーとグループを同期する

JumpCloud 連携では、SCIM を使ってユーザーグループを同期し、ユーザーを自動でプロビジョニング解除できます。

SCIM が Access と Gateway のポリシー評価に与える影響は異なります。

Access は、認証時にアイデンティティプロバイダーが返す SAML アサーションまたは OIDC トークンから、ユーザーの ID とグループ所属を評価します。SCIM は Access のポリシービルダーに読みやすいグループ名を提供しますが、Access はログイン評価に SCIM のグループ所属を使いません。Enable user deprovisioning をオンにすると、SCIM アプリケーションからユーザーを削除した時点で、そのユーザーのアクティブな Access セッションが取り消されます。グループ所属の変更後にセッションを取り消すよう、SCIM を設定することもできます。Access は、ユーザーが再度認証したときに、更新後のアイデンティティプロバイダーデータを評価します。

Gateway は、User Registry の ID に対してアイデンティティベースのポリシーを評価します。ユーザーまたはグループ所属が変わると、SCIM はこの ID を更新します。ユーザーの再認証を待つ必要はありません。Cloudflare One Client のデバイスプロファイルも、同じ同期済み ID を使います。

1. Cloudflare One で SCIM を有効にする

  1. Cloudflare ダッシュボード ↗ で Zero Trust > Integrations > Identity providers を開きます。

  2. JumpCloud 連携を探し、Edit を選択します。

  3. Enable SCIM をオンにします。

  4. （任意）次の設定を行います。

  1. Regenerate Secret を選択します。SCIM Endpoint と SCIM Secret をコピーします。これらの値を JumpCloud に入力します。

  2. Save を選択します。

SCIM シークレットに有効期限はありません。ただし、いつでも手動で再生成できます。

2. JumpCloud で SCIM を設定する

  1. JumpCloud Admin Portal ↗ で SSO Applications を開きます。
  2. JumpCloud を SAML プロバイダーとしてセットアップする ときに作成した Cloudflare アプリケーションを選びます。
  3. SSO タブを選びます。
  4. ユーザーグループをプロビジョニングするには、Include group attribute を選び、groups と入力します。グループ属性名は groups と完全一致している必要があります。一致しない場合、SAML 属性として送信されます。
  5. Identity Management タブを選びます。
  6. Enable management of User Groups and Group Membership in this application がオンになっていることを確認します。
  7. Configure を選びます。
  8. Base URL に、Cloudflare One で取得した SCIM Endpoint を入力します。
  9. Token Key に、Cloudflare One で取得した SCIM Secret を入力します。
  10. Activate を選びます。Identity Management 連携が正常に検証されたことを示す確認が表示されます。
  11. Save を選びます。

Cloudflare One でユーザー ID が更新されたかを確認するには、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"
}

役に立ちましたか？