Browser/JavaScript Agent
📄️ 설치 및 초기화
BotManager Browser Agent installation and initialization guide
📄️ 설정 옵션 참조
All configuration options and usage for BotManager Browser Agent
📄️ API 참조
API function specifications and usage for BotManager Browser Agent
📄️ 문제 해결
Common issues and solutions when using BotManager Browser Agent
Overview
BotManager Browser Agent is an agent that performs important functions for bot detection on the client side.
Key Features:
- Developer Tools Detection: Detects when developer tools are activated to identify bot possibilities.
- Selenium Detection: Detects whether the automation tool Selenium is being used.
- User Click Behavior Analysis: Analyzes user click patterns to detect abnormal behavior.
BotManager Browser Agent collects pathname information when the page loads and sends it to the server. You can also configure it to send detection data to the server before calling specific functions. Based on the server's response, it redirects to Deny page, Captcha page, or Browser Challenge page to respond to detection.
- Analyzes user behavior in real time and interacts with detection server
- Can take immediate security measures based on server response
- Runs directly in browser environment for high accuracy
Key Features
| Feature | Description |
|---|---|
| Real-time Detection | Automatically sends detection requests when page loads |
| Event-based Detection | Performs detection along with specific events (button clicks, etc.) |
| Async/Sync Mode | Supports synchronous mode via callback and asynchronous mode |
| Server-Side Agent Integration | Integration with server agents through header-based redirection |
| Flexible Configuration | Customized detection through various configuration options |
System Requirements
- Browser: All modern browsers including Chrome, Firefox, Safari, Edge
- JavaScript: ES5+ support
- Framework: Compatible with all frameworks including React, Vue, Angular, vanilla JavaScript
Compatible Environments
- Web Applications: Single Page Applications (SPA), Multi Page Applications (MPA)
- Frameworks: React, Vue.js, Angular, Next.js, Nuxt.js, vanilla JavaScript
- All Web Platforms: Desktop browsers, mobile browsers
How It Works
BotManager Browser Agent works in the following flow:
- Script Load: Initialize the agent by adding the script to HTML.
- Auto Detection: Automatically send detection requests when the page loads (optional).
- Event Detection: Can send detection requests when specific events occur.
- Response Processing: Redirect to Deny, Captcha, or Browser Challenge pages based on server response.
Workflow:
Script Load → Agent Initialization
↓
[Auto Detection] or [Event-based Detection]
↓
Server Response Processing
↓
┌─────────────────────────┐
│ Processing by Detection Result │
├─────────────────────────┤
│ • Normal: Continue normally │
│ • Suspicious: Captcha page │
│ • Blocked: Deny page │
│ • Challenge: Browser Challenge │
└─────────────────────────┘
Combining auto detection and event-based detection can provide more effective security.
Installation Methods
BotManager Browser Agent can be installed in two ways:
- Direct Insertion in HTML File: Insert installation code directly into the
<head>tag of the page. - Insertion in Common JavaScript File: Add installation code to a JavaScript file commonly used across the site.
For detailed installation methods, refer to Installation Guide.
Configuration Options
BotManager Browser Agent provides various configuration options:
| Option | Type | Default | Description |
|---|---|---|---|
detectOnLoad | boolean | true | Whether to automatically send detection requests after page load |
detectDevTools | boolean | true | Whether to enable developer tools detection |
detectClickBehavior | boolean | true | Whether to enable user click detection |
networkTimeout | number | 5000 | Network timeout time (ms) for requests to detection server |
For detailed configuration options, check Configuration Options Reference.
Configuration options are applied with priority to values passed at initialization time. Changes during runtime are not reflected.