captcha_csrf

`captcha_csrf` 指令定义用于 CAPTCHA 验证的 CSRF 变量名称。

语法captcha_csrf string;
默认值csrf
上下文http, server, location
参数1

说明

captcha_csrf 指令是 NGINX Captcha Module 的一部分,用于指定与 CAPTCHA 功能相关联的跨站请求伪造 (CSRF) 变量的名称。该指令对于维护安全性至关重要,因为它确保被验证的 CAPTCHA 与预期的 CSRF 令牌相对应。默认情况下,该变量设置为 'csrf',但可以根据特定应用或实现的需要进行自定义。\n\n通过使用 captcha_csrf 指令,管理员可以定义在 CAPTCHA 验证阶段使用的 CSRF 变量名称。当用户提交包含 CAPTCHA 的表单时,系统会同时验证 CAPTCHA 响应和 CSRF 令牌,以确保请求是合法的,从而防止 CSRF 攻击。该指令的配置通常在 httpserverlocation 的上下文中进行,允许根据应用不同区域的需要灵活设置。\n\n在存在多个表单或端点需要不同 CSRF 变量名称的配置场景中,该指令尤其有用。通过指定 captcha_csrf,可以确保在 CAPTCHA 验证过程中检查到正确的变量,从而增强应用工作流的整体安全性。

配置示例

location =/login {
    captcha_csrf my_csrf_var;
    ...
}

确保指定的 CSRF 变量在应用程序的表单和验证逻辑中保持一致。

如果未正确设置 CSRF 变量,可能导致 CAPTCHA 验证失败,从而使合法请求被拒绝。

← 返回所有指令