Extension:CheckUser/cs
CheckUser je rozšíření, které umožňuje uživateli (s oprávněním checkuser) zkontrolovat, které IP adresy jsou používány daným uživatelským jménem a která uživatelská jména jsou používána danou IP, aniž by musel ručně spouštět dotazy přímo na databázi.
Rozšíření běží živě na všech wikinách Wikimedie.
Aktualizace budou provedeny podle potřeb wikin Wikimedia Foundation. Nebo pokud je objevena kritická zranitelnost. Podrobnosti o tom, jak používat nástroje poskytované rozšířením, najdete na stránce Help:Extension:CheckUser.
Instalace
- Stáhněte soubor/y a vložte je do adresáře pojmenovaného
CheckUserve vaší složceextensions/.
Vývojáři a přispěvatelé kódu by si místo toho měli nainstalovat rozšíření from Git pomocí:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/CheckUser - Při instalaci z Gitu spusťte Composer pro instalaci závislostí PHP zadáním
composer install --no-devv adresáři rozšíření. (Vyskytnou-li se nějaké komplikace, podívejte se na T173141.)Category:Extensions requiring Composer with git/cs - Na konec vašeho souboru LocalSettings.php přidejte následující kód:
wfLoadExtension( 'CheckUser' );
- Spusťte aktualizační skript, který automaticky provede všechny nezbytné databázové změny, jaké rozšíření vyžaduje.
- Nakonfigurujte podle potřeby.
Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.
Pokud používáte MediaWiki-Docker
Chcete-li nainstalovat toto rozšíření do instance MediaWiki Docker, postupujte podle kroků v MediaWiki-Docker/Extension/CheckUser.
Nastavení
Tento nástroj kopíruje údaje o nedávných změnách do samostatných tabulek a přidává k nim nové položky.
Pokud je $wgPutIPinRC nastaveno na false, zkopírovaná data nebudou obsahovat přidruženou IP adresu.
Záznamy přidané po instalaci tohoto rozšíření však budou obsahovat IP adresu.
Po instalaci tohoto rozšíření můžete snížit $wgRCMaxAge, aby byly nedávné změny kratší, aniž by to ovlivnilo kontrolního uživatele.
Pomocí $wgCUDMaxAge nastavte, jak daleko mohou být data kontrolního uživatele v sekundách.
Nastavení specifické pro CheckUser $wgCheckUserCIDRLimit určuje největší rozsah, který lze zkontrolovat při jedné kontrole.
Jeho formát je stejný jako $BlockCIDRlimit.
Výchozí limit je /19 pro kontroly IPv6 a /16 pro kontroly IPv4.
Chcete-li, aby tento nástroj zaznamenával úspěšné a neúspěšné pokusy o přihlášení i odhlášení, nastavte $wgCheckUserLogLogins na true.
Pokud máte na své wiki účty robotů, nastavením $wgCheckUserLogSuccessfulBotLogins až false přeskočíte protokolování úspěšných pokusů o přihlášení k účtům robotů.
| Verze MediaWiki: | ≥ 1.43 |
Pokud je rozšíření nainstalováno v multi-wiki instalaci (pro více wikin), pak byste měli nastavit $wgVirtualDomainsMapping pro virtual-checkuser-global, aby odkazovalo na centrální databázovou tabulku.
Nastavením tohoto zabezpečení zajistíte, že centrální indexové tabulky budou skutečně na centrální DB, a proto budou fungovat globální automatická blokování GlobalBlocking a GUC.
Poté budete muset spustit update.php k vytvoření tabulek na centrální wiki.
Odstraňování problémů s funkcí Special:GlobalContributions
Pokud Special:GlobalContributions nevrací revize podle očekávání (např. máte revize na jiné wiki, které si můžete prohlédnout na této wiki), nesprávná konfigurace může způsobovat vnitřní selhání, které se netýká uživatele (protože jej nelze vyřešit uživatelem). Zkontrolujte, zda:
- Váš uživatel má centrální účet a jeho účty na dotčené wiki jsou propojeny. To lze zkontrolovat na Special:MergeAccount.
- Dotčená wiki je wiki farmě známá. To je definováno v tabulce
sitesa wiki lze do této tabulky přidat pomocí skriptu údržbyaddSite. You'll need to ensure that the optional parameterspagepathandfilepathare 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. - Centrální databáze je nastavena na
virtual-checkuser-global(např.$wgVirtualDomainsMapping['virtual-checkuser-global'] = [ 'db' => $wiki ];) a že tabulkacuci_temp_editzaznamenává revize z dotčené wiki. - V případě potřeby by měly být povoleny soubory cookie napříč doménami, protože token
centralauthmusí fungovat na obou wikinách.
Udělení práva používat CheckUser
Chcete-li udělit právo používat Special:CheckUser, Special:Investigate a Special:CheckUserLog, musí uživatel se správou uživatelských práv přejít na Special:UserRights a zadat jméno uživatele do pole a poté vybrat možnost "checkuser". Jakmile to uděláte, výše uvedené speciální stránky se pro daného uživatele zobrazí na stránce Special:SpecialPages.
Aby uživatelé měli přístup k IP adresám dočasných účtů, měli by mít právo checkuser-temporary-account.
Chcete-li sysopům poskytnout všechna práva, která toto rozšíření poskytuje, vložte do LocalSettings.php následující:
$wgGroupPermissions['sysop']['checkuser'] = true;
$wgGroupPermissions['sysop']['checkuser-log'] = true;
$wgGroupPermissions['sysop']['investigate'] = true;
$wgGroupPermissions['sysop']['checkuser-temporary-account'] = true;
Chcete-li povolit pouze přidávání a odebírání oprávnění checkuser, použijte místo toho následující:
$wgAddGroups['sysop'][] = 'checkuser';
$wgRemoveGroups['sysop'][] = 'checkuser';
Nastavení
Níže je uveden vybraný počet konfiguračních hodnot.
Tyto konfigurační hodnoty jsou užitečné pro administrátory k úpravě wikin.
Hodnoty nastavení, které jsou obvykle ponechány jako výchozí hodnoty, zde nejsou specifikovány, aby byl seznam stručný, ale podrobnosti o těchto hodnotách nastavení jsou uvedeny v souboru extension.json.
| Název konfigurace | Výchozí hodnota | Podrobnosti |
|---|---|---|
$wgCUDMaxAge |
7776000 |
Jak dlouho uchovávat data CU (v sekundách)? (výchozí = 90 dní) |
$wgCheckUserMaxBlocks |
200 |
Maximální počet uživatelů, kteří mohou být hromadně blokováni současně na Special:Investigate |
$wgCheckUserForceSummary |
false |
Nastavte toto na true, pokud chcete přinutit kontrolní uživatele, aby uvedli důvod pro každou kontrolu, kterou provedou prostřednictvím Special:CheckUser. (Není to příliš užitečné, protože kontrolní uživatelé by mohli jednoduše poskytnout shrnutí, jako například "je třeba je zkontrolovat" nebo "cítím se na to", a software by to nevěděl.) |
$wgCheckUserCIDRLimit |
[ 'IPv4' => 16, 'IPv6' => 19 ] |
Nejmenší hodnota CIDR, kterou lze použít při kontrole libovolného individuálního rozsahu |
$wgCUPublicKey |
'' |
Veřejný klíč k zašifrování soukromých dat, která může být potřeba přečíst později. Vygenerujte veřejný klíč s něčím jako:
Používá se s přidruženým soukromým klíčem k šifrování určitých dat, která se nezobrazují CU, ale jsou uložena v tabulce cu_changes nebo cu_private_event. V současné době se jedná pouze o příjemce e-mailů. Bez platného veřejného klíče nebudou data uložena. |
$wgCheckUserCAMultiLock |
false |
To lze použít k přidání odkazu na Special:MultiLock od CentralAuth do formuláře hromadného bloku Special:CheckUser. To vyžaduje, aby bylo na wiki nainstalováno rozšíření CentralAuth. Chcete-li to povolit, nastavte toto na pole s názvem centrální databáze wiki a pole s názvem (názvy) globální skupiny (skupin), na kterou chcete přidat odkaz. Například:
$wgCheckUserCAMultiLock = [
'centralDB' => 'metawiki',
'groups' => [ 'steward' ]
];
|
$wgCheckUserCAtoollink |
false |
Od 77360f1cf1d2. Toto přidá odkaz na centrální wiki Special:CentralAuth do výsledků Special:CheckUser "Get users" (získat uživatele). To vyžaduje, aby bylo na wiki nainstalováno rozšíření CentralAuth. Chcete-li to povolit, nastavte toto s názvem centrální databáze wiki. Například:
$wgCheckUserCAtoollink = 'metawiki';
|
$wgCheckUserGBtoollink |
false |
Od 77360f1cf1d2. To přidá odkaz na místní nebo centrální wiki Special:GlobalBlock do výsledků Special:CheckUser "Získat uživatele". To vyžaduje, aby bylo na wiki nainstalováno rozšíření GlobalBlocking. Chcete-li to povolit, pokud je nakonfigurován $wgConf, nastavte toto na pole s názvem centrální databáze wiki a pole s názvy lokálních (nebo globálních, pokud máte nainstalovaných CentralAuth) skupin, pro které chcete přidat odkaz. Například:
$wgCheckUserGBtoollink = [
'centralDB' => 'metawiki',
'groups' => [ 'steward', 'staff' ]
];
|
$wgCheckUserEnableSpecialInvestigate (1.35-1.43) |
false (<=1.39)true (1.40+) |
Od 57dcfe46d2e4. To umožňuje Special:Investigate, aktualizovanou verzi Special:CheckUser, která umožňuje kontrolu více uživatelských účtů a IP adres v rámci jednoho vyšetřování. |
$wgCheckUserLogLogins |
false |
Zda má CheckUser protokolovat pokusy o přihlášení a odhlášení (úspěšné i neúspěšné). |
$wgCheckUserLogSuccessfulBotLogins |
true |
Zda má CheckUser ukládat úspěšné pokusy o přihlášení k účtům se skupinou uživatelů robotů, pokud je $wgCheckUserLogLogins nastaveno na true. Použije se pouze v případě, že $wgCheckUserLogLogins je true |
$wgCheckUserMaximumRowCount |
5000 |
Maximální počet výsledků, které lze vrátit Special:CheckUser. Před MediaWiki 1.39, v 'Get edits' a 'Get IPs' výsledky s více než 5 000 výsledky vracely výsledky v jiném formátu. Od MediaWiki 1.39 je to maximální počet výsledků, které lze zobrazit podle stránky a další lze generovat pomocí stránkovacích odkazů |
$wgCheckUserInvestigateMaximumRowCount |
25000 |
Podobné jako $wgCheckUserMaximumRowCount, ale pro Investigate |
$wgCheckUserCollapseCheckUserHelperByDefault (1.41+) |
2500 |
Řídí, kdy je souhrnná tabulka "CheckUser helper" na Special:CheckUser. Zadejte true, aby se ve výchozím nastavení vždy sbalilo, false, aby se ve výchozím nastavení nikdy nesbalilo, a číslo, které se má sbalit, když se na stránce zobrazí více než uvedený počet výsledků. |
$wgCheckUserMaximumIPsToAutoblock (1.43+) |
1 |
Maximální počet adres IP, které se mají zpětně automaticky zablokovat při vytvoření bloku s povoleným automatickým blokováním. |
$wgCheckUserClientHintsEnabled (1.41+) |
true |
Používá se ke kontrole, zda má CheckUser shromažďovat a zobrazovat klientské rady ve výsledcích. |
$wgCheckUserClientHintsSpecialPages (1.41+) |
{ "CreateAccount": "header", "Emailuser": "js", "PasswordReset": "js", "Userlogin": [ "js", "header" ], "Userlogout": "header"} |
Seznam speciálních stránek, na kterých bude CheckUser vyžadovat klientské rady, pokud $wgCheckUserClientHintsEnabled je 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": ""} |
Seznam typů klientských nápověd, které budou požadovány. Klíče představují hodnoty nápovědy klienta požadované pomocí hlavičky Accept-CH. Hodnoty představují ekvivalentní název, když je požadujete z rozhraní API klientských tipů na straně klienta JS. |
$wgCheckUserClientHintsForDisplay (1.41+) |
[ "model", "fullVersionList", "platformVersion", "platform", "brands", "formFactor", "architecture", "mobile", "bitness", "woW64" ] |
Seznam dat klientských rad, která se mají zobrazit ve výsledcích CheckUser. Pořadí pole se používá k určení pořadí zobrazení dat. |
$wgCheckUserClientHintsValuesToHide (1.41+) |
{ "architecture": [ "x86" ], "bitness": [ "64" ], "woW64": [ false ]} |
Určuje datové hodnoty nápovědy klienta, které by měly být skryty ve výsledcích CheckUser. To se provádí za účelem skrytí běžně zobrazovaných hodnot dat nápovědy klienta v případech, kdy není užitečné tyto informace vidět, pokud se nejedná o vzácnou hodnotu. |
$wgCheckUserTemporaryAccountMaxAge (1.40+) |
86400 |
Počet sekund, po které je odpověď API dočasného účtu aktuální. |
$wgCheckUserSpecialPagesWithoutIPRevealButtons (1.40+) |
[ "Investigate", "InvestigateBlock", "CheckUser", "CheckUserLog", "Activeusers", "Listusers", "BlockList" ] |
Seznam speciálních názvů stránek, kde jsou tlačítka "Zobrazit IP" deaktivována, protože nejsou užitečná. U speciálních názvů stránek se rozlišují velká a malá písmena a nemusí vždy odpovídat jejich vzhledu v adrese URL. Například Special:ListUsers se v tomto poli nazývá Listusers. |
$wgCheckUserClientHintsUnsetHeaderWhenPossible (1.41+) |
true |
Pokud je true, server odešle prázdnou hlavičku Accept-CH, když si uživatel prohlíží stránku, která nepotřebuje data klientských nápověd. |
$wgCheckUserGlobalContributionsCentralWikiId (1.44+) |
null |
Řetězec představující název wiki, který má být označen jako "centrální" wiki pro Special:GlobalContributions. Nastavením tohoto přesměrujete všechny Special:GlobalContributions stránky ostatních wikin na centrální wiki. |
$wgCheckUserWriteToCentralIndex (1.43+) |
true |
Používá se k zabránění přidávání položek do centrálních indexových tabulek CheckUser na wiki. Použijte toto, když wiki není součástí většího systému jednotného účtu wiki farmy. |
$wgCheckUserCentralIndexGroupsToExclude (1.43+) |
[ "bot" ] |
Uživatelé v žádné ze skupin uvedených v této konfigurační hodnotě nebudou mít své akce uloženy v centrálních indexových tabulkách. Používá se ke snížení rychlosti zápisů do centrálních indexových tabulek pro uživatele s vysokou aktivitou, u nichž není potřeba spouštět kontroly CheckUser u těchto uživatelů. |
Použití rozšíření
Detail about how to use the extension can be viewed at the extension help page. Tyto informace zde nejsou zahrnuty, aby byla zachována správná velikost této stránky a aby se tato stránka zaměřila na instalaci a správu rozšíření.
Rozšíření poskytuje několik speciálních stránek a několik rozhraní API. Speciální stránky jsou:
- Special:CheckUser - používá se k vyhledání dat CheckUser o účtech a anonymních uživatelích. Described at Help:Extension:CheckUser#Special:CheckUser usage.
- Special:Investigate - alternativní nástroj používaný k vyhledání dat CheckUser o účtech a anonymních uživatelích s informacemi zobrazenými ve formátu jedné stránky. Popsaný na Help:Special Investigate.
- Special:CheckUserLog - používá se k výpisu kontrol provedených pomocí Special:CheckUser, Special:Investigate nebo CheckUser API. Popsaný na Help:Extension:CheckUser#Special:Investigate usage.
- Special:IPContributions - používá se k vyhledání úprav provedených dočasnými účty na dané IP adrese nebo rozsahu. Popsaný na Help:Extension:CheckUser#Special:IPContributions usage.
- Special:GlobalContributions - používá se k vyhledání úprav provedených účty nebo dočasnými účty na dané IP adrese nebo rozsahu. Popsaný na Help:Extension:CheckUser#Special:GlobalContributions usage.
Rozšíření také poskytuje možnost odhalit IP adresu používanou dočasným účtem. Popsaný na Help:Extension:CheckUser#Showing IPs for temporary accounts.
 | Toto rozšíření se používá na jednom nebo více projektech Wikimedia. Pravděpodobně to znamená, že rozšíření je stabilní a funguje dostatečně dobře, aby jej mohly používat weby s tak vysokou návštěvností. Vyhledejte tento název rozšíření v konfiguračních souborech CommonSettings.php a InitialiseSettings.php Wikimedie, abyste viděli, kde je nainstalováno. Úplný seznam rozšíření nainstalovaných na konkrétní wiki lze vidět na stránce wiki Special:Version. |
 | Toto rozšíření je zahrnuto v následujících wiki farmách/hostitelích a/nebo balíčcích:
|