shib_request_use_headers
指令 `shib_request_use_headers` 配置 NGINX 使用 Shibboleth 授权器响应中的特定头以便进行后续处理。
Shibboleth Auth Request module for NGINX
·
httpserverlocation
语法shib_request_use_headers on | off;
默认值off
上下文http, server, location
参数flag
说明
指令 shib_request_use_headers 是 NGINX 的 Shibboleth 身份验证请求模块的一部分，允许它利用由配置好的 Shibboleth FastCGI 授权器提供的头。当此指令设置为 'on' 时，NGINX 将从 Shibboleth 响应头中提取用户属性，并在请求处理期间将这些属性用于后续处理。这对于将用户信息传递给后端应用程序或在 NGINX 中的条件配置中使用这些信息尤其有用。该指令的有效性依赖于正确配置 NGINX 服务器和 Shibboleth FastCGI 授权器，因为这些头必须在授权器的响应中被显式设置。
在实际应用中，该指令通过使有关用户身份的特定声明（例如电子邮件或角色）可在整个 NGINX 请求周期中访问，从而实现动态和个性化的用户体验。该指令的参数很简单；它接受一个标志参数，可用于启用或禁用该功能。此灵活性允许管理员根据应用流程或安全要求的需要在每个配置层面上激活或停用头的使用。在从头处理中处理用户属性时应谨慎，以避免与头伪造相关的安全漏洞，特别是当这些头被用于访问控制决策时。
配置示例
http {
server {
location /protected {
shib_request_use_headers on;
shib_request /shibboleth-auth;
}
}
}⚠
确保 Shibboleth authorizer 发送的 headers 已正确定义并填充；否则，它们在 NGINX 中将不可用。
⚠
检查 Shibboleth authorizer 的响应，以确保预期的 headers 已存在。
⚠
NGINX 中预期的 header keys 与 Shibboleth service 发送的 header keys 不匹配时，可能导致未定义的行为。