kmp_ctrl_add_header
指令 `kmp_ctrl_add_header` 将自定义头添加到 Kaltura Media Framework API 的响应中。
Kaltura Media Framework Common NGINX Module
语法kmp_ctrl_add_header header_name value;
默认值none
上下文
参数2
说明
指令 kmp_ctrl_add_header 允许管理员在对 Kaltura Media Framework API 的响应中指定自定义 HTTP 头。此功能可用于在 Kaltura 基础设施的媒体处理组件发送的标准响应中传递附加的上下文、元数据或控制信息。
该指令接受两个参数：头的名称和要为该头设置的值。当 Kaltura API 处理请求时，它会评估 kmp_ctrl_add_header 指令并在每个响应中包含指定的头。该机制有助于在 HTTP 响应中增强信息，这些信息对使用媒体 API 的客户端可能至关重要，例如版本信息、客户端跟踪或用于管理媒体内容访问的安全令牌。
还应注意，可以使用多个 kmp_ctrl_add_header 指令来设置多个不同的头。每次调用都会在响应中产生一个新的头。需要注意避免与 Kaltura Media Framework API 中可能已定义的标准 HTTP 头冲突。
配置示例
kmp_ctrl_add_header "X-Custom-Header" "MyValue";
⚠
确保标头名称不会与现有 HTTP 标准标头冲突，以避免出现意外行为。
⚠
在标头值中处理敏感信息时要谨慎，尤其是在面向公众的 APIs 中。