Extension:WikiToLDAP

Příručka k rozšířením MediaWiki

WikiToLDAP Stav rozšíření: stabilní
Popis	Poskytuje způsob migrace uživatelů wiki na uživatele podporované LDAP
Autoři	Mark A. Hershberger, Robert Vogel
Nejnovější verze	1.0.4
Zásady kompatibility	Vydání snímků současně s MediaWiki. Hlavní vývojová větev není zpětně kompatibilní.
MediaWiki	1.34+
Composer	mediawiki/wiki-to-ldap
Licence	GNU General Public License 3.0 nebo novější
Stáhnout	Stáhněte si rozšíření Git [?]: Procházení úložiště (Phabricator · GitHub) Kontrola kódu Gerrit Zobrazení historie Git Stáhněte si zdrojový soubor tarball
Parametry $wgMergedGroup $wgCanCheckOldUser $wgOldUsersAreRenamed $wgMigrationGroup $wgMigrationInProgress $wgOldUsernamePrefix $wgInProgressGroup
Použité háčky (hooks) AuthChangeFormFields PluggableAuthPopulateGroups userCan
Přeložte rozšíření WikiToLDAP, používá-li lokalizaci z translatewiki.net

Počáteční vývoj tohoto rozšíření byl financován The Open Source Geospatial Foundation, aby pomohl migrovat jejich uživatele wiki z uživatelských účtů pouze MediaWiki na jejich centralizované, LDAP podporované OSGeo Services UserID.

Záměrem je sloučit stávající wiki účty s účty podporovanými LDAP pomocí rozšíření UserMerge . K tomu slouží dvě speciální stránky: Special:WikiUserMerge, Special:LDAPUserMerge. Kvůli požadavkům na OSGeo bylo vykonáno více práce na pracovním postupu Special:LDAPUserMerge, ale druhý by měl fungovat také.

Předpoklady

• Testovací wiki – před nasazením do produkce budete chtít otestovat celý pracovní postup, protože ověřování je kritickou součástí wiki.
• Nastavte rozšíření LDAPAuthentication2 – To závisí alespoň na PluggableAuth a LDAPProvider . Než budete pokračovat, měli byste zajistit, aby se uživatelé mohli přihlásit pomocí svých přihlašovacích údajů LDAP.
• Povolit rozšíření UserMerge – WikiToLDAP používá slučovací schopnost UserMerge ke zpracování skutečného slučování uživatelů.
• Povolit rozšíření Renameuser – To je potřeba, pokud chcete na začátku přejmenovat všechny stávající uživatele na wiki.

Instalace

This extension uses the new (as of early 2021) Composer for extensions guidance to install the extension.

To znamená, že k instalaci rozšíření musíte nainstalovat Composer a spustit následující Chcete-li stáhnout rozšíření, spusťte následující příkaz z příkazového řádku v adresáři nejvyšší úrovně vaší wiki (tj. ten, který obsahuje soubor LocalSettings.php):

   $ COMPOSER=composer.local.json php ( touch $COMPOSER && \
      php composer.phar require --no-update mediawiki/wiki-to-ldap )
   $ php composer.phar update

Poté budete muset rozšíření povolit přidáním následujícího do souboru LocalSettings.php:

    wfLoadExtension( 'WikiToLDAP' );

Konfigurace

Stejně jako u většiny ostatních rozšíření MediaWiki se toto rozšíření konfiguruje nastavením proměnných PHP v souboru LocalSettings.php. The settings are all prefixed with WikiToLDAP so the MigrationInProgress setting below would be set by adding the following line to the LocalSettings.php:

    $WikiToLDAPMigrationInProgress = false;

Setting	Default	Description
MigrationGroup	wikitoldap-needs-migration	The group old wiki users are put into before any migration is attempted.
InProgressGroup	wikitoldap-in-progress	The group users are put into after they log in and migration has started.
MergedGroup	wikitoldap-merged	The group for users who have gone through WikiToLDAP's merge process.
OldUserNamePrefix	⚠️	The prefix the old wiki accounts have. You can use the -r option in the 'MoveToMigrationGroup.php' script to rename all current wiki users with this prefix.
MigrationInProgress	true	Whether any migration is currently in progress. If false, defaults to behaving just like LDAPAuthentication2.
OldUsersAreRenamed	false	Set to true if you use the -r option in the 'MoveToMigrationGroup.php' script.
CanCheckOldUser	false	Set to true if you want users to be able to log in with their old wiki username during the transition period.