---
title: "DRM 블랙리스트 관리 가이드"
description: "이 문서는 DRM 블랙리스트 기능을 이용해 불법적인 서비스 이용이 의심되는 사용자 또는 클라이언트 기기에 대한 라이선스 발급을 차단하는 방법을 설명합니다."
---
> For the complete documentation index, see [llms.txt](https://docs.doverunner.com/llms.txt).

도브러너 멀티 DRM 서비스는 불법복제나 무단 콘텐츠 사용이 의심되는 사용자나 클라이언트 기기에 대해 OTT 플랫폼이 추가적인 DRM 라이선스 발급을 차단할 수 있는 `DRM 블랙리스트 관리` 기능을 제공합니다. 고객사는 HTTP API 또는 도브러너 콘솔 웹 UI의 블랙리스트 관리 섹션을 통해 차단 대상 사용자 또는 기기의 ID를 등록, 조회, 업데이트할 수 있습니다.

```mermaid
sequenceDiagram
    box 최종 사용자
    participant A as OTT 사용자<br/>(클라이언트 기기)
    end
    box 콘텐츠 서비스
    participant B as OTT 플랫폼
    end
    box 도브러너
    participant C as 도브러너 서버
    end
    A ->> C: DRM 라이선스 요청 (블랙리스트 미등록)
    C ->> C: 토큰 유효성 확인
    C ->> A: DRM 라이선스 발급
    A ->> A: 콘텐츠 재생
    opt 블랙리스트를 통한 차단
    B ->> C: 불법 사용자 또는 기기 ID 등록
    C ->> C: 블랙리스트 DB에 해당 ID 저장
    A ->> C: DRM 라이선스 요청 (블랙리스트 대상)
    C ->> C: 토큰 및 블랙리스트 확인 
    C -->> A: DRM 라이선스 발급 거부
    A -->> A: 콘텐츠 재생 불가
    end
```

:::note 

DRM 블랙리스트 기능에서 사용되는 `사용자 ID`와 `기기 ID`의 정의는 다음과 같습니다. 
- `사용자 ID`: DRM 라이선스 연동에 사용되는 토큰 데이터의 `user_id` 값. 토큰 생성 시 해당 값을 입력하지 않거나 최종 사용자와 무관한 임의의 값을 입력하는 경우, 사용자 ID에 대한 블랙리스트를 적용할 수 없음.
- `기기(Device) ID`: DRM 라이선스 응답 데이터에 포함되는 Device ID 값. `Content Security` > `Multi DRM` > `Analytics` 화면에서 확인할 수 있으며, 브라우저 등 클라이언트 환경에 따라 고유한 기기 ID가 존재하지 않을 수 있음.

기기 ID는 해당 기기에서 지원하는 DRM 유형과 관련이 있습니다. 하나의 기기가 여러 DRM을 지원하는 경우, 각각의 DRM 유형마다 서로 다른 기기 ID가 적용됩니다.

:::

## 도브러너 콘솔을 통한 블랙리스트 관리 

도브러너 콘솔의 `블랙리스트 관리` 화면에서 차단 대상 사용자 ID 또는 기기 ID에 대한 등록, 조회, 상태 변경을 처리할 수 있습니다.

### 사용자 블랙리스트 관리 

도브러너 콘솔 로그인 후 `멀티 DRM` > `블랙리스트 관리` > `사용자 블랙리스트` 메뉴로 이동하면 다음과 같은 화면에서 사용자 ID에 대한 블랙리스트를 관리할 수 있습니다. 

![사용자 블랙리스트 관리](https://docs.doverunner.com/img/content-security/blacklist-user-id-list-ko.png)

#### 차단 대상 사용자 조회 

사용자 블랙리스트 화면에서 각종 검색 조건을 적용해 블랙리스트에 등록된 사용자 ID와 현재 상태를 조회할 수 있습니다. 

#### 차단 대상 사용자 등록 

사용자 블랙리스트 화면의 `등록` 버튼을 누르면 다음과 같은 `사용자 ID 등록` 화면으로 이동합니다.

![사용자 ID 등록](https://docs.doverunner.com/img/content-security/blacklist-register-user-id-ko.png)

여러 ID를 입력하는 경우 `등록` 버튼 상단의 `+` 버튼으로 항목을 추가할 수 있으며, 각 항목 우측의 휴지통 버튼을 클릭하면 항목을 줄일 수 있습니다.

#### 차단 상태 변경 

블랙리스트에 등록된 각 사용자 ID마다 상태(차단 또는 차단 해제)를 변경할 수 있습니다. 목록에서 해당 항목 좌측의 체크 박스를 선택하면 현재 상태에 따라 `상태 변경` 버튼이 `차단` 또는 `차단 해제`로 전환되고, 클릭 시 선택된 대상의 차단 상태가 변경됩니다.

:::note 

`차단 해제`로 전환된 사용자 ID에 대해서는 블랙리스트에 등록되기 전과 마찬가지로 DRM 라이선스 발급이 정상적으로 이루어집니다. 

:::

### 기기 블랙리스트 관리 

도브러너 콘솔 로그인 후 `멀티 DRM` > `블랙리스트 관리` > `기기 블랙리스트` 메뉴로 이동하면 다음과 같은 화면에서 기기 ID에 대한 블랙리스트를 관리할 수 있습니다. 

![기기 블랙리스트 관리](https://docs.doverunner.com/img/content-security/blacklist-device-id-list-ko.png)

#### 차단 대상 기기 조회 

기기 블랙리스트 화면에서 각종 검색 조건을 적용해 블랙리스트에 등록된 기기 ID, DRM 유형 및 현재 상태를 조회할 수 있습니다. 

#### 차단 대상 기기 등록 

기기 블랙리스트 화면의 `등록` 버튼을 누르면 다음과 같은 `기기 ID 등록` 화면으로 이동합니다.

![기기 ID 등록](https://docs.doverunner.com/img/content-security/blacklist-register-device-id-ko.png)

등록할 항목마다 기기 ID에 해당하는 DRM 유형을 선택한 후 차단할 기기 ID 값을 입력합니다. 여러 ID를 입력하는 경우 `등록` 버튼 상단의 `+` 버튼으로 항목을 추가할 수 있으며, 각 항목 우측의 휴지통 버튼을 클릭하면 항목을 줄일 수 있습니다.

#### 차단 상태 변경 

블랙리스트에 등록된 각 기기 ID마다 상태(차단 또는 차단 해제)를 변경할 수 있습니다. 목록에서 해당 항목 좌측의 체크 박스를 선택하면 현재 상태에 따라 `상태 변경` 버튼이 `차단` 또는 `차단 해제`로 전환되고, 클릭 시 선택된 대상의 차단 상태가 변경됩니다.

:::note 

`차단 해제`로 전환된 기기 ID에 대해서는 블랙리스트에 등록되기 전과 마찬가지로 DRM 라이선스 발급이 정상적으로 이루어집니다. 

:::

## 블랙리스트 API를 통한 관리 

DRM 블랙리스트 기능은 콘솔 UI 외에 HTTP API를 통해서도 관리할 수 있습니다. 고객사 시스템과 자동화된 연동이 필요한 경우 도브러너 서비스 API 가이드의 [DRM 서비스 API](https://docs.doverunner.com/ko/content-security/service-api-guide/#%EB%B8%94%EB%9E%99%EB%A6%AC%EC%8A%A4%ED%8A%B8-%EC%82%AC%EC%9A%A9%EC%9E%90-id-%EC%A1%B0%ED%9A%8C) 섹션에 있는 블랙리스트 API를 참고하시기 바랍니다.