---
title: "Ant Media Server DRM 플러그인 연동 가이드"
description: "본 문서는 Ant Media Server 제품을 사용하여 콘텐츠 패키징 워크플로우에 도브러너 멀티 DRM 서비스를 연동하는 방법을 설명합니다."
---
> For the complete documentation index, see [llms.txt](/llms.txt).

![](/img/content-security/ant-media-server-logo.png)

**도브러너 멀티 DRM**과 **Ant Media Server**의 연동으로 CPIX(콘텐츠 보호 정보 교환) API를 활용하여 안전한 라이브 스트리밍이 가능합니다. 이 연동을 통해 DASH 및 HLS 출력은 암호화되고 **Widevine**, **PlayReady** 및 **FairPlay** DRM 시스템을 통해 권한이 있는 사용자만 액세스할 수 있습니다.

이 가이드는 필요한 플러그인 설치, DoveRunner를 키 관리 서버로 구성, 재생 확인을 위한 단계별 지침을 제공합니다.

## 사전 요구 사항

* 서버 인스턴스에 설치된 **Ant Media Server**
* **Ant Media DRM 플러그인** (`contact@antmedia.io`를 통해 구매 또는 획득)
* **도브러너 멀티 DRM** 서비스의 활성 계정
* 서버에 대한 루트 또는 sudo 액세스

## 플러그인 및 패키저 설치

DRM 기능을 활성화하려면 Ant Media Server 인스턴스에 DRM 플러그인과 Shaka Packager 바이너리를 설치해야 합니다.

### 1. DRM 플러그인 설치

1.  `DRM-Plugin-bundle.jar` 파일 다운로드
2.  Ant Media Server의 `plugins` 디렉토리에 JAR 파일 복사
    ```bash
    sudo cp DRM-Plugin-bundle.jar /usr/local/antmedia/plugins
    ```
3.  Ant Media Server를 재실행해 플러그인 적용
    ```bash
    sudo service antmedia restart
    ```

### 2. Shaka Packager 설치

이 플러그인은 암호화 작업을 위해 Shaka Packager를 사용합니다.

1.  Shaka Packager 바이너리 다운로드
    ```bash
    wget https://github.com/shaka-project/shaka-packager/releases/download/v3.4.1/packager-linux-x64 -O shakapackager
    ```
2.  시스템 패스에 바이너리 복사 및 실행 권한 설정
    ```bash
    sudo cp shakapackager /usr/local/bin/
    sudo chmod +x /usr/local/bin/shakapackager
    ```

## 환경 설정

DRM 설정은 웹 패널의 **사용자 정의 설정** 기능을 사용하여 애플리케이션 수준(예: `Live` 또는 `WebRTCAppEE`)에서 적용됩니다.

### 1. KMS URL 획득

먼저 도브러너 계정을 사용하여 KMS (Key Management Server) URL 을 구성합니다.

1.  **도브러너 콘솔**에 로그인
2.  **멀티 DRM > DRM 설정**으로 이동
3.  **KMS 토큰**을 복사
4.  URL을 다음과 같이 구성
    `https://drm-kms.doverunner.com/v2/cpix/doverunner/getKey/{YOUR_KMS_TOKEN}`

### 2. Ant Media Server 설정

1.  Ant Media Server 웹 패널 접속
2.  왼쪽 사이드바에서 애플리케이션을 선택(예: `Live`)
3.  **설정** -> **고급**으로 이동
4.  `customSettings` 키/값 저장소 확인
5.  아래와 같이 `plugin.drm-plugin` 구성 개체를 추가하거나 수정

```json
"customSettings": {
  "plugin.drm-plugin": {
    "enabledDRMSystems": [
      "Widevine",
      "PlayReady",
      "FairPlay"
    ],
    "keyManagementServerURL": "https://drm-kms.doverunner.com/v2/cpix/doverunner/getKey/{YOUR_KMS_TOKEN}",
    "encryptionScheme": "cbcs"
  }
}
```

:::note

이전 단계에서 복사한 KMS 토큰 값으로 `{YOUR_KMS_TOKEN}` 부분을 교체해야 합니다.

:::

#### 설정 파라미터 

| 항목 | 설명 |
| :--- | :--- |
| **keyManagementServerURL** | **(필수)** 암호화 키 획득에 사용할 CPIX API URL |
| **enabledDRMSystems** | **(필수)** 지원할 DRM 목록 `["Widevine", "FairPlay", "PlayReady"]`. |
| **encryptionScheme** | 암호화 모드. `"cbcs"` (기본값, 모든 DRM 지원) 또는 `"cenc"` (FairPlay 미지원). |
| **hlsPlayListType** | HLS Playlist 유형. `"LIVE"`(기본값), `"VOD"`, 또는 `"EVENT"`. |
| **segmentDurationSecs** | 세그먼트 길이 (초 단위). 기본값 `2`. |
| **timeShiftBufferDepthSecs** | 라이브스트림 버퍼 길이. 기본값 `60`. |

6. **Save** 버튼을 클릭해 설정 적용

## 재생 확인

연동을 확인하려면 스트림을 게시하고 DRM 지원 플레이어를 사용하여 재생을 테스트합니다.

### 1. 스트림 게시

1.  WebRTC 스트림 게시 (예: 샘플 게시 페이지 사용)
2.  **스트림 ID**를 `stream007`(또는 원하는 ID)로 설정
3.  서버의 디렉토리를 확인하여 스트림이 암호화되고 있는지 확인
    ```bash
    sudo ls /usr/local/antmedia/webapps/live/streams/drm/stream007/
    ```
    *해당 디렉토리에 `master.mpd`와 `master.m3u8` 파일이 존재해야 합니다.*

### 2. 라이선스 토큰 생성 

[도브러너 데브콘솔](https://devconsole.doverunner.com/drm-tools/license-token/#token-generator)에 접속해 다음 정보를 입력하고 테스트용 토큰을 생성합니다.

*   **사이트 ID, 사이트 키, 액세스 키:** 도브러너 콘솔 > 멀티 DRM > DRM 세팅 화면에서 확인
*   **DRM Type:** `Widevine` 입력 (크롬 브라우저 테스트용)
*   **CID:** 이전 단계에서 입력한 Stream ID (예: `stream007`)
*   **User ID:** 임의의 사용자 ID 
*   **토큰 생성** 버튼을 클릭하고 생성된 토큰 문자열을 복사

### 3. 테스트 플레이어 설정

1.  도브러너가 제공하는 샘플 플레이어 저장소를 클론
    ```bash
    git clone https://github.com/doverunner/html5-player-drm-samples
    ```
2.  테스트할 웹 어플리케이션에 플레이어 폴더를 복사. 샘플이 상대 경로를 사용하므로 폴더 구조를 그대로 유지해서 복사합니다.
    ```bash
    cd html5-player-drm-samples
    sudo cp -r basic shared css media /usr/local/antmedia/webapps/live/
    ```

### 4. 설정 및 재생 

1.  베이스 헬퍼 파일 수정 
    ```bash
    sudo nano /usr/local/antmedia/webapps/live/shared/js/doverunner-base-helper.js
    ```
2.  서버 세부 정보와 생성된 토큰으로 변수를 업데이트
    ```javascript
    const dashUri = "https://{YOUR_ANTMEDIA_SERVER}:5443/live/streams/drm/stream007/master.mpd";
    let widevineToken = '{PASTE_YOUR_GENERATED_TOKEN_HERE}';
    ```
3.  파일 저장
4.  크롬 브라우저에서 테스트 페이지 열기
    `https://{YOUR_ANTMEDIA_SERVER}:5443/live/basic/videojs/index.html`
5.  **재생** 버튼 클릭 수 영상 재생을 확인

:::note

DRM 활성화 여부를 검증하려면 비디오 플레이어의 스크린샷에서 비디오 영역이 검은색/빈칸으로 나타나는지 확인합니다.

:::

## 기술 지원 문의 

DRM 플러그인 설치 또는 구매에 대한 도움이 필요하면 Ant Media에 문의해 주시고, 키, 토큰 또는 재생 라이선스와 관련된 문제가 있는 경우 도브러너 지원팀에 문의하시기 바랍니다.

*   **Ant Media 지원:** `contact@antmedia.io`
*   **도브러너 지원:** [헬프 센터](https://support.doverunner.com/)