설치 및 초기화

이 가이드는 NetFUNNEL Akamai 에이전트의 설치 및 초기화 과정을 설명합니다.

---

1단계: Client ID 가져오기

1. NetFUNNEL 콘솔로 이동
2. 우측 상단의 프로필 아이콘 클릭
3. 통합 자격 증명 (Integration Credentials) 메뉴 선택
4. Client ID 복사

Client ID 확인 위치

콘솔 화면 우측 상단의 프로필 아이콘을 클릭한 후, 통합 자격 증명 메뉴에서 확인할 수 있습니다.

---

2단계: EdgeWorker 생성

EdgeWorker 생성

1. Akamai 콘솔 → [EdgeWorkers] 메뉴 클릭
2. [Create EdgeWorker ID] 클릭
3. 내용 입력 후 [Create EdgeWorker ID] 클릭하여 EdgeWorker 생성
4. 생성한 EdgeWorker 선택 후 [Create version] 클릭
5. [Open editor] 클릭

에이전트 코드 업로드

1. https://agent-lib.stclab.com/agents/cdn/akamai/netfunnel-akamai-agent-latest.js 에서 netfunnel-akamai-agent.js 파일 다운로드
2. [Code Bundle] 탭에서 main.js 파일 선택
3. netfunnel-akamai-agent.js 파일의 내용을 붙여넣기
4. bundle.json 파일 선택 후 아래 코드 작성:

{
    "edgeworker-version": "1.0.0",
    "description" : "akamai-agent-1.0.0"
}

5. [Create new version] 클릭하여 버전 생성

EdgeWorker 배포

1. [Activate version] 클릭
2. [Production] 선택 후 [Activate version] 클릭하여 배포
3. 배포 완료 후 Current Status가 Complete가 되면 완료

---

3단계: Property 생성 (선택 사항)

이미 생성한 Property가 있다면 다음 단계로 넘어가세요.

1. [Properties] 메뉴 클릭
2. [New Property] 클릭
3. [Create Property] 클릭
4. [Guide me] 클릭
5. 내용 입력 후 [Next] 버튼 클릭
6. Hostname 값 확인 후 [Next] 버튼 클릭
7. STEP1: 내용 입력, [Validate] 클릭, EDGE CERTIFICATE 선택
8. [Continue] 클릭, 캐시 설정 후 [Next] 클릭
9. STEP2: [Next] 클릭
10. STEP3: [Activate] 클릭, 진행 완료 후 [Next] 클릭
11. STEP4: [Next] 클릭
12. STEP5: [Exit] 클릭하여 Property 생성 완료

---

4단계: Property 설정

Property 선택

1. [Properties] 메뉴 클릭
2. 생성한 Property 선택
3. 수정할 버전 선택 (가장 위에 있는 버전)

Property Variables 설정

아래 표를 참고하여 Property Variables를 추가합니다.

VARIABLE NAME	INITIAL VALUE
NF_CLIENT_ID	{{CLIENT_ID}}

CLIENT_ID는 NetFUNNEL 콘솔에서 확인하세요.

Property Configuration Settings 설정

EdgeWorker Rule 추가

1. Property Configuration Settings에서 [+Rules] 클릭
2. [Blank Rule Template] 선택 후 "NF EdgeWorker" 입력
3. [Insert Rule] 클릭
4. Criteria에서 [+Match] 클릭:
   • Path: matches one of → /*
5. [+Match] 추가:
   • File Extension: is not one of → HTML 파일 제외, 정적 파일 확장자 제외
   • 제외할 확장자: woff, woff2, ttf, eot, otf, sfnt, svg, webp, avif, map, mp4, webm, ogg, ogv, flac, acc, docx, xls, xlsx, ppt, pptx, csv, xml, json
6. Behaviors에서 [+Behavior] 클릭 → Standard property behavior 선택
7. EdgeWorkers 선택 후 [Insert Behavior] 클릭
8. Identifier에서 생성한 EdgeWorker 선택

Core Origin Rule 추가

1. [+Rules] 클릭
2. [Blank Rule Template] 선택 후 "NF Core Origin" 입력
3. [Insert Rule] 클릭
4. Criteria에서 [+Match] 클릭:
   • Path: matches one of → /ts.wseq
5. Behaviors에서 [+Behavior] 클릭 → Standard property behavior 선택
6. Origin Server 선택 후 [Insert Behavior] 클릭
7. 아래 표를 참고하여 설정:

항목	값
Origin Type	Your Origin
Origin Server Hostname	{CLIENT_ID}.netfunnel.stclab.com (예: stclab-0601.netfunnel.stclab.com)
Forward Host Header	Origin Hostname
Cache Key Hostname	Origin Hostname

Setting Origin Rule 추가

1. [+Rules] 클릭
2. [Blank Rule Template] 선택 후 "NF Setting Origin" 입력
3. [Insert Rule] 클릭
4. Criteria에서 [+Match] 클릭:
   • Path: matches one of → {{NF_SETTING_URL}}의 Path (예: /stclab-0601.netfunnel/nf-setting.json)
5. Behaviors에서 [+Behavior] 클릭 → Standard property behavior 선택
6. Origin Server 선택 후 [Insert Behavior] 클릭
7. 아래 표를 참고하여 설정:

항목	값
Origin Type	Your Origin
Origin Server Hostname	nf-setting-bucket.stclab.com
Forward Host Header	Origin Hostname
Cache Key Hostname	Origin Hostname

---

5단계: Property 저장 및 활성화

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

---

다음 단계

• 초기화 설정: Property Variables 및 부가 기능 설정
• 문제 해결: 일반적인 문제 및 해결 방법