MediaWiki extensions manual

TrustedXFF Release status: stableCategory:Stable extensions
Description	Handling of trusted proxy addresses (XFF)
Author(s)	Tim Starlingtalk
Latest version	2.0.0
MediaWiki	>= 1.44
License	GNU General Public License 2.0 or later
Download	Download extension Git [?]: Browse repository (Phabricator · GitHub) Gerrit code review Git commit log Download source tarball Category:Extensions in Wikimedia version control
Example	mediawiki.org
Hooks used IsTrustedProxy Category:IsTrustedProxy extensions
Quarterly downloads	2 (Ranked 99th)
Public wikis using	868 (Ranked 275th)
Translate the TrustedXFF extension if it is available at translatewiki.net
Issues	Open tasks · Report a bug

The TrustedXFF extension maintains a list of trusted hosts in a file in a PHP array format. For details, see meta:XFF project.

The file can be generated using the generate.php maintenance script.

Installation

• Download and move the extracted TrustedXFF folder to your extensions/ directory.
  Developers and code contributors should install the extension from Git instead, using:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/TrustedXFF
• Add the following code at the bottom of your LocalSettings.php file:

  wfLoadExtension( 'TrustedXFF' );
  

• Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

See also

• Extension:CheckUser
• Manual:$wgApplyIpBlocksToXff
• $wgGlobalBlockingBlockXFF

This extension is being used on one or more Wikimedia projects. This probably means that the extension is stable and works well enough to be used by such high-traffic websites. Look for this extension's name in Wikimedia's CommonSettings.php and InitialiseSettings.php configuration files to see where it's installed. A full list of the extensions installed on a particular wiki can be seen on the wiki's Special:Version page.