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

초기화 설정

이 문서는 NetFUNNEL Fastly Agent에서 사용할 수 있는 Config Store 설정 및 부가 기능을 설명합니다.

Config Store 설정​

Config Store를 통해 NetFUNNEL 에이전트의 동작을 제어합니다.

필수 설정​

CLIENT_ID​

NetFUNNEL 콘솔에서 발급받은 클라이언트 ID를 입력합니다.

KeyValue
CLIENT_ID{'{CLIENT_ID}'}

설정 방법:

  1. Resources 메뉴 → Config stores 이동
  2. 에이전트에서 사용 중인 store 선택
  3. [Add item] 클릭
  4. Key: CLIENT_ID, Value: NetFUNNEL 콘솔의 Client ID 입력
  5. [Add] 클릭
  6. Compute purge 수행

부가 기능​

Good Bot 예외 처리​

Config Store 설정을 통해 특정 User-Agent 값이 포함되어 있을 경우 에이전트 동작으로부터 예외 처리할 수 있습니다.

Config Store 설정​

KeyValue
GOOD_BOTSGooglebot, Bingbot, Slurp, Applebot, facebookexternalhit

예시: Google, Microsoft, Yahoo, Apple, Facebook 봇을 예외 처리한 예시입니다.

설정 방법:

  1. Resources 메뉴 → Config stores 이동
  2. 에이전트에서 사용 중인 store 선택
  3. [Add item] 클릭
  4. Key: GOOD_BOTS, Value: 예외하고 싶은 굿 봇의 User-Agent를 쉼표로 구분하여 입력
  5. [Add] 클릭
  6. Compute purge 수행

Compute Purge​

  1. Compute 메뉴 → Compute Services 이동
  2. 에이전트를 적용한 service 선택
  3. [Purge] 클릭
  4. [Purge all] 선택
  5. service name 입력
  6. [Purge all] 버튼 클릭

진입 키 자동 반납 처리​

NetFUNNEL Fastly 에이전트는 진입 후 넷퍼넬 키를 자동으로 반납하여 다음 대기자가 진입할 수 있도록 처리하고 있습니다. 만약, 넷퍼넬 키를 바로 반납하지 않고 세그먼트에서 설정한 타임아웃 시간에 넷퍼넬 키를 반납하고 싶은 경우에 사용할 수 있는 기능입니다.

Config Store 설정​

KeyValue
RETURN_KEYtrue
  • true (기본값): 대기 완료 및 진입 후 에이전트에서 넷퍼넬 키를 자동으로 반납합니다.
  • false: 세그먼트에서 설정한 타임아웃 시간에 키가 반납 처리됩니다.

설정 방법:

  1. Resources 메뉴 → Config stores 이동
  2. 에이전트에서 사용 중인 store 선택
  3. [Add item] 클릭
  4. Key: RETURN_KEY, Value: true 또는 false 입력
  5. [Add] 클릭
  6. Compute purge 수행

Compute Purge​

  1. Compute 메뉴 → Compute Services 이동
  2. 에이전트를 적용한 service 선택
  3. [Purge] 클릭
  4. [Purge all] 선택
  5. service name 입력
  6. [Purge all] 버튼 클릭

대기실 도메인 변경​

NetFUNNEL 대기실 페이지의 도메인은 agent-lib.stclab.com입니다. 해당 도메인을 서비스 중인 도메인에 맞게 변경하려면 NetFUNNEL 서비스팀을 통해 원하는 도메인을 알려주시고, Config Store 설정을 변경해야 합니다.

Config Store 설정​

KeyValue
VWR_PAGE_DOMAINhttp(s)://{'{CNAME_DOMAIN}'}

예시: https://wait.stclab.com

설정 방법:

  1. Resources 메뉴 → Config stores 이동
  2. 에이전트에서 사용 중인 store 선택
  3. [Add item] 클릭
  4. Key: VWR_PAGE_DOMAIN, Value: 변경하고자 하는 대기실 주소 입력
  5. [Add] 클릭
  6. Compute purge 수행

Compute Purge​

  1. Compute 메뉴 → Compute Services 이동
  2. 에이전트를 적용한 service 선택
  3. [Purge] 클릭
  4. [Purge all] 선택
  5. service name 입력
  6. [Purge all] 버튼 클릭

쿠키 도메인 설정​

NetFUNNEL 서버에서 발급한 키를 쿠키에 저장할 때 현재 페이지의 도메인을 기준으로 저장합니다. 만약 서로 다른 서브도메인 간에 키를 공유해야할 경우 메인 도메인이 쿠키에 저장되도록 설정합니다.

예: develop.stclab.com과 staging.stclab.com과 같이 서브도메인이 서로 다른 페이지에서 쿠키를 공유하도록 .stclab.com으로 설정합니다.

Config Store 설정​

KeyValue
COOKIE_DOMAIN.{'{MAIN_DOMAIN}'}

예시: .stclab.com

설정 방법:

  1. Resources 메뉴 → Config stores 이동
  2. 에이전트에서 사용 중인 store 선택
  3. [Add item] 클릭
  4. Key: COOKIE_DOMAIN, Value: .MAIN_DOMAIN 형식으로 입력
  5. [Add] 클릭
  6. Compute purge 수행

Compute Purge​

  1. Compute 메뉴 → Compute Services 이동
  2. 에이전트를 적용한 service 선택
  3. [Purge] 클릭
  4. [Purge all] 선택
  5. service name 입력
  6. [Purge all] 버튼 클릭

Config Store 변경 후 Compute Purge​

Config Store를 변경한 후에는 반드시 Compute Purge를 수행해야 변경 사항이 적용됩니다.

  1. Compute 메뉴 → Compute Services 이동
  2. 에이전트를 적용한 service 선택
  3. [Purge] 클릭
  4. [Purge all] 선택
  5. service name 입력
  6. [Purge all] 버튼 클릭

관련 문서​