Skip to content

HlsContentProtection

Source code in docs_src/capo_elastic_transcoder/types/hls_content_protection.py
class HlsContentProtection(TypedDict, closed=True):
    method: NotRequired[
        "capo_elastic_transcoder.types.hls_content_protection_method.HlsContentProtectionMethod"
    ]
    """<p>The content protection method for your output. The only valid value is: <code>aes-128</code>.</p> <p>This value is written into the method attribute of the <code>EXT-X-KEY</code> metadata tag in the output playlist.</p>"""
    key: NotRequired[
        "capo_elastic_transcoder.types.base64_encoded_string.Base64EncodedString"
    ]
    """<p>If you want Elastic Transcoder to generate a key for you, leave this field blank.</p> <p>If you choose to supply your own key, you must encrypt the key by using AWS KMS. The key must be base64-encoded, and it must be one of the following bit lengths before being base64-encoded:</p> <p> <code>128</code>, <code>192</code>, or <code>256</code>. </p>"""
    key_md5: NotRequired[
        "capo_elastic_transcoder.types.base64_encoded_string.Base64EncodedString"
    ]
    """<p>If Elastic Transcoder is generating your key for you, you must leave this field blank.</p> <p>The MD5 digest of the key that you want Elastic Transcoder to use to encrypt your output file, and that you want Elastic Transcoder to use as a checksum to make sure your key was not corrupted in transit. The key MD5 must be base64-encoded, and it must be exactly 16 bytes before being base64- encoded.</p>"""
    initialization_vector: NotRequired[
        "capo_elastic_transcoder.types.zero_to255_string.ZeroTo255String"
    ]
    """<p>If Elastic Transcoder is generating your key for you, you must leave this field blank.</p> <p>The series of random bits created by a random bit generator, unique for every encryption operation, that you want Elastic Transcoder to use to encrypt your output files. The initialization vector must be base64-encoded, and it must be exactly 16 bytes before being base64-encoded.</p>"""
    license_acquisition_url: NotRequired[
        "capo_elastic_transcoder.types.zero_to512_string.ZeroTo512String"
    ]
    """<p>The location of the license key required to decrypt your HLS playlist. The URL must be an absolute path, and is referenced in the URI attribute of the EXT-X-KEY metadata tag in the playlist file.</p>"""
    key_storage_policy: NotRequired[
        "capo_elastic_transcoder.types.key_storage_policy.KeyStoragePolicy"
    ]
    """<p>Specify whether you want Elastic Transcoder to write your HLS license key to an Amazon S3 bucket. If you choose <code>WithVariantPlaylists</code>, <code>LicenseAcquisitionUrl</code> must be left blank and Elastic Transcoder writes your data key into the same bucket as the associated playlist.</p>"""

initialization_vector instance-attribute

initialization_vector: NotRequired[ZeroTo255String]

If Elastic Transcoder is generating your key for you, you must leave this field blank.

The series of random bits created by a random bit generator, unique for every encryption operation, that you want Elastic Transcoder to use to encrypt your output files. The initialization vector must be base64-encoded, and it must be exactly 16 bytes before being base64-encoded.

key instance-attribute

key: NotRequired[Base64EncodedString]

If you want Elastic Transcoder to generate a key for you, leave this field blank.

If you choose to supply your own key, you must encrypt the key by using AWS KMS. The key must be base64-encoded, and it must be one of the following bit lengths before being base64-encoded:

128, 192, or 256.

key_md5 instance-attribute

key_md5: NotRequired[Base64EncodedString]

If Elastic Transcoder is generating your key for you, you must leave this field blank.

The MD5 digest of the key that you want Elastic Transcoder to use to encrypt your output file, and that you want Elastic Transcoder to use as a checksum to make sure your key was not corrupted in transit. The key MD5 must be base64-encoded, and it must be exactly 16 bytes before being base64- encoded.

key_storage_policy instance-attribute

key_storage_policy: NotRequired[KeyStoragePolicy]

Specify whether you want Elastic Transcoder to write your HLS license key to an Amazon S3 bucket. If you choose WithVariantPlaylists, LicenseAcquisitionUrl must be left blank and Elastic Transcoder writes your data key into the same bucket as the associated playlist.

license_acquisition_url instance-attribute

license_acquisition_url: NotRequired[ZeroTo512String]

The location of the license key required to decrypt your HLS playlist. The URL must be an absolute path, and is referenced in the URI attribute of the EXT-X-KEY metadata tag in the playlist file.

method instance-attribute

method: NotRequired[HlsContentProtectionMethod]

The content protection method for your output. The only valid value is: aes-128.

This value is written into the method attribute of the EXT-X-KEY metadata tag in the output playlist.