md5_param_name
指令 `md5_param_name` 指定在 NGINX 的安全令牌配置中用于传输 MD5 签名的查询参数名称。
Secure token module for NGINX
语法md5_param_name name;
默认值none
上下文
参数1
说明
指令 md5_param_name 是 NGINX 的 Secure Token 模块的一部分,该模块用于为内容分发网络 (CDNs) 生成安全令牌。配置后,该指令允许用户为将保存安全令牌 MD5 哈希签名的查询参数自定义名称。这在 CDN 提供商要求将令牌作为 URL 查询参数包含的场景中非常重要,尤其是在处理视频流或受保护内容时。\n\n该指令接受一个参数:参数的名称。当需要令牌验证的请求发出时,该模块会将根据多个安全令牌组件计算出的 MD5 哈希附加到请求 URL 中指定的查询参数上。这样可确保 CDN 通过检查参数中包含的签名来验证请求,从而有效增强所访问内容的安全性。正确实现此指令有助于防止未授权访问并确保内容传输保持安全。\n\n必须确保为 md5_param_name 设置的值与 CDN 预期的值完全匹配,以避免令牌验证失败。配置错误可能导致内容无法访问或令牌验证出错,因此在部署时理解该指令的使用上下文至关重要。
配置示例
md5_param_name "signature";
⚠
确保参数名称被 CDN 提供商识别,以避免验证问题。
⚠
别忘了定义关联的密钥和令牌生成设置,因为仅凭参数名称在没有适当配置的情况下无法保证安全。
⚠
使用常见或默认的参数名称可能会与使用相似命名约定的其他应用或服务发生冲突。