Java 에이전트
📄️ 설치 및 초기화
BotManager Java Agent 설치 및 초기화 가이드
📄️ 설정 옵션 참조
BotManager Java Agent의 모든 설정 옵션 및 사용법
📄️ API 참조
BotManager Java Agent의 API 메서드 명세 및 사용법
개요
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는 다음과 같은 흐름으로 작동합니다:
- 초기화: 애플리케이션 시작 시 BotManager를 초기화합니다.
- 요청 탐지: HTTP 요청 처리 시
detectPage()또는detectApi()를 호출합니다. - 응답 처리: 탐지 결과에 따라 Location 헤더 또는 X-BotManager-Location 헤더를 통해 리다이렉트를 수행합니다.
메서드 선택 가이드
- 페이지 요청:
detectPage()메서드 사용 - API 요청:
detectApi()메서드 사용 - 두 메서드는 각각 다른 탐지 로직을 적용합니다.
설치 방법
BotManager Java Agent는 JAR 파일을 프로젝트에 추가하여 설치합니다.
자세한 설치 방법은 설치 및 초기화를 참조하세요.
설정 옵션
BotManager Java Agent는 다양한 설정 옵션을 제공합니다:
| 옵션 | 타입 | 필수 | 설명 |
|---|---|---|---|
tenantId | String | ✅ | 고객사 식별을 위한 고유 ID |
domainName | String | ✅ | 요청이 들어오는 서버의 도메인 |
serverUrl | String | ❌ | 탐지 서버 URL (기본값 제공) |
protectionUrl | String | ❌ | 차단 페이지 URL (기본값 제공) |
httpRequestTimeout | int | ❌ | HTTP 요청 타임아웃(ms) |
logLevel | String | ❌ | 로그 레벨 (ERROR, WARN, INFO, DEBUG) |
자세한 설정 옵션은 설정 옵션 참조를 확인하세요.
필수 설정
tenantId와 domainName은 반드시 설정해야 합니다. BotManager 콘솔에서 확인할 수 있습니다.