如何将Apache请求级环境变量传递至NestJS(Node)应用？

核心问题 #

Apache的SetEnv设置的是服务器内部的环境变量，这类变量仅在Apache进程内部生效，无法直接通过ProxyPass传递给后端Node.js应用——因为Node应用是独立运行的进程，Apache没有权限修改其他进程的环境变量，且进程级环境变量是启动时固定的，无法动态适配每个请求的用户属性（比如SAML返回的用户信息）。

如果你的需求是传递静态全局变量（比如示例中的YOUR_VARIABLE_NAME固定值），或者动态SAML用户属性，可以按以下方式配置：

1. 传递静态全局变量到后端 #

要把Apache内部的静态变量传给Node应用，需要将其转换为请求头，后端通过读取请求头获取值。有两种配置方式：

方式一：直接设置请求头

LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so
LoadModule rewrite_module modules/mod_rewrite.so

<VirtualHost *:80>
    <Location />
            # 直接设置请求头，后端通过req.headers['x-your-variable-name']读取
            RequestHeader set X-YOUR-VARIABLE-NAME "value"
            
            AuthType shibboleth
            ShibRequestSetting requireSession 1
            ShibUseHeaders On
            Require shibboleth
            
            ProxyPass http://127.0.0.1:3000/
            ProxyPassReverse http://127.0.0.1:3000/
    </Location>
    
    <Location /Shibboleth.sso>
            ProxyPass !
            SetHandler shib
            AuthType None
            Require all granted
    </Location>
</VirtualHost>

方式二：从Apache内部环境变量转请求头

如果已经用SetEnv定义了变量，可以通过表达式将其转为请求头：

<Location />
        SetEnv YOUR_VARIABLE_NAME "value"
        # 将Apache内部环境变量转为请求头
        RequestHeader set X-YOUR-VARIABLE-NAME expr=%{ENV:YOUR_VARIABLE_NAME}
        
        # 其余Shibboleth和Proxy配置同上
</Location>

2. 传递SAML动态用户属性 #

你提到的优先用“环境变量”传递SAML属性的需求存在误区：SAML属性是每个请求的用户专属数据，无法作为Node进程的全局环境变量（会导致多请求数据冲突）。正确的做法是继续使用ShibUseHeaders On，让Apache把SAML属性转为Shib-*前缀的请求头（比如Shib-uid、Shib-email），然后在NestJS应用中直接读取这些请求头。

如果希望在NestJS中把这些属性当作“请求级的环境变量”使用，可以通过中间件统一处理：

// NestJS中间件示例
import { Injectable, NestMiddleware } from '@nestjs/common';
import { Request, Response, NextFunction } from 'express';

@Injectable()
export class ShibAttrMiddleware implements NestMiddleware {
  use(req: Request, res: Response, next: NextFunction) {
    // 从请求头读取SAML属性，挂载到req对象的自定义字段
    req.userAttrs = {
      uid: req.headers['shib-uid'],
      email: req.headers['shib-email'],
      // 其他SAML属性
    };
    next();
  }
}

关键配置补充 #

• 必须加载mod_proxy_http模块：否则ProxyPass无法正确处理HTTP请求头的传递。
• 加入ProxyPassReverse：确保后端返回的重定向URL被正确改写为前端访问的域名，避免客户端直接访问后端地址。

内容的提问来源于stack exchange，提问作者orlb