---
title: "포렌식 워터마킹 연동 워크플로우"
description: "이 문서는 `도브러너 포렌식 워터마킹` 연동에 필요한 전체 워크플로우와 각종 옵션들을 설명합니다."
---
> For the complete documentation index, see [llms.txt](https://docs.doverunner.com/llms.txt).

이 문서는 `도브러너 포렌식 워터마킹` 연동에 필요한 전체 워크플로우와 각종 옵션들을 설명합니다.

## 도브러너 포렌식 워터마킹 서비스

`도브러너 포렌식 워터마킹`은 복잡한 서버 환경을 구축하지 않고도 포렌식 워터마킹을 쉽고 빠르게 적용할 수 있는 클라우드 기반 서비스입니다.

콘텐츠 서비스에 도브러너 포렌식 워터마킹을 적용하는 데는 세 가지 단계가 있으며, 각 단계에는 선택할 수 있는 옵션이 있습니다.

## 1단계: 워터마킹 연동 준비

도브러너 포렌식 워터마킹 연동을 시작하려면 [도브러너 콘솔](https://console.doverunner.com/signup)에서 계정을 등록해야 합니다.

콘텐츠 패키징 및 CDN 연동 유형에 따라 아래와 같은 준비 과정을 수행합니다.

### 도브러너 트랜스코딩 & 패키징

도브러너는 AWS 기반 클라우드 시스템에서 `트랜스코딩`과 `콘텐츠 패키징`을 처리할 수 있는 SaaS 기반의 `트랜스코딩 & 패키징 (T&P) 서비스`를 제공합니다. 이 옵션을 선택하면 아래 준비가 필요합니다.

1. T&P 서비스를 실행할 AWS 리전을 설정
  - 도브러너 콘솔 사이트에서 원본 비디오를 업로드할 지역을 선택할 수 있습니다.

2. 패키징 작업을 위한 입/출력 스토리지 등록
  - 도브러너 콘솔 사이트에서 S3 버킷 이름, 액세스 키 및 비밀 키와 같은 정보를 입력하여 S3 스토리지를 등록합니다.
  - 패키징 입력과 출력에 대해 각각 다른 저장소를 설정할 수 있습니다.
  - 자세한 내용은 [트랜스코딩 & 패키징 서비스 가이드](https://docs.doverunner.com/ko/content-security/tnp/tnp-service-guide/)를 참조하시기 바랍니다.

> 트랜스코딩 & 패키징 서비스는 `출력 시간` 당 요금을 부과합니다. 자세한 내용은 [가격 정책 페이지](https://doverunner.com/kr/pricing/)를 확인하십시오.

### 아카마이 CDN 연동

콘텐츠 전송에 아카마이 CDN을 사용하는 경우, 사전 통합된 `Akamai Adaptive Media Delivery` 인터페이스를 도브러너 포렌식 워터마킹과 함께 사용할 수 있습니다.

1. 아카마이 계정 담당자에게 요청해 CDN 계약에 워터마킹 연동 기능을 추가합니다.

2. 도브러너 팀에 문의해 아래 구성에 필요한 토큰 서명 및 패턴 암호화 값을 전달받습니다.

3. [아카마이 가이드](https://techdocs.akamai.com/adaptive-media-delivery/docs/set-up-watermarking-in-your-amd-property)를 참고해 CDN 속성 구성에 워터마킹 동작을 추가합니다.

:::note 

Fastly CDN 연동 시에도 위 아카마이의 경우와 유사한 준비 과정이 필요합니다. Fastly CDN 연동에 대한 상세 안내가 필요한 경우 헬프데스크로 문의해 주시기 바랍니다.

:::

### 아마존 CloudFront 연동

CloudFront CDN을 사용하는 경우, CloudFront 엣지에 도브러너 Watermark Embedder 모듈을 설정해야 합니다. 자세한 내용은 [이 안내서](https://docs.doverunner.com/content-security/forensic-watermarking/embedding/cloudfront-embedder/)를 확인하십시오.

## 2단계: 워터마킹 전처리

이 단계에서는 하나의 원본 비디오에서 두 가지 버전(A/B variant)의 DASH/HLS 스트림을 생성합니다. 워터마킹 전처리 과정에는 아래와 같이 두 가지 옵션이 있습니다.

### 옵션 2-A: 도브러너 트랜스코딩 & 패키징

```mermaid
flowchart TB
  %% pa: 1=A 2=B 3=C 4=C>B
  subgraph grp_b["콘텐츠 서비스 사이트"]
    direction LR
    A@{ icon: "doverunner-video", form: "square", h: 72, label: "원본 영상" } --> B@{ icon: "doverunner-storage", form: "square", h: 72, label: "1. 아마존 S3 스토리지" }
  end
  subgraph grp_a["도브러너 T&P Service"]
    direction LR
    C@{ icon: "doverunner-server", form: "square", h: 72, label: "도브러너 T&P 서버 (3. 작업 수행)" }
  end
  B -->|2. 트랜스코딩 & 패키징 작업 생성| C
  C -->|4. A/B 버전 DASH/HLS 스트림| B
```

1. 원본 영상 업로드
  - 원본 콘텐츠 파일을 아마존 S3 스토리지에 업로드합니다.
  - 스토리지는 이전 단계에서 도브러너 콘솔에 등록되어 있어야 합니다.
 
2. 트랜스코딩 & 패키징 작업 생성
 - 도브러너 콘솔을 통해 도브러너 클라우드 시스템이 트랜스코딩 및 패키징 프로세스를 수행하게 합니다.
 - 해상도 별 옵션을 통해 어댑티브 스트림을 생성하거나 자막을 추가할 수 있습니다.
 - 자세한 방법은 [해당 가이드](https://docs.doverunner.com/ko/content-security/tnp/tnp-service-guide/)를 참고하시기 바랍니다.

3. 도브러너 클라우드 시스템에서의 전처리 및 패키징
 - 도브러너 클라우드의 T&P 서버는 원본 영상과 관련 파일들을 고객사 스토리지로부터 복사합니다.
 - T&P 서버는 트랜스코딩과 전처리 과정을 통해 원본 영상의 A/B 버전을 만들고, 각각 DASH/HLS 스트림으로 패키징된 결과를 출력 저장소에 저장합니다.

4. 패키징 결과를 CDN 오리진에 복사
 - 패키징 작업 완료 시 이메일 알림을 받거나 콘솔에서 확인 가능합니다.
 - 아마존 S3를 오리진 서버로 사용하는 경우, 이를 도브러너 `트랜스코딩 & 패키징`의 출력 스토리지로 설정할 수 있습니다. (결과물 복사 불필요)

### 옵션 2-B: 서드파티 인코더/트랜스코더 연동

워터마크 전처리는 인코딩 프로세스의 일부로 수행할 수 있습니다. 이를 위해서는 해당 솔루션 업체가 `도브러너 전처리 SDK`를 제품에 적용해 지원해야 합니다.

```mermaid
flowchart TB
  subgraph grp_b["인코더"]
    direction LR
    A@{ icon: "doverunner-video", form: "square", h: 72, label: "원본 영상" } -->|프레임 이미지| B@{ icon: "doverunner-plugin", form: "square", h: 72, label: "전처리 SDK" }
    B -->|0 또는 1로 마킹된 두벌 프레임| C@{ icon: "doverunner-variants", form: "square", h: 72, label: "인코딩 결과 (A/B 버전 비디오 파일)" }
  end
  subgraph grp_d["패키저"]
    direction LR
    D@{ icon: "doverunner-package", form: "square", h: 72, label: "DASH 또는 HLS 패키징" } --> E@{ icon: "doverunner-variants", form: "square", h: 72, label: "패키징 결과 (A/B 버전 스트림)" }
  end
  C --> D
```

1. 인코더에 도브러너 전처리 SDK 적용
 - 자세한 사항은 [해당 가이드](https://docs.doverunner.com/content-security/forensic-watermarking/preprocessing/preprocessor-library/)를 참고하시기 바랍니다.

2. 원본 영상을 A/B 버전 MP4 비디오로 인코딩
 - 하나의 원본 영상에 대해서 두 가지 버전의 MP4 파일이 생성됩니다.

3. 트랜스코더 또는 패키저를 통해 DASH/HLS 스트림 패키징
 - A/B 버전의 DASH 또는 HLS 스트림을 생성합니다.
 - 패키징 결과물은 연동 대상 CDN에 따라 아래 설명된 규칙으로 생성되어야 합니다.

4. A/B 버전 DASH, HLS 스트림을 오리진 서버로 복사

#### 아카마이/Fastly CDN 연동을 위한 패키징 규칙

아카마이 또는 Fastly CDN에서 워터마킹 임베딩을 처리하려면, A/B 버전 DASH/HLS 스트림의 구조가 아래 규칙을 따라야합니다.

- 각각의 스트림은 [아카마이 가이드](https://learn.akamai.com/en-us/webhelp/adaptive-media-delivery/adaptive-media-delivery-implementation-guide/GUID-27105AB8-7C37-4AF9-BB62-FA6E4AEEF80E.html)의 `라벨이 없는 A 변형 방법을 사용하여 변환 및 저장` 항목에 따라 생성되어야 합니다.

- DASH/HLS 세그먼트는 1 GOP (Group of Pictures) 단위로 수행해야 합니다.

- HLS 마스터 플레이리스트 파일명은 `master.m3u8`이어야 합니다.

- DASH 매니페스트 파일 이름은 `stream.mpd`이어야 합니다.

- 비디오 트랙 디렉토리 구조는 `video/[codec]/[track number]/` 형식이어야 합니다.

- 오디오 및 자막 트랙 구조는 `[type]/[codec]/[track number]/` 형식이어야 합니다.

- `[트랙 번호]` 디렉토리에는 미디어 파일만 있어야 합니다. (하위 디렉토리 없음)

- DASH 미디어 세그먼트 태그는 `<SegmentTemplate>` 이어야 합니다. SegmentList 태그는 지원되지 않습니다.

- DASH media init filename은 `xxx_init.xxx` 형식이어야 합니다. (예: `_init.mp4`)

- DASH 미디어 세그먼트 파일 이름은 `xxx_$Number$.xxx` 형식이어야 합니다. (예: `seg_$Number$.m4s`)

- DASH 미디어 세그먼트 번호는 `0`부터 시작해야합니다.

- 파일 이름과 매니페스트/플레이리스트의 내용이 일치해야합니다.

#### 아마존 CloudFront 연동을 위한 패키징 규칙

아마존 CloudFront CDN에서 워터마킹 임베딩을 처리하려면, A/B 버전 DASH/HLS 스트림의 구조가 아래 규칙을 따라야합니다.

- A/B 버전 스트림 콘텐츠는 S3 오리진에 `/dldzkdpsxmdnjrtm/<output_path>/<cid>/<0/1>/<stream format>/<manifest file>` 구조로 저장되어야 합니다.
  -  `/dldzkdpsxmdnjrtm/`: CloudFront 연동을 위해 정의된 키워드 문자열
  -  `<output_path>`: 패키징 결과물을 분류해 저장할 폴더명
  -  `<cid>`: 콘텐츠 서비스에서 관리하는 해당 콘텐츠의 고유 ID
  -  `<0/1>`: `0` or `1` A/B 버전을 구분
  -  `<stream format>`: `dash` 또는 `hls` 입력
  -  `<manifest file>`: DASH 콘텐츠는 `stream.mpd`, HLS 콘텐츠는 `master.m3u8` 

- DASH/HLS 세그먼트는 1 GOP (Group of Pictures) 단위로 수행해야 합니다.

## 3 단계: 워터마크 임베딩

A/B 버전의 스트림 콘텐츠는 CDN 엣지와의 연동을 통해 재생 시점에 조합되어 고유한 워터마크 정보가 임베딩됩니다. 아래와 같이 두 가지 CDN 연동이 가능합니다.

### Option 3-A: 아카마이 또는 Fastly CDN

```mermaid
flowchart TB
  %% pa: 1=A,C 2=C>A 3=B 4=D,E 5=E>B
  subgraph grp_a["도브러너 서비스"]
    direction LR
    C@{ icon: "doverunner-token", form: "square", h: 72, label: "세션 매니저 (2. 세션 데이터 저장 및 WMT 생성)" }
  end
  subgraph grp_b["콘텐츠 서비스 사이트"]
    direction LR
    A@{ icon: "doverunner-server", form: "square", h: 72, label: "서비스 백엔드" } ~~~ D@{ icon: "doverunner-storage", form: "square", h: 72, label: "오리진 서버" }
    D -->|A/B 버전 스트림| E@{ icon: "doverunner-cloud", form: "square", h: 72, label: "CDN 엣지" }
  end
  subgraph grp_c["최종 사용자"]
    B@{ icon: "doverunner-player", form: "square", h: 72, label: "클라이언트 플레이어" }
  end
  A -->|1. 스트림 정보 + 세션 데이터| C
  C -->|3. WMT 포함된 스트림 URL| A
  A -->|4. WMT 포함된 스트림 URL| B
  E -->|5. 워터마크 임베딩된 스트림| B
```

1. 도브러너 세션 매니저에 세션 데이터 전송
  - 콘텐츠 서비스 백엔드(CMS)는 `세션 매니저 API`를 통해 `도브러너 세션 매니저`에 `워터마킹된 스트림 URL`을 요청합니다.
  - 요청에는 해당 스트림 정보와 사용자 ID, IP 주소 및 타임 스탬프와 같은 클라이언트의 세션 데이터가 포함됩니다.

2. 세션 데이터 저장 및 워터마크 토큰 생성
  - 세션 매니저는 세션 데이터를 저장하고 해당 세션의 워터마크 토큰을 생성합니다.

3. 워터마크 토큰(WMT)이 적용된 스트림 URL 전달
  - 세션 매니저는 API 응답으로 스트림 URL의 '가상 경로 구성 요소 (VPC)'에 워터마크 토큰을 포함시켜 API 응답으로 전송합니다.
  - 자세한 내용은 [아카마이 가이드](https://techdocs.akamai.com/adaptive-media-delivery/docs/add-wmk)를 참고하시기 바랍니다.

4. 클라이언트 플레이어에 워터마크 버전 스트림 URL 전달
 - 콘텐츠 서비스는 클라이언트 플레이어에 워터마크 토큰이 포함된 URL을 전달합니다.

5. 콘텐츠 재생 및 워터마크 임베딩
 - 재생이 시작되면 아카마이 엣지는 WMT에 포함된 워터마킹 패턴을 이용해 오리진 서버의 A/B 버전 스트림을 조합해 스트리밍합니다.
 - 클라이언트 플레이어는 워터마킹이 적용되지 않은 일반 스트림과 동일한 방법으로 해당 스트림을 재생할 수 있습니다.

### 옵션 3-B: 아마존 CloudFront CDN

```mermaid
flowchart TB
  %% pa: 1=A,C 2=C>A 3=B 4=D,E 5=E>B
  subgraph grp_a["도브러너 서비스"]
    direction LR
    C@{ icon: "doverunner-token", form: "square", h: 72, label: "세션 매니저 (2. 세션 데이터 저장)" }
  end
  subgraph grp_b["콘텐츠 서비스 사이트"]
    direction LR
    A@{ icon: "doverunner-server", form: "square", h: 72, label: "서비스 백엔드" } ~~~ D@{ icon: "doverunner-storage", form: "square", h: 72, label: "오리진 서버" }
    D -->|A/B 버전 스트림| E@{ icon: "doverunner-cloud", form: "square", h: 72, label: "아마존 CloudFront (5. Lambda Edge 워터마크 임베딩)" }
  end
  subgraph grp_c["최종 사용자"]
    B@{ icon: "doverunner-player", form: "square", h: 72, label: "클라이언트 플레이어" }
  end
  A -->|1. 스트림 정보 및 세션 데이터| C
  C -->|3. 세션 URL| A
  A -->|4. 세션 URL| B
  E -->|6. 워터마크 적용된 스트림| B
```

1. 스트림 정보 및 세션 데이터를 도브러너 세션 매니저로 전송
  - 콘텐츠 서비스 백엔드(CMS)는 [세션 매니저 API](https://docs.doverunner.com/content-security/forensic-watermarking/embedding/session-manager/)를 통해 `도브러너 세션 매니저`에 `워터마킹된 스트림 URL`을 요청합니다.
  - 요청에는 해당 스트림 정보와 사용자 ID, IP 주소 및 타임 스탬프와 같은 클라이언트의 세션 데이터가 포함됩니다.

2. 세션 데이터 저장 및 세션 URL 생성
  - 세션 매니저는 세션 데이터를 저장하고 해당 세션에 대한 고유한 세션 URL을 생성합니다.

3. 세션 URL 전달
  - 세션 매니저는 생성된 세션 URL을 API 응답으로 콘텐츠 서비스 백엔드에 전달합니다.

4. 세션 URL을 클라이언트에 전달
 - 서비스 사이트는 클라이언트 플레이어에 세션 URL을 전달합니다.

5. 콘텐츠 재생 시 워터마크 임베딩
 - CloudFront 엣지 서버는 해당 세션 URL에 포함된 세션 키를 이용해 Lambda@Edge 로직으로 A/B 버전 스트림을 조합해 클라이언트에 전달합니다.
 - 클라이언트 플레이어는 워터마킹이 적용되지 않은 일반 스트림과 동일한 방법으로 해당 스트림을 재생할 수 있습니다.

## 워터마크 검출

워터마크 연동이 완료된 후 유출된 콘텐츠를 발견하면, 워터마크 검출을 도브러너 서비스에 요청할 수 있습니다.
 보다 자세한 사항은 [해당 가이드](https://docs.doverunner.com/content-security/forensic-watermarking/detecting/)를 참고하시기 바랍니다.