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

.NET Agent

概要​

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

.NET Agentの特徴

.NET 4.0以上バージョンをサポートし、.NET Frameworkと.NET Coreすべてで使用できます。

主要機能​

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

適用可能環境​

  • .NET 4.0以上（.NET 4.xバージョンサポート）
  • HTTPおよびHTTPSリクエストサポート

動作方式​

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

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

インストール方法​

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

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

設定オプション​

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

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

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

必須設定

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