GuideReference
TrainingSupportCommunity
Guide

watermarking

  • Property Manager name: Watermarking
  • Behavior version: The v2024-05-31 rule format supports the watermarking behavior v1.1.
  • Rule format status: GA, stable
  • Access: Read/Write
  • Allowed in includes: Yes

Adds watermarking for each valid user's content. Content segments are delivered from different sources using a pattern unique to each user, based on a watermarking token included in each request. If your content is pirated or redistributed, you can forensically analyze the segments to extract the pattern, and identify the user who leaked the content.

OptionTypeDescriptionRequires
enableboolean

Enables the watermarking behavior.

{"displayType":"boolean","tag":"input","type":"checkbox"}
signature_​verification_​enableboolean

When enabled, you can verify the signature in your watermarking token.

{"displayType":"boolean","tag":"input","type":"checkbox"}
{"if":{"attribute":"enable","op":"eq","value":true}}
verification_​key_​id1string

Specifies a unique identifier for the first public key.

signature_​verification_​enable is true
{"displayType":"string","tag":"input","type":"text"}
{"if":{"attribute":"signatureVerificationEnable","op":"eq","value":true}}
verification_​public_​key1string

Specifies the first public key in its entirety.

signature_​verification_​enable is true
{"displayType":"string","tag":"input","type":"text"}
{"if":{"attribute":"signatureVerificationEnable","op":"eq","value":true}}
verification_​key_​id2string

Specifies a unique identifier for the optional second public key.

signature_​verification_​enable is true
{"displayType":"string","tag":"input","type":"text"}
{"if":{"attribute":"signatureVerificationEnable","op":"eq","value":true}}
verification_​public_​key2string

Specifies the optional second public key in its entirety. Specify a second key to enable rotation.

signature_​verification_​enable is true
{"displayType":"string","tag":"input","type":"text"}
{"if":{"attribute":"signatureVerificationEnable","op":"eq","value":true}}
pattern_​decryption_​enableboolean

If patterns in your watermarking tokens have been encrypted, enabling this allows you to provide values to decrypt them.

{"displayType":"boolean","tag":"input","type":"checkbox"}
{"if":{"attribute":"enable","op":"eq","value":true}}
decryption_​password_​id1string

Specifies a label that corresponds to the primary password.

pattern_​decryption_​enable is true
{"displayType":"string","tag":"input","type":"text"}
{"if":{"attribute":"patternDecryptionEnable","op":"eq","value":true}}
decryption_​password1string

Provides the primary password used to encrypt patterns in your watermarking tokens.

pattern_​decryption_​enable is true
{"displayType":"string","tag":"input","type":"text"}
{"if":{"attribute":"patternDecryptionEnable","op":"eq","value":true}}
decryption_​password_​id2string

Specifies a label for the secondary password, used in rotation scenarios to identify which password to use for decryption.

pattern_​decryption_​enable is true
{"displayType":"string","tag":"input","type":"text"}
{"if":{"attribute":"patternDecryptionEnable","op":"eq","value":true}}
decryption_​password2string

Provides the secondary password you can use to rotate passwords.

pattern_​decryption_​enable is true
{"displayType":"string","tag":"input","type":"text"}
{"if":{"attribute":"patternDecryptionEnable","op":"eq","value":true}}
use_​original_​as_​aboolean

When you work with your watermarking vendor, you can apply several preprocessing methods to your content. See the AMD help for more information. With the standard filename-prefix AB naming preprocessing method, the watermarking vendor creates two variants of the original segment content and labels them as an A and B segment in the filename. If you selected the unlabeled A variant preprocessing method, enabling this option tells your configuration to use the original filename segment content as your A variant.

{"displayType":"boolean","tag":"input","type":"checkbox"}
{"if":{"attribute":"enable","op":"eq","value":true}}
ab_​variant_​locationenum

When you work with your watermarking vendor, you can apply several preprocessing methods to your content. See the AMD help for more information. Use this option to specify the location of the A and B variant segments.

{"displayType":"enum","options":["FILENAME_PREFIX","PARENT_DIRECTORY_PREFIX"],"tag":"select"}
{"if":{"attribute":"enable","op":"eq","value":true}}
FILENAME_​PREFIX

Set for the standard, filename-prefix AB naming preprocessing method, where the variant letter is included in the filename.

PARENT_​DIRECTORY_​PREFIX

Set for the directory-prefix AB naming preprocessing method, where variants are located in a subdirectory named after the variants, such as /B/segment1.​ts.