A free, self-hostable news aggregator…
Update documentation of TRUSTED_PROXY syntax and document limitations. (#9283)
Yuchen Shi818b57a9a9c8
diff --git a/Docker/README.md b/Docker/README.mdindex 6eb52ef4e..6f66944b0 100644--- a/Docker/README.md+++ b/Docker/README.md@@ -351,8 +351,8 @@ services:#INTERNAL_HOST_ALLOWLIST: rss-bridge:80 rsshub:1200# Optional parameter, remove for automatic settings, set to 0 to disable,- # or (if you use a proxy) to a space-separated list of trusted IP ranges- # compatible with https://httpd.apache.org/docs/current/mod/mod_remoteip.html#remoteipinternalproxy+ # or (if you use a proxy) to a space-separated list of trusted IPs or CIDR+ # notation for ranges. Domain names are not supported and will be ignored.# This impacts which IP address is logged (X-Forwarded-For or REMOTE_ADDR).# This also impacts external authentication methods;# see https://freshrss.github.io/FreshRSS/en/admins/09_AccessControl.htmldiff --git a/docs/en/admins/09_AccessControl.md b/docs/en/admins/09_AccessControl.mdindex be79681cb..e2e966b5e 100644--- a/docs/en/admins/09_AccessControl.md+++ b/docs/en/admins/09_AccessControl.md@@ -58,13 +58,12 @@ variable containing the email address of the authenticated user (e.g. `REMOTE_USYou may also use the `Remote-User` or `X-WebAuth-User` HTTP headers to integrate with a reverse-proxy’s authentication.-To enable this feature, you need to add the IP range (in CIDR notation) of your trusted proxy in the `trusted_sources` configuration option.-To allow only one IPv4, you can use a `/32` like this: `trusted_sources => [ '192.168.1.10/32' ]`.-Likewise to allow only one IPv6, you can use a `/128` like this: `trusted_sources => [ '::1/128' ]`.+To enable this feature, you need to add the IPs (or ranges in CIDR notation) of your trusted proxy in the `trusted_sources` configuration option.-You may alternatively pass a `TRUSTED_PROXY` environment variable in a format compatible with [Apache’s `mod_remoteip` `RemoteIPInternalProxy`](https://httpd.apache.org/docs/current/mod/mod_remoteip.html#remoteipinternalproxy).+You may alternatively pass a `TRUSTED_PROXY` environment variable, which is a space-separated list of IPs or CIDR notations like this: `192.168.1.10 ::1/128`.+The format is largely compatible with [Apache’s `mod_remoteip` `RemoteIPInternalProxy`](https://httpd.apache.org/docs/current/mod/mod_remoteip.html#remoteipinternalproxy), except that domain names are not supported and will be silently ignored.-> ☠️ WARNING: FreshRSS will trust any IP configured in the `trusted_sources` option, if your proxy isn’t properly secured, an attacker could simply attach this header and get admin access.+> ☠️ WARNING: FreshRSS will trust any IP configured in the `trusted_sources` option and/or the `TRUSTED_PROXY` environment variable. If your proxy isn’t properly secured, an attacker could simply attach this header and get admin access.### Authentik Proxy Provider