[activemq-artemis] branch master updated: NO-JIRA Add proxy forwarding doc

[cl...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

clebertsuconic pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/activemq-artemis.git


The following commit(s) were added to refs/heads/master by this push:
     new 03a64f6  NO-JIRA Add proxy forwarding doc
     new 7474f11  This closes #3361
03a64f6 is described below

commit 03a64f6b5058d40a319606f1a98bf96715f68145
Author: Domenico Francesco Bruscino <br...@apache.org>
AuthorDate: Tue Dec 1 18:49:01 2020 +0100

    NO-JIRA Add proxy forwarding doc
---
 docs/user-manual/en/web-server.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/docs/user-manual/en/web-server.md b/docs/user-manual/en/web-server.md
index 8e48a36..cd63963 100644
--- a/docs/user-manual/en/web-server.md
+++ b/docs/user-manual/en/web-server.md
@@ -89,3 +89,19 @@ Here is an example configuration:
    <request-log filename="${artemis.instance}/log/http-access-yyyy_MM_dd.log" append="true" extended="true"/>
 </web>
 ```
+
+## Proxy Forwarding
+
+The proxies and load balancers usually support `X-Forwarded` headers
+to send information altered or lost when a proxy is involved
+in the path of the request. Jetty supports the [`ForwardedRequestCustomizer`](https://www.eclipse.org/jetty/javadoc/current/org/eclipse/jetty/server/ForwardedRequestCustomizer.html)
+customizer to handle `X-Forwarded` headers.
+Set the `customizer` attribute via the `web` element to enable the [`ForwardedRequestCustomizer`](https://www.eclipse.org/jetty/javadoc/current/org/eclipse/jetty/server/ForwardedRequestCustomizer.html) customizer, ie:
+
+```xml
+<web bind="http://localhost:8161" path="web" customizer="org.eclipse.jetty.server.ForwardedRequestCustomizer">
+   <app url="activemq-branding" war="activemq-branding.war"/>
+   <app url="artemis-plugin" war="artemis-plugin.war"/>
+   <app url="console" war="console.war"/>
+</web>
+```
\ No newline at end of file