.NET 에이전트
📄️ 설치 및 초기화
BotManager .NET Agent 설치 및 초기화 가이드
📄️ 설정 옵션 참조
BotManager .NET Agent의 모든 설정 옵션 및 사용법
📄️ API 참조
BotManager .NET Agent의 API 메서드 명세 및 사용법
개요
BotManager .NET Agent는 .NET 기반 웹 애플리케이션에 통합 가능한 매크로 탐지 및 보안 솔루션입니다. 페이지 및 API 요청의 매크로 활동을 감지하여 차단하거나 Captcha, Redirect 등의 대응을 자동화할 수 있습니다.
.NET Agent의 특징
.NET 4.0 이상 버전을 지원하며, .NET Framework와 .NET Core 모두에서 사용할 수 있습니다.
주요 기능
| 기능 | 설명 |
|---|---|
| 페이지 요청 탐지 | 사용자 페이지 요청 시 매크로 활동 여부를 감지해 대응합니다 |
| API 요청 탐지 | REST API 요청에서도 매크로 활동을 감지합니다 |
| 단독 사용 | .NET Agent만 설치 시 페이지 요청(URL 호출)에만 Location 헤더로 대응합니다 |
| Browser Agent 연동 | Browser Agent와 함께 사용 시 비동기 요청(XHR, Fetch)에 대해 Redirect로 대응 추가 제공합니다 |
적용 가능 환경
- .NET 4.0 이상 (.NET 4.x 버전 지원)
- HTTP 및 HTTPS 요청 지원
작동 방식
BotManager .NET Agent는 다음과 같은 흐름으로 작동합니다:
- 초기화: 애플리케이션 시작 시 BotManager를 초기화합니다.
- 요청 탐지: HTTP 요청 처리 시
DetectPage()또는DetectApi()를 호출합니다. - 응답 처리: 탐지 결과에 따라 Location 헤더 또는 X-BotManager-Location 헤더를 통해 리다이렉트를 수행합니다.
메서드 선택 가이드
- 페이지 요청:
DetectPage()메서드 사용 - API 요청:
DetectApi()메서드 사용 - 두 메서드는 각각 다른 탐지 로직을 적용합니다.
설치 방법
BotManager .NET Agent는 DLL 파일을 프로젝트에 추가하여 설치합니다.
자세한 설치 방법은 설치 및 초기화를 참조하세요.
설정 옵션
BotManager .NET 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 콘솔에서 확인할 수 있습니다.