Java Agent

📄️ 설치 및 초기화

BotManager Java Agent installation and initialization guide

📄️ 설정 옵션 참조

All configuration options and usage for BotManager Java Agent

📄️ API 참조

API method specifications and usage for BotManager Java Agent

Overview

BotManager Java Agent is a macro detection and security solution that can be integrated into Java-based web applications. It detects macro activities in page and API requests and can automatically respond by blocking or using Captcha, Redirect, etc.

Java Agent Features

Easily integrates with Servlet-based web applications and supports both javax.servlet and jakarta.servlet environments.

Key Features

Feature	Description
Page Request Detection	Detects and responds to macro activities when users make page requests
API Request Detection	Detects macro activities in REST API requests as well
Standalone Use	When only Java Agent is installed, it responds to page requests (URL calls) only with Location header
Browser Agent Integration	When used together with Browser Agent, it additionally provides Redirect response for asynchronous requests (XHR, Fetch)

Supported Environments

• Servlet-based web applications
• JDK 1.8 or higher
  • Supports both javax.servlet and jakarta.servlet environments
  • Supports HTTP and HTTPS requests

How It Works

BotManager Java Agent works in the following flow:

1. Initialization: Initialize BotManager when the application starts.
2. Request Detection: Call detectPage() or detectApi() when processing HTTP requests.
3. Response Processing: Perform redirect through Location header or X-BotManager-Location header according to detection results.

Method Selection Guide

• Page Requests: Use detectPage() method
• API Requests: Use detectApi() method
• Each method applies different detection logic.

Installation Methods

BotManager Java Agent is installed by adding a JAR file to the project.

For detailed installation methods, refer to Installation and Initialization.

Configuration Options

BotManager Java Agent provides various configuration options:

Option	Type	Required	Description
tenantId	String	✅	Unique ID for customer identification
domainName	String	✅	Domain of the server receiving requests
serverUrl	String	❌	Detection server URL (default provided)
protectionUrl	String	❌	Block page URL (default provided)
httpRequestTimeout	int	❌	HTTP request timeout (ms)
logLevel	String	❌	Log level (ERROR, WARN, INFO, DEBUG)

For detailed configuration options, check Configuration Options Reference.

Required Configuration

tenantId and domainName must be configured. You can check them in the BotManager console.