summaryrefslogtreecommitdiff
path: root/searx/botdetection/__init__.py
diff options
context:
space:
mode:
authorMarkus Heiser <markus.heiser@darmarit.de>2023-05-29 19:46:37 +0200
committerMarkus Heiser <markus.heiser@darmarit.de>2023-06-01 14:38:53 +0200
commit38431d2e142b7da6a9b48aad203f02a2eff7e6fd (patch)
tree102a00847e3d84747b814739d9c6dde465d7139b /searx/botdetection/__init__.py
parentb8c7c2c9aa604fd1fb7be5559c9ad025ceb17aa4 (diff)
[fix] correct determination of the IP for the request
For correct determination of the IP to the request the function botdetection.get_real_ip() is implemented. This fonction is used in the ip_limit and link_token method of the botdetection and it is used in the self_info plugin. A documentation about the X-Forwarded-For header has been added. [1] https://github.com/searxng/searxng/pull/2357#issuecomment-1566211059 Signed-off-by: Markus Heiser <markus.heiser@darmarit.de>
Diffstat (limited to 'searx/botdetection/__init__.py')
-rw-r--r--searx/botdetection/__init__.py20
1 files changed, 17 insertions, 3 deletions
diff --git a/searx/botdetection/__init__.py b/searx/botdetection/__init__.py
index b4de0f9c8..c903b0bb4 100644
--- a/searx/botdetection/__init__.py
+++ b/searx/botdetection/__init__.py
@@ -2,11 +2,25 @@
# lint: pylint
""".. _botdetection src:
-Bot detection methods
----------------------
+X-Forwarded-For
+===============
-The methods implemented in this python package are use by the :ref:`limiter src`.
+.. attention::
+
+ A correct setup of the HTTP request headers ``X-Forwarded-For`` and
+ ``X-Real-IP`` is essential to be able to assign a request to an IP correctly:
+
+ - `NGINX RequestHeader`_
+ - `Apache RequestHeader`_
+
+.. _NGINX RequestHeader:
+ https://docs.searxng.org/admin/installation-nginx.html#nginx-s-searxng-site
+.. _Apache RequestHeader:
+ https://docs.searxng.org/admin/installation-apache.html#apache-s-searxng-site
+
+.. autofunction:: searx.botdetection.get_real_ip
"""
from ._helpers import dump_request
+from ._helpers import get_real_ip