MediaWiki extensions manual

CrowdSec Release status: experimentalCategory:Experimental extensions
Implementation	Page action Category:Page action extensions
Description	Bouncer Integration with CrowdSec for anti-spam.
Author(s)	MPThLeetalk
MediaWiki	1.35+Category:Extensions with manual MediaWiki version
License	GNU General Public License 2.0 or later
Download	GitHub: project page git repository URL [help ] commit history Note: No localisation updates are provided by translatewiki.net . Category:Extensions in GitHub version control
Parameters $wgCrowdSecEnable $wgCrowdSecAPIUrl $wgCrowdSecAPIKey $wgCrowdSecCache $wgCrowdSecCacheTTL $wgCrowdSecFallbackBan $wgCrowdSecRestrictRead $wgCrowdSecTreatTypesAsBan $wgCrowdSecReportOnly
Added rights crowdsec-bypass Category:Extensions which add rights
Hooks used AbuseFilter-computeVariable Category:AbuseFilter-computeVariable extensions AbuseFilter-generateUserVars Category:AbuseFilter-generateUserVars extensions AbuseFilter-builder Category:AbuseFilter-builder extensions getUserPermissionsErrorsExpensive Category:GetUserPermissionsErrorsExpensive extensions OtherBlockLogLink Category:OtherBlockLogLink extensions

This extension adds anti-spam integration with CrowdSec. As it's working as bouncer, It's mandatory to setup CrowdSec Agent too.

Installation

• Download on GitHub and place the file(s) in a directory called CrowdSec in your extensions/ folder.
• Add the following code at the bottom of your LocalSettings.php file:

  wfLoadExtension( 'CrowdSec' );
  

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

Configuration

sudo cscli bouncers add mediawiki-bouncer

sudo cscli capi register

wfLoadExtension( 'CrowdSec' );
$wgCrowdSecAPIKey = ""; // put lapi key here.

AbuseFilter Integration

There's AbuseFilter integration. The variable crowdsec_blocked is representing...

• false: LAPI Request was failed. or failed to get user ip.
• 'ok': This user is ok to process.
• 'ban': This user is reported for "ban" from LAPI.
• ... and various (custom) types via CrowdSec. including 'captcha'

User rights

• crowdsec-bypass - allows users to bypass crowdsec check.

See also

• Extension:StopForumSpam - main functionality based on this extension.