본문으로 건너뛰기
버전: 4.6.1-saas

초기화 설정

이 문서는 NetFunnelInitialize에서 사용할 수 있는 모든 초기화 설정을 설명합니다.

필수 매개변수​

초기화 설정에는 clientId와 secretKey 매개변수가 필요합니다.

Client ID 및 Secret Key 가져오기

Client ID와 Secret Key를 가져오는 방법과 초기화 예제는 빠른 시작 문서를 참조하세요.

기본 초기화​

필수 매개변수만 사용​

NetFunnelInitialize config = NetFunnelInitialize.Companion.builder()
    .clientId("{{CLIENT_ID}}")
    .secretKey("{{SECRET_KEY}}")
    .build();

초기화 설정 매개변수​

필드타입기본값설명에이전트 버전
clientIdStringN/A콘솔에서 발급받은 클라이언트 아이디를 입력합니다.4.0.1 이상
secretKeyStringN/A콘솔에서 발급받은 암호화 키를 입력합니다.4.0.1 이상
serverUrlStringN/ANetFUNNEL 서버의 URL입니다. CNAME을 사용하지 않고, clientId 기반의 URL 조합이 아닌 별도의 URL로 서버에 접근할 때 사용합니다. (기존 방식과의 호환성을 위해 지원됩니다.)4.0.1 이상
settingUrlStringN/ANetFUNNEL 환경설정 파일의 URL입니다. CNAME을 사용하지 않고, clientId 기반의 URL 조합이 아닌 별도의 URL로 설정 파일을 불러올 때 사용합니다. (기존 방식과의 호환성을 위해 지원됩니다.)4.0.1 이상
vwrPageUrlStringN/ANetFUNNEL VWR Page의 URL입니다. CNAME을 사용하지 않고, clientId 기반의 URL 조합이 아닌 별도의 URL로 대기실 페이지에 진입해야 할 때 지정합니다.4.0.1 이상
returnKeybooleantrue사용자가 대기열을 통과해 페이지에 진입하면 즉시 다음 사용자가 입장할 수 있습니다. 옵션을 비활성화하면, 사용자가 페이지에 진입한 뒤에도 일정 시간동안 다음 사용자가 대기하게 됩니다. (타임아웃 설정은 콘솔의 세그먼트 설정 > 고급설정에서 가능합니다.)4.0.1 이상
logLevelLevelLevel.OFFch.qos.logback.classic.Level을 기반으로 로그 레벨을 설정하므로, 해당 의존성 추가가 필요합니다. 사용 가능 레벨: ERROR, WARN, INFO, DEBUG, TRACE, OFF4.0.1 이상
goodBotsArray<String>N/A선의의 봇(검색엔진 등)이 NetFUNNEL 진입 요청에서 제외되도록 설정합니다. 문자열의 배열로 값을 받습니다. 예시: ["Googlebot", "Bingbot"]4.0.1 이상
userIdStringN/A이 값을 입력하면 화이트리스트 및 영구 차단 사용자 구분에 ID가 사용됩니다. 콘솔의 반복 요청 차단 > 사용자 설정 > 접속자 관리에서 설정한 ID가 적용됩니다.4.0.1 이상
vwrPageDomainStringN/ACNAME 도메인만으로 VWR Page URL을 구성할 때 사용합니다. 예시: https://vwr.example.com4.0.1 이상
cookieDomainStringN/A발급되는 NetFUNNEL 쿠키의 도메인(Domain) 값을 직접 지정할 수 있습니다.4.0.1 이상

설정 예제​

기본 설정​

NetFunnelInitialize config = NetFunnelInitialize.Companion.builder()
    .clientId("{{CLIENT_ID}}")
    .secretKey("{{SECRET_KEY}}")
    .build();

로그 레벨 설정​

import ch.qos.logback.classic.Level;

NetFunnelInitialize config = NetFunnelInitialize.Companion.builder()
    .clientId("{{CLIENT_ID}}")
    .secretKey("{{SECRET_KEY}}")
    .logLevel(Level.INFO)
    .build();

Good Bot 예외 처리​

NetFunnelInitialize config = NetFunnelInitialize.Companion.builder()
    .clientId("{{CLIENT_ID}}")
    .secretKey("{{SECRET_KEY}}")
    .goodBots(new String[]{"Googlebot", "Bingbot", "Slurp", "Applebot", "facebookexternalhit"})
    .build();

사용자 식별 설정​

NetFunnelInitialize config = NetFunnelInitialize.Companion.builder()
    .clientId("{{CLIENT_ID}}")
    .secretKey("{{SECRET_KEY}}")
    .userId("{{USER_ID}}")
    .build();

진입 키 자동 반납 비활성화​

NetFunnelInitialize config = NetFunnelInitialize.Companion.builder()
    .clientId("{{CLIENT_ID}}")
    .secretKey("{{SECRET_KEY}}")
    .returnKey(false)
    .build();

대기실 도메인 변경​

NetFunnelInitialize config = NetFunnelInitialize.Companion.builder()
    .clientId("{{CLIENT_ID}}")
    .secretKey("{{SECRET_KEY}}")
    .vwrPageDomain("https://wait.example.com")
    .build();

쿠키 도메인 설정​

NetFunnelInitialize config = NetFunnelInitialize.Companion.builder()
    .clientId("{{CLIENT_ID}}")
    .secretKey("{{SECRET_KEY}}")
    .cookieDomain(".example.com")
    .build();

완전한 구성 예제​

import ch.qos.logback.classic.Level;

NetFunnelInitialize config = NetFunnelInitialize.Companion.builder()
    // 필수
    .clientId("{{CLIENT_ID}}")
    .secretKey("{{SECRET_KEY}}")
    
    // 서버 구성 (선택사항)
    .serverUrl("https://custom-server.example.com")
    .settingUrl("https://custom-setting.example.com")
    .vwrPageUrl("https://custom-vwr.example.com")
    
    // 대기실 설정
    .vwrPageDomain("https://wait.example.com")
    .cookieDomain(".example.com")
    
    // 키 관리
    .returnKey(true)
    
    // 로깅
    .logLevel(Level.INFO)
    
    // 봇 예외 처리
    .goodBots(new String[]{"Googlebot", "Bingbot"})
    
    // 사용자 식별
    .userId("{{USER_ID}}")
    .build();

매개변수 유효성 검사​

clientId​

  • 필수
  • 유형: String
  • 유효성 검사: 빈 문자열일 수 없음
  • 소스: NetFUNNEL 콘솔 → 프로필 아이콘 → 통합 자격 증명 (Integration Credentials)

secretKey​

  • 필수
  • 유형: String
  • 유효성 검사: 빈 문자열일 수 없음
  • 소스: NetFUNNEL 콘솔 → 프로필 아이콘 → 통합 자격 증명 (Integration Credentials)

logLevel​

  • 선택
  • 유형: ch.qos.logback.classic.Level
  • 기본값: Level.OFF
  • 사용 가능 레벨: ERROR, WARN, INFO, DEBUG, TRACE, OFF
  • 의존성: logback-classic 필요

goodBots​

  • 선택
  • 유형: String[]
  • 기본값: null
  • 예시: new String[]{"Googlebot", "Bingbot"}

returnKey​

  • 선택
  • 유형: boolean
  • 기본값: true
  • 동작: true인 경우 즉시 키 반납, false인 경우 타임아웃 설정에 따라 반납

관련 문서​