Skip to content

非公式 / UnofficialCloudflare, Inc. 非提携。アカウント情報は入力しないでください。Not affiliated with Cloudflare, Inc. Do not enter Cloudflare credentials here.Official docsこのサイトについてプライバシー

パラメーター

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

各 Cloudflare One Client(旧 WARP)は、デプロイ方法に関係なく、次のパラメーターセットに対応しています。

フル機能の Cloudflare Zero Trust に必要な項目

ほとんどの Cloudflare Zero Trust 機能を使うには、チーム名を指定する必要があります。チーム名に依存する機能の例は、HTTP ポリシー、Browser Isolation、デバイスポスチャ です。

organization

クライアントに、組織へのデバイス登録を指示します。登録には IdP または Service Auth による認証が必要です。

値の型: string

値: チーム名。

DNS のみのポリシー適用に必要な項目

このフィールドは、クライアントを DoH 専用モードでデプロイするときに、DNS ポリシーを適用するために使います。

gateway_unique_id

クライアントに、すべての DNS クエリを特定の Gateway DNS ロケーション へ送るよう指示します。この値は、チーム名 なしでデプロイする場合、または複数の DNS ロケーションがある組織でのみ必要です。DoH サブドメインを指定しない場合は、組織のデフォルト Gateway DNS ロケーションが自動で使われます。

値の型: string

値: DoH サブドメイン。

組織パラメーター

次のパラメーターで、特定の Zero Trust 組織を設定できます。

allow_managed_deployments

機能の提供状況

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

Cloudflare ダッシュボードからプッシュされる クライアントバージョン割り当て のローカルキルスイッチです。ダッシュボードの設定に関係なく、デバイスをダッシュボード管理のバージョン変更から外すときに使います。

デフォルトでは、デバイスはダッシュボードが送る割り当てを適用します。デバイスを対象とする割り当てがなければ、このパラメーターは効果がありません。

値の型: boolean

値:

  • true — (デフォルト)デバイスは、Cloudflare ダッシュボードで設定されたクライアントバージョン割り当てを適用します。デバイスを対象とする割り当てがなければ、この設定は効果がありません。
  • false — デバイスはクライアントバージョン割り当てを無視し、ダッシュボードの設定に関係なく、現在インストールされているバージョンのままです。

auth_client_id

サービストークン を使って、デバイスを Zero Trust 組織へ登録します。 auth_client_secret パラメーターが必要です。

値の型: string

値: サービストークンの Client ID。

設定例:

<key>auth_client_id</key>
<string>88bf3b6d86161464f6509f7219099e57.access</string>
<key>auth_client_secret</key>
<string>bdd31cbc4dec990953e39163fbbb194c93313ca9f0a6e420346af9d326b1d2a5</string>

auth_client_secret

サービストークン を使って、デバイスを Zero Trust 組織へ登録します。 auth_client_id パラメーターが必要です。

値の型: string

値: サービストークンの Client Secret。

auto_connect

ユーザーがスイッチをオフにした場合、指定した分数のあとでクライアントが自動でオンに戻します。ホテルや空港の Wi-Fi へログインできる程度の、ごく短い値をおすすめします。auto_connect に値を指定すると、Cloudflare One Client のデフォルト状態は常に Connected になります(初回インストール後や再起動後など)。

値の型: integer

値:

  • 0 — ユーザーが再びオンにするまで、スイッチをオフのままにできます。
  • 1 から 1440 — 指定した分数のあとで、スイッチを自動でオンに戻します。

display_name

クライアントを 複数組織 でデプロイするとき、Cloudflare One Client の GUI で Zero Trust 組織を識別します。configs 配列 内に organization パラメーターがある場合は必須です。

値の型: string

値: Cloudflare One Client の GUI でユーザーに表示する組織のニックネーム(例: Test environment)。

enable_netbt

NetBIOS over TCP/IP(NetBT)は、一部の まれなシナリオ での名前解決に使う Windows のレガシー機能です。セキュリティ上の理由で、Cloudflare One Client はトンネルインターフェイス上の NetBT をデフォルトで無効にします。NetBT が必要なレガシーアプリケーションにまだ依存している場合は、デフォルトを上書きして NetBT を有効にできます。

値の型: boolean

値:

  • false — (デフォルト)Cloudflare One Client のトンネルインターフェイスで NetBT を無効にします。
  • true — Cloudflare One Client のトンネルインターフェイスで NetBT を有効にします。

enable_pmtud

Path MTU Discovery(PMTUD) を使うと、Cloudflare One Client は現在のネットワークで送信できる最大パケットサイズを調べ、接続パフォーマンスを最適化できます。

値の型: boolean

値:

  • false — (デフォルト)PMTUD を無効にします。
  • true — Cloudflare One Client のトンネルインターフェイスで PMTUD を有効にします。

enable_post_quantum

機能の提供状況

クライアントモード Zero Trust プラン ↗
  • Traffic and DNS モード
  • Traffic only モード
すべてのプラン
システム 提供状況 最小 WARP バージョン
Windows ✅ 2025.5.735.1
macOS ✅ 2025.5.735.1
Linux ✅ 2025.5.735.1
iOS ✅ 1.10
Android ✅ 2.4
ChromeOS ✅ 2.4

Cloudflare One Client は 耐量子暗号 を使い、デバイスから Cloudflare ネットワークへの接続を保護します。耐量子暗号には MASQUE プロトコル が必要で、MASQUE を使うすべてのデバイスでデフォルトで有効です。

値の型: boolean

値:

  • false — 耐量子鍵合意を無効にします。
  • true — WARP トンネルを通るすべてのトラフィックで耐量子鍵合意を有効にします。

environment

機能の提供状況

クライアントモード Zero Trust プラン ↗
すべてのモード すべてのプラン
システム 提供状況 最小 WARP バージョン
Windows ✅ 2025.9.558.0
macOS ✅ 2025.9.558.0
Linux ✅ 2025.9.558.0
iOS ✅ 1.12.0
Android ✅ 2.5.1
ChromeOS ✅ 2.5.1

Cloudflare One Client を、Cloudflare の FedRAMP High 認定環境へ接続するよう設定します。

値の型: string

値:

  • normal — (デフォルト)Cloudflare One Client は標準の API エンドポイント、IP、ドメイン(<ACCOUNT_ID>.cloudflare-gateway.com など)へ接続し、世界中の Cloudflare データセンターへトラフィックを転送します。
  • fedramp_high — Cloudflare One Client は FedRAMP 専用の API エンドポイント、IP、ドメイン(<ACCOUNT_ID>.fed.cloudflare-gateway.com など)へ接続します。トラフィックは処理のため FedRAMP High 準拠のデータセンターへ転送されます。FedRAMP High 環境を設定するには、ファイアウォールで FedRAMP 専用のエンドポイント、IP、ドメイン を許可する必要があります。

同じ組織に 複数の設定 を使う場合、すべての設定で同じ environment 値を指定する必要があります。1 つの組織を通常環境と FedRAMP High 環境の両方で運用することはできません。

バージョン 2026.5.0 以降では、organization_configs を使い、設定エントリごとに繰り返さず、組織ごとに environment を 1 回設定します。

<dict>
  <key>organization_configs</key>
  <dict>
    <key>mycompany-gov</key>
    <dict>
      <key>environment</key>
      <string>fedramp_high</string>
    </dict>
  </dict>
  <key>configs</key>
  <array>
    <dict>
      <key>organization</key>
      <string>mycompany-gov</string>
      <key>display_name</key>
      <string>Production</string>
    </dict>
    <dict>
      <key>organization</key>
      <string>mycompany-gov</string>
      <key>display_name</key>
      <string>Staging</string>
    </dict>
    <dict>
      <key>organization</key>
      <string>test-org</string>
      <key>display_name</key>
      <string>Test</string>
      <key>environment</key>
      <string>normal</string>
    </dict>
  </array>
</dict>

それ以前のバージョンでは、その組織の各設定に environment を明示的に含める必要があります。

<dict>
  <key>configs</key>
  <array>
    <dict>
      <key>organization</key>
      <string>mycompany-gov</string>
      <key>display_name</key>
      <string>Production</string>
      <key>environment</key>
      <string>fedramp_high</string>
    </dict>
    <dict>
      <key>organization</key>
      <string>mycompany-gov</string>
      <key>display_name</key>
      <string>Staging</string>
      <key>environment</key>
      <string>fedramp_high</string>
    </dict>
    <dict>
      <key>organization</key>
      <string>test-org</string>
      <key>display_name</key>
      <string>Test</string>
      <key>environment</key>
      <string>normal</string>
    </dict>
  </array>
</dict>

external_emergency_signal_fingerprint

Cloudflare One Client が external_emergency_signal_url の HTTPS エンドポイントを検証するために使う SHA-256 フィンガープリントです。このフィンガープリントの取り出し方は External Emergency Disconnect を参照してください。

値の型: string

値: HTTPS サーバー証明書の SHA-256 フィンガープリント(例: DD4F4806C57A5BBAF1AA5B080F0541DA75DB468D0A1FE731310149500CCD8662)

external_emergency_signal_interval

Cloudflare One Client が External Emergency Disconnect シグナルのために external_emergency_signal_url をポーリングする間隔です。

値の型: integer

値: ポーリング間隔(秒)。最小 30、デフォルト 300

external_emergency_signal_url

Cloudflare One Client が External Emergency Disconnect シグナルをポーリングする HTTPS エンドポイントです。

値の型: string

値: https://192.0.2.1:3333/status/disconnect

URL は https:// を使い、ホストはドメインではなく IPv4 または IPv6 アドレスである必要があります。

hardware_backed_registration

機能の提供状況

クライアントモード Zero Trust プラン ↗
すべてのモード すべてのプラン
システム 提供状況 最小 WARP バージョン
Windows ✅ 2026.6.0
macOS ✅ 2026.6.0
Linux ✅ 2026.6.0
iOS ❌ N/A
Android ❌ N/A
ChromeOS ❌ N/A

登録を、デバイスハードウェア(Secure Enclave または TPM 2.0)に保存されるエクスポート不可の鍵に紐づけ、API リクエストを mTLS で認証します。詳細は ハードウェア裏付け登録 を参照してください。

値の型: boolean

値:

  • false — (デフォルト)Cloudflare One Client は API トークンをデバイスのキーストアに保存します。
  • true — Cloudflare One Client は登録時にハードウェア裏付けの鍵を生成し、以降の API 呼び出しに mTLS を使います。

local_emergency_signal_enabled

Local Emergency Disconnect を有効にします。有効にすると、Cloudflare One Client はデバイス上の固定パスの JSON ファイルを監視し、緊急切断シグナルを受け取ります。

値の型: boolean

値:

  • false — (デフォルト)ローカルシグナルファイルの監視は無効です。
  • true — クライアントはローカルシグナルファイルを監視し、緊急切断に使います。

onboarding

アプリケーションの初回起動時に、プライバシーポリシーの確認を求めるオンボーディング画面の表示を制御します。

値の型: boolean

値:

  • false — 画面を非表示にします。
  • true — (デフォルト)画面を表示します。

override_api_endpoint

Cloudflare One Client がクライアントオーケストレーション API との通信に使う IP アドレス を上書きします。このパラメーターを設定する場合は、新しい IP が通るよう組織のファイアウォールを更新してください。

この機能は、Cloudflare China のローカルネットワークパートナー、またはネットワークトラフィックの完全性を維持できるそのほかのサードパーティネットワークパートナー向けです。ほとんどの IT 管理者はこの設定を使うべきではありません。すべての API トラフィックが新しい IP へリダイレクトされます。

値の型: string

値: 1.2.3.4 — すべてのクライアントオーケストレーション API 呼び出しを 1.2.3.4 へリダイレクトします。

文字列は有効な IPv4 または IPv6 アドレスである必要があります。そうでない場合、Cloudflare One Client は MDM ファイル全体の解析に失敗します。

override_doh_endpoint

Cloudflare One Client が DNS over HTTPS(DoH)で DNS クエリを解決するときに使う IP アドレス を上書きします。このパラメーターを設定する場合は、新しい IP が通るよう組織のファイアウォールを更新してください。

この機能は、Cloudflare China のローカルネットワークパートナー、またはネットワークトラフィックの完全性を維持できるそのほかのサードパーティネットワークパートナー向けです。ほとんどの IT 管理者はこの設定を使うべきではありません。すべての DoH トラフィックが新しい IP へリダイレクトされます。

値の型: string

値: 1.2.3.4 — すべての DNS over HTTPS ルックアップを 1.2.3.4 へリダイレクトします。

文字列は有効な IPv4 または IPv6 アドレスである必要があります。そうでない場合、Cloudflare One Client は MDM ファイル全体の解析に失敗します。

override_warp_endpoint

Cloudflare One Client が Cloudflare のエッジへトラフィックを送るときに使う IP アドレスと UDP ポート を上書きします。このパラメーターを設定する場合は、新しい IP が通るよう組織のファイアウォールを更新してください。

この機能は、Cloudflare China のローカルネットワークパートナー、またはネットワークトラフィックの完全性を維持できるそのほかのサードパーティネットワークパートナー向けです。ほとんどの IT 管理者はこの設定を使うべきではありません。すべての Cloudflare One Client トラフィックが新しい IP へリダイレクトされます。

値の型: string

値: 203.0.113.0:500 — すべての Cloudflare One Client トラフィックを 203.0.113.0 のポート 500 へリダイレクトします。

文字列は有効な IPv4 または IPv6 ソケットアドレス(IP アドレスとポート番号)である必要があります。そうでない場合、Cloudflare One Client は MDM ファイル全体の解析に失敗します。

service_mode

クライアントの動作モードを選べます。

値の型: string

値:

support_url

MDM で Cloudflare One Client をデプロイすると、アプリ内の Send Feedback ボタンはデフォルトで無効です。このパラメーターでボタンを再有効化し、フィードバックの送り先を組織にできます。

値の型: string

値:

  • https://<support.example.com> — https:// リンクで社内ヘルプサイトを開きます。
  • mailto:<[email protected]> — mailto: リンクでデフォルトのメールクライアントを開きます。

switch_locked

ユーザーがクライアントのスイッチをオフにし、Cloudflare One Client を切断できるかどうかを制御します。

値の型: boolean

値:

  • false — (デフォルト)ユーザーは任意でスイッチをオン/オフできます。スイッチがオフのとき、特定のデバイスポスチャチェックを使う Access 保護サイトへは到達できません。
  • true — ユーザーはスイッチをオフにできません。Cloudflare One Client は自動で接続済み状態で起動します。

新規デプロイでは、auto_connect パラメーターを少なくとも 0 で含める必要があります。オフ状態でデプロイされ、ユーザーが手動で有効にできない状態を防げます。

unique_client_id

デバイス UUID ポスチャチェック 用に、デバイスへ一意の識別子を割り当てます。

値の型: string

値: デバイスの UUID(例: 496c6124-db89-4735-bc4e-7f759109a6f1)。

use_in_app_webview

Zero Trust 認証に、デフォルトのシステムブラウザーではなくアプリ内 WebView を使います。Always-on VPN と Lockdown モードが有効な場合にこの設定が必要です。

値の型: boolean

値:

  • false — (デフォルト)Zero Trust 認証にデフォルトのシステムブラウザーを使います。
  • true — Zero Trust 認証にアプリ内 WebView を使います。

warp_tunnel_protocol

デバイスから Cloudflare Gateway へ IP トラフィックを送るプロトコルを設定します。詳細は デバイストンネルプロトコル を参照してください。

値の型: string

値:

トップレベルパラメーター

トップレベルパラメーターは、Cloudflare One Client がデバイス登録を管理する方法を決めます。

configs

ユーザーが Cloudflare One Client の GUI で Zero Trust 組織を切り替え できるようにします。組織が 1 つだけでも、multi_user や pre_login などのほかの トップレベルパラメーター を使う場合は configs 配列が必要です。

値の型: array

値: 1 つ以上の Zero Trust 組織を含む配列。

multi_user

Windows デバイスで複数ユーザーの登録を有効にします。

値の型: boolean

値:

  • false — (デフォルト)デバイスごとに Cloudflare One Client の登録は 1 つだけ保存されます。ユーザーが Cloudflare One Client にログインしたあと、その設定と ID がデバイスからのすべてのトラフィックに適用されます。
  • true — 各 Windows ユーザーが独自の Cloudflare One Client 登録を持ちます。詳細は Windows デバイス上の複数ユーザー を参照してください。

organization_configs

機能の提供状況

クライアントモード Zero Trust プラン ↗
すべてのモード すべてのプラン
システム 提供状況 最小 WARP バージョン
Windows ✅ 2026.5.0
macOS ✅ 2026.5.0
Linux ✅ 2026.5.0
iOS ❌ N/A
Android ❌ N/A
ChromeOS ❌ N/A

特定の組織のすべての configs エントリに適用する組織全体の設定を定義します。個別の設定エントリ内の競合する値を上書きします。

値の型: dict

値: 各キーが組織名(チーム名)、各値が組織全体の設定の dict である dict。

対応する設定:

キー 説明
environment この組織に属するすべての設定で environment の値を上書きします。
hardware_backed_registration この組織に属するすべての設定で hardware_backed_registration の値を上書きします。

同じ組織に複数の設定があり、すべてで同じ environment 値を強制したいときに organization_configs を使います。その組織の個別 configs エントリに設定した environment 値は、organization_configs で指定した値で上書きされます。

test-org に 2 つの設定(Production と Staging)があり、どちらも organization_configs で fedramp_high が強制される設定例:

<dict>
  <key>organization_configs</key>
  <dict>
    <key>test-org</key>
    <dict>
      <key>environment</key>
      <string>fedramp_high</string>
    </dict>
  </dict>
  <key>configs</key>
  <array>
    <dict>
      <key>organization</key>
      <string>test-org</string>
      <key>display_name</key>
      <string>Production</string>
    </dict>
    <dict>
      <key>organization</key>
      <string>test-org</string>
      <key>display_name</key>
      <string>Staging</string>
    </dict>
  </array>
</dict>

pre_login

ユーザーが最初の Windows ログインを完了する前に、サービストークンで Cloudflare One Client を接続できます。詳細は Windows ログイン前に Cloudflare One Client を接続する を参照してください。

アプリ単位 VPN パラメーター(Android)

アプリ単位 VPN ↗ パラメーターでは、WARP トンネル経由でトラフィックを送れる Android アプリを選べます。管理者は、管理対象デバイスまたはワークプロファイルへ Android アプリをデプロイできる任意の MDM ツールで、これらのパラメーターを設定できます。

app_identifier

Google Play Store 上のアプリを一意に識別する、アプリケーションのパッケージ名 / バンドル識別子です。このアプリケーションは Cloudflare One Client サービス経由でトンネリングされます。

値の型: string

値: アプリ識別子は、そのアプリの Play Store URL の ID クエリパラメーターにあります。例: https://play.google.com/store/apps/details?id=com.cloudflare.cloudflareoneagent の場合、Cloudflare One Agent アプリのアプリ識別子は com.cloudflare.cloudflareoneagent です。

is_browser

省略可能なプロパティです。is_browser は、再認証や Gateway のブロック通知など特定の機能で、Cloudflare One Agent アプリケーションがデフォルトブラウザーの代わりに開くブラウザーを決めるのに役立ちます。必要な場合、管理者は自動検出に頼らず、対象の tunneled_app がブラウザーであることを明示してください。

値の型: boolean

値: 値が true の場合、app_identifier で定義したアプリケーションをブラウザーとして扱います。デフォルト値は false で、is_browser は省略可能なプロパティです。

Footnotes

  1. Traffic and DNS モードはクライアントバージョン 2025.2.664.0 以下で対応します。バージョン 2025.4.589.1 以降では、すべての DoH トラフィックが WARP トンネル内を通るため、このパラメーターは Traffic and DNS モードに適用されません。 ↩

役に立ちましたか?