본문으로 건너뛰기

설치 및 초기화

사전 요구사항​

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는 서비스 페이지에서 사용자를 특정할 수 있는 값으로 명시할 수 있는 선택적 설정 값입니다.

예시:

  • 로그인 인증을 통해 로그인한 경우 사용자 아이디
  • 로그인 인증을 통해 로그인한 경우 세션 값

주요 기능 및 이점​

  1. BotManager 접속자 관리 콘솔 통합:

    • customId를 설정하면 서비스 내에서 확인 가능한 특정 사용자 기준으로 탐지 정보를 확인할 수 있습니다.

  2. 다중 기기 차단:

    • 동일한 customId를 사용하는 사용자가 여러 기기를 통해 접속할 경우, 차단 설정이 해당 기기들에도 동일하게 적용됩니다.
    • 이를 통해 차단된 사용자의 다중 기기 사용을 방지할 수 있습니다.

다음 단계​

설치가 완료되면 다음 문서를 참조하세요: