본문으로 건너뛰기

설치 및 초기화

사전 요구사항​

BotManager .NET Agent를 사용하기 전에 아래 사항을 확인하세요.

  1. .NET 버전

    • 최소 .NET 4.0 이상 필요
    • .NET 4.0 ~ 4.8 버전 지원

  2. 애플리케이션 아키텍처

    • Windows 기반의 .NET 환경
    • HTTP 또는 HTTPS를 사용하는 환경

  3. 서버 설정

    • 서버에서 외부로의 HTTP/HTTPS 통신이 가능해야 합니다
    • 매크로 탐지 서버와 통신을 위해 https://botmanager.stclab.com로의 네트워크 접근 필요

설치 방법​

1. 도메인 선택​

에이전트를 설치할 도메인을 선택하고 BotManager 콘솔에서 설정 값을 확인하세요.

2. ZIP 파일 다운로드​

최신 ZIP 파일을 아래 링크에서 다운로드합니다:

다운로드 링크

3. DLL 파일을 프로젝트에 추가​

다운로드한 botmanager-dotnet-agent.zip 파일의 BotManagerDotNetAgent.dll 파일을 프로젝트에 직접 추가합니다. Newtonsoft.Json.dll 파일의 경우 11.0.1 버전이며, 기존에 사용하시는 다른 버전의 파일이 없을 경우에만 추가하시면 됩니다.

파일 복사: BotManagerDotNetAgent.dll 파일을 프로젝트의 bin 폴더 (bin|bin/Debug|bin/Release)에 dll 파일을 복사합니다. 복사 후 참조를 통하여 해당 라이브러리를 추가합니다.

Newtonsoft.Json.dll 파일 적용 시 Web.config 파일에 다음과 같이 추가합니다.

다운로드 받은 파일을 적용할 경우​

<runtime> 
  <assemblyBinding> 
    <dependentAssembly>
      <assemblyIdentity name="Newtonsoft.Json" publicKeyToken="30ad4fe6b2a6aeed"/>
      <bindingRedirect oldVersion="0.0.0.0-11.0.0.1" newVersion="11.0.0.1"/>
    </dependentAssembly>
  </assemblyBinding>
</runtime>

상위 버전의 파일을 사용 중일 경우​

<runtime> 
  <assemblyBinding> 
    <dependentAssembly>
      <assemblyIdentity name="Newtonsoft.Json" publicKeyToken="30ad4fe6b2a6aeed"/>
      <bindingRedirect oldVersion="0.0.0.0-13.0.0.0" newVersion="12.0.0.0"/>
    </dependentAssembly>
  </assemblyBinding>
</runtime>

<bindingRedirect oldVersion="0.0.0.0-13.0.0.0" newVersion="12.0.0.0"/> oldVersion, newVersion 값을 기존에 사용하시는 버전으로 맞춰 주시면 됩니다.

4. 초기화​

BotManager를 사용하려면 초기화가 필요합니다. 아래 코드를 참고하여 애플리케이션 초기화 시점에 설정을 추가하세요.

코드 예제:

using System.Web;
using System.Web.Mvc;
using System.Web.Routing;
using BotManagerDotNetAgent.Domain;
using BotManagerDotNetAgent.Config;

namespace MyApplication
{
    public class MvcApplication : HttpApplication
    {
        protected void Application_Start()
        {
            BotManager.Initialize(new BotManagerConfig.Builder()
                .TenantId("{tenant-id}") // 고객사 식별 ID
                .DomainName("{domain-name}") // 요청 도메인
                .ServerUrl("https://botmanager.stclab.com/api/v1/macro") // 탐지 서버
                .ProtectionUrl("https://cdn-botmanager.stclab.com") // 차단 페이지 URL
                .HttpRequestTimeout(1000) // HTTP 요청 타임아웃 (ms)
                .LogLevel("ERROR") // 로그 레벨
                .Build());
        }
    }
}

customId 설정​

customId는 서비스 페이지에서 사용자를 특정할 수 있는 값으로 명시할 수 있는 선택적 설정 값입니다.

예시:

  • 로그인 인증을 통해 로그인한 경우 사용자 아이디
  • 로그인 인증을 통해 로그인한 경우 세션 값

주요 기능 및 이점​

  1. BotManager 접속자 관리 콘솔 통합:

    • customId를 설정하면 서비스 내에서 확인 가능한 특정 사용자 기준으로 탐지 정보를 확인할 수 있습니다.

  2. 다중 기기 차단:

    • 동일한 customId를 사용하는 사용자가 여러 기기를 통해 접속할 경우, 차단 설정이 해당 기기들에도 동일하게 적용됩니다.
    • 이를 통해 차단된 사용자의 다중 기기 사용을 방지할 수 있습니다.

다음 단계​

설치가 완료되면 다음 문서를 참조하세요: