Ant Media Server DRM 플러그인 연동 가이드

도브러너 멀티 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 플러그인 설치

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

2. Shaka Packager 설치

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

Shaka Packager 바이너리 다운로드

wget https://github.com/shaka-project/shaka-packager/releases/download/v3.4.1/packager-linux-x64 -O shakapackager

시스템 패스에 바이너리 복사 및 실행 권한 설정

sudo cp shakapackager /usr/local/bin/
sudo chmod +x /usr/local/bin/shakapackager

환경 설정

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

1. KMS URL 획득

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

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

2. Ant Media Server 설정

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

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

설정 파라미터

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

Save 버튼을 클릭해 설정 적용

재생 확인

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

1. 스트림 게시

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

2. 라이선스 토큰 생성

도브러너 데브콘솔에 접속해 다음 정보를 입력하고 테스트용 토큰을 생성합니다.

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

3. 테스트 플레이어 설정

도브러너가 제공하는 샘플 플레이어 저장소를 클론
Terminal window
```
git clone https://github.com/doverunner/html5-player-drm-samples
```

테스트할 웹 어플리케이션에 플레이어 파일을 복사

cd html5-player-drm-samples
sudo cp videojs-doverunner-sample.html /usr/local/antmedia/webapps/live/
sudo cp js/videojs-sample.js /usr/local/antmedia/webapps/live/js/
sudo cp js/doverunner-sample-helper.js /usr/local/antmedia/webapps/live/js/
sudo cp css/* /usr/local/antmedia/webapps/live/css/

4. 설정 및 재생

헬퍼 파일 수정

sudo nano /usr/local/antmedia/webapps/live/js/doverunner-sample-helper.js

서버 세부 정보와 생성된 토큰으로 변수를 업데이트

dashUri = "https://{YOUR_ANTMEDIA_SERVER}:5443/live/streams/drm/stream007/master.mpd";
widevineToken = '{PASTE_YOUR_GENERATED_TOKEN_HERE}';

파일 저장
크롬 브라우저에서 테스트 페이지 열기 https://{YOUR_ANTMEDIA_SERVER}:5443/live/videojs-doverunner-sample.html
재생 버튼 클릭 수 영상 재생을 확인

기술 지원 문의

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

Ant Media 지원: contact@antmedia.io
도브러너 지원: 헬프 센터