pvsv1984 / lumen-2fa by pvsv1984

A One Time Password Authentication package, compatible with Google Authenticator. Authenticates oauth tokens
1
0
1
Package Data
Maintainer Username: pvsv1984
Maintainer Contact: promise.ekoriko@lshtm.ac.uk (prog_24)
Package Create Date: 2022-05-10
Package Last Update: 2022-05-10
Language: PHP
License: BSD-3-Clause
Last Refreshed: 2024-06-25 03:00:40
Package Statistics
Total Downloads: 1
Monthly Downloads: 0
Daily Downloads: 0
Total Stars: 0
Total Watchers: 1
Total Forks: 0
Total Open Issues: 0

Google2FA for Lumen

Google Two-Factor Authentication Package for Lumen

Package install: composer require pvsv1984/lumen-2fa

Google2FA is a PHP implementation of the Google Two-Factor Authentication Module, supporting the HMAC-Based One-time Password (HOTP) algorithm specified in RFC 4226 and the Time-based One-time Password (TOTP) algorithm specified in RFC 6238.

This package is a Lumen update to to Google2FA for Laravel package.

The intent of this package is to create a microservice safe way to implement 2FA Code and check responses against user.

Recovery/Backup codes

if you need to create recovery or backup codes to provide a way for your users to recover a lost account, you can use the Recovery Package.

Installation on Lumen

Add the Service Provider to your bootstrap/app.php

Lshtmweb\Lumen2FA\TwoFactorServiceProvider::class

This package assumes you are using Dusterio passport for api authentication and have the standard oauth_tables. Feel free to change the migrations to suit your needs.

Publish the config file and migrations

php artisan vendor:publish --provider="Lshtmweb\Lumen2FA\TwoFactorServiceProvider::class"

Usage

The standard routes have already been set up for you. You can change to suit your need by adding routes and pointing to the correct Controller methods.

  • Add the middleware
    • In route middleware add a new middleware or use the default one lumen2fa to secure your routes.

Events Fired

  • TwoFactorActivatedEvent
  • TwoFactorBeforeDisableEvent
  • TwoFactorDisabledEvent
  • TwoFactorInfoGeneratedEvent

Using Laravel? Try this instead

Google2FA for Laravel

Changes

Pull requests are welcome