machaven/track-attempts

Track and limit any auth, OTP, or any other type of action.

Track Attempts Library

A handy library to track any type of action and limit the amount of attempts made in a period of time frame., _(*1)

Useful things to track and limit:, _(*2)

• Login attempts.
• One Time Pin (OTP) attempts.
• Any thing else you want to limit or monitor.

Features

• Track on any metric you want, like email, username, etc.
• Configurable limits.
• Multiple backend drivers:
  • Redis (Predis Client)
  • Laravel (Cache Facade)

Install

If using with the Laravel Drivers:, _(*3)

Use tags for version 1.x when used with Laravel version less than 5.8, _(*4)

composer require machaven/track-attempts:^1.0, _(*5)

Use tags for version 2.x when used with Laravel version 5.8+, _(*6)

composer require machaven/track-attempts:^2.0, _(*7)

If used with predis driver:, _(*8)

composer require machaven/track-attempts:^2.0, _(*9)

Class Configuration

Minimum Configuration, _(*10)

$config = ['driver' => 'predis', userIdentifier' => $username];
$attempts = (new \Machaven\TrackAttempts\TrackAttempts($config))->getDriver();

Full Configuration, _(*11)

$config = [
    'driver' => 'predis', // Driver to use ('predis' or 'laravel')
    'userIdentifier' => $username, // A variable with a unique identifier for the session/user
    'maxAttempts' => 3, // Max attempts limit
    'systemName' => 'my-website', // System Identifier used in cache key prefix.
    'ttlInMinutes' => 5, // Keep track of attempts in a five minute period.
    'actionName' => 'login', // The name of the action you are tracking.
    ];
$attempts = (new \Machaven\TrackAttempts\TrackAttempts($config))->getDriver();

The configuration above will create a key named: my-website:login:$username., _(*12)

Predis Driver Configuration

The predis driver requires redis settings to be configured in a .env file in your project root folder., _(*13)

Example .env:, _(*14)

REDIS_SCHEME=tcp
REDIS_HOST=localhost
REDIS_PASSWORD=
REDIS_PORT=6379
REDIS_DB=0
REDIS_PROFILE=3.2

Usage

Keeping count, _(*15)

>>> $attempts->increment();
=> true

Getting the count, _(*16)

>>> $attempts->getCount();
=> 1

Checking if the limit is reached, _(*17)

>>> $attempts->isLimitReached();
=> false

Clearing all attempts, _(*18)

>>> $attempts->clear();
=> true

Checking the time left before the count expires (in seconds), _(*19)

>>> $attempts->getTimeUntilExpired();
=> 188

Incrementing attempts, _(*20)

>>> $attempts->increment();

Using increment to track and check (example of max limit of 3 attempts), _(*21)

>>> $attempts->incrementAndCheckLimit();
=> true
>>> $attempts->incrementAndCheckLimit();
=> true
>>> $attempts->incrementAndCheckLimit();
=> true
>>> $attempts->incrementAndCheckLimit();
=> false