Parâmetros

[
    'throttle' => true,
    'warn' => true,
    'disallow' => true,
    'blockautopromote' => true,
    'block' => true,
    'rangeblock' => false,
    'degroup' => false,
    'tag' => true
]

1000

[
    'default'
]

[
    'default' => 0.05
]

[
    'default' => 2
]

[
    'default' => 86400
]

[
	"throttle" => false,
	"warn" => false,
	"disallow" => false,
	"blockautopromote" => true,
	"block" => true,
	"rangeblock" => true,
	"degroup" => true,
	"tag" => false
]

false

false

null

false

[
	"throttle" => false,
	"warn" => false,
	"disallow" => false,
	"blockautopromote" => false,
	"block" => false,
	"rangeblock" => false,
	"degroup" => false,
	"tag" => false
]

'indefinite'

null

5

[
    'default' => 'abusefilter-warning'
]

[
    'default' => 'abusefilter-disallowed'
]

true

3 * 30 * 24 * 3600

10000

false

false

500

[
    'IPv4' => '16',
    'IPv6' => '19',
]

[ "user_unnamed_ip" ]

Supressão de emergência

O AbuseFilter vem com um recurso que suprime (desabilita) automaticamente os filtros que foram editados recentemente e correspondem a um determinado limite das ações mais recentes.

Isso é feito para evitar edições prejudiciais nos filtros para bloquear todos os usuários que executam uma ação em uma wiki ou semelhante.

A condição para desativar o filtro depende dessas variáveis:

• $wgAbuseFilterEmergencyDisableThreshold - Porcentagem de correspondências sobre a quantidade total de ações no período observado.
• $wgAbuseFilterEmergencyDisableCount - Quantidade de correspondências do filtro no período observado.
• $wgAbuseFilterEmergencyDisableAge - Idade do filtro considerado. Se a última edição do filtro for anterior a esse número de segundos, o filtro não será regulado, a menos que já esteja regulado.

Os filtros suprimidos podem ser identificados na lista de filtros (Special:AbuseFilter) com o estado Ativo, Alta taxa de correspondências. A supressão ocorre silenciosamente e não há como saber quando um filtro foi suprimido, exceto quando Extension:Echo é instalado, então uma notificação é enviada ao último usuário a modificar o filtro.

Quando um filtro é suprimido, ele não executa nenhuma ação perigosa (ações geralmente restritas a direitos especiais como bloquear o usuário ou removê-lo de grupos, controlados por $wgAbuseFilterActionRestrictions), e apenas ações "seguras" são permitidas (aquelas que podem avisar ou impedir a ação em andamento). Filtros suprimidos não são ativados automaticamente. Para desativar a supressão, você precisará editar o filtro. Observe que você realmente precisará mudar algo no filtro: algo como as notas do filtro será suficiente.

Observe que editar o filtro atualiza sua idade e pode fazer com que ele seja desativado se atingir novamente as condições para ser suprimido em um curto período desde a última edição, levando a um filtro inutilizável se sua wiki tiver mais edições de abuso do que legítimas.

list=abusefilters (abf)

Lista informações sobre filtros

Parâmetros

• abfstartid – O ID do filtro de onde inicia-se a enumeração
• abfendid – O ID de filtro onde interrompe-se a enumeração
• abfdir – A direção na qual enumerar: older, newer
• abfshow – Mostra apenas filtros que atendem a esses critérios: enabled|!enabled|deleted|!deleted|private|!private|protected|!protected
• abflimit – O número máximo de filtros para listar
• abfprop – Quais propriedades para se obter: id|description|pattern|actions|hits|comments|lasteditor|lastedittime|status|private|protected

Quando os filtros são private, algumas das propriedades especificadas com abfprop estarão ausentes, a menos que você tenha os direitos de usuário apropriados.

Exemplos

{
    "batchcomplete": "",
    "continue": {
        "abfstartid": 18,
        "continue": "-||"
    },
    "query": {
        "abusefilters": [
            {
                "id": 1,
                "hits": 41430
            },
            {
                "id": 3,
                "hits": 957485
            },
            {
                "id": 5,
                "hits": 5931
            },
            {
                "id": 6,
                "hits": 19
            },
            {
                "id": 8,
                "hits": 7
            },
            {
                "id": 9,
                "hits": 41354
            },
            {
                "id": 11,
                "hits": 132971
            },
            {
                "id": 12,
                "hits": 139693
            },
            {
                "id": 14,
                "hits": 63
            },
            {
                "id": 15,
                "hits": 15
            }
        ]
    }
}

list=abuselog (afl)

Lista casos em que as ações desencadearam um filtro de abuso.

Parâmetros

• afllogid – Um único ID de registro inteiro para listar.
• aflstart – O timestamp de onde se inicia a enumeração
• aflend – O timestamp onde se para a enumeração
• afldir – A direção na qual se realiza a enumeração (mais antigo, mais recente)
• afluser – Mostra apenas as entradas onde a ação foi tentada por um determinado usuário ou endereço IP.
• afltitle – Mostra apenas as entradas onde a ação envolveu uma determinada página.
• aflfilter – Mostra apenas as entradas que desencadearam um determinado ID de filtro
• afllimit – O número máximo de entradas para listar
• aflprop – Quais propriedades a serem obtidas: (ids|filter|user|title|action|details|result|timestamp|hidden|revid|wiki)

aflprop=wiki é reconhecido apenas em wikis centrais.

Exemplo

{
    "batchcomplete": "",
    "continue": {
        "aflstart": "2018-03-06T02:34:18Z",
        "continue": "-||"
    },
    "query": {
        "abuselog": [
            {
                "id": 27219261,
                "filter_id": "1073"
            },
            {
                "id": 26938051,
                "filter_id": ""
            },
            {
                "id": 23388942,
                "filter_id": "1"
            },
            {
                "id": 22044912,
                "filter_id": ""
            },
            {
                "id": 22032235,
                "filter_id": ""
            },
            {
                "id": 22032196,
                "filter_id": ""
            },
            {
                "id": 21983882,
                "filter_id": ""
            },
            {
                "id": 20594818,
                "filter_id": "904"
            },
            {
                "id": 20593489,
                "filter_id": "904"
            },
            {
                "id": 20590442,
                "filter_id": "904"
            }
        ]
    }
}

Adicionando variáveis para filtragem

É possível adicionar novas variáveis, para serem utilizadas em filtros de abuso. Uma lista de exemplos está disponível . Para fazer isso, você deve:

• Adicione um manipulador para o gancho AbuseFilter-builder . Para adicionar uma variável, você deve usar $builder['vars']['variable_name'] = 'i18n-key';, onde variable_name é o nome da variável e i18n-key é o fragmento de uma chave i18n. A chave completa será abusefilter-edit-builder-vars-{$your_key}.
• Adicione as mensagens i18n que você escolheu no ponto anterior.
• Escolha um manipulador de gancho onde a variável será calculada. Dependendo do seu caso de uso, você pode:
  • Implemente o gancho AbuseFilter-generateTitleVars ; isso é pensado especificamente para variáveis relacionadas à página;
  • Implemente o gancho AbuseFilter-generateUserVars ; isso é pensado especificamente para variáveis relacionadas ao usuário;
  • Implemente o gancho AbuseFilter-generateGenericVars ; isso é para variáveis não vinculadas a uma página ou usuário específico;
  • Implemente o gancho AbuseFilterAlterVariables ; isso é um pouco mais flexível do que os outros ganchos, mas tem uma desvantagem: sua variável não estará disponível ao examinar entradas anteriores de mudanças recentes. Se você quiser implementar esse recurso (e é recomendado fazer isso), você deve usar um dos ganchos listados acima e usar seu terceiro parâmetro ($RCRow).
• Dentro do gerenciador de gancho, existem duas maneiras de adicionar uma variável:
  • A forma "direta" é chamar $vars->setVar( 'var_name', var_value );. Isso é ideal apenas quando o valor é fácil e rápido de calcular: o valor é calculado mesmo se nenhum filtro ativo o usar.
  • A maneira "preguiçosa" é chamar $vars->setLazyLoadVar( 'var_name', 'method_name', $params );. Aqui, 'method_name' é um identificador (único) que será usado para calcular a variável (é recomendado prefixá-lo com o nome de sua extensão). Para registrar o método, você deve adicionar um manipulador para o gancho AbuseFilter-computeVariable ; nele, você deve verificar se o $method passado corresponde ao seu 'nome_do_método' e, em caso afirmativo, calcular a variável. Por último, $params é uma matriz de parâmetros de que você precisará para calcular a variável; eles são passados para o manipulador de gancho computeVariable. Para obter um exemplo disso, você pode verificar o CentralAuth global_user_groups.

Adicionar ações personalizadas

Você pode adicionar manipuladores de ação personalizados, para que cada filtro possa executar outras ações. Para fazer isso, você escolhe um nome para a ação ('my-action' de agora em diante) e, em seguida:

• Crie uma classe chamada, por exemplo MyAction, que deve estender \MediaWiki\Extension\AbuseFilter\Consequence, que também pode implementar HookAborterConsequence ou ConsequencesDisablerConsequence
• Adicione um assinante ao gancho AbuseFilterCustomActions; o assinante deve fornecer um retorno de chamada, conforme documentado na documentação do gancho, que retorna uma instância da classe criada acima, por exemplo:

class MyAction extends \MediaWiki\Extension\AbuseFilter\Consequence {
    public function run() {
        throw new \Exception( 'Write me' );
    }
}

public function onAbuseFilterCustomActions( &$actions ) {
    $actions[] = function ( \MediaWiki\Extension\AbuseFilter\Consequence\Parameters $params, array $rawParams ) : MyConsequence {
        return new MyAction( $params, $rawParams );
    };
}

Então você deve adicionar as seguintes mensagens i18n; você pode substituir 'my_action' por, por exemplo, 'block' para ver para que servem as mensagens:

• 'abusefilter-edit-action-${my_action}'
• 'abusefilter-action-${my_action}'

Adicionando grupos de regras

Você também pode adicionar grupos de regras extras, que podem ser usados para agrupar filtros de abuso existentes. Observe que, no momento, cada filtro só pode estar em um único grupo (T116642). Atualmente, o único consumidor conhecido desse recurso é Extension:StructuredDiscussions . Para fazer isso, você deve:

• Anexe o nome do grupo a $wgAbuseFilterValidGroups
• Adicione algum código para executar os filtros com seu grupo. Observe que filtro de abusos não fará isso por conta própria. Para fazer isso, você deve construir um objeto AbuseFilterRunner, passando o nome do seu grupo.