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

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

事前要件​

BotManager .NET Agentを使用する前に以下の事項を確認してください。

  1. .NETバージョン

    • 最小**.NET 4.0**以上必要
    • .NET 4.0～4.8バージョンサポート

  2. アプリケーションアーキテクチャ

    • Windowsベースの.NET環境
    • HTTPまたはHTTPSを使用する環境

  3. サーバー設定

    • サーバーから外部へのHTTP/HTTPS通信が可能でなければなりません
    • マクロ検出サーバーと通信するためにhttps://botmanager.stclab.comへのネットワークアクセス必要

インストール方法​

1. ドメイン選択​

エージェントをインストールするドメインを選択しBotManagerコンソールで設定値を確認してください。

2. ZIPファイルダウンロード​

最新ZIPファイルを以下のリンクからダウンロードします：

ダウンロードリンク

3. DLLファイルをプロジェクトに追加​

ダウンロードしたbotmanager-dotnet-agent.zipファイルのBotManagerDotNetAgent.dllファイルをプロジェクトに直接追加します。Newtonsoft.Json.dllファイルの場合は11.0.1バージョンであり、既存に使用している他のバージョンのファイルがない場合にのみ追加すればよいです。

ファイルコピー： BotManagerDotNetAgent.dllファイルをプロジェクトのbinフォルダー（bin|bin/Debug|bin/Release）にdllファイルをコピーします。コピー後参照を通じて該当ライブラリを追加します。

Newtonsoft.Json.dllファイル適用時Web.configファイルに以下のように追加します。

ダウンロード受けたファイルを適用する場合​

<runtime> 
  <assemblyBinding> 
    <dependentAssembly>
      <assemblyIdentity name="Newtonsoft.Json" publicKeyToken="30ad4fe6b2a6aeed"/>
      <bindingRedirect oldVersion="0.0.0.0-11.0.0.1" newVersion="11.0.0.1"/>
    </dependentAssembly>
  </assemblyBinding>
</runtime>

上位バージョンのファイルを使用中の場合​

<runtime> 
  <assemblyBinding> 
    <dependentAssembly>
      <assemblyIdentity name="Newtonsoft.Json" publicKeyToken="30ad4fe6b2a6aeed"/>
      <bindingRedirect oldVersion="0.0.0.0-13.0.0.0" newVersion="12.0.0.0"/>
    </dependentAssembly>
  </assemblyBinding>
</runtime>

<bindingRedirect oldVersion="0.0.0.0-13.0.0.0" newVersion="12.0.0.0"/> oldVersion、newVersion値を既存に使用しているバージョンに合わせてください。

4. 初期化​

BotManagerを使用するには初期化が必要です。以下のコードを参照してアプリケーション初期化時点に設定を追加してください。

コード例：

using System.Web;
using System.Web.Mvc;
using System.Web.Routing;
using BotManagerDotNetAgent.Domain;
using BotManagerDotNetAgent.Config;

namespace MyApplication
{
    public class MvcApplication : HttpApplication
    {
        protected void Application_Start()
        {
            BotManager.Initialize(new BotManagerConfig.Builder()
                .TenantId("{tenant-id}") // 顧客社識別ID
                .DomainName("{domain-name}") // リクエストドメイン
                .ServerUrl("https://botmanager.stclab.com/api/v1/macro") // 検出サーバー
                .ProtectionUrl("https://cdn-botmanager.stclab.com") // ブロックページURL
                .HttpRequestTimeout(1000) // HTTPリクエストタイムアウト（ms）
                .LogLevel("ERROR") // ログレベル
                .Build());
        }
    }
}

customId設定​

customIdはサービスページでユーザーを特定できる値として明示できる選択的設定値です。

例：

  • ログイン認証を通じてログインした場合ユーザーID
  • ログイン認証を通じてログインした場合セッション値

主要機能および利点​

  1. BotManager接続者管理コンソール統合：

    • customIdを設定するとサービス内で確認可能な特定ユーザー基準で検出情報を確認できます。

  2. 多重機器ブロック：

    • 同一のcustomIdを使用するユーザーが複数の機器を通じて接続する場合、ブロック設定が該当機器にも同一に適用されます。
    • これを通じてブロックされたユーザーの多重機器使用を防止できます。

次のステップ​

インストールが完了すると以下の文書を参照してください：