ブラウザ/JavaScriptエージェント
📄️ インストールと初期化
BotManager Browser Agentインストールおよび初期化ガイド
📄️ 設定オプション参照
BotManager Browser Agentのすべての設定オプションおよび使用方法
📄️ API参照
BotManager Browser AgentのAPI関数仕様および使用方法
📄️ トラブルシューティング
BotManager Browser Agent使用時に発生する可能性のある一般的な問題および解決方法
概要
BotManager Browser Agentは、クライアント側でボット検出のための重要な機能を実行するエージェントです。
主要機能：
- 開発者ツール検出：開発者ツールが有効化された状態を検出してボット可能性を識別します。
- Selenium検出：自動化ツールであるSelenium使用の有無を検出します。
- ユーザークリック行動分析：ユーザーのクリックパターンを分析して異常な行動を検出します。
BotManager Browser Agentはページロード時にpathname情報を収集してサーバーに送信します。特定機能を呼び出す前にサーバーに検出データを送信するように設定することもできます。サーバーの応答に応じてDenyページ、Captchaページ、Browser Challengeページにリダイレクトして検出に対応します。
クライアント側エージェントの利点
- ユーザーの行動をリアルタイムで分析して検出サーバーと相互作用
- サーバーとの応答に応じて即座にセキュリティ措置可能
- ブラウザ環境で直接実行されて高い精度
主要機能
| 機能 | 説明 |
|---|---|
| リアルタイム検出 | ページロード時に自動で検出リクエスト送信 |
| イベントベース検出 | 特定イベント（ボタンクリックなど）と一緒に検出実行 |
| 非同期/同期モード | Callbackを通じた同期モードと非同期モードサポート |
| Server-Side Agent連動 | ヘッダーベースリダイレクトを通じたサーバーエージェントとの連動 |
| 柔軟な設定 | 多様な設定オプションを通じたカスタマイズ検出 |
システム要件
- ブラウザ：Chrome、Firefox、Safari、Edgeなどすべてのモダンブラウザ
- JavaScript：ES5+サポート
- フレームワーク：React、Vue、Angular、vanilla JavaScriptなどすべてのフレームワークと互換
互換環境
- ウェブアプリケーション：Single Page Applications (SPA)、Multi Page Applications (MPA)
- フレームワーク：React、Vue.js、Angular、Next.js、Nuxt.js、vanilla JavaScript
- すべてのウェブプラットフォーム：デスクトップブラウザ、モバイルブラウザ
動作方式
BotManager Browser Agentは以下のようなフローで動作します：
- スクリプトロード：HTMLにスクリプトを追加してエージェントを初期化します。
- 自動検出：ページロード時に自動で検出リクエストを送信します（オプション）。
- イベント検出：特定イベント発生時に検出リクエストを送信できます。
- 応答処理：サーバー応答に応じてDeny、Captcha、Browser Challengeページにリダイレクトします。
動作フロー：
スクリプトロード → エージェント初期化
↓
[自動検出] または [イベントベース検出]
↓
サーバー応答処理
↓
┌─────────────────────────┐
│ 検出結果に応じた処理 │
├─────────────────────────┤
│ • 正常：正常進行 │
│ • 疑い：Captchaページ │
│ • ブロック：Denyページ │
│ • チャレンジ：Browser Challenge │
└─────────────────────────┘
検出モード選択
自動検出とイベントベース検出を組み合わせて使用するとより効果的なセキュリティを提供できます。
インストール方法
BotManager Browser Agentは以下の2つの方式でインストールできます：
- HTMLファイルに直接挿入：ページの
<head>タグに直接インストールコードを挿入します。 - 共通JavaScriptファイルに挿入：サイトで共通に使用するJavaScriptファイルにインストールコードを追加します。
詳細なインストール方法はインストールガイドを参照してください。
設定オプション
BotManager Browser Agentは多様な設定オプションを提供します：
| オプション | タイプ | デフォルト値 | 説明 |
|---|---|---|---|
detectOnLoad | boolean | true | ページロード後に自動で検出リクエスト送信の有無 |
detectDevTools | boolean | true | 開発者ツール検出機能有効化の有無 |
detectClickBehavior | boolean | true | ユーザークリック検出機能有効化の有無 |
networkTimeout | number | 5000 | 検出サーバーへのリクエスト時のネットワークタイムアウト時間(ms) |
詳細な設定オプションは設定オプション参照を確認してください。
設定優先順位
設定オプションは初期化時点に渡された値が優先適用されます。ランタイム中変更は反映されません。