From aeb5d695e6b9eaf775b90e95c21bd9b976752540 Mon Sep 17 00:00:00 2001 From: Stephan Zuercher Date: Wed, 4 Sep 2019 16:32:46 -0700 Subject: [PATCH] docs: note which header expressions cannot be used for request headers (#8138) As discussed in #8127, some custom header expressions evaluate as empty when used in request headers. Risk Level: low, docs only Testing: n/a Docs Changes: updated Release Notes: n/a Signed-off-by: Stephan Zuercher --- docs/root/configuration/http/http_conn_man/headers.rst | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/root/configuration/http/http_conn_man/headers.rst b/docs/root/configuration/http/http_conn_man/headers.rst index bfb3a0682ad7..0a5a1877f7fd 100644 --- a/docs/root/configuration/http/http_conn_man/headers.rst +++ b/docs/root/configuration/http/http_conn_man/headers.rst @@ -602,9 +602,13 @@ Supported variable names are: namespace and key(s) are specified as a JSON array of strings. Finally, percent symbols in the parameters **do not** need to be escaped by doubling them. + Upstream metadata cannot be added to request headers as the upstream host has not been selected + when custom request headers are generated. + %UPSTREAM_REMOTE_ADDRESS% Remote address of the upstream host. If the address is an IP address it includes both address - and port. + and port. The upstream remote address cannot be added to request headers as the upstream host + has not been selected when custom request headers are generated. %PER_REQUEST_STATE(reverse.dns.data.name)% Populates the header with values set on the stream info filterState() object. To be