Extensie:CheckUser
![]() Release status: stabiel |
|
---|---|
![]() |
|
Implementatie | Speciale pagina , Gebruikersidentiteit , API , Hook , Database |
Beschrijving | Met de functie CheckUser kan een gebruiker met dat recht controleren welke IP's worden gebruikt door een bepaalde gebruikersnaam en welke gebruikersnamen worden gebruikt door een bepaald IP-adres, zonder dat hij query's rechtstreeks handmatig op de database hoeft uit te voeren. |
Auteur(s) | Tim Starling, Aaron Schulz, Dreamy Jazz |
Laatste versie | 2.5 (continuous updates) |
Compatibiliteit beleid | Snapshots releases samen met MediaWiki. Master is niet achterwaarts compatibel. |
PHP | 7.4.3+ |
Database wijzigingen | Ja |
Virtueel domein | virtual-checkuser-global |
Tabellen | cu_changes cu_log_event cu_private_event cu_log cu_useragent_clienthints cu_useragent_clienthints_map cu_useragent cuci_wiki_map cuci_temp_edit cuci_user |
Licentie | GNU General Public Licentie 2.0 of hoger |
Download | |
|
|
|
|
|
|
Downloads kwartaal | 162 (Ranked 37th) |
Publieke wiki's die het gebruiken | 9,118 (Ranked 13th) |
Vertaal de CheckUser extensie indien beschikbaar op translatewiki.net | |
Problemen | Open taken · Rapporteer een bug |
CheckUser is een extensie waarmee een gebruiker (met dat recht checkuser
) kan controleren welke IP-adressen worden gebruikt door een bepaalde gebruikersnaam en welke gebruikersnamen worden gebruikt door een bepaald IP-adres, zonder dat query's rechtstreeks met de hand op de database hoeven te worden uitgevoerd.
De extensie wordt in productie uitgevoerd op alle Wikimedia wiki's.
Updates worden gemaakt volgens de behoeften van Wikimedia Foundation wiki's; of waar kritieke kwetsbaarheden worden ontdekt. Details over het gebruik van de hulpmiddelen die de extensie biedt staan op Help:Extension:CheckUser .
Installatie
- Download en plaats de bestanden in de map
CheckUser
in de mapextensions/
.
Ontwikkelaars en bijdragers van code moeten in plaats daarvan de extensie van Git installeren, met behulp van:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/CheckUser - Alleen bij installeren vanuit Git, run Composer om PHP afhankelijkheden te installeren, door het publiceren van
composer install --no-dev
in de extensie-map. (Zie T173141 voor potentiële problemen.) - Voeg de volgende code onderaan het bestand LocalSettings.php toe:
wfLoadExtension( 'CheckUser' );
- Voer het update script uit, dat automatisch de vereiste database-tabellen creëert die nodig zijn voor de extensie.
- Configureer naar vereiste.
Klaar – Navigeer naar Special:Version op de wiki om te controleren dat de extensie geïnstalleerd is.
MediaWiki-Docker gebruiken
Volg de stappen in MediaWiki-Docker/Extension/CheckUser om deze extensie te installeren in een instantie van MediaWiki Docker.
Configuratie
Dit hulpmiddel kopieert recente wijzigingsgegevens in afzonderlijke tabellen en voegt daarbij toe wanneer nieuwe gegevens worden toegevoegd.
Als $wgPutIPinRC
is ingesteld op false
, bevatten de gekopieerde gegevens niet het bijbehorende IP-adres.
De gegevens die na de installatie van deze extensie worden toegevoegd bevatten echter het IP-adres.
Na de installatie van deze extensie kunt u $wgRCMaxAge
verminderen om recente wijzigingen korter te maken zonder dat dit de checkuser beïnvloedt.
Gebruik $wgCUDMaxAge
om te bepalen hoe ver de gegevens van checkuser kunnen teruggaan, in seconden.
De CheckUser-specifieke instelling $wgCheckUserCIDRLimit bepaalt het grootste bereik dat in één enkele controle kan worden gecontroleerd.
Het formaat is hetzelfde als $wgBlockCIDRLimit .
De standaardlimiet is /19
voor IPv6 controles en /16
voor IPv4 controles.
Om dit hulpmiddel te laten loggen op succesvolle en mislukte inlog- of uitlog-pogingen, stel $wgCheckUserLogLogins
op true
.
Als u botaccounts op uw wiki heeft, wordt het loggen van succesvolle inlogpogingen op botaccounts overgeslagen door $wgCheckUserLogSuccessfulBotLogins
op false
in te stellen.
MediaWiki-versie: | ≥ 1.43 |
Als de extensie is geïnstalleerd op een multi-wiki installatie, dan moet u $wgVirtualDomainsMapping instellen voor de virtual-checkuser-global
om naar een centrale databasetabel te verwijzen.
Als u dit instelt, zorgt u ervoor dat de centrale indextabellen zich daadwerkelijk op een centrale database bevinden, en daarom werken de wereldwijde autoblokkades GlobalBlocking en GUC.
Nadat u dit heeft gedaan, moet u update.php
uitvoeren om de tabellen op de centrale wiki te maken.
Foutoplossing functie Special:GlobalContributions
Als Special:GlobalContributions niet de revisie terugstuurt zoals verwacht (bijvoorbeeld als er revisies zijn op een andere wiki die u op die wiki kunt bekijken), kan een foutconfiguratie een intern probleem veroorzaken dat niet aan de gebruiker getoond wordt (het kan niet door de gebruiker opgelost worden). Controleer dat:
- Uw gebruiker een centrale account heeft en dat deze accounts aan de betrokken wiki zijn gekoppeld. Dit kan worden gecontroleerd op Special:MergeAccount.
- De betrokken wiki is bekend aan de wiki farm. Dit wordt gedefinieerd in de tabel
sites
en wiki's kunnen via het onderhoudsscriptaddSite
aan deze tabel worden toegevoegd. You'll need to ensure that the optional parameterspagepath
andfilepath
are filled out (eg.php ./maintenance/run.php addSite $wikiName wiki --pagepath https://hostname/wiki/\$1 --filepath https://hostname/w/\$1
), as Special:GlobalContributions uses these to generate API queries and links. - De centrale database is ingesteld met
virtual-checkuser-global
(bijv.$wgVirtualDomainsMapping['virtual-checkuser-global'] = [ 'db' => $wiki ];
) en dat de tabelcuci_temp_edit
revisies van de betrokken wiki vastlegt. - Als dat nodig is, moeten cross-domain cookies worden ingeschakeld, omdat het token
centralauth
op beide wiki's moet werken.
Verlenen van het recht om CheckUser te gebruiken
Om het recht te verlenen om Special:CheckUser, Special:Investigate en Special:CheckUserLog te gebruiken, moet een gebruiker met gebruikersrechtenbeheer naar Special:UserRights gaan en de naam van de gebruiker in het vak invoeren, en vervolgens de optie "checkuser" selecteren. Als dit is gedaan, worden de bovengenoemde speciale pagina's voor die gebruiker weergegeven in pagina Special:SpecialPages.
Om gebruikers toegang te geven tot de IP-adressen van ijdelijke accounts , moet aan hun het recht checkuser-temporary-account worden verleend.
Om sysops alle rechten te geven die deze extensie biedt, zet het volgende in LocalSettings.php
:
$wgGroupPermissions['sysop']['checkuser'] = true;
$wgGroupPermissions['sysop']['checkuser-log'] = true;
$wgGroupPermissions['sysop']['investigate'] = true;
$wgGroupPermissions['sysop']['checkuser-temporary-account'] = true;
Om alleen de toevoeging en de verwijdering van het recht checkuser
toe te staan, gebruik in plaats daarvan het volgende:
$wgAddGroups['sysop'][] = 'checkuser';
$wgRemoveGroups['sysop'][] = 'checkuser';
Configuratie
Een geselecteerd aantal van de configuratiewaarden wordt hieronder weergegeven.
Deze configuratiewaarden zijn nuttig voor beheerders van wiki's.
De configuratiewaarden die meestal als standaardwaarde worden achtergelaten, worden hier niet aangegeven om de lijst kort en helder te houden, maar de details voor deze configuratiewaardes zijn aanwezig in het bestand extension.json
.
Configuratienaam | standaard | Detail |
---|---|---|
$wgCUDMaxAge
|
7776000
|
Hoe lang kunnen de CU-gegevens worden bewaard (in seconden)? (standaard is 90 dagen) |
$wgCheckUserMaxBlocks
|
200
|
Maximaal aantal gebruikers dat tegelijkertijd massaal kan worden geblokkeerd op Special:Investigate
|
$wgCheckUserForceSummary
|
false
|
Stel dit op true als u checkusers wilt dwingen om een reden te geven voor elke controle die ze doen via Special:CheckUser. (Niet erg nuttig, aangezien er eenvoudig een reden kan worden gegeven als "they need to be checked" of "Barbapapa".)
|
$wgCheckUserCIDRLimit
|
[ 'IPv4' => 16, 'IPv6' => 19 ]
|
Kleinste CIDR-waarde die kan worden gebruikt bij elke individuele bereikcontrole |
$wgCUPublicKey
|
''
|
Publieke sleutel om privégegevens te versleutelen die later moeten worden gelezen. Genereer een publieke sleutel met iets als:
Gebruikt met een bijbehorende private sleutel om bepaalde gegevens te versleutelen die niet aan Checkusers worden getoond, maar worden opgeslagen in de tabel cu_changes of cu_private_event. Nu zijn dit alleen de ontvangers van e-mails. Zonder een geldige publieke sleutel worden de gegevens niet opgeslagen. |
$wgCheckUserCAMultiLock
|
false
|
Dit kan worden gebruikt om een link naar Special:MultiLock door CentralAuth toe te voegen aan het massablokkade-formulier van Special:CheckUser. Dit vereist dat de extensie CentralAuth/nl is geïnstalleerd. Om dit in te schakelen, stelt u dit in op een matrix met de databasenaam van een centrale wiki en een matrix met de naam/namen van de globale groep(en) om de link voor toe te voegen. Bijvoorbeeld:
$wgCheckUserCAMultiLock = [
'centralDB' => 'metawiki',
'groups' => [ 'steward' ]
];
|
$wgCheckUserCAtoollink
|
false
|
Sinds 77360f1cf1d2. Dit voegt een link toe naar de centrale wiki Special:CentralAuth naar de "Get users" resultaten van Special:CheckUser. Dit vereist dat de extensie CentralAuth/nl is geïnstalleerd. Om dit in te schakelen, stelt u dit in met de databasenaam van een centrale wiki. Bijvoorbeeld:
$wgCheckUserCAtoollink = 'metawiki';
|
$wgCheckUserGBtoollink
|
false
|
Sinds 77360f1cf1d2. Dit voegt een link toe naar de lokale of centrale wiki Special:GlobalBlock aan de "Get users" resultaten van Special:CheckUser. Dit vereist dat de extensie GlobalBlocking is geïnstalleerd. Om dit in te schakelen, als een $wgConf is geconfigureerd, stel dit dan in op een matrix met de databasenaam (of databasenamen) van een centrale wiki en een array met de naam/namen van de lokale (of globale als u CentralAuth/nl heeft geïnstalleerd) groep(en) om de link voor toe te voegen. Bijvoorbeeld:
$wgCheckUserGBtoollink = [
'centralDB' => 'metawiki',
'groups' => [ 'steward', 'staff' ]
];
|
$wgCheckUserEnableSpecialInvestigate (1.35-1.43)
|
false (<=1.39)true (1.40+)
|
Sinds 57dcfe46d2e4. Dit schakelt Special:Investigate in, een bijgewerkte versie van Special:CheckUser waarmee binnen één onderzoek kan worden gecontroleerd op meerdere gebruikersaccounts en IP-adressen. |
$wgCheckUserLogLogins
|
false
|
Of CheckUser inlog- en uitlogpogingen moet loggen (zowel succesvol als niet). |
$wgCheckUserLogSuccessfulBotLogins
|
true
|
Of CheckUser succesvolle inlogpogingen moet opslaan bij accounts met de bot-gebruikersgroep als $wgCheckUserLogLogins is ingesteld op true . Wordt alleen gebruikt als $wgCheckUserLogLogins true is
|
$wgCheckUserMaximumRowCount
|
5000
|
Het maximum aantal resultaten dat kan worden geretourneerd door Special:CheckUser. Vóór MediaWiki 1.39 leverden de resultaten met meer dan 5.000 resultaten in de 'Get edits' en 'Get IPS' de resultaten in een ander formaat. Vanaf MediaWiki 1.39 is dit het maximale aantal resultaten dat per pagina kan worden weergegeven en er kunnen er meer worden gegenereerd met behulp van de paging-links |
$wgCheckUserInvestigateMaximumRowCount
|
25000
|
Vergelijkbaar met $wgCheckUserMaximumRowCount, maar dan voor onderzoeken |
$wgCheckUserCollapseCheckUserHelperByDefault (1.41+)
|
2500
|
Bepaald wanneer de samenvattingstabel "CheckUser helper" op Special:CheckUser staat. Geeft true om altijd standaard in te vouwen, false om nooit in te vouwen en een nummer om in te vouwen wanneer meer dan dat aantal resultaten op de pagina worden weergegeven.
|
$wgCheckUserMaximumIPsToAutoblock (1.43+)
|
1
|
Het maximum aantal IP-adressen dat terugwerkend automatisch kan worden geblokkeerd wanneer een blok wordt gemaakt met automatisch blokkeren ingeschakeld. |
$wgCheckUserClientHintsEnabled (1.41+)
|
true
|
Wordt gebruikt om te bepalen of hints van klanten moeten worden verzameld en weergegeven in de resultaten door CheckUser. |
$wgCheckUserClientHintsSpecialPages (1.41+)
|
{ "CreateAccount": "header", "Emailuser": "js", "PasswordReset": "js", "Userlogin": [ "js", "header" ], "Userlogout": "header" }
|
De lijst met speciale pagina's waar CheckUser cliënt-suggesties vraagt als $wgCheckUserClientHintsEnabled is true .
|
$wgCheckUserClientHintsHeaders (1.41+)
|
{ "Sec-CH-UA": "brands", "Sec-CH-UA-Arch": "architecture", "Sec-CH-UA-Bitness": "bitness", "Sec-CH-UA-Form-Factor": "", "Sec-CH-UA-Full-Version-List": "fullVersionList", "Sec-CH-UA-Mobile": "mobile", "Sec-CH-UA-Model": "model", "Sec-CH-UA-Platform": "platform", "Sec-CH-UA-Platform-Version": "platformVersion", "Sec-CH-UA-WoW64": "" }
|
De lijst met cliënt-hinttypen die wordt opgevraagd. Keys vertegenwoordigen de cliënt-hintwaarden die zijn aangevraagd met behulp van de Accept-CH -header. Waarden vertegenwoordigen de gelijkwaardige naam wanneer ze worden aangevraagd bij de JS-client-kant cliënt-hints API.
|
$wgCheckUserClientHintsForDisplay (1.41+)
|
[ "model", "fullVersionList", "platformVersion", "platform", "brands", "formFactor", "architecture", "mobile", "bitness", "woW64" ]
|
De lijst van gegevens van cliënten (Client Hints) die in de CheckUser-resultaten weergegeven moeten worden. De volgorde van het array wordt gebruikt om te bepalen in welke volgorde de gegevens moet worden weergegeven. |
$wgCheckUserClientHintsValuesToHide (1.41+)
|
{ "architecture": [ "x86" ], "bitness": [ "64" ], "woW64": [ false ] }
|
Specificeert de gegevenswaarden van de Client Hint die moeten worden verborgen in de CheckUser-resultaten. Dit wordt gedaan om de meest voorkomende Client Hint datawaarden te verbergen in gevallen waarin het niet nuttig is om deze informatie te zien tenzij het een zeldzame waarde is. |
$wgCheckUserTemporaryAccountMaxAge (1.40+)
|
86400
|
Het aantal seconden waarvoor de API-reactie van het tijdelijk account nieuw is. |
$wgCheckUserSpecialPagesWithoutIPRevealButtons (1.40+)
|
[ "Investigate", "InvestigateBlock", "CheckUser", "CheckUserLog", "Activeusers", "Listusers", "BlockList" ]
|
Een lijst met speciale paginanamen waar de knoppen om het IP te tonen worden uitgeschakeld, omdat ze daar niet nuttig zijn. De speciale paginanamen zijn hoofdlettergevoelig en komen niet altijd overeen met hun weergave in de URL. Bijvoorbeeld, Special:ListUsers wordt in deze array Listusers .
|
$wgCheckUserClientHintsUnsetHeaderWhenPossible (1.41+)
|
true
|
Als true , stuurt de server een lege Accept-CH header wanneer de gebruiker een pagina bekijkt die geen client-suggesties nodig heeft.
|
$wgCheckUserGlobalContributionsCentralWikiId (1.44+)
|
null
|
Een tekenreeks die de naam van de wiki vertegenwoordigt om de "centrale" wiki aan te duiden voor Special:GlobalContributions. Als u dit instelt, worden alle pagina's Special:GlobalContributions van de andere wiki's naar de centrale wiki's omgeleid. |
$wgCheckUserWriteToCentralIndex (1.43+)
|
true
|
Wordt gebruikt om te voorkomen dat er gegevens worden toegevoegd aan de centrale indextabellen van CheckUser op de wiki. Gebruik dit wanneer de wiki geen deel uitmaakt van een groter wiki farm-unified account systeem. |
$wgCheckUserCentralIndexGroupsToExclude (1.43+)
|
[ "bot" ]
|
Van gebruikers in een van de in deze configuratiewaarde gespecificeerde groepen worden de acties niet opgeslagen in de centrale indextabel. Wordt gebruikt om de snelheid van schrijven naar de centrale indextabel te verminderen voor gebruikers met een hoge activiteit, waarbij er geen CheckUser-controles op deze gebruikers nodig zijn. |
De extensie gebruiken
Detail about how to use the extension can be viewed at the extension help page . Deze informatie is hier niet opgenomen om deze pagina in grootte te beheren te houden en ons op deze pagina op de installatie en het beheer van de extensie te richten.
Er zijn verschillende speciale pagina's en een paar API's die door de extensie worden aangeboden. Deze speciale pagina's zijn:
- Special:CheckUser - Wordt gebruikt om CheckUser-gegevens over accounts en anonieme gebruikers op te zoeken. Described at Help:Extension:CheckUser#Special:CheckUser usage .
- Special:Investigate - Alternatief hulpmiddel om CheckUser-gegevens over accounts en anonieme gebruikers te bekijken, met informatie die wordt weergegeven op één pagina. Beschreven op Help:Special Investigate .
- Special:CheckUserLog - Wordt gebruikt om de controles te vermelden die met behulp van Special:CheckUser, Special:Investigate of de CheckUser API zijn uitgevoerd. Beschreven op Help:Extension:CheckUser#Special:Investigate usage .
- Special:IPContributions - Wordt gebruikt voor zoekbewerkingen die worden uitgevoerd door een tijdelijk account op een bepaald IP-adres of -bereik. Beschreven op Help:Extension:CheckUser#Special:IPContributions usage .
- Special:GlobalContributions - Wordt gebruikt voor zoekbewerkingen uitgevoerd door een accounts of een tijdelijk account op een bepaald IP-adres of -bereik. Beschreven op Help:Extension:CheckUser#Special:GlobalContributions usage .
De extensie biedt ook de mogelijkheid om het IP-adres te tonen dat door een tijdelijk account wordt gebruikt. Beschreven op Help:Extension:CheckUser#Showing IPs for temporary accounts .
![]() | Deze uitbreiding wordt gebruikt op een of meerdere Wikimedia projecten. Dit betekent waarschijnlijk dat de uitbreiding stabiel is en goed werkt op dergelijke vaak bezochte websites. Zoek op de naam van deze uitbreiding in Wikimedia's CommonSettings.php en InitialiseSettings.php om te zien waar deze is geïnstalleerd. Een volledige lijst van de uitbreidingen die geïnstalleerd zijn op een bepaalde wiki kan worden gevonden op de Special:Version pagina van de wiki. |
![]() | Deze uitbreiding is beschikbaar op de volgende wiki-families en/of onderdeel van de volgende pakketten: Dit is geen gezaghebbende lijst. Sommige wikifarms/hosts en/of pakketten kunnen deze extensie bevatten, zelfs als ze hier niet worden vermeld. Controleer het altijd bij uw wiki farms/hosts of bundel. |
- Stable extensions/nl
- Special page extensions/nl
- User identity extensions/nl
- API extensions/nl
- Hook extensions/nl
- Database extensions/nl
- GPL licensed extensions/nl
- Extensions in Wikimedia version control/nl
- Extensions which add rights/nl
- APIGetAllowedParams extensions/nl
- AbuseFilterCanViewProtectedVariables extensions/nl
- AbuseFilterCustomProtectedVariables extensions/nl
- AbuseFilterLogProtectedVariableValueAccess extensions/nl
- ApiQuery::moduleManager extensions/nl
- AuthManagerLoginAuthenticateAudit extensions/nl
- BeforePageDisplay extensions/nl
- ChangesListInsertLogEntry extensions/nl
- ContributionsToolLinks extensions/nl
- EmailUser extensions/nl
- GetPreferences extensions/nl
- GlobalBlockingGetRetroactiveAutoblockIPs extensions/nl
- GlobalPreferencesSetGlobalPreferences extensions/nl
- LoadExtensionSchemaUpdates extensions/nl
- LocalUserCreated extensions/nl
- LogEventsListLineEnding extensions/nl
- PerformRetroactiveAutoblock extensions/nl
- RecentChange save extensions/nl
- RenameUserSQL extensions/nl
- ResourceLoaderRegisterModules extensions/nl
- SaveUserOptions extensions/nl
- SidebarBeforeOutput extensions/nl
- SpecialContributionsBeforeMainOutput extensions/nl
- SpecialPageBeforeExecute extensions/nl
- SpecialPage initList extensions/nl
- User::mailPasswordInternal extensions/nl
- UserLogoutComplete extensions/nl
- UserMergeAccountFields extensions/nl
- UserToolLinksEdit extensions/nl
- All extensions/nl
- Extensions requiring Composer with git/nl
- Extensions used on Wikimedia/nl
- Extensions included in Canasta/nl
- Extensions included in Fandom/nl
- Extensions included in Miraheze/nl
- Extensions included in ShoutWiki/nl
- Extensions included in Telepedia/nl
- Extensions included in WikiForge/nl
- Log extensions/nl