lab404/laravel-auth-checker

Laravel Auth Checker allows you to log users authentication, devices authenticated from and lock intrusions.

Laravel Auth Checker

, _(*1)

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., _(*2)

, _(*3)

• Requirements
• Installation
• Usage
  • Authenticatable model
  • Logins
  • Devices
  • Events
• Tests
• Contributors
• Licence

Requirements

Installation

• Require the package: composer require lab404/laravel-auth-checker
• Publish migration files: php artisan vendor:publish --tag=auth-checker
• Migrate your database: php artisan migrate
• Configure your Authenticatable model (see below)

Usage

This library collects login data and devices data about your users., _(*4)

Authenticatable model

Your Authenticatable model (usually User) must implement the HasLoginsAndDevicesInterface interface., _(*5)

The trait HasLoginsAndDevices is provided with for a working default implementation., _(*6)

use Lab404\AuthChecker\Models\HasLoginsAndDevices;
use Lab404\AuthChecker\Interfaces\HasLoginsAndDevicesInterface;

class User extends Authenticatable implements HasLoginsAndDevicesInterface
{
    // ...
    use HasLoginsAndDevices;  
}

Once configured, you can access the following methods, _(*7)

• logins() returns all logins
• auths() returns all successful login attemps
• fails() returns all failed login attempts
• lockouts() returns all lockouts

Each login returned is associated with the Device model used, _(*8)

• devices() returns all devices used by the user to authenticate.

Logins

Calling $user->logins outputs:, _(*9)

[
    [
        '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',
    ],
    // ...
]

Also, you can directly access logins by their type, _(*10)

• $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)

Devices

Calling $user->devices outputs:, _(*11)

[
    [
        '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
        ],
    ],
    // ...
]

Events

There are many events available that can be used to add features to your app, _(*12)

• 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., _(*13)

Tests

vendor/bin/phpunit

Contributors

• MarceauKa
• and all others contributors

Licence

MIT, _(*14)