pckg_m3u8_enc_key_format_versions
The `pckg_m3u8_enc_key_format_versions` directive configures the supported encryption key format versions for m3u8 playlist files.
Description
The pckg_m3u8_enc_key_format_versions directive is used within the Kaltura Media Framework's NGINX module to specify which encryption key format versions are supported when generating m3u8 playlist files. These key formats are essential for implementing encryption and Digital Rights Management (DRM) in media streams. By configuring this directive, administrators can control which versions of the encryption keys are acceptable, providing a means to enforce security measures and compatibility with various client devices.
When this directive is set, it impacts how the server responds to client requests for media content that utilizes encryption. An incorrect or unsupported value may lead to failures in media playback, as clients may not be able to locate or utilize the necessary encryption keys. This is particularly relevant in environments where multiple clients with varying capabilities attempt to access the same media content. Thus, careful configuration of the accepted versions is critical for ensuring a seamless streaming experience.
This directive accepts a single argument representing the version or versions of the encryption key formats that are to be allowed. The formats specified, typically in a comma-separated list, dictate how the server will behave in terms of key transmission and lifecycle management. It must be placed within the contexts of HTTP, server, or location blocks to take effect correctly.
Config Example
http {
server {
location /media {
pckg_m3u8_enc_key_format_versions "1,2,3";
}
}
}Ensure that the specified versions are supported by all client devices accessing the media.
Misconfiguration can lead to media playback failures due to unsupported key formats.
It's important to check compatibility with other directives that may affect encryption settings.