Skip to content

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

クライアントバージョンの割り当て

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

クライアントバージョンの割り当てを使うと、MDM ファイル を変更したり、ユーザーにクライアント更新を依頼したりせずに、Cloudflare ダッシュボードからデバイス群へ特定の Cloudflare One Client（旧 WARP）バージョンを指定できます。

割り当てが有効になると、一致するデバイスは目標バージョンへ静かにアップグレードまたはダウングレードします。インストール中、エンドユーザーにはクライアント GUI に Update in progress バナーが表示されます。更新が完了すると、クライアントは通常動作に戻ります。

機能の可用性

クライアントモード Zero Trust プラン ↗
すべてのモード すべてのプラン
システム 可用性 最小クライアントバージョン
Windows ✅ 2026.6.0
macOS ✅ 2026.6.0
Linux ❌ —
iOS ❌ —
Android ❌ —
ChromeOS ❌ —

仕組み

デプロイメントグループ は、1 つ以上の目標クライアントバージョンを、デバイスプロファイル の 1 つ以上のポリシー ID に結び付けます。グループ内の各エントリは、target_environment（windows または macos）とそのプラットフォームへデプロイする version を指定します。1 つのデプロイメントグループで、両方のプラットフォームを同時に対象にできます。

デプロイメントグループを保存すると、Cloudflare API は、デバイスプロファイルのポリシー ID がグループに含まれるすべてのデバイスへ割り当てを配信します。各デバイスは次の処理を行います。

  1. 次回の登録更新時に、実行中のバージョンと割り当てられたバージョンを比較します。
  2. バージョンが異なる場合、目標インストーラーをダウンロードし、暗号署名を検証します。
  3. インストーラーをサイレント実行し、新しいバージョンが有効になると通常動作を再開します。

クライアントは、クライアントバージョン 2026.6.0 以降に既存サービスと一緒に同梱される、別の常駐 OS サービスを通じてインストールを調整します。ダウンロード、署名検証、インストールのいずれかが失敗した場合、デバイスは以前のバージョンのまま稼働し続けます。

デプロイメントグループを設定する

  1. Cloudflare ダッシュボード ↗ で Zero Trust > Team & Resources > Devices を開きます。
  2. Management タブを選びます。
  3. Client version assignments で Manage を選びます。
  4. Create new deployment group を選びます。
  5. Name your deployment group で名前を入力します。
  6. Select device profiles で、この割り当てを受け取るデバイスプロファイルを 1 つ以上選びます。
  7. Assign client version で、オペレーティングシステム、リリーストラック、クライアントバージョンを選びます。同じグループで追加のプラットフォームを対象にする場合は、Add OS を選んで繰り返します。
  8. Save を選びます。

Deployment Groups API へ POST リクエストを送ります。

Create deployment groupbash
curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/devices/deployment-groups" \
	--request POST \
	--header "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
	--json '{
		"name": "Engineering Ring 0",
		"version_config": [
				{
						"target_environment": "windows",
						"version": "2026.6.0"
				},
				{
						"target_environment": "macos",
						"version": "2026.6.0"
				}
		],
		"policy_ids": [
				"<POLICY_UUID_1>",
				"<POLICY_UUID_2>"
		]
	}'

  1. cloudflare_api_token ↗ に次の権限を追加します。

    • Zero Trust Write

  2. cloudflare_zero_trust_device_deployment_groups ↗ リソースでデプロイメントグループを作成します。

    resource "cloudflare_zero_trust_device_deployment_groups" "example" {
	account_id = var.cloudflare_account_id
	name       = "Engineering Ring 0"
	version_config = [
		{
			target_environment = "windows"
			version            = "2026.6.0"
		},
		{
			target_environment = "macos"
			version            = "2026.6.0"
		},
	]
	policy_ids = [
		"<POLICY_UUID_1>",
		"<POLICY_UUID_2>",
	]
}

デバイスが割り当てを評価するタイミング

デプロイメントグループを作成、更新、または削除すると、API は影響を受けるデバイスへ変更を通知します。配信には最大 15 分かかることがあります。デバイスが通知を受け取ると、まもなく割り当てを評価し、実行中のバージョンと異なる場合は目標バージョンをインストールします。

デバイスは、次の場合にも、受け取った最新の割り当てを再評価します。

  • クライアントサービスが開始または再起動したとき。
  • デバイスがスリープから復帰したとき。

デバイスが割り当てを受け取ったことを確認する

デバイスが割り当てられたバージョンを受け取ったことを確認するには、デバイス上でターミナルを開き、次を実行します。

warp-cli settings

出力の version_config に、解決済みの目標バージョンが含まれます。デバイスがそのバージョンをまだ実行していない場合、次回の評価でインストールが始まります。

MDM で割り当てを上書きする

MDM ファイルで allow_managed_deployments を false にすると、個別デバイスでクライアントバージョンの割り当てを無効にできます。このパラメーターが false のとき、デバイスはダッシュボードからの割り当てを無視し、現在のバージョンのままです。ダッシュボードではなく MDM でバージョンを固定する必要があるデバイスに使います。

制限事項

  • 割り当てを適用するには、デバイスがクライアントバージョン 2026.6.0 以降を実行している必要があります。古いバージョンは割り当てを完全に無視します。
  • デバイスでインストールが始まると、キャンセルできません。デバイスが以前の目標バージョンをダウンロード中に目標バージョンを変更すると、ダウンロードはきれいにキャンセルされます。
  • 各デバイスプロファイルのポリシー ID は、同時に 1 つのデプロイメントグループにしか所属できません。

ウイルス対策とエンドポイントセキュリティの設定

バージョン 2026.6.0 以降、クライアントのインストールは、クライアントバージョンの割り当てで起動する更新を扱う 2 つ目の常駐 OS サービスを追加します。エンドポイント保護またはウイルス対策ツールがプロセスまたはサービスの許可リストを管理している場合は、Cloudflare One Client 向けの既存エントリに加えて、次を追加してください。

プラットフォーム サービス識別子 プロセス名
macOS com.cloudflare.warp.updater warp-updater
Windows CloudflareWARPUpdater warp-updater-armed.exe

失敗した更新のトラブルシュート

デバイスが割り当てられたバージョンを受け取らない場合は、warp-diag で診断ログを収集します。診断アーカイブには、試行ごとのインストーラーログが入った updater/ ディレクトリと、人が読める更新履歴の要約が含まれます。Cloudflare Support と共有できます。

役に立ちましたか？