Jump to content

Extensie:CheckUser

From mediawiki.org
This page is a translated version of the page Extension:CheckUser and the translation is 100% complete.
Deze pagina gaat over het installeren van de extensie zelf. Voor het CheckUser beleid van de Wikimedia Foundation, zie deze pagina. Voor details over het gebruik van de extensie, zie Help:Extension:CheckUser .
MediaWiki Handleiding extensies
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
  • $wgCheckUserGBtoollink
  • $wgCheckUserClientHintsSpecialPages
  • $wgCheckUserCAMultiLock
  • $wgCheckUserLogSuccessfulBotLogins
  • $wgCheckUserWriteToCentralIndex
  • $wgCheckUserSpecialPagesWithoutIPRevealButtons
  • $wgCheckUserLogLogins
  • $wgCUPublicKey
  • $wgCheckUserCAtoollink
  • $wgCheckUserCuciUserRandomChanceDebounceCutoff
  • $wgCheckUserClientHintsRestApiMaxTimeLag
  • $wgCheckUserDeveloperMode
  • $wgCheckUserEnableTempAccountsOnboardingDialog
  • $wgCheckUserCentralIndexRangesToExclude
  • $wgCUDMaxAge
  • $wgCheckUserCIDRLimit
  • $wgCheckUserMaxBlocks
  • $wgCheckUserCentralIndexGroupsToExclude
  • $wgCheckUserDisplayClientHints
  • $wgCheckUserGlobalContributionsCentralWikiId
  • $wgCheckUserForceSummary
  • $wgCheckUserInvestigateMaximumRowCount
  • $wgCheckUserMaximumIPsToAutoblock
  • $wgCheckUserClientHintsForDisplay
  • $wgCheckUserClientHintsValuesToHide
  • $wgCheckUserClientHintsUnsetHeaderWhenPossible
  • $wgCheckUserCollapseCheckUserHelperByDefault
  • $wgCheckUserClientHintsEnabled
  • $wgCheckUserTemporaryAccountMaxAge
  • $wgCheckUserMaximumRowCount
  • $wgCheckUserClientHintsHeaders

  • checkuser
  • checkuser-log
  • checkuser-temporary-account
  • checkuser-temporary-account-log
  • checkuser-temporary-account-no-preference
  • investigate
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 map extensions/.
    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.
  • Yes 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 onderhoudsscript addSite aan deze tabel worden toegevoegd. You'll need to ensure that the optional parameters pagepath and filepath 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 tabel cuci_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 .

Configuratie instellingen in 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:

openssl genrsa -out cu.key 2048; openssl rsa -in cu.key -pubout > cu.pub en plak hier de inhoud van cu.pub

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:

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 .