Extension:AccessControl/cs

Rozšíření AccessControl umožňuje omezit přístup k vybraným stránkám na základě interních skupin, nebo seznamů uživatelů vytvářených přímo uživateli.

MediaWiki není navržená jako CMS (Content Management System), který by umožňoval sofistikovanější nastavení práv, proto se to musí tam, kde je požadavek na ochranu citlivých dat, např. při nasazení v korporátní sféře, nebo na školním intranetu, řešit pomocí rozšíření. A právě pro tento účel bylo vytvořeno rozšíření AccessControl.



Jak tohle rozšíření splňuje požadavky na zabezpečení

 * Zdroje Atom/RSS, rozdíly a odkazy na revize: Obsah stránky je chráněn, ale při otevření stránky z historie se objeví část nezpracovaného obsahu. Pokud byla značka &lt;accesscontrol> umístěna na začátku, potenciální útočník může vidět jména přispívajících uživatelů!


 * Výpisy a vyhledávání: Pokud není uvedeno jinak, pokud je ve výsledcích vyhledávání nějaká stránka s chráněným obsahem, uživatel je přesměrován pryč. Od verze rozšíření 2.5 může být povoleno i vyhledávání. Je ale třeba mít na paměti, že zobrazené výsledky vyhledávání mohou ohrozit citlivá data. Proto do své wiki nezapisujte citlivé informace, jako jsou hesla, která by bylo možné získat fulltextovým vyhledáváním, pokud je povoleno prohledávání obsahu stránek chráněných prostřednictvím řízení přístupu!


 * Začlenění/přeřazení, související práva a další rozšíření: Stránky obsahující značku &lt;accesscontrol> nebo obsahující jinou stránku chráněnou značkou &lt;accesscontrol> jsou zabezpečené. Značka &lt;accesscontrol> je před konverzí HTML zpracována v nezpracovaném wikitextu.


 * Přesměrování: Problém s přesměrování byl opraven ve verzi 1.1


 * API a odkazy akcí: Pro každého anonymního uživatele je třída akce automaticky nastavena na hodnotu false, kromě atributu view pro nechráněné stránky. Povolené akce pro oprávněné uživatele závisí na nastavení oprávnění MediaWiki a uživatelském jménu uvedeném na stránkách seznamu přístupů.


 * Upravit sekci a stránky sledování: Možnosti jsou dostupné pouze registrovaným uživatelům, pokud jsou přihlášeni a jsou na bezpečnostním přístupovém seznamu.


 * Soubory a obrázky


 * XML export ( Special:Export )
 * Upozornění: AccessControl verze < 2.0 byla založena na háčku nechráněném ze strany MediaWiki před exportem stránek do prostého kódu. Pokud tedy používáte AccessControl verze < 2.0, musíte zakázat speciální stránku, která zakáže export stránek z MediaWiki.


 * Autorova zadní vrátka: Rozšíření AccessControl nemá žádná "zadní vrátka" (backdoor)!


 * Kešování: Doporučuji pokud možno vypnout kešování stránek. Viz předchozí odstavec.

Více informací o případných problémech se zabezpečením můžete najít na stránce Bezpečnostní problémy s autorizačními rozšířeními.

Co nabízí

 * Snadné nastavení a jednoduché použití.
 * Žádné záplaty jádra MediaWiki.
 * Neomezené skupiny.
 * Řízení přístupu ve dvou režimech:
 * View control.
 * Edit control, including restrictions on manual edit access when using action=edit in the URL.
 * User groups may use any namespace.
 * Namespaces with group lists may be protected by another extension.
 * MediaWiki sysop group may view and edit the protected pages.
 * Controlled by extension variable
 * Access may be granted to multiple groups
 * Read-only access may be granted to both groups and individual users.
 * Unauthorized users can use the search feature only if is it allowed. See how this extension meets the requirements for site security.

Dokumentace
K rozšíření existuje rozsáhlý manuál v češtině zde, ve formě wiki stránky, připravené k překladu. Pokud se chcete podílet na vzniku jeho anglické verze můžete finančně přispět na profesionálního překladatele, jelikož autor není na překlad tak náročného textu jazykově vybaven. Tato stránka (zatím tedy pouze česká verze) je také součástí zdrojového kódu a můžete si ji, pokud chcete, naimportovat do své instance MediaWiki.

Instalace


Krok 1: soubor Local Settings

 * Přidejte na konec vašeho souboru LocalSettings.php následující řádky:

If you're not sure which namespace ID to use, then use 730 and 731 as detailed at the extension defalt namespaces listing. See step 2 for more information on how to do this.
 * Add a namespace to the LocalSettings.php file for the purpose of creating groups.
 * See for more information.
 * Check the settings in AccessControl.php. These can be set in LocalSettings.php:



Krok 2: Vytvoření skupiny uživatelů

 * Uživatelský seznam musí být vytvořen v hlavním jmenném prostoru. U původní verze to bylo jedno, ale pak se změnil kód MediaWiki. Přečtěte si prosím níže uvedené poznámky.

User groups are simply standard wiki pages that are part of a namespace other than the default namespace. For ease of use, it is suggested that a specific custom namespace is created for the explicit purpose of managing access control list pages For your custom namespace, if you're not sure which namespace ID to use, then use 730 and 731 as detailed at the extension defalt namespaces listing. For your convenience, IDs 730-739 are reserved for your use for this extension.

Furthermore IT: should not be specified in the accesscontrol tag, just "Department"
 * Create a wiki page with a users list in any namespace
 * It is not sufficient to simply create a page with a colon in the name, this extension requires the use of a namespace and one or more pages within namespaces
 * Page Name Example: My:Group
 * The namespace is My
 * The group page is Group
 * This is the name of user group
 * Users are added to the group in a bulleted list
 * Page Content Example
 * Presume that the namespace IT exists
 * Note that in v3.0 you also need to register the namespace IT either in LocalSettings.php e.g.  or modify the.
 * Create a page in the namespace titled "Department"
 * Create users "John Doe" and "Jane Doe" in the group. The group information is contained on the page "Department".
 * Each username appears as a list item.


 * Uživatel, za jehož uživatelským jménem v seznamu následuje "(ro)" může chráněnou stránku číst, ale ne upravit. Pro další skupiny uživatelů můžete vytvořit seznam s názvem Department v jiném uživatelském prostoru. Pamatujte, že uživatelské jméno vždy začíná velkým písmenem!


 * Tipy: K ochraně jmenného prostoru IT můžete použít rozšíření Lockdown, ale není to nutné, protože seznam uživatelů může být chráněn sám sebou přes tag &lt;accesscontrol>.



Krok 3: Použijeme Access Control

 * Depending on localization, your wiki needs pages created to which anonymous or unauthorized users will be redirected. You have to create them in advance because some of them can't access pages from another page.
 * The safety of the page is provided by the &lt;accesscontrol> tag. If there isn't a tag or the page is empty, it's freely accessible to logged-in users that can read and edit the page. No user, logged in or anonymous, will have read-only access.
 * Members from groups listed in the &lt;accesscontrol> tag can edit the page only if the group title isn't listed with "(ro)" and if they don't have read only access set in the group member list.
 * By default the variable  is set to true so that members of sysop can edit user group pages in any namespace.


 * Example tag code

In this example, all users from the groups "Administrators", "IT:Department" and "Sales" can read the page but only the users from "Administrators" group (if exists) and John Doe from "IT:Department" user group can edit it.

Usage on Pages to Control Access
That is for the installation. To restrict access to a page for specific user groups, just include the names of the allowed user groups (separated by commas) as the content of the &lt;accesscontrol> tag in the top of the content page.

Pozor
Je důrazně doporučeno použít verzi 2.5.1.



Pro verzi < 2.3

 * Zde se objevil problém ve funkci fromTemplate, který způsoboval, že AccessControl neakceptoval tag z vložených stránek či šablon. Aktualizace je doporučena!



Pro verzi ≥ 2.0

 * Stránky nemohou mít více než jeden &lt;accesscontrol> prvek.
 * If the user is a member of multiple groups, the group that gives them more access is assumed.
 * This extension uses a MediaWiki hook that is called whenever a search result is displayed. This means that a page that has an ACL will trigger an "Access Denied" message for end users who happen to search for text contained in a protected page. A simple solution is to put pages that require AccessControl into another namespace and then disable searching for that namespace. Although this isn't really a bug, it is undesirable behavior. Click here for an example showing a work around.



Pro verzi ≤ 1.3

 * Groups from MediaWiki must not be in localized form! sysop cannot be Správce, etc.
 * A page may have multiple &lt;accesscontrol> elements, with access accepted from groups in any tag.
 * Anonymous users do not have access to pages protected by &lt;accesscontrol> elements.
 * If variable  is true, sysops always have edit access.



Verze MediaWiki s nimiž bylo rozšíření otestováno

 * Verze 4.0 je zastaralá (T281848). Aktualizace je doporučena.
 * Verze 3.0.1 byla testována na MediaWiki 1.34.0, ale už je zastaralá. Aktualizace je doporučena.
 * Verze 2.5.1 byla testována na MediaWiki 1.33.0-alpha (5eb97ec)
 * Verze 2.6 byla testována na MediaWiki 1.27.0-rc.0 (57f722a)
 * Verze 2.5 byla testována na MediaWiki 1.27.0 (z git repozitáře)
 * Version 2.5 was tested on MediaWiki 1.22.9 (from git repository)
 * Version 2.3 was tested on MediaWiki 1.22.0 (from git repository)
 * Version 2.2 was tested on MediaWiki 1.22.0 (from git repository)
 * Version 2.0 was tested on MediaWiki 1.19-alpha (from svn repository)
 * Version 1.2 was tested on MediaWiki 1.15.5-1 (from Debian repository)
 * Version 1.1 was tested on MediaWiki 1.16.0(b3). Works fine, except that it needed a minor change to line 358 of AccessControl.php (remove '&' from parameter to  ). When viewing a page on a Linux server, the  tags show. But on a Windows server, the tags don't show and it is fine! Still haven't figured that one out, but it is ok for my application.
 * Version 1.1 was tested on MediaWiki 1.15
 * Version 1.0 of this extension has been tested and works fine on MediaWikis > 1.12.x.
 * Version 1.1 tested on MediaWiki 1.16.1 with new patch from http://git.felk.cvut.cz/pub/git?p=accesscontrol.git;a=commitdiff;h=2f678deed0e4e4f77620e391c94559c7b50102a9

Historie
První verze tohoto rozšíření (1.x) vycházela z rozšíření Group Based Access Control, ale neměla žádnou z jeho chyb.



Viz též

 * Extension:Semantic ACL
 * Extension:Semantic ACL