USP integrates with DRMtoday via DRMtoday's Java based key ingestion application. Please note that this application is only provided to DRMtoday customers.
To use the tool, select one of the commands to be run by the Java application:
java -jar tools-drmtoday-cli-3.0.20.jar <command>
|ingest -t CENC||Ingests a Common Encryption key|
|deleteByAssetId||Deletes an asset by asset id|
|deleteByKeyId||Deletes an asset by key id|
|genKey||Generates a random value that can be used as a key|
|genKeyId||Generates a UUID to be used as key id|
The output of
genKeyId should be used with the
ingest -t CENC
The key and keyid strings do not have to be generated by the DRMtoday tool, 16 random bytes are sufficient (as long as they are provided by a trusted random number generator).
There are two ways of combining the output of the DRMtoday tool and USP:
- Generate CEK with
genKeyand KID with
ingestKeywith the UUID format of the KID
- Pass the KID as hex (base16) to USP
- Generate both CEK and KID with
- Pass CEK and KID as hex (base16) to USP
In the case of CENC you will need to pass the returned "pssh" value
as well to USP (via the
Generate a content key or keyid:
java -jar tools-drmtoday-cli-3.0.20.jar genKey
411b990533e9911621f1d8c5754f068b, a hex (base16) value.
Never use the same value for content key and keyid. Always generate two different values.
Ingest a key pair:
java -jar tools-drmtoday-cli-3.0.20.jar ingest \ -t CENC \ -e TEST \ -i f2ef66b385b7ee4f02a053b58affcd7a \ -k 411b990533e9911621f1d8c5754f068b \ -s VIDEO_AUDIO \ -a TESTVIDEO_24042014 \ -m DRMTODAY_USER \ -u YOUR_USERNAME \ -p YOUR_PASSWORD
Delete a key pair:
java -jar tools-drmtoday-cli-3.0.20.jar deleteByKeyId \ -t CENC \ -e TEST \ -i f2ef66b385b7ee4f02a053b58affcd7a \ -m DRMTODAY_USER \ -u YOUR_USERNAME \ -p YOUR_PASSWORD
The keys generated and ingested by DRMtoday in the previous example can be used by USP to generate a server manifest for just-in-time (dynamic) packaging or to encrypt a file for offline (static) packaging.