Extension:CheckUser

MediaWiki extensions manual

CheckUser Release status: estable
Implementación	Special page , User identity
Descripción	La función de CheckUser permite a un usuario con los respectivos permisos, comprobar qué direcciones IP son utilizadas por un determinado nombre de usuario o que nombres de usuario son utilizados por una determinada IP, sin tener que ejecutar consultas directamente a mano contra la base de datos.
Autor(es)	Tim Starling, Aaron Schulz
Última versión	2.5 (continuous updates)
Política de compatibilidad	release branches
MediaWiki	1.27+
PHP	5.4+
Cambios de la base de datos	Sí
Tablas	cu_changes cu_log
Licencia	GNU General Public License 2.0 or later
Descarga	Download extension Git [?]: Descargar desde master de Git Explorar el repositorio (GitHub) historial de cambios repository contributors (GitHub) revisión de código
Parámetros $wgCheckUserCIDRLimit $wgCheckUserMaxBlocks $wgCheckUserCAMultiLock $wgCheckUserForceSummary $wgCheckUserEnableSpecialInvestigate $wgCheckUserLogLogins $wgCUPublicKey $wgCheckUserCAtoollink $wgCheckUserMaximumRowCount $wgCheckUserLogAdditionalRights $wgCheckUserGBtoollink $wgCUDMaxAge
Derechos añadidos checkuser checkuser-log
Hooks que usa AuthManagerLoginAuthenticateAudit ContributionsToolLinks EmailUser GetPreferences LoadExtensionSchemaUpdates LocalUserCreated ParserTestTables PerformRetroactiveAutoblock RecentChange_save RenameUserSQL SpecialPage_initList User::mailPasswordInternal UserGetAllRights UserMergeAccountFields
Hooks provided CheckUserInsertForRecentChange SpecialCheckUserGetLinksFromRow
Translate the CheckUser extension if it is available at translatewiki.net
Verificar uso y versión de la matriz.
Asuntos	Tareas abiertas · Reportar un bug

Esta página es sobre la extensión. Para la Política CheckUser de la Fundación Wikimedia, vea la m:CheckUser policy.

CheckUser es una extensión que permite a un usuario (con el permiso de checkuser) comprobar qué direcciones IP son utilizadas por un nombre de usuario y que nombres de usuario son utilizados por una IP determinada, sin tener que ejecutar consultas directamente a mano contra la base de datos. La extensión se está ejecutando en vivo en todas las wikis de Wikimedia.

Descarga

The extension can be retrieved directly from Git ^[?]:

• Browse code
• Some extensions have tags for stable releases.
  • Browse tags
  • Select the tag
  • Click "snapshot"
• Each branch is associated with a past MediaWiki release. There is also a "master" branch containing the latest alpha version (might require an alpha version of MediaWiki).
  • Browse branches
  • Select a branch name
  • Click "Continue"

Extract the snapshot and place it in the extensions/CheckUser/ directory of your MediaWiki installation.

If you are familiar with git and have shell access to your server, you can also obtain the extension as follows:

cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/CheckUser.git

Instalación

La extensión está liberada bajo la licencia GNU General Public License 2.0 o posterior. El software está proporcionado como es. Las actualizaciones se realizan de acuerdo a las necesidades de las wikis de Wikimedia; o cuando se descubren vulnerabilidades críticas.

En una wiki existente

Básico

• Si has instalado otras extensiones sin ejecutar php maintenance/update.php, primero ejecutalo

• Descarga y extrae los archivos en el directorio «CheckUser» dentro del directorio extensions/ existente.

• Añade el siguiente código a tu LocalSettings.php (preferiblemente al final):

  wfLoadExtension( 'CheckUser' );
  

• To users running MediaWiki 1.27 or earlier:

El uso de un programa cliente Telnet/SSH como PuTTY, permite navegar por las extensiones, comprobar la carpeta de usuario y ejecutar php install.php. If you don't see an install.php in that folder, you may need to switch to an older version of this extension, to match your MediaWiki version, using a command similar to git checkout REL1_26. Asegúrese de que está ejecutando una versión 5.x de PHP o posterior, de lo contrario este script no se ejecutará. If install.php is not present then run php maintenance/update.php again. El resultado será algo similar a esto:

...cu_changes table added.
...doing rc_id from 368856 to 368955....
...
...cu_changes table added and populated.
...cu_log added
...logging disabled, skipping log import.

•  Hecho – Navega a Special:Version en tu wiki para verificar que la apariencia se haya instalado correctamente.

Para quienes usan MediaWiki 1.24 o versiones anteriores:

Estas instrucciones describen la nueva forma de instalar extensiones usando wfLoadExtension(). Si necesitas instalar esta extensión en versiones anteriores (MediaWiki 1.24 y anteriores), debes usar lo siguiente en lugar de wfLoadExtension( 'CheckUser' );:

require_once "$IP/extensions/CheckUser/CheckUser.php";

Instalación sin comando de acceso y sin demora

Muchos proveedores de alojamiento no permiten el acceso directo al shell, pero permiten la creación de puestos de trabajo (e.j. vía la interfaz web de cPanel). Para aquellos proveedores de alojamiento temporal que ejecutan una tarea programada, puede ser utilizada para ejecutar php /path/to/install.php (naturalmente /path/to debe sustituirse por una completa ruta real para install.php). Si está utilizando un servidor remoto y no tiene un comando de acceso rápido (ni solución de trabajo que sea adecuada para usted) o no tiene acceso a través de phpMyAdmin, saltarse estos pasos para el paso #2:

1. Descargar cu_changes.sql y cu_log.sql
2. En phpMyAdmin, haga clic en la base de datos que está utilizando para mediawiki a lo largo del lado izquierdo
3. En la siguiente pantalla, haga clic en Importar en la parte superior.
4. En Ubicación del archivo de texto, elegir uno de los archivos, seleccione la compresión "Ninguno", y haga clic en el botón inferior "Go".

   Si en la pantalla de su phpMyAdmin sólo tiene un campo de texto y no hay archivo de texto Selector, haga clic en el botón de SQL de la columna de la izquierda, bajo el logotipo phpMyAdmin, y haga clic en la pestaña "Archivos de importación" en la nueva ventana que se abre.

5. Repetir para el segundo archivo

En una nueva wiki

Seguir el paso 1, entonces ejecute la instalación de MediaWiki. El instalador de MediaWiki automáticamente hará las tareas de instalación si has seleccionado el check para CheckUser en el paso de elegir la instalación de las extensiones.

Configuración

Esta herramienta migra los datos de cambios recientes por separado en una cu_changes table, y se suma a que cuando se añaden nuevas entradas. Si $PutlPinRC era anteriormente falsa, no habrá datos iniciales para buscar, pero las nuevas ediciones se completarán tan pronto como la extensión sea configurada.

Después de ejecutar las consultas, puedes reducir $wgRCMaxAge para mostrar los cambios recientes sin afectar checkuser. Usa $wgCUDMaxAge para establecer en qué medida los datos del usuario pueden ser comprobados de nuevo, en cuestión de segundos.

En versiones de MediaWiki 1.22 hacia adelante, CheckUser establece una configuración concreta $wgCheckUserCIDRLimit determina la gama más grande que puede ser comprobada en un solo control. Su formato es el mismo en $wgBlockCIDRLimit De lo contrario, el límite por defecto (para todas las versiones) es /32 para comprobar direcciones IPv6 y /16 para comprobar direcciones IPv4.

CheckUsers que utilizan Mozilla Firefox deben agregar este script JS en el archivo .js. Hace recuperar el WHOIS de la IP más fácilmente. Requiere soporte applets.codebase.principle (about:config) habilitado. (Esto puede ser signed.applets.codebase_principle_support en Firefox 3)

Manera correcta de utilizar CheckUser

Para conceder el derecho de utilizar la herramienta CheckUser, un usuario con derechos de administrador tiene que ir a Special:UserRights e introducir el nombre de usuario en la caja, y por último seleccionar la opción "CheckUser". Una vez hecho esto, la opción de CheckUser aparecerá en la página de Special:SpecialPages para aquel usuario.

Para activar la gestión de derechos de usuario para los administradores, escriba lo siguiente en LocalSettings.php:

$wgGroupPermissions['sysop']['checkuser'] = true;
$wgGroupPermissions['sysop']['checkuser-log'] = true;
$wgGroupPermissions['sysop']['investigate'] = true;

Para permitir solo la adición y la eliminación de la autorización de verificación de usuario, utilice en su lugar:

$wgAddGroups['sysop'][] = 'checkuser';
$wgRemoveGroups['sysop'][] = 'checkuser';

Configuración

Preferencias de configuración en extension.json

parámetro	por defecto	comentario
$wgCUDMaxAge	7776000	Cuánto tiempo para mantener CU dato (en segundos)? (default = 3 meses)
$wgCheckUserMaxBlocks	200	Límites de bloqueo máximo
$wgCheckUserForceSummary	false	Establecer esta propiedad a true si desea forzar a los usuarios de verificación para que den una razón para cada verificación que se realiza a través de Especial:CheckUser. (No es muy útil, ya que los verificadores podrían dar simplemente un resumen tales como "que necesitan ser revisados" o "me da la gana" y el software no lo sabría.)
$wgCheckUserCIDRLimit	[ 'IPv4' => 16, 'IPv6' => 32 ]	Cortos límites CIDR que se pueden comprobar en una verificación de rango
$wgCUPublicKey	''	Clave pública para cifrar datos privados que pueden necesitar para ser leído más tarde. Generar una clave pública con algo como: openssl genrsa -out cu.key 2048; openssl rsa -in cu.key -pubout > cu.pub y pega los contenidos de cu.pub aquí
$wgCheckUserCAMultiLock	false	This can be used to add a link to Special:MultiLock by CentralAuth to the Special:CheckUser's mass block form. This requires the CentralAuth extension to be installed on the wiki. To enable this, set this to an array with a central wiki's database name and an array with the name(s) of the global group(s) to add the link for. Por ejemplo: $wgCheckUserCAMultiLock = [ 'centralDB' => 'metawiki', 'groups' => [ 'steward' ] ];
$wgCheckUserCAtoollink	false	Since 77360f1cf1d2. This adds a link to central wiki Special:CentralAuth to the Special:CheckUser's "Get users" results. This requires the CentralAuth extension to be installed on the wiki. To enable this, set this with a central wiki's database name. Por ejemplo: $wgCheckUserCAtoollink = 'metawiki';
$wgCheckUserGBtoollink	false	Since 77360f1cf1d2. This adds a link to local or central wiki Special:GlobalBlock to the Special:CheckUser's "Get users" results. This requires the GlobalBlocking extension to be installed on the wiki. To enable this, if a $wgConf is configured, set this to an array with a central wiki's database name and an array with the name(s) of the local (or global if you have CentralAuth installed) group(s) to add the link for. Por ejemplo: $wgCheckUserGBtoollink = [ 'centralDB' => 'metawiki', 'groups' => [ 'steward', 'staff' ] ];
$wgCheckUserEnableSpecialInvestigate	false	Since 57dcfe46d2e4. This enables Special:Investigate, an updated version of Special:CheckUser that allows checking for multiple user accounts and IP addresses within one investigation.

Special:CheckUser usage

Interfaz básica

1. Ir a Special:CheckUser
2. En el campo usuario, escriba un nombre de usuario (sin el prefijo 'usuario'), dirección IP o rango CIDR.
   • IP: cualquier dirección IPv4 o IPv6.
   • CIDR: Puedes comprobar un rango de direcciones IP anexando el prefijo CIDR (por defecto, hasta /16 para IPv4 (65,536 direcciones) hasta /64 para IPv6 (~1.8446*10¹⁹ direcciones) antes que en revision 7352, hasta /48 para IPv6 (~1.2089*10²⁴ direcciones en 65536 /64 - controladas por $wgCheckUserCIDRLimit o en versiones superiores) en la revisión 7352, y subiendo hasta /32 (65536 /48s) en revision rECHU9d7c239bf88866eca577f3241194d440f94fa014). Para notación, véase Bloquear un rango.
   • XFF: Puedes comprobar una dirección IP cliente proporcionada por X-Forwarded para encabezamientos se debe anteponer /xff (por ejemplo, 127.0.0.1/xff).
3. Seleccione la información que desea obtener.
   • Obtener IPs: obtiene las direcciones IP utilizadas por un usuario registrado.
   • Obtener ediciones de IP: obtiene todas las ediciones (registradas o anonimas) realizadas en una determinada dirección IP o rango.
   • Obtener usuarios: obtiene los usuarios que han editado en esa dirección IP o rango.
4. En el campo "razón" escribe la razón por la que estás accediendo a ese dato confidencial. Try to succinctly summarise the situation (for example, "cross-wiki spam"); this will be logged in a log visible only to users with the checkuser-log permission.

• Screenshots
• 

  Interfaz básica CheckUser

• 

  Ejemplo de verificación a nombre de usuario

• 

  Ejemplo de verificación a dirección IP

• 

  Ejemplo del registro

Información obtenida

Una entrada típica en el resultado CheckUser para un resumen de usuario ("get users") es el siguiente:

• Example (Talk | contribs) (20:11, 02 agosto 2020 -- 20:12, 02 agosto 2020) [5]
  1. 127.0.0.37 XFF: 127.0.0.1, 127.0.0.5

Esto está formateado para adecuar una gran cantidad de información a un formato que puede ser muy fácilmente listado y ojeado, pero es difícil de leer a menos que sepas cuál es la información proporcionada: The information is laid out as follows:

• Nombre de usuario (user links) (time period when they edited from the given IP or range) [number of edits from the IP or range]
  1. IP address edited from XFF: XFF information provided (can be spoofed)

Cada combinación IP / XFF utilizada para editar aparece en la lista, por orden de utilización.

Las últimos diez aplicaciones de usuario (navegador, sistema operativo, idioma del sistema y las versiones) para cada usuario, las modificaciones realizadas en el IP o el intervalo se enumeran después.

Formato XFF

XFF (X-Forwarded-For) encabezados indican la serie de direcciones IP utilizadas desde el ordenador del usuario (primero) al último servidor proxy. In case of Wikimedia, the last proxy server is one of the Wikimedia proxies (listed under $wgCdnServersNoPurge in the Wikimedia configuration file).

En este ejemplo:

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

• las primeras dos direcciones (10.4.46.42, 127.0.0.1) son privadas para la red de origen y no pueden alcanzarse directamente desde la Internet pública,
• the third address (aaa.aaa.aaa.aaa) is the "public face" of the editor, usually a broadband or dialup ISP, a company gateway, (but possibly an anonymizer or a malware-compromised server),
• the last address (208.80.152.46) is one of the Wikimedia squids (sq36.wikimedia.org).

Ajustes de configuración de MediaWiki $wgUsePrivateIPs , $wgCdnServers , $wgCdnServersNoPurge y de extensiones que utilizan el gancho IsTrustedProxy (como Extensión:TrustedXFF ) cambiar la forma en que se selecciona una dirección IP real que se utiliza para atribuir al editor.

Personal tool links

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

• MediaWiki:checkuser-userlinks-ip for IP addresses (for example m:MediaWiki:checkuser-userlinks-ip)
• MediaWiki:Checkuser-userlinks for registered users (for example m:MediaWiki:Checkuser-userlinks)

Special:Investigate usage

Basic usage

1. Go to Special:Investigate.
2. In the Usernames and IP addresses field, type in up to 10 targets, which may be usernames (without the 'user:' 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 investigate permission.

• Screenshots
• 

  Input form

• 

  Account information tab

• 

  IPs and user agents tab

• 

  Timeline tab

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 checkuser-investigate-compare-toollinks message. This message is parsed to find links, which are added to the menu in the IPs and user agents tab.

API

CheckUser también proporciona una API.

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