Phabricator Projekt: #AbuseFilter
Erweiterung:Missbrauchsfilter
Jump to navigation
Jump to search
 Erscheinungsstatus: stabil |
|||
|---|---|---|---|
 |
|||
| Einbindung | User activity, Special page, API | ||
| Beschreibung | Allows specific behavior-based restrictions to be placed on wiki activity | ||
| Autor(en) |
|
||
| Kompatibilitätspolitik | Release-Zweige | ||
| MediaWiki | 1.25+ | ||
| PHP | 5.4+ benötigt | ||
| Datenbankänderungen | Ja | ||
| Tabellen | abuse_filter abuse_filter_action abuse_filter_history abuse_filter_log |
||
| Lizenz | GNU General Public License 2.0 or later | ||
| Herunterladen | |||
|
|||
|
|||
| Übersetze die AbuseFilter Erweiterung wenn sie auf translatewiki.net verfügbar ist | |||
| Prüfe die Benutzungs- und Versionsmatrix. | |||
| Probleme | Offene Aufgaben · Einen Fehler melden | ||
Die „Missbrauchsfilter“-Erweiterung erlaubt privilegierten Benutzern, bestimmte Aktionen durchzufführen wenn von Benutzern durchgeführte Aktionen, wie Bearbeitungen, bestimmte Kriterien erfüllen. For example, a filter could be created to prevent anonymous users from adding external links, or to block a user who removes more than 2000 characters.
Contents
Voraussetzungen
There are no required dependencies for this extension.
Installation
- Lade die Erweiterung herunter und lege die Datei(en) in ein Verzeichnis namens
AbuseFilterin deinem Ordnerextensions/ab. - Führe Composer mit
composer installim Erweiterungsverzeichnis aus, um die PHP-Abhängigkeiten zu installieren (Siehe T173141 für mögliche Komplikationen.) - Füge folgenden Code am Ende deiner LocalSettings.php hinzu:
wfLoadExtension( 'AbuseFilter' );
- Führe das Aktualisierungsskript aus, welches automatisch die notwendigen Datenbanktabellen erstellt, die diese Erweiterung braucht.
Erledigt – Navigiere zu Special:Version in deinem Wiki (bei Einstellung auf deutsch nach Spezial:Version), um zu prüfen, dass die Erweiterung erfolgreich installiert ist.
Erledigt – Navigiere zu Special:Version in deinem Wiki (bei Einstellung auf deutsch nach Spezial:Version), um zu prüfen, dass die Erweiterung erfolgreich installiert ist.An Nutzer, die MediaWiki 1.26 und früher betreiben:
Die oben stehenden Anweisungen beschreiben den neuen Weg der Installation von diese Erweiterung per wfLoadExtension(). Falls du diese Erweiterung in einer dieser früheren Versionen (MediaWiki 1.26 und früher) – an Stelle von wfLoadExtension( 'AbuseFilter' ); – installieren musst, benutze:
require_once "$IP/extensions/AbuseFilter/AbuseFilter.php";
Benutzerrechte
Wenn du die Erweiterung ubstalliert hast, musst du die Benutzerrecte in LocalSettings.php eintragen.
| Rechte | Beschreibung |
|---|---|
| abusefilter-modify | Missbrauchsfilter bearbeiten |
| abusefilter-view | Missbrauchsfilter ansehen |
| abusefilter-log | Missbrauchsfilter-Logbuch einsehen |
| abusefilter-log-detail | Erweitertes Missbrauchsfilter-Logbuch einsehen |
| abusefilter-private | Private Daten im Missbrauchsfilter-Logbuch einsehen |
| abusefilter-modify-restricted | Missbrauchsfilter mit privilegierten Aktionen bearbeiten |
| abusefilter-modify-global | Globale Missbrauchsfilter erstellen oder verändern |
| abusefilter-revert | Alle Bearbeitungen durch einen bestimmten Missbrauchsfilter rückgängig machen |
| abusefilter-view-private | Als privat markierten Missbrauchsfilter einsehen |
| abusefilter-log-private | Als privat markierten Einträge im Missbrauchsfilter einsehen |
| abusefilter-hide-log | Einträge aus dem Missbrauchsfilter-Logbuch ausblenden |
| abusefilter-hidden-log | Versteckte Einträge im Missbrauchsfilter-Logbuch einsehen |
| abusefilter-private-log | Das Missbrauchsfilter-Private-Einzelheiten-Zugriffs-Logbuch ansehen |
Die folgende Beispielkonfiguartion würde zum Beispiel Administratoren erlauben, alles mit den Missbrauchsfiltern zu machen, und jedem das Logbuch und die Einstellungen öffentlicher Filter zu sehen.
$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;
Filter, die als privat markiert sind, können nur von Benutzern angesehen werden, die entweder das abusefilter-modify oder das abusefilter-view-private-Recht besitzen.
Creating and managing filters
Ist die Erweiterung einmal installiert, können Filter über die Missbrauchsfilter-Verwaltungsseite Spezial:Missbrauchsfilter erstellt, getestet, geändert unnd gelöscht werden. Dort kann auch auf die Logbücher zugegriffenwerden.
- Rules format - The basics of how to write a filter
- Actions
- Global Rules
- Guide to optimizing condition limit usage
- To import filters from Wikipedia: When you have installed the extension, go to w:Special:AbuseFilter, choose a filter (say w:Special:AbuseFilter/3), then click "Export this filter to another wiki", copy the text, go to "Special:AbuseFilter/import" on your wiki, paste the text.
Konfiguration
| Name der Variablen | Standardwert | Beschreibung | ||
|---|---|---|---|---|
| $wgAbuseFilterActions | array( 'flag' => true, 'throttle' => true, 'warn' => true, 'disallow' => true, 'blockautopromote' => true, 'block' => true, 'rangeblock' => false, 'degroup' => true, 'tag' => true )
|
Diese möglichen Aktionen können durch Missbrauchsfilter getätigt werden. When adding a new action, check if it is restricted in $wgAbuseFilterRestrictions and, if it is, don't forget to add the abusefilter-modify-restricted right to the appropriate user groups.
| ||
| $wgAbuseFilterConditionLimit | 1000 | The maximum number of 'conditions' that can be used each time the filters are run against a change. (More complex filters require more 'conditions'). | ||
| $wgAbuseFilterValidGroups | 'default' | The list of "groups" filters can be divided into. By default there is only one group. | ||
| $wgAbuseFilterEmergencyDisableThreshold | array( 'default' => 0.05 )
|
Disable a filter if it matched more than 2 edits, constituting more than 5 % of the actions which were checked against the filter's group in the "observed" period (at most one day), unless the filter has been changed in the last 86400 seconds (one day) | ||
| $wgAbuseFilterEmergencyDisableCount | array( 'default' => 2 )
| |||
| $wgAbuseFilterEmergencyDisableAge | array( 'default' => 86400 )
| |||
| $wgAbuseFilterParserClass | 'AbuseFilterParser'
|
Name of AbuseFilter's parser class. | ||
| $wgAbuseFilterRestrictions | array( 'block' => true, 'degroup' => true, 'blockautopromote' => true, 'rangeblock' => true )
|
Users must have the "abusefilter-modify-restricted" user right as well as "abusefilter-modify" in order to create or modify filters which carry out these actions. | ||
| $wgAbuseFilterNotifications | false
|
Allows to configure the extension to send hit notifications to Special:RecentChanges or UDP. Available options: rc, udp, rcandudp | ||
| $wgAbuseFilterNotificationsPrivate | false
|
Enable notifications for private filters. | ||
| $wgAbuseFilterCentralDB | null
|
Name of a database where global abuse filters will be stored in (only supported in the latest, development version). | ||
| $wgAbuseFilterIsCentral | false
|
Set this variable to true for the wiki where global AbuseFilters are stored in (only supported in the latest, development version). | ||
| $wgAbuseFilterDisallowGlobalLocalBlocks | false
|
Disallow Centralised filters from taking actions that locally block, remove from groups, or revoke permissions. | ||
| $wgAbuseFilterBlockDuration | 'indefinite'
|
Duration of blocks made by AbuseFilter.
as of 1.31.0-wmf.25 block durations may be specified for every single filter and will override this variable. This variable is only used when enabling the block in order to preselect a default duration.
| ||
| $wgAbuseFilterAnonBlockDuration | null
|
Duration of blocks made by AbuseFilter on users who are not logged in. The value of $wgAbuseFilterBlockDuration will be used if this is not set.
as of 1.31.0-wmf.25 block durations may be specified for every single filter and will override this variable. This variable is only used when enabling the block in order to preselect a default duration.
| ||
| $wgAbuseFilterCustomActionsHandlers | array()
|
Callback functions for custom actions. | ||
| $wgAbuseFilterValidGroups | array('default')
|
Valid "filter groups" – used for applying edit filters to certain types of actions | ||
| $wgAbuseFilterDefaultWarningMessage | array( 'default' => 'abusefilter-warning' )
|
Default warning messages, per filter group | ||
| $wgAbuseFilterLogIPMaxAge | 3 * 30 * 24 * 3600
|
Age used as cutoff when purging old IP log data. Defaults to 3 months. Used by maintenance script purgeOldLogIPData.php. | ||
| $wgAbuseFilterProfile | false
|
Whether to record data about the performance of filters – the average number of conditions used and the time consumed by every filter. (This was always enabled in MediaWiki up to 1.25, then entirely removed from 1.26 for performance reasons, then restored in 1.27.) | ||
| $wgAbuseFilterRuntimeProfile | false
|
Whether to calculate and record the total runtime, conditions, and matched filters on each execution. | ||
| $wgAbuseFilterProfileActionsCap | 10000
|
Number of action that determines when to reset profiling stats. |
API
AbuseFilter adds two API list modules, one for details of abuse filters ("abusefilters") and one for the abuse log, since it is separate from other MediaWiki logs ("abuselog"). It is not possible to create or modify abuse filters using the API.
list = abusefilters
Liste mit Informationen über die Filter
- Parameters
abfstartid: The filter id to start enumerating fromabfendid: The filter id to stop enumerating atabfdir: The direction in which to enumerate (older, newer)abfshow: Show only filters which meet these criteria (enabled|!enabled|deleted|!deleted|private|!private)abflimit: The maximum number of filters to listabfprop: Which properties to get (id|description|pattern|actions|hits|comments|lasteditor|lastedittime|status|private)
When filters are private, some of the properties specified with abfprop will be missing unless you have the appropriate user rights.
- Beispiele
List non-private abuse filters
| Ergebnis |
|---|
<api>
<query>
<abusefilters>
<filter id="1" hits="867" />
<filter id="3" hits="66110" />
<filter id="5" hits="464" />
<filter id="6" hits="19" />
<filter id="8" hits="7" />
<filter id="9" hits="24869" />
<filter id="11" hits="10033" />
<filter id="14" hits="63" />
<filter id="15" hits="15" />
<filter id="16" hits="44" />
</abusefilters>
</query>
<query-continue>
<abusefilters abfstartid="18" />
</query-continue>
</api>
|
list = abuselog
List instances where actions triggered an abuse filter.
- Parameters
aflstart: The timestamp to start enumerating fromaflend: The timestamp to stop enumerating atafldir: The direction in which to enumerate (older, newer)afluser: Show only entries where the action was attempted by a given user or IP address.afltitle: Show only entries where the action involved a given page.aflfilter: Show only entries that triggered a given filter IDafllimit: The maximum number of entries to listaflprop: Which properties to get (ids|user|title|action|result|timestamp|details)
- Beispiel
List instances where the abuse filter was triggered in response to actions from the user "SineBot"
| Ergebnis |
|---|
<api>
<query>
<abuselog>
<item id="900937" filter_id="211" user="SineBot" result="" />
<item id="888404" filter_id="211" user="SineBot" result="" />
<item id="862751" filter_id="211" user="SineBot" result="" />
<item id="855649" filter_id="211" user="SineBot" result="" />
<item id="842429" filter_id="211" user="SineBot" result="" />
<item id="840958" filter_id="1" user="SineBot" result="" />
<item id="824151" filter_id="211" user="SineBot" result="" />
<item id="804892" filter_id="211" user="SineBot" result="" />
<item id="205254" filter_id="58" user="SineBot" result="disallow" />
<item id="205252" filter_id="58" user="SineBot" result="disallow" />
</abuselog>
</query>
<query-continue>
<abuselog aflstart="2009-04-19T02:07:55Z" />
</query-continue>
</api>
|
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
$wgServervalue, 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)
Siehe auch
- Liste der WMF-Wikis mit Bearbeitungsfilter (mit der jeweiligen Konfiguration)
 | Diese Erweiterung wird in einem oder mehreren Wikis von Wikimedia verwendet. Das bedeutet mit hoher Wahrscheinlichkeit, dass die Erweiterung stabil ist und gut genug funktioniert, um auf solch häufig besuchten Webseiten benutzt zu werden. Suche nach dem Erweiterungs-Namen in den Wikimedia CommonSettings.php und den InitialiseSettings.php-Konfigurations-Dateien, um zu nachzusehen, wo es installiert ist. Eine vollständige Liste der installierten Erweiterungen in einem bestimmten Wiki wird auf Special:Version im Wiki generiert und angezeigt. |
Categories:
- GPL licensed extensions/de
- Stable extensions/de
- User activity extensions/de
- Special page extensions/de
- API extensions/de
- Extensions in Wikimedia version control/de
- Extensions which add rights/de
- EditFilterMerged extensions/de
- GetAutoPromoteGroups extensions/de
- AbortMove extensions/de
- MovePageCheckPermissions extensions/de
- ArticleDelete extensions/de
- RecentChange save extensions/de
- ListDefinedTags extensions/de
- ChangeTagsListActive extensions/de
- LoadExtensionSchemaUpdates extensions/de
- ContributionsToolLinks extensions/de
- UploadVerifyFile extensions/de
- UploadVerifyUpload extensions/de
- UploadStashFile extensions/de
- MakeGlobalVariablesScript extensions/de
- PageContentSaveComplete extensions/de
- UserMergeAccountFields extensions/de
- ParserOutputStashForEdit extensions/de
- All extensions/de
- Extensions used on Wikimedia/de
- Spam management extensions/de
