如何通过Nginx Ingress规则修改Set-Cookie头为亲和性Cookie添加Secure标记
所有配置均无需修改控制器核心代码,完全基于Ingress原生的自定义配置能力实现。
前置校验
在开始配置前先确认两个基础前提,否则任何配置都不会生效:
- 前置代理转发到Ingress的请求中,必须携带
X-Forwarded-Proto: https请求头,标记原始用户请求的实际HTTPS协议 - Nginx Ingress全局ConfigMap中已开启
use-forwarded-headers: "true",确保Ingress会信任并读取上述转发头的协议值,不会把内部HTTP转发的协议当成用户实际请求协议
注:Nginx Ingress默认的亲和性Cookie自动加Secure逻辑,是基于Ingress接收到的直接请求协议判定的,哪怕配置了信任转发头,部分旧版本的自动逻辑也不会读取X-Forwarded-Proto的值,因此会出现本该加Secure却没加的问题,这也是需要上述强制配置的核心原因。
方案1:适配Nginx Ingress v1.11.0及以上版本
该版本底层内置Nginx 1.21.4+,原生支持proxy_cookie_flags指令,可直接通过注解实现低侵入配置:
在对应业务的Ingress资源中添加注解,将亲和性Cookie(默认名称为INGRESSCOOKIE,自定义名称的场景替换为实际Cookie名)标记为强制追加Secure属性:
nginx.ingress.kubernetes.io/server-snippet: | proxy_cookie_flags <你的亲和性Cookie名> secure;
配置生效逻辑:Ingress生成对应Cookie的Set-Cookie响应头后,会自动在响应内容末尾追加Secure属性,完全不改动Cookie原有的域、路径、过期时间、SameSite策略等配置。
方案2:适配Nginx Ingress v1.11.0以下旧版本
旧版本无原生proxy_cookie_flags透传能力,可借助Ingress默认内置的ngx_headers_more模块,直接对已生成的Set-Cookie响应头做正则匹配改写,实现相同效果:
在对应业务的Ingress资源server-snippet注解中添加如下配置:
# 匹配携带目标亲和性Cookie的Set-Cookie响应,在原有内容末尾追加secure标记 more_set_headers 'Set-Cookie $sent_http_set_cookie; secure' if ($sent_http_set_cookie ~* "<你的亲和性Cookie名>");
配置生效逻辑:模块会读取Ingress已经生成的完整Set-Cookie内容,在末尾拼接secure参数后重新写回响应头。该配置并不是单纯新增重复的Set-Cookie响应头,而是完全替换原有已生成的头内容,解决了“只能新增头、无法修改已有Set-Cookie”的场景痛点,也不会破坏原有Cookie的配置字段。
生效验证方法
配置部署完成后,通过curl模拟前置代理的转发规则验证:
curl -H "X-Forwarded-Proto: https" http://<Ingress服务访问地址>/<对应业务路由路径> -I
检查返回报文的Set-Cookie头中是否包含Secure标记,即可确认配置是否生效。
内容的提问来源于stack exchange,提问作者Matthias M

