Laravel Auth Log is a package to automatically log all logins of your users. It can also send notifications when a successful login was made from an unknown device.
This package is a modified and extended version of https://github.com/yadahan/laravel-authentication-log.
Laravel Auth Log requires Laravel 5.8 or higher, and PHP 7.2+.
You may use Composer to install Laravel Auth Log into your Laravel project:
composer require samuelnitsche/laravel-auth-log
After installing the Laravel Auth Log, publish its config, migration and view, using the vendor:publish
Artisan command:
php artisan vendor:publish --provider="SamuelNitsche\AuthLog\AuthLogServiceProvider"
Next, you need to migrate your database. The Laravel Auth Log migration will create the table your application needs to store auth logs:
php artisan migrate
Finally, add the AuthLogable
and Notifiable
traits to your authenticatable model (by default, App\User
model). These traits provides various methods to allow you to get common auth log data, such as last login time, last login IP address, and set the channels to notify the user when login from a new device:
use SamuelNitsche\AuthLog\AuthLogable;
use Illuminate\Notifications\Notifiable;
use Illuminate\Foundation\Auth\User as Authenticatable;
class User extends Authenticatable
{
use Notifiable, AuthLogable;
}
Get all authentication logs for the user:
User::find(1)->authentications;
Get the user last login info:
User::find(1)->lastLoginAt();
User::find(1)->lastLoginIp();
Get the user previous login time & ip address (ignoring the current login):
auth()->user()->previousLoginAt();
auth()->user()->previousLoginIp();
Notifications may be sent on the mail
, nexmo
, and slack
channels. By default notify via email.
You may define notifyAuthenticationLogVia
method to determine which channels the notification should be delivered on:
/**
* The Auth Log notifications delivery channels.
*
* @return array
*/
public function notifyAuthenticationLogVia()
{
return ['nexmo', 'mail', 'slack'];
}
Of course you can disable notification by set the notify
option in your config/auth-log.php
configuration file to false
:
'notify' => env('AUTH_LOG_NOTIFY', false),
You may clear the old auth log records using the auth-log:clear
Artisan command:
php artisan auth-log:clear
Records that is older than the number of days specified in the older
option in your config/auth-log.php
will be deleted:
'older' => 365,
Thank you for considering contributing to the Laravel Auth Log.
Laravel Auth Log is open-sourced software licensed under the MIT license.