View source for Extension:CentralAuth/ja

<languages/>
{{Extension
|status    = stable
|type1     = user identity
|type2     = database
|type3     = special
|type4     = api
|username    = Brooke Vibber
|image     = CentralAuth administration demo screenshot.png
|update    =
|compatibility policy = rel
|download  = {{WikimediaDownload|CentralAuth|phab=ECAU}}
|readme    =
|changelog =
|description = グローバルアカウントへの統合を可能にする
|example   =
|newhook1  = CentralAuthIsUIReloadRecommended
|newhook2  = CentralAuthLoginRedirectData
|newhook3  = CentralAuthPostLoginRedirect
|newhook4  = CentralAuthSilentLoginRedirect
|newhook5  = CentralAuthWikiList
|phabricator = MediaWiki-extensions-CentralAuth
|table1    = globalnames
|table2    = localnames
|table3    = globaluser
|table4    = localuser
|table5    = global_user_groups
|table6    = global_group_permissions
|table7    = wikiset
|table8    = global_group_restrictions
|table9    = renameuser_status
|table10   = renameuser_queue
|table11   = users_to_rename
|table12   = global_edit_count
|table13   = global_user_autocreate_serial
}}
<span lang="en" dir="ltr" class="mw-content-ltr">'''CentralAuth''' allows merging several existing separate account systems into one global account system.</span>

{{warning|1=
<span class="mw-translate-fuzzy">CentralAuthは、共通認証用テーブルに統合される必要のある何百万ものアカウントを既に持っているウィキメディアプロジェクトのために特別に設計されました。</span>
一から新たなウィキを立ち上げようとしていて、既存アカウントを共通認証用テーブルに統合する必要がない場合には、CentralAuth を使うより {{ll|Manual:$wgSharedDB|$wgSharedDB}} を使って共通認証アカウントを設定した方がずっと簡単です。<ref>[[mailarchive:mediawiki-l/2008-October/028805.html|[Mediawiki-l] CentralAuth problems: Help required]]</ref><ref>[[mailarchive:mediawiki-l/2008-October/028894.html|[Mediawiki-l] Need help with CentralAuth]]</ref>

しかしながら、<syntaxhighlight lang=php inline>$wgSharedDB</syntaxhighlight> は単に利用者名作成の衝突回避には役立つものの、ユニバーサルなサインインなどの処理は対象外で (利用者は個別のウィキごとにサインインが必要)、クラスター横断型アカウントの権限やその管理には対応しません。
この拡張機能の構成は、上記の機能性を実現するため複雑です。

<span lang="en" dir="ltr" class="mw-content-ltr">If you end up using this extension on a third-party wiki, it is likely that you will end up having to troubleshoot complex issues that potentially require diving into the source code to resolve.</span>
'''<span lang="en" dir="ltr" class="mw-content-ltr">You have been warned.</span>'''
}}

<span id="Installation"></span>
==インストール==
<span class="mw-translate-fuzzy">CentralAuth のインストールと使用の前提条件は、以下の [[#Setup|セットアップ]]節を参照してください。</span>
<span class="mw-translate-fuzzy">CentralAuth を有効にする準備ができたら、次に以下の指示に従ってください:</span>

# <span lang="en" dir="ltr" class="mw-content-ltr">Install {{ll|Extension:AntiSpoof}}, since it is a required dependency.</span>
# [[Special:ExtensionDistributor/CentralAuth|最新のスナップショット]]をダウンロードして、<code>extensions</code>ディレクトリに展開します。
<div class="mw-translate-fuzzy">
# データベースを選択し、CentralAuthデータベーステーブルを作成してください。
</div> 使用するデータベースは既存でも、新規作成することもできす。拡張機能の使用する規定のデータベースの名前は<code>centralauth</code>です (以下{{phpi|$wgCentralAuthDatabase}}をご参照ください)。 このデータベースを使用し、次に<code>tables-generated.sql</code>を実行します。
#* {{ll|Extension:AntiSpoof}} を使用する場合は、グローバルな <code>spoofuser</code> テーブルを作成する櫃行があります (ウィキを問わず見た目が似た利用者名を除外するため。) これを行う方法の一つとして、ローカルwikiのデータベースから<code>spoofuser</code>テーブルのダンプを作成し、新しい{{phpi|$wgCentralAuthDatabase}}にインポートします。
#{{phpi|wfLoadExtension( 'CentralAuth' );}} の追加先は、ご利用のウィキ単位で  {{ll|Manual:LocalSettings.php|LocalSettings.php}} に、もしくはご利用のウィキごとに <code>LocalSettings.php</code> に含まれた他の PHP ファイルです。 
#これで拡張機能が有効になるはずです。

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Create a new database ===
</div>
<span class="mw-translate-fuzzy">ここで紹介するサンプルシェルとSQLコマンドは、CentralAuth のデータベースを作成してそこに spoofuser テーブルを転写してから、既存のユーザーデータをそこ<!-- 中央Wikiとは？ -->へ移行するために使います。</span>
ご利用のウィキのインストール形態に合わせて、$wgDBname と $wgDBuser を該当する値に置換します。

新規データベースを作成 (この段階はオプション、既存のデータベースを使うなら本項目は飛ばしてテーブル作成の手順へ進みます):

<syntaxhighlight lang="shell-session">
$ cd extensions/CentralAuth
$ mysql -u root -p
(enter password for root SQL user)
</syntaxhighlight>

<syntaxhighlight lang="mysql">
CREATE DATABASE centralauth;
USE centralauth;
GRANT all on centralauth.* to '$wgDBuser'@'localhost';
quit
</syntaxhighlight>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== Run maintenance scripts ===
</div>
<span class="mw-translate-fuzzy">以下の記述は現時点の作業ディレクトリがご利用の MediaWiki インストレーションであることを前提にします (ご利用の CentralAuth ディレクトリではない点にご注意。)</span>
統一認証テーブルを作成します（<code>{{ll|Manual:sql.php|sql.php}}</code>の使用が推奨されます）。

<syntaxhighlight lang="shell">
php maintenance/run.php sql --wikidb centralauth extensions/CentralAuth/schema/<データベースの種類>/tables-generated.sql
</syntaxhighlight>

<div class="mw-translate-fuzzy">
AntiSpoof をインストールした環境では、テーブル作成はそれを経由します (代替案として既存の AntiSpoof テーブルを転写しておき、これまでのエントリを保存):
</div>

<syntaxhighlight lang="shell">
php maintenance/run.php sql --wikidb centralauth extensions/AntiSpoof/sql/<db_type>/tables-generated.sql
</syntaxhighlight>

利用者移行スクリプトの実行

<syntaxhighlight lang="shell-session">
$ php maintenance/run.php CentralAuth:migratePass0.php
$ php maintenance/run.php CentralAuth:migratePass1.php
</syntaxhighlight>

<span id="Upgrading"></span>
=== アップグレード ===
<span lang="en" dir="ltr" class="mw-content-ltr">CentralAuth is designed for large wiki farms who run database updates manually in order to enable zero-downtime upgrades.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">For that reason, the CentralAuth database will not be updated with the usual upgrade process.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">Third-party users are expected to follow CentralAuth development and apply database migrations manually instead.</span>

<span id="Setup"></span>
==セットアップ==
{{Warning|1=異なるプライマリドメインを横断するログインを実現するには、統一ログイン ウィキを作る必要があります (つまりご利用のウィキが同一のドメインのサブドメインの配下にない場合。) 詳細は[[#"SUL2" behavior|下記]]を参照してください。}}

初めに、[[Special:MyLanguage/Manual:Wiki family|wikiファミリ]]を{{wg|Conf}}で設定する必要があり、そうしないとCentralAuthがあなたのwikiファミリに使用できません。
これには、{{wg|LocalDatabases}}をセットして、{{phpi|$wgConf->wikis}}、{{phpi|$wgConf->settings}}（最小は{{wg|CanonicalServer}}、{{wg|Server}}、{{wg|ArticlePath}}）に割り当てることが含まれます。
[[Special:MyLanguage/Manual:$wgConf#Example|例]]によく従って下さい。
新しいウィキファミリーを作成する場合、各グループのウィキのデータベースが同じサフィックスを持つ方が簡単です（例えば、同じグループに属するウィキのデータベース<code>enwiki</code>、<code>dewiki</code>、<code>frwiki</code>などは、すべて「<code>wiki</code>」というサフィックスを持っているとします）。

拡張機能をインストール後、CentralAuthのデータベースにあるデータを集める必要があります。
グローバルアカウントを過去にさかのぼって設定するためには、{{git file|project=mediawiki/extensions/CentralAuth|file=maintenance/migratePass0.php|branch=HEAD|text=migratePass0.php}}および{{git file|project=mediawiki/extensions/CentralAuth|file=maintenance/migratePass1.php|branch=HEAD|text=migratePass1.php}}のスクリプトを実行する必要があります。
最初のものは、CentralAuthデータベースにあなたのWikiに関する情報を保存します。一方、2番目のものは、自動移行ヒューリスティックを使用してグローバルアカウントを生成します。
利用者は'''Special:MergeAccount'''を通じて統合できます。
ドライランはテスト目的で使用することができます。

グローバルグループを有効にするには、CentralAuthデータベースの<code>global_group_permissions</code>テーブルに、<code>ggp_group='steward'</code>と（グループ管理インターフェイスへのアクセス用に）<code>ggp_permission=globalgrouppermissions</code>のエントリを作成する必要があります。
使用することが推奨されるサンプルクエリー :
<syntaxhighlight lang="sql">
INSERT INTO global_group_permissions (ggp_group,ggp_permission) VALUES ('steward','globalgrouppermissions'), ('steward','globalgroupmembership');
</syntaxhighlight>

<span lang="en" dir="ltr" class="mw-content-ltr">Then, promote some users into stewards:</span>
<syntaxhighlight lang="sql">
INSERT IGNORE INTO global_user_groups (gug_user, gug_group) VALUES ((SELECT gu_id FROM globaluser WHERE gu_name='Admin'), 'steward');
</syntaxhighlight>

<span lang="en" dir="ltr" class="mw-content-ltr">There are various settings you may wish to modify (e.g. whether to provide single sign-on across a whole domain) listed in {{git file|project=mediawiki/extensions/CentralAuth|file=CentralAuth.php|branch=HEAD|text=CentralAuth.php}}.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">In particular, you will want to override the default value of {{phpi|$wgCentralAuthDatabase}} if your CentralAuth database is named something other than <code>'centralauth'</code>.</span>
<code>wfLoadExtension</code>の行の後に<code>LocalSettings.php</code>を設定してください。

<syntaxhighlight lang="php">
wfLoadExtension( 'CentralAuth' );
$wgCentralAuthDatabase = 'mycentralauthdatabase';
</syntaxhighlight>

<span id="&quot;SUL2&quot;_behavior"></span>
== リンクの挙動 ==
{{warning|1=<span lang="en" dir="ltr" class="mw-content-ltr">As all logged in users will have a session in the central login wiki, you are recommended to set up a new wiki with as few extensions installed as possible (not using an existing wiki for this purpose).</span>
これにより、XSSの脆弱性のリスクが軽減されます。}}
{{warning|1=SameSite Cookieポリシーにより、新しいバージョンのGoogle Chromeではユニバーサルサインオンが機能しない可能性があります。 解決方法 :
<syntaxhighlight lang="php">
$wgCookieSameSite = "None";
$wgUseSameSiteLegacyCookies = true;
</syntaxhighlight>

さらに、サイトをHTTPSで稼働させる必要があります。
}}
{{update}}
{{expand|1=needs example on how to set this up.}}

<span lang="en" dir="ltr" class="mw-content-ltr">In July 2013 WMF changed its approach to logging users into multiple wikis.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">When configured for this new approach, after successful login and account creation CentralAuth redirects to <code>Special:CentralLogin/start?token=''somevalue''</code> on a "central login wiki", which sets cookies on that wiki and then redirects back to the logged-into wiki.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">It omits the "login/account creation success" page, instead redirecting back to the "returnto" page that the user was originally on.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">It places 1x1 pixel images in the footer of that page, in place of the icons formerly used on the "login/account creation success" page.</span>

<span lang="en" dir="ltr" class="mw-content-ltr">The settings for this are, roughly,</span>

<syntaxhighlight lang="php">
# General CentralAuth configuration
$wgCentralAuthCookies = true;
$wgCentralAuthDatabase = 'centralauthDatabaseName'; // default is 'centralauth'
$wgCentralAuthAutoMigrate = true;
#$wgCentralAuthCookieDomain = '.example.org';
$wgCentralAuthAutoLoginWikis = array(
    # Mapping from domain name to wiki id for other wikis to automatically login into
);

# Activates the redirect to the "central login wiki"
$wgCentralAuthLoginWiki = 'WikiIdOfLoginWiki';
</syntaxhighlight>

<syntaxhighlight lang="php" inline="true">$wgCentralAuthLoginWiki</syntaxhighlight> <span lang="en" dir="ltr" class="mw-content-ltr">is the id (usually the database-name) of the wiki to which CentralAuth will redirect on login and create account.</span>

<span id="Cache_issues"></span>
=== キャッシュの問題 ===
最良の結果を得るために、memcachedの使用が推奨されます。
<span lang="en" dir="ltr" class="mw-content-ltr">If you have only a single server, accelerator caches (<code>CACHE_ACCEL</code>) like APCu can also work, but do not use them if you have multiple servers.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">If you have no cache set up (i.e. <code>CACHE_NONE</code>) for {{phpi|$wgMainCacheType}}, or are using <code>CACHE_DB</code>, then you need to make sure all your wikis use the same caching table.</span>

<span lang="en" dir="ltr" class="mw-content-ltr">By default, each wiki in your wiki farm will use the <code>objectcache</code> table in its own database (with its own db prefix) when {{phpi|$wgMainCacheType}} is set to <code>CACHE_NONE</code> or <code>CACHE_DB</code>.</span>
<!-- FIXME, does anything in centralauth use CACHE_ANYTING, or is this only an issue when wgMainCacheType is set to CACHE_DB-->
これをCentralAuthで正常に動作させるために、中央のキャッシュテーブルを使用するようwikiを設定する必要があります。

<div lang="en" dir="ltr" class="mw-content-ltr">
If you want to make a central caching table in the <code>centralauth</code> database (and assuming one of your existing wikis has a database name of <code>enwiki</code>), run code like the following to copy the table to your other database:
</div>

<syntaxhighlight lang="sql">
CREATE TABLE centralauth.objectcache LIKE enwiki.objectcache
</syntaxhighlight>

次に、以下の設定を全てのWikiに行い、中央のWikiが使用されるようにします :

<syntaxhighlight lang="php">
$wgSharedDB     = 'centralauth'; // or whatever database you use for central data
$wgSharedTables = array( 'objectcache' ); // remember to copy the table structure's to the central database first
$wgCentralAuthSessionCacheType = CACHE_DB; // Tell mediawiki to use objectcache database for central auth. 
</syntaxhighlight>

<div lang="en" dir="ltr" class="mw-content-ltr">
=== HTTP and HTTPS ===
</div>
<span lang="en" dir="ltr" class="mw-content-ltr">Since 2023, CentralAuth does not support mixed-protocol HTTP/HTTPS wikis, only pure-HTTPS wikis (with {{ll|Manual:$wgForceHTTPS|$wgForceHTTPS}} set to <code>true</code>) and pure-HTTP wikis (primarily for local testing).</span>[[phab:T348852]]

<span id="Configuration"></span>
=== 設定 ===
{| class="wikitable"
|+ {{git file|project=mediawiki/extensions/CentralAuth|file=CentralAuth.php|branch=HEAD|text=CentralAuth.php}} での構成設定
|--
! パラメーター
! 既定値
! コメント
|---
| <syntaxhighlight lang="php" inline="true">$wgCentralAuthDatabase</syntaxhighlight>
| <syntaxhighlight lang="php" inline="true">'centralauth'</syntaxhighlight>
| CentralAuthのデータを保存するデータベース名。

<span lang="en" dir="ltr" class="mw-content-ltr">If this is not on the primary database connection, don't forget to also set up <syntaxhighlight lang="php" inline="true">$wgDBservers</syntaxhighlight> to have an entry with a <code>groupLoads</code> setting for the <code>'CentralAuth'</code> group.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">Alternatively you can use <syntaxhighlight lang="php" inline="true">$wgLBFactoryConf</syntaxhighlight> to set up an <code>LBFactoryMulti</code> object.</span>

<span lang="en" dir="ltr" class="mw-content-ltr">To use a database with a table prefix, set this variable to "<code><nowiki>{$database}-{$prefix}</nowiki></code>".</span>
|---
| <syntaxhighlight lang="php" inline="true">$wgCentralAuthAutoMigrate</syntaxhighlight>
| <syntaxhighlight lang="php" inline="true">false</syntaxhighlight>
| <span lang="en" dir="ltr" class="mw-content-ltr">If <code>true</code>, existing unattached accounts will be automatically migrated if possible at first login.</span>

新規アカウント作成の場合、添付が必要です。

<span lang="en" dir="ltr" class="mw-content-ltr">If <code>false</code>, unattached accounts will not be harassed unless the individual account has opted in to migration.</span>
|---
| <syntaxhighlight lang="php" inline="true">$wgCentralAuthAutoMigrateNonGlobalAccounts</syntaxhighlight>
| <syntaxhighlight lang="php" inline="true">false</syntaxhighlight>
| <span lang="en" dir="ltr" class="mw-content-ltr">If <code>true</code>, existing unattached accounts where no global account exists will be compared to see if a merge can be made based on passwords and emails with no clashes (all accounts merge).</span>

以前は<syntaxhighlight lang="php" inline="true">$wgCentralAuthAutoMigrate</syntaxhighlight>に管理されていました。
|---
| <syntaxhighlight lang="php" inline="true">$wgCentralAuthStrict</syntaxhighlight>
| <syntaxhighlight lang="php" inline="true">false</syntaxhighlight>
| <span lang="en" dir="ltr" class="mw-content-ltr">If <code>true</code>, remaining accounts which have not been attached will be forbidden from logging in until they are resolved.</span>
|---
| <syntaxhighlight lang="php" inline="true">$wgCentralAuthDryRun</syntaxhighlight>
| <syntaxhighlight lang="php" inline="true">false</syntaxhighlight>
| <span lang="en" dir="ltr" class="mw-content-ltr">If <code>true</code>, merging won't actually be possible through the Special:MergeAccount interface.</span>
|---
| <syntaxhighlight lang="php" inline="true">$wgCentralAuthCookies</syntaxhighlight>
| <syntaxhighlight lang="php" inline="true">false</syntaxhighlight>
| <span lang="en" dir="ltr" class="mw-content-ltr">If <code>true</code>, global session and token cookies will be set alongside the per-wiki session and login tokens when users log in with a global account.</span>

<span lang="en" dir="ltr" class="mw-content-ltr">This allows other wikis on the same domain to transparently log them in.</span>
|---
| <syntaxhighlight lang="php" inline="true">$wgCentralAuthLoginWiki</syntaxhighlight>
| <syntaxhighlight lang="php" inline="true">false</syntaxhighlight>
| <span lang="en" dir="ltr" class="mw-content-ltr">Database name of a central login wiki.</span> <span lang="en" dir="ltr" class="mw-content-ltr">This is an alternative to directly setting cross-domain cookies for each wiki in <syntaxhighlight lang="php" inline="true">$wgCentralAuthAutoLoginWikis</syntaxhighlight>.</span> <span lang="en" dir="ltr" class="mw-content-ltr">If set, a single login wiki will use a session/cookie to handle unified login sessions across wikis.</span>

<span lang="en" dir="ltr" class="mw-content-ltr">On login, users will be redirected to the login wiki's Special:CentralLogin/login page and then redirected to Special:CentralLogin back on the originating wiki.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">In the process, the central login wiki cookie and session will be set.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">As the user accesses other wikis, the login wiki will be checked via JavaScript to check login status and set the local session and cookies.</span>

これには <syntaxhighlight lang="php" inline="true">$wgCentralAuthCookies</syntaxhighlight> が必要です。
|---
| <syntaxhighlight lang="php" inline="true">$wgCentralAuthCookieDomain</syntaxhighlight>
| <syntaxhighlight lang="php" inline="true">''</syntaxhighlight>
| <span lang="en" dir="ltr" class="mw-content-ltr">Domain to set global cookies for.</span>

<span lang="en" dir="ltr" class="mw-content-ltr">For instance, <code>'.wikipedia.org'</code> to work on all <code>wikipedia.org</code> subdomains instead of just the current one.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">Leave blank to set the cookie for the current domain only, such as if all your wikis are hosted on the same subdomain.</span>
|---
| <syntaxhighlight lang="php" inline="true">$wgCentralAuthCookiePrefix</syntaxhighlight>
| <syntaxhighlight lang="php" inline="true">'centralauth_'</syntaxhighlight>
| <span lang="en" dir="ltr" class="mw-content-ltr">Prefix for CentralAuth global authentication cookies.</span>
|---
| <syntaxhighlight lang="php" inline="true">$wgCentralAuthCookiePath</syntaxhighlight>
| <syntaxhighlight lang="php" inline="true">'/'</syntaxhighlight>
| <span lang="en" dir="ltr" class="mw-content-ltr">Path for CentralAuth global authentication cookies.</span> <span lang="en" dir="ltr" class="mw-content-ltr">Set this variable if you want to restrict cookies to a certain path within the domain specified by <syntaxhighlight lang="php" inline="true">$wgCentralAuthCookieDomain</syntaxhighlight>.</span>
|---
| <syntaxhighlight lang="php" inline="true">$wgCentralAuthAutoLoginWikis</syntaxhighlight>
| <syntaxhighlight lang="php" inline="true">[]</syntaxhighlight>
| <span lang="en" dir="ltr" class="mw-content-ltr">List of wiki IDs which should be called on login to try to set third-party cookies for the global session state.</span>

<div lang="en" dir="ltr" class="mw-content-ltr">
The wiki ID is typically the database name, except when table prefixes are used, in which case it is the database name, a hyphen separator, and then the table prefix.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
This allows a farm with multiple second-level domains to set up a global session on all of them by hitting one wiki from each domain (en.wikipedia.org, en.wikinews.org, etc.).
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
Done by accessing <code>Special:CentralAutoLogin/start</code> on each wiki.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
If empty, no other wikis will be hit.
</div>

<div lang="en" dir="ltr" class="mw-content-ltr">
The key should be set to the cookie domain name.
</div>
|---
| <syntaxhighlight lang="php" inline="true">$wgCentralAuthAutoCreateWikis</syntaxhighlight>
| <syntaxhighlight lang="php" inline="true">[]</syntaxhighlight>
| <span lang="en" dir="ltr" class="mw-content-ltr">List of wiki IDs on which an attached local account should be created automatically when the global account is created.</span>

<span lang="en" dir="ltr" class="mw-content-ltr">The wiki ID is typically the database name, except when table prefixes are used, in which case it is the database name, a hyphen separator, and then the table prefix.</span>
|---
| <syntaxhighlight lang="php" inline="true">$wgCentralAuthLoginIcon</syntaxhighlight>
| <syntaxhighlight lang="php" inline="true">false</syntaxhighlight>
| <span lang="en" dir="ltr" class="mw-content-ltr">Local filesystem path to the icon returned by <code>Special:CentralAutoLogin</code> should be a 20x20px PNG.</span>
|---
| <syntaxhighlight lang="php" inline="true">$wgCentralAuthPrefsForUIReload</syntaxhighlight>
| <syntaxhighlight lang="php" inline="true">[ 'skin', 'language', 'thumbsize', 'underline', 'stubthreshold', 'showhiddencats', 'justify', 'numberheadings', 'editondblclick', 'editsection', 'editsectiononrightclick', 'usenewrc', 'extendwatchlist' ]</syntaxhighlight>
| <span lang="en" dir="ltr" class="mw-content-ltr">User preferences for which we should recommend reloading the page after a successful central login query.</span>

<span lang="en" dir="ltr" class="mw-content-ltr">If you need to do something more complicated than just {{phpi|1=$userOptionsLookup->getOption( $user, $pref ) !== $userOptionsLookup->getDefaultOption( $pref )}}, use the hook <code>CentralAuthIsUIReloadRecommended</code>.</span>
|---
| <syntaxhighlight lang="php" inline="true">$wgCentralAuthRC</syntaxhighlight>
| <syntaxhighlight lang="php" inline="true">[]</syntaxhighlight>
| <span lang="en" dir="ltr" class="mw-content-ltr">Array of settings for sending the CentralAuth events to the RC Feeds.</span>

@example $wgRCFeeds['example'] = array(
		'uri' => "udp://localhost:1336",
	);
|---
| <syntaxhighlight lang="php" inline="true">$wgCentralAuthWikisPerSuppressJob</syntaxhighlight>
| <syntaxhighlight lang="php" inline="true">10</syntaxhighlight>
| <span lang="en" dir="ltr" class="mw-content-ltr">Size of wikis handled in one suppress user job.</span> <span lang="en" dir="ltr" class="mw-content-ltr">Keep in mind that one wiki requires <code>~10</code> queries.</span>
|---
| <syntaxhighlight lang="php" inline="true">$wgCentralAuthReadOnly</syntaxhighlight>
| <syntaxhighlight lang="php" inline="true">false</syntaxhighlight>
| <span lang="en" dir="ltr" class="mw-content-ltr">Like <syntaxhighlight lang="php" inline="true">$wgReadOnly</syntaxhighlight>, used to set extension to database read only mode.</span>

@var bool
|---
| <syntaxhighlight lang="php" inline="true">$wgCentralAuthEnableGlobalRenameRequest</syntaxhighlight>
| <syntaxhighlight lang="php" inline="true">false</syntaxhighlight>
| <span lang="en" dir="ltr" class="mw-content-ltr">Feature flag for <code>Special:GlobalRenameRequest</code>.</span>

@var bool
|---
| <syntaxhighlight lang="php" inline="true">$wgCentralAuthGlobalPasswordPolicies</syntaxhighlight>
| <syntaxhighlight lang="php" inline="true">[]</syntaxhighlight>
| <span lang="en" dir="ltr" class="mw-content-ltr">Global password policies.</span> <span lang="en" dir="ltr" class="mw-content-ltr">These are applied like local password policies, the strongest policy applicable to a user is used.</span> ローカルグループ (当該利用者がいずれのウィキであってもそのグループに所属しているなら方針を当該利用者に適用) もグローバルグループもさまざまな方針の適用対象です。

@var array
|---
| <syntaxhighlight lang="php" inline="true">$wgGlobalRenameDenylist</syntaxhighlight>
| <syntaxhighlight lang="php" inline="true">null</syntaxhighlight>
| <span lang="en" dir="ltr" class="mw-content-ltr">A list of users who won't be allowed to create new global rename requests through Special:GlobalRenameRequest.</span>

<span lang="en" dir="ltr" class="mw-content-ltr">There are two ways to set it:</span>
* <span lang="en" dir="ltr" class="mw-content-ltr">Using a wiki-page: use a {{class|Title}} object to have a wiki-page (<code>MediaWiki:GlobalRenameDenylist</code> for example) as the banned-list.</span> <span lang="en" dir="ltr" class="mw-content-ltr">The wiki-page must be a list with one item per line, and must exist otherwise <code>Special:GlobalRenameRequest</code> will throw a {{class|MWException}}.</span> <br /><span lang="en" dir="ltr" class="mw-content-ltr">Example:</span> <syntaxhighlight lang="php" inline="true">$wgGlobalRenameDenylist = Title::makeTitle( NS_MEDIAWIKI, 'GlobalRenameDenylist' );</syntaxhighlight>.
* <span lang="en" dir="ltr" class="mw-content-ltr">Using a URL: put a complete URL which must return, using HTTP, a plain-text list of the banned users (and nothing else).</span><br /><span lang="en" dir="ltr" class="mw-content-ltr">For example, with a URL pointing to a wiki page:</span> <syntaxhighlight lang="php" inline="true">$wgGlobalRenameDenylist = "https://yourwiki/yourpath/index.php?title=MediaWiki:GlobalRenameDenylist&action=raw";</syntaxhighlight>
<span lang="en" dir="ltr" class="mw-content-ltr">You can use the exact names or regular expressions.</span>

@var Title|string|null
|---
| <syntaxhighlight lang="php" inline="true">$wgCentralAuthGlobalBlockInterwikiPrefix</syntaxhighlight>
| <syntaxhighlight lang="php" inline="true">"global"</syntaxhighlight>
| <span lang="en" dir="ltr" class="mw-content-ltr">When globally suppressing a user, a block against this user is inserted in all wikis.</span> <span lang="en" dir="ltr" class="mw-content-ltr">CentralAuth will set the author of theses blocks as <code>$wgCentralAuthGlobalBlockInterwikiPrefix>(user-who-made-the-suppression's nickname)</code>.</span> <span lang="en" dir="ltr" class="mw-content-ltr">For example, if</span> <syntaxhighlight lang=php inline>$wgCentralAuthGlobalBlockInterwikiPrefix = "Admins";</syntaxhighlight>, <span lang="en" dir="ltr" class="mw-content-ltr">and Joe suppresses John, all wikis will show in {{Special|BlockList}} a block against John made by <code>Admins>Joe</code>.</span>

@var string
|}

<span id="Use"></span>
== 使用法 ==
単一利用者ログインシステム (SUL) を採用、MediaWiki のAuthPlugin システムを援用。
利用者の作成とログインは単一の統一利用者テーブルを用いて、全てのウィキでグローバルに実行されます。
ローカルの利用者アカウントはいずれにしてもアカウント作成・ログイン時に自動的に作成されることに留意してください。

この拡張機能はまた、グローバルな利用者グループを実行し、そこにはグローバルアカウントを登録できます。

<span id="User_rights"></span>
=== 利用者権限 ===
CentralAuth は複数の新しい利用者権限を定義します。

{| class="wikitable"
!利用者権限
!技能
!既定のグループ
!状態
|-
|<code>centralauth-createlocal</code>
|<span lang="en" dir="ltr" class="mw-content-ltr">Forcibly create a local account for a global account</span>
|<span lang="en" dir="ltr" class="mw-content-ltr">Stewards and sysops</span>
|<span lang="en" dir="ltr" class="mw-content-ltr">Active in MW 1.36+</span>
|-
|<code>centralauth-lock</code>
|<span lang="en" dir="ltr" class="mw-content-ltr">Prevent users from logging in on any wiki</span>
|<span lang="en" dir="ltr" class="mw-content-ltr">Stewards</span>
|<span lang="en" dir="ltr" class="mw-content-ltr">Active</span>
|-
|<code>centralauth-suppress</code>
|<span lang="en" dir="ltr" class="mw-content-ltr">Suppress or unhide global accounts</span>
|<span lang="en" dir="ltr" class="mw-content-ltr">Stewards</span>
|<span lang="en" dir="ltr" class="mw-content-ltr">Active</span>
|-
|<code>centralauth-rename</code>
|<span lang="en" dir="ltr" class="mw-content-ltr">Rename global accounts</span>
|<span lang="en" dir="ltr" class="mw-content-ltr">Stewards</span>
|<span lang="en" dir="ltr" class="mw-content-ltr">Active</span>
|-
|<code>centralauth-unmerge</code>
|<span lang="en" dir="ltr" class="mw-content-ltr">Unmerge global accounts from a local account</span>
|<span lang="en" dir="ltr" class="mw-content-ltr">Stewards</span>
|<span lang="en" dir="ltr" class="mw-content-ltr">Active</span>
|-
|<code>centralauth-merge</code>
|<span lang="en" dir="ltr" class="mw-content-ltr">Merge all CentralAuth accounts globally</span>
|<span lang="en" dir="ltr" class="mw-content-ltr">All users</span>
|<span lang="en" dir="ltr" class="mw-content-ltr">Active; usually automatic</span>
|-
|<code>globalgrouppermissions</code> 
|<span lang="en" dir="ltr" class="mw-content-ltr">Manage permissions of global groups</span>
|<span lang="en" dir="ltr" class="mw-content-ltr">Global Stewards</span>
|<span lang="en" dir="ltr" class="mw-content-ltr">Active; not assigned to local stewards by default</span>
|-
|<code>globalgroupmembership</code>
|<span lang="en" dir="ltr" class="mw-content-ltr">Edit membership to global groups</span>
|<span lang="en" dir="ltr" class="mw-content-ltr">Global Stewards</span>
|<span lang="en" dir="ltr" class="mw-content-ltr">Active; not assigned to local stewards by default</span>
|}

<span id="Functions"></span>
==機能==

===Single-user login (SUL)===
<span lang="en" dir="ltr" class="mw-content-ltr">A user with an account on more than one wiki may use [[Special:MergeAccount]] to create their global user account, which can then be used on any wiki.</span><!--A developer should add info about configuring the cookie settings--> <span lang="en" dir="ltr" class="mw-content-ltr">Users with the <code>centralauth-unmerge</code> permission (given to stewards by default) can undo a merging of a global account, where the passwords are all reset back to the pre-merge setting.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">User accounts can now also be renamed globally.</span>

<span id="Locking_and_hiding_global_users"></span>
=== グローバルユーザーをロックして非表示にする ===
[[File:Screenshot of the CentralAuth interface.png|thumb|Meta-Wiki上の[[m:Special:CentralAuth|Special:CentralAuth]]インターフェイスのスクリーンショットで、ロック/非表示のインターフェイスを表示しています。]]
グローバル アカウントは、既定で ''local'' グループ 'stewards' に与えられている <code>centralauth-lock</code> と <code>centralauth-suppress</code> の権限を持つ利用者によって ''locked'' または ''hidden'' にすることができます。
ロックされたグローバルアカウントは、現在ログインしているすべてのWikiのセッションから即座にログアウトされます。
非表示のグローバル アカウントの利用者名は、グローバル アカウント記録以外の記録には表示されません。

<span id="Wiki_sets"></span>
=== Wikiのセット ===
<span lang="en" dir="ltr" class="mw-content-ltr">A ''wiki set'' is a group of wikis specified by a user with the <code>globalgrouppermissions</code> right.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">Sets can be ''opt-in'' (wikis are not in it by default) or ''opt-out'' (wikis are in it unless opted out).</span>

<span id="Global_user_groups"></span>
===グローバル利用者グループ===
<span lang="en" dir="ltr" class="mw-content-ltr">Once you have enabled global user groups as described in the installation section, a migrated steward can use the [[Special:GlobalGroupPermissions]] interface to configure global user groups, and their rights.</span>
<span lang="en" dir="ltr" class="mw-content-ltr">A global user group is active on all wikis (the users in it have its rights on all the wikis) by default, unless the group has been specified to only be active on a specific wiki set (the users in the group only have the rights if they are on a wiki in the set).</span>
<span lang="en" dir="ltr" class="mw-content-ltr">Global group permissions are ''not'' listed at [[Special:ListUsers]], but instead [[Special:GlobalUsers]].</span>
<span lang="en" dir="ltr" class="mw-content-ltr">They are assigned by a user with the <code>globalgroupmembership</code> permission (by default the global group <code>stewards</code>), and give the specified rights to the user even if the local rights defined by {{wg|GroupPermissions}} do not do so.</span>

<span id="Licensing_and_downloads"></span>
== ライセンスとダウンロード ==
この拡張機能には GNU 一般公衆ライセンス 2.0 以降が適用され、[[Special:MyLanguage/Download from Git|ダウンロードは Git から]]、もしくは {{git file|action=tree|project=mediawiki/extensions/CentralAuth|branch=HEAD|text=web-based viewer}}経由でアクセス可能です。

ソフトウェアは現状のまま支給されます。
ウィキメディアのウィキの需要による場合、もしくは重大な脆弱性が発見された場合に更新が行われる可能性があります。

== API ==

{{ll|Extension:CentralAuth/API}}を参照

<span id="References"></span>
== 脚注 ==
<references />

<span id="See_also"></span>
==関連項目==
*[[m:Special:MyLanguage/Single login specifications|Single login specifications]] はメタウィキの単一ログインの要件
* [[m:Special:MyLanguage/Help:Unified login|Help:Unified login]]はメタウィキの統一ログインのヘルプ
* {{ll|Extension:CentralAuth/authentication}} - <span lang="en" dir="ltr" class="mw-content-ltr">CentralAuth authentication features</span>
* {{wg|SharedDB}}
* [[User:Legoktm/evil-plans2.txt]] - <span lang="en" dir="ltr" class="mw-content-ltr">2015 plan to phase out CentralAuth at WMF</span>
* {{ll|Global session threat assessment}}
* [[w:Wikipedia:Integrated watchlists|統一したウォッチリスト]]
*[[Special:MyLanguage/Extension:CentralAuth/control flow|CentralAuth制御フロー]]
* [[wikitech:Stuck global renames]]

{{OnWikimedia}}
{{Used by}}

[[Category:CentralIdLookup providers{{#translation:}}]]
[[Category:Login extensions{{#translation:}}]]