Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.

DRM

Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Biểu tượng DRM HAL của Android

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 mạnh mẽ hoặc các quy tắc tuân thủ có thể được xác định bởi sơ đồ DRM.

Khuôn khổ

Nền tảng Android cung cấp một 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 giấy phép liên quan đến nội dung đó. Khung DRM hỗ trợ nhiều chương trình DRM; chương trình DRM nào mà thiết bị hỗ trợ là 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 một 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 tóm tắt khỏi nội dung được bảo vệ bằng DRM hoặc không được bảo vệ. Xem MediaDrm cho lớp để lấy các khóa giải mã các luồng phương tiện được bảo vệ.

Android DRM HAL
Hình 1a. Lớp trừu tượng phần cứng DRM trước Android 11
Bài đăng Android DRM HAL R
Hình 1b. Lớp trừu tượng phần cứng DRM bắt đầu trong 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 có phí cấp 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 hỗ trợ bởi phần cứng để 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 được cung cấp bởi plugin DRM 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. Khả năng phần cứng của thiết bị phải bao gồm khởi động an toàn 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 mật và bảo vệ nội dung ở trên. Bảo mật không bao giờ được thực hiện ở một nơi duy nhất trong ngăn xếp, mà thay vào đó dựa vào 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 an toàn biệt lập để 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ị an toàn.

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 một plugin DRM dành riêng cho lược đồ cụ thể. Khung DRM bao gồm các API đơn giản để xử lý các hoạt động DRM phức tạp, xin 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:

  • Một 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, cho thấy một giao diện cho các plugin DRM (tác nhân) để xử lý việc quản lý quyền và giải mã cho các chương trình 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 trong 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 quét các bản sao / dịch vụ HAL (được mô tả trong tệp .rc ) và các plugin được phát hiện. Media DRM Server (máy chủ trung gian) tạo cả DrmHal tượng mediadrmserverCryptoHal . CryptoHalDrmHal sau đó gọi các plugin với các triển khai dành riêng cho nhà cung cấp.

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

Các plugin được xây dựng bởi các nhà cung cấp hoặc nhà sản xuất SOC và đặt trong một phân vùng /vendor trên thiết bị. Tất cả các thiết bị chạy Android 13 trở lên phải hỗ trợ HAL được ràng buộc bởi ngôn ngữ AIDL.

Thực hiện

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

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

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

Các API được định nghĩa 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 các 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 gói android.hardware.drm-service.* :


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

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

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 AIDL API (ví dụ: 1, 2). Ngoài ra, chúng tôi khuyên bạn nên sử dụng vintf_fragment.

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 theo / nhà cung cấp

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

Xem Android Init Language để biết thêm 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ợ một lược đồ tiền điện tử nhất định thông qua lớp DrmFactory .

IDrmFactory là điểm nhập 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 chương trình 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ể tạo các plugin DRM hỗ trợ một lược đồ tiền điện tử nhất định, được chỉ định bởi UUID hay không.

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

Xác định xem nhà máy sản xuất plugin có thể tạo các plugin DRM hỗ trợ định dạng vùng chứa phương tiện nhất định do mimeType chỉ định 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);

Tạo một 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ợ một 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 tiền điện tử có thể tạo các plugin tiền điện tử hỗ trợ một sơ đồ tiền điện tử nhất định, được chỉ định bởi UUID hay không.

::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 sản xuất plugin có thể tạo các plugin tiền điện tử hỗ trợ một sơ đồ tiền điện tử nhất định, được chỉ định bởi UUID hay không.

API plugin DRM

Các API được định nghĩa trong hardware/interfaces/drm/aidl/aidl_api/android.hardware.drm/ VERSION /android/hardware/drm/IDrmPlugin.aidl . IDrmPlugin.h tương ứng có thể được tìm thấy trong Out / Soong sau khi xây dựng.