---
title: "CDNetworks Edge Application 연동 가이드"
description: "본 문서에서는 CDNetworks Edge Application을 사용하여 도브러너의 CDN 임베더를 구성하고 배포하는 방법을 설명합니다."
---
> For the complete documentation index, see [llms.txt](https://docs.doverunner.com/llms.txt).

CDN 임베더는 CDNetworks Edge Application을 활용하여 콘텐츠 전송 네트워크를 통해 포렌식 워터마크가 적용된 콘텐츠를 제공합니다. 
이 가이드는 도브러너 포렌식 워터마킹 구현을 위한 임베더 구성 및 배포 과정을 안내합니다.

샘플 코드는 GitHub에서 확인할 수 있습니다.
[CDNetworks Embedder 샘플](https://github.com/doverunner/fwm-cdn-embedder-cdnetworks-edge-application)

CDN 임베더의 역할은 다음과 같습니다:
- **세션 관리자**가 발급한 워터마크 토큰 검증  
- 올바른 **워터마크 파일 경로** 확인 (사용자/세션/변형 기반)  
- CDN 도메인의 오리진에서 파일을 가져와 도메인을 통해 제공  

주요 구성은 다음을 통해 수행됩니다:
- `config.js` – 워터마크 토큰 및 폴더 구조 구성  

## 구성

#### 소스 구성 (`config.js`)

배포에 적합한 설정으로 `config.js` 파일을 업데이트하는 것부터 시작하세요:

```javascript
export const config = {
  "aesKey": "YOUR_DOVERUNER_SITE_KEY",
  "type": "unlabeled_a_variant",
  "availableInterval": 60,
  "prefixFolder": ["folder1", "folder2"],
  "wmtPublicKey": "YOUR_PUBLIC_KEY", // Akamai WMT용 PEM 형식 공개 키
  "wmtPassword": "YOUR_PASSWORD" // WMT 토큰 생성/검증을 위한 비밀번호
}
```

#### 구성 매개변수

| 매개변수 | 토큰 유형 | 설명 |
|---------|---------|------|
| `aesKey` | AES | 도브러너 콘텐츠 보안 서비스에서 발급한 사이트 키 |
| `type` | AES, JWT | 워터마크 토큰 요청 사양 유형. 기본값: `unlabeled_a_variant` |
| `availableInterval` | AES | 토큰 유효 기간(분 단위, 무제한 유효성을 위해 `0`으로 설정) |
| `prefixFolder` | AES | 워터마크된 파일이 포함된 최상위 폴더 배열. 워터마크 토큰 요청 사양의 `prefix_folder`에 해당 |
| `wmtPublicKey` | JWT | Akamai WMT 통합을 위한 PEM 형식 공개 키 |
| `wmtPassword` | JWT | WMT 토큰 생성 및 검증을 위한 비밀번호 자격 증명 |

:::info
`wmt_type` 매개변수는 워터마크 토큰이 AES 암호화를 사용할지 JWT 형식을 사용할지 결정합니다. 이는 도브러너에서 워터마크 토큰을 요청할 때 제공된 사양과 일치해야 합니다.
:::

## 배포

### 사전 요구사항

배포를 진행하기 전에 다음 사항을 확인하세요:

- Edge Application이 활성화된 CDNetworks 계정
- 워터마크된 콘텐츠를 오리진에 저장한 CDN 도메인
- 개발 머신에 설치된 Node.js 및 npm

### 1단계: 함수 빌드

Edge Application은 함수를 `index.js` 파일 하나로 받습니다. 샘플 디렉터리에서 함수를 빌드하세요:

```bash
npm install
npm run bundle
```

이 명령은 번들된 함수를 `dist/index.js`에 생성합니다. 같은 번들이 각 [GitHub 릴리스](https://github.com/doverunner/fwm-cdn-embedder-cdnetworks-edge-application/releases/latest)에 zip 파일로도 첨부되어 있습니다. 이 파일을 사용하는 경우에는 그 안의 `index.js` 맨 위에 있는 `config` 객체에 값을 설정하세요.

### 2단계: 함수 생성

1. **Edge Application** > **Function List**에서 템플릿 없이 함수를 생성합니다.
2. CloudIDE에서 `index.js`를 번들된 `index.js`로 교체합니다.
3. **save and test**를 클릭해 코드를 커밋합니다.

### 3단계: 배포 및 트리거 추가

1. **Grayscale Deployment**에서 함수를 배포하고, 배포 기록의 버전이 바뀌었는지 확인합니다.
2. **Trigger List** > **Add**에서 도메인을 선택하고 워터마크 폴더에 대한 경로 조건(예: `/wm-contents/*`)을 추가한 뒤 함수를 선택합니다.

## 워터마크 파일 폴더 구조

`prefixFolder` 구성 매개변수에 지정된 폴더 구조에 따라 CDN 도메인의 오리진에 워터마크가 적용된 콘텐츠를 구성하세요. 최상위 폴더는 워터마크 토큰 요청 사양에 정의된 `prefix_folder` 값과 일치해야 합니다.

## 추가 리소스

- [CDNetworks Edge Application 문서](https://documents.cdnetworks.com/document/edgeapplication/ea-overview)
- [트리거 추가](https://documents.cdnetworks.com/document/edgeapplication/add-triggers)
- [도브러너 포렌식 워터마킹 임베딩 문서](https://docs.doverunner.com/content-security/forensic-watermarking/embedding/)

## 지원

CDN 임베더 구성 또는 배포에 대한 추가 지원이 필요한 경우 [도브러너 지원팀에 문의](https://support.doverunner.com/)하거나 포렌식 워터마킹 임베딩 문서를 참조하세요.