Go to file
MusikAnimal 0a4cd510e4 Complete documentation of config variables
Bug: T160094
Change-Id: Icf312685419fb314943ef7b978caf6707724e838
2017-03-24 17:48:20 +00:00
i18n Localisation updates from https://translatewiki.net. 2017-03-23 22:48:54 +01:00
tests/phpunit Move tests to tests/phpunit/ and remove hook 2016-08-06 01:30:11 -07:00
.gitignore Add grunt-jsonlint and grunt-banana-checker 2017-01-09 16:37:01 +01:00
.gitreview Whoops, track not trace 2016-10-24 17:02:52 -07:00
composer.json build: Updating mediawiki/mediawiki-codesniffer to 0.7.2 2016-05-27 18:21:24 -07:00
COPYING Initial version of extension to notify people on failed login attempts. 2016-03-28 04:29:04 -04:00
extension.json Complete documentation of config variables 2017-03-24 17:48:20 +00:00
Gruntfile.js Add grunt-jsonlint and grunt-banana-checker 2017-01-09 16:37:01 +01:00
LoginNotify.hooks.php Simplify messages in login notification, still having two 2017-03-23 09:47:16 -07:00
LoginNotify_body.php Update AddNewAccount->LocalUserCreated hook for LoginNotify 2017-02-23 17:47:03 +00:00
LoginNotifyPresentationModel.php Simplify messages in login notification, still having two 2017-03-23 09:47:16 -07:00
package.json Add grunt-jsonlint and grunt-banana-checker 2017-01-09 16:37:01 +01:00
phpcs.xml Attempt to enable tests 2016-04-25 16:18:22 -04:00
README.md Complete documentation of config variables 2017-03-24 17:48:20 +00:00
UserAvatar.svg Simplify messages in login notification, still having two 2017-03-23 09:47:16 -07:00

The LoginNotify extension notifies you when someone logs into your account. It can be configured to give warnings after a certain number of failed login attempts (The number is configurable, and can be different between unknown IPs/devices and known IP/devices). It can also give echo/email notices for successful logins from IPs you don't normally use. It can optionally integrate into the CheckUser extension in order to determine if the login is from an IP address you don't normally use. It can also set a cookie to try and determine if the login is from a device you normally use.

Installation

  • This extension requires the Echo extension to be installed. This extension can optionally integrate with the CheckUser extension if it is installed, but does not require it.
  • Download and place the file(s) in a directory called LoginNotify in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php: wfLoadExtension( 'LoginNotify' );
  • Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Configuration parameters

"@doc": "The number of failed login attempts to permit from a known IP before a notification is triggered.",
"LoginNotifyAttemptsKnownIP": 10
"@doc": "The time-to-live of the count of failed login attempts from a known IP (from the time of the first failed attempt).",
"LoginNotifyExpiryKnownIP": 604800,
"@doc": "The number of failed login attempts to permit from a new IP before a notification is triggered.",
"LoginNotifyAttemptsNewIP": 3,
"@doc": "The time-to-live of the count of failed login attempts from a new IP (from the time of the first failed attempt).",
"LoginNotifyExpiryNewIP": 1209600,
"@doc": "Whether to trigger a notification after failed logins from known IPs.",
"LoginNotifyCheckKnownIPs": true,
"@doc": "Whether to trigger a notification after successful logins from unknown IPs.",
"LoginNotifyEnableOnSuccess": true,
"@doc": "Enable notification for users with certain rights. To disable set to false",
"LoginNotifyEnableForPriv": [ "editinterface", "userrights" ],
"@doc": "Override this to use a different secret than $wgSecretKey",
"LoginNotifySecretKey": null,
"@doc": "Expiry in seconds. Default is 180 days",
"LoginNotifyCookieExpire": 15552000,
"@doc": "Override to allow sharing login cookies between sites on different subdomains",
"LoginNotifyCookieDomain": null,
"@doc": "Maximum number of users (records) to track as having successfully logged in on a particular device.",
"LoginNotifyMaxCookieRecords": 6,
"@doc": "Set to false to disable caching IPs in memcache. Set to 0 to cache forever. Default 60 days.",
"LoginNotifyCacheLoginIPExpiry": 5184000