This is an automated email from the ASF dual-hosted git repository.
zwoop pushed a commit to branch 9.2.x
in repository https://gitbox.apache.org/repos/asf/trafficserver.git
The following commit(s) were added to refs/heads/9.2.x by this push:
new c766050d05 ja3_fingerprint.so docs: --modify-incoming (#11226)
c766050d05 is described below
commit c766050d0596303ba89d420bd248bf0ea441bc57
Author: Brian Neradt <[email protected]>
AuthorDate: Mon Apr 8 17:18:42 2024 -0500
ja3_fingerprint.so docs: --modify-incoming (#11226)
This adds a description for --modify-incoming to the ja3_fingerprint.so
docs.
(cherry picked from commit 2014479155bee9744daa419321718b94ff93440f)
---
doc/admin-guide/plugins/ja3_fingerprint.en.rst | 14 +++++++++++++-
1 file changed, 13 insertions(+), 1 deletion(-)
diff --git a/doc/admin-guide/plugins/ja3_fingerprint.en.rst
b/doc/admin-guide/plugins/ja3_fingerprint.en.rst
index 62bf31608d..faada2530a 100644
--- a/doc/admin-guide/plugins/ja3_fingerprint.en.rst
+++ b/doc/admin-guide/plugins/ja3_fingerprint.en.rst
@@ -55,7 +55,6 @@ or :file:`remap.config`.
.. option:: --ja3log
-
This option enables logging to the file ``ja3_fingerprint.log`` in the
standard logging
directory. The format is ::
@@ -63,6 +62,19 @@ or :file:`remap.config`.
By default this is not enabled.
+.. option:: --modify-incoming
+
+ As described above, typically, the ``X-JA3-Sig`` header is added to the
request as it is sent
+ upstream so that any upstream hosts can make use of it. The
``--modify-incoming`` option
+ instructs the plugin to add the ``X-JA3-Sig`` header field earlier on the
incoming request so
+ that other plugins can make use of it while processing the request. To be
precise,
+ ``--modify-incoming`` adds the ``X-JA3-Sig`` header field in the
+ ``TS_HTTP_READ_REQUEST_HDR_HOOK`` hook rather than the default
``TS_HTTP_SEND_REQUEST_HDR_HOOK``
+ hook.
+
+ This option is only useful when the plugin is configured as a global
plugin. By default this
+ is not enabled.
+
Requirement
=============
