라이선스 사이퍼 SDK 가이드

개요

본 문서는 안드로이드 애플리케이션을 대상으로 Widevine L3의 보안성을 강화하는 DRM 라이선스 사이퍼 SDK에 대해 안내합니다.

소프트웨어 수준의 보안을 제공하는 Widevine L3 DRM의 경우, TEE(Trusted Execution Environment) 기반의 하드웨어 보안을 지원하는 Widevine L1에 비해 해킹에 취약하다는 단점이 있습니다. 안드로이드 애플리케이션에서 Widevine DRM 콘텐츠 재생 시, 라이선스 사이퍼 SDK을 적용하면 DRM 라이선스 요청을 암호화해 각종 해킹 툴에 의한 콘텐츠 키 유출을 방지할 수 있습니다.

라이선스 사이퍼와 함께 앱실링 서비스의 앱 보안 기능을 적용하면 안드로이드 앱에 대한 해킹 시도를 효과적으로 차단하여 콘텐츠 보안을 강화할 수 있습니다.

사전 요구 사항

라이선스 사이퍼 SDK를 이용하기 위해서는 다음과 같은 사항이 요구됩니다.

• 엔터프라이즈 요금제 및 앱실링 서비스 가입
  • 라이선스 사이퍼를 이용하려면 PallyCon 엔터프라이즈 요금제에 가입해야 합니다. 또한 어플리케이션 보안 적용을 위해 앱실링 서비스 가입이 필요합니다.
  • PallyCon DRM 클라이언트 SDK (Widevine Android SDK, FPS iOS SDK 등) 대신 타사 플레이어와 연동하는 경우에도 동일한 조건이 적용됩니다.
• 라이선스 사이퍼 SDK 요청
  • 라이선스 사이퍼 SDK는 헬프데스크를 통해 전달됩니다. 해당 SDK를 요청하려면 헬프데스크에 티켓을 생성해 주시기 바랍니다.
• PallyCon Widevine Android SDK 또는 연동 가능한 타사 플레이어 사용
  • 라이선스 사이퍼 SDK는 PallyCon Widevine Android SDK 외에도 Google ExoPlayer 또는 Bitmovin 플레이어와 연동 가능합니다.
  • 다른 플레이어 솔루션과 라이선스 사이퍼 SDK 연동이 필요한 경우에는 헬프데스크로 문의해 주시기 바랍니다.
• 키 테이블 파일 다운로드
  • 라이선스 요청 데이터의 암호화에 사용되는 WBC(WhiteBox Crypto) 키 테이블을 PallyCon 콘솔에서 다운로드 받아야 합니다. (멀티 DRM > DRM 세팅 > 라이선스 사이퍼)
  • 다운로드 받은 키 테이블 파일은 라이선스 사이퍼를 적용할 안드로이드 앱에 포함시켜 배포합니다.

라이선스 사이퍼 SDK 적용

라이선스 사이퍼 SDK는 적용 대상에 따라 다음과 같은 방법으로 연동됩니다. 두 가지 연동 방식에 대한 자세한 사항은 SDK에 포함된 샘플 프로젝트를 참고하시기 바랍니다.

PallyCon Widevine Android SDK 연동

1. PallyCon 콘솔에서 다운로드한 키 테이블 파일을 안드로이드 애플리케이션 프로젝트의 assets 폴더에 복사합니다.
2. 헬프데스크를 통해 전달받은 라이선스 사이퍼 SDK의 압축을 해제합니다.
3. PallyConLicenseCipher.aar 파일을 프로젝트의 /module/libs/ 폴더에 복사합니다.
4. build.gradle (app)에 다음과 같은 설정을 추가합니다.

dependencies {
  ...
  // If the pallycon widevine sdk is included in the existing 'project/module/libs/', omit it.
  implementation 'com.pallycon:widevine:x.x.x' 

  implementation fileTree(dir: 'libs', include: ['*.aar'])
  ...
}

5. Widevine Android SDK의 DRM 설정 부분에 다음과 같이 키 테이블 경로를 추가합니다.

// Enter DRM-related information.
val config = PallyConDrmConfiguration(
 siteId = "site id",
 customData = "content auth data",
 httpHeaders = mutableMapOf(), // custom header
 drmLicenseUrl = "request license server url",
 licenseCipherPath = "key table file path in assets" // ex) plc-kt-test.bin
)

val data = ContentData(
 contentId = "content id",
 url = "content URL",
 localPath = "Download location where content will be stored",
 drmConfig = config,
 cookie = null
)

val wvSDK = PallyConWvSDK.createPallyConWvSDK(
 Context, // Context
 data
)

타사 플레이어 솔루션 연동

1. PallyCon 콘솔에서 다운로드한 키 테이블 파일을 안드로이드 애플리케이션 프로젝트의 assets 폴더에 복사합니다.
2. 헬프데스크를 통해 전달받은 라이선스 사이퍼 SDK의 압축을 해제합니다.
3. PallyConLicenseCipher.aar 파일을 프로젝트의 /module/libs/ 폴더에 복사합니다.
4. build.gradle (app)에 다음과 같은 설정을 추가합니다.

dependencies {
  ...
  // If the pallycon widevine sdk is included in the existing 'project/module/libs/', omit it.
  implementation 'com.pallycon:widevine:x.x.x' 

  implementation fileTree(dir: 'libs', include: ['*.aar'])
  ...
}

5. 라이선스 사이퍼 라이브러리를 임포트합니다.

import com.pallycon.licensecipher.LicenseCipher

6. Widevine 라이선스 요청 시, 라이선스 사이퍼를 이용해 요청 데이터를 암호화합니다.

// If you use ExoPlayer, you will need to inherit the 'MediaDrmCallback' and implement your own license request process. 
// licenseData is the widevine request license data and the data type is ByteArray.
val outputData = ByteArray(licenseData.size)
// create license cipher, path = The path to the Asset directory. ex) plc-kt-test.bin
// You can download the table file from the PallyCon console.
val licenseCipher = LicenseCipher.createLicenseCipher(context, tablePath)
// doCipher
if (licenseCipher.doCipher(licenseData, outputData)) {
  // requestData is the data to include in the body when communicating with the server API.
  requestData = outputData
}

라이선스 토큰에 라이선스 사이퍼 활성화

클라이언트 앱에 라이선스 사이퍼 기능을 적용한 후에는 해당 앱에서 사용되는 라이선스 토큰에 아래 예시와 같이 암호화 플래그를 활성화합니다.

"security_policy": [
  {
    ...
    "widevine": {
      ...
      "enable_license_cipher": true
    },
    ...
  }
]

암호화 미적용 요청 차단

클라이언트 앱에 라이선스 사이퍼 기능을 적용한 후에는 해당 앱에서의 라이선스 요청만 허용되도록 암호화 미적용 요청을 차단해야 합니다. DRM 기능의 신규 도입 여부에 따라 다음과 같은 방법으로 차단을 설정합니다.

신규 서비스에 도입하는 경우

라이선스 사이퍼를 신규 서비스에 도입하는 경우, 라이선스 사이퍼가 적용된 클라이언트 앱이 스토어에 등록되면 다음과 같이 암호화가 적용되지 않은 라이선스 요청을 차단합니다.

1. PallyCon 콘솔 로그인
2. 멀티DRM > DRM 세팅 화면에서 라이선스 사이퍼 설정의 암호화 미적용된 라이선스 요청 허용 여부 옵션을 차단으로 변경

위 설정 이후에는 안드로이드 앱으로부터의 Widevine 라이선스 요청은 라이선스 사이퍼 SDK를 통해 암호화된 경우에만 정상적으로 처리되며, 암호화가 미적용된 요청은 해킹 시도로 간주되어 DRM 라이선스 발급이 거부됩니다.

기존 서비스에 적용하는 경우

이미 DRM 콘텐츠를 서비스하고 있는 경우, 라이선스 사이퍼 솔루션 도입 과정에서 사용자 불편을 최소화 하려면 대부분의 사용자들이 신규 버전 앱으로 업데이트할 때까지 기존 버전에서의 암호화되지 않은 요청도 허용해야 합니다.

1. 클라이언트 앱에 라이선스 사이퍼 SDK를 적용
2. 신규 버전의 앱에 대해서 토큰 규격의 enable_license_cipher 항목을 true로 적용 (기본값: false)
3. 업데이트된 앱을 스토어에 등록 후 사용자들에게 업데이트 요청 공지
4. 대부분의 사용자가 업데이트를 완료하면 PallyCon 콘솔에서 암호화 미적용된 라이선스 요청 허용 여부 옵션을 차단으로 변경

토큰 프록시 방식 연동

고객사 시스템에서 운영하는 프록시 서버를 통해 DRM 라이선스 연동을 하는 경우, 프록시에서 생성하는 라이선스 토큰에 클라이언트 환경에 따라 enable_license_cipher 항목을 true로 설정해야 합니다. (라이선스 사이퍼 SDK가 적용된 안드로이드 앱 대상)

그 외에 프록시 서버에서 처리되는 라이선스 서버와 클라이언트 간의 요청 데이터와 응답 데이터에 대한 전달은 라이선스 사이퍼 적용 여부와 무관하게 기존과 동일한 방식으로 이루어집니다.