Browser/JavaScript Agent
📄️ 설치 및 초기화
BotManager Browser Agent 설치 및 초기화 가이드
📄️ 설정 옵션 참조
BotManager Browser Agent의 모든 설정 옵션 및 사용법
📄️ API 참조
BotManager Browser Agent의 API 함수 명세 및 사용법
📄️ 문제 해결
BotManager Browser Agent 사용 시 발생할 수 있는 일반적인 문제 및 해결 방법
개요
BotManager Browser Agent는 클라이언트 측에서 봇 탐지를 위한 중요한 기능을 수행하는 에이전트입니다.
주요 기능:
- 개발자 도구 탐지: 개발자 도구가 활성화된 상태를 감지하여 봇 가능성을 식별합니다.
- 셀레니움 탐지: 자동화 툴인 셀레니움 사용 여부를 감지합니다.
- 사용자 클릭 행위 분석: 사용자의 클릭 패턴을 분석하여 비정상적인 행동을 탐지합니다.
BotManager Browser Agent는 페이지 로드시 pathname 정보를 수집하여 서버로 전송합니다. 특정 기능을 호출하기 전에 서버로 탐지 데이터를 전송하도록 설정할 수도 있습니다. 서버의 응답에 따라 Deny 페이지, Captcha 페이지, Browser Challenge 페이지로 리디렉션하여 탐지에 대응합니다.
클라이언트 측 에이전트의 장점
- 사용자의 행위를 실시간으로 분석하여 탐지 서버와 상호작용
- 서버와의 응답에 따라 즉시 보안 조치 가능
- 브라우저 환경에서 직접 실행되어 높은 정확도
주요 기능
| 기능 | 설명 |
|---|---|
| 실시간 탐지 | 페이지 로드 시 자동으로 탐지 요청 전송 |
| 이벤트 기반 탐지 | 특정 이벤트(버튼 클릭 등)와 함께 탐지 수행 |
| 비동기/동기 모드 | Callback을 통한 동기 모드와 비동기 모드 지원 |
| Server-Side Agent 연동 | 헤더 기반 리디렉션을 통한 서버 에이전트와의 연동 |
| 유연한 설정 | 다양한 설정 옵션을 통한 맞춤형 탐지 |
시스템 요구사항
- 브라우저: Chrome, Firefox, Safari, Edge 등 모든 모던 브라우저
- JavaScript: ES5+ 지원
- 프레임워크: React, Vue, Angular, vanilla JavaScript 등 모든 프레임워크와 호환
호환 환경
- 웹 애플리케이션: Single Page Applications (SPA), Multi Page Applications (MPA)
- 프레임워크: React, Vue.js, Angular, Next.js, Nuxt.js, vanilla JavaScript
- 모든 웹 플랫폼: 데스크톱 브라우저, 모바일 브라우저
작동 방식
BotManager Browser Agent는 다음과 같은 흐름으로 작동합니다:
- 스크립트 로드: HTML에 스크립트를 추가하여 에이전트를 초기화합니다.
- 자동 탐지: 페이지 로드 시 자동으로 탐지 요청을 전송합니다 (선택 사항).
- 이벤트 탐지: 특정 이벤트 발생 시 탐지 요청을 전송할 수 있습니다.
- 응답 처리: 서버 응답에 따라 Deny, Captcha, Browser Challenge 페이지로 리디렉션합니다.
작동 흐름:
스크립트 로드 → 에이전트 초기화
↓
[자동 탐지] 또는 [이벤트 기반 탐지]
↓
서버 응답 처리
↓
┌─────────────────────────┐
│ 탐지 결과에 따른 처리 │
├─────────────────────────┤
│ • 정상: 정상 진행 │
│ • 의심: Captcha 페이지 │
│ • 차단: Deny 페이지 │
│ • 챌린지: Browser Challenge │
└─────────────────────────┘
탐지 모드 선택
자동 탐지와 이벤트 기반 탐지를 조합하여 사용하면 더 효과적인 보안을 제공할 수 있습니다.
설치 방법
BotManager Browser Agent는 다음 두 가지 방식으로 설치할 수 있습니다:
- HTML 파일에 직접 삽입: 페이지의
<head>태그에 직접 설치 코드를 삽입합니다. - 공통 JavaScript 파일에 삽입: 사이트에서 공통으로 사용하는 JavaScript 파일에 설치 코드를 추가합니다.
자세한 설치 방법은 설치 가이드를 참조하세요.
설정 옵션
BotManager Browser Agent는 다양한 설정 옵션을 제공합니다:
| 옵션 | 타입 | 기본값 | 설명 |
|---|---|---|---|
detectOnLoad | boolean | true | 페이지 로드 후 자동으로 탐지 요청 전송 여부 |
detectDevTools | boolean | true | 개발자 도구 탐지 기능 활성화 여부 |
detectClickBehavior | boolean | true | 사용자 클릭 탐지 기능 활성화 여부 |
networkTimeout | number | 5000 | 탐지 서버로의 요청 시 네트워크 타임아웃 시간(ms) |
자세한 설정 옵션은 설정 옵션 참조를 확인하세요.
설정 우선순위
설정 옵션은 초기화 시점에 전달된 값이 우선 적용됩니다. 런타임 중 변경은 반영되지 않습니다.