본문으로 건너뛰기

설치 및 초기화

BotManager Browser Agent는 다음 두 가지 방식으로 설치할 수 있습니다.

사전 준비​

에이전트를 설치하기 전에 BotManager 콘솔에서 다음 정보를 확인하세요:

  1. 도메인 선택: 에이전트를 설치할 도메인을 선택합니다.
  2. 설정 값 확인: 콘솔에서 제공하는 다음 값들을 확인합니다:
    • TENANT_ID: 고객사 식별 ID
    • DOMAIN: 도메인 이름
    • ENGINE_URL: 탐지 서버 URL
    • AGENT_URL: 에이전트 파일 URL

설치 방법​

방법 1: HTML 파일에 직접 삽입​

페이지의 <head> 태그에 직접 설치 코드를 삽입합니다. 이는 간단하고 빠르게 적용할 수 있는 방법입니다.

아래는 예제 코드입니다. {} 괄호 내의 값은 고객 전용 콘솔에서 자동 생성되어 제공됩니다.

<script>
  (function(cfg) {
    cfg.tenantId = '{{ TENANT_ID }}';
    cfg.domainName = '{{ DOMAIN }}';
    cfg.customId = '{{ USER_CUSTOM_ID }}';  // optional
    cfg.serverUrl = '{{ ENGINE_URL }}/api/v1/macro';
  })(window['BotManager-config'] || (window['BotManager-config'] = {}));
</script>
<script src="{{ AGENT_URL }}/agents/client/javascript/botmanager-browser-agent.js" async></script>

방법 2: 공통 JavaScript 파일에 삽입​

사이트에서 공통으로 사용하는 JavaScript 파일에 설치 코드를 추가하여 적용할 수 있습니다. 이 방법은 유지보수 및 관리 측면에서 효율적입니다.

// 공통 JavaScript 파일에 삽입
(function(cfg) {
  cfg.tenantId = '{{ TENANT_ID }}';
  cfg.domainName = '{{ DOMAIN }}';
  cfg.customId = '{{ USER_CUSTOM_ID }}'; // optional
  cfg.serverUrl = '{{ ENGINE_URL }}/api/v1/macro';
})(window['BotManager-config'] || (window['BotManager-config'] = {}));

// 라이브러리 다운로드 및 실행
var scriptBM = document.createElement('script');
scriptBM.src = '{{ AGENT_URL }}/agents/client/javascript/botmanager-browser-agent.js';
scriptBM.async = true;
document.head.appendChild(scriptBM);

customId 설정​

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

예시:

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

주요 기능 및 이점​

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

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

  2. 다중 기기 차단:

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

초기화 확인​

설치가 완료되면 브라우저 콘솔에서 다음을 확인할 수 있습니다:

// BotManager 객체가 전역에 로드되었는지 확인
console.log(window.BotManager); // BotManager 객체가 출력되어야 합니다

다음 단계​

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