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

초기화 설정

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

Property Variables​

Property Variables는 Akamai Property에서 설정하는 변수로, NetFUNNEL 에이전트의 동작을 제어합니다.

필수 설정​

NF_CLIENT_ID​

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

VARIABLE NAMEINITIAL VALUE설명
NF_CLIENT_ID{{CLIENT_ID}}NetFUNNEL 콘솔에서 확인한 Client ID

설정 방법:

  1. Property 선택
  2. Property Variables에서 [+Add Variable] 클릭
  3. Variable Name: NF_CLIENT_ID
  4. Initial Value: NetFUNNEL 콘솔의 Client ID 입력
  5. [Save] 클릭

부가 기능​

Good Bot 예외 처리​

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

Property 설정​

  1. EdgeWorker가 적용되어 있는 Property 선택
  2. Property Configuration Settings에서 NF EdgeWorker 선택
  3. Criteria에서 [+Match] 클릭
  4. User Agent, is not one of 선택
  5. 예외하고 싶은 굿 봇의 User-Agent 추가 (예: Googlebot, Bingbot, Slurp, Applebot, facebookexternalhit)
  6. 우측 하단의 [Save] 버튼 클릭
  7. 상단의 [Activate] 탭 클릭
  8. Production Network에서 [Activate {version} on Production] 클릭
  9. Verifying 완료 후 경고 메시지 박스 체크
  10. [Activate {version} on Production] 클릭

진입 키 자동 반납 처리​

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

Property Variables 설정​

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

설정 방법:

  1. Property Variables에서 [+Add Variable] 클릭
  2. Variable Name: NF_RETURN_KEY
  3. Initial Value: true 또는 false
  4. [Save] 클릭
  5. Property 활성화

대기실 도메인 변경​

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

Property Variables 설정​

VARIABLE NAMEINITIAL VALUE설명
NF_VWR_PAGE_DOMAINhttp(s)://{CNAME_DOMAIN}대기실 도메인 URL

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

설정 방법:

  1. Property Variables에서 [+Add Variable] 클릭
  2. Variable Name: NF_VWR_PAGE_DOMAIN
  3. Initial Value: 변경하고자 하는 대기실 도메인 URL 입력 (예: https://wait.stclab.com)
  4. [Save] 클릭
  5. Property 활성화

쿠키 도메인 설정​

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

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

Property Variables 설정​

VARIABLE NAMEINITIAL VALUE설명
NF_COOKIE_DOMAIN.{MAIN_DOMAIN}쿠키 도메인

예시: .stclab.com

설정 방법:

  1. Property Variables에서 [+Add Variable] 클릭
  2. Variable Name: NF_COOKIE_DOMAIN
  3. Initial Value: 메인 도메인 형식으로 입력 (예: .stclab.com)
  4. [Save] 클릭
  5. Property 활성화

Property 활성화​

Property Variables를 변경한 후에는 반드시 Property를 활성화해야 변경 사항이 적용됩니다.

  1. 우측 하단의 [Save] 버튼 클릭
  2. 상단의 [Activate] 탭 클릭
  3. Production Network에서 [Activate {version} on Production] 클릭
  4. Verifying 완료 후 상단의 경고 메시지 박스 체크
  5. [Activate {version} on Production] 클릭

관련 문서​