メインコンテンツまでスキップ

Java Agent

概要​

BotManager Java AgentはJavaベースウェブアプリケーションに統合可能なマクロ検出およびセキュリティソリューションです。ページおよびAPIリクエストのマクロ活動を検出してブロックするかCaptcha、Redirectなどの対応を自動化できます。

Java Agentの特徴

Servletベースウェブアプリケーションに簡単に統合でき、javax.servletおよびjakarta.servlet環境をすべてサポートします。

主要機能​

機能説明
ページリクエスト検出ユーザーページリクエスト時にマクロ活動の有無を検出して対応します
APIリクエスト検出REST APIリクエストでもマクロ活動を検出します
単独使用Java Agentのみインストール時ページリクエスト（URL呼び出し）にのみLocationヘッダーで対応します
Browser Agent連動Browser Agentと一緒に使用時非同期リクエスト（XHR、Fetch）に対してRedirectで対応追加提供します

適用可能環境​

  • Servletベースウェブアプリケーション
  • JDK 1.8以上
    • javax.servletおよびjakarta.servlet環境サポート
    • HTTPおよびHTTPSリクエストサポート

動作方式​

BotManager Java Agentは以下のようなフローで動作します：

  1. 初期化：アプリケーション開始時にBotManagerを初期化します。
  2. リクエスト検出：HTTPリクエスト処理時にdetectPage()またはdetectApi()を呼び出します。
  3. 応答処理：検出結果に応じてLocationヘッダーまたはX-BotManager-Locationヘッダーを通じてリダイレクトを実行します。
メソッド選択ガイド
  • ページリクエスト：detectPage()メソッド使用
  • APIリクエスト：detectApi()メソッド使用
  • 2つのメソッドはそれぞれ異なる検出ロジックを適用します。

インストール方法​

BotManager Java AgentはJARファイルをプロジェクトに追加してインストールします。

詳細なインストール方法はインストールおよび初期化を参照してください。

設定オプション​

BotManager Java Agentは多様な設定オプションを提供します：

オプションタイプ必須説明
tenantIdString✅顧客社識別のための固有ID
domainNameString✅リクエストが入ってくるサーバーのドメイン
serverUrlString❌検出サーバーURL（デフォルト値提供）
protectionUrlString❌ブロックページURL（デフォルト値提供）
httpRequestTimeoutint❌HTTPリクエストタイムアウト（ms）
logLevelString❌ログレベル（ERROR、WARN、INFO、DEBUG）

詳細な設定オプションは設定オプション参照を確認してください。

必須設定

tenantIdとdomainNameは必ず設定する必要があります。BotManagerコンソールで確認できます。