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

インストールおよび初期化

概要​

BotManager Fastly AgentはFastly Computeプラットフォームで動作するエッジベースボット検出およびブロックソリューションです。

主要機能：

  • リアルタイムボット/マクロ検出およびブロック
  • セッションベースユーザー管理
  • キャプチャ/チャレンジページ提供
  • 設定ベースbypassロジック

Fastly Computeとは？​

Fastly ComputeはWebAssembly（WASM）ベースのサーバーレスエッジコンピューティングプラットフォームです。

特徴：

  • 全世界エッジロケーションで実行
  • 超高速応答時間（sub-millisecond）
  • 自動スケーリング
  • 開発者フレンドリー環境

Fastly Computeに関する詳細内容はFastly公式文書を参照してください。

備考

このガイドは既存にFastly Compute Serviceが運用中の環境でBotManager Agentを追加インストールする方法を扱います。

インストール方法​

BotManager Fastly Agentインストールのために以下の4ステップを順序どおりに進行してください。

1. Origins設定​

BotManager検出サーバーをOriginとして登録します。

  1. インストールするCompute ServicesのOriginsタブに移動

  2. Create a hostクリック

  3. 以下の情報を入力します：

    フィールド値説明
    Namebotmanager_serverOrigin名
    Addressbotmanager.stclab.com検出サーバーアドレス
    Port443HTTPSポート
    Use SSL✅ チェックSSL使用
    Certificate hostnamebotmanager.stclab.com証明書ホスト名
Origins設定のヒント

Origin設定後接続テストを通じて正常に接続されるか確認してください。

2. Packageアップロード​

BotManager Fastly Agentパッケージをアップロードします。

  1. BotManager Fastly Agentダウンロード：

    https://cdn-botmanager.stclab.com/agents/cdn/fastly/botmanager-fastly-agent.tar.gz

  2. Packageタブに移動

  3. Upload new packageクリック

  4. ダウンロードしたbotmanager-fastly-agent.tar.gzファイルを選択するかDrag and dropでアップロード

  5. Upload successメッセージ確認

Packageバージョン

パッケージアップロード後バージョン情報を確認して正しいバージョンがアップロードされたか確認してください。

3. Config Stores設定​

BotManager Agentの設定値をConfig Storeに保存します。

  1. Resources → Config stores移動

  2. Create storeクリック

  3. Store name：bm_config入力

  4. Add itemクリック後以下の設定項目追加

必須設定確認

適用ドメインを正確に確認するために下部ドメインを選択してください。

必須設定​

以下の設定は必ず追加する必要があります：

KeyValue説明
BM_TENANT_ID{TENANT ID}顧客識別子（BotManagerコンソールで確認）
BM_DOMAIN_NAME{DOMAIN}適用対象ドメイン（例：example.com）
必須設定漏れ時

必須設定が漏れるとAgentが正常に動作しません。必ず確認してください。

選択設定​

以下の設定はデフォルト値で動作し、必要時にのみ変更します：

Keyデフォルト値説明
BM_SERVER_URLhttps://botmanager.stclab.com/api/v1/macro検出サーバーURL
BM_PROTECTION_URLhttps://cdn-botmanager.stclab.comブロックページURL
BM_STATIC_BYPASStrue静的リソースbypassの有無
BM_BYPASSfalse全体bypassの有無
BM_SERVER_TIMEOUT1000検出サーバータイムアウト（ms）
BM_LOGLEVELERRORログレベル（WARN、INFO、DEBUG）
BM_EXCLUDED_PATHS/api,/health除外パス（カンマ区切り）
BM_EXCLUDED_QUERYSuser,password除外クエリ（カンマ区切り）
選択設定活用

特定パスやクエリパラメータを検出から除外するにはBM_EXCLUDED_PATHSとBM_EXCLUDED_QUERYSを活用してください。

4. Service Activation​

設定したサービスを有効化しキャッシュを初期化します。

  1. Add version commentクリック後デプロイ内容記述

    例：「BotManager Agent v1.0.1デプロイ」

  2. Service configurationタブのActivateクリック

  3. Service summaryタブのPurge allクリックしてキャッシュ初期化

有効化後確認

Service有効化後実際のリクエストでAgentヘッダーが正常に追加されるか確認してください。

基本動作テスト​

インストールが完了するとAgentが正常に動作するか確認してください。

Agentヘッダー確認​

ブラウザ開発者ツールを通じてAgentヘッダーを確認します。

  1. ブラウザ開発者ツール開く（F12）

  2. Networkタブ選択

  3. 保護されたサイト接続

  4. Response Headersで以下のヘッダー確認：

x-bm-agent: BM-fastly-agent-x.x.x
ヘッダー確認のヒント

最初のリクエストでヘッダーが見えない場合はページをリフレッシュするかキャッシュをクリアして再試行してください。

セッションクッキー確認​

Agentが生成したセッションクッキーを確認します。

  1. Applicationタブ（Chrome）またはStorageタブ（Firefox）選択

  2. Cookiesセクションで以下のクッキー確認：

BM-session-id: [生成されたセッションID]
  1. コマンドラインでテスト：
# curlを利用したヘッダー確認
curl -I https://your-domain.com

# 予想結果：
# HTTP/2 200
# x-bm-agent: BM-fastly-agent-1.0.1
# set-cookie: BM-session-id=...
セッションクッキー

セッションクッキーはユーザーセッションを追跡するために自動で生成されます。ブラウザクッキー設定に応じて生成されない場合があります。

問題解決​

インストールおよび運用中に発生する可能性のある問題と解決方法を案内します。

Agentヘッダーが見えない場合​

症状：Response Headersにx-bm-agentヘッダーが表示されない

可能性のある原因：

  • Serviceが有効化されていない
  • Packageアップロード失敗
  • Configurationエラー

解決方法：

  1. Service状態確認

    • Service configurationタブで有効化状態確認
    • 無効化状態ならActivateクリックして再試行

  2. Package再アップロード

    • Packageタブで最新バージョン確認
    • 必要時パッケージ再アップロード

  3. Config Store設定再確認

    • 必須設定項目（BM_TENANT_ID、BM_DOMAIN_NAME）確認
    • Store名がbm_configか確認
Service有効化必須

Serviceを有効化しないとAgentが動作しません。必ず有効化状態を確認してください。

検出サーバー接続失敗​

症状：Response Headersに以下のエラーメッセージ表示

x-bm-error: Detection server timeout

解決方法：

  1. Origins設定確認

    • Backendアドレスがbotmanager.stclab.comか確認
    • SSL設定が正しいか確認
    • Portが443か確認

  2. タイムアウト設定調整

    • Config StoreでBM_SERVER_TIMEOUT値増加
    • デフォルト値：1000ms → 必要時2000ms以上に増加

  3. ネットワーク接続状態確認

    • Fastlyからbotmanager.stclab.comへの接続可能性確認
タイムアウト設定

ネットワーク遅延がある環境ではBM_SERVER_TIMEOUT値を適切に増加させるのが良いです。

Config Storeアクセスエラー​

症状：Response Headersに以下のエラーメッセージ表示

x-bm-error: Config initialization failed

解決方法：

  1. Config Store名確認

    • Store名が正確にbm_configか確認
    • 大文字小文字区別注意

  2. 必須設定項目確認

    • BM_TENANT_IDとBM_DOMAIN_NAMEがすべて設定されているか確認
    • 値が正しく入力されているか確認

  3. Service接続確認

    • ServiceにConfig Storeが正しく接続されているか確認
    • Resourcesタブで接続状態確認
Config Storeエラー

Config Storeアクセスエラーが発生するとAgentが全く動作しません。必ず解決する必要があります。