PHP download

Download the PHP package erayaydin/fingerprint-laravel without Composer

On this page you can find all versions of the php package erayaydin/fingerprint-laravel. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

Table of contents
Download erayaydin/fingerprint-laravel
More information about erayaydin/fingerprint-laravel
Files in erayaydin/fingerprint-laravel

Vendor erayaydin
Package fingerprint-laravel
Short Description Fingerprint Laravel Wrapper
License MIT
Homepage https://github.com/erayaydin/fingerprint-laravel

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:

If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.

Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
To use Composer is sometimes complicated. Especially for beginners.
Composer needs much resources. Sometimes they are not available on a simple webspace.
If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.

Please rate this library. Is it a good library?

Example code of erayaydin/fingerprint-laravel

Informations about the package fingerprint-laravel

Fingerprint Laravel

Fingerprint Laravel is a package for integrating Fingerprint Server API into your Laravel application with PHP SDK for Fingerprint Pro Server API. It provides HTTP middlewares to block bots, VPNs, Tor, and more based on Fingerprint Server API event response.

Requirements

Laravel 11
PHP ^8.2

Features

Customizable implementations with fingerprint config file.
Injectable Event and Fingerprint classes. Event data class will auto-bind when a request with requestId received.
Fingerprint class provides a fluent interface to interact with the Fingerprint Server API.
Ready to use HTTP middlewares to block bots, VPNs, Tor, and more based on Fingerprint Server API event response.

Installation

You can install the package via Composer:

Check installation with about command.

Configuration

Publish the configuration file:

This will create a config/fingerprint.php file where you can set configurations.

By default, the package will use the FINGERPRINT_PRO_SECRET_API_KEY and FINGERPRINT_REGION environment variables. You should specify these values in your .env file. You can change the environment variable names in the configuration file after publishing it.

Configuration Options

api_secret: Your Fingerprint Server API key.
region: The region of the Fingerprint Server API. Available options: eu/europe, ap/asia, global.
middleware
- bot_block: Blocks good and/or bad bots.
- vpn_block: Blocks request if user is using a VPN.
- tor_block: Blocks tor network users.
- min_confidence: Minimum required confidence score. It should be in range of 0.0 to 1.0. If it's null, it will not check the confidence score.
- incognito_block: Blocks users who are using incognito mode.
- max_elapsed_time: Maximum elapsed time between the request and the event identification.

Usage

Middlewares

The package provides several middleware to block different types of traffics:

BlockBotsMiddleware (fingerprint.bots)
BlockIncognitoMiddleware (fingerprint.incognito)
BlockOldIdentificationMiddleware (fingerprint.old-identification)
BlockTorMiddleware (fingerprint.tor)
BlockVPNMiddleware (fingerprint.vpn)
MinConfidenceScoreMiddleware (fingerprint.confidence)

You can register these middleware in your bootstrap/app.php file or use the provided middleware group fingerprint in routes or controllers.

To use the middleware group in a route:

Or you can use specific middlewares:

Event Data Access

Use dependency injection to access the Event data class in your controller or middleware:

Fingerprint Server API Access

Use dependency injection to access the Fingerprint class in your controller or middleware:

About Command Support

The package integrates with Laravel's AboutCommand to provide information about the fingerprinting configuration. This is registered automatically.

Testing

You can run the tests with:

Roadmap

Increase code coverage to ~95%.
Add config option to change requestId key.
Add IP block middleware.
Add auto visitor store support with Visitor model and migrations.
Add HasVisitorId trait to use with custom Eloquent models.

Contributing

Please see CONTRIBUTING for details.

License

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

All versions of fingerprint-laravel with dependencies

PHP Build Version

Package Version

Version 0.1.0 Release 25. Sep 2024
create-project require 0 people choosed require and
0 people choosed create-project.

Download

Download latest version of fingerprint-laravel from vendor erayaydin

Requires php Version ^8.2
illuminate/support Version ^11.24
fingerprint/fingerprint-pro-server-api-sdk Version ^5.0
illuminate/http Version ^11.24
illuminate/routing Version ^11.24

Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package erayaydin/fingerprint-laravel contains the following files

Loading the files please wait ....