Downloads
Stars
Version
Laravel Auth Checker is a plugin to collect login info and devices used when a user authenticates. It makes it easy to catch user authentication attempts and lockouts from new IP address or new devices.
Version | Release |
---|---|
9, 10 | 2.0 |
8, 9 | 1.7 |
6, 7 | 1.6 |
5.8 | 1.2 |
5.7, 5.6 | 1.1 |
composer require lab404/laravel-auth-checker
Lab404\AuthChecker\Models\HasLoginsAndDevices
trait and the Lab404\AuthChecker\Interfaces\HasLoginsAndDevicesInterface
interface.use Lab404\AuthChecker\Models\HasLoginsAndDevices;
use Lab404\AuthChecker\Interfaces\HasLoginsAndDevicesInterface;
class User extends Authenticatable implements HasLoginsAndDevicesInterface
{
use Notifiable, HasLoginsAndDevices;
}
php artisan vendor:publish --tag=auth-checker
php artisan migrate
Note: Migrations are published in case you need to customize migration timestamps to integrate to your existing project.
This library collects login data and devices data about your users.
// Your user model:
$logins = $user->logins;
// Output:
[
[
'ip_address' => '1.2.3.4',
'device_id' => 1, // ID of the used device
'type' => 'auth',
'device' => [
// See Devices
],
'created_at' => '2017-03-25 11:42:00',
],
// ... and more
]
Also, you can directly access logins by their type:
$user->auths
, returns successful logins (via Login::TYPE_LOGIN
)$user->fails
, returns failed logins (via Login::TYPE_FAILED
)$user->lockouts
, returns locked out logins (via Login::TYPE_LOCKOUT
)// Your user model:
$devices = $user->devices;
// Outputs:
[
[
'platform' => 'OS X',
'platform_version' => '10_12_2',
'browser' => 'Chrome',
'browser_version' => '54',
'is_desktop' => true,
'is_mobile' => false,
'language' => 'fr-fr',
'login' => [
// See logins
],
],
// ... and more
]
There are many events available that can be used to add features to your app:
LoginCreated
is fired when a user authenticates.DeviceCreated
is fired when a new device is created for a user.FailedAuth
is fired when a user fails to log in.LockoutAuth
is fired when authentication is locked for a user (too many attempts).Each event passes a Login
model and a Device
model to your listeners.
Once the trait HasLoginsAndDevices
is added to your User
model, it is extended with these methods:
logins()
returns all loginsauths()
returns all successful login attempsfails()
returns all failed login attemptslockouts()
returns all lockoutsEach login returned is associated with the Device
model used.
devices()
returns all devices used by the user to authenticate.vendor/bin/phpunit
MIT