testcookie_refresh_template

为 NGINX 中的 testcookie 挑战/响应机制设置自定义模板。

语法testcookie_refresh_template path;
默认值none
上下文http, server, location
参数1

说明

testcookie_refresh_template 指令定义了一个自定义模板,在 NGINX testcookie 机器人缓解模块为客户端请求生成挑战 cookie 时使用。该指令允许灵活地自定义在 cookie 验证过程中呈现给客户端的 HTML 或 JavaScript。通过使用模板,管理员可以在设置 cookie 阶段提供定制的用户体验,通过个性化界面增强安全性,同时确保挑战在视觉上连贯且功能上可用。

该指令的主要参数是一个字符串,表示自定义模板文件的路径。该文件可以包含 HTML 和 JavaScript,用于指示用户的浏览器如何处理并将挑战 cookie 发送回服务器。如果未指定此指令,模块将回退到其默认行为,通常包括一个标准的设置 cookie 的机制,可能无法考虑自定义品牌或定制的用户体验。必须确保模板遵循为正确的 cookie 处理和响应验证所需的 JavaScript 行为。

testcookie_refresh_template 应在 httpserverlocation 上下文中定义,具体取决于希望为 cookie 挑战应用设置的粒度。用例包括为不同的 location 块或 server 配置使用不同的模板,以根据访问点或 IP 来源细化用户体验。

配置示例

location /path {
    testcookie_refresh_template "/path/to/custom/template.html";
}

确保模板文件路径正确且 NGINX 工作进程可访问。

必须验证自定义模板以确保 JavaScript 正常执行;任何错误可能导致挑战静默失败。

确保在 HTML 中正确转义字符,以避免破坏模板的结构。

← 返回所有指令