---
title: "워터마크 검출 서비스 가이드"
description: "도브러너 콘솔을 통해 FWM 검출을 요청하고 결과를 확인하는 방법을 안내합니다."
---
> For the complete documentation index, see [llms.txt](/llms.txt).

import YouTubeEmbed from '../../../../../../components/YouTubeEmbed.astro';

도브러너의 포렌식 워터마크 검출은 '블라인드' 검출 방식을 사용합니다. 워터마크 검출은 영상의 각 프레임을 분석하여 원본 워터마크 패턴을 감지하고 임베딩 시 사용한 비밀 키로 데이터를 획득합니다. 검출 과정을 통해 워터마크 페이로드를 찾아내면, 세션 데이터베이스에서 해당 페이로드를 키 값으로 하는 세션 정보를 찾아 검출 결과로 리포트합니다.

```mermaid
sequenceDiagram
    participant A as 서비스 사이트
    participant B as 도브러너 서비스
    A ->> B: 유출 의심 영상
    Note right of B: 워터마크(페이로드) 검출
    B -->> B: 영상 프레임 분석
    opt 워터마크 검출 시
    Note right of B: 워터마크 세션 데이터베이스
    B -->> B: 해당 세션 정보 검색
    end
    B ->> A: 검출 결과 리포트
```

## 동영상 튜토리얼

포렌식 워터마킹 검출 요청 방법을 설명하는 영상입니다.

<YouTubeEmbed videoId="LOJMPCkamnM" />

## 워터마크 검출 요구사항

:::note 

워터마크 검출을 위해서는 최소 5분 이상의 연속된 녹화 영상이 필요합니다. 도브러너 포렌식 워터마크 제품은 리사이징을 비롯한 각종 공격에 대한 강인성을 가지고 있지만, 실제 워터마크의 검출율은 검출에 사용되는 영상의 화질(해상도, 비트레이트, 흔들림 등)에 따라 달라질 수 있습니다. 검출에 필요한 최소 사양은 480p 1Mbps 이상이며, 일반적으로 720p 이상의 영상에 대해서는 대부분 검출이 가능합니다. 자동 검출이 실패한 경우, 도브러너는 non-blind 검출도 지원하므로 원본 영상 또는 원본 콘텐츠의 스냅샷을 TS를 통해 제공해 주시면 전문가 팀이 수동검출을 시도할 수 있습니다.

:::

워터마크 검출에 필요한 상세 요구 사항은 다음과 같습니다. 

| 항목 | 내용 | 
| :--- | :-- |
| 최소 영상 길이 | 워터마크 검출을 위해서는 최소 5분 이상 길이의 구간 반복 없이 연속된 녹화 영상이 필요 |
| 검출 영상 화질 | 검출을 위해서는 최소 480p 1Mbps 이상 화질 필요. 720p 이상의 화질 권장 |
| 영상 안정성 | 흔들림 없이 고정된 녹화 영상 필요. 핸드헬드 카메라 또는 스마트폰으로 촬영되어 화면이 흔들리는 경우 검출 불가 |
| 버퍼링 또는 화면 멈춤 | 최소 5분 이상 버퍼링이나 화면 멈춤 현상 없이 정상 재생된 구간이 있어야 함 |

## 워터마크 탐지 요청 등록

워터마크 탐지를 요청하려면,
- **1단계:** DoveRunner 콘솔의 `포렌식 워터마킹` > `탐지 서비스` 화면에서 `+ Request` 버튼을 클릭합니다.
- **2단계:** 등록 화면에서 **Request Type**(`File` 또는 `URL`)을 선택하고, 대상 콘텐츠의 제목을 입력한 후 선택한 유형에 맞게 탐지 대상을 입력합니다.
- **3단계:** `Register` 버튼을 클릭하여 워터마크 탐지 요청을 등록합니다.

  - `Request Type`: 탐지 대상을 파일 업로드(`File`)로 제공할지, 다운로드 링크(`URL`)로 제공할지 선택합니다.
  - `Content Title`: 탐지 목록 화면에서 각 항목을 구분하기 위한 정보입니다. 이 정보는 실제 워터마크 탐지 작업에는 사용되지 않습니다.
  - `Detection Video Link` (`URL` 선택 시 표시): 로그인이나 별도의 확인 절차 없이 DoveRunner 서비스 시스템이 다운로드할 수 있는 영상 파일의 '다이렉트 다운로드 링크'를 입력합니다. Google Drive와 같은 클라우드 스토리지 링크도 사용할 수 있지만, 일반적인 "공유" 링크(예: `drive.google.com/file/d/.../view`)는 자동으로 다운로드되지 않으므로, 다이렉트 다운로드 링크를 사용하거나 중간 확인 페이지 없이 파일이 다운로드되도록 공유 설정을 변경해야 합니다.
  - `Detection File` (`File` 선택 시 표시): 업로드 영역을 클릭하거나 파일을 드래그 앤 드롭하여 탐지 대상 영상 파일을 기기에서 직접 업로드합니다.
  - `Video captured from DoveRunner DEMO Page`: 샘플이 DoveRunner 데모 페이지에서 캡처된 경우 선택하는 항목입니다.
  - `Advanced Options`: 추가 설정을 위한 선택적 접힘(collapsible) 영역입니다.

:::note
`Advanced Options`는 필수 입력 항목이 아닙니다. 여기에 입력한 정보는 해당 탐지 기록에 변경 불가능한 형태로 저장되며, 추출되는 증거 보고서(evidence report)에 탐지 결과의 일부로 표시됩니다.

  - **Source Information**: 해당 파일에 대해 확인된 불법 유통 소스 정보입니다. 이 항목을 입력할 경우 `Source URL Link`(불법 유통 URL)는 필수이며, `IP Address`와 `GEO Location`은 선택 사항입니다.
  - **VPN Detected**: `VPN flag` — 불법 유통 소스 URL을 재생/접속하기 위해 VPN이 필요했던 경우 토글을 켭니다.
:::

## 탐지 결과 확인

탐지 요청을 등록한 후에는 `탐지 서비스` 화면에서 각 항목의 진행 상태와 탐지 결과가 포함된 요청 목록을 확인할 수 있습니다.

  - `Checkbox`: 탐지 진행 중인 항목을 선택하여 `탐지 취소(cancel detection)`를 요청할 수 있습니다.
  - `Detection ID`: 각 탐지 요청에 부여되는 고유 ID입니다.
  - `Content Title`: 요청 등록 시 입력한 제목 값입니다. 제목을 클릭하면 해당 항목의 탐지 상세 페이지가 열립니다.
  - `Type`: `Watermark` — 탐지 서비스 또는 API를 통해 탐지가 요청된 경우 표시됩니다.
  - `Status`: 탐지 진행 상태를 표시합니다(예: `Completed`, `Error`). 상태 값에 대한 자세한 목록은 다음 섹션을 참고하세요.
  - `Registration Date`: 탐지 요청이 등록된 시각입니다.
  - `Complete Date`: 탐지 작업이 완료된 시각입니다.

`Content Title`을 클릭하면 다음 정보가 포함된 탐지 상세 페이지가 열립니다.

  - `Export Report`: 페이지 상단의 버튼으로, 아래 전체 섹션이 포함된 탐지 결과 보고서 전체를 파일로 다운로드합니다.

  **Detection File Information**
  - `Detection ID`: 해당 탐지 요청의 고유 ID입니다.
  - `File Name`: 등록 시 입력한 콘텐츠 제목입니다 (Read Only).
  - `Detection Video Link`: 등록된 탐지 대상의 다운로드 링크 또는 파일명입니다.
  - `File Integrity Hash (SHA-256)`: 탐지 대상 파일의 SHA-256 해시 값으로, 등록 이후 파일이 변경되지 않았는지 확인하는 데 사용됩니다.

  **Detection Result**
  - `Status`: 현재 탐지 상태입니다(예: `Completed`).
  - `Watermark Token`: 탐지 대상에서 추출된 워터마크 토큰입니다.
  - `Watermark Data`: 콘텐츠에 삽입된 워터마크 페이로드를 디코딩한 값입니다(예: 재생 클라이언트, IP, 타임스탬프, 사용자 식별자 등).
  - `Error Code`: 탐지 성공 여부 또는 실패 유형을 나타내는 코드입니다(`0000` = 성공).
  - `Error Message`: 오류가 있는 경우 추가 상세 정보입니다(오류가 없으면 `-`로 표시).

  **Detection Location**
  탐지와 관련된 위치 정보가 있는 경우 이를 표시합니다. 정보가 없는 경우 "No detection location data available"로 표시됩니다.

  **Detection Log**
  탐지 처리 단계를 시간 순으로 기록한 로그이며, 각 단계마다 타임스탬프가 표시됩니다. `Download` 버튼 — 전체 보고서가 아닌 탐지 로그만 다운로드합니다.
    - `FD001` - Detection Requested (탐지 요청됨)
    - `FD002` - Downloading (다운로드 중)
    - `FD003` - Detection Started (탐지 시작됨)
    - `FD004` - Detection Completed (탐지 완료됨)

  **Source Information** (등록 시 `Advanced Options`에 정보를 입력한 경우에만 표시)
  - `Pirated URL`: 등록 시 입력한 소스 URL로, 클릭 가능한 링크 형태로 표시됩니다.
  - `IP Address`: 등록 시 입력한 IP 주소입니다.
  - `GEO Location`: 등록 시 입력한 지역 정보입니다.
  - `VPN Detected`: 불법 유통 소스에 접속하기 위해 VPN이 필요했다고 표시되었는지 여부입니다(`Yes - VPN detected` / `No`).


### 검출 진행 상태

워터마크 검출 작업은 진행 상황에 따라 다음과 같은 상태로 구분됩니다.

 - `요청`: 검출 요청이 시스템에 등록됨
 - `다운로드 중`: 검출 대상 영상의 다운로드가 진행 중임
 - `검출 중`: 영상 파일 다운로드가 완료되어 워터마크 검출이 진행 중임
 - `완료`: 워터마크 검출이 완료되어 결과가 추가됨
 - `취소`: 사용자에 의해 검출 요청이 취소됨
 - `오류`: 대상 영상이 요구 사항을 만족하지 않아 검출 진행을 할 수 없음
 - `실패`: 워터마크 검출을 시도했으나 각종 공격에 의해 워터마크 정보 검출에 실패함