メインコンテンツまでスキップ
バージョン: 4.6.1-saas

初期化設定

このドキュメントでは、NetFUNNEL Cloudflare Agentで使用可能な環境変数設定と追加機能を説明します。

環境変数​

環境変数は、Cloudflare Worker設定で設定する変数で、NetFUNNELエージェントの動作を制御します。

必須設定​

CLIENT_ID​

NetFUNNELコンソールで発行されたクライアントIDを入力します。

タイプ名前値説明
テキストCLIENT_ID{{CLIENT_ID}}NetFUNNELコンソールで確認したClient ID

設定方法:

  1. [WorkersとPages]でWorkerを選択
  2. [設定]タブをクリック
  3. 変数とシークレットで[+追加]をクリック
  4. タイプ: テキストを選択
  5. 名前: CLIENT_ID
  6. 値: NetFUNNELコンソールのClient IDを入力
  7. [デプロイ]をクリック

追加機能​

Good Bot例外処理​

Worker設定を通じて、特定のUser-Agent値が含まれている場合、エージェント動作から例外処理できます。

環境変数設定​

タイプ名前値説明
テキストGOOD_BOTSGooglebot, Bingbot, Slurp, Applebot, facebookexternalhit例外処理するボットのUser-Agentリスト (カンマ区切り)

例: Google、Microsoft、Yahoo、Apple、Facebookボットを例外処理した例です。

設定方法:

  1. [WorkersとPages]でエージェントが適用されたWorkerを選択
  2. [設定]タブをクリック
  3. 変数とシークレットで[+追加]をクリック
  4. タイプ: テキストを選択
  5. 名前: GOOD_BOTS
  6. 値: 例外したいグッドボットのUser-Agentをカンマで区切って入力
  7. [デプロイ]をクリック

進入キー自動返却処理​

NetFUNNEL Cloudflareエージェントは、進入後にNetFUNNELキーを自動的に返却して、次の待機者が進入できるように処理しています。NetFUNNELキーをすぐに返却せず、セグメントで設定したタイムアウト時間にNetFUNNELキーを返却したい場合に使用できる機能です。

環境変数設定​

タイプ名前値説明
テキストRETURN_KEYtrue または false進入キー自動返却の有無
  • true (デフォルト): 待機完了後進入時にエージェントでNetFUNNELキーを自動的に返却します。
  • false: セグメントで設定したタイムアウト時間にキーが返却処理されます。

設定方法:

  1. [WorkersとPages]でエージェントが適用されたWorkerを選択
  2. [設定]タブをクリック
  3. 変数とシークレットで[+追加]をクリック
  4. タイプ: テキストを選択
  5. 名前: RETURN_KEY
  6. 値: true または false を入力
  7. [デプロイ]をクリック

待機室ドメイン変更​

NetFUNNEL待機室ページのドメインはagent-lib.stclab.comです。このドメインをサービス中のドメインに合わせて変更するには、NetFUNNELサービスチームを通じて希望するドメインを伝え、Worker設定を変更する必要があります。

環境変数設定​

タイプ名前値説明
テキストVWR_PAGE_DOMAINhttp(s)://{CNAME_DOMAIN}待機室ドメインURL

例: https://wait.stclab.com

設定方法:

  1. [WorkersとPages]でエージェントが適用されたWorkerを選択
  2. [設定]タブをクリック
  3. 変数とシークレットで[+追加]をクリック
  4. タイプ: テキストを選択
  5. 名前: VWR_PAGE_DOMAIN
  6. 値: 変更したい待機室ドメインURLを入力 (例: https://wait.stclab.com)
  7. [デプロイ]をクリック

クッキードメイン設定​

NetFUNNELサーバーで発行したキーをクッキーに保存する際、現在のページのドメインを基準に保存します。異なるサブドメイン間でキーを共有する必要がある場合、メインドメインがクッキーに保存されるように設定します。

例: develop.stclab.comとstaging.stclab.comのようにサブドメインが異なるページ間でクッキーを共有するように.stclab.comに設定します。

環境変数設定​

タイプ名前値説明
テキストCOOKIE_DOMAIN.{MAIN_DOMAIN}クッキードメイン

例: .stclab.com

設定方法:

  1. [WorkersとPages]でエージェントが適用されたWorkerを選択
  2. [設定]タブをクリック
  3. 変数とシークレットで[+追加]をクリック
  4. タイプ: テキストを選択
  5. 名前: COOKIE_DOMAIN
  6. 値: メインドメイン形式で入力 (例: .stclab.com)
  7. [デプロイ]をクリック

Workerデプロイ​

環境変数を変更した後は、必ずWorkerをデプロイして変更内容を適用する必要があります。

  1. 環境変数設定完了後、[デプロイ]ボタンをクリック
  2. デプロイ完了後、変更内容が適用されます

関連ドキュメント​