kmp_cc_out_ctrl_add_header
The `kmp_cc_out_ctrl_add_header` directive is used to add custom headers to Kaltura Media Framework's control messages in NGINX streaming configurations.
Description
The kmp_cc_out_ctrl_add_header directive allows you to specify custom headers for outgoing control messages processed by the Kaltura Media Framework Common NGINX Module. This directive takes two arguments: the name of the header and the value to be assigned to it, giving you flexibility to modify how your streaming server communicates with clients or other components in your media pipeline. By using this directive, you can tailor your media streaming configurations to suit specific requirements such as authentication, metadata, or service identification that must be included in control messages.
When this directive is included in your stream or stream server context, the specified header will be appended to any outgoing control messages sent through the Kaltura Media Protocol. It is particularly useful in scenarios where you want to send additional information that can help clients process media streams more effectively. This directive facilitates dynamic configurations and enhances the interoperability of various media components that rely on custom headers for proper operation.
Config Example
stream {
server {
kmp_cc_out_ctrl_add_header "X-Kaltura-Auth" "Bearer my_token";
}
}Ensure that the header name is valid and does not conflict with existing headers.
Using incorrect argument count will result in a configuration error.
Headers added may affect how clients or downstream systems handle the control messages.