00785b2ccd
Plugin: 1. Process ECM v3 and send fingerprinting/service_blocking events 2. Rmove unused function Ctr128Add 3. Add support for ECM v3 OEMCrypto: 1. Update API description of OEMCrypto_LoadCasECMKeys 2. Fix android build files for ODK 3. Load content keys to shared memory 4. Move KCB check to LoadCasKeys call 5. Support even/odd content keys to share entitlement key
98 lines
3.3 KiB
Protocol Buffer
98 lines
3.3 KiB
Protocol Buffer
// Copyright 2018 Google LLC. All Rights Reserved. This file and proprietary
|
|
// source code may only be used and distributed under the Widevine Master
|
|
// License Agreement.
|
|
|
|
syntax = "proto2";
|
|
|
|
package video_widevine;
|
|
|
|
option optimize_for = LITE_RUNTIME;
|
|
|
|
// Widevine private data in the CA descriptor.
|
|
message CaDescriptorPrivateData {
|
|
// Provider name.
|
|
optional string provider = 1;
|
|
|
|
// Content ID.
|
|
optional bytes content_id = 2;
|
|
}
|
|
|
|
// Widevine fingerprinting.
|
|
message Fingerprinting {
|
|
// Channels that will be applied with the controls.
|
|
repeated bytes channels = 1;
|
|
// Fingerprinting controls are opaque to Widevine.
|
|
optional bytes control = 2;
|
|
}
|
|
|
|
// Widevine service blocking.
|
|
message ServiceBlocking {
|
|
// Channels that will be blocked.
|
|
repeated bytes channels = 1;
|
|
// Device groups that will be blocked. Group definition is opaque to Widevine.
|
|
repeated bytes device_groups = 2;
|
|
// Blocking start time in seconds since epoch. Start time is "immediate" if
|
|
// this field is not set.
|
|
optional int64 start_time_sec = 3;
|
|
// Required. Blocking end time in seconds since epoch.
|
|
optional int64 end_time_sec = 4;
|
|
}
|
|
|
|
message EcmMetaData {
|
|
enum CipherMode {
|
|
UNSPECIFIED = 0;
|
|
AES_CBC = 1;
|
|
AES_CTR = 2;
|
|
DVB_CSA2 = 3;
|
|
DVB_CSA3 = 4;
|
|
AES_OFB = 5;
|
|
AES_SCTE52 = 6;
|
|
}
|
|
// Required. The cipher mode used to encrypt/decrypt the content.
|
|
optional CipherMode cipher_mode = 1;
|
|
// Optional. The minimum age required to watch the content. The value
|
|
// represents actual age, with 0 means no restriction.
|
|
optional uint32 age_restriction = 2 [default = 0];
|
|
}
|
|
|
|
message EcmKeyData {
|
|
// The wrapped content key data (aka control word).
|
|
// Required.
|
|
optional bytes wrapped_key_data = 1;
|
|
// The ID of the entitlement key used to wrap the content key. The secure key
|
|
// data associated with this ID is held by the license server. The client gets
|
|
// the key from the license server through a license request.
|
|
// Required for the even key data, optional for the odd key data if it is the
|
|
// same as the even key data.
|
|
optional bytes entitlement_key_id = 2;
|
|
// IV for decrypting the wrapped_key_data.
|
|
// Required for the even key data, optional for the odd key data if it is the
|
|
// same as the even key data.
|
|
optional bytes wrapped_key_iv = 3;
|
|
// IV for decrypting the content stream.
|
|
// Optional. If not specified in the even key data, 8 bytes 0x00 will be used;
|
|
// If not specified in the odd key data, the same content iv in the even key
|
|
// data will be used.
|
|
optional bytes content_iv = 4;
|
|
}
|
|
|
|
message EcmPayload {
|
|
// Required. Meta info carried by the ECM.
|
|
optional EcmMetaData meta_data = 1;
|
|
// Required. The key data for the even slot.
|
|
optional EcmKeyData even_key_data = 2;
|
|
// Optional. The key data for the odd slot if key rotation is enabled.
|
|
optional EcmKeyData odd_key_data = 3;
|
|
// Optional. Widevine fingerprinting information.
|
|
optional Fingerprinting fingerprinting = 4;
|
|
// Optional. Widevine service blocking information.
|
|
optional ServiceBlocking service_blocking = 5;
|
|
}
|
|
|
|
// The payload field for an ECM with signature.
|
|
message SignedEcmPayload {
|
|
// Serialized EcmPayload.
|
|
optional bytes serialized_payload = 1;
|
|
// ECC (Elliptic Curve Cryptography) signature of |serialized_payload|.
|
|
optional bytes signature = 2;
|
|
} |