Extension:TorBlock

MediaWiki extensions manual - list

TorBlock Release status: stable
Implementation	User access
Description	Automatically applies restrictions to Tor exit nodes.
Author(s)	Andrew Garrett (WerdnaTalk)
License	GPL
Download	Download snapshot Subversion [Help] Browse source code View code changes
Parameters $wgTorIPs
Added rights torunblock
Hooks used getUserPermissionsErrorsExpensive AbortAutoblock GetAutoPromoteGroups GetBlockedStatus AutopromoteCondition RecentChange_save ListDefinedTags
Check usage (experimental)

Automatically applies restrictions to Tor exit nodes.

Installation

1. Download the files (using snapshot) to the extensions directory, e.g. put the TorBlock folder in ServerRoot/w/extensions.
2. Add include_once('extensions/TorBlock/TorBlock.php'); in LocalSettings.php.

Parameters

$wgTorBypassPermissions = array( 'torunblocked' );

User account permissions that bypass Tor blocks.

By default, $wgGroupPermissions['user']['torunblocked'] = true; is set, so logged-in users will bypass permissions unless it is set to false.

$wgTorLoadNodes = true;

Load and cache a list of Tor nodes as necessary if the list is not stored in cache under the key 'mw-tor-exit-nodes'. Despite code comments, APC appears to be usable as cache. loadExitNodes.php can be used in a cron job instead of this.

$wgTorIPs = array( '208.80.152.2' );

An array of IP addresses that the wiki server uses. Only exit nodes allowed to connect to these IPs will be returned in the internal list.

$wgTorDisableAdminBlocks = true;

Disables existing Tor blocks made by admins

$wgTorAutoConfirmAge = 0;

$wgTorAutoConfirmCount = 0;

Like $wgAutoConfirmAge and $wgAutoConfirmCount. Both sets of limits must be passed for an account to be granted autoconfirmed status.

$wgTorAllowedActions = array( 'read' );

Permissions allowed to Tor anonymous users. By default, Tor users cannot create accounts.

NOTE

There have been reports of this module not functioning properly. Its status as stable may need to be updated.

Here it's said that it needs cron, supposedly to update the list of TOR nodes from the external source, but doesn't explains precisely what sort of cron etc.

You need to run loadExitNodes.php regularly (for instance every half hour) to load nodes from an external source and put them in memcache; no reliable source (with regard to uptime) currently exists, but Wikimedia projects as of 2011 use https://check.torproject.org/cgi-bin/TorBulkExitList.py?ip=91.198.174.232 (replace ip with the server ip). The script can break if run with the php -n tag.

Language:	English  • Русский