This is an automated email from the ASF dual-hosted git repository.
bneradt pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/trafficserver.git
The following commit(s) were added to refs/heads/master by this push:
new 2014479155 ja3_fingerprint.so docs: --modify-incoming (#11226)
2014479155 is described below
commit 2014479155bee9744daa419321718b94ff93440f
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.
---
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
=============
