ForwardAuth

forwardAuth 中间件将认证委托给外部服务。 如果该服务返回 2XX 状态码，则授予访问权限，并执行原始请求。 否则，将返回认证服务器的响应。

配置示例¶

# Forward authentication to example.com
http:
  middlewares:
    test-auth:
      forwardAuth:
        address: "https://example.com/auth"

# Forward authentication to example.com
[http.middlewares]
  [http.middlewares.test-auth.forwardAuth]
    address = "https://example.com/auth"

# Forward authentication to example.com
labels:
  - "traefik.http.middlewares.test-auth.forwardauth.address=https://example.com/auth"

// Forward authentication to example.com
{
  "Tags" : [
    "traefik.http.middlewares.test-auth.forwardauth.address=https://example.com/auth"
  ]
}

# Forward authentication to example.com
apiVersion: traefik.io/v1alpha1
kind: Middleware
metadata:
  name: test-auth
spec:
  forwardAuth:
    address: https://example.com/auth

配置选项¶

authResponseHeadersRegex 响应头正则表达式¶

允许使用正则表达式对请求头名称进行部分匹配。

应使用字符串起始（^）和字符串结束（$）锚点，确保完整匹配请求头名称。

可以使用 Go Playground 或 Regex101 等在线工具测试正则表达式和替换规则。

maxBodySize 请求体大小上限¶

maxBodySize 选项控制转发给认证服务器的请求体最大大小。

⚠️ 重要安全注意事项

默认情况下，未设置 maxBodySize（值为 -1），即请求体大小不受限制。这可能带来显著的安全和性能影响：

• 安全风险：攻击者可能发送极大的请求体，导致 DoS 攻击或内存耗尽。
• 性能影响：大型请求体消耗内存和处理资源，影响整个系统的性能。
• 资源消耗：不受限制的请求体大小可能导致非预期的资源使用情况。

建议配置

强烈建议根据具体使用场景设置合适的 maxBodySize 值：

# For most web applications (1MB limit)
maxBodySize: 1048576  # 1MB in bytes

# For API endpoints expecting larger payloads (10MB limit)  
maxBodySize: 10485760  # 10MB in bytes

# For file upload authentication (100MB limit)
maxBodySize: 104857600  # 100MB in bytes

设置 maxBodySize 的指导原则

• Web 表单：1–5MB 通常足以满足大多数表单提交。
• API 端点：考虑预期最大的 JSON/XML 负载，并预留余量。
• 文件上传：根据预期最大的文件大小设置。
• 高流量服务：使用较小限制，避免资源耗尽。

maxResponseBodySize 响应体大小上限¶

maxResponseBodySize 选项定义认证服务器响应体允许的最大大小，单位为字节。 如果响应体超过配置的限制，则以 401（未授权）状态拒绝请求。 未设置时，请求体大小不受限制，可能带来性能或安全影响。

trustForwardHeader 信任转发头¶

将 trustForwardHeader 选项设为 true，即可信任所有 X-Forwarded-* 请求头。

转发请求头¶

以下请求属性会以 X-Forwarded- 请求头的形式提供给转发认证目标端点。