Open main menu

Extension:AbuseFilter

This page is a translated version of the page Extension:AbuseFilter and the translation is 100% complete.

Other languages:
Deutsch • ‎English • ‎català • ‎dansk • ‎español • ‎français • ‎galego • ‎italiano • ‎magyar • ‎polski • ‎português • ‎português do Brasil • ‎română • ‎sicilianu • ‎čeština • ‎български • ‎русский • ‎עברית • ‎العربية • ‎سنڌي • ‎فارسی • ‎हिन्दी • ‎中文 • ‎日本語 • ‎粵語 • ‎한국어
Manuel des extensions MediaWiki
OOjs UI icon advanced.svg
AbuseFilter
État de la version : stable
AbuseFilter-Management.png
Implémentation User activity, Special page, API
Description Permet de placer des restrictions spécifiques basées sur des comportements sur le wiki.
Auteur(s)
Compatibility policy release branches
MediaWiki 1.25+
PHP 5.4+ recommandé
Changements
base de données
Oui
Tables abuse_filter
abuse_filter_action
abuse_filter_history
abuse_filter_log
Licence GNU General Public License 2.0 or later
Téléchargement
Paramètres
  • $wgAbuseFilterActions
  • $wgAbuseFilterConditionLimit
  • $wgAbuseFilterEmergencyDisableThreshold
  • $wgAbuseFilterEmergencyDisableCount
  • $wgAbuseFilterEmergencyDisableAge
  • $wgAbuseFilterParserClass
  • $wgAbuseFilterRestrictions
  • $wgAbuseFilterNotifications
  • $wgAbuseFilterNotificationsPrivate
  • $wgAbuseFilterCentralDB
  • $wgAbuseFilterIsCentral
  • $wgAbuseFilterDisallowGlobalLocalBlocks
  • $wgAbuseFilterBlockDuration
  • $wgAbuseFilterAnonBlockDuration
  • $wgAbuseFilterCustomActionsHandler
  • $wgAbuseFilterValidGroups
  • $wgAbuseFilterDefaultWarningMessage
  • $wgAbuseFilterIPMaxAge
  • $wgAbuseFilterProfileActionsCap
Droits ajoutés
  • abusefilter-view
  • abusefilter-log
  • abusefilter-log-detail
  • abusefilter-revert
  • abusefilter-private
  • abusefilter-private-log
  • abusefilter-view-private
  • abusefilter-log-private
  • abusefilter-hidden-log
  • abusefilter-hide-log
  • abusefilter-modify
  • abusefilter-modify-restricted
  • abusefilter-modify-global
Accroches utilisées
EditFilterMerged
GetAutoPromoteGroups
AbortMove
MovePageCheckPermissions
ArticleDelete
RecentChange_save
ListDefinedTags
ChangeTagsListActive
LoadExtensionSchemaUpdates
ContributionsToolLinks
UploadVerifyFile
UploadVerifyUpload
UploadStashFile
MakeGlobalVariablesScript
PageContentSaveComplete
UserMergeAccountFields
ParserOutputStashForEdit
Traduisez l’extension AbuseFilter sur translatewiki.net
Vérifiez la matrice des utilisations et des versions.
Problèmes Tâches ouvertes · Signalez un bug

L’extension AbuseFilter (filtre anti-abus) permet aux utilisateurs privilégiés de positionner des contrôles spécifiques sur les actions des utilisateurs tels que les contributions et de créer des réactions automatiques pour certains comportements. Par exemple, un filtre peut être créé pour empêcher que certains utilisateurs anonymes n'ajoutent des liens externes , ou pour bloquer un utilisateur qui supprime plus de 2000 caractères.

Contents

Prérequis

Il n'y a pas de dépendances requises pour cette extension.

Installation

  • Téléchargez et placez le(s) fichiers (s) dans un répertoire appelé AbuseFilter dans votre dossier extensions/.
  • Utilisez Composer pour installer les dépendances PHP, en entrant composer install --no-dev après s'être positionné dans le répertoire de l'extension. (Voir T173141 pour des complications potentielles.)
  • Ajoutez le code suivant à la fin de votre fichier LocalSettings.php :
    wfLoadExtension( 'AbuseFilter' );
    
  • Lancez le script de mise à jour qui va créer automatiquement les tables de base de données dont cette extension a besoin.
  •   Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Pour les utilisateurs de MediaWiki 1.26 ou précédents :

Les instructions ci-dessous décrivent la nouvelle procédure pour installer cette extension en utilisant wfLoadExtension() Si vous avez besoin d'installer cette extension sur les précédentes versions de MediaWiki (1.26 ou précédent), à la place de wfLoadExtension( 'AbuseFilter' );, vous devez utiliser :

require_once "$IP/extensions/AbuseFilter/AbuseFilter.php";


Droits utilisateur

Une fois que vous avez installé l’extension, vous devez paramétrer les droits utilisateur dans LocalSettings.php.

Droit Description
abusefilter-modify Modifier les filtres antiabus
abusefilter-view Voir les filtres antiabus
abusefilter-log Voir le journal des filtres anti-abus
abusefilter-log-detail Voir les entrées détaillées du journal anti-abus
abusefilter-private Voir les données privées dans le journal anti-abus
abusefilter-modify-restricted Modifier les filtres antiabus qui ont des actions restreintes
abusefilter-modify-global Créer ou modifier les filtres globaux d'abus
abusefilter-revert Révoquer toutes les modifications effectuées par un filtre antiabus donné
abusefilter-view-private Voir les filtres antiabus marqués comme privés
abusefilter-log-private Voir les entrées du journal des filtres antiabus marqués comme privés
abusefilter-hide-log Masquer des entrées dans le journal antiabus
abusefilter-hidden-log Voir les entrées masquées du journal antiabus
abusefilter-private-log Afficher les détails confidentiels du journal d’accès de AbuseFilter

Par exemple, la configuration d’exemple suivante permet aux sysops de faire tout ce qu’ils veulent avec le filtre d’abus, et tout le monde peut voir les journaux et les paramètres publics du filtre :

$wgGroupPermissions['sysop']['abusefilter-modify'] = true;
$wgGroupPermissions['*']['abusefilter-log-detail'] = true;
$wgGroupPermissions['*']['abusefilter-view'] = true;
$wgGroupPermissions['*']['abusefilter-log'] = true;
$wgGroupPermissions['sysop']['abusefilter-private'] = true;
$wgGroupPermissions['sysop']['abusefilter-modify-restricted'] = true;
$wgGroupPermissions['sysop']['abusefilter-revert'] = true;
Les filtres marqués comme privés ne peuvent être vus que par les utilisateurs ayant le droit abusefilter-modify ou abusefilter-view-private.

Créer et gérer des filtres

Une fois l’extension installée, les filtres peuvent être créés, testés, changés, effacés, et on peut accéder aux journaux depuis la page de gestion du filtre anti-abus Special:AbuseFilter.

Configuration

Nom de la variable Valeur par défaut Description
$wgAbuseFilterActions array( 'flag' => true, 'throttle' => true, 'warn' => true, 'disallow' => true, 'blockautopromote' => true, 'block' => true, 'rangeblock' => false, 'degroup' => true, 'tag' => true ) Les actions possibles que peuvent utiliser les filtres anti-abus. Lors de l'ajout d'une nouvelle action, vérifiez si elle est restreinte dans $wgAbuseFilterRestrictions et, si c'est le cas, n'oubliez pas d'ajouter le droit abusefilter-modify-restricted Groupes d'utilisateurs.
$wgAbuseFilterConditionLimit 1000 Le nombre maximum de 'conditions' qui peuvent être utilisées à chaque fois que les filtres sont exécutés à propos d’une modification. (Les filtres les plus complexes demandent plus de 'conditions'.)
$wgAbuseFilterValidGroups [ 'default' ] La liste des "groupes" dans lesquels les filtres peuvent être classés. Par défaut il n'y en a qu'un. D'autres extensions peuvent ajouter des groupes supplémentaires.
$wgAbuseFilterEmergencyDisableThreshold array( 'default' => 0.05 ) Désactiver les filtres s’ils sont actionnés sur plus de X modifications, constituant plus de Y % des Z dernières modifications, s’ils ont été changés dans les S dernières secondes.
$wgAbuseFilterEmergencyDisableCount array( 'default' => 2 )
$wgAbuseFilterEmergencyDisableAge array( 'default' => 86400 )
$wgAbuseFilterParserClass 'AbuseFilterParser' Nom de la classe du parseur du filtre anti-abus.
$wgAbuseFilterRestrictions array( 'block' => true, 'degroup' => true, 'blockautopromote' => true, 'rangeblock' => true ) Les utilisateurs doivent avoir le droit utilisateur "abusefilter-modify-restricted" ainsi que "abusefilter-modify" pour pouvoir créer ou modifier les filtres que supposent ces actions.
$wgAbuseFilterNotifications false Il permet configurer l'extension pour envoyer faire-part de coincidencias à Spécial:CambiosRecientes ou à UDP. Options disponibles: rc, udp, rcandudp
$wgAbuseFilterNotificationsPrivate false Autoriser les notifications pour les filtres privés.
$wgAbuseFilterCentralDB null Nom de la base de données où les filtres anti-abus sont stockés (supporté uniquement dans la dernière version de développement).
$wgAbuseFilterIsCentral false Positionnez cette variable à true (vrai) pour le wiki où les filtres anti-abus sont stockés (supporté uniquement dans la dernière version de développement).
$wgAbuseFilterDisallowGlobalLocalBlocks false Ne permettre que les filtres centralisés réalisent accciones que bloquent, qu'ils éliminent des utilisateurs d'un groupe, ou qu'ils révoquent des permissions de forme locale.
$wgAbuseFilterBlockDuration 'indefinite' Durée des blocages faits par le filtre anti-abus.
à partir de 1.31.0-wmf.25, des durées de bloc peuvent être spécifiées pour chaque filtre et remplacent cette variable. Cette variable est uniquement utilisée lors de l'activation du bloc afin de présélectionner une durée par défaut.
$wgAbuseFilterAnonBlockDuration null Durée des blocages instaurés par AbuseFilter pour des utilisateurs anonymes. Sinon il s'indique une valeur, il s'usera la valeur de $wgAbuseFilterBlockDuration.
à partir de 1.31.0-wmf.25, des durées de bloc peuvent être spécifiées pour chaque filtre et remplacent cette variable. Cette variable est uniquement utilisée lors de l'activation du bloc afin de présélectionner une durée par défaut.
$wgAbuseFilterCustomActionsHandlers array() Fonctions d'appel de tour pour des actions personnalisées.
$wgAbuseFilterDefaultWarningMessage array( 'default' => 'abusefilter-warning' ) Messages d'avis predeterminados, par groupe de filtres.
$wgAbuseFilterLogIPMaxAge 3 * 30 * 24 * 3600 Temps pendant lequel ils peuvent s'allonger les registres avant d'éliminer vieille information de registres de IP. De forme predeterminada sont 3 mois. Le script d'entretien purgeoldlogipdata.php use cette valeur.
$wgAbuseFilterProfileActionsCap 10000 Nombre d'actions qui déterminent quand réinitialiser les statistiques de profilage.


API

Le filtre anti-abus ajoute deux modules dans l’API, un relatif aux détails du filtre anti-abus ("abusefilters") et un relatif au journal des filtrages puisque celui-ci est séparé des autres journaux MediaWiki ("abuselog"). Il n’est pas possible de créer ou de modifier des filtres anti-abus à partir de l’API.

list = abusefilters

Liste les informations sur les filtres

Paramètres
  • abfstartid : l’identifiant du filtre où commencer l’énumération
  • abfendid : l’identifiant du filtre où terminer l’énumération
  • abfdir : la direction dans laquelle se fait l’énumération (older, newer = vers le plus vieux, vers le plus récent)
  • abfshow : ne montrer que les filtres qui répondent à ces critères (enabled|!enabled|deleted|!deleted|private|!private = activé|!activé|effacé|!effacé|privé|!privé)
  • abflimit : le nombre maximum de filtres dans la liste
  • abfprop : quelles propriétés afficher (id|description|pattern|actions|hits|comments|lasteditor|lastedittime|status|private = identifiant|description|motif|actions|nombre d’activations|commentaires|dernier contributeur|date de dernière modification|statut|privé)

Quand les filtres sont privés, quelques-unes des propriétés spécifiées avec abfprop seront manquantes à moins que vous n’ayez les droits utilisateur appropriés.

Exemples

Liste les filtres anti-abus non-privés

list = abuselog

Liste les instances où des actions ont actionné un filtre anti-abus.

Paramètres
  • aflstart : l’identifiant du filtre où commencer l’énumération
  • aflend : l’identifiant du filtre où terminer l’énumération
  • afldir : la direction dans laquelle se fait l’énumération (older, newer = vers le plus vieux, vers le plus récent)
  • afluser : ne montrer que les entrées où l’action est testée pour un utilisateur ou une IP donné.
  • afltitle : ne montrer que les entrées où l’action est testée pour une page donnée.
  • aflfilter : ne montrer que les entrées actionnées par un identifiant de filtre donné
  • afllimit : le nombre maximum d’entrées dans la liste
  • aflprop : quelles propriétés afficher (ids|user|title|action|result|timestamp|details = identifiant|utilisateur|titre|résultat|date|détails)
Exemple

Liste les instance où le filtre anti-abus a été actionné en réponse aux actions de l’utilisateur « SineBot »

Possible errors

  • Some users might experience that creating new filters or modifying old filters fail and the user just gets redirected to the original page. If the Wiki is using SSL certificates, this error could possibly be because of the $wgServer value, which might be using "http://" instead of "https://". An indication of this error will be, the browser giving https warning for Special:AbuseFilter pages. (Topic:T23dyyih0ofjada5)

Voir aussi