From fa47148343582c183a12ae2a8974cff50fde338a Mon Sep 17 00:00:00 2001
From: Rich Bowen <rbowen@apache.org>
Date: Sun, 10 May 2026 18:22:17 +0000
Subject: [PATCH] mod_proxy_ajp: Note that Tomcat getAttributeNames() does not
 list AJP-forwarded request attributes (PR 65044)

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1934059 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/mod/mod_proxy_ajp.xml | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/manual/mod/mod_proxy_ajp.xml b/docs/manual/mod/mod_proxy_ajp.xml
index 0a35bb1318..f745684d66 100644
--- a/docs/manual/mod/mod_proxy_ajp.xml
+++ b/docs/manual/mod/mod_proxy_ajp.xml
@@ -111,6 +111,12 @@ ProxyPassReverse "/apps/foo" "http://www.example.com/foo"
     <p>Environment variables whose names have the prefix <code>AJP_</code>
     are forwarded to the origin server as AJP request attributes
     (with the <code>AJP_</code> prefix removed from the name of the key).</p>
+
+    <p>Please be aware that these request attributes are only accessible when
+    directly asking for them using the <code>HttpServletRequest.getAttribute</code>
+    method - Tomcat's implementation of the
+    <a href="https://tomcat.apache.org/tomcat-9.0-doc/api/org/apache/catalina/connector/Request.html#getAttributeNames--"><code>getAttributeNames</code></a>
+    method does not list them as those are handled as internal attributes.</p>
 </section>
 
 <section id="overviewprotocol"><title>Overview of the protocol</title>
-- 
2.47.3