This package uses Microsoft's cognitive API to identify faces instead of passwords for your Laravel application.

You can install the package via composer:

composer require mpociot/laravel-face-auth

Add the service provider to your config/app.php:

Mpociot\FaceAuth\FaceAuthServiceProvider::class,

In your config/auth.php, change the auth driver to faceauth:

'providers' => [
    'users' => [
        'driver' => 'faceauth',
        'model' => App\User::class,
    ],
]

Publish the configuration:

php artisan vendor:publish --provider="Mpociot\FaceAuth\FaceAuthServiceProvider"

Edit the newly published config/faceauth.php file and enter your Face API key.

The face authentication works, by using a reference image of your user and matching it against a uploaded image upon login. So this pretty much is the same flow as comparing two password hashes.

When you register your users, you need to make sure that you store a photo of the users face - this is basically his password.

In order for this package, to find the user photo, your User model needs to implement the FaceAuthenticatable interface.

This interface only has one single method, which is public function getFaceAuthPhoto(). This method needs to return the content of the user photo.

Example:

class User extends Authenticatable implements FaceAuthenticatable
{

	public function getFaceAuthPhoto()
	{
		return File::get(storage_path('facces').$this->id.'.png');
	}

}

Your login form now needs a photo field (the name can be configured) - this field should contain a base64 representation of the image, the user uses to log in.

If you want a simple way to capture the user image from the webcam, take a look at the vue-webcam Vue.js component.

Please see CHANGELOG for more information what has changed recently.

Please see CONTRIBUTING for details.

If you discover any security related issues, please email [email protected] instead of using the issue tracker.

• Marcel Pociot
• All Contributors

The MIT License (MIT). Please see License File for more information.