DASH Media Packaging SDK
 All Classes Namespaces Functions Variables Typedefs Enumerations Enumerator
widevine_encryption_flags.cc
1 // Copyright 2014 Google Inc. All rights reserved.
2 //
3 // Use of this source code is governed by a BSD-style
4 // license that can be found in the LICENSE file or at
5 // https://developers.google.com/open-source/licenses/bsd
6 //
7 // Defines command line flags for widevine_encryption.
8 
9 #include "packager/app/widevine_encryption_flags.h"
10 
11 #include "packager/app/validate_flag.h"
12 #include "packager/base/logging.h"
13 #include "packager/base/strings/string_piece.h"
14 #include "packager/base/strings/string_util.h"
15 
16 DEFINE_bool(enable_widevine_encryption,
17  false,
18  "Enable encryption with Widevine license server/proxy. User should "
19  "provide either AES signing key (--aes_signing_key, "
20  "--aes_signing_iv) or RSA signing key (--rsa_signing_key_path).");
21 DEFINE_bool(enable_widevine_decryption,
22  false,
23  "Enable decryption with Widevine license server/proxy. User should "
24  "provide either AES signing key (--aes_signing_key, "
25  "--aes_signing_iv) or RSA signing key (--rsa_signing_key_path).");
26 DEFINE_bool(include_common_pssh,
27  false,
28  "When using Widevine encryption, include an additional v1 PSSH box "
29  "for the common system ID that includes the key IDs. See: "
30  "https://goo.gl/s8RIhr");
31 DEFINE_string(key_server_url, "", "Key server url. Required for encryption and "
32  "decryption");
33 DEFINE_hex_bytes(content_id, "", "Content Id (hex).");
34 DEFINE_string(policy,
35  "",
36  "The name of a stored policy, which specifies DRM content "
37  "rights.");
38 DEFINE_int32(max_sd_pixels,
39  768 * 576,
40  "The video track is considered SD if its max pixels per frame is "
41  "no higher than max_sd_pixels. Default: 442368 (768 x 576).");
42 DEFINE_int32(max_hd_pixels,
43  1920 * 1080,
44  "The video track is considered HD if its max pixels per frame is "
45  "higher than max_sd_pixels, but no higher than max_hd_pixels. "
46  "Default: 2073600 (1920 x 1080).");
47 DEFINE_int32(max_uhd1_pixels,
48  4096 * 2160,
49  "The video track is considered UHD1 if its max pixels per frame "
50  "is higher than max_hd_pixels, but no higher than max_uhd1_pixels."
51  " Otherwise it is UHD2. Default: 8847360 (4096 x 2160).");
52 DEFINE_string(signer, "", "The name of the signer.");
53 DEFINE_hex_bytes(aes_signing_key,
54  "",
55  "AES signing key in hex string. --aes_signing_iv is required. "
56  "Exclusive with --rsa_signing_key_path.");
57 DEFINE_hex_bytes(aes_signing_iv, "", "AES signing iv in hex string.");
58 DEFINE_string(rsa_signing_key_path,
59  "",
60  "Stores PKCS#1 RSA private key for request signing. Exclusive "
61  "with --aes_signing_key.");
62 DEFINE_int32(crypto_period_duration,
63  0,
64  "Crypto period duration in seconds. If it is non-zero, key "
65  "rotation is enabled.");
66 
67 namespace shaka {
68 namespace {
69 const bool kOptional = true;
70 } // namespace
71 
73  bool success = true;
74 
75  const bool widevine_crypto =
76  FLAGS_enable_widevine_encryption || FLAGS_enable_widevine_decryption;
77  const char widevine_crypto_label[] =
78  "--enable_widevine_encryption/decryption";
79  // key_server_url and signer (optional) are associated with
80  // enable_widevine_encryption and enable_widevine_descryption.
81  if (!ValidateFlag("key_server_url",
82  FLAGS_key_server_url,
83  widevine_crypto,
84  !kOptional,
85  widevine_crypto_label)) {
86  success = false;
87  }
88  if (!ValidateFlag("signer",
89  FLAGS_signer,
90  widevine_crypto,
91  kOptional,
92  widevine_crypto_label)) {
93  success = false;
94  }
95  if (widevine_crypto && FLAGS_signer.empty() &&
96  base::StartsWith(base::StringPiece(FLAGS_key_server_url), "http",
97  base::CompareCase::INSENSITIVE_ASCII)) {
98  LOG(WARNING) << "--signer is likely required with "
99  "--enable_widevine_encryption/decryption.";
100  }
101 
102  const char widevine_encryption_label[] = "--enable_widevine_encryption";
103  // content_id and policy (optional) are associated with
104  // enable_widevine_encryption.
105  if (!ValidateFlag("content_id",
106  FLAGS_content_id_bytes,
107  FLAGS_enable_widevine_encryption,
108  !kOptional,
109  widevine_encryption_label)) {
110  success = false;
111  }
112  if (!ValidateFlag("policy",
113  FLAGS_policy,
114  FLAGS_enable_widevine_encryption,
115  kOptional,
116  widevine_encryption_label)) {
117  success = false;
118  }
119  if (FLAGS_include_common_pssh && !FLAGS_enable_widevine_encryption) {
120  PrintError("--include_common_pssh is only valid with "
121  "--enable_widevine_encryption");
122  success = false;
123  }
124 
125  if (FLAGS_max_sd_pixels <= 0) {
126  PrintError("--max_sd_pixels must be positive.");
127  success = false;
128  }
129  if (FLAGS_max_hd_pixels <= 0) {
130  PrintError("--max_hd_pixels must be positive.");
131  success = false;
132  }
133  if (FLAGS_max_uhd1_pixels <= 0) {
134  PrintError("--max_uhd1_pixels must be positive.");
135  success = false;
136  }
137  if (FLAGS_max_hd_pixels <= FLAGS_max_sd_pixels) {
138  PrintError("--max_hd_pixels must be greater than --max_sd_pixels.");
139  success = false;
140  }
141  if (FLAGS_max_uhd1_pixels <= FLAGS_max_hd_pixels) {
142  PrintError("--max_uhd1_pixels must be greater than --max_hd_pixels.");
143  success = false;
144  }
145 
146  const bool aes = !FLAGS_aes_signing_key_bytes.empty() ||
147  !FLAGS_aes_signing_iv_bytes.empty();
148  if (aes && (FLAGS_aes_signing_key_bytes.empty() ||
149  FLAGS_aes_signing_iv_bytes.empty())) {
150  PrintError("--aes_signing_key/iv is required if using aes signing.");
151  success = false;
152  }
153 
154  const bool rsa = !FLAGS_rsa_signing_key_path.empty();
155 
156  if (FLAGS_signer.empty() && (aes || rsa)) {
157  PrintError("--signer is required if using aes/rsa signing.");
158  success = false;
159  }
160  if (!FLAGS_signer.empty() && !aes && !rsa) {
161  PrintError(
162  "--aes_signing_key/iv or --rsa_signing_key_path is required with "
163  "--signer.");
164  success = false;
165  }
166  if (aes && rsa) {
167  PrintError(
168  "Only one of --aes_signing_key/iv and --rsa_signing_key_path should be "
169  "specified.");
170  success = false;
171  }
172 
173  if (FLAGS_crypto_period_duration < 0) {
174  PrintError("--crypto_period_duration should not be negative.");
175  success = false;
176  }
177  return success;
178 }
179 
180 } // namespace shaka
void PrintError(const std::string &error_message)
bool ValidateFlag(const char *flag_name, const FlagType &flag_value, bool condition, bool optional, const char *label)
Definition: validate_flag.h:33
bool ValidateWidevineCryptoFlags()