빠른 시작

이 빠른 시작 가이드로 5-10분 안에 NetFUNNEL 4 CloudFront Agent를 시작하세요.

---

사전 요구사항

• NetFUNNEL 콘솔 액세스
• AWS 계정 및 Lambda@Edge 지원
• CloudFront Distribution 생성 및 관리 권한
• IAM 역할 생성 및 정책 첨부 권한

---

1단계: Client ID 가져오기

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

---

2단계: IAM 역할 생성

1. AWS IAM 콘솔 → [역할] 클릭
2. [역할 생성] 클릭
3. 신뢰할 수 있는 엔터티: AWS 서비스 선택
4. 사용 사례: Lambda 선택
5. [다음: 권한] 클릭

Trust Entity 설정

1. 역할 생성 후 [Trust Entity] 탭 클릭
2. Trust Entity 편집 후 아래 JSON 붙여넣기:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": [
          "edgelambda.amazonaws.com",
          "lambda.amazonaws.com"
        ]
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

정책 첨부

1. [권한] 탭 클릭
2. [권한 추가] → [인라인 정책 만들기] 클릭
3. JSON 탭에 아래 정책 붙여넣기:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "logs:CreateLogGroup",
        "logs:CreateLogStream",
        "logs:PutLogEvents"
      ],
      "Resource": "*"
    }
  ]
}

---

3단계: Lambda 함수 생성

Lambda 함수 생성

1. us-east-1 리전의 Lambda 콘솔로 이동 (필수)
2. [함수 생성] 클릭
3. [처음부터 작성] 선택
4. 함수 이름 입력 (예: "netfunnel-agent")
5. 런타임: Node.js 선택
6. 위에서 생성한 IAM 역할 선택
7. [함수 생성] 클릭

Lambda 함수 설정

1. https://agent-lib.stclab.com/agents/cdn/cloudfront/netfunnel-cloudfront-agent-latest.js 에서 netfunnel-cloudfront-agent.js 파일 다운로드
2. [코드] 탭에서 코드 소스에 netfunnel-cloudfront-agent.js 파일 업로드
3. index.mjs 파일 열고 아래 코드 작성:

import handleEvent from './netfunnel-cloudfront-agent.js';
const config = {
  clientID: "{{CLIENT_ID}}",
}
export const handler = async (event) => {
  return await handleEvent(event, config)
};

4. package.json 파일 생성 후 아래 코드 붙여넣기:

{
    "name": "cloudfront-agent",
    "type": "module",
    "dependencies": {}
}

5. [Deploy] 버튼 클릭
6. [버전] 탭 → [새 버전 발행] 클릭

---

4단계: CloudFront 설정

Lambda@Edge 연결

1. Lambda@Edge를 적용할 CloudFront Distribution 선택
2. [동작] 탭에서 항목 선택 후 [편집] 클릭
3. 하단의 함수 연결에서:
   • 뷰어 요청: 생성한 Lambda 함수 ARN 입력 (버전 포함, 예: :1)
   • 뷰어 응답: 생성한 Lambda 함수 ARN 입력 (버전 포함, 예: :1)
4. [변경 사항 저장] 클릭

CloudFront 무효화

1. [무효화] 탭 클릭
2. [무효화 생성] 클릭
3. 객체 경로: /* 입력
4. [무효화 생성] 클릭
5. 무효화 완료 후 Lambda@Edge 연결 적용

---

다음 단계

• 설치 및 초기화: 상세한 설정 가이드
• 초기화 설정: Lambda config 및 부가 기능 설정