自定义响应重定向策略 (proto)

此扩展的限定名称为 envoy.http.custom_response.redirect_policy

注意

此扩展正在开发中。功能尚不完整，不适合生产使用。

此扩展的安全状况未知，应仅在上下游都可信的部署中使用。

提示

此扩展扩展了以下扩展类别，并可与之一起使用

• envoy.http.custom_response

此扩展必须使用以下类型 URL 之一进行配置

• type.googleapis.com/envoy.extensions.http.custom_response.redirect_policy.v3.RedirectPolicy

警告

此 API 功能目前正在开发中。标记为正在开发中的 API 功能不被视为稳定，不包括在 威胁模型 中，不受安全团队支持，并且可能会发生重大更改。在了解以上所有要点之前，请勿使用此功能。

extensions.http.custom_response.redirect_policy.v3.RedirectPolicy

[extensions.http.custom_response.redirect_policy.v3.RedirectPolicy proto]

自定义响应策略，用于将原始响应内部重定向到不同的上游。

{
  "uri": ...,
  "redirect_action": {...},
  "status_code": {...},
  "response_headers_to_add": [],
  "request_headers_to_add": [],
  "modify_request_headers_action": {...}
}

uri

(string) 用于将原始请求重定向到的 Http URI，以获取自定义响应。它应该是带协议、主机和路径的完整 FQDN。

示例

uri: https://www.mydomain.com/path/to/404.txt

必须精确设置 uri 或 redirect_action 中的一个。

redirect_action

(config.route.v3.RedirectAction) 单独指定重定向 URL 的元素。注意：不要在 redirect_action 中指定 response_code 字段，请使用 status_code 代替。以下 redirect_action 中的字段目前不受支持，指定它们会导致配置被拒绝： - prefix_rewrite - regex_rewrite

必须精确设置 uri 或 redirect_action 中的一个。

status_code

(UInt32Value) 如果指定，则为新的响应状态代码。如果它不是错误状态，则用于覆盖来自新上游的响应的状态代码。

response_headers_to_add

(repeated config.core.v3.HeaderValueOption) 要添加到响应中的 HTTP 标头。这允许响应策略在将原始响应的本地主体或来自远程主体的自定义响应发送到下游客户端之前，追加、添加或覆盖原始响应的标头。请注意，如果重定向的响应是错误响应，则不会应用这些标头。

request_headers_to_add

(repeated config.core.v3.HeaderValueOption) 在内部重定向之前要添加到请求中的 HTTP 标头。

modify_request_headers_action

(config.core.v3.TypedExtensionConfig) 在选择重定向路由之前修改请求标头的自定义操作。