初期化設定
このドキュメントでは、NetFUNNEL Akamai Agentで使用可能なProperty Variables設定と追加機能について説明します。
Property Variables
Property Variablesは、Akamai Propertyで設定する変数で、NetFUNNELエージェントの動作を制御します。
必須設定
NF_CLIENT_ID
NetFUNNELコンソールで発行されたクライアントIDを入力します。
| VARIABLE NAME | INITIAL VALUE | 説明 |
|---|---|---|
NF_CLIENT_ID | {{CLIENT_ID}} | NetFUNNELコンソールで確認したClient ID |
設定方法:
- Propertyを選択
- Property Variablesで[+Add Variable]をクリック
- Variable Name:
NF_CLIENT_ID - Initial Value: NetFUNNELコンソールのClient IDを入力
- [Save]をクリック
追加機能
Good Bot例外処理
Property設定を通じて、特定のUser-Agent値が含まれている場合、エージェント動作から例外処理できます。
Property設定
- EdgeWorkerが適用されているPropertyを選択
- Property Configuration SettingsでNF EdgeWorkerを選択
- Criteriaで[+Match]をクリック
- User Agent、
is not one ofを選択 - 例外したいグッドボットのUser-Agentを追加 (例:
Googlebot、Bingbot、Slurp、Applebot、facebookexternalhit) - 右下の[Save]ボタンをクリック
- 上部の[Activate]タブをクリック
- Production Networkで[Activate
{version}on Production]をクリック - Verifying完了後、警告メッセージボックスにチェック
- [Activate
{version}on Production]をクリック
進入キー自動返却処理
NetFUNNEL Akamaiエージェントは、進入後にNetFUNNELキーを自動的に返却して次の待機者が進入できるように処理しています。もし、NetFUNNELキーをすぐに返却せず、セグメントで設定したタイムアウト時間にNetFUNNELキーを返却したい場合に使用できる機能です。
Property Variables設定
| VARIABLE NAME | INITIAL VALUE | 説明 |
|---|---|---|
NF_RETURN_KEY | true | 進入キー自動返却の有無 |
true(デフォルト): 待機完了後進入時にエージェントでNetFUNNELキーを自動的に返却します。false: セグメントで設定したタイムアウト時間にキーが返却処理されます。
設定方法:
- Property Variablesで[+Add Variable]をクリック
- Variable Name:
NF_RETURN_KEY - Initial Value:
trueまたはfalse - [Save]をクリック
- Propertyを有効化
待機室ドメイン変更
NetFUNNEL待機室ページのドメインはagent-lib.stclab.comです。このドメインをサービス中のドメインに合わせて変更するには、NetFUNNELサービスチームを通じて希望するドメインを伝え、Property設定を変更する必要があります。
Property Variables設定
| VARIABLE NAME | INITIAL VALUE | 説明 |
|---|---|---|
NF_VWR_PAGE_DOMAIN | http(s)://{CNAME_DOMAIN} | 待機室ドメインURL |
例: https://wait.stclab.com
設定方法:
- Property Variablesで[+Add Variable]をクリック
- Variable Name:
NF_VWR_PAGE_DOMAIN - Initial Value: 変更したい待機室ドメインURLを入力 (例:
https://wait.stclab.com) - [Save]をクリック
- Propertyを有効化
クッキードメイン設定
NetFUNNELサーバーで発行したキーをクッキーに保存する際、現在のページのドメインを基準に保存します。もし、異なるサブドメイン間でキーを共有する必要がある場合、メインドメインがクッキーに保存されるように設定します。
例: develop.stclab.comとstaging.stclab.comのようにサブドメインが異なるページ間でクッキーを共有するように.stclab.comに設定します。
Property Variables設定
| VARIABLE NAME | INITIAL VALUE | 説明 |
|---|---|---|
NF_COOKIE_DOMAIN | .{MAIN_DOMAIN} | クッキードメイン |
例: .stclab.com
設定方法:
- Property Variablesで[+Add Variable]をクリック
- Variable Name:
NF_COOKIE_DOMAIN - Initial Value: メインドメイン形式で入力 (例:
.stclab.com) - [Save]をクリック
- Propertyを有効化
Property有効化
Property Variablesを変更した後は、必ずPropertyを有効化して変更内容を適用する必要があります。
- 右下の[Save]ボタンをクリック
- 上部の[Activate]タブをクリック
- Production Networkで[Activate
{version}on Production]をクリック - Verifying完了後、上部の警告メッセージボックスにチェック
- [Activate
{version}on Production]をクリック
関連ドキュメント
- インストールと初期化: Property Variables基本設定
- トラブルシューティング: 一般的な問題と解決方法