testcookie_secure_flag

启用为挑战 Cookie 设置 Secure 标志,以增强对跨站脚本(XSS)攻击的防护。

语法testcookie_secure_flag on | off;
默认值off
上下文http, server, location
参数1

说明

testcookie_secure_flag 指令在 NGINX 的 testcookie 机器人缓解模块中,允许管理员为由测试 cookie 机制生成的 cookie 启用 Secure 标志。当设置该标志时,cookie 仅会在安全的 HTTPS 连接上发送,从而减轻数据传输过程中被拦截的风险。要使用此指令,必须将其设置为 onoff,其中 on 启用 Secure 标志,off 禁用该标志。此指令可在 httpserverlocation 上下文中配置,为在 NGINX 配置的不同作用域中实现安全 cookie 提供了灵活性。

通过确保挑战 cookie 被标记为 Secure,该指令增强了整体应用程序安全性,尤其适用于处理敏感信息的网站。在实际使用中,站点管理员需要确保其 NGINX 服务器已配置为通过 HTTPS 提供内容,因为被标记为 Secure 的 cookie 在不安全的 HTTP 连接上不会被传输。这可以通过将服务器设置为监听端口 443 并配置适当的 SSL 证书来实现。此外,如果使用 Secure 标志,还需要正确处理混合内容,以避免浏览器出现安全警告。

配置示例

server {
    listen 443 ssl;
    server_name example.com;
    ssl_certificate /path/to/ssl/certificate.pem;
    ssl_certificate_key /path/to/ssl/key.pem;

    testcookie_secure_flag on;
    testcookie on;
    testcookie_name my_test_cookie;
}

确保您的站点通过 HTTPS 提供服务;带有 Secure flag 的 cookies 不会通过 HTTP 发送。

出于测试目的,如果需要模拟非安全的 cookie 行为,请记得将该指令关闭。

NGINX 服务器的 SSL 配置错误可能导致 cookie 处理出现问题。请确保所有 SSL 参数已正确设置。

← 返回所有指令