watermarking

  • Property Manager name: Watermarking
  • Behavior version: The v2023-09-20 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.