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

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

事前要件​

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

  1. JDKバージョン

    • 最小JDK 1.8以上必要
    • JDK 1.8と最新JDKすべてで互換されるように設計

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

    • Servletベースアーキテクチャ
    • HTTPまたはHTTPSを使用する環境

  3. サーバー設定

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

インストール方法​

1. ドメイン選択​

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

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

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

ダウンロードリンク

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

ダウンロードしたbotmanager-java-agent.jarファイルをプロジェクトに直接追加します。

Gradle​

build.gradleファイルに以下のように追加：

repositories {
    flatDir {
        dirs 'libs' // JARファイルが位置するディレクトリ
    }
}

dependencies {
    implementation name: 'botmanager-java-agent'
}

Maven​

pom.xmlファイルに以下のように追加：

<dependency>
    <groupId>com.stclab</groupId>
    <artifactId>botmanager-java-agent</artifactId>
    <version>1.0.0</version>
    <scope>system</scope>
    <systemPath>${project.basedir}/libs/botmanager-java-agent.jar</systemPath>
</dependency>

4. 初期化​

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

コード例：

import com.stclab.botmanager.agent.BotManager;
import com.stclab.botmanager.agent.config.BotManagerConfig;
import org.springframework.stereotype.Component;
import jakarta.annotation.PostConstruct;

@Component
public class BotManagerInitializer {

    @PostConstruct
    public void initializeBotManager() {
        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());
        System.out.println("BotManager initialized successfully.");
    }
}

customId設定​

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

例：

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

主要機能および利点​

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

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

  2. 多重機器ブロック：

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

次のステップ​

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