Extension:CheckUser/pt-br


 * Esta página é sobre a própria extensão. Para a política de Wikimedia Foundation CheckUser, veja m:Política de CheckUser.

CheckUser é uma extensão que permite que um usuário (com a permissão de ) verifique quais IPs são utilizados por um determinado usuário e que usuários são usados ​​por um determinado IP, sem ter que executar consultas diretamente no banco de dados. Esta extensão está presente em todas as wikis Wikimedia.

Instalação
A extensão é liberada pela licença GNU General Public License 2.0 e posteriores. O software é fornecido como está. As atualizações serão feitas de acordo com as necessidades das wikis Wikimedia, ou quando vulnerabilidades críticas são descobertas.



Básico

 * Se você instalou outras extensões sem executar, execute isso primeiro.



Instalando sem acesso ao prompt de comando
Muitos provedores de hospedagem não permitem o acesso direto ao shell, mas permitem a criação de trabalhos cron (por exemplo, via a interface web cPanel). Para os provedores de hospedagem, um trabalho cron temporário pode ser usado para executar  (naturalmente   deve ser substituído pelo caminho completo real para  ). Se você estiver usando um servidor remoto e não tiver acesso ao prompt de comando (se nem a solução de trabalho do cron é adequada para você), mas tem acesso através de phpMyAdmin, substitua estas etapas pelo passo #2 acima:


 * 1) Choose and download the tables_generated.sql file from the CheckUser/schema folder. Navigate in to the folder of the DB you are running to find the files.
 * 2) No phpMyAdmin, clique no banco de dados que você está usando para o MediaWiki no lado esquerdo
 * 3) Na próxima tela, clique na guia "Importar" na parte superior
 * 4) Em "Localização do arquivo de texto", escolha um dos arquivos, selecione "Nenhum" e clique no botão inferior "Ir".
 * Se sua tela phpMyAdmin tiver apenas um campo de texto e nenhum escolhedor de arquivos de texto, clique no botão "SQL" na coluna ao lado esquerdo, no logotipo phpMyAdmin e clique na guia "importar arquivos" na nova janela que se abre.
 * 1) Repita para o segundo arquivo



Em uma nova wiki
Siga o passo 1 acima, em seguida, execute a instalação do MediaWiki. O instalador do MediaWiki executará automaticamente as tarefas de instalação se você selecionar a caixa de seleção para o CheckUser quando for solicitado quais as extensões a serem instaladas.

Using Mediawiki-Docker
Follow the steps in to install this extension inside a MediaWiki Docker instance.

Configuração
Esta ferramenta migra dados das mudanças recentes para uma tabela $changes separada e adiciona-se a isso quando novas entradas são adicionadas. Se  foi previamente definido como , não haverá dados iniciais para pesquisa, mas as novas edições serão preenchidas assim que a extensão for configurada. However, entries added after installation of this extension will contain the IP address.

Depois de executar as consultas, você pode reduzir  para tornar as mudanças recentes mais curtas, sem afetar o checkuser. Use  para definir uma distância com os dados disponíveis para o checkuser podem ser exibidos, em segundos.

Nas versões do MediaWiki 1.22 e posteriores, a configuração específica do CheckUser $wgCheckUserCIDRLimit determina o maior intervalo que pode ser verificado em uma única verificação. Seu formato é o mesmo que. Caso contrário, o limite padrão (para todas as versões) é  para seleções   e   para seleções.

To allow this tool to log successful and failed login attempts as well as logouts, set  to. If you have bot accounts on your wiki, setting  to  will skip logging successful login attempts to bot accounts.



Concedendo o direito de usar CheckUser
Para conceder o direito de usar a função CheckUser, um usuário capaz de gerenciar privilégios de usuário deve ir para Special:UserRights e digitar o nome do usuário na caixa e, em seguida, selecionar a opção "Check User". Uma vez feito isso, a opção Verificar Usuário aparecerá na página Special:SpecialPages para esse usuário.

Para ativar o gerenciamento de direitos do usuário para administradores, coloque o seguinte em :

Para permitir apenas a adição e remoção da permissão de  ao usuário, use o seguinte em vez disso:

Special:CheckUser usage


Interface básica
Para a notação, veja. Tente resumir sucintamente a situação (por exemplo, "spam cross-wiki"); isso será logado em um registro visível apenas para usuários com a permissão.
 * 1) Vá para Special:CheckUser.
 * 2) No campo "usuário", digite o nome de um usuário (sem o prefixo  ), um endereço IP ou um intervalo CIDR.
 * 3) * IP: qualquer endereço IPv4 ou IPv6.
 * 1) * CIDR: você pode verificar uma variedade de endereços IP anexando o prefixo CIDR (por padrão, até /16 para IPv4 (65.536 endereços), até /64 para IPv6 (~ 1.8446 * 10 19 endereços) antes [$gerrit revisão 7352], até /48 para endereços IPv6 (~ 1.2089 * 10 24 ou 65536 /64s - controlado por $wgCheckUserCIDRLimit na versão mais recente) após a revisão 7352, e até /32 (65536/48's) após rECHU9d7c239bf88866eca577f3241194d440f94fa014).
 * 1) * XFF: você pode verificar um endereço de cliente fornecido por X-Forwarded-For adicionando  (por exemplo,  ).
 * 2) Selecione a informação que deseja recuperar.
 * 3) *  - #* Obter IPs: retorna endereços IP usados ​​por um usuário registrado.
 * 4) *  - #* Obter edições de IP: retorna todas as edições feitas por um usuário (registrado ou anônimo) de um endereço IP ou intervalo.
 * 5) *  - #* Obter usuários: retorna contas de usuários que foram editadas de um IP ou intervalo.
 * 1) No campo motivo, digite o motivo pelo qual você está acessando os dados confidenciais.



Informações exibidas
Uma entrada típica nos resultados das verificações para um resumo de usuário ("get users") é a seguinte:


 * Example (talk | contribs | block) (Check) (20:11, -- 20:12, ) [5]
 * 127.0.0.37 XFF: 127.0.0.1, 127.0.0.5
 * Example user agent
 * Example user agent

Isso é formatado para se adequar a uma grande quantidade de informações em um formato que pode ser facilmente listado e compreendido, mas é difícil de ler, a menos que você saiba qual é a informação fornecida. A informação é apresentada da seguinte forma:


 * Nome de usuário (Links de usuários) (Período de tempo em que os usuários editaram a partir do IP ou intervalo fornecido) [Número de edições do IP ou intervalo]
 * O Endereço de IP editou de XFF: Informações XFF fornecidas (podem ser falsificadas)

Cada combinação de IP/XFF usada para editar está listada, em ordem de uso.

Os últimos dez agentes de usuário (navegador, sistema operacional, linguagem do sistema e versões) de cada edição feitas no IP ou no intervalo são listados posteriormente.



Formato XFF
Os cabeçalhos XFF (X-Forwarded-For) indicam a série de endereços IP usados do computador do usuário (primeiro) até o último servidor proxy. No caso da Wikimedia, o último servidor proxy é um dos proxies da Wikimedia (listado em no arquivo de configuração da Wikimedia).

Exemplo:

aaa.aaa.aaa.aaa       XFF: 10.4.46.42, 127.0.0.1, aaa.aaa.aaa.aaa, 208.80.152.46


 * Os dois primeiros endereços são privados para a rede de origem e não podem ser alcançados diretamente pela Internet pública,
 * O terceiro endereço é o "rosto público" do editor, geralmente um ISP de banda larga ou dial-up, um gateway da empresa, (mas possivelmente um anonimizador ou um servidor comprometido com malware)
 * O último endereço é uma das squids da Wikimedia.

Opções de configuração do MediaWiki, , e usando extensões. O hook (com a ) altera a forma em que um endereço IP real usado para atribuir edições está selecionado.

Personal tool links
When you get results from Special:CheckUser you can add personal user tool links via two interface messages:


 * for IP addresses (for example m:MediaWiki:checkuser-userlinks-ip)
 * for registered users (for example m:MediaWiki:Checkuser-userlinks)
 * - for IPs in the 'Get IP Addresses' check type (for example m:MediaWiki:checkuser-toollinks)

Basic usage

 * 1) Vá para Special:Investigate.
 * 2) In the Usernames and IP addresses field, type in up to 10 targets, which may be usernames (without the   prefix), IP addresses, or CIDR ranges.
 * 3) In the Reason field, enter the reason you are accessing the confidential data, as described in the Special:CheckUser instructions above; this will be logged in a log visible only to users with the checkuser-log permission.

For advanced feature usage, see Help:Special Investigate.

Customizing tool links
As with Special:CheckUser, links to external tools can be customized.

The links are defined in the  message. This message is parsed to find links, which are added to the menu in the IPs and user agents tab.

API
CheckUser também fornece um API. The APIs work similarly to Special:CheckUser and Special:CheckUserLog respectively.

api.php?action=query&list=checkuser&curequest=userips&cutarget=Jimbo_Wales api.php?action=query&list=checkuser&curequest=edits&cutarget=127.0.0.1/16&xff=1&cureason=Some_check

api.php?action=query&list=checkuserlog&culuser=WikiSysop&cullimit=25 api.php?action=query&list=checkuserlog&cultarget=127.0.0.1&culfrom=20111015230000

Temporary Account Reveal API
Usage

The TemporaryAccountHandler class offers API endpoints for retrieving the IP addresses associated with temporary user accounts. To access this information, the Enable revealing IP addresses for temporary accounts feature must be enabled on the user's Special:Preferences page.

'''API endpoint

`POST /rest.php/checkuser/v0/temporaryaccount/{name}` where   is the user name you want to look up

Response

If the request is successful, the API will respond with a JSON object containing the following fields: If the request fails, the API will respond with an appropriate error code and message.

Example request

POST /rest.php/checkuser/v0/temporaryaccount/*Unregistered%202

Example response

TemporaryAccountRevisionHandler
The TemporaryAccountRevisionHandler class is used in several places throughout the CheckUser extension. For example, it is used when a checkuser is performed to create temporary accounts and revisions for the users and pages being checked. It is also used when the checkuser is complete to delete any temporary accounts and revisions that were created.

You can add the optional params in via the querystring (e.g. ?revision=123, etc); which will show revisions.

Displaying IP Address Information for Temporary Accounts
The CheckUser extension has also been updated to include a new feature whereby a button will be displayed next to temporary account user links on user pages. This functionality is available exclusively to users with the checkuser-temporary-account privilege, granting them the ability to view the IP addresses that are linked to temporary accounts. These buttons will appear when viewing page histories, or in Special:Contributions.