captcha_name
'captcha_name' 指令设置用于在 NGINX Captcha 模块中存储生成的验证码值的 cookie 名称。
NGINX Captcha Module
·
httpserverlocation
语法captcha_name string;
默认值Captcha
上下文http, server, location
参数1
说明
'captcha_name' 指令是 NGINX Captcha 模块中的一个配置选项，用于指定将保存生成验证码值的 cookie 名称。该值对于验证验证码非常关键，以确保合法请求被处理并阻止自动提交。默认情况下，该 cookie 命名为 'Captcha'，但可以自定义为任何符合应用要求的字符串。
当用户尝试需要验证码的操作时，服务器会根据指定的参数（例如长度和字符集）生成验证码图片并发送给用户。对应的验证码值会被进行哈希处理，生成的哈希值会存储在由 'captcha_name' 指令指定名称的 cookie 中。在随后的表单提交过程中，可以引用该 cookie 来验证用户是否正确输入了验证码。验证码验证逻辑会检查该 cookie 以确定用户是否输入了正确的验证码。
该指令可以放置在多个上下文中，包括 'http'、'server' 和 'location'，从而在应用中提供灵活性。请确保 cookie 名称在应用范围内唯一，以避免与其他 cookie 冲突。
配置示例
location =/captcha {
captcha;
captcha_name CustomCaptchaName;
}⚠
确保 cookie 名称不会与应用程序中使用的其他 cookie 冲突。
⚠
在用户开始互动之后更改 captcha 名称可能会导致验证问题，因为 cookie 可能无法正确同步。