Wikimore

**MediaWiki extensions manual**
CrowdSec; Release status: experimentalCategory:Experimental extensions
Implementation	Page actionCategory:Page action extensions
Description	Bouncer Integration with CrowdSec for anti-spam.
Author(s)	MPThLeetalk
Latest version	0.20.0
MediaWiki	1.39+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; $wgCrowdSecFallback; $wgCrowdSecRestrictRead; $wgCrowdSecTreatTypesAsBan; $wgCrowdSecReportOnly;
	Added rights crowdsec-bypass Category:Extensions which add rights;
	Hooks used AbuseFilter-computeVariableCategory:AbuseFilter-computeVariable extensions; AbuseFilter-generateUserVarsCategory:AbuseFilter-generateUserVars extensions; AbuseFilter-builderCategory:AbuseFilter-builder extensions; getUserPermissionsErrorsCategory:GetUserPermissionsErrors extensions; OtherBlockLogLinkCategory:OtherBlockLogLink extensions;

This extension adds anti-spam integration with CrowdSec. It works as a bouncer, so it is mandatory to set up the CrowdSec Agent as well.

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.

Follow this documentation from CrowdSec. You may need to set up collections, logs, and more.

Then, you need to get a bouncer API token.

sudo cscli bouncers add mediawiki-bouncer

Remember the token key. It needs to be added to the extension configuration.

It is highly recommended to register with the Central API to pull blocklists from remote sources.

sudo cscli capi register

wfLoadExtension( 'CrowdSec' );
$wgCrowdSecAPIKey = ""; // Put LAPI key here.

This is the basic configuration. More configurations are documented in the README.

There is no challenge method implemented. You can treat captcha decisions as bans using $wgCrowdSecTreatTypesAsBan.
- It is recommended to use this extension with Extension:ConfirmEdit, which can block certain actions.
This extension has been tested on MediaWiki 1.43. The minimum required version is 1.39+. It may work on older versions.

This extension integrates with AbuseFilter. The variable crowdsec_decision represents the CrowdSec decision:

CrowdSec Release status: experimentalCategory:Experimental extensions
Implementation	Page action Category:Page action extensions
Description	Bouncer Integration with CrowdSec for anti-spam.
Author(s)	MPThLee^talk
Latest version	0.20.0
MediaWiki	1.39+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 $wgCrowdSecFallback $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 getUserPermissionsErrors Category:GetUserPermissionsErrors extensions OtherBlockLogLink Category:OtherBlockLogLink extensions