Extension:AbuseFilter/ja

マニュアル - リスト - スナップショット

AbuseFilter/ja Release status: stable
実装	User activity, Special page
説明	ウィキでの特定の行動を制限することを可能にする。
作者	Andrew Garrett (WerdnaTalk)
ライセンス	GPL
ダウンロード	スナップショットをダウンロード Subversion [ヘルプ] ソースコードを閲覧
パラメータ $wgAbuseFilterAvailableActions $wgAbuseFilterConditionLimit $wgAbuseFilterEmergencyDisableThreshold $wgAbuseFilterEmergencyDisableCount $wgAbuseFilterEmergencyDisableAge $wgAbuseFilterParserClass $wgAbuseFilterStyleVersion $wgAbuseFilterRestrictedActions $wgAbuseFilterUDPPrefix $wgAbuseFilterUDPAddress $wgAbuseFilterUDPPort $wgAbuseFilterCentralDB $wgAbuseFilterIsCentral $wgAbuseFilterBlockDuration
追加される権限 abusefilter-view abusefilter-modify abusefilter-modify-restricted abusefilter-log abusefilter-log-detail abusefilter-private abusefilter-revert abusefilter-view-private
使われているフック EditFilter GetAutoPromoteGroups AbortMove AbortNewAccount ArticleDelete LoadExtensionSchemaUpdates RecentChange_save ListDefinedTags

AbuseFilterは権限のある利用者が利用者の特定の行動を制限することを可能にします

インストール方法

注： Extension:AntiSpoof/jaが必要です

ほかのMediaWiki拡張機能と同じように、extensionsフォルダに展開しrequire_once( "$IP/extensions/AbuseFilter/AbuseFilter.php" );をLocalSettings.phpに追加し、テーブルを作成する(install.phpもしくはupdate.phpを実行する)ことでこの拡張機能をインストールすることができます。

ユーザーの権限

いったん拡張機能をインストールしたら、LocalSettings.phpでユーザー権限をセットアップしなければなりません。たとえば、次のサンプルのコンフィギュレーションではシスオペがAbuseFilterで望むことがすべて可能です。通常のログインユーザーはログとフィルタ設定を、すべての利用者(匿名利用者を含む)はフィルタ設定を見ることができます。

$wgGroupPermissions['sysop']['abusefilter-modify'] = true;
$wgGroupPermissions['sysop']['abusefilter-log-detail'] = true;
$wgGroupPermissions['*']['abusefilter-view'] = true;
$wgGroupPermissions['user']['abusefilter-log'] = true;
$wgGroupPermissions['sysop']['abusefilter-private'] = true;
$wgGroupPermissions['sysop']['abusefilter-modify-restricted'] = true;
$wgGroupPermissions['sysop']['abusefilter-revert'] = true;

privateとマークされたフィルターはabusefilter-modifyもしくはabusefilter-view-privateパーミッションのどちらを持つユーザーのみが見ることができることに注意してください。

AbuseFilterの管理

いったん拡張機能がインストールされると、フィルターは作成/テスト/変更/削除が可能でAbuseFilter管理ページのSpecial:AbuseFilterからアクセスできます。

• ルールのフォーマット
• アクション
• ウィキペディアからフィルタをインポートするには: 拡張機能をインストールしたとき、w:Special:AbuseFilterに移動し、フィルタ(たとえばw:Special:AbuseFilter/3)を選び、"Export this filter to another wiki"をクリックし、テキストをコピーし、自分のウィキのSpecial:AbuseFilter/importに移動し、テキストをペーストします。

コンフィギュレーション

変数の名前	デフォルト値	説明
$wgAbuseFilterAvailableActions	array( 'flag', 'throttle', 'warn', 'disallow', 'blockautopromote', 'block', 'degroup', 'tag' )	不正利用フィルタによって取得可能なアクション
$wgAbuseFilterConditionLimit	1000
$wgAbuseFilterEmergencyDisableThreshold	0.05	これらがX回よりも多くの編集回数にマッチし、最後更新からS秒以内に変更された場合、最後のZ回編集のうちY%よりも構成される場合、フィルタを無効にする
$wgAbuseFilterEmergencyDisableCount	2	前のフィルタを参照
$wgAbuseFilterEmergencyDisableAge	86400	前のフィルタを参照
$wgAbuseFilterParserClass	'AbuseFilterParser'	AbuseFilterのパーサークラスの名前
$wgAbuseFilterStyleVersion		$wgStyleVersionのように、しかしこの拡張機能限定です。.css/.jsファイルを変更するたびに開発者はこの番号をはじき出します。
$wgAbuseFilterRestrictedActions	array( 'block', 'degroup' )	これらのアクションを実行するフィルタを作成もしくは修正するためには利用者は"abusefilter-modify"と同じく"abusefilter-modify-restricted"利用者権限を持たなければなりません。
$wgAbuseFilterUDPPrefix	'abusefilter:'	$wgRC2UDPPrefixのように、しかしAbuseFilter?限定
$wgAbuseFilterUDPAddress	null	$wgRC2UDPAddressのように、しかしAbuseFilter?限定
$wgAbuseFilterUDPPort	null	$wgRC2UDPPortのように、しかしAbuseFilter?限定
$wgAbuseFilterCentralDB	null	グローバル不正利用フィルタが保存されるデータベースの名前
$wgAbuseFilterIsCentral	false	グローバルなAbuseFiltersが保存されるウィキに対してこの変数をtrueにセットする(グローバルフィルタを利用している場合)
$wgAbuseFilterBlockDuration	'indefinite'	AbuseFilterによるブロックの期間

API

AbuseFilterは2つのAPIリストモジュールを追加します。1つは不正利用フィルタ("abusefilters")でもう1つは不正利用ログの詳細情報です。これはほかのMediaWikiのログ("abuselog")から分離されているからです。APIを使って不正利用フィルタを作成もしくは修正することは不可能です。

list = abusefilters

フィルタに関する情報のリストです。

パラメータ

• abfstartid: 列挙を始めるフィルタid
• abfendid: 列挙を止めるフィルタid
• abfdir: 列挙する方向(古いほう、新しいほう)
• abfshow: これらの基準(enabled|!enabled|deleted|!deleted|private|!private)を満たすフィルタのみを表示する
• abflimit: 表示するフィルタの最大数
• abfprop: 取得するプロパティ(id|description|pattern|actions|hits|comments|lasteditor|lastedittime|status|private)

フィルタが提供されるとき、abfpropで指定されるプロパティの一部は適切な利用者権限がないかぎり見つかりません。

例

権限のない不正利用フィルタの一覧を表示する

api.php ? action=query & list=abusefilters & abfshow=!private & abfprop=id|hits

<api>
  <query>
    <abusefilters>
      <filter id="1" hits="867" />
      <filter id="3" hits="66110" />
      <filter id="5" hits="464" />
      <filter id="6" hits="19" />
      <filter id="8" hits="7" />
      <filter id="9" hits="24869" />
      <filter id="11" hits="10033" />
      <filter id="14" hits="63" />
      <filter id="15" hits="15" />
      <filter id="16" hits="44" />
    </abusefilters>
  </query>
  <query-continue>
    <abusefilters abfstartid="18" />
  </query-continue>
</api>

list = abuselog

不正利用フィルタで作動するインスタンスの一覧。

Parameters

• aflstart: 列挙を始めるタイムスタンプ
• aflend: 列挙を止めるタイムスタンプ
• afldir: 列挙する方向(古いほう、新しいほう)
• afluser: アクションが任意の利用者もしくはIPアドレスによって試されたエントリーのみを表示する
• afltitle: アクションが関わるページでのエントリーのみを表示する
• aflfilter: 任意のフィルターIDを作動させたエントリーのみを表示する
• afllimit: 一覧を表示するエントリーの最大数
• aflprop: 取得するプロパティ(ids|user|title|action|result|timestamp|details)

例

利用者の"SineBot"からのアクションに対応して不正利用フィルタが作動したインスタンスの一覧を表示する

api.php ? action=query & list=abuselog & afluser=SineBot & aflprop=ids

<api>
  <query>
    <abuselog>
      <item id="900937" filter_id="211" user="SineBot" result="" />
      <item id="888404" filter_id="211" user="SineBot" result="" />
      <item id="862751" filter_id="211" user="SineBot" result="" />
      <item id="855649" filter_id="211" user="SineBot" result="" />
      <item id="842429" filter_id="211" user="SineBot" result="" />
      <item id="840958" filter_id="1" user="SineBot" result="" />
      <item id="824151" filter_id="211" user="SineBot" result="" />
      <item id="804892" filter_id="211" user="SineBot" result="" />
      <item id="205254" filter_id="58" user="SineBot" result="disallow" />
      <item id="205252" filter_id="58" user="SineBot" result="disallow" />
    </abuselog>
  </query>
  <query-continue>
    <abuselog aflstart="2009-04-19T02:07:55Z" />
  </query-continue>
</api>

関連項目

• 最新のコードの変更
• この拡張機能が有効なWMFのウィキ (とコンフィギュレーション)