DRM

Biểu tượng Android DRM HAL

Tài liệu này cung cấp tổng quan về khung quản lý quyền kỹ thuật số (DRM) của Android và giới thiệu các giao diện mà plugin DRM phải triển khai. Tài liệu này không mô tả các quy tắc về độ bền hoặc quy tắc tuân thủ có thể được xác định bởi sơ đồ DRM.

khung

Nền tảng Android cung cấp khung DRM có thể mở rộng cho phép các ứng dụng quản lý nội dung được bảo vệ quyền theo các ràng buộc về giấy phép liên quan đến nội dung. Khung DRM hỗ trợ nhiều chương trình DRM; lược đồ DRM nào mà thiết bị hỗ trợ tùy thuộc vào nhà sản xuất thiết bị. Khung DRM cung cấp một giao diện thống nhất cho các nhà phát triển ứng dụng và che giấu sự phức tạp của các hoạt động DRM. Khung DRM cung cấp chế độ hoạt động nhất quán cho nội dung được bảo vệ và không được bảo vệ. Các lược đồ DRM có thể xác định các mô hình sử dụng phức tạp bằng siêu dữ liệu giấy phép. Khung DRM cung cấp sự liên kết giữa nội dung và giấy phép DRM, đồng thời xử lý việc quản lý quyền. Điều này cho phép trình phát đa phương tiện được trừu tượng hóa khỏi nội dung được bảo vệ bằng DRM hoặc không được bảo vệ. Xem MediaDrm để biết lớp này có khóa để giải mã các luồng phương tiện được bảo vệ.

HAL DRM Android
Hình 1a. Lớp trừu tượng phần cứng DRM trước Android 11
Android DRM HAL bài R
Hình 1b. Lớp trừu tượng hóa phần cứng DRM bắt đầu từ Android 11

Sự sẵn có của nội dung kỹ thuật số phong phú rất quan trọng đối với người dùng trên thiết bị di động. Để cung cấp rộng rãi nội dung của họ, các nhà phát triển Android và nhà xuất bản nội dung kỹ thuật số cần triển khai DRM nhất quán được hỗ trợ trên toàn hệ sinh thái Android. Để cung cấp nội dung kỹ thuật số đó trên các thiết bị Android và để đảm bảo rằng có ít nhất một DRM nhất quán trên tất cả các thiết bị, Google cung cấp DRM mà không tính phí giấy phép trên các thiết bị Android tương thích. Plugin DRM được tích hợp với khung DRM của Android và có thể sử dụng tính năng bảo vệ được phần cứng hỗ trợ để bảo mật nội dung cao cấp và thông tin đăng nhập của người dùng.

Khả năng bảo vệ nội dung do plugin DRM cung cấp phụ thuộc vào khả năng bảo mật và bảo vệ nội dung của nền tảng phần cứng bên dưới. Các khả năng phần cứng của thiết bị phải bao gồm khả năng khởi động bảo mật phần cứng để thiết lập một chuỗi tin cậy về bảo mật và bảo vệ các khóa mật mã. Khả năng bảo vệ nội dung của thiết bị phải bao gồm bảo vệ các khung được giải mã trong thiết bị và bảo vệ nội dung thông qua cơ chế bảo vệ đầu ra đáng tin cậy. Không phải tất cả các nền tảng phần cứng đều hỗ trợ tất cả các tính năng bảo vệ nội dung và bảo mật ở trên. Bảo mật không bao giờ được triển khai ở một vị trí duy nhất trong ngăn xếp mà thay vào đó dựa trên sự tích hợp của phần cứng, phần mềm và dịch vụ. Sự kết hợp của các chức năng bảo mật phần cứng, cơ chế khởi động đáng tin cậy và một hệ điều hành bảo mật riêng biệt để xử lý các chức năng bảo mật là rất quan trọng để cung cấp một thiết bị bảo mật.

Ngành kiến ​​​​trúc

Khung DRM được thiết kế để không thể triển khai và tóm tắt các chi tiết của việc triển khai lược đồ DRM cụ thể trong plugin DRM dành riêng cho lược đồ. Khung DRM bao gồm các API đơn giản để xử lý các hoạt động DRM phức tạp, mua giấy phép, cung cấp thiết bị, liên kết nội dung DRM và giấy phép của nó, và cuối cùng là giải mã nội dung DRM.

Khung DRM của Android được triển khai theo hai lớp kiến ​​trúc:

  • API khung DRM, được hiển thị với các ứng dụng thông qua khung ứng dụng Android.
  • Khung DRM mã gốc, hiển thị giao diện cho các phần bổ trợ DRM (tác nhân) để xử lý việc quản lý và giải mã quyền cho các sơ đồ DRM khác nhau.
Khung DRM của Android
Hình 2a. Khung DRM trước Android 11
Khung DRM của Android
Hình 2b. Khung DRM bắt đầu từ Android 11

Xem Android Media DRMAndroid Media Crypto để biết thêm chi tiết.

plugin DRM

Khi khởi động hệ thống, khung DRM sẽ quét các phiên bản/dịch vụ HAL (được mô tả trong tệp .rc ) và các phần bổ trợ được phát hiện. Media DRM Server ( mediadrmserver ) tạo cả hai đối tượng CryptoHalDrmHal . Sau đó, CryptoHalDrmHal gọi các phần bổ trợ có triển khai dành riêng cho nhà cung cấp.

Các plugin nên triển khai các HAL được liên kết hóa. HAL được liên kết hóa sử dụng Ngôn ngữ định nghĩa giao diện Android (AIDL) , cho phép thay thế khung mà không phải xây dựng lại HAL.

Plugin được nhà cung cấp hoặc nhà sản xuất SOC xây dựng và đặt trong phân vùng /vendor trên thiết bị. Tất cả các thiết bị khởi chạy với Android 13 trở lên phải hỗ trợ HAL liên kết được viết bằng ngôn ngữ AIDL.

Thực hiện

Bản phát hành thiết bị GMS và AOSP cho Android 13 phải sử dụng giao diện AIDL.

Để triển khai các API khung DRM mới bằng plugin:

  1. Thêm dịch vụ plugin vào tệp xây dựng của thiết bị.
  2. Cập nhật bảng kê khai thiết bị.
  3. Thêm quyền SELinux.
  4. Tạo tệp .rc bên dưới /vendor .
  5. Triển khai plugin.

API được xác định trong mỗi phiên bản IDrmPlugin.aidl , ICryptoPlugin.aidl , IDrmFactory.aidlICryptoFactory.aidl

aidl/PLATFORM_ROOT/hardware/interfaces/drm/

Thêm dịch vụ plugin vào tệp xây dựng thiết bị

Ví dụ: để thêm hỗ trợ giao diện AIDL, tệp VENDOR DEVICE /device.mk phải bao gồm các gói android.hardware.drm-service.* :


  PRODUCT_PACKAGES += \
    android.hardware.drm-service.clearkey \
    android.hardware.drm-service.widevine

Cập nhật bảng kê khai thiết bị

Tệp vendor manifest.xml cho thiết bị phải bao gồm các mục sau:

  <hal format="aidl">
    <name>android.hardware.drm</name>
    <version>STABLE AIDL VERSION</version>
      <fqname>ICryptoFactory/clearkey</fqname>
      <fqname>IDrmFactory/clearkey</fqname>
      <fqname>ICryptoFactory/widevine</fqname>
      <fqname>IDrmFactory/widevine</fqname>
  </hal>

PHIÊN BẢN AIDL ỔN ĐỊNH là số phiên bản của mỗi bản phát hành API AIDL (ví dụ: 1, 2). Ngoài ra, chúng tôi khuyên bạn nên sử dụng vintf_fragments.

Thêm quyền SELinux

  1. Thêm vào VENDOR DEVICE /sepolicy/vendor/file.te
    type mediadrm_vendor_data_file, file_type, data_file_type;
  2. Thêm vào VENDOR DEVICE /sepolicy/vendor/file_contexts
        /vendor/bin/hw/android\.hardware\.drm-service\.clearkey  u:object_r:hal_drm_clearkey_exec:s0
    /data/vendor/mediadrm(/.*)? u:object_r:mediadrm_vendor_data_file:s0
  3. Thêm vào device/sepolicy/vendor/hal_drm_clearkey.te
        vndbinder_use(hal_drm_clearkey)
        allow hal_drm_clearkey servicemanager:binder { call transfer };
        allow hal_drm_clearkey hal_drm_service:service_manager add;
        allow hal_drm_clearkey { appdomain -isolated_app }:fd use;
        get_prop(ramdump, public_vendor_default_prop)
        

Tạo tệp RC trong /vendor

Tệp .rc chỉ định các hành động sẽ được thực hiện khi khởi chạy dịch vụ.

Xem Ngôn ngữ khởi tạo Android để biết chi tiết.

triển khai plugin

  1. Triển khai điểm nhập main() trong service.cpp của dịch vụ plugin.
  2. Triển khai ICryptoPlugin , IDrmPlugin , ICryptoFactoryIDrmFactory .
  3. Triển khai các API mới trong plugin.

Chi tiết plugin DRM

Các nhà cung cấp plugin DRM triển khai plugin DrmFactory , CryptoFactory và DRM.

DrmFactory

Lớp DrmHal tìm kiếm các dịch vụ plugin DRM đã đăng ký và xây dựng các plugin tương ứng hỗ trợ sơ đồ tiền điện tử nhất định thông qua lớp DrmFactory .

IDrmFactory là điểm vào chính để tương tác với drm HAL của nhà cung cấp thông qua API createPlugin. API createPlugin được sử dụng để tạo các phiên bản IDrmPlugin.

::ndk::ScopedAStatus getSupportedCryptoSchemes(
    std::vector<::aidl::android::hardware::drm::Uuid>* _aidl_return);

getSupportedCryptoSchemes trả về danh sách các lược đồ tiền điện tử được hỗ trợ cho phiên bản AIDL drm HAL.

::ndk::ScopedAStatus isCryptoSchemeSupported(
    const ::aidl::android::hardware::drm::Uuid& in_uuid,
    const std::string& in_mimeType,
    ::aidl::android::hardware::drm::SecurityLevel in_securityLevel,
    bool* _aidl_return);

Xác định xem nhà máy sản xuất plugin có thể xây dựng các plugin DRM hỗ trợ sơ đồ tiền điện tử nhất định hay không, được chỉ định bởi UUID.

::ndk::ScopedAStatus isContentTypeSupported(const std::string& in_mimeType,
    bool* _aidl_return);

Xác định xem nhà máy plugin có thể xây dựng các plugin DRM hỗ trợ định dạng vùng chứa phương tiện cụ thể được chỉ định bởi mimeType hay không.

::ndk::ScopedAStatus createPlugin(
    const ::aidl::android::hardware::drm::Uuid& in_uuid,
    const std::string& in_appPackageName,
    std::shared_ptr<::aidl::android::hardware::drm::IDrmPlugin>* _aidl_return);

Xây dựng plugin DRM cho lược đồ tiền điện tử do UUID chỉ định.

CryptoFactory

Lớp CryptoHal tìm kiếm các dịch vụ plugin DRM đã đăng ký và xây dựng các plugin tương ứng hỗ trợ sơ đồ tiền điện tử nhất định thông qua lớp CryptoFactory .

::ndk::ScopedAStatus isCryptoSchemeSupported(
    const ::aidl::android::hardware::drm::Uuid& in_uuid,
    bool* _aidl_return);

Xác định xem nhà máy sản xuất tiền điện tử có thể xây dựng các plugin tiền điện tử hỗ trợ sơ đồ tiền điện tử nhất định hay không, được chỉ định bởi UUID.

::ndk::ScopedAStatus createPlugin(
    const ::aidl::android::hardware::drm::Uuid& in_uuid,
    const std::vector<uint8_t>& in_initData,
    std::shared_ptr<::aidl::android::hardware::drm::ICryptoPlugin>* _aidl_return);

Xác định xem nhà máy plugin có thể xây dựng plugin tiền điện tử hỗ trợ sơ đồ tiền điện tử nhất định hay không, được chỉ định bởi UUID.

API plugin DRM

API được xác định trong hardware/interfaces/drm/aidl/aidl_api/android.hardware.drm/ VERSION /android/hardware/drm/IDrmPlugin.aidl . Có thể tìm thấy tệp IDrmPlugin.h tương ứng trong out/Soong after build.